Registry v4.1.0 introduce the concept of Vetting, where a CO Person can be reviewed via one or more vetting processes (called Vetting Steps) for such purposes as background checks or compliance. Vetting Steps can be run on demand, or as part of an Enrollment Flow.

Vetting Steps are implemented via Vetting Plugins. Vetting Steps are configured at the CO level, meaning in the current implementation the same Vetting Steps are applied to all members of the CO, regardless of COU memberships or other considerations. The data used for Vetting is specific to each Plugin.

Configuring Vetting Steps

Vetting Steps are configured via COConfigurationVetting Steps with the following settings:

Vetting Requests

Manual Vetting

A Vetting Request may be registered for a specific CO Person via the CO Person record, by selecting Vetting Requests from the side menu, and then (plus) Register Vetting Request. Only one Vetting Request for a CO Person may be registered at a time. Any previous Request must be completed or canceled before a new Request can be registered.

Registering a Vetting Request queues a Job to process the request, as described below.

Manual Vetting does not currently result in automatic changes to the CO Person status. For example, a Failed result will not suspend or lock the CO Person record. This behavior is subject to change in a future release.

Processing Vetting Requests

Vetting Requests are processed asynchronously via VetJob. Vetting Steps are processed one at a time, in order, and may return the following statuses:

Vetting via Enrollment Flows

Vetting Requests can be created as part of an Enrollment Flow by ticking Request Vetting in the Enrollment Flow configuration. The Vetting Request is registered after all Petitioner and Enrollee steps are completed, but before Approval. (warning) Note that Require Approval For Enrollment must be set for Vetting to take place, since the Approval step is how the Enrollment Flow is re-entered after the Vetting Request has been processed.

The Petition will remain in Pending Vetting status until the Vetting Request has completed. If Vetting fails, the Petition is automatically denied.

(warning) If a Vetting Request associated with a Petition is canceled, the Petition will remain in Pending Vetting status until manual intervention.

Viewing Vetting Requests

Vetting Requests may be viewed via the CO Person record, or via PeopleVetting Requests.

CO Administrators can view and resolve any Vetting Steps (Pending Manual Review) within the CO. Members of any Vetting Group associated with any Vetting Step may view all Vetting Requests (and all Vetting Steps within those Requests), but a Vetting Step can only be resolved by members of the Vetting Group associated with that Step.

See Also