• A runZero superuser account to access Custom Integrations.

• Access to the Device42 REST API at the /api/1.0/devices/all/ endpoint.
• Either:
  • A valid Device42 username and password, or
  • A valid Bearer token.

Device42 supports Basic or Bearer authentication.

You must configure both fields in your runZero credential:

• access_key: must be either basic or bearer.
• access_secret:
  • For basic: a base64-encoded string of username:password.
  • For bearer: your raw API token.

echo -n 'myuser:mypassword' | base64

Use the output as your access_secret. Set access_key to basic.

Set access_key to bearer, and access_secret to your API token string.

• Go to runZero Credentials.
• Select the type: Custom Integration Script Secrets.
• Set:
  • access_key: basic or bearer
  • access_secret: base64-encoded username:password or API token

• Navigate to Custom Integrations.
• Name your integration (e.g. device42).
• Paste the finalized script into the code editor.
• Click Validate, then Save.

• Go to Ingest Task.
• Select the Credential and Custom Integration you created.
• Choose the runZero Explorer where it will run.
• Set your schedule and click Save.

• Your Device42 instance must be reachable from the runZero Explorer.
• API pagination is handled automatically using limit and offset.
• Assets will be enriched with all available fields (except IP/MAC/name) in customAttributes.

To find assets imported by this integration:

custom_integration:device42