- Superuser access to the Custom Integrations configuration in runZero.
- Valid Endpoint Central URL (
EC_HOST) for your account. - API Version (e.g.,
1.4, default is 1.4). - Endpoint Central API token (
access_secret) with permissions to access inventory data.
-
Set up your Endpoint Central API:
- Obtain your API token from the Endpoint Central admin console.
- Confirm your Endpoint Central URL (e.g.,
https://your-endpoint-central.com). - Ensure the API version is set correctly (default is
1.4).
-
Test your credentials:
- Use a tool like Postman or curl to confirm you can reach the Endpoint Central API.
- Example request:
curl -X GET "https://your-endpoint-central.com/api/1.4/inventory/scancomputers?format=json&pagelimit=1&page=1" \ -H "Authorization: Bearer <your_auth_token>" \ -H "Accept: application/json"
- You should receive a 200 response with a list of devices if your credentials are correct.
-
(OPTIONAL) - Make any necessary changes to the script to align with your environment.
- Modify API calls as needed to filter device data.
- Adjust the custom attributes as needed for your specific use case.
-
Create the Credential for the Custom Integration.
- Select the type
Custom Integration Script Secrets. - Use the
access_keyfield for your Endpoint Central URL. - Use the
access_secretfield for your API token.
- Select the type
-
Create the Custom Integration.
- Add a Name and Icon for the integration (e.g., "endpoint-central").
- Toggle
Enable custom integration scriptto input the finalized script. - Click
Validateto ensure it has valid syntax. - Click
Saveto create the Custom Integration.
-
Create the Custom Integration task.
- Select the Credential and Custom Integration created in steps 2 and 3.
- Update the task schedule to recur at the desired timeframes.
- Select the Explorer you'd like the Custom Integration to run from.
- Click
Saveto kick off the first task.
- You will see the task kick off on the tasks page like any other integration.
- The task will update existing assets with data pulled from the custom integration source.
- The task will create new assets for when there are no existing assets that meet merge criteria (hostname, MAC, etc).
- You can search for assets enriched by this custom integration with the runZero search
custom_integration:endpoint-central.