How to set up identity federation

Reviewed on November 24, 2025

Scaleway supports Identity Federation to provide your teams with secure access to their accounts via Single Sign-On (SSO). Depending on your organization’s requirements, you can use either built-in OAuth2 providers or configure SAML for centralized identity management.

Follow the steps below to set up Identity Federation for your Organization through SAML at Scaleway.

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into the console
• Owner status or IAM permissions allowing you to perform actions in the intended Organization
• An Identity Provider (IdP) configured in your company, making sure it includes all users who need to access Scaleway. Some examples of IdPs:
  • Okta
  • OneLogin
  • Microsoft Entra ID (prev. Azure AD)
  • PingIdentity
  • Google Workspace
  • Authentik

How to set up a SAML connection

1. Go to your security settings.

2. Scroll to the Configure Identity Federation section.

3. Click Set up SAML SSO. A pop-up appears.

4. Copy the URLs displayed in the pop-up.

   The information in the first step are the URLs referring to Scaleway that will be requested by your Identity Provider to create a link between platforms. They are:

   • The assertion consumer service (ACS) URL, and
   • Scaleway's entity ID

5. Click Import identity provider data.

6. Upload your identity provider metadata. Most identity providers supply an XML file export of your configuration. You can upload this file to automatically set up SAML.

   Important

   Alternatively, you can click Set up manually to manually enter the IdP's metadata. This is the information referring to your Identity Provider that Scaleway needs to confirm the connection. It can be found in your IdP's configuration page. The metadata includes:

   • Single Sign-On URL - This is the URL your members will be redirected to when logging in with SAML
   • The Identity Provider's Entity ID

7. Click Submit.

8. Enter the signing certificate generated by your Identity Provider in the box.

   Important

   Keep in mind that:

   • Only base64-encoded certificates are supported.
   • The certificate must have an expiration date.
   • Your certificate entry must start with:
     -----BEGIN CERTIFICATE-----

     And end with:
     -----END CERTIFICATE-----

   Note

   You can close the Identity Provider pop-up without adding the certificate right away. The certificate can be added at a later time. However, while the certificate is not added, the connection between Scaleway and your Identity Provider will not be complete and the SSO feature will not work for your Organization members.

9. Click Complete set up.

Once setup is complete, members can log in via SAML.

How to update the connection configuration

If you change your Identity Provider, you will need to re-configure your SAML connection.

1. Go to your security settings.
2. Scroll to the Identity Federation section.
3. Click Edit configuration. A pop-up appears.
4. (Optional) Replace the Identity Provider's Single Sign-On URL and Entity ID with the information of your new one.
5. Click Confirm.

How to add a certificate

If you started the connection set up, but did not add a certificate right away, you can add it after. While the certificate is not added, the connection between Scaleway and your Identity Provider will not be complete and the SSO feature will not work for your Organization members.

1. Go to your security settings.
2. Scroll to the Identity Federation section.
3. Click + Add certificate. A pop-up appears.
4. Enter the signing certificate generated by your Identity Provider in the box.
5. Click Confirm.

How to renew a certificate

You must regularly update your signing certificate in the frequency set by your Identity Provider. To renew a certificate:

1. Go to your security settings.
2. Scroll to the Identity Federation section.
3. Click Renew certificate. A pop-up appears.
4. Enter the signing certificate generated by your Identity Provider in the box.
5. Click Confirm.

How to delete a connection

1. Go to your security settings.
2. Scroll to the Identity Federation section.
3. Click Delete SSO.
   Important

   A pop-up appears to warn you that:

   • Deleting the connection will also delete your identity federation configuration and disable SAML-based SSO connections, preventing Members from logging in via this method. You can reconfigure identity federation at any time.
4. Type DELETE in the box to confirm.
5. Click Delete.