A tool for creating credentials for accessing S3 buckets
Go to file
Simon Willison 1628856634 --public fixed tests, refs #88 2024-04-04 22:09:03 -07:00
.github Run pip freeze to show dependencies, refs #85 2023-04-30 09:36:56 -07:00
docs --public fixed tests, refs #88 2024-04-04 22:09:03 -07:00
s3_credentials --public fixed tests, refs #88 2024-04-04 22:09:03 -07:00
tests --public fixed tests, refs #88 2024-04-04 22:09:03 -07:00
.gitignore Initial s3-credentials whoami command, refs #1 2021-11-02 14:40:25 -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.15 2023-04-30 15:08:14 -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