Skip to main content

Command line client for DETERRERS

Project description

Command line client for DETERRERS

A command line client making it easy to interact with the DETERRERS perimeter firewall portal to registr and configuration IP addresses and firewall profiles.

Warning: The API of DETERRERS used by this tool is still experimental and somewhat fragile. Most notably, this often leads to unexpected errors returned by the API.

Installation

Use pip to install the latest version:

pip install deterrers-cli

Configuration

To configure the client, create a file ~/.deterrers.yml with the following content:

url: https://deterrers.example.com
token: <api-token>

Usane

Use the context based help to get information about available commands:

❯ deterrers-cli --help
Usage: python -m deterrerscli [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  action  Activate firewall profile or block IP address in perimeter...
  add     Add IP address to DETERRERS.
  delete  Delete IP address from DETERRERS.
  get     Get information about an IP address in DETERRERS.
  hosts   List all IPs added to DETERRERS.
  update  Update IP address in DETERRERS.

Help about adding new IP addresses:

❯ deterrers-cli add --help
Usage: python -m deterrerscli add [OPTIONS] IPV4

  Add IP address to DETERRERS.

Options:
  -a, --admin TEXT  [required]
  --help            Show this message and exit.

Example

# Delete IP 192.0.0.1 from DETERRERS deterrers-cli delete 192.0.0.1

# Add IP 192.0.0.1 with group `virtUOS` as admins deterrers-cli add --admin virtUOS 192.0.0.1

# Set firewall profile `SSH` deterrers-cli update --profile ssh 192.0.0.1

# Activate firewall profile deterrers-cli action register 192.0.0.1

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deterrers-cli-0.2.tar.gz (3.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page