Skip to main content

IP Liberator

https://img.shields.io/pypi/v/ip-liberator.svg https://img.shields.io/travis/wagnerluis1982/ip-liberator.svg Documentation Status

A command line utility to update AWS Security Groups rules.

Features

  • Update a list of security groups of your AWS account at once.

  • Grant access to informed ports for your current IP address or an informed IP.

  • Read profile files in JSON with all the information needed to contact.

  • Fit for use as script (e.g. to update your dynamic IP regularly).

Installation

$ pip install ip-liberator

Quickstart

Consider a file /path/my-profile.json with the following content:

{
  "credentials": {
    "access_key": "<AWS_ACCESS_KEY>",
    "secret_key": "<AWS_SECRET_KEY>",
    "region_name": "<AWS REGION>"
  },
  "config": {
    "operator": "John",
    "services": [
      {
        "name": "FTP+SFTP",
        "port": "21-22"
      },
      {
        "name": "HTTPS",
        "port": "443"
      }
    ],
    "security_groups": [
      "sg-<GROUP_ID_1>",
      "sg-<GROUP_ID_2>"
    ]
  }
}

Using the profile defined above will create or update two entries in the informed security groups:

  • John FTP+SFTP granting access for the current IP the ports 21 and 22.

  • John HTTPS granting access for the current IP the port 443.

To accomplish it, simply run:

$ ip-liberator --profile /path/my-profile.json
Authorizing rules ['John FTP+SSH', 'John HTTPS'] to IP 192.30.253.112/32
- sg-<GROUP_ID_1>
- sg-<GROUP_ID_2>

Credits

Authors

Release files for ip-liberator 0.2.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ip-liberator 0.2.4
File Size Uploaded
ip-liberator-0.2.4.tar.gz 15.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ip-liberator 0.2.4
File Interpreter ABI Platform
ip_liberator-0.2.4-py3-none-any.whl Python 3 none any Details

Total release size: 33.4 kB

Release files / ip-liberator-0.2.4.tar.gz

Download URL ip-liberator-0.2.4.tar.gz
Size 15.0 kB
Tags Source
SHA-256 checksum
How to use checksums
e87d21c1ec95765a62c4aafc8525702ce281c805181f1890ab698daea19ea746
BLAKE2b-256 checksum
How to use checksums
28a0ea8e23132b2a52a9ca3e39563509e8624595f68cf89415693fcd82c6853b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.0.0b1 CPython/3.7.3 Linux/4.15.0-65-generic

Release files / ip_liberator-0.2.4-py3-none-any.whl

Download URL ip_liberator-0.2.4-py3-none-any.whl
Size 18.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b0f1c6438201dec59fd15287ea6b65d405e22c9309911a1746ce12722fb95205
BLAKE2b-256 checksum
How to use checksums
43f596808c28ce78a455b1d8298364d2cdac09dd3fb38ae696b6fd793f4bf3e3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.0.0b1 CPython/3.7.3 Linux/4.15.0-65-generic

Release history Release notifications | RSS feed

This release

0.2.4 This release

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page