This pages requires Javascript! If javascript is not enabled, most functions will not work.
Shibboleth Service Provider (SP) 3.4 Installation Guide
Table of contents
- Introduction
- Recommendations
- Installation
- Quick Test
- Service Provider Configuration
- Additional Information
Note regarding Upgrades to Shibboleth SP 3
Shibboleth SP v3 supports the SP v2 configuration format, so the SP v2 configuration files are forward-compatible with SP v3.
Check the shibd.log
for deprecation warnings for legacy configuration elements.
The Migration guide documents how to update your configuration to get rid of the deprecation warnings for legacy configuration elements.
1. Introduction
This guide describes the installation of a Shibboleth Service Provider (SP) 3.4 on the operating systems Windows and Linux/Unix as supported by the Shibboleth Consortium. The instructions are generic, not federation specific.
We did not test the SP on all OS versions, so please report any issue you encounter.
Check and confirm the Shibboleth SP 3 System Requirements before proceeding.
Select the type of operating system on the host where the Shibboleth Service Provider gets installed:
Red Hat Enterprise Linux 7/8/9, Rocky Linux 8/9, Ubuntu 22/23/24, Debian 11/12 or CentOS Linux 7 or Amazon Linux 2/2023
Windows Server 2008 and later (32-bit and 64-bit Windows)
If you use a Linux distribution not listed above that includes an up-to-date Shibboleth SP package, you can try to install that one.
If the Service Provider is already installed, please continue to our federation-specific Switch Shibboleth Service Provider Configuration Guide.
Note regarding CentOS 8
Since September 2023, the Shibboleth Consortium no longer supports CentOS 8 as officially supported platform.
Note for Debian and Ubuntu installations that used the former pkg.switch.ch repository:
As previously announced, the https://pkg.switch.ch/switchaai/
repository is no longer available. Use the packages from the official Debian and Ubuntu distribution channels.
To remove the SWITCHaai package repository from your system, uninstall packages shibboleth
and switchaai-apt-source
, then remove any remaining APT configuration for this repository (if any). This won’t uninstall the Shibboleth SP and the currently-installed SWITCHaai SP packages will remain until a newer version is available from the distribution’s official repository.
copypop-up
apt remove shibboleth apt-mark manual libapache2-mod-shib apt purge switchaai-apt-source rm /etc/apt/trusted.gpg.d/SWITCHaai-swdistrib.gpg /etc/apt/sources.list.d/SWITCHaai-swdistrib.list apt update