# AWS Allowlist
[](https://github.com/geoffreywiseman/awswl/actions/workflows/ci.yml)
[](https://pepy.tech/project/awswl)
[](https://awswl.readthedocs.io/en/latest/)
A small tool to make it pretty simple to add and remove ip addresses (or CIDR blocks) from an AWS security group. This acts like a sort of oversimplified VPN, where you can quickly give yourself SSH access to a project as you move about from network to network.
This README should have enough information to get started, but you can get more information on:
- recent changes in the [CHANGELOG](CHANGELOG.md)
- documentation on [Read The Docs](https://awswl.readthedocs.io/en/latest/)
- [Alternatives](docs/alternatives.md) to awswl
## Installing 🛠️
This is a python tool, packaged as a python module, so you should be able to just run
```bash
pip install awswl
```
Of course, if you don't know what a python module is, or you don't have python and pip installed,
you may have additional work ahead of you.
Now that Python2 is largely a relic of the past, I'm focused on supporting Python 3 only. The current CI build is for Python 3.9+.
## Usage ⌨
If you want usage help at the command line, try:
```bash
awswl --help
```
There's more detailed usage documentation in the documentation, which you can read on [GitHub](docs/usage.md) or [readthedocs](https://awswl.readthedocs.io/en/latest/usage/).
## Environment
All of these require you to have AWS credentials set up in advance, stored in
``~/.aws/credentials``, and if you need to use a profile, you can configure it with
``AWS_PROFILE``. If you want to identify the security group using a command-line variable so that
you don't have to put it into each command invocation, you can put it in ``AWSWL_SGID``.
Raw data
{
"_id": null,
"home_page": "https://github.com/geoffreywiseman/awswl",
"name": "awswl",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "aws, vpn, securitygroups, security, networking, allowlist, ssh, firewall, utility",
"author": "Geoffrey Wiseman",
"author_email": "geoffrey.wiseman@codiform.com",
"download_url": "https://files.pythonhosted.org/packages/93/62/ea1bf41961f446c59898da0ac99f4c16a7968b8de720ac933957f1b2c0c9/awswl-1.2.2.tar.gz",
"platform": null,
"description": "# AWS Allowlist\n\n[](https://github.com/geoffreywiseman/awswl/actions/workflows/ci.yml)\n[](https://pepy.tech/project/awswl)\n[](https://awswl.readthedocs.io/en/latest/)\n\n\n\nA small tool to make it pretty simple to add and remove ip addresses (or CIDR blocks) from an AWS security group. This acts like a sort of oversimplified VPN, where you can quickly give yourself SSH access to a project as you move about from network to network.\n\nThis README should have enough information to get started, but you can get more information on:\n- recent changes in the [CHANGELOG](CHANGELOG.md)\n- documentation on [Read The Docs](https://awswl.readthedocs.io/en/latest/)\n- [Alternatives](docs/alternatives.md) to awswl\n\n## Installing \ud83d\udee0\ufe0f\n\nThis is a python tool, packaged as a python module, so you should be able to just run\n\n```bash\npip install awswl\n``` \n\nOf course, if you don't know what a python module is, or you don't have python and pip installed,\nyou may have additional work ahead of you.\n\nNow that Python2 is largely a relic of the past, I'm focused on supporting Python 3 only. The current CI build is for Python 3.9+.\n\n## Usage \u2328\n\nIf you want usage help at the command line, try:\n\n```bash\nawswl --help\n```\n\nThere's more detailed usage documentation in the documentation, which you can read on [GitHub](docs/usage.md) or [readthedocs](https://awswl.readthedocs.io/en/latest/usage/).\n\n\n## Environment\n\nAll of these require you to have AWS credentials set up in advance, stored in\n``~/.aws/credentials``, and if you need to use a profile, you can configure it with\n``AWS_PROFILE``. If you want to identify the security group using a command-line variable so that\nyou don't have to put it into each command invocation, you can put it in ``AWSWL_SGID``.\n",
"bugtrack_url": null,
"license": "Public Domain",
"summary": "A project to make it simple to add/remove ip addresses (or CIDR blocks) from an AWS Security group.",
"version": "1.2.2",
"project_urls": {
"Homepage": "https://github.com/geoffreywiseman/awswl",
"Repository": "https://github.com/geoffreywiseman/awswl"
},
"split_keywords": [
"aws",
" vpn",
" securitygroups",
" security",
" networking",
" allowlist",
" ssh",
" firewall",
" utility"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2ac619d6a57e1e3fbc0d0fcd6332c7adf7c6d5d8c3e2716188f85fed84878491",
"md5": "fdeaa2f03b6c732f21cedc573e333131",
"sha256": "46def05f609d5c93418052fab1d55bb9a31823319195642609ffbb8efda910e3"
},
"downloads": -1,
"filename": "awswl-1.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fdeaa2f03b6c732f21cedc573e333131",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 7680,
"upload_time": "2025-02-11T17:57:51",
"upload_time_iso_8601": "2025-02-11T17:57:51.135363Z",
"url": "https://files.pythonhosted.org/packages/2a/c6/19d6a57e1e3fbc0d0fcd6332c7adf7c6d5d8c3e2716188f85fed84878491/awswl-1.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9362ea1bf41961f446c59898da0ac99f4c16a7968b8de720ac933957f1b2c0c9",
"md5": "8e6b9bad52ddb0c312f0b7e7f3d40a8e",
"sha256": "a3052365b778c306389f2855c3675720f1582d9e41d6af82553046c1641b2442"
},
"downloads": -1,
"filename": "awswl-1.2.2.tar.gz",
"has_sig": false,
"md5_digest": "8e6b9bad52ddb0c312f0b7e7f3d40a8e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 6029,
"upload_time": "2025-02-11T17:57:52",
"upload_time_iso_8601": "2025-02-11T17:57:52.959885Z",
"url": "https://files.pythonhosted.org/packages/93/62/ea1bf41961f446c59898da0ac99f4c16a7968b8de720ac933957f1b2c0c9/awswl-1.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-11 17:57:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "geoffreywiseman",
"github_project": "awswl",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "awswl"
}
JSON
