Skip to main content

Documentation Status travis coverage

Ansible role to DevOps-ify network security management, leveraging AlgoSec’s business-driven security policy management solution

Documentation available online at: http://algosec-ansible-role.readthedocs.io/en/latest/

Requirements

  • This module is supported and fully tested under python2.7 and python3.6.

  • All modules of this role require environment:

    pip install algosec --upgrade
    pip install ansible marshmallow urllib3

Installation

The Ansible role can be installed directly from Ansible Galaxy by running:

ansible-galaxy install algosec.algosec

If the ansible-galaxy command-line tool is not available (usually shipped with Ansible), or you prefer to download the role package directly, navigate to the Ansible Galaxy role page and hit “Download”.

Alternately, you can directly navigate to our GitHub repository.

Usage

Once installed, you can start using the modules included in this role in your ansible playbooks.

To quickly get up and running a simple example you can follow these steps:

  1. Download and unzip locally the examples folder by clicking here.

  2. Update authentication credentials in vars/algosec-secrets.yml.

  3. Update your AlgoSec server IP in inventory.ini.

  4. Update the arguments of the relevant modules in one of the playbooks (files with the yml extension).

  5. Run ansible-playbook -i inventory.ini <playbook-filename>.yml.

  6. You’ve made it!

Documentation

Documentation Status

Documentation available online at: https://algosec-ansible-role.readthedocs.io/en/latest/

How to build doc’s locally?

Using Docker, running from one folder outside of the project:

$ docker run -it -v $PWD/ansible-role-algosec/:/documents/ ivanbojer/spinx-with-rtd
$ cd docs
$ make html

Using Spinx:

$ cd docs
$ make html

Then see the docs/_build folder created for the html files.

License

MIT (see full license here)

Author Information

AlgoSec Official Website https://www.algosec.com/

Development

To kickoff local development, just use pipenv:

pipenv install

And to use the newly installed virtual environment just run:

pipenv shell

Metadata

Release files for ansible-role-algosec 0.6.0

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

Source distribution (sdist)

Source distribution for ansible-role-algosec 0.6.0
File Size Uploaded
ansible-role-algosec-0.6.0.tar.gz 6.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ansible-role-algosec 0.6.0
File Interpreter ABI Platform
ansible_role_algosec-0.6.0-py3-none-any.whl Python 3 none any Details

Total release size: 16.2 kB

Release files / ansible-role-algosec-0.6.0.tar.gz

Download URL ansible-role-algosec-0.6.0.tar.gz
Size 6.8 kB
Tags Source
SHA-256 checksum
How to use checksums
b322da97bf9a55d04d1a9ab5cd691023b73f0e9126b086022a645d4b59a789c1
BLAKE2b-256 checksum
How to use checksums
573763f54e638533cbce19e429cf4eeb6053f585d02767779f9764da9f471f11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.29.1 CPython/3.6.3

Release files / ansible_role_algosec-0.6.0-py3-none-any.whl

Download URL ansible_role_algosec-0.6.0-py3-none-any.whl
Size 9.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0e8825fe019542c2fa4eef21be4df6cc2c0c4558c050ad448d2f0dd9ec3be7be
BLAKE2b-256 checksum
How to use checksums
56ae751c8883ccadd025b39ea4d8e7ba75ca6c011282c8e653bd731868ef660c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.29.1 CPython/3.6.3

Release history Release notifications | RSS feed

This release

0.6.0 This release

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