Requirements

• Python (tested on Python 2.7 and Python 3.6.5)

• Requests

Installation:

sudo pip install edm-client

Source code is available on GitHub.

Generating an API Token From Edge Defense Manager

Access to the Edge Defense Manager API requires an API token for authentication. You generate the token in the EDM command line interface (CLI).

The API token is associated with the user account under which it is generated. Any user can generate an EDM API token, except for the root user.

To generate an EDM API token:

1. Establish an SSH connection to EDM.

2. Log in to the operating system CLI with your EDM credentials.

3. To create the token, enter edm_apitoken_gen.

   The system responds with the new API token, for example:

   { "admin": "LMttPZ45FXnJT6IokVh6Px-otiKGDMkUdyQmJMWmWGz" }

4. For later use, copy the token and then paste it to a text file.

5. To log out of the CLI, enter exit

To View or delete a token, use one of the following commands.

• edm_apitoken_show

• edm_apitoken_delete

Using the Client

Import the package:

from edmclient.edm import EdgeDefenseManager
dev = EdgeDefenseManager(<host>, <apitoken>, api_version=<api_version, eg. 'v1'>, raise_on_error=<True|False>)

dev.devices.add(host='aed_1.example.com',
                apiToken='WWPi7_',
                name='AED_1')

dev.devices.show()
dev.devices.show(id=1)

dev.devices.remove(id=1)

dev.devices.update(id=1,
                   host='aed_1.example.com',
                   apiToken='WWPi7_',
                   name='AED_1')

dev.devices.update(id=1, name='NEW_AED_1')
dev.devices.update(id=1, apiToken='sdf79_kjI')

dev.alerts.threats.show(start='2018-09-08T00:00:00Z')

dev.alerts.ddos.show(start='2018-09-08T00:00:00Z')

dev.alerts.ddos.count.show(start='2018-09-08T00:00:00Z')

dev.traffic.edge.show(start='2018-09-08T00:00:00Z')

dev.cti.insights.show(indicatorValue='1.2.3.4')

dev.configuration.cti.show()

dev.configuration.cti.update(cti_token='ajfdgFJGFGmh27hnbv')

Running Unit Tests

If nose is not installed, then run:

pip3 install nose

Run the following command from the package directory:

nosetests