# AWS Allowlist
[![ci](https://github.com/geoffreywiseman/awswl/actions/workflows/ci.yml/badge.svg)](https://github.com/geoffreywiseman/awswl/actions/workflows/ci.yml)
[![Downloads](https://static.pepy.tech/badge/awswl)](https://pepy.tech/project/awswl)
[![Documentation](https://readthedocs.org/projects/awswl/badge/)](https://awswl.readthedocs.io/en/latest/)
![PyPI - Downloads](https://img.shields.io/pypi/dm/awswl)
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/f5/e4/4de0dea2de97882924d3507877372306acf67b751ea083a73d99f8de9e40/awswl-1.2.1.tar.gz",
"platform": null,
"description": "# AWS Allowlist\n\n[![ci](https://github.com/geoffreywiseman/awswl/actions/workflows/ci.yml/badge.svg)](https://github.com/geoffreywiseman/awswl/actions/workflows/ci.yml)\n[![Downloads](https://static.pepy.tech/badge/awswl)](https://pepy.tech/project/awswl)\n[![Documentation](https://readthedocs.org/projects/awswl/badge/)](https://awswl.readthedocs.io/en/latest/)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/awswl)\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.1",
"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": "e10482648d73cc49aa76952f6ef47889ab633ecee7dfa244df1f14c485bed47c",
"md5": "626d415916e533e56552c5951804cbde",
"sha256": "31a524aa4457a16bfeeb9fddff487f0a0ee42fb5cb980cad996ec832b9ec5947"
},
"downloads": -1,
"filename": "awswl-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "626d415916e533e56552c5951804cbde",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 7677,
"upload_time": "2024-11-17T01:04:03",
"upload_time_iso_8601": "2024-11-17T01:04:03.340999Z",
"url": "https://files.pythonhosted.org/packages/e1/04/82648d73cc49aa76952f6ef47889ab633ecee7dfa244df1f14c485bed47c/awswl-1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f5e44de0dea2de97882924d3507877372306acf67b751ea083a73d99f8de9e40",
"md5": "b2c88f8964ea0b6d8f1b82147f3e7d0d",
"sha256": "679aa480e9504320dd7b308926c6d77895ce44d6a115e3ca630ac7027c9d13a9"
},
"downloads": -1,
"filename": "awswl-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "b2c88f8964ea0b6d8f1b82147f3e7d0d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 6242,
"upload_time": "2024-11-17T01:04:05",
"upload_time_iso_8601": "2024-11-17T01:04:05.610030Z",
"url": "https://files.pythonhosted.org/packages/f5/e4/4de0dea2de97882924d3507877372306acf67b751ea083a73d99f8de9e40/awswl-1.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-17 01:04:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "geoffreywiseman",
"github_project": "awswl",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "awswl"
}