Migration from 1.10.x to 2.0.x
This guide contains instructions for migration from PowerAuth Cloud version 1.10.x to version 2.0.0.
REST API Migration
The REST API has been updated to reflect changes required for integration with PowerAuth server 2.0.x, which introduces post-quantum cryptography.
REST API Updates
GET /admin/application/{id}
The application detail endpoint no longer contains parameter masterServerPublicKey. The configuration of mobile SDK is available in parameter mobileSdkConfig.
GET /v2/registrations/{registrationId}
The registration detail endpoint parameter activationCodeSignature is deprecated and will be removed in a future release. Use parameters activationCodeSignatureEcdsa instead for ECDSA signature and activationCodeSignatureMldsa for ML-DSA signature.
POST /v2/signature/verify
The signature verification endpoint is deprecated and will be removed in a future release. Use endpoint POST /v2/authentication/verify instead.
POST /v2/token/verify
The token verify endpoint parameter signatureType is deprecated and will be removed in a future release. Use parameters authenticationCodeType instead.
POST /v2/operations/{operationId}/offline/otp
The operation offline OTP validation endpoint parameter signatureType is deprecated and will be removed in a future release. Use parameters authenticationCodeType instead.
GET /admin/templates
The template list endpoint has been modified to return authenticationCodeTypes instead of signatureTypes in the template detail. This change was done to unify terminology due to updated REST API parameter naming.
Registration Attributes
The API endpoints GET /v2/registrations, and GET /v2/registrations/{registrationId} newly return the following attributes:
parentRegistrationId- Parent registration ID if the registration is created using a transfer.transferType- Transfer type of the registration, eitherSPAWNorMOVE.
Structured logging
All endpoints contain structured logging. At the INFO level, the action, its state, and important parameters are logged.
For example: action: createApplication, state: initiated, applicationId: app-example
To log the full request and response, set the logging level to DEBUG.