Enabling a Login Module
On the Environment Administration page, you can enable custom login modules based on application needs. Enable the setting to connect or disconnect login modules to applications. Disable the setting to prevent login modules from being connected or disconnected from applications.
To enable an existing login module:
| 1.
|
At the top right of the Unqork Designer Platform, click the drop-down. |
| 2.
|
Select Administration. |
| 3.
|
Under Environment, select Environment Administration. |
| 4.
|
Navigate to the General settings section of Environment Administration. |
| 5.
|
Set Enable Custom Login/Logout Modules to (checked). |
| 6.
|
At the bottom of the page, click Save Changes. |
Login modules do not display in when you disable this setting. Disabling the custom login module setting reverts all affected applications back to the default login screen for the environment.
Creating a Login Module
Create and connect a login module during the application creation process. This method names the login module and connects it to the new application for you.
To create and connect a login module when creating a new application:
| 1.
|
Navigate to your workspace and click + Create App. |
| 2.
|
In the Create App pop-up , complete the required application information. |
| 3.
|
From the Login Module drop-down, select FENew Login Module. |
Login modules created in the Create App pop-up modal are named after the application and end with the text "Login". For example, Acme Corp Login.
From here, open the module and customize your login screen. Here are a few ideas of components you can add to begin:
The Unqork Marketplace offers a Login Moduletemplate containing everything you need to set up a login page.
Connecting a Login Module to an Application
On an existing application's App Settings page, you can connect a login module.
To connect a login module to your application:
| 1.
|
Navigate to your workspace and locate your application tile. |
| 2.
|
Click the ellipsis (···) menu. |
| 3.
|
Select Settings. |
| 4.
|
From the Login Module drop-down, enter or select a login module. |
Creating a Login Module Library Element
You can also create a login module as a Library Element before connecting it to your application. By adding your module to the Library, you can share it with all your applications.
To create a login module Library Element for your application:
| 1.
|
At the top right of the Unqork Designer Platform, click the drop-down. |
| 2.
|
Select Library Elements. |
| 4.
|
In the Module Name field, enter a name for your module. |
To easily locate your login module later, begin the module name with Login. For example, Login: Acme Corp.
Previewing a Login Module
It's important to note that all modules you plan to have navigate to using your login module must exist in the same application. Otherwise, you'll receive a 403 error. The following image shows you how to preview a module at the Application level:
To successfully preview your login module, you must preview it at the Application level. Otherwise, you must manipulate the browser URL to consider any redirects. The URL looks like the following: https://www.{your-environment}.io/app/{appPath}#/display/{moduleId}/{submissionId}/{moduleId}.
Disconnecting a Login Module
If you decide you don’t want a login module in your application anymore, you can remove it.
To remove a login module from an application:
| 1.
|
Navigate to your workspace and locate your application. |
| 2.
|
Click the ellipsis (···) menu. |
| 3.
|
Select Settings. |
| 4.
|
From the Login Module drop-down, click the X next to the login module’s name. |