This guide will show you how to share an e24files container with other e24cloud users.
To share a container with other e24files users, you need to create those users first. The entire process is described in this article.
Next, create any number of containers using external software or directly in the Client Panel by navigating to Cloud Files > Permissions and clicking the Add Container button.
For the purposes of this guide, we have created one additional user and two containers:
bucket-name1
bucket-name2
Then, go to Cloud Files > API and copy your API key
.
In our example, the key is:
aaaabbbb-cccc-dddd-eeee-ffffgggghhhh
In e24files, permissions can be assigned in two ways using either ACL
(an older method) or bucket policy
(newer and recommended).
We use bucket policy
if:
We use ACL
if:
bucket policy
.bucket policy
Navigate to the Cloud Files > Permissions tab and, for each created container, click the Edit Rules button.
In the window that appears, insert the following rule if you want to grant full access
to selected containers:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::user/aaaabbbb-cccc-dddd-eeee-ffffgggghhhh"
},
"Action": "s3:*",
"Resource": [
"arn:aws:s3:::bucket-name1",
"arn:aws:s3:::bucket-name1/*"
]
}
]
}
or the following rule if you want to grant read-only
permissions:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam:::user/aaaabbbb-cccc-dddd-eeee-ffffgggghhhh"
},
"Action": [
"s3:GetObject",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::bucket-name1",
"arn:aws:s3:::bucket-name1/*"
]
}
]
}
The string aaaabbbb-cccc-dddd-eeee-ffffgggghhhh
should be replaced with your API key
, and the container name bucket-name1
should be replaced with the one you created in the previous step. Save the changes. Repeat this operation for every container
you want to share.
This way, we have assigned permissions for our containers to another user or group of users.
ACL
To assign permissions to users, for each container you want to share, click the Edit Permissions button.
In the window that appears, select the user you want to share the container with and the level of permissions they should have for that container, then click the Add button. This way, you can add multiple users with different permissions. Finally, click the Save Changes button.
This way, we have granted permissions for our containers to another user.
Due to the specifics of how the S3 technology that e24files is based on works, shared containers are not visible in the Client Panel on the account of the user they were shared with and are not visible by default when logging into the S3 account using external tools.
To solve this issue, you need to specify the container’s path in the Path
field.
This way, we have assigned permissions for our containers to another user or group of users.