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:
Download and unzip locally the examples folder by clicking here.
Update authentication credentials in vars/algosec-secrets.yml.
Update your AlgoSec server IP in inventory.ini.
Update the arguments of the relevant modules in one of the playbooks (files with the yml extension).
Run ansible-playbook -i inventory.ini <playbook-filename>.yml.
You’ve made it!
Documentation
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)
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)
| File | Size | Uploaded | |
|---|---|---|---|
| ansible-role-algosec-0.6.0.tar.gz | 6.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|