Creating a SAML app in Yandex Identity Hub for integration with the management console of Yandex Browser for organizations
Yandex Browser for organizations
For the users of your organization to be able to authenticate to the management console of Yandex Browser for organizations via SAML
SAML apps can be managed by users with the organization-manager.samlApplications.admin role or higher.
To give the users of your organization access to the management console of Yandex Browser for organizations:
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:
browser-cloud. - Optionally, in the Description field, enter a description for the new app.
- Optionally, add labels:
- Click Add label.
- Add a label in
key: valueformat. - Press Enter.
- Click Create application.
Set up the integration
To configure the integration between Yandex Browser for organizations and the SAML app you created in Identity Hub, complete the setup both in Identity Hub and Yandex Browser for organizations.
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
browser.yandex.ru. - In the ACS URL field, enter an address formatted as
https://<console_domain>/corp/api/sso/saml/callback, e.g.,https://browser.yandex.ru/corp/api/sso/saml/callback. - In the Signature mode field, select
Response. - Click Save.
- In the **SP EntityID ** field, specify
Configure user attributes
Warning
For integration with the management console of Yandex Browser for organizations, you need to configure the firstName and lastName attributes.
Set user attributes for integration with Yandex Browser for organizations:
-
Log in to Yandex Identity Hub
. -
In the left-hand panel, select
Apps and select the desired app. -
Navigate to the Attributes tab.
-
Edit user attributes:
- Replace the
givennameattribute withfirstName. - Replace the
surnameattribute withlastName. - The
fullnameandemailaddressattributes are not required, so you can remove them.
- Replace the
For more information about configuring attributes, see Configure user and group attributes.
Collect data for setting up Yandex Browser for organizations
To set up SSO in Yandex Browser for organizations, you need the following data from your SAML app:
- Log in to Yandex Identity Hub
. - In the left-hand panel, select
Apps and then, the SAML app. - In the Overview tab, under Identity provider (IdP) configuration, in the Login URL field, copy the entry point URL (Login URL).
- Under Service provider (SP) configuration, in the SP EntityID field, copy the unique service provider ID.
- Under Application certificate, click Download certificate and save the token signature certificate in X.509 format to your device.
You will need this data to set up SSO in Yandex Browser for organizations.
Set up SAML authentication in Yandex Browser for organizations
Note
To set up SAML authentication in Yandex Browser for organizations, the user needs the organization administrator permissions.
To set up SAML authentication in Yandex Browser for organizations:
- Log in to the Yandex Browser for organizations management console
. - Go to SSO settings.
- Specify the following:
- Domain: Domain in Yandex Identity Hub.
- SP Entity ID: Unique service provider ID obtained in the previous step.
- Single sign-on service URL: Login URL obtained in the previous step.
- Signing certificate: Provide the previously saved token signing certificate in X.509 format.
- Save the settings.
- Click Download certificate.
- Optionally, configure signature verification:
- Log in to Yandex Identity Hub
. - In the left-hand panel, select
Apps and then, the SAML app. - Click
Edit. - Enable Only accept signed requests and click Add certificate.
- In the window that opens, attach the certificate file you downloaded in the Yandex Browser management console.
- Click Add.
- Log in to Yandex Identity Hub
- In the Yandex Browser for organizations management console, enable SSO/SAML authentication.
- Wait until the domain is confirmed. To check the status, go to SSO settings.
Add users
For your organization's users to be able to authenticate in the Yandex Browser for organizations management console with Yandex Identity Hub's SAML app, you need to explicitly add these users and/or user groups to your SAML application. You also need to add the relevant users as administrators in the Yandex Browser for organizations management console.
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 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 or user group.
- Click Add.
Add administrators:
- Log in to the Yandex Browser for organizations management console
. - Go to the Administrators settings section.
- Click Add.
- Specify the email address of a user added to the app.
- Repeat the previous steps for all users who need access to the console.
Make sure your application works correctly
To make sure both your SAML app and Yandex Browser for organizations integration management console work correctly, authenticate as one of the administrators you added to the app. Follow these steps:
- In your browser, go to the Yandex Browser for organizations management console login page.
- If you were previously logged in, log out.
- On the authentication page, click Log in via SSO.
- On the Yandex Cloud authentication page, enter the email address and user password. The user or group they belong to must be added to the application. The user must also be a management console administrator.
- Make sure you have successfully authenticated in the Yandex Browser management console.