- 15 May 2022
- 1 Minute to read
-
Print
-
DarkLight
-
PDF
Axonius REST API
- Updated on 15 May 2022
- 1 Minute to read
-
Print
-
DarkLight
-
PDF
Axonius provides a RESTful API service that allows you to query assets that have been discovered and correlated by Axonius.
To use the REST API, you must have the following:
- API Key: either a user name and password, or an API key and API secret.
- API Access permission: The user's role used to access the API requires that the API Access permission will be enabled.
Creating a Service Account
You can also create Service Accounts to manage accounts that will only connect to the system using the API. Refer to Manage Service Accounts
Get an API Key
Using the Axonius REST API to query Axonius assets requires a user name and password, or an API key and API secret.
To get an API Key and an API Secret do as follows:
-
Open your user Account Settings.
From the left navigation panel, under your account avatar and user name, click the settingsicon.
-
Select the API Key tab. Copy the existing API key and secret. To reset them, click Reset Key.
Enable API Access Permission
Using the Axonius REST API to query Axonius assets requires a that the user's role will have the API Access enabled permission enabled.
To set this permission:
- Open the Manage Roles page.
From the top right corner of all pages, click. The System Settings page opens. Then, click the Manage Roles tab.
-
Select the relevant role as described in Manage Roles. For the selected role, under the API Access category, select the API access enabled checkbox.
-
Click Save.