The concept of maintenance message Locations has been introduced to allow for a more flexible configuration of end-user UIs.
This concept can serve different purposes. It can be used:
- to display maintenance messages in different locations (e.g. bottom, top, right, left).
- to provide different messages for different client types (e.g. HTML for web clients, plain text for mobile app clients).
The idea is to provide a Location attribute with each maintenance message. When querying for the currently valid maintenance message, the client (IAM Loginapp or a 3rd party REST client) uses the corresponding location. Like this, multiple maintenance messages can be managed and queried independently.
How and where the client displays the maintenance message is a task left to the client. When styling the Loginapp UI, customization using JavaScript is required to customize the selection and display of maintenance messages. By default, the Loginapp UI will display all messages at the bottom of the login screen as shown here Maintenance messages examples in the Loginapp.
- The number of Locations is not limited.
- Locations must be defined in:
- Adminapp maintenance messages configuration: defines the set of available Locations on the maintenance message management page. Go to: Adminapp >> Maintenance Messages.
- Loginapp REST API (Loginapp >> Maintenance Messages): defines the Locations accepted by the Loginapp REST API.
- Loginapp UI (Loginapp >> UI Settings >> Authentication & Authorization UIs >> Non-Flow UI Settings >> Maintenance Message UI Settings) to define location filters used by the UI.