Realm9 Logo
Search documentation...

Integrations

Realm9 currently integrates with ServiceNow for CMDB connectivity and environment request automation.

Path: /integrations

ServiceNow

The ServiceNow integration connects Realm9 to your ServiceNow instance, enabling CMDB data import during environment creation and automatic ticket creation for environment requests.

Setup

  1. Navigate to Integrations in the sidebar
  2. Click Configure on the ServiceNow card
  3. Enter the required details:
    • Instance URL — your ServiceNow instance (e.g. https://your-company.service-now.com)
    • API Token — a ServiceNow API key with access to the required tables
    • Assignment Group — default group for auto-created tickets
    • Category / Subcategory — default ticket classification
  4. Click Test Connection to verify connectivity and token validity
  5. Toggle Enable Integration to activate

The integration can be disabled at any time without losing the configuration.

Required ServiceNow Permissions

Your API token needs read access to:

  • sys_db_object — CMDB class definitions
  • sys_dictionary — field definitions
  • CI tables (e.g. cmdb_ci_server, cmdb_ci_application, and any others you want to import)

CMDB Integration

Importing CI Data During Environment Creation

When creating an environment, an optional Import from ServiceNow CMDB step lets you:

  1. Browse available CI classes (servers, applications, network devices, etc.)
  2. Search and select a specific CI record
  3. Import the CI data — it is stored with the environment for reference

Imported data appears on the environment detail page under the CMDB tab, showing CI class information, record attributes, and a link back to the ServiceNow record.

CMDB Sync

From the ServiceNow settings page, admins can:

  • Import and sync CMDB classes into Realm9
  • Mark specific CI classes or fields as sensitive — sensitive data is encrypted at rest
  • Refresh CI data on demand

Environment Request Automation

When the ServiceNow integration is configured and enabled, the environment request form shows a Create ServiceNow ticket toggle (on by default). If left on at submission, Realm9 creates a service request in ServiceNow using the configured assignment group, category, and subcategory. The resulting ticket number and direct URL are stored on the environment request record in Realm9. Users can turn the toggle off before submitting if they do not want a ticket created for a particular request.

Connection Status

The integration card shows the last-tested timestamp and connection health. Click Test Connection at any time to recheck connectivity.

Next Steps