OpenAthens LA provides default styles for all the pages that end-users of the application see.
loginpage – where users are required to authenticate.
logoutpage – the landing page which users see after logging out.
ssopage – this is the page that will be visited after login. It is normally transitional and the user will be forwarded to the Service Provider. If there is a problem, e.g. there is no Service Provider to respond to, a message will be displayed.
sso-debugpage – a debug page which displays attribute information.
It is possible to fully customise the look-and-feel of these pages to integrate with other applications. The default pages use standard Apache Server-side includes (SSI). This method is used because it will work on any Apache server, without additional modules however login pages can easily be adapted to work with PHP or other scripting languages.
The pages can be found on the runtime server in:
For each of these pages, a number of variables are written to the Apache environment. These are available to template/scripting languages (e.g. SSI, PHP etc) for customisation of the user interface.
The following variables are available to all pages
The name and version of the OpenAthens LA product
The organisation name, as defined in the configuration in the Administration Console
The prefix for the application path (default:
A human-readable error message, if an error occurred (may be empty)
A short error-code, if an error occurred (may be empty)
There are also some standard variables associated with SSI and Apache that are available.
The following additional variables are available to the login page
The last username entered by the user in the case of a failed login (may be empty)
Single Sign-On page
The following additional variables are available to the Single Sign-On page after login.
The username of the logged in user
A human-readable name of the Service Provider that the response is intended for
The URL of the Service Provider that the response is to be sent to
A formatted list of attribute names and values to be sent to the Service Provider
The following attributes are necessary for the operation of OpenAthens LA. They should be used as defined in the standard templates. Any customised page, should include them.
The value of the response document to be sent to the Service Provider (may be empty)
The value of the SAML artifact to be sent to the Service Provider (may be empty)
The value of the SAML relay-state in the request from the Service Provider (may be empty)
If you want to add a favicon to your login / logout / sso pages, upload a suitably sized icon as: