Release 1.2.0 introduces a REST based public API. The API can be used to automate actions such as list, add, remove and update of Users, Endpoints, Agents, Gateways, Groups and Policy.
Pre-requisites
Your Orchestrator, Gateways, Agents and Clients must be using firmware release 1.2.0 or higher.
If you are not using firmware release 1.2.0 or higher, then you must upgrade.
Learn about how to check what version firmware you are using here and learn about how to upgrade your Orchestrator here
You must create an API key in the Orchestrator. This is explained below.
To be able to access the API documentation, you must add API access to your user account. This is explained below.
Summary
Enable API access on your User profile
Configure and create an API key
Connect to the interactive API documentation
Step 1: Enable API access on your User profile
Performed by the BlastShield Orchestrator Administrator
Login to the Orchestrator and click on the Users menu on the left hand side
The list of users will appear. Click on the User on which you want to enable API Access to be able to access the interactive API documentation.
The User information will open. In the Settings tab, check the API Access box.
Click on Save.
This user can now access the API documentation at "https://<orchestrator-fqdn>:8000/docs". For Orchestrators which are using the default hostname, then this will be "https://orchestrator.blastshield.io:8000/docs".
Step 2: Create and configure a new API key
Performed by the BlastShield Orchestrator Administrator
Add a new API key by clicking on the API Keys settings menu on the left hand side.
The API Keys menu will open. Click on the Add New API Key on the right hand side
The Edit API Key menu will open. Check the boxes according to the permissions you want to set to the API key and click Save to create the API Key.
The API key will be displayed and you must keep a copy of it before you close the window. There will be no way to view it again.
Step 3: Connect to the interactive API documentation
To be able to access the API documentation, your user account must have API Access enabled (see above). The interactive documentation for the API is available at the following url:
https://<orchestrator-fqdn>:8000/docs
For Orchestrators which are using the default hostname, this will be:
