A Python library for the Demisto API
Project description
Demisto Client for Python
A Python library for the Demisto API.
Version 2.x is compatible with Demisto server version 4.5 and later.
Note: You are viewing the demisto-py 2.x development branch. demisto-py 1.x is officially deprecated (maintenance-mode only) and can be obtained at: https://github.com/demisto/demisto-py/releases.
Demisto for Python Usage
This section covers the steps you need to take to get the client configured.
1. Get a Demisto API Key
Follow these instructions to generate your Demisto API Key.
- In Demisto, navigate to Settings > API Keys.
- Click the Generate Your Key button.
2. Create a Demisto client instance with the api-key and server-url:
import demisto_client
# Also possible to set env variables: DEMISTO_API_KEY and DEMISTO_BASE_URL
api_key = 'YOUR_API_KEY'
host = 'https://YOUR_DEMISTO_HOST'
api_instance = demisto_client.configure(base_url=host, api_key=api_key)
Alternatively, you can login with username and password:
import demisto_client
host = 'https://YOUR_DEMISTO_HOST'
username = 'YOUR_USERNAME'
password = 'YOUR_PASSWORD'
api_instance = demisto_client.configure(base_url=host, username=username, password=password)
3. Create incidents
import demisto_client.demisto_api
from demisto_client.demisto_api.rest import ApiException
api_key = 'YOUR_API_KEY'
host = 'https://YOUR_DEMISTO_HOST'
api_instance = demisto_client.configure(base_url=host, api_key=api_key, debug=False)
create_incident_request = demisto_client.demisto_api.CreateIncidentRequest()
create_incident_request.name = 'Sample Simulation Incident'
create_incident_request.type = 'Simulation'
create_incident_request.owner = 'Admin'
try:
api_response = api_instance.create_incident(create_incident_request=create_incident_request)
print(api_response)
except ApiException as e:
print("Exception when calling DefaultApi->create_incident: %s\n" % e)
API Documentation
API Documentation based upon the Demisto Server Swagger API is available here
Dev Environment Setup
We build for both python 2 and 3. We recommend installing both development environments. You can use pyenv to manage multiple python versions (see: https://github.com/pyenv/pyenv). We use tox for managing environments and running unit tests.
Install tox
:
pip install tox
List configured environments:
tox -l
Then setup dev virtual envs for both python 2 and 3 (will also install all necessary requirements):
tox --devenv venv2 --devenv py27
tox --devenv venv3 --devenv py37
Activate python 2 env by running:
. venv2/bin/activate
Switch to python 3 env by running:
. venv3/bin/activate
Running Unit Tests
We use pytest to run unit tests. Inside a virtual env you can run unit test using:
python -m pytest -v
Additionally, our build uses tox to run on multiple envs. To use tox to run on all supported environments (py27, py36, py37), run:
tox -q
To run on a specific environment, you can use:
tox -q -e py27
Code Generation
Library code was generated using the Demisto Server 4.5.0 Swagger definition. We use a script to generate the code and then modify as needed. If you would like to contribute don't modify the generated code directly, modify the script. To generate the code run (requires bash, sed and docker):
./gen-code.sh
License
Apache 2.0 - See LICENSE for more information.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for demisto_py-2.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c55e7ca4ebdece0f98b16245943aec2f8738eba131c54920267c72c895076a23 |
|
MD5 | 869273daa6de5c06d2b994d1c5bb0077 |
|
BLAKE2b-256 | d1a26b6e04f79bef13d629e97de1a61900821b0b9f6675c176dff5a6bc82b6d7 |