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 metadata administrative interface has the following input fields:
- Logo URL
- Display Name
- Description
- Information URL
- Privacy Statement URL
By submitting these fields, the administrator adds the corresponding user interface elements to metadata. See the following help pages for guidance:
To better understand how the user interface elements are used, the InCommon Federation entity information pages display the values of all user interface elements on dynamic web pages. The information pages are refreshed daily, in parallel with InCommon metadata.
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>