Customizing SAML login forms in Sierra

Library administrators can fully customize the SAML login form used for patron and staff authentication via Web Master in the Sierra client. This allows libraries to independently configure:

  • custom messages/text

  • logo

  • colors and CSS styles

  • button appearance

  • other UI customizations defined in the custom_messages.properties file

The applied customizations are stored in SAML configuration files and are applied whenever the CAS server is restarted.

SAML must be enabled either in Admin App | Authorization & Authentication | Options | Web Master or in Admin | Options | Web Master in the Sierra client.
The directory /iiidb/http/apps/SAML must be populated. This directory is repopulated every time CAS is restarted via runcas.
To customize SAML login forms in Web Master, you must be assigned permission 560 (Web Master).

To configure the SAML login form in Sierra:

  1. Under Function, select Web Master.

    The Web Master screen displays.

  2. Under Select Process, select SAML Configuration - apps/SAML (apps/SAML).

    The SAML screen display, listing custom_messages.properities and default_messages.properties files.

  3. Select custom_messages.properties and select Edit.

  4. Edit the file.

    The file contains all customizable fields.

    The default_messages.properties is a reference file showing available keys and default values. This file is automatically re-generated from the WAR file on each CAS restart.

  5. Select Save.

    The file is saved to server.

    The custom_messages.properties file is preserved across CAS restarts.

  6. Select Close to return to the SAML screen.