Security in Object Storage
Who may do what (IAM), what is audited, how objects are encrypted at rest, and who can reach a bucket.
IAM actions
Every signed request, through the console, the API or an S3 client, is checked against your IAM
policies and the bucket policy; an unsigned request, against the bucket policy alone.
A bucket's resource name is rn:ews::<org>:s3:bucket/<name>, an object's
rn:ews::<org>:s3:bucket/<name>/object/<key>; object storage has no region segment.
| Action | Access | What it allows |
|---|---|---|
s3:ListBuckets | Read | List the buckets of the organization |
s3:GetBucket | Read | Describe a bucket |
s3:CreateBucket | Write | Create a bucket |
s3:DeleteBucket | Write · destructive | Delete an empty bucket |
s3:ListObjects | Read | List the object keys and sizes in a bucket |
s3:GetObject | Read · sensitive | Read the contents of an object |
s3:PutObject | Write · destructive | Upload an object, including multipart uploads |
s3:DeleteObject | Write · destructive | Delete an object |
s3:AbortMultipartUpload | Write · destructive | Abandon a multipart upload and discard its parts |
s3:GetBucketVersioning | Read | Read whether a bucket keeps old versions of its objects |
s3:PutBucketVersioning | Write · destructive | Turn versioning on or suspend it |
s3:ListBucketVersions | Read | List every version and delete marker in a bucket |
s3:GetLifecycleConfiguration | Read | Read the rules that expire or clean up objects |
s3:PutLifecycleConfiguration | Write · destructive | Set or remove the rules that expire or clean up objects |
s3:GetBucketCORS | Read | Read which websites may call the bucket from a browser |
s3:PutBucketCORS | Write · destructive | Set or remove which websites may call the bucket from a browser |
s3:GetBucketObjectLockConfiguration | Read | Read a locked bucket's default retention |
s3:PutBucketObjectLockConfiguration | Write · destructive | Set a locked bucket's default retention |
s3:GetBucketPolicy | Read | Read the bucket policy, which can make objects public |
s3:PutBucketPolicy | Write · destructive | Set the bucket policy; with block public access off it can make objects public |
s3:DeleteBucketPolicy | Write · destructive | Remove the bucket policy |
s3:GetBucketPublicAccessBlock | Read | Read whether the bucket blocks public access |
s3:PutBucketPublicAccessBlock | Write · destructive | Turn block public access on or off for the bucket |
s3:GetBucketWebsite | Read | Read the static website configuration and custom domains |
s3:PutBucketWebsite | Write | Serve the bucket as a static website, and add custom domains |
s3:DeleteBucketWebsite | Write · destructive | Stop serving the bucket as a website, or remove a custom domain |
s3:GetReplicationConfiguration | Read | Read the bucket’s replication rules and how far replication has got |
s3:PutReplicationConfiguration | Write | Replicate the bucket’s objects to another bucket (also needs PutObject on the destination) |
s3:DeleteReplicationConfiguration | Write · destructive | Stop replicating the bucket (replicas already made are kept) |
s3:GetBucketRemoteCopy | Read | Read whether a bucket on a storage cluster keeps a copy in another location, and what still waits to be copied |
s3:PutBucketRemoteCopy | Write · destructive | Turn the copy in another location on or off for a bucket on a storage cluster (off: the copy is deleted after a grace period) |
s3:GetEncryptionConfiguration | Read | Read which key encrypts the bucket’s objects |
s3:PutEncryptionConfiguration | Write | Choose the key that encrypts the bucket’s objects: the platform key or a KMS key (also needs kms:Encrypt on it) |
s3:GetObjectVersion | Read · sensitive | Read a specific earlier version of an object |
s3:DeleteObjectVersion | Write · destructive | Delete a specific version of an object for good |
s3:GetObjectRetention | Read | Read how long an object version is locked |
s3:PutObjectRetention | Write · destructive | Lock an object version until a date, or extend the lock |
s3:BypassGovernanceRetention | Write · destructive | Shorten or remove a governance-mode lock, or delete under one |
s3:GetObjectLegalHold | Read | Read whether an object version is under legal hold |
s3:PutObjectLegalHold | Write · destructive | Place or lift a legal hold on an object version |
s3:ListAccessKeys | Read | List S3 access keys — ids and status, never secrets |
s3:CreateAccessKey | Write | Create an S3 access key; the secret is shown once |
s3:DeleteAccessKey | Write · destructive | Delete an S3 access key |
s3:CreateTemporaryCredentials | Write | Create short-lived S3 credentials with a session token; they act with the caller’s permissions |
Generated from the service’s IAM descriptor. Sensitive reads hand over secret material or source code and are recorded in the audit log like writes; destructive writes delete, overwrite or revoke.
s3:GetObjectands3:GetObjectVersionare sensitive reads: the generated ReadOnly policy leaves them out, and an allowed read through the API is recorded in the audit log.- Some operations check more than their own action: restoring a version also needs
s3:GetObjectVersion; replication needss3:PutObjecton the destination; a KMS key needskms:Encrypton it; reading all public-access settings at once (GET /s3/api/buckets/{name}/public-access) needss3:GetBucketPolicy,s3:GetBucketPublicAccessBlockands3:GetBucketWebsite. - Removing CORS rules, lifecycle rules or the KMS key needs the setting's Put action, as on AWS.
- A bucket's policy, Block public access, website and other settings can be changed only by your own organization, never through a bucket policy.
- Access keys are IAM access keys: creating one is
iam:CreateAccessKey(see Create an access key). Older S3 keys, made withs3:CreateAccessKey, keep working; temporary credentials ares3:CreateTemporaryCredentials.
How IAM policies, key scopes and bucket policies combine is in Access control.
Audit
Every write through the API is recorded in the audit log with its outcome, and so are sensitive reads and refused requests. An unsigned request, such as a public read, has nobody to record.
Encryption at rest
Every object is encrypted under its bucket's own data key, which is wrapped by the platform key or a KMS key of yours. See Encryption.
Encryption in transit
The endpoint, the bucket addresses and the website addresses answer over HTTPS.
Network exposure
A bucket is private: nothing in it can be read without a key while Block public access is on, which it is for every new bucket. A bucket policy can make objects public (see Make objects public), and a website serves only those public objects.