Migration from 2.1.x to 2.2.0
This guide contains instructions for migration from PowerAuth Enrollment Onboarding Server version 2.1.x to version 2.2.0.
Onboarding process state machine
Added limit for identity verification records processed by a single scheduled task calling next state. The default limit is 10_000 and can be configured by property enrollment-server-onboarding.identity-verification.next-state-batch-size.
Replaced Event
We replaced old event type FINISHED with the new event type PROCESS_FINISHED. Event is triggered at the end of the onboarding process.
The previous event was connected with the end of the identity verification stage. Currently, it is connected with the end of the process. In most cases, there is no difference except for temporary activation. Here, we can have a scenario where identity verification is ACCEPTED, but the process ends in a FAILED state for whatever reason.
The event is triggered if the process ends in a FINISHED or FAILED state (see eventData.process.status).
Old format (event FINISHED)
{
"type": "FINISHED",
"userId": "",
"processId": "",
"processType": "",
"identityVerificationId": "",
"eventData": {
"locale": "",
"clientIPAddress": "",
"httpUserAgent": "",
"requestId": "",
"fdsData": {}
}
}
New format (event PROCESS_FINISHED)
{
"id": "",
"timestamp": "",
"type": "PROCESS_FINISHED",
"userId": "",
"externalUserId": "",
"processId": "",
"processType": "",
"identityVerificationId": "",
"eventData": {
"process": {
"status": "FINISHED",
"errorDetail": null,
"deviceData": {
"locale": "",
"ipAddress": "",
"httpUserAgent": "",
"fdsData": {}
}
}
}
}
All details are described in Events Documentation.
Database Changes
For convenience, you can use liquibase for your database migration.
For manual changes use SQL scripts:
External User ID
A new column external_user_id was added to the es_onboarding_process table.
The column stores an external user identifier used by the presence check provider (e.g. iProov).
It is NULL at the start of the process and set during the presence check phase.
Configuration
Events
A new property enrollment-server-onboarding.onboarding-process.process-event.types has been added to the configuration.
It contains a list of event types that are supported to be published.
The default value is PROCESS_FINISHED, DOCUMENT_VERIFICATION_FINISHED, FINAL_DOCUMENT_VERIFICATION_FINISHED, and PRESENCE_CHECK_FINISHED.