# aws-portknock #
Port knocking for AWS security groups
## "Port knocking" ##
Unlike the traditional port knocking utilities, this tool relies on
the caller having the rights, through Amazon Web Services' Identity
and Access Management roles, to modify a security group.
## Usage ##
```
$ aws-portknock --help
Usage: aws-portknock [OPTIONS]
Options:
--port INTEGER Port to open
--profile TEXT Configuration profile to use
--sgid TEXT Security group ID
--help Show this message and exit.
```
`aws-portknock` will determine the caller's public IP and add a rule
to the security group allowing access to the requested port from that
IP. It then sleeps until the user quits by using CTRL-C.
If a matching rule already exists, nothing happens on exit; otherwise,
that added rule is deleted when `aws-portknock` exits.
For repeated use, create `$HOME/.aws/portknock.ini` containing, for example:
```
[default]
sgid = sg-12abcdef
port = 22
[webprofile]
sgid = sg-12abcdef
port = 443
```
Raw data
{
"_id": null,
"home_page": "https://github.com/michel-slm/aws-portknock",
"name": "aws-portknock",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "aws portknock",
"author": "Michel Lind",
"author_email": "michel@michel-slm.name",
"download_url": "https://files.pythonhosted.org/packages/78/7d/ce8c331a45872c167e63d7a9a6dc5efd5b5a6f7063f281678bb4d93ec6d6/aws-portknock-0.1.2.tar.gz",
"platform": null,
"description": "# aws-portknock #\nPort knocking for AWS security groups\n\n## \"Port knocking\" ##\n\nUnlike the traditional port knocking utilities, this tool relies on\nthe caller having the rights, through Amazon Web Services' Identity\nand Access Management roles, to modify a security group.\n\n## Usage ##\n\n```\n$ aws-portknock --help\nUsage: aws-portknock [OPTIONS]\n\nOptions:\n --port INTEGER Port to open\n --profile TEXT Configuration profile to use\n --sgid TEXT Security group ID\n --help Show this message and exit.\n```\n\n`aws-portknock` will determine the caller's public IP and add a rule\nto the security group allowing access to the requested port from that\nIP. It then sleeps until the user quits by using CTRL-C.\n\nIf a matching rule already exists, nothing happens on exit; otherwise,\nthat added rule is deleted when `aws-portknock` exits.\n\nFor repeated use, create `$HOME/.aws/portknock.ini` containing, for example:\n\n```\n[default]\nsgid = sg-12abcdef\nport = 22\n\n[webprofile]\nsgid = sg-12abcdef\nport = 443\n```\n",
"bugtrack_url": null,
"license": "",
"summary": "Port knocking for AWS security groups",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/michel-slm/aws-portknock"
},
"split_keywords": [
"aws",
"portknock"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "979e6aaabd912e6059d538611fc438c9b256269bc25770c6c5fef7edb99f7cb6",
"md5": "3de025a5fffacc2a6490a7391a66d584",
"sha256": "58445bbcc4b29578804f951537e1e23c87815a18dd85c05a016a5f6656994c1a"
},
"downloads": -1,
"filename": "aws_portknock-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3de025a5fffacc2a6490a7391a66d584",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8878,
"upload_time": "2024-01-23T16:46:13",
"upload_time_iso_8601": "2024-01-23T16:46:13.683519Z",
"url": "https://files.pythonhosted.org/packages/97/9e/6aaabd912e6059d538611fc438c9b256269bc25770c6c5fef7edb99f7cb6/aws_portknock-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "787dce8c331a45872c167e63d7a9a6dc5efd5b5a6f7063f281678bb4d93ec6d6",
"md5": "aa6ef6dab952fa89ceffdc9cc71c8696",
"sha256": "fc61d141f40c9e6a1f50a55349a975f8eacd8c0d1bdb96046af972e22564b0de"
},
"downloads": -1,
"filename": "aws-portknock-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "aa6ef6dab952fa89ceffdc9cc71c8696",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 8247,
"upload_time": "2024-01-23T16:46:18",
"upload_time_iso_8601": "2024-01-23T16:46:18.266837Z",
"url": "https://files.pythonhosted.org/packages/78/7d/ce8c331a45872c167e63d7a9a6dc5efd5b5a6f7063f281678bb4d93ec6d6/aws-portknock-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-23 16:46:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "michel-slm",
"github_project": "aws-portknock",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "boto3",
"specs": [
[
"==",
"1.2.3"
]
]
},
{
"name": "botocore",
"specs": [
[
"==",
"1.3.15"
]
]
},
{
"name": "click",
"specs": [
[
"==",
"6.2"
]
]
},
{
"name": "docutils",
"specs": [
[
"==",
"0.12"
]
]
},
{
"name": "jmespath",
"specs": [
[
"==",
"0.9.0"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
"==",
"2.4.2"
]
]
},
{
"name": "six",
"specs": [
[
"==",
"1.10.0"
]
]
}
],
"lcname": "aws-portknock"
}
JSON
