AWS S3 Access Grants Plugin provides the functionality to enable S3 customers to configure S3 ACCESS GRANTS as a permission layer on top of the S3 Clients.
S3 Access Grants is a feature from S3 that allows its customers to configure fine-grained access permissions for the data in their buckets.
Run this command to install the plugin.
pip install aws-s3-access-grants-boto3-plugin==<Latest_Version>
- Create your S3 Client.
- Create a S3AccessGrantsPlugin object and pass the S3 Client and fallback option during initialization.
- Register the plugin.
import botocore.session
from aws_s3_access_grants_boto3_plugin.s3_access_grants_plugin import S3AccessGrantsPlugin
session = botocore.session.get_session()
s3_client = session.create_client('s3')
plugin = S3AccessGrantsPlugin(s3_client, fallback_enabled=True)
plugin.register()
fallback_enabled takes in a boolean value. This option decides if we will fall back to the credentials set on the S3 Client by the user.
- If fallback_enabled is set to True then we will fall back every time we are not able to get the credentials from Access Grants, no matter the reason.
- If fallback_enabled option is set to False we will fall back only in case the operation/API is not supported by Access Grants.
- The plugin supports delete_objects API and copy_object API which S3 Access Grants does not implicitly support. For these APIs we get the common prefix of all the object keys and find their common ancestor. If you have a grant present on the common ancestor, you will get Access Grants credentials based on that grant. For copy_object API the source and destination buckets should be same, since a grant cannot give access to multiple buckets.
- Currently, the plugin grants access to Amazon S3 bucket, prefix, or object via IAM principals only.
- See CONTRIBUTING.md
This project is licensed under the Apache-2.0 License.