51369b610e
When an include is not surrounded by empty lines, its content is inlined on the same line as the adjacent content. That can lead to broken tags and other display issues. This PR fixes all such includes and introduces a validation step that forbids introducing the same problem again.
124 lines
3.6 KiB
Plaintext
124 lines
3.6 KiB
Plaintext
By default S3 buckets are private, it means that only the bucket owner can access it.
|
|
|
|
This access control can be relaxed with ACLs or policies.
|
|
|
|
|
|
To prevent permissive policies to be set on a S3 bucket the following booleans settings can be enabled:
|
|
|
|
* `block_public_acls`: to block or not public ACLs to be set to the S3 bucket.
|
|
* `ignore_public_acls`: to consider or not existing public ACLs set to the S3 bucket.
|
|
* `block_public_policy`: to block or not public policies to be set to the S3 bucket.
|
|
* `restrict_public_buckets`: to restrict or not the access to the S3 endpoints of public policies to the principals within the bucket owner account.
|
|
|
|
The other attribute `BlockPublicAccess.BLOCK_ACLS` only turns on `block_public_acls` and `ignore_public_acls`. The public policies can still affect the S3 bucket.
|
|
|
|
|
|
However, all of those options can be enabled by setting the `block_public_access` property of the S3 bucket to `BlockPublicAccess.BLOCK_ALL`.
|
|
|
|
|
|
include::../ask-yourself.adoc[]
|
|
|
|
== Recommended Secure Coding Practices
|
|
|
|
It's recommended to configure:
|
|
|
|
* `block_public_acls` to `True` to block new attempts to set public ACLs.
|
|
* `ignore_public_acls` to `True` to block existing public ACLs.
|
|
* `block_public_policy` to `True` to block new attempts to set public policies.
|
|
* `restrict_public_buckets` to `True` to restrict existing public policies.
|
|
|
|
|
|
== Sensitive Code Example
|
|
|
|
By default, when not set, the `block_public_access` is fully deactivated (nothing is blocked):
|
|
|
|
[source,python]
|
|
----
|
|
bucket = s3.Bucket(self,
|
|
"bucket" # Sensitive
|
|
)
|
|
----
|
|
|
|
This `block_public_access` allows public ACL to be set:
|
|
|
|
[source,python]
|
|
----
|
|
bucket = s3.Bucket(self,
|
|
"bucket",
|
|
block_public_access=s3.BlockPublicAccess(
|
|
block_public_acls=False, # Sensitive
|
|
ignore_public_acls=True,
|
|
block_public_policy=True,
|
|
restrict_public_buckets=True
|
|
)
|
|
)
|
|
----
|
|
|
|
The attribute `BLOCK_ACLS` only blocks and ignores public ACLs:
|
|
|
|
[source,python]
|
|
----
|
|
bucket = s3.Bucket(self,
|
|
"bucket",
|
|
block_public_access=s3.BlockPublicAccess.BLOCK_ACLS # Sensitive
|
|
)
|
|
----
|
|
|
|
== Compliant Solution
|
|
|
|
This `block_public_access` blocks public ACLs and policies, ignores existing public ACLs and restricts existing public policies:
|
|
|
|
[source,python]
|
|
----
|
|
bucket = s3.Bucket(self,
|
|
"bucket",
|
|
block_public_access=s3.BlockPublicAccess.BLOCK_ALL # Compliant
|
|
)
|
|
----
|
|
|
|
A similar configuration to the one above can obtained by setting all parameters of the `block_public_access`
|
|
|
|
[source,python]
|
|
----
|
|
bucket = s3.Bucket(self, "bucket",
|
|
block_public_access=s3.BlockPublicAccess( # Compliant
|
|
block_public_acls=True,
|
|
ignore_public_acls=True,
|
|
block_public_policy=True,
|
|
restrict_public_buckets=True
|
|
)
|
|
)
|
|
----
|
|
|
|
include::../see.adoc[]
|
|
|
|
* https://docs.aws.amazon.com/cdk/api/v2/python/aws_cdk.aws_s3/Bucket.html[AWS CDK version 2] - Bucket
|
|
ifdef::env-github,rspecator-view[]
|
|
|
|
'''
|
|
== Implementation Specification
|
|
(visible only on this page)
|
|
|
|
=== Message
|
|
|
|
* Primary locations
|
|
** Make sure allowing public ACL/policies to be set is safe here.
|
|
** No Public Access Block configuration prevents public ACL/policies to be set on this S3 bucket. Make sure it is safe here.
|
|
* Secondary location
|
|
** Propagated setting.
|
|
|
|
|
|
=== Highlighting
|
|
|
|
* Primary locations
|
|
** aws_cdk.aws_s3.Bucket constructor
|
|
** aws_cdk.aws_s3.Bucket.block_public_access property
|
|
** aws_cdk.aws_s3.Bucket.public_read_access property
|
|
** 'block_public_acls', 'block_public_policy', 'ignore_public_acls', 'restrict_public_buckets' properties of Bucket set to False
|
|
|
|
* Secondary location
|
|
** For the propagated sensitive setting
|
|
|
|
|
|
endif::env-github,rspecator-view[]
|