Integrations Guide

How to set up Alloy Navigator Sync

This guide shows you how to prepare AlloyScan so an Alloy Navigator instance can import AlloyScan inventory through the AlloyScan Sync job.

The sync job runs on the Alloy Navigator side. The AlloyScan-side preparation is the App registration that the sync job uses to authenticate.

Note: Details may vary by deployment.

Prerequisites

  • You sign in with the Administrator role on the AlloyScan site whose inventory will be imported.
  • The Alloy Navigator instance is deployed and has the Alloy Navigator Sync business logic enabled.
  • The Alloy Navigator host has network connectivity to the AlloyScan API endpoint.

Steps

  1. Sign in to AlloyScan and switch to the site whose inventory you want to expose to Alloy Navigator.

  2. Navigate to Admin Center > Site Settings > IAM > App registrations.

  3. Create a new App registration for the sync. See Register an API client for the field-by-field flow.

    • Name — choose a value that identifies this as the Alloy Navigator Sync client.
    • Expiration date — set far enough in the future that the registration will not lapse between maintenance windows.
    • Enabled — on.
    • Copy the issued Client ID and Client secret.

    Important: The Client secret is shown only once. Store it securely before leaving the form.

  4. On the Alloy Navigator side, configure the AlloyScan Sync job with:

    • The AlloyScan API endpoint for this site.
    • The Client ID and Client secret you just copied.

  5. If you want to limit which software is imported into Alloy Navigator, configure the per-group Track software from this groups in Alloy Navigator toggle in the Classify software into groups modal on the Software page. See Choose which Software groups are imported into Alloy Navigator.

  6. Run the sync from the Alloy Navigator side and observe the first import.

Verify

  • The Alloy Navigator side reports a successful sync run.
  • AlloyScan device counts and the Alloy Navigator Discovered Installations count match (subject to the import filter).
  • The AlloyScan Security log does not show Service authentication failed events for the sync registration.