Skip to Content

ITGlue

The ITGlue integration synchronizes device documentation between SonicSaaS and your ITGlue instance. This keeps your documentation platform up to date with the latest device configurations, network details, and compliance data.

What It Provides

  • Pull sync — import device and organization data from ITGlue into SonicSaaS
  • Push sync — write device documentation, configuration details, and compliance data back to ITGlue
  • Bidirectional sync — keep both platforms in sync with scheduled synchronization

Setup

To configure the ITGlue integration:

  1. Navigate to Integrations → ITGlue
  2. Enter your ITGlue API key (generated from ITGlue’s admin panel)
  3. Configure sync direction (pull, push, or bidirectional)
  4. Map ITGlue organizations to SonicSaaS organizations
  5. Save and run an initial sync

Your ITGlue API key is encrypted at rest using AES-256-GCM.

What Gets Synced

From ITGlue to SonicSaaS (Pull)

  • Organization names and metadata
  • Device records (for discovery and import)

From SonicSaaS to ITGlue (Push)

  • Device documentation (model, serial, firmware, configuration details)
  • Network information (interfaces, IP addresses, VPN tunnels)
  • Compliance and security status

Sync-Back

“Sync-back” is the continuous write path from SonicSaaS into ITGlue. Whenever SonicSaaS polls a device and collects updated data, relevant fields are written back to the matching ITGlue asset so your documentation stays current automatically.

What writes back

  • Device traits (model, serial, firmware, hostname, management address)
  • Network details (interfaces, IP assignments, VPN tunnel summaries)
  • Compliance and policy status flags

When it runs

  • After every successful device poll — no separate schedule to configure
  • On demand from the ITGlue integration page

Conflict handling

Sync-back uses SonicSaaS as the source of truth for managed fields. If someone edits a synced field directly in ITGlue between sync runs, the SonicSaaS value overwrites it on the next write. Fields that SonicSaaS does not manage are left untouched, so your free-form notes, runbooks, and attachments are preserved.

If you want a field to stay ITGlue-authoritative, unmap it in the ITGlue integration settings.

Sync Schedule

Pull and full-push synchronization can be run on demand or on an automated schedule. Sync-back runs opportunistically with every poll. The platform tracks sync status and alerts you to any failures.

Last updated on