Skip to navigation

S3 Browser with a sub-user key

Open one bucket in S3 Browser with a sub-user’s key.

A sub-user’s key only works on the buckets the account owner assigned to it. S3 Browser normally lists your buckets, but for a sub-user that list is always empty. So you connect as usual and then add the bucket by its exact name.

Before you start

  • The sub-user’s credentials file. Zata downloads it when the owner creates the sub-user or adds a region to it. For each region it lists the Service URL, Access Key and Secret Key. The secret key cannot be shown again — if the file is lost, the owner makes a new key, see New keys for a sub-user.
  • The exact name of a bucket assigned to the sub-user. The owner sees it in the Zata console under Subusers, in the Assigned Buckets column. To give access, see Assign a bucket.
  • S3 Browser installed — download S3 Browser.
The Subusers page in the Zata console, showing a sub-user with one bucket in the Assigned Buckets column
A sub-user has a separate key for each region. Use the key and Service URL of the region the bucket is in — an Indore key does not work on the Mumbai endpoint, and the other way round.

Connection settings

SettingValue
Account typeS3 Compatible Storage
REST Endpointthe Service URL from the credentials file: https://idr01.zata.ai (Indore) or https://bom01.zata.ai (Mumbai)
Access Key ID / Secret Access Keythe Access Key and Secret Key from the credentials file, for the bucket’s region
Use secure transfer (SSL/TLS)On
Signature version / Addressing model (advanced settings)Signature V4 / Path style

Set up S3 Browser

1

Add an account

Open S3 Browser and select Accounts → Add new account.

The Accounts menu in S3 Browser with Add new account
2

Enter the sub-user's key

Enter a Display name, set Account type to S3 Compatible Storage, and enter the REST Endpoint and the sub-user’s keys. Keep Use secure transfer (SSL/TLS) ticked. Under advanced settings, choose Signature V4 and Path style (screenshot on the S3 Browser page). Then select Add new account.

Add New Account form filled in with a sub-user's key and the endpoint https://idr01.zata.ai

The bucket list stays empty. That is normal for a sub-user.

3

Add the bucket by name

Select Add external bucket above the bucket list. Enter the exact bucket name and select Add External bucket.

If the owner gave you access to one folder only, enter the bucket name and the folder, for example my-bucket/reports/.

The Add External Bucket dialog with a bucket name entered
4

Open the bucket

The bucket now appears in the list. Select it to see its files.

The added bucket selected in S3 Browser, with its files listed on the right

What the sub-user can do

The owner sets one of these permissions for each bucket (or folder):

PermissionWhat works in S3 Browser
View OnlyBrowse and download files
Upload OnlyUpload new files only. Listing the bucket is denied, so you cannot browse or download.
View & UploadBrowse, download and upload. No delete.
Full AccessBrowse, download, upload and delete. Renaming or moving needs this level too.

Sub-users cannot create buckets — New bucket always gives Access Denied. Ask the account owner to create the bucket and assign it to you.

Troubleshooting

ProblemFix
The bucket list is emptyNormal for sub-users. Add the bucket with Add external bucket.
Access Denied when you open the bucketCheck the bucket name (exact, lowercase). Check with the owner that the bucket is assigned to this sub-user and that the permission includes listing — Upload Only does not. If access is limited to a folder, add my-bucket/folder-name/ instead.
InvalidAccessKeyId or the connection failsThe key is from the other region. Use the key and Service URL for the bucket’s region.
Invalid credentialsCopy the keys again from the credentials file, without extra spaces.

See also Access denied and Sub-users overview.