Configuring block public access settings for your S3 buckets - Amazon Simple Storage Service

Configuring block public access settings for your S3 buckets

Amazon S3 Block Public Access provides settings for access points, buckets, and accounts to help you manage public access to Amazon S3 resources. By default, new buckets, access points, and objects do not allow public access.

For more information, see Blocking public access to your Amazon S3 storage.

You can use the S3 console, AWS CLI, AWS SDKs, and REST API to grant public access to one or more buckets. You can also block public access to buckets that are already public. For more information, see the sections below.

To configure block public access settings for every bucket in your account, see Configuring block public access settings for your account. For information about configuring block public access for access points, see Performing block public access operations on an access point.

Amazon S3 Block Public Access prevents the application of any settings that allow public access to data within S3 buckets. This section describes how to edit Block Public Access settings for one or more S3 buckets. For information about blocking public access using the AWS CLI, AWS SDKs, and the Amazon S3 REST APIs, see Blocking public access to your Amazon S3 storage.

You can see if your bucket is publicly accessible from the Buckets list, in the IAM Access Analyzer column. For more information, see Reviewing bucket access using IAM Access Analyzer for S3.

If you see an Error when you list your buckets and their public access settings, you might not have the required permissions. Check to make sure you have the following permissions added to your user or role policy:

s3:GetAccountPublicAccessBlock
s3:GetBucketPublicAccessBlock
s3:GetBucketPolicyStatus
s3:GetBucketLocation
s3:GetBucketAcl
s3:ListAccessPoints
s3:ListAllMyBuckets

In some rare cases, requests can also fail because of an AWS Region outage.

To edit the Amazon S3 block public access settings for a single S3 bucket

Follow these steps if you need to change the public access settings for a single S3 bucket.

  1. Sign in to the AWS Management Console and open the Amazon S3 console at https://console.aws.amazon.com/s3/.

  2. In the Bucket name list, choose the name of the bucket that you want.

  3. Choose Permissions.

  4. Choose Edit next to Block public access (bucket settings) to change the public access settings for the bucket. For more information about the four Amazon S3 Block Public Access Settings, see Block public access settings.

  5. Choose one of the settings, and then choose Save changes.

  6. When you're asked for confirmation, enter confirm. Then choose Confirm to save your changes.

You can also change Amazon S3 Block Public Access settings when you create a bucket. For more information, see Creating a general purpose bucket.

To block public access on a bucket or to delete the public access block, use the AWS CLI service s3api. The bucket-level operations that use this service are as follows:

  • PutPublicAccessBlock (for a bucket)

  • GetPublicAccessBlock (for a bucket)

  • DeletePublicAccessBlock (for a bucket)

  • GetBucketPolicyStatus

For more information and examples, see put-public-access-block in the AWS CLI Reference.

Java

AmazonS3 client = AmazonS3ClientBuilder.standard()
	  .withCredentials(<credentials>)
	  .build();

client.setPublicAccessBlock(new SetPublicAccessBlockRequest()
		.withBucketName(<bucket-name>)
		.withPublicAccessBlockConfiguration(new PublicAccessBlockConfiguration()
				.withBlockPublicAcls(<value>)
				.withIgnorePublicAcls(<value>)
				.withBlockPublicPolicy(<value>)
				.withRestrictPublicBuckets(<value>)));
Important

This example pertains only to bucket-level operations, which use the AmazonS3 client class. For account-level operations, see the following example.

Other SDKs

For information about using the other AWS SDKs, see Developing with Amazon S3 using the AWS SDKs in the Amazon S3 API Reference.

For information about using Amazon S3 Block Public Access through the REST APIs, see the following topics in the Amazon Simple Storage Service API Reference.