Skip to end of metadata
Go to start of metadata

There are two ways how to associate user and account: assign account to the user and link account to the user. There is a fundamental difference between the two. The short answer is that assignment represents what should be and link represent what is. The long answer takes the rest of this page.


Assignment represents what should be. Assignment specifies that a user should have an account. If an account is assigned to the user the assignment structure is added to the user object. The structure remains there no matter how the state of the resource changes. The assignment can be described as a legal right of the user to have an account.

Following XML snippet shows a simple assignment of account to a user.

MidPoint will try to create the assigned account as soon as possible. But that may not be an immediate action. E.g. if the target resource is down then the account may be created later when the resource goes up. However, the operation to add the assignment to the user will finish almost immediately regardless of whether the account was or was not created.

Note that the mechanism of assignments is actually the same concept that is used to model roles. Simply speaking roles can be seen as indirect assignments.


Link represents what is. Link specifies that an account belongs to a specific user. It links existing account to a user.

Following XML snippet shows an account linked to the user.


in 2.1.x versions reference accounts using accountRef instead of linkRef

Assignment and Link

It is quite frequent in the world around us that what should be and what is are not really the same. This is also quite common in the identity management: an account was accidentally deleted, illegal account was created, operation to add account failed due to communication error, etc. Therefore it is expected that the accounts that are assigned to the user and accounts that are linked to the user may not be the same. It is one of the primary tasks of midPoint to make sure that what should be really is. Therefore if midPoint detects account that should be there (is assigned) but it is not there (is not linked) it will react by creating such account. Similarly if there is a linked account that is not assigned midPoint will try to remove such account.

Even though assignments and links should be in accord there are situations that this is not desired. E.g. if an IDM solution is just deployed no accounts are assigned to users. There is usually a migration phase that is focusing just on mapping the reality without enforcing any policies. For that reason there is an option in the system configuration to weaken enforcement of assignment-link consistency. If such a case assigned accounts will still be created however accounts that are not assigned will not be removed.

See Also

  • No labels