Fix Keycloak authentication management indexing (#6734)

* fix: keep original index

* refac: provider id choice

* refac: default

* fix: missing docs

* fix: ident

* fix: yaml formatting

* chore: bugfix changelog fragment

* fix: remove minor changes form current PR

* fix: missing yml extension

* Update changelogs/fragments/6734-keycloak-auth-management-indexing.yml

Co-authored-by: Felix Fontein <felix@fontein.de>

---------

Co-authored-by: Skrekulko <Skrekulko@users.noreply.github.com>
Co-authored-by: Felix Fontein <felix@fontein.de>

changelogs/fragments/6734-keycloak-auth-management-indexing.yml

@@ -0,0 +1,2 @@
+bugfixes:
+  - keycloak_authentication - fix Keycloak authentication flow (step or sub-flow) indexing during update, if not specified by the user (https://github.com/ansible-collections/community.general/pull/6734).

plugins/modules/keycloak_authentication.py

@@ -110,7 +110,7 @@ author:
 '''
 
 EXAMPLES = '''
-    - name: Create an authentication flow from first broker login and add an execution to it.
+- name: Create an authentication flow from first broker login and add an execution to it.
   community.general.keycloak_authentication:
     auth_keycloak_url: http://localhost:8080/auth
     auth_realm: master
@@ -134,7 +134,7 @@ EXAMPLES = '''
             test2.property: "value"
     state: present
 
-    - name: Re-create the authentication flow
+- name: Re-create the authentication flow
   community.general.keycloak_authentication:
     auth_keycloak_url: http://localhost:8080/auth
     auth_realm: master
@@ -153,7 +153,7 @@ EXAMPLES = '''
     state: present
     force: true
 
-    - name: Create an authentication flow with subflow containing an execution.
+- name: Create an authentication flow with subflow containing an execution.
   community.general.keycloak_authentication:
     auth_keycloak_url: http://localhost:8080/auth
     auth_realm: master
@@ -172,7 +172,7 @@ EXAMPLES = '''
         flowAlias: "New Sublow"
     state: present
 
-    - name: Remove authentication.
+- name: Remove authentication.
   community.general.keycloak_authentication:
     auth_keycloak_url: http://localhost:8080/auth
     auth_realm: master
@@ -280,6 +280,8 @@ def create_or_update_executions(kc, config, realm='master'):
                     # Compare the executions to see if it need changes
                     if not is_struct_included(new_exec, existing_executions[exec_index], exclude_key) or exec_index != new_exec_index:
                         exec_found = True
+                        if new_exec['index'] is None:
+                            new_exec_index = exec_index
                         before += str(existing_executions[exec_index]) + '\n'
                     id_to_update = existing_executions[exec_index]["id"]
                     # Remove exec from list in case 2 exec with same name