-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Yochai Blumenfeld
committed
Mar 27, 2017
1 parent
51af829
commit 6af947b
Showing
26 changed files
with
2,235 additions
and
1,172 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,10 +1,14 @@ | ||
*.pyc | ||
*.exe | ||
*.zip | ||
*.msi | ||
.idea | ||
*.swp | ||
mazerunner_sdk_venv | ||
build | ||
mazerunner_sdk.egg-info/ | ||
dist | ||
.coverage | ||
.cache | ||
sdk-venv | ||
htmlcov | ||
test_deployments |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1,40 @@ | ||
See documentation [here](https://community.cymmetria.com/api) | ||
# MazeRunner Python SDK | ||
|
||
|
||
This library implements a convenient client for MazeRunner API for python. | ||
|
||
Using this library, you'll be able to easily configure and manipulate | ||
|
||
the key features of MazeRunner, such as creation of a deception campaign, turning | ||
|
||
decoys on or off, deployment on remote endpoints, and inspect alerts with their | ||
|
||
attached evidence. | ||
|
||
For a quick start, it's recommended to perform the easy steps in the installation section, and | ||
|
||
continue to trying some of the usage examples in the mazerunner/samples folder. | ||
|
||
###Run tests: | ||
`py.test -vvv --json_credentials=my_keys.json --lab_dependent --cov=mazerunner.api_client --cov-report html` | ||
|
||
Structure of the json_credentials file: | ||
~~~~ | ||
{ | ||
"ip_address": "mazerunner.host.or.ip", | ||
"id": "mazerunner_api_key", | ||
"secret": "mazerunner_api_secret", | ||
"mazerunner_certificate_path": "MazeRunner.crt", | ||
"endpoint_ip": "endpoint.host.or.ip", | ||
"endpoint_username": "ep_username", | ||
"endpoint_password": "ep_password" | ||
} | ||
~~~~ | ||
|
||
###Generate documentation files: | ||
~~~~ | ||
export PYTHONPATH=`pwd` | ||
make html | ||
~~~~ | ||
|
||
###See documentation at [https://community.cymmetria.com/api](https://community.cymmetria.com/api) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,6 @@ | ||
def pytest_addoption(parser): | ||
parser.addoption("--ip_address", action="store", default=None, help="IP Address of MazeRunner") | ||
parser.addoption("--json_credentials", action="store", default=None, help="Json file with the relevant credentials") | ||
parser.addoption("--json_credentials", action="store", default=None, | ||
help="Json file with the relevant credentials") | ||
parser.addoption("--runslow", action="store_true", default=False, help="Run slow tests") | ||
parser.addoption("--lab_dependent", action="store_true", default=False, | ||
help="Run tests that depend on the lab resources") |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,10 +1,9 @@ | ||
from mazerunner import api_client | ||
|
||
|
||
def connect(ip_address, api_key, api_secret, certificate, use_http=False): | ||
def connect(ip_address, api_key, api_secret, certificate): | ||
"""Establish a connection to the MazeRunner server""" | ||
return api_client.APIClient(ip_address, | ||
api_key, | ||
api_secret, | ||
certificate, | ||
use_http=use_http) | ||
certificate) |
Oops, something went wrong.