Overview

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 Assignment will, however, only create identifiers of the format specified.)

As of v1.1.0, Identifier Validation Plugins allow for additional validation to take place. Supported use cases include

• Extending availability checks beyond the Registry 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.

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)
• Note that while Validators can apply to Email Addresses, the uniqueness check described above applies only to Identifiers attached to CO Person records.)
• Identifiers and Email Addresses generated via Identifier Assignment are subject to validation.
• Identifiers and Email Addresses loaded via Organizational Identity Sources 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)).