Customize UI login errors

This page describes how to customize errors when a login via a portal (for example, with SAML) fails and redirects to the UI with an error parameter

When login fails, the UI may redirect to a login error page. You can customize this page to display relevant error messages with custom text.

The default labels in the lang_en_US_labels.json file include the following:

    "login.error.404":"Login error, server is down.",
    "login.error.503":"Server unavailable or restarting.",
    "login.error.DEFAULT":"Login error, please contact with your administrator.",
    "login.error.SAMLERROR":"Login error, please contact with your administrator.",

To configure display of custom error messages for SAML, on the Abiquo API Server, set the following property to point to your UI server. For example, for a UI server at abiquo.example.com:

abiquo.saml.redirect.error.endpoint = https://abiquo.example.com/ui/?error=ERRORPARAMETER

To create the error message text:

Edit the labels file for your language, for example, lang_en_US_custom.json
For each error message, add a label with the error parameter code as follows
"login.error.ERRORPARAMETER": "Error message text",
To set the default error for the platform to display if there is no query parameter, use the following pattern.

When a login fails, the URL will redirect to the error page with the error query parameter.

For example, for a UI server at abiquo.example.com:

The UI will display the error page with the error message text.

For more details about customizing UI labels, see Abiquo UI client language configuration .