Configuring Custom URL and Login Pages

Overview

A Login URL determines which login page is displayed to users when they navigate to a specific site address. It consists of two parts:

• Site URL – The base address users will navigate to.

• Login Page – The login interface that will be presented.

Each Login URL must be linked to an Identity Provider to enable user authentication within the Encodify platform.

Note: A Login URL must be configured for each Identity Provider to ensure users are routed to the correct login experience.

Configuring a Login URL

Adding a Login URL

To add a new Login URL:

1. Click Add New Login URL.

2. Enter the Base Site URL. (This is typically pre-filled based on the current site settings.)

3. Select the Login Page to be used.

4. Click Save.

Configuring a user-defined Login Page

Login Pages define the design and behaviour of the login interface shown to users when they access an Encodify site. You can create custom login pages using HTML and CSS, control their appearance, preview them, and assign them to specific sites.

Note: Custom login pages can only be applied after a Login URL has been created and assigned to a site.

Creating a Login Page

To create a custom login page:

1. Navigate to Site Configuration > Identity Providers and Users > Login Pages.

2. Click Add New Login Page.

3. Complete the following fields:

4. (Optional) Add Custom CSS, allowing you to redefine styles for login page elements.

5. (Optional) Add Custom HTML, allowing you to insert elements that render below the "Forgot Password" link.

6. Click Preview Login Page to see how the login page will appear.

7. Click Save to create the login page.

Note: If you want to render external resources on login page such as images, video, JS applications etc., place all resources you need in <EncodeWebApplicationFolder>/css/custom/common/ folder and link to them as following, for example:

<img src="https://qa.test.com/qa/css/custom/common"></img>

Managing Login Pages

On the Login Pages screen, you can:

• Preview: Click the ellipsis next to a login page and select Preview.

• Edit: Click Edit, update the fields or design, and click Save.

• Delete: Select Delete from the ellipsis menu to remove a login page.

Assigning Login Pages to Sites

Login pages are site-specific. To assign a login page to a site:

1. Go to System Configuration > Site List.

2. Click the Edit icon for the desired site.

3. Open the Appearance tab.

4. From the Login Page dropdown, select the page to assign.

5. Click OK to save.

Once assigned, logging out and revisiting the site will load the selected login page.

User-defined login pages can also be accessed directly via URL. For example:

In the URLhttp://qa.test.com/qa/common/login/ebms?LoginPage=user_defined_5, the ?LoginPage parameter specifies which login page to use. You can select the desired login page by adding ?LoginPage=user_defined_{id} to the URL, where {id} corresponds to the login page’s identifier.

To set a user-defined login page as the default, specify it in the System.properties file. The default login page will be used for any sites that do not have a specific login page configured or are set to use the default. To do this, add the following line to your System.properties file:

iniCopyEditloginPage=user_defined_{id}

Setting a Default Login Page

To use a specific login page as the default (for all sites that don’t have one assigned):

1. Open the System.properties file.

2. Add the following entry:

propertiesCopyEditloginPage=user_defined_{id}

3. Restart the application server for the changes to take effect.

Enabling Access Requests for New Users

Users without an account can request access from the login page if the feature is enabled.

To enable:

1. In the login page editor, make sure the Enable “New User Request” option is checked.

2. Add the following properties to your System.properties file:

propertiesCopyEditnew.user.request.mailto=admin@example.com
new.user.request.subject=New User Access Request
new.user.request.templateFile=../properties/common/new_user_request.template

• mailto – Required. A comma-separated list of email recipients.

• subject – Optional. Subject line for the email (default used if omitted).

• templateFile – Optional. File path for the email body template. Default template is used if not specified.

3. Restart the application server to apply changes.

To submit a request:

1. On the login page, click New User Request.

2. Fill in the required fields: Full Name, Email Address, and Company.

3. Click Send Request.

The request is emailed to the addresses specified in your System.properties.