This document describes how to configure a Shibboleth Service Provider (SP) to download the InCommon IdP-only metadata aggregate file and verify the digital signature. To learn about other options to consume UW IdP metadata, see UW IdP Metadata.
Configuration
Configuration Steps
- Open your
shibboleth2.xml
file for editing. - Find the section with
MetadataProvider
elements. - Add the following
MetadataProvider
:<MetadataProvider type=
"XML"
url=
"
https://mdq.incommon.org/entities/idps/all
"
backingFilePath=
"inc-idp-metadata.xml"
reloadInterval=
"7200"
>
<MetadataFilter type=
"Signature"
certificate=
"inc-cert.pem"
/>
</MetadataProvider>
- The
MetadataFilter
element says that the signature oninc-idp-metadata.xml
should be verified using theinc-cert.pem
certificate. - If you have configured a
MetadataProvider
for the InCommon MDQ service or for the local UW IdP metadata endpoint, you should comment it out or delete it. - Save your shibboleth2.xml file.
- The InCommon signing certificate can be downloaded at https://spaces.at.internet2.edu/display/MDQ/production-mdq-signing-key.
- Save the certificate file in the same directory as your
shibboleth2.xml
file. Name it something likeinc-cert.pem
.
- Restart the shibd process on your SP however you normally do that on your platform.
- This will cause Shibboleth to check the
MetadataProvider
locations and to download any updates. Shibboleth will also verify the digital signatures on any metadata where it is configured to do so.
- The restart of shibd, reloading of metadata, and signature verification should all be recorded in
shibd.log
. - Open the log file and scroll to near the bottom of the file to find messages from the shibd restart.
- Look for messages like the following (numbering added for clarity, these are not present in the log file):
1
.
2018
-
03
-
23
12
:
05
:
16
INFO OpenSAML.Metadata.Chaining : building MetadataProvider of type XML
2
.
2018
-
03
-
23
12
:
05
:
16
INFO OpenSAML.Metadata : building MetadataFilter of type Signature
3
.
2018
-
03
-
23
12
:
05
:
16
INFO XMLTooling.SecurityHelper : loading certificate(s) from file (C:/opt/shibboleth-sp/etc/shibboleth/inc-cert.pem)
4
.
2018
-
03
-
23
12
:
05
:
16
INFO XMLTooling.CredentialResolver.File : no
private
key resolved, usable
for
verification/trust only
5
.
2018
-
03
-
23
12
:
05
:
17
INFO OpenSAML.Metadata.XML : loaded XML resource (
https://mdq.incommon.org/entities/idps/all
)
6
.
2018
-
03
-
23
12
:
05
:
17
INFO OpenSAML.Metadata : applying metadata filter (Signature)
7
.
2018
-
03
-
23
12
:
05
:
17
INFO OpenSAML.Metadata.XML : adjusted reload interval to
7200
seconds
8
.
2018
-
03
-
23
12
:
05
:
17
INFO OpenSAML.Metadata.XML : reload thread started...running every
7200
seconds
- Message #3 indicates that the certificate file on disk was successfully loaded.
- Message #5 indicates that the InCommon IdP-only metadata aggregate file was successfully loaded.
- Message #6 indicates that the signature on the metadata file was successfully verified.
- If instead you see warning or errors for these entries, go back and verify you have followed these instructions.