Airlock IAM 8.3 - Deprecation announcement for future releases

REST Endpoints

Topic	Description	May be removed in version	Deprecated since
Legacy health endpoint	The legacy health endpoint `/rest/health` will be removed. Use the official health endpoint as documented in Monitoring, health checks, and metrics.	9.0	7.5
Legacy password self-service endpoint	The legacy password change self-service endpoint `/rest/protected/my/password/change/` will be removed. Use the corresponding protected self-service endpoints instead.	9.0	8.2
Legacy mTAN token self-service endpoints	The legacy mTAN token self-service endpoints `/rest/protected/my/tokens/mtan/` will be removed. Use the corresponding protected self-service endpoints instead.	9.0	8.1
Legacy Cronto token self-service endpoints	The legacy Cronto token self-service endpoints `/rest/protected/my/tokens/cronto/` will be removed. Use the corresponding protected self-service endpoints instead.	9.0	8.2
User identification endpoint (authentication)	The Loginapp REST endpoint `/public/authentication/username/identify` will be removed. Use `/public/authentication/user/identify` instead.	9.0	8.2
User identification endpoint (self-service)	The Loginapp REST endpoint `/public/self-service/username/identify` will be removed. Use `/public/self-service/user/identify`instead.	9.0	8.2
OTP resend information	The following REST endpoints return information about a possible OTP resend in the field `included` in the response. This field has been deprecated and may be removed with the next major release. The information is returned as additional attributes. `/protected/self-service/approval/mtan/otp/resend/ /protected/self-service/approval/mtan/tokens/{id}/select/ /public/authentication/mtan/otp/resend/ /public/authentication/mtan/otp/resend/ /public/authentication/mtan/tokens/{id}/select/ /public/self-service/approval/mtan/otp/resend/ /public/self-service/approval/mtan/tokens/{id}/select/ /transaction-approval/mtan/otp/resend/ /transaction-approval/mtan/tokens/{id}/select/`	9.0	8.3
Retrieve endpoints	The following REST "retrieve" endpoints have been deprecated and may be removed with the next major release. The information is returned as additional attributes with the preceding REST response and thus allows to do with fewer roundtrips. /protected/self-service/airlock-2fa/activation/challenge/retrieve/ /protected/self-service/airlock-2fa/device-edit/data/retrieve/ /protected/self-service/approval/airlock-2fa/devices/retrieve/ /protected/self-service/approval/airlock-2fa/mobile-only/challenge/retrieve/ /protected/self-service/approval/airlock-2fa/offline-qr-code/challenge/retrieve/ /protected/self-service/approval/cronto/challenge/retrieve/ /protected/self-service/approval/cronto/push-devices/retrieve/ /protected/self-service/approval/fido/challenge/retrieve/ /protected/self-service/approval/matrix/challenge/retrieve/ /protected/self-service/approval/mtan/otp/resend-info/retrieve/ /protected/self-service/approval/mtan/tokens/retrieve/ /protected/self-service/cronto/activation/challenge/retrieve/ /protected/self-service/cronto/activation/start-challenge/retrieve/ /protected/self-service/cronto/device/info/retrieve/ /protected/self-service/cronto/push-devices/activation/challenge/retrieve/ /protected/self-service/fido/credential/info/retrieve/ /protected/self-service/selection/options/retrieve/ /public/authentication/airlock-2fa/activation/challenge/retrieve/ /public/authentication/airlock-2fa/activation/challenge/retrieve/ /public/authentication/airlock-2fa/activation/device-edit/data/retrieve/ /public/authentication/airlock-2fa/activation/device-edit/data/retrieve/ /public/authentication/airlock-2fa/devices/retrieve/ /public/authentication/airlock-2fa/devices/retrieve/ /public/authentication/airlock-2fa/mobile-only/challenge/retrieve/ /public/authentication/airlock-2fa/mobile-only/challenge/retrieve/ /public/authentication/airlock-2fa/offline-qr-code/challenge/retrieve/ /public/authentication/airlock-2fa/offline-qr-code/challenge/retrieve/ /public/authentication/airlock-2fa/zero-touch-info/retrieve/ /public/authentication/airlock-2fa/zero-touch-info/retrieve/ /public/authentication/cronto/activation/challenge/retrieve//public/authentication/cronto/activation/challenge/retrieve/ /public/authentication/cronto/activation/start-challenge/retrieve/ /public/authentication/cronto/activation/start-challenge/retrieve/ /public/authentication/cronto/challenge/retrieve/ /public/authentication/cronto/challenge/retrieve/ /public/authentication/cronto/push-devices/activation/challenge/retrieve/ /public/authentication/cronto/push-devices/activation/challenge/retrieve/ /public/authentication/cronto/push-devices/retrieve/ /public/authentication/cronto/push-devices/retrieve/ /public/authentication/fido/challenge/retrieve/ /public/authentication/matrix/challenge/retrieve/ /public/authentication/matrix/challenge/retrieve/ /public/authentication/migration/options/retrieve/ /public/authentication/migration/options/retrieve/ /public/authentication/mtan/otp/resend-info/retrieve/ /public/authentication/mtan/otp/resend-info/retrieve/ /public/authentication/mtan/tokens/retrieve/ /public/authentication/mtan/tokens/retrieve/ /public/authentication/secret-questions/status/retrieve/ /public/authentication/secret-questions/status/retrieve/ /public/authentication/selection/options/retrieve/ /public/authentication/selection/options/retrieve/ /public/self-service/approval/airlock-2fa/devices/retrieve/ /public/self-service/approval/airlock-2fa/mobile-only/challenge/retrieve/ /public/self-service/approval/airlock-2fa/offline-qr-code/challenge/retrieve/ /public/self-service/approval/cronto/challenge/retrieve/ /public/self-service/approval/cronto/push-devices/retrieve/ /public/self-service/approval/fido/challenge/retrieve/ /public/self-service/approval/matrix/challenge/retrieve/ /public/self-service/approval/mtan/otp/resend-info/retrieve/ /public/self-service/approval/mtan/tokens/retrieve/ /public/self-service/selection/options/retrieve/ /public/self-service/verification/secret-questions/retrieve/ /public/user-self-registration/airlock-2fa/activation/challenge/retrieve/ /public/user-self-registration/selection/options/retrieve/ /transaction-approval/airlock-2fa/challenge/retrieve/ /transaction-approval/airlock-2fa/devices/retrieve/ /transaction-approval/airlock-2fa/mobile-only/challenge/retrieve/ /transaction-approval/cronto/challenge/retrieve/ /transaction-approval/cronto/push-devices/retrieve/ /transaction-approval/matrix/challenge/retrieve/ /transaction-approval/mtan/otp/resend-info/retrieve/ /transaction-approval/mtan/tokens/retrieve/ /transaction-approval/selection/options/retrieve/ As a consequence, the following next-step codes concerning retrieval will also be removed: `AIRLOCK_2FA_DEVICE_ACTIVATION_POLLING_REQUIRED` (use instead: `AIRLOCK_2FA_DEVICE_ACTIVATION_REQUIRED`) `AIRLOCK_2FA_MOBILE_ONLY_CHALLENGE_RETRIEVAL_REQUIRED` (use instead: `AIRLOCK_2FA_POLLING_REQUIRED`) `FIDO_APPROVAL_CHALLENGE_RETRIEVAL_REQUIRED` (use instead:`FIDO_APPROVAL_ASSERTION_RESPONSE_REQUIRED`) `FIDO_AUTHENTICATION_CHALLENGE_RETRIEVAL_REQUIRED` (use instead: `FIDO_AUTHENTICATION_ASSERTION_RESPONSE_REQUIRED`)	9.0	8.3