COmanage Registry is capable of automatically assigning identifiers for members of COs. Identifiers may be assigned on demand, or as part of an Enrollment Flow. If you only want to assign identifiers manually (ie: without the help of auto assignment), this page does not apply to you.
Identifiers can be automatically assigned to CO Person records, not to Organizational Identity records. If you don't know what this means, review Understanding Registry People Types.
Defining Identifier Assignments
COmanage Registry defines the following algorithms for assigning identifiers:
Algorithm |
Description |
Examples |
---|---|---|
Name |
Identifiers assigned based on elements of a person's name, including initials. Collision numbers are used when names are not unique. |
|
Random |
Identifiers are assigned based on random numbers, with optional additional characters. |
|
Sequential |
Identifiers are assigned based on sequential numbers, with optional additional characters. |
|
To define an identifier assignment, select Identifier Assignments from your CO's menu. Any already defined assignments will be listed. Click Add Identifier Assignment to create a new one.
Fill in the form, paying careful attention to the following fields:
- Name: This name must match the type you wish to be populated in cm_identifiers:type. For example, if you wish to assign ePPNs, set the name to
eppn
. - Login: In general, CO Person identifiers are not used to log in to COmanage services (Organizational Identities are), so this should generally be left unchecked.
- Algorithm: As described above.
- Format: See Specifying Identifier Formats, below.
- Minimum: For Random identifiers, the minimum value that may be assigned. For Sequential identifiers, the first value to be assigned.
- Maximum: For Random identifiers, the maximum value that may be assigned.
Specifying Identifier Formats
Identifier formats can be a bit tricky, so let's start with the easier ones.
Random and Sequential identifiers are assigned the same way. If no format is specified, they will simply be assigned as an integer, eg 109
or 523788
.
To embed the assigned number in a string, set the format to be the string you would like, using ${#
} to denote where the assigned number should go, or using ${#:8
} to denote a fixed width (in this case, 8 characters).
Some examples:
Format |
Example Assigned Identifier |
---|---|
|
|
|
|
${#:5} ${GIVEN}.${FAMILY}(1:.${#})@myvo.org
Assigning Identifiers on Demand
xxx click the button
Assigning Identifiers via Enrollment Flows
xxx configure the enrollment flow
Constraints
- Identifiers of a given type must be unique within a CO.
- If a CO Person already has an identifier of a given type, no additional identifier will be created.
Identifier Reassignment
Random and Name Based identifiers can be reassigned if the original identifier was deleted rather than marked status inactive. (Random identifiers are less likely to be reused than Name Based identifiers since their assignment is by definition random.) If you do not wish identifiers to be reassigned, set the status of identifiers that are no longer needed to inactive; do not delete them.
Sequential identifiers are not and cannot be reassigned under normal conditions.