A tool for creating credentials for accessing S3 buckets
Go to file
Simon Willison 15922d2dfc
Release 0.16.1
2024-04-04 22:44:28 -07:00
.github setup.py not pyproject.toml 2024-04-04 22:37:34 -07:00
docs Ran cog, refs #90 2024-04-04 22:31:41 -07:00
s3_credentials list-bucket --urls option, closes #89 2024-04-04 22:13:37 -07:00
tests Upgrade moto, refs #90 2024-04-04 22:20:19 -07:00
.gitignore Initial s3-credentials whoami command, refs #1 2021-11-02 14:40:25 -07:00
.readthedocs.yaml readthedocs.yaml config 2024-04-04 22:42:42 -07:00
LICENSE Initial s3-credentials whoami command, refs #1 2021-11-02 14:40:25 -07:00
README.md Bulk out the README a bit 2022-09-15 10:42:28 -07:00
setup.py Release 0.16.1 2024-04-04 22:44:28 -07:00

README.md

s3-credentials

PyPI Changelog Tests Documentation Status License

A tool for creating credentials for accessing S3 buckets

For project background, see s3-credentials: a tool for creating credentials for S3 buckets on my blog.

Installation

pip install s3-credentials

Basic usage

To create a new S3 bucket and output credentials that can be used with only that bucket:

% s3-credentials create my-new-s3-bucket --create-bucket
Created bucket:  my-new-s3-bucket
Created user: s3.read-write.my-new-s3-bucket with permissions boundary: arn:aws:iam::aws:policy/AmazonS3FullAccess
Attached policy s3.read-write.my-new-s3-bucket to user s3.read-write.my-new-s3-bucket
Created access key for user: s3.read-write.my-new-s3-bucket
{
    "UserName": "s3.read-write.my-new-s3-bucket",
    "AccessKeyId": "AKIAWXFXAIOZOYLZAEW5",
    "Status": "Active",
    "SecretAccessKey": "...",
    "CreateDate": "2021-11-03 01:38:24+00:00"
}

The tool can do a lot more than this. See the documentation for details.

Documentation