User Interface Elements in Metadata
User interface elements in Federation metadata are used by downstream applications to construct rich, dynamic user interfaces (UIs). Specifically, user interface elements in IdP metadata are used for the discovery and error pages at the SP, while user interface elements in SP metadata are used for the login, consent, and error pages at the IdP. The goal is to unify the various user interfaces associated with cross-domain single sign-on, thereby enhancing the overall user experience.
The administrative interface has the following input fields:
- Display Name
- Description
- Information URL
- Privacy Statement URL
- Logo URL
By submitting these fields, the administrator adds the corresponding user interface elements to metadata. See the following help pages for guidance:
Best Practice
A site supplies values for each of the user interface elements to maximize the user experience.
Technical Details
The SAML V2.0 Metadata Extensions for Login and Discovery specification defines an <mdui:UIInfo>
extension element. InCommon supports the following child elements of the <mdui:UIInfo>
element:
<mdui:DisplayName>
<mdui:Description>
<mdui:InformationURL>
<mdui:PrivacyStatementURL>
<mdui:Logo>
An example follows:
<!-- User Interface Elements for InCommon IdPs and SPs --> <md:Extensions> <mdui:UIInfo xmlns:mdui="urn:oasis:names:tc:SAML:metadata:ui"> <mdui:DisplayName xml:lang="en">...</mdui:DisplayName> <mdui:Description xml:lang="en">...</mdui:Description> <mdui:InformationURL xml:lang="en">...</mdui:InformationURL> <mdui:PrivacyStatementURL xml:lang="en">...</mdui:PrivacyStatementURL> <!-- the actual width and height of the image are input by the user --> <mdui:Logo width="130" height="80">...</mdui:Logo> </mdui:UIInfo> </md:Extensions>