Certificates for SAML federations
When working with federations, two types of certificates are used:
- identity provider certificate — a certificate that is issued on the identity provider side and added when configuring a federation in the control panel. Without a certificate, the federation will not work;
- certificates for signing requests — an optional certificate that is issued on the Selectel side if the federation has the Sign authentication requests checkbox marked.
Identity provider certificates
You issue a certificate from your identity provider and add it to the federation in Selectel. The certificate is used for authenticating data during user login in the control panel.
You can create a federation without a certificate and add one later, but a federation without a certificate will not work. You can add up to 10 certificates for a single federation.
If a federation has multiple certificates, they will be applied sequentially: if a certificate has expired or is invalid, the next uploaded certificate will be used.
Issue a certificate from an identity provider
Keycloak
AD FS
- In the Keycloak control panel, go to the Realm settings section → Keys tab.
- In the RS256 row, click Certificate.
- Copy the certificate.
Add a certificate
- In the control panel, on the top menu, click IAM.
- Go to the Federations section.
- Open the federation page → Federations tab.
- In the IdP certificates block, click Add certificate.
- Enter a certificate name.
- Paste the certificate. It must start with
-----BEGIN CERTIFICATE-----and end with-----END CERTIFICATE-----. - Click Add.
Remove a certificate
- In the control panel, on the top menu, click IAM.
- Go to the Federations section.
- Open the federation page → Federations tab.
- In the IdP certificates block, in the certificate row, click .
Certificates for signing requests
A certificate for signing requests is generated automatically on the Selectel side if the Sign authentication requests option is enabled for the federation.
You can download the certificate and upload it when configuring the federation on your identity provider side; for more details, see the Create a SAML federation for Keycloak and Create a SAML federation for AD FS guides.
Download a certificate for signing requests
- In the control panel, on the top menu, click IAM.
- Go to the Federations section.
- Open the federation page → Federations tab.
- In the Sign authentication requests field, click Download certificate. The certificate file in
.crtformat will be downloaded to your device.