The Generate Authenticator App URI action generates the URI information required for users to initiate two-factor authentication (2FA) using mobile applications such as Google Authenticator or Microsoft Authenticator. This URI can be displayed as a QR code or entered manually. For the action to work, the necessary 2FA configurations must first be made through the Configuration Manager module, where the system generates and stores a user-specific secret key. When triggered by an OnClick trigger, this action, which is linked to a button such as ‘Start 2FA’, generates a user-specific URI and displays it as a QR code, usually as a one-time code.

Technical Features

URI Generation: A URI is generated that will work in integration with two-factor authentication applications.
Secure Login Preparation: The application link is defined so that the user can receive authentication codes.
Web & Mobile Compatibility: Can be used in both web and mobile applications.
QR Code Support: The generated URI can be converted to QR code format and displayed to the user.

Generate Authenticator App Uri Action Application Steps

1. Adding the Generate Authenticator App Uri Action

Log in to the Kuika platform.
Open your project from the Apps screen.
Go to the UI Design module.
Create the element that will initiate URI generation (e.g., ‘Start 2FA’ button).

Select the button and add the Authorisation > Generate Authenticator App URI action from the + ADD ACTION menu according to the desired trigger event (Initial Actions, OnClick, OnBlur, etc.).

2. Configuring Parameters

User Name (String- Required): The username or email address of the user for whom the URI will be created.

It is usually defined using data sources such as Action Result, Current, Form Component, Screen Input, or Fixed, and can be linked via the Symbol Picker.

Use Case: Configuring 2FA with a QR Code

When a user clicks the ‘Start 2FA’ button in the application, the system generates an Authenticator URI for them and displays it on the screen as a QR code. The user scans this QR code with the authentication app on their phone to complete the 2FA process.

Element: ‘Start 2FA’ button
Trigger: OnClick
Action: Authorisation → Generate Authenticator App URI
User Name: Current.email (taken from the user's email address form field)

Generate Authenticator App URI Advanced Customisations

QR Code Display: Link the generated URI to a QR Code component to make it scannable by the user.
Form Integration: By integrating with the user form, 2FA setup can be performed immediately after account creation.

Technical Risks and Precautions

Invalid User: If the User Name parameter belongs to a user not defined in the system, URI generation will fail.
Privacy: After the URI is generated, it should be a temporary process specific only to that user. It should not be shared with others.

Generate Authenticator App Uri is a critical security component that allows users to link their accounts with authentication applications. In Kuika applications, this action simplifies 2FA setup and enhances application security. It offers a flexible and robust authentication infrastructure with QR code integration and user-based URI generation.