Getting Certificates for an Identity Provider
(Separate information is provided for getting certificates for a Shibboleth 2.x IdP.)
To set up an IdP entity within the UK federation, you normally require two X.509 digital certificates:
- a browser-facing certificate that users will see, and
- a trust-fabric certificate for machine-to-machine use.
These two certificates are used for different purposes and have different properties. A key length of 2048 bits is recommended for all certificates.
An X.509 SSL certificate is required for the browser-facing certificate, ie. the SSL certificate configured on the port 443 virtual host. Here are instructions for acquiring an SSL certificate suitable for the browser-facing certificate.
The federation now recommends that you use a long-life self-signed certificate for an IdP trust fabric certificate.
The CN of the trust fabric certificate must exactly match the hostname of the
ArtifactResolutionService or equivalent URLs (usually the hostname of the identity provider server). The federation does not accept wildcard certificates as IdP trust fabric certificates.
A key length of at least 2048 bits is mandatory for trust fabric certificates. The federation recommends 2048 bits, as longer keys provide no additional practical security but are more computationally expensive for all parties.
Replacing an IdP trust-fabric certificate
A trust fabric certificate should be replaced before it expires. When replacing an embedded IdP trust fabric certificate that is used for signing purposes, we recommend that you follow the steps described below. Please note that this process may take several days. If you aren't familiar with the process then allow at least a month.
- ask the UK federation support team to add the new certificate to the registered IdP metadata in the federation in addition to the old one. This will usually be performed by the administrative contact, and we will perform certificate verification with that person.
- wait for a few days, to allow the metadata to propagate to federation SPs
- update your IdP configuration to use the new certificate - please consult your software documentation or software vendor for details
- test using the UK federation test SP and check in your IdP log that the IdP used the new certificate. If you can't tell then please ask the UK federation support team to check the test SP log for you.
- ask the UK federation support team to remove the old certificate from the metadata
Please note: There should be no loss of service with most federation SPs if the above procedure is followed, but there are some SPs that are unable to handle the presence of more than one certificate in an IdP's metadata. You should aim to minimise the time for which two certificates are together in the metadata to reduce service disruption with any such SPs.