cookbook 'algosec', '= 1.0.0'
algosec (7) Versions 1.0.0 Follow1
Leverage AlgoSec's business-driven security policy management solution.
cookbook 'algosec', '= 1.0.0', :supermarket
knife supermarket install algosec
knife supermarket download algosec
AlgoSec Chef Cookbook
Chef Cookbook to DevOps-ify network security management, leveraging AlgoSec's business-driven security policy management solution.
Maintaining compatibility between applications and their network connectivity requirements can be a challenging task for many organizations. This Cookbook together with AlgoSec's solution and Chef automation infrastructure will make it as easy as committing a simple json
file for each application. DevOps made simple...Engineers love it!
SCOPE
This cookbook is concerned with all AlgoSec services:
- AlgoSec BusinessFlow
- AlgoSec FireFlow
- AlgoSec Firewall Analyzer
Requirements
- Chef 12.7+
- AlgoSec Ruby SDK >= 0.1.0 (automatically installed upon first execution)
Usage
This cookbook is not intended to include any recipes.
Use it by specifying a dependency on this cookbook in your own cookbook.
Please see the [Examples README](examples/README.md) for a thorough explanation of how to use this package.
The README file will walk you through all the steps from installing Chef and its dependencies, to running a live example.
# my_cookbook/metadata.rb depends 'algosec' algosec = { host: 'local.algosec.com', user: 'admin', password: 'algosec123' } # Example: Define the application flows for application 'testApp' # This will delete/modify/create flows as needed to match this flows definition on the server algosec_application_flows 'define new application flows' do algosec_options algosec application_name 'testApp' application_flows( 'flow1' => { 'sources' => ['HR Payroll server', '192.168.0.0/16'], 'destinations' => ['16.47.71.62'], 'services' => ['HTTPS'], }, 'flow2' => { 'sources' => ['10.0.0.1'], 'destinations' => ['10.0.0.2'], 'services' => ['udp/501'], }, 'flow3' => { 'sources' => ['1.2.3.4'], 'destinations' => ['3.4.5.6'], 'services' => ['SSH'], } ) action :define end
Testing
For more details look at the [TESTING.md](./TESTING.md).
All static code tests are simply run by:
bundle exec rake
To actually test the code, please refer to the examples/README.md
file and apply against a
TEST app in your AlgoSec Demo VM machine.
Custom Resources
Currently, the AlgoSec Chef Cookbook include only one custom resource which is highly useful: The algosec_application_flows
.
algosec_application_flows
This custom resource is used to define a set of application flows for a given application on AlgoSec BusinessFlow.
The resource will delete/modify/create flows as needed to make the list of application flows on the server match the exact request made by the Chef cookbook (defined by you).
Common Use Cases
- A team of engineers in your company are developing an application that is frequently deployed within the network. With some of the changes, new requirements for network connectivity are presented.
Leveraging AlgoSec BusinessFlow and Chef using the
algosec_application_flows
, all they need to do is ship aflows.json
file along with their code. This file will be loaded onto AlgoSec BusinessFlow by Chef and AlgoSec solution would deploy it to the network.
Examples
To see an example of how to use this custom resource you can choose from a few options based on your level of familiarity with AlgoSec Chef Cookbook and Chef in general:
* See the Usage section in this README file for a short example.
* See the [Examples README.md](examples/README.md) for a full step-by-step guide that will show you how to use this resource.
License & Authors
If you would like to see the detailed LICENCE click [here](./LICENSE).
- Author:: AlgoSec dev@algosec.com
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
1.0.0 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
1.0.0 passed this metric
Foodcritic Metric
1.0.0 passed this metric
No Binaries Metric
1.0.0 failed this metric
Failure: Cookbook should not contain binaries. Found:
algosec/dist/algosec-0.6.1.tar.gz
algosec/dist/algosec-0.7.0.tar.gz
algosec/dist/algosec-0.6.0.tar.gz
algosec/docs/_build/doctrees/support.doctree
algosec/docs/_build/doctrees/index.doctree
algosec/docs/_build/doctrees/readme.doctree
algosec/docs/_build/doctrees/api_clients.doctree
algosec/docs/_build/doctrees/environment.pickle
algosec/docs/_build/doctrees/license.doctree
algosec/docs/_build/html/_static/minus.png
algosec/docs/_build/html/_static/down-pressed.png
algosec/docs/_build/html/_static/fonts/RobotoSlab-Bold.ttf
algosec/docs/_build/html/_static/fonts/Inconsolata-Bold.ttf
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.woff
algosec/docs/_build/html/_static/fonts/RobotoSlab-Regular.ttf
algosec/docs/_build/html/_static/fonts/Lato-Bold.ttf
algosec/docs/_build/html/_static/fonts/Lato-Regular.ttf
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.eot
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.svg
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.ttf
algosec/docs/_build/html/_static/fonts/Inconsolata-Regular.ttf
algosec/docs/_build/html/_static/comment-close.png
algosec/docs/_build/html/_static/file.png
algosec/docs/_build/html/_static/up-pressed.png
algosec/docs/_build/html/_static/plus.png
algosec/docs/_build/html/_static/down.png
algosec/docs/_build/html/_static/comment-bright.png
algosec/docs/_build/html/_static/comment.png
algosec/docs/_build/html/_static/up.png
algosec/docs/_build/html/_static/ajax-loader.gif
algosec/docs/_build/html/objects.inv
algosec/algosec/tests/__init__.pyc
algosec/algosec/tests/test_flow_comparison_logic.pyc
algosec/algosec/models.pyc
algosec/algosec/__init__.pyc
algosec/algosec/api_client.pyc
algosec/algosec/helpers.pyc
algosec/algosec/errors.pyc
algosec/algosec/flow_comparison_logic.pyc
algosec/algosec.egg-info/dependency_links.txt
Testing File Metric
1.0.0 passed this metric
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 failed this metric
1.0.0 passed this metric
Foodcritic Metric
1.0.0 passed this metric
No Binaries Metric
1.0.0 failed this metric
Failure: Cookbook should not contain binaries. Found:
algosec/dist/algosec-0.6.1.tar.gz
algosec/dist/algosec-0.7.0.tar.gz
algosec/dist/algosec-0.6.0.tar.gz
algosec/docs/_build/doctrees/support.doctree
algosec/docs/_build/doctrees/index.doctree
algosec/docs/_build/doctrees/readme.doctree
algosec/docs/_build/doctrees/api_clients.doctree
algosec/docs/_build/doctrees/environment.pickle
algosec/docs/_build/doctrees/license.doctree
algosec/docs/_build/html/_static/minus.png
algosec/docs/_build/html/_static/down-pressed.png
algosec/docs/_build/html/_static/fonts/RobotoSlab-Bold.ttf
algosec/docs/_build/html/_static/fonts/Inconsolata-Bold.ttf
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.woff
algosec/docs/_build/html/_static/fonts/RobotoSlab-Regular.ttf
algosec/docs/_build/html/_static/fonts/Lato-Bold.ttf
algosec/docs/_build/html/_static/fonts/Lato-Regular.ttf
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.eot
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.svg
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.ttf
algosec/docs/_build/html/_static/fonts/Inconsolata-Regular.ttf
algosec/docs/_build/html/_static/comment-close.png
algosec/docs/_build/html/_static/file.png
algosec/docs/_build/html/_static/up-pressed.png
algosec/docs/_build/html/_static/plus.png
algosec/docs/_build/html/_static/down.png
algosec/docs/_build/html/_static/comment-bright.png
algosec/docs/_build/html/_static/comment.png
algosec/docs/_build/html/_static/up.png
algosec/docs/_build/html/_static/ajax-loader.gif
algosec/docs/_build/html/objects.inv
algosec/algosec/tests/__init__.pyc
algosec/algosec/tests/test_flow_comparison_logic.pyc
algosec/algosec/models.pyc
algosec/algosec/__init__.pyc
algosec/algosec/api_client.pyc
algosec/algosec/helpers.pyc
algosec/algosec/errors.pyc
algosec/algosec/flow_comparison_logic.pyc
algosec/algosec.egg-info/dependency_links.txt
Testing File Metric
1.0.0 passed this metric
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 passed this metric
1.0.0 failed this metric
Failure: Cookbook should not contain binaries. Found:
algosec/dist/algosec-0.6.1.tar.gz
algosec/dist/algosec-0.7.0.tar.gz
algosec/dist/algosec-0.6.0.tar.gz
algosec/docs/_build/doctrees/support.doctree
algosec/docs/_build/doctrees/index.doctree
algosec/docs/_build/doctrees/readme.doctree
algosec/docs/_build/doctrees/api_clients.doctree
algosec/docs/_build/doctrees/environment.pickle
algosec/docs/_build/doctrees/license.doctree
algosec/docs/_build/html/_static/minus.png
algosec/docs/_build/html/_static/down-pressed.png
algosec/docs/_build/html/_static/fonts/RobotoSlab-Bold.ttf
algosec/docs/_build/html/_static/fonts/Inconsolata-Bold.ttf
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.woff
algosec/docs/_build/html/_static/fonts/RobotoSlab-Regular.ttf
algosec/docs/_build/html/_static/fonts/Lato-Bold.ttf
algosec/docs/_build/html/_static/fonts/Lato-Regular.ttf
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.eot
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.svg
algosec/docs/_build/html/_static/fonts/fontawesome-webfont.ttf
algosec/docs/_build/html/_static/fonts/Inconsolata-Regular.ttf
algosec/docs/_build/html/_static/comment-close.png
algosec/docs/_build/html/_static/file.png
algosec/docs/_build/html/_static/up-pressed.png
algosec/docs/_build/html/_static/plus.png
algosec/docs/_build/html/_static/down.png
algosec/docs/_build/html/_static/comment-bright.png
algosec/docs/_build/html/_static/comment.png
algosec/docs/_build/html/_static/up.png
algosec/docs/_build/html/_static/ajax-loader.gif
algosec/docs/_build/html/objects.inv
algosec/algosec/tests/__init__.pyc
algosec/algosec/tests/test_flow_comparison_logic.pyc
algosec/algosec/models.pyc
algosec/algosec/__init__.pyc
algosec/algosec/api_client.pyc
algosec/algosec/helpers.pyc
algosec/algosec/errors.pyc
algosec/algosec/flow_comparison_logic.pyc
algosec/algosec.egg-info/dependency_links.txt
Testing File Metric
1.0.0 passed this metric
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 passed this metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number