This page attempt to summarise the various requirements that federations place on MDUI.
Please note that this is not definitive and must not be assumed to be up to date. Its purpose is purely to provide easy cross referencing
Per Federation Information
The federations involved are:
Feide
Guidance for SP is given in section 6 of the Integration guide
The guide does not talk about MD, rather specification is given in terms of Logo, Service Description, Service Name and 'A URL to more information about the service', which are taken here to mean Logo, Description, DisplayName and InformationURL
As a centralised login service Feide gives no guidance for IdPs.
InCommon
InCommon guidance starts here
Kalmar Union
Kalmar Union (the Nordic confederation) guidance is given here
UK Federation
Recommendations are give here
Other
Per MDUI Element information - SP
Non Logo elements
| Element | Feide | InCommon | Kalmar | UK Federation | SWITCHaai |
|---|---|---|---|---|---|
| <mdui:DisplayName> | Yes | 'Required' | Optional | Yes | Required, 70 chars max |
| <mdui:Description> | Yes | Encouraged. 140 chars max | Optional 140 chars max | Yes 100 chars max | Required, 255 chars max. New values must be below 120 chars |
| <mdui:Keywords> | No | No | Optional | Recommend against | Optional |
| <mdui:InformationURL> | Yes | Encouraged | Optional | Recommend against | Optional |
| <mdui:PrivacyStatementURL> | No | Strongly encouraged | Optional use defined | Recommend against | Optional |
<mdui:IPHint>, <mdui:DomainHint> and <mdui:GeolocationHint> are not relevant for SPs.
Logo elements
- InCommon - the SP Logo URL must be specified using an HTTPS URL
- InCommon - the resource at the SP Logo URL must be an unprotected image resource
- InCommon - the host in the SP Logo URL must reside in a domain owned by the SP
- InCommon - the logo should have a transparent background
- InCommon - the logo should have a landscape orientation (width > height)
- InCommon - the logo should have a minimum width of 100 pixels
- InCommon - the logo should have a minimum height of 75 pixels and a maximum height of 150 pixels (or the application will scale it proportionally)
- Feide - Preferably have white/transparent background
- Feide - Preferably have a height of 50-60 pixels.
- Feide - The logo size should not exceed 400 (width) x 100 (height) pixels.
- Kalmar - Logos SHOULD be as square as possible (1:1).
- Kalmar - Logos SHOULD be at least 300×300 px.
- Kalmar - Logos SHOULD look nice when resized to 50×50 px. This means, do not use to much details. Text much be large when the resolution is high.
- Kalmar - Logos SHOULD be in PNG format with transparent background.
- Kalmar - Logos SHOULD look good on white background.
- Kalmar - Logos SHOULD NOT look bad on 20% grey.
- Kalmar - Logos SHOULD fill approx 50% of the image with color. Heavy icons should be made lighter, and lighter logos made heavier. This is to have balance between logos when shown on a list.
- UK Federation - The URL must be https protected
- UK Federation - Width between 64px and 350px and height between 64px and 170px.
- UK Federation - Logo background (if any) should be transparent.
- SWITCHaai - a small logo of 16x16 pixel (max. 5kB) and a large logo of about 80x60 pixels (max. 15kB) are supported but optional for now
- SWITCHaai - the logos are embedded directly in metadata as data uri.
- SWITCHaai - the logo should have a transparent background
- SWITCHaai - logos must be PNG files
Note that when you register the logo with the UK Federation you will need to provide its size as well at its location.
Note logos should be provided as gif or png (as per the formal specification). Other formats (for instance .ico or .jpg) may work but are liable to cause issues on some browers.
Per MDUI Element information - IdP
Non Logo elements
| Element | Feide | InCommon | Kalmar | UK Federation | SWITCHaai |
|---|---|---|---|---|---|
| <mdui:DisplayName> | NA | Required Falls back to <md:OrganizationDisplayName> | Optional | Yes Falls back to <md:OrganizationDisplayName> | Required, max 70 chars |
| <mdui:Description> | NA | Encouraged. 140 chars max | Optional. 140 chars max | No | Required, max 255. New values must be below 120 chars |
| <mdui:Keywords> | NA | No | Optional | Recommend against | Optional |
| <mdui:InformationURL> | NA | Optional | Optional | Recommend against | Optional |
| <mdui:PrivacyStatementURL> | NA | Optional use defined | Optional use defined | Recommend against | Optional |
| <mdui:IPHint> | NA | No | Optional | Optional | Optional but available for all IdPs |
| <mdui:DomainHint> | NA | No | Optional | Optional | Optional |
| <mdui:GeolocationHint> | NA | No | Optional | Optional | Optional |
Logo elements
- InCommon - the IdP Logo URL must be specified using an HTTPS URL
- InCommon - the resource at the IdP Logo URL must be an unprotected image resource
- InCommon - the host in the IdP Logo URL must reside in a domain owned by the IdP
- InCommon - the logo should have a transparent background
- InCommon - the logo should have a landscape orientation (width > height)
- InCommon - the logo should have a minimum width of 100 pixels
- InCommon - the logo should have a minimum height of 75 pixels and a maximum height of 150 pixels (or the application will scale it proportionally)
- Kalmar - Logos SHOULD be as square as possible (1:1).
- Kalmar - Logos SHOULD be at least 300×300 px.
- Kalmar - Logos SHOULD look nice when resized to 50×50 px. This means, do not use to much details. Text much be large when the resolution is high.
- Kalmar - Logos SHOULD be in PNG format with transparent background.
- Kalmar - Logos SHOULD look good on white background.
- Kalmar - Logos SHOULD NOT look bad on 20% grey.
- Kalmar - Logos SHOULD fill approx 50% of the image with color. Heavy icons should be made lighter, and lighter logos made heavier. This is to have balance between logos when shown on a list.
- UK Federation - The URL must be https protected
- UK Federation - You should provide at least two sizes:
- A logo of approximately 80px (width) by 60px(height), with a transparent background.
- A 16x16 'icon'.
- SWITCHaai - a small logo of 16x16 pixel (max. 5kB) and a large logo of about 80x60 pixels(max. 15kB) can be added. In April 2012 small and large logos were added for all IdPs by SWITCH. IdPs can change the logos themselves if they want.
- SWITCHaai - the logos are embedded directly in metadata as data uri.
- SWITCHaai - the logo should have a transparent background
- SWITCHaai - logos must be PNG files