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.
Configure Microsoft Entra, create a tenant, users, and groups.
- Go to your VK Cloud account.
- Go to the Identity Federation section.
- Go to the Federations tab and click the Create button.
- Click the Download metadata button. A metadata file will be downloaded, which will be needed for configuring Microsoft Entra.
- Copy the value of the URL for federated user login parameter. This value will need to be specified when configuring Microsoft Entra.
-
Go to the Microsoft Entra admin center.
-
Go to the Applications → Enterprise applications tab.
-
Click the Microsoft Entra SAML Toolkit application, then click the Create button to start creating a new enterprise application.
-
In the settings window of the new application, go to the Single sign-on tab and select SAML.
-
Click the Upload metadata file button and upload the federation metadata file.
-
Click the Add button.
-
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.
-
Click the Save button.
-
Go to the Users and groups section in the application settings.
-
Create at least one group that will be used for mapping user roles in the management console.
-
Go to the Single sign-on → SAML section in the application settings.
-
In the Attributes and claims block, click the Edit button to edit the claims.
-
Modify the existing claims and add new ones:
- For the
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givennameclaim, clickand select Delete.
- Click the
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameclaim and change the source attribute touser.givenname. - Click the Add group claim button.
- Select Groups assigned to the application.
- In the Source attribute list, select Cloud group display names.
- Click Advanced options.
- Enable the Customize the name of the group claim option to specify the claim type.
- In the Name field, specify
http://schemas.xmlsoap.org/claims/Group. - Click the Save button.
- (Optional) Add a new claim, specifying
phone_numberas the namespace anduser.mobilephoneas the source attribute.
- For the
-
Go to the Single sign-on → SAML section in the application settings.
-
In the SAML certificates block, create a new certificate or import an existing one.
-
Click the Federation XML metadata button. The IdP metadata will be downloaded.
- Go to your VK Cloud account.
- Go to the Identity Federation section.
- Go to the Federations tab and click the Upload IdP metadata button to upload the new metadata.
- Select the Microsoft Entra metadata file and click the Upload button.
-
In the same section of the VK Cloud account, go to the Groups tab.
-
Click the name of the project for which the identity federation is being configured.
-
Add the groups you use in Microsoft Entra:
-
Click the Add button. If there are already created groups on the page, click the Add group button.
-
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.
-
Click the Add button.
-
-
Create a test user in Microsoft Entra and add them to the desired group.
-
(Optional) Go to the Token encryption menu item and add the certificate that can be obtained from the federation metadata file.
-
Enter the URL for federated user login in the browser address bar. You will be redirected to the authentication page.
-
Enter the test user's authentication credentials. After successful authorization, you will be redirected to the main page of the VK Cloud management console.
-
Verify that the automatically assigned VK Cloud user role matches the one selected when adding the group.