VK Cloud logo

Configuring identity federation via MS Entra

You can connect your Identity Provider (IdP) to VK Cloud. This will allow your employees to log in to VK Cloud without entering a login and password, using corporate authentication credentials from the identity provider. This mode is called identity federation.

To work in federation mode, the identity provider must support the SAML 2.0 standard.

Below is the setup of identity federation for logging in to VK Cloud with Microsoft Entra as the identity provider.

Preparation steps

Configure Microsoft Entra, create a tenant, users, and groups.

1. Create an identity federation in VK Cloud

  1. Go to your VK Cloud account.
  2. Go to the Identity Federation section.
  3. Go to the Federations tab and click the Create button.
  4. Click the Download metadata button. A metadata file will be downloaded, which will be needed for configuring Microsoft Entra.
  5. Copy the value of the URL for federated user login parameter. This value will need to be specified when configuring Microsoft Entra.

2. Configure Microsoft Entra

  1. Go to the Microsoft Entra admin center.

  2. Go to the Applications → Enterprise applications tab.

  3. Click the Microsoft Entra SAML Toolkit application, then click the Create button to start creating a new enterprise application.

  4. In the settings window of the new application, go to the Single sign-on tab and select SAML.

  5. Click the Upload metadata file button and upload the federation metadata file.

  6. Click the Add button.

  7. In the Sign-on URL field, specify the URL for federated user login that was copied when creating the federation in the VK Cloud management console.

  8. Click the Save button.

  9. Go to the Users and groups section in the application settings.

  10. Create at least one group that will be used for mapping user roles in the management console.

  11. Go to the Single sign-on → SAML section in the application settings.

  12. In the Attributes and claims block, click the Edit button to edit the claims.

  13. Modify the existing claims and add new ones:

    1. For the http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname claim, click Configuring identity federation via MS Entra and select Delete.
    2. Click the http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name claim and change the source attribute to user.givenname.
    3. Click the Add group claim button.
    4. Select Groups assigned to the application.
    5. In the Source attribute list, select Cloud group display names.
    6. Click Advanced options.
    7. Enable the Customize the name of the group claim option to specify the claim type.
    8. In the Name field, specify http://schemas.xmlsoap.org/claims/Group.
    9. Click the Save button.
    10. (Optional) Add a new claim, specifying phone_number as the namespace and user.mobilephone as the source attribute.
  14. Go to the Single sign-on → SAML section in the application settings.

  15. In the SAML certificates block, create a new certificate or import an existing one.

  16. Click the Federation XML metadata button. The IdP metadata will be downloaded.

3. Upload Microsoft Entra metadata to the VK Cloud identity federation

  1. Go to your VK Cloud account.
  2. Go to the Identity Federation section.
  3. Go to the Federations tab and click the Upload IdP metadata button to upload the new metadata.
  4. Select the Microsoft Entra metadata file and click the Upload button.

4. Configure the group and role mapping in VK Cloud

  1. In the same section of the VK Cloud account, go to the Groups tab.

  2. Click the name of the project for which the identity federation is being configured.

  3. Add the groups you use in Microsoft Entra:

    1. Click the Add button. If there are already created groups on the page, click the Add group button.

    2. Configure the group:

      • Group name: specify the group name. The name of the created group must match the name of the group in Microsoft Entra, but it must be in lowercase.
      • Permissions — select the level at which the group permissions will apply:
        • Project — select to link the group and roles within a single project. In different projects, the same group can be linked to different roles, which allows you to differentiate the federated user's access level to projects.
        • Domain — select to link the group and roles across all projects of one owner and provide the federated user with a unified access level to them. The Domain permission is available only to the project owner.
      • Group roles: select the VK Cloud roles or permissions that match your access matrix for the created group.
    3. Click the Add button.

5. Verify the ability to log in via the federation

  1. Create a test user in Microsoft Entra and add them to the desired group.

  2. (Optional) Go to the Token encryption menu item and add the certificate that can be obtained from the federation metadata file.

  3. Enter the URL for federated user login in the browser address bar. You will be redirected to the authentication page.

  4. Enter the test user's authentication credentials. After successful authorization, you will be redirected to the main page of the VK Cloud management console.

  5. Verify that the automatically assigned VK Cloud user role matches the one selected when adding the group.

Was this article helpful?