Metadata-Version: 2.1
Name: dome9
Version: 0.4
Summary: Dome9 SDK for Python
Home-page: https://github.com/davidmoremad
Author: David Amrani Hernandez
Author-email: davidmorenomad@gmail.com
License: Apache 2.0
Project-URL: Documentation, https://dome9.readthedocs.io
Project-URL: Source Code, https://github.com/davidmoremad/dome9
Keywords: dome9 sdk cloudsecurity cspm
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Security
Classifier: Environment :: Console
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Natural Language :: English
Description-Content-Type: text/markdown
License-File: LICENSE

# Dome9 SDK


[![Documentation Status](https://readthedocs.org/projects/dome9/badge/?version=latest)](http://dome9.readthedocs.io/?badge=latest)
![PyPI](https://img.shields.io/pypi/v/dome9)

## Usage

```python
from dome9 import Dome9

dome9 = Dome9(key='xxxxxx', secret='yyyyyyy')

rulesets = dome9.list_rulesets()
```



## Authentication

There are two ways to authenticate Dome9SDK:
* **SDK Arguments**: Passing variables to Dome9SDK `Dome9SDK(key='xxxxxx', secret='yyyyyyy')`
* **Environment variables**: Setting your credentials to `DOME9_ACCESS_KEY` and `DOME9_SECRET_KEY` environment variables

Example: 
```bash
export DOME9_ACCESS_KEY='xxxxxxxxxxxxxxxxxxxx'
export DOME9_SECRET_KEY='yyyyyyyyyyyyyyyyyyyy'
echo -e "import dome9sdk \nprint(dome9sdk.Dome9SDK().list_cloud_accounts())" | python
```



## Agile

```python
import json
from dome9 import Dome9

cloudAccount = '00000-00000-00000-00000'

d9 = Dome9()

rulesetTemplate = {}
with open('ruleset','r') as f:
    rulesetTemplate = json.loads(f.read())

# Step 1. Create ruleset
ruleset = d9.create_ruleset(rulesetTemplate)

# Step 2. Run Assessment
results = d9.run_assessment(rulesetId=ruleset['id'], cloudAccountId=cloudAccount)

# Step 3. Delete ruleset
ruleset = d9.delete_ruleset(ruleset['id'])

```

