Manage access to object storage

Last update: October 29 2024

Manage access to object storage

Access to object storage resources is regulated:

• role model — defines access within an account and projects;
• access policy — defines access within a container.

When receiving a request for an action in the object store, access is first checked by role model. If the role model allows access, the access policy is checked, if not, access is denied.

For access via API or FTP hand over the keys..

Role model access⁠

Object storage supports role model:

• Account owner — has full access to all the projects and manage all object storage resources and other products in the account through the control panel, as well as user management;
• Account Administrator — has full access to all projects and management of all object store resources except users;
• User Administrator — can create users and does not have access to object storage resources;
• Project Administrator — has full access to manage the object store and other products in the project, except for user management;
• Account Watcher — can view object store resources and other products in all projects;
• Project viewer — can view object store resources and other products in your project;
• Object Storage Administrator — has full access to object storage management in the project without access to other products and user management;
• Object storage user — by default does not have access to viewing and managing object storage resources. It has access to managing objects of those containers, for which it is set up access policy If the policy rules allow access to this user.

Control panel users

	Account owner	Account administrator	User Administrator	Project Administrator	Account Supervisor	Project viewer
Viewing the list of containers in the control panel	✓	✓	✗	✓ (under the project)	✓	✓ (as part of the project)
Reading containers in the control panel	✓	✓	✗	✓ (under the project)	✓	✓ (as part of the project)
Loading objects into the container through the control panel	✓	✓	✗	✓ (as part of the project)	✗	✗
Changing container settings in the control panel	✓	✓	✗	✓ (as part of the project)	✗	✗
User Creation with access to object storage in the control panel	✓	✗	✓	✗	✗	✗
Issuance of S3 keys to users in the control panel	✓	✗	✓	✗	✗	✗
Connecting to storage via instruments	✗	✗	✗	✗	✗	✗
Configuring the access policy in the control panel	✓	✓	✗	✓ (under the project)	✗	✗

Service users

	Account administrator	User Administrator	Project Administrator	Account Supervisor	Project Watcher	Object Storage Administrator	Object storage user
Viewing the list of containers via API	✓	✗	✓ (as part of the project)	✓ (as part of the project)	✓ (under the project)	✓ (under the project)	✓ (under the project)
Reading containers via API	✓	✗	✓ (under the project)	✓ (under the project)	✓ (under the project)	✓ (under the project)	✓ (if allowed by the container-specific access policy)
Loading objects into the container via API	✓	✗	✓ (under the project)	✗	✗	✓ (under the project)	✓ (if allowed by the container-specific access policy)
Creating users with access to object storage via API	✗	✗	✗	✗	✗	✗	✗
Issuance of S3 keys users (via the control panel)	✗	✗	✗	✗	✗	✗	✓ (if allowed by the container-specific access policy) (except Cyberduck)
Connecting to storage via instruments	✓	✗	✓ (as part of the project)	✓ (as part of the project)	✓ (as part of the project)	✓ (as part of the project)	✓

Access within the access policy⁠

If the user role provides access to object storage, access to a particular container depends on the availability and settings of the access policy:

• If no access policy is created, access will be allowed to all users with access within the role model except for the Object Storage User role;
• if an access policy is created, anything not allowed by the policy rules is denied.

For more information on how the access policy works, see Access Policy.

Keys for API access⁠

You can only issue keys for access to the storage via API service users.

Depending on the type of API the user will need:

• Keystone token is used to access through Selectel Storage API и Swift API;
• S3 key (EC2 key), used to sign requests S3 API and by FTP. Consists of a pair of values — Access Key ID and Secret Key.

Issue S3 key⁠

S3 keys (EC2 keys) can only be issued to service users с a role with access to object storage.

For your information

Only the Account Owner or User Administrator can issue an S3 key to a service user. The service user cannot get the S3 key by himself.

A separate key must be created for each project. Multiple keys can be issued for one project.

1. В control panels go to Access control → User management.

2. Open the tab Service users.

3. Open the service user page.

4. In the block S3 keys click Add key.

5. Enter the name of the key.

6. Select project for which the key will work.

7. Click Generate. Two values will be generated:

   • Access key — Access Key ID, key identifier;
   • Secret key — Secret Access Key, secret key.

8. Click Copy and save the key — it cannot be viewed after closing the window.