Differences

This shows you the differences between two versions of the page.

--- tutorial:adm:accounts [2018/12/27 12:16]
kotisovam [Linking object to CzechIdM entity manually]
+++ tutorial:adm:accounts [2022/12/09 11:58] (current)
doischert
@@ Line 26: / Line 26: @@
 Usually, linking objects to CzechIdM entities takes place during a data Synchronization or Provisioning when the CzechIdM system is deployed in the production environment. But it is a common situation that some data have to be corrected in an end system as well, e.g. LDAP. It may well be that the algorithm for object linking during synchronization does not work for all entities on the end system, or the individuals who entered some data manually before CzechIdM had been implemented may have made some mistakes. In either one of those cases, having the option in CzechIdM to link an object to an entity manually comes in handy.
-To do so, open a detail of the system on which you want to link an identity to some object: **Systems -> System detail**. Next, the first thing to do is to create a SysAccount and define its ID. In the example below, a manually created identity is being connected to its mirrored object in the HR system. Go to the **Entities** tab, there is a list of all SysAccounts.
+To do so, open the detail of the system on which you want to link an identity to some object: **Systems -> System detail**. Next, the first thing to do is to create a SysAccount and define its ID. In the example below, a manually created identity is being connected to its mirrored object in the HR system. Go to the **Entities** tab, there is a list of all entities on the system, that CzechIdM knows of.
 {{ :tutorial:entities_in_system.png | Entities list}}
-In the next step, we create a new SysAccount object:
+In the next step, we create a new system Entity (make sure the entity with the desired identifier is not yet present in the table):
-  * Connected system - Read only
+  * Connected system - Read-only
   * Identifier in the system - here, the ID (e.g. login) of the object on the end system is to be typed in.
   * Entity type - Type of entity in CzechdIdM
@@ Line 37: / Line 37: @@
 {{ :tutorial:new_entity.png | New entity}}
-Once a SysAccount is created, we proceed to create an AccAccount. Go to the tab **Accounts** and click on the Add button.
+Once a system entity is created, we proceed to create an AccAccount. Go to the tab **Accounts** and click on the Add button.
 {{ :tutorial:accounts_list.png | Accounts list}}
@@ Line 47: / Line 47: @@
 {{ :tutorial:new_accaccount.png | New Account}}
+FIXME To link the account to the entity in IdM (typically an identity), an additional step is needed - add a link to the account (for source systems), or assign some role to the identity (for managed systems).
+===== Manually delete accounts on system with account protection  =====
+If you need to immediately remove account on connected system, where account protection is on, or if you want to force delete user with all accounts:
+**1) Go to user contracts a set it's validity to past.**
+{{ :tutorial:adm:delete_user_with_account_1.png?800 |}}
+This will remove **all accounts** of the user. If you want to remove only one selected account of the user from some system (e.g. AD), then remove all roles that are assigned to the user for this system (e.g. all AD groups and the main AD role) instead of inactivating the whole contract of the user.
+**2) Go to user profile -> Accounts, and there you will see account in protection, so edit account and set protection validity to past **
+{{ :tutorial:adm:delete_user_with_account_2.png?800 |}}
+**3) Go to Settings -> Task scheduler -> Scheduled task and run AccountProtectionExpirationTaskExecutor**
+  * The account on system will be deleted when the task is over.
+===== Manually unlink account from the identity and IdM without deleting it =====
+<note tip>Starting with IdM 13.0, you can you the bulk action Stop managing accounts. [[tutorial:adm:accounts_bulk_actions#stop_managing_accounts|Learn more]]</note>
+You can use this tutorial e.g. in the following situations:
+  * an account is linked to a wrong identity, so you want to unlink it (so it can be managed by IdM without any specific identity owner, or linked to some different identity)
+  * an account is linked to an identity, but you don't want to manage this account by IdM at all. At the same time, you don't want to delete it from the connected system (e.g. some technical account on MS AD)
+**1) Go to user profile -> Accounts -> Links to accounts. Select the account that you want to unlink and click on the magnifying glass.**
+{{ :tutorial:adm:unlink_account_1_remove_owner_1.png?800 |}}
+**2) Uncheck the checkbox "Owns account" and click "Save".**
+{{ :tutorial:adm:unlink_account_2_remove_owner_2.png?800 |}}
+**3) Remove the link to the account from the identity.**
+Before that, make sure that the checkbox "Owns account" is really not checked (you did this in the previous step). Otherwise this action would delete the object from the connected system.
+{{ :tutorial:adm:unlink_account_2_remove_owner_3.png?800 |}}
+**STOP here**, if you still want to manage this account by IdM. This depends on the type of the account. Usually, it's recommended to manage accounts of all common users by IdM. Depending on your IdM implementation strategy, technical, privileged or testing accounts may not be in the scope of IdM. If you don't want to manage the account by IdM, continue with the next step.
+**4) List accounts managed in IdM on the connected system (Systems -> e.g. MS AD -> Accounts) and filter the account by its identifier.**
+{{ :tutorial:adm:unlink_account_3_list_accounts.png?800 |}}
+**5) Remove the link to the system account - open the account and clear the value in the select box for Entity (system). Then scroll down and click "Save".**
+{{ :tutorial:adm:unlink_account_4_remove_system_entity.png?800 |}}
+**6) Remove the account object from IdM**.
+Before that, make sure that the value in "Entity (system)" is really empty (you did this in the previous step). Otherwise, this action would delete the object from the connected system.
+{{ :tutorial:adm:unlink_account_5_unlink_from_idm.png?800 |}}
+Finally, you can make sure that the object still exists on the connected system. You can find it on the tab **Entities** of the connected system and open its detail. You could delete this entity ("SysAccount") from this tab, it will make no change on the real connected system. But you usually don't have any reason to do this, because the object really exists on the system and the Entities are mostly an evidence about really existing objects on the connected system.
+===== Manually change the value of an attribute for an account =====
+<note>This feature was introduced in IdM 13.0.</note>
+Once you open an account (either from the account agenda or from the detail of its owner, you can manually manage values of attributes for a specific account.
+{{:tutorial:adm:account_detail_001.png?direct|}}
+<note important>Once you start managing the value of an attribute, the value will be sent to the system directly. There is no way to modify it with a script. Standard mapping configuration will not be used.</note>
+You can modify even values for attributes which are not present in a mapping. You will be able to see and modify all attribute values from the schema.
+<note important>Currently, this is not supported for virtual systems. You can manually change only the values which are present in the mapping of the system.</note>
+To edit the value of an attribute, click Edit, change the value. You will notice that the value will now show that it is manually managed.
+{{:tutorial:adm:account_detail_002.png?direct|}}
+Then, click the Save button. You will be presented with a differential view of the modified attribute values.
+{{:tutorial:adm:account_detail_003.png?direct|}}
+Confirm it and the value will be provisioned to the system.
+===== Admin tutorials =====
+  * [[tutorial:adm:accounts_bulk_actions|Supported bulk actions for account]]