Setting up access to an SAML app in Yandex Identity Hub

Written by

Yandex Cloud

Updated at July 16, 2026

View in Markdown

To grant access to a SAML app, assign roles to subjects. Learn what roles the service has and assign the required ones.

Cloud Center UI

CLI

API

Log in to Yandex Identity Hub.
In the left-hand panel, click Apps and select your app.
Navigate to the Access bindings tab.
Click Assign roles.
In the window that opens, select the group, user, or service account to which you want to give access to the app.
Click Add role and select a role. Add other roles as needed.
Click Save.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

See the description of the CLI command for assigning roles to SAML app users:

yc organization-manager idp application saml application set-access-bindings --help

Get a list of SAML apps and their IDs:
```
yc organization-manager idp application saml application list --organization-id <organization_ID>
```
Where --organization-id is the ID of the organization you need the list of SAML apps for.
Get the ID of the user, service account, or user group you are assigning roles to.

Using the yc organization-manager idp application saml application set-access-bindings command, assign the following roles:

To a Yandex account user or local user:

yc organization-manager idp application saml application set-access-bindings \
  --id <app_ID> \
  --access-binding role=<role>,user-account-id=<user_ID>

To all users of a federation:

yc organization-manager idp application saml application set-access-bindings \
  --id <app_ID> \
  --access-binding role=<role>,federation-users=<federation_ID>

To all users of an organization:

yc organization-manager idp application saml application set-access-bindings \
  --id <app_ID> \
  --access-binding role=<role>,organization-users=<organization_ID>

To a service account:

yc organization-manager idp application saml application set-access-bindings \
  --id <app_ID> \
  --access-binding role=<role>,service-account-id=<service_account_ID>

To a user group:

yc organization-manager idp application saml application set-access-bindings \
  --id <app_ID> \
  --access-binding role=<role>,group-members=<group_ID>

To all authenticated users (the All authenticated users public group):

yc organization-manager idp application oauth application set-access-bindings \
  --id <app_ID> \
  --access-binding role=<role>,all-authenticated-users

Provide a separate --access-binding parameter for each role. Here is an example:

yc organization-manager idp application oauth application set-access-bindings \
  --id <app_ID> \
  --access-binding role=<role1>,service-account-id=<service_account_ID> \
  --access-binding role=<role2>,service-account-id=<service_account_ID> \
  --access-binding role=<role3>,service-account-id=<service_account_ID>

Use the Application.SetAccessBindings REST API method for the Application resource or the ApplicationService/SetAccessBindings gRPC API call.

Setting up access to an SAML app in Yandex Identity Hub

Was the article helpful?