Validating Identifiers
Additional Topics: Identifier Validation
By default, COmanage Registry accepts identifiers of any format, as long as they are unique for a given type within a CO. That is, two CO People within the same CO may not have the same identifier of the same type. Identifier Validation Plugins allow for additional validation to take place. Supported use cases include
- Extending availability checks beyond COmanage database. This is useful to (eg) prevent assignment of identifiers that conflict with identifiers managed by other systems, such as email aliases.
- Verifying that a new identifier does not violate restrictions on formats imposed by integrated systems.
If you are interested in learning more about identifier validation, we can review them toward the end of the workshop if time.
Configuration
Plugins must be instantiated (CO » Configuration » Identifier Validators) by attaching them to the type of identifier to be validated. Validators can be attached to multiple types (including both Email Address and Identifier types), and a given type can have multiple Validators attached.
Applicability
- Validation applies only to CO Person records, not Org Identity records. (CO-478)
- As of Registry v3.3.0, validation also applies to CO Group records.
- Note that while Validators can apply to Email Addresses, the uniqueness check described above applies only to Identifiers attached to CO Person or CO Group records.)
- Identifiers and Email Addresses generated via Identifier Assignment are subject to validation.
- Identifiers and Email Addresses loaded via Organizational Identity Sources and Registry Pipelines are not subject to availability checks or validation.
Technical Notes
To skip availability checks, including all Identifier Validation Plugin calls, use save($data, array('skipAvailability' => true)).
Copyright (C) 2018-2020 University Corporation for Advanced Internet Development (Internet2) - All Rights Reserved