- 01 Feb 2023
- 1 Minute to read
- DarkLight
Axonius
- Updated on 01 Feb 2023
- 1 Minute to read
- DarkLight
Use the Axonius integration in Torq to ingest Axonius events and manage assets as part of your automated security workflows.
Trigger workflows with Axonius events
To ingest Axonius events in Torq, you need to create an Axonius trigger integration and use the generated webhook URL (Torq endpoint) to configure a Webhook integration in Axonius.
Create an Axonius trigger integration
Perform these steps in Torq.
- Go to Integrations > Triggers.
- Locate Orca and click Add.
- Type a meaningful name for the integration instance and click Add.
- (Optional) Add an authentication header. Make sure you use the same authentication header names and values as they are in Axonius. Axonius supports the following headers:
- user name
- password
Create a send to Webhook action in Axonius
See the Axonus documentation for instructions on how to create this action.
Create a test workflow
You'll create the workflow in Torq. The purpose of the test workflow is to confirm that events from Axonius are being sent to the webhook URL successfully.
- Go to Workflows and click Create Workflow.
- Type a meaningful name for the workflow, such as Axonius Events Test.
- Click the trigger icon and select Axonius.
Use Axonius steps in a workflow
To use Axonius steps in Torq workflows, you have to create an Axonius steps integration, which requires an Axonius API key and secret.
Create an Axonius API key and secret
See the Axonius documentation for instructions on how to create an API key and secret.
Create an Axonius steps integration in Torq
Perform these steps in Torq. You'll need the API key and secret you created previously.
- Go to Integrations > Steps.
- Locate Axonius and click Add.
- Type a meaningful name for the integration instance.
- Enter the API key and secret that you generated in your Axonius tenant.
- Click Add.
Use steps in a workflow
Axonius steps have several required input parameters and more optional input parameters. To view the optional parameters, click the gear icon in the step configuration window.
- BASE URL: the URL for your Axonius tenant.
- FIELDS: the fields to include in returned assets. If no fields are supplied, only minimal information is returned for the assets.
- FILTERS: a filter that you build using Query Wizard that's used when counting assets.
- INTEGRATION: the steps integration to use to execute the step, for example, axonius-steps .
Premade steps
- Get devices
- Get users