--- title: "Forms Authentication" slug: "forms-authentication" tags: ["Login type", "Access Control Center", "Super Admin"] updated: 2024-05-08T13:39:11Z published: 2024-05-08T13:39:11Z canonical: "help.symphonysummitai.com/forms-authentication" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.symphonysummitai.com/llms.txt > Use this file to discover all available pages before exploring further. # Forms Authentication **Form Authentication** is used in applications where users are required to enter their credentials (such as username and password) into a form provided by the application in order to authenticate and gain access to secured resources. ### Default Login **To add a new** **Authentication****, perform the following steps:** 1. Navigate to **Platform Studio** > **Access Control Center** > **Authentication** > **User Authentication Details**. You can click **Add Authentication** to add it to the instance. The Authentication list page is displayed. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1691990500478.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=NIrIwHkn22Pqe7JhxMavRbHi5S80%2Fl6acakj4%2B%2Bllo4%3D)Figure: Add Authentication 2. You can define the basic information such as **Domain**, **Sub Domain**, and **URL** for the selected fields.![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1705569606027.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=k9Mvtvbk9TDkKouf4L4HL11cYuXIrXue99T%2BU3Kr1Og%3D)Figure: Details page Refer to the Field Description for more details. **Field Description** | **Field** | **Description** | | --- | --- | | **Domain*** | Select the **Domain** from the drop-down list. | | **Sub Domain*** | Based on **Domain** selection, choose the **Sub** **Domain** from the drop-down list. | | **URL*** | Select unique **URL** configured for **Domain** and **Sub Domain**. If you click **Save** and a valid **URL** is not entered in the text box, then the following validation message appears **Please enter all mandatory information**. If you enter an invalid **URL**, then a validation message **Not a valid URL** appears*.* You can also view the configured **URL** by clicking the **ID**. The respective configuration opens in edit mode under a new tab. | | **Active** | Enable the switch ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704362760380.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=bbYOSMv53eSwimuI4S4%2B6Ca6xv4IAKUh6fv5kCzUXlg%3D) to make the Authentication **Active**. Activating authentication configurations allows for immediate testing and validation of the setup. This helps ensure that the authentication mechanisms are functioning as intended and that any issues can be identified and addressed promptly. | 3. Click **Next** to select **Forms** from the **Authentication Type**. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1677842500232.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=yAU2lc4dxj9OJeyjwYgmvJ8%2B1aU8j5G6dX9ljs%2BfkWI%3D)Figure: Form Login 4. Configure **Forms** Authentication if you want to authenticate the user using a username and password.  5. Navigate to **Default Login** tab and click **Login Type**. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1705569291645.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=HcnpILyP12iMbYHP7AY37T00MPWRroTgTfCnbswgRkY%3D)Figure: Login Type The following table contains a brief description of **Login Type**. Table | Login Type | Description | | --- | --- | | **Password Based** | If the **Password** option is selected, the user must enter the **Password** for logging in to the application.![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704361325886.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=s%2FzNHS5ZkH3FSCheLW3CWzS1JGbrDqxJsbCeO%2BDeS4c%3D)Figure: Login Type | | **OTP Based** | If **OTP via SMS** is checked, the system generates a temporary and single-use code, and it is sent to the user's mobile phone as an SMS. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704361704856.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=k5LQPQDllLQWk4fXjQB8KiRggAoZGXAWoKIJ1wTseRA%3D)Figure: OTP via SMS For **O****TP via Email** option, a temporary and single-use code is generated and sent to the user's registered email address for authentication. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704361664383.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=d%2FDvJXfrD1ll55FXoKKK%2FBymcB2BFGINGyOHM76G3g8%3D)Figure: OTP via Email For **O****TP via Voice** option, a system generates a temporary and single-use code, and the code is conveyed to the user through an automated voice message. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704361766797.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=f6oZM6e0%2FiPfDagSn%2FGU52sy%2FLoCYBama8nge69srZk%3D)Figure: OTP via Voice | | Specify the **OTP Expiry** time. The expiry time is set to ensure that even if the OTP is intercepted, it becomes invalid after a certain period, enhancing overall security. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704361860777.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=4b7wZiOB38K4dYQJE%2FKpSWpe%2FWqlIEIX7dkBCVMsLOA%3D) Figure: Select OTP Expiry![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704362088633.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=z9vO9lccdpAQh8NJKi%2BwWmCOCvkveNOVbfpC69lF12Q%3D)Figure: Minutes and Seconds Specify the **Minutes** and **Seconds** under this field. | | Specify the Resend OTP Timespan. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704361877367.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=JHEuIN7ByNWqTc9fVuwrHIvWjeR4k3RpHmKbcCsjZ%2FY%3D) Figure: Resend OTP Select the time from the drop-down list. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704362252299.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=%2FwJMSb%2B4t3%2BwARDJXdCirgaRLldqG2TKgp9DX0DgKDQ%3D)Figure: Timespan | 6. Click **Next** to navigate to the **Authentication** **Details**. ### Two-factor Authentication When you enable the **Two-factor** **Authentication,** the following screen view is displayed.![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704366965209.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=4e743RvGngGIaWIhlYCMTH43KbxZX9JltIA1lv0EKXU%3D) Figure: Two-Factor Authentication ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1671704186114.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=ZlKsO3BNiy1JxkMAEGHoMq20vZmN07iSpNC1dnaUFjw%3D) Figure: Login Type-Forms If **Two Factor Authentication** is enabled, the following list of **Login Type** displays for the configuration. See the field description for more details. ### Field Description | Serial # | Login Type | Authentication Details | | --- | --- | --- | | 1 | **Password Based** | Select the **Login Type** as **Password Based** for logging to the application. In a **Password-Based** login system, user needs to enter a username or email address along with a secret password to prove their identity. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704365865259.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=GMX9m1WJvpcwtFRrBu6BxU3PFm6XeCAuvUG3qRzlcvw%3D) Figure: Password Based | | 2 | **OTP Based** | Select **Authentication Type** as **OTP** **Based** on the drop-down list and check OTP via Email or OTP via SMS or OTP via Voice based on the requirements. Figure: OTP Based Enter the **OTP Expiry** and **Resend details** under the column values. This indicates the amount of time a generated OTP is valid. After this period, the OTP becomes invalid for authentication. The screenshot displays the related fields. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1705569893397.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=yqHAogpbEfm8OO3iJWs13McJ5m23e2umyS1p2vpMJAM%3D) Figure: OTP details **Resend details** involve the rules and options for resending OTPs. Users might request a new OTP if the previous one has expired or if they didn't receive it. | | 3 | **Authenticator App** | Select **Authentication Type** as **Authenticator App** from the drop-down list. It generates one-time passwords (OTPs) or authentication codes for two-factor authentication (2FA) that require users to enter a temporary code generated by the authenticator app in addition to the regular password. See the screenshot for more details. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1704366107607.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=1CpYZhgrxj6XYICcCUeaNVTtFhD65ynjvruBqFNFvf8%3D) Figure: Authenticator App | Click **Next** to navigate to **Customize Login Screen** for **Form Authentication**. --- NoteTwo-factor authentication is disabled always by default. ### New User Registration If the user's basic details are available but the password is unset, the user will be prompted to register by answering questions. Upon successful completion, a system-generated password will be sent to the registered email-ID.  There is an option to enable the Register User toggle, which opens or closes the menu when clicked, facilitating the generation of passwords for existing users. Enabling this option will provide a Click here to register with us link on the Apex platform login page. The decision to enable the Register User option is optional and depends on your specific requirements. Refer to the screenshot for more details.![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1705562319382.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=83bGxk27Bj7lIR6YLWaKI5d%2BkLuZ%2BGnwbwKVc%2Bvehqk%3D)Figure: Register User See the table below for more **Request User**-related configuration. Table | Field | Description | | --- | --- | | **Registration Link Expiry (In Minutes)** | Specify the expiry time in minutes. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1705568318219.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=YponaiXboc2hvIB6n%2BzLnNmnBCQCBgj8ELitGVKxWCI%3D)Figure: Registration Link Expiry | | **Questions** | Add the fields under **Questions** for User Registration. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1705568489532.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=UEDQinhLvGaEwViX8FmdRHbKUKUzhPrI4eO1xHCZgx8%3D)Figure: Field values Click **+** icon to add more field details. The values in configured **Question** fields must be present for all users, as these fields are mandatory during the user registration process. See the screenshot for values available under drop-down list. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1705569010064.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=WySKcVZqHJcTy6IylsiKu%2BivLLjczqnKUjmBEMJMic4%3D)Figure: QuestionsNoteThe configured user login page appears as shown below: ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1705640515374.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=xzdzG5UWeDZkOqu%2B3L2tJk58rArSlafkzpT79%2Fv35c0%3D)Figure: User login screen If End User clicks ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1705640813876.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=x%2FBc0Bsq1rofY%2FKuJ1nSAIW3aWYqwyt9VBfKeIqSOU8%3D), pop-up screen for registering user details appears as shown below. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1705641170942.png?sv=2026-02-06&spr=https&st=2026-11-17T01%3A07%3A01Z&se=2026-11-17T02%3A07%3A01Z&sr=b&sp=r&sig=69VdpFef%2BQkLTDXrjcEnmYBYsAvfsFd8vLvSuXgkyFY%3D)Figure: Registration screen |