Custom Login Prompt

IMPORTANT

This feature is available starting from release harness-0.30.0.

Custom login prompt allows organizations to display security, legal, or compliance notices—such as U.S. Government consent banners— ensuring users see and acknowledge important information before accessing the platform.

Showing a login prompt to users can be important in the following use cases:

• Regulatory compliance that may require user consent or policy acknowledgement.

• Legal protection by showing terms of use, data usage policies, or disclaimers before granting access.

• Security awareness by reminding users of acceptable use policies, confidentiality requirements, or security best practices.

Configuration Steps

Follow these steps to enable and configure the Custom Login Message:

1. Write the information you want to display in the prompt using valid HTML format. Ensure the content is properly sanitized to prevent XSS or injection risks.

2. Encode the HTML content to Base64.

   • Use any standard tool or command. For example:

     cat your-message.html | base64

   • Once you have encoded your HTML, here’s an example of what the output will look like (truncated for readability):

     PCFET0NUWVBFIGh0bWw+CjwhLS0gc2F2ZWQgZnJvbSB1cmw9KDAwMjIpY2hyb21lOi8vbmV3LXRhYi1wYWdl...

3. Configure the environment variable.

   Add the Base64-encoded string to your values.yaml file in the ng-auth-ui service, config → CUSTOM_EULA_POLICY as shown below:

   ng-auth-ui:
     config:
       CUSTOM_EULA_POLICY: "<your-base64-encoded-html>"

   Example:

   ng-auth-ui:
     config:
       CUSTOM_EULA_POLICY: "PCFET0NUWVBFIGh0bWw+CjwhLS0gc2F2ZWQgZnJvbSB1cmw9KDAwMjIpY2hyb21lOi8vbmV3LXRhYi1wYWdlLyAtLT4KPGh0bWwgZGlyPSJsdHIiIGxhbmc9ImVuIiBjbGFzcz0iIiBsYXp5LWxvYWRlZD0idHJ1ZSI+PGhlYWQ..."

4. Upgrade your Helm chart to apply the changes:

   helm upgrade -i <release-name> <path-to-directory> -n <namespace> -f values.yaml

   Once you have successfully upgraded your Helm chart, your custom login prompt will appear on the login screen, similar to the example shown below.

   

   custom-message