Adding a user to an organization
Add a user to your organization to grant him or her access to Yandex Cloud resources.
You can add users with a Yandexaccount as well as federated users. To do this, you need to be the organization administrator (the organization-manager.admin
role) or owner (the organization-manager.organizations.owner
role).
The user will become an organization member, and you will be able to grant them access to your cloud resources by assigning them a role. A new organization member will not have access to cloud resources until you assign them a role.
Add a user to your organization and grant them the role needed to access Yandex Cloud resources. For example, enable the user to create managed DB clusters or track the status of VMs in use.
You can add users with a Yandex account and federated users. To do this, you need to be the organization administrator (the organization-manager.admin
role) or owner (the organization-manager.organizations.owner
role). To learn how to grant roles to users, see Assigning roles.
Users with a Yandex account
If your employees have Yandex accounts (for example, login@yandex.com
), they can use them to access the Yandex Cloud services enabled in your organization.
You can invite a user to an organization via the management console or Yandex Cloud Organization. An invitation to join your organization will be sent to the user's email address.
Send an invitation
-
Log in
as the organization administrator or owner. -
Go to Yandex Cloud Organization
. -
In the left-hand panel, select Users
. -
In the top-right corner, click Invite users.
-
Enter the email addresses of the users you want to invite to the organization (e.g.,
login@yandex.com
).You can send invitations to any email address. Invited users will be able to select the appropriate Yandex account once they accept the invitation.
-
Click Send invitation.
-
Log in
to the cloud administrator account. -
Log in to the management console
. -
Select the appropriate cloud from the list on the left. For example:
-
Go to the Access bindings tab.
-
In the top-right corner, click
and select Invite users. -
Enter the email addresses of the users you want to invite to the organization (e.g.,
login@yandex.com
).You can send invitations to any email address. Invited users will be able to select the appropriate Yandex account once they accept the invitation.
-
Click Send invitation.
The user will be able to log in to the organization upon accepting the invitation via the emailed link and selecting an account for log-in. To access the services enabled for the organization, the users you invited simply need to log in to their Yandex account.
You can delete or resend your invitation only via Cloud Organization.
Delete the invitation
- Under Users
, go to Invitations → Pending. - Click
in the invitation line and select Delete invitation.
Resend your invitation
- Under Users
, go to Invitations → Pending. - Click
in the invitation line and select Resend.
Note
To better safeguard your resources from unauthorized access, enable Yandex ID two-factor authentication
Federated users
If you did not enable the Automatically create users option when setting up a federation, you will have to add federated users to your organization manually.
To do this, you need to know the user name IDs returned by the Identity Provider (IdP) server together with the successful authentication response. This will usually be the user's email address. To find out what the server returns as the name ID, contact the administrator who configured authentication for your federation.
If the Automatically create users option is enabled, a federation will only add users logging in to a cloud for the first time. If a federated user has been removed, they can only be added again manually.
You do not need to invite federated users to the organization; they are added automatically after logging in.
Add federated users
- Log in
as the organization administrator. - Go to Yandex Cloud Organization
. - In the left-hand panel, select Users
. - In the top-right corner, click
→ Add federated users. - Select the identity federation to add users from.
- List the name IDs of users, separating them with line breaks.
- Click Add. This will give the users access to the organization.
If you do not have the Yandex Cloud command line interface yet, install and initialize it.
The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name
or --folder-id
parameter.
-
View a description of the add user command:
yc organization-manager federation saml add-user-accounts --help
-
Add users by listing their name IDs separated by a comma:
yc organization-manager federation saml add-user-accounts \ --name <federation_name> \ --name-ids <list_of_user_name_IDs>
Use the addUserAccounts REST API method for the Federation resource or the FederationService/AddUserAccounts gRPC API call and provide the following in the request:
- Federation ID in the
federationId
parameter. - List of user name IDs in the
nameIds
parameter.