# s3-credentials
[](https://pypi.org/project/s3-credentials/)
[](https://github.com/simonw/s3-credentials/releases)
[](https://github.com/simonw/s3-credentials/actions?query=workflow%3ATest)
[](https://s3-credentials.readthedocs.org/)
[](https://github.com/simonw/s3-credentials/blob/master/LICENSE)
A tool for creating credentials for accessing S3 buckets
For project background, see [s3-credentials: a tool for creating credentials for S3 buckets](https://simonwillison.net/2021/Nov/3/s3-credentials/) 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](https://s3-credentials.readthedocs.io/) for details.
## Documentation
- [Full documentation](https://s3-credentials.readthedocs.io/)
- [Command help reference](https://s3-credentials.readthedocs.io/en/stable/help.html)
- [Release notes](https://github.com/simonw/s3-credentials/releases)
Raw data
{
"_id": null,
"home_page": "https://github.com/simonw/s3-credentials",
"name": "s3-credentials",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "Simon Willison",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/3e/75/680af77727974d02bf32fd1873f863e8c9c20c9f309e7006f23f56d571ab/s3-credentials-0.16.1.tar.gz",
"platform": null,
"description": "# s3-credentials\n\n[](https://pypi.org/project/s3-credentials/)\n[](https://github.com/simonw/s3-credentials/releases)\n[](https://github.com/simonw/s3-credentials/actions?query=workflow%3ATest)\n[](https://s3-credentials.readthedocs.org/)\n[](https://github.com/simonw/s3-credentials/blob/master/LICENSE)\n\nA tool for creating credentials for accessing S3 buckets\n\nFor project background, see [s3-credentials: a tool for creating credentials for S3 buckets](https://simonwillison.net/2021/Nov/3/s3-credentials/) on my blog.\n\n## Installation\n\n pip install s3-credentials\n\n## Basic usage\n\nTo create a new S3 bucket and output credentials that can be used with only that bucket:\n```\n% s3-credentials create my-new-s3-bucket --create-bucket\nCreated bucket: my-new-s3-bucket\nCreated user: s3.read-write.my-new-s3-bucket with permissions boundary: arn:aws:iam::aws:policy/AmazonS3FullAccess\nAttached policy s3.read-write.my-new-s3-bucket to user s3.read-write.my-new-s3-bucket\nCreated access key for user: s3.read-write.my-new-s3-bucket\n{\n \"UserName\": \"s3.read-write.my-new-s3-bucket\",\n \"AccessKeyId\": \"AKIAWXFXAIOZOYLZAEW5\",\n \"Status\": \"Active\",\n \"SecretAccessKey\": \"...\",\n \"CreateDate\": \"2021-11-03 01:38:24+00:00\"\n}\n```\nThe tool can do a lot more than this. See the [documentation](https://s3-credentials.readthedocs.io/) for details.\n\n## Documentation\n\n- [Full documentation](https://s3-credentials.readthedocs.io/)\n- [Command help reference](https://s3-credentials.readthedocs.io/en/stable/help.html)\n- [Release notes](https://github.com/simonw/s3-credentials/releases)\n",
"bugtrack_url": null,
"license": "Apache License, Version 2.0",
"summary": "A tool for creating credentials for accessing S3 buckets",
"version": "0.16.1",
"project_urls": {
"CI": "https://github.com/simonw/s3-credentials/actions",
"Changelog": "https://github.com/simonw/s3-credentials/releases",
"Homepage": "https://github.com/simonw/s3-credentials",
"Issues": "https://github.com/simonw/s3-credentials/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4ecd659a77e944584056f2c489956b4fd4cafa26278b82c8204e99bfba6e4b94",
"md5": "38f2ec85b3e2ace4b244f908a99bf69c",
"sha256": "c07eb808cab1c7a6af52c513cce183d2a91596291b365e2f87e82ccb23c9d3d7"
},
"downloads": -1,
"filename": "s3_credentials-0.16.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "38f2ec85b3e2ace4b244f908a99bf69c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 19134,
"upload_time": "2024-04-05T05:46:28",
"upload_time_iso_8601": "2024-04-05T05:46:28.238830Z",
"url": "https://files.pythonhosted.org/packages/4e/cd/659a77e944584056f2c489956b4fd4cafa26278b82c8204e99bfba6e4b94/s3_credentials-0.16.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3e75680af77727974d02bf32fd1873f863e8c9c20c9f309e7006f23f56d571ab",
"md5": "28a4ee309f74b84126666f385bd63e68",
"sha256": "223e81f41d3e5becd5d33becd087555cee7d1c2f8a9f77dc58c5a954c6e6e7d9"
},
"downloads": -1,
"filename": "s3-credentials-0.16.1.tar.gz",
"has_sig": false,
"md5_digest": "28a4ee309f74b84126666f385bd63e68",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 29535,
"upload_time": "2024-04-05T05:46:30",
"upload_time_iso_8601": "2024-04-05T05:46:30.108992Z",
"url": "https://files.pythonhosted.org/packages/3e/75/680af77727974d02bf32fd1873f863e8c9c20c9f309e7006f23f56d571ab/s3-credentials-0.16.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-05 05:46:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "simonw",
"github_project": "s3-credentials",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "s3-credentials"
}
JSON
