What is “Skinning”?
Skinning allows the customisation of the look and feel of the CILogon Discovery page to match an organisation’s branding. This can include adding a logo, changing colour schemes, and adjusting styles so that users have a consistent experience with a service. Skins can change both the look (e.g., CSS), the behavior (e.g., custom list of Identity Providers) and the text displayed by the CILogon service.
Where are skins applied?
Skins are applied to
- The Discovery Page – https://cilogon.aaf.edu.au
- The Profile/Settings Page – https://cilogon.aaf.edu.au/me/
These pages should be considered in the page design, so that styles remain consistent across the user journey.
How skins work
A skins package is stored in the CILogon service. When enabled, this package is added to the displayed page, to override the default look. When loaded, skins can be previewed by adding a query parameter to the CILogon URL: https://cilogon.aaf.edu.au/?skin=<query>
- ?skin=default - The default CILogon interface. Use this URL to reset the skin back to default.
- ?skin=austintob - Provides a customised scheme for the Australian Internet Observatory
- ?skin=biocommons - Provides a customised scheme for the BioCommons services
- ?skin=cadre - Provides a customised scheme for the CADRE services
- ?skin=ldaca - Provides a customised scheme for the Language Data Commons of Australia
E.g. https://cilogon.aaf.edu.au/?skin=austintob
Assets and logos
Skins may include text, images, fonts and other assets. Skin configuration files (i.e., skin.css and/or config.xml) must be added to a CILogon subscriber’s GitHub repository for deployment. Read-only access for this repository will be granted to subscriber developers to create and supply a skin.
For subscribers using the Australian CILogon instance, the AAF will assist with checking and deploying skins.
Links
CILogon Skins Documentation https://www.cilogon.org/skins
CILogon FAQ https://www.cilogon.org/faq
CILogon OIDC documentation https://www.cilogon.org/oidc (for technical integration, including skin parameters)
For AAF Support
help@cilogon.aaf.edu.au