Example customizing the cancel button for the Airlock 2FA migration page

This article explains how to customize the Loginapp REST UI using a token migration page as an example.

Example Scenario

When migrating from another 2nd factor to Airlock 2FA, a page displays a QR code which is scanned by the end-user with a mobile app (e.g. the Airlock 2FA app).

By default, the page contains a cancel button which - when clicked - informs the user that the migration process has been canceled.

The cancel button example is used to show

  • how to display additional information on the cancel operation.
  • how to hide the cancel button altogether.

Set a step ID in the IAM configuration

To be able to customize the example page using the UI SDK, the corresponding authentication flow step must be equipped with a step ID:

  1. Go to:
    Loginapp >> Authentication Flows
    then select the affected authentication flow and within it navigate to the Airlock 2FA Activation Step plugin.
  2. Set a Step ID (the id my-custom-step is used in the examples below).
  3. The step ID is used in the UI SDK to define the scope of the customization.

Modify texts using the UI SDK

To modify the texts displayed on the example page, do the following in the UI SDK customization folder:

  1. Open the language properties files in
    and change the following properties:
  2. custom.step.my-custom-step.authentication.pages.messages.cancel: customize the message that is shown after the user clicks the Cancel button.
  3. custom.step.my-custom-step.authentication.airlock-2fa.migration.instruction: customize the text shown on the migration page above the Qr code, e.g, instruct the user to scan the QR code with the mobile app.
  4. custom.step.my-custom-step.authentication.airlock-2fa.migration.do-no-close: customize the text shown on the migration page below the QR code, e.g., instruct the user to wait until the app is activated.

Suppress the cancel button using the UI SDK

To hide the cancel button on the example page, do the following in the UI SDK customization folder:

  1. Open
  2. Add the following code snippet to suppress the Cancel button:
  3. [data-iam-step-id='my-custom-step'] {
        #cancelButton {
            display: none;