Creating a SAML app in Yandex Identity Hub for integration with Cloud.ru
Cloud.ru
To authenticate your organization's users to Cloud.ru via SAML
SAML apps can be managed by users with the organization-manager.samlApplications.admin role or higher.
For the users of your organization to be able to access Cloud.ru:
Create an app
- Log in to Yandex Identity Hub
. - In the left-hand panel, select
Apps. - In the top-right corner, click
Create application and in the window that opens:-
Select the SAML (Security Assertion Markup Language) single sign-on method.
-
In the Name field, specify a name for your new app:
cloud-ru-saml-app. -
Optionally, in the Description field, enter a description for the new app.
-
Optionally, add labels:
- Click Add label.
- Enter a label in
key: valueformat. - Press Enter.
-
Click Create application.
-
Set up the integration
To configure Cloud.ru integration with the SAML app you created in Yandex Identity Hub, complete the setup both in Cloud.ru and Yandex Identity Hub.
Set up the SAML app in Cloud.ru
-
Get the metadata for the new app:
- Log in to Yandex Identity Hub
. - In the left-hand panel, select
Apps and then, the SAML app. - On the Overview tab, under Identity provider (IdP) configuration, click Download metadata file.
The downloaded XML
file contains the required metadata and a certificate used for SAML response signature verification. - Log in to Yandex Identity Hub
-
Set up SAML authentication for Cloud.ru.
-
Log in to the Cloud.ru console
. -
Navigate to the Federations tab in the Administration section.
-
Click Create federation and select the SAML protocol type.
-
Upload the XML metadata file you got in Yandex Identity Hub in the previous step.
-
Enter the federation name and description.
-
Set the session duration.
Note
The maximum lifetime of an SSO session is from 30 minutes to 7 days. If there is no activity, the session is automatically terminated and re-authentication is required.
-
Check the settings in the Single Logout Service section, they should be imported from the XML metadata file. For Default URL Binding, set
Post. -
Check the settings in the Single Sign-On Service section, they should be imported from the XML metadata file. For Default URL Binding, set
Redirect. -
Make sure the signing certificate was imported from the XML metadata file and has the
Signingtype. -
Click Create.
-
Download the provided XML file with Cloud.ru metadata, as it is required to complete the setup in Yandex Identity Hub.
-
Click Done.
-
In the list of federations, find the new federation and copy its ID. Save this ID as you will need it later.
-
Set up the SAML application in Yandex Identity Hub
Set up service provider endpoints
- Log in to Yandex Identity Hub
. - In the left-hand panel, select
Apps and then, the SAML app. - At the top right, click
Edit and in the window that opens:- In the **SP EntityID ** field, specify the
entityIDattribute value of theEntityDescriptorelement from the Cloud.ru XML metadata file. - In the ACS URL field, specify the
Locationattribute value of theAssertionConsumerServiceelement from the Cloud.ru XML metadata file. - Click Save.
- In the **SP EntityID ** field, specify the
Add users
To enable your organization's users to authenticate in Cloud.ru using the Yandex Identity Hub SAML application, you must explicitly add their accounts both to the application and the Cloud.ru federation.
Note
Users and groups added to a SAML application can be managed by a user with the organization-manager.samlApplications.userAdmin role or higher.
Add users to the Yandex Identity Hub SAML application
- Log in to Yandex Identity Hub
. - In the left-hand panel, select
Apps and select the required app. - Navigate to the Users and groups tab.
- Click
Add users. - In the window that opens, select the required user.
- Click Add.
Add users to the Cloud.ru federation
- Log in to the Cloud.ru console
. - Open the Users section and go to the Federated users tab.
- In the top-right corner, click Add federation user.
- Select the federation to add the user to.
- Specify the user's email address.
- Grant the user the required access permissions for projects and platforms.
- Click Add.
Make sure your application works correctly
To make sure both your SAML app and its integration with Cloud.ru work correctly, authenticate to Cloud.ru as one of the users you added to the app.
Proceed as follows:
- In your browser, open the Cloud.ru console
login page. - If you were logged in, log out.
- On the login form, click SSO.
- In the dialog that appears, enter the ID of the federation you created and click Log in.
- On the Yandex Cloud authentication page, enter your email address and user password.
- Make sure you have successfully authenticated to Cloud.ru.