Configure Scan Engine instance integration settings

  • Release version: Zurich
  • Updated November 19, 2025
  • 1 minute to read

    • You can view and configure a variety of information, formatted into lists, that the Scan Engine uses to implement its various scanning types.

    Role required: Scan Engine admin and Impact admin.

    System properties

    These are the properties specifically created by the Scan Engine application upon installation. Modification of these properties is performed using standard procedures in ServiceNow.

    My SN Instances

    Each record indicates an instance connected to the current instance through API integrations.

    Note:
    You must configure this to take advantage of exception processing, definition syncing, and user story tracking in Production.
    1. To add an instance to the list, select New.
    2. Configure the following fields and settings.
      Field/Setting Description
      Instance Name The name of the instance.
      Instance URL The URL of the instance.
      Environment

      The instance environment:

      • Development
      • Production
      • Test
      Important:
      Only one instance can be listed as Production. Otherwise, the integration will fail.
      Validated
      • Indicates whether the instance has been successfully validated using the UI Action provided in the configuration interface.
      • You can use the Validate Connection action available on the instance configuration form to attempt a live connection to the target instance using the defined credentials and connection parameters. If successful, the instance is flagged as Validated = true.
      Connection Status
      • Represents the current state of connectivity between local and remote instances.
      • This field is automatically updated based on the results of the validation process. It reflects the outcome of the live connection test and cannot be edited.
      • The following values are supported:
        • Approvals not configured in production
        • Authentication method is not configured
        • Connection Valid
        • Connection Invalid
        • API User is missing role
        • User not setup on target instance

        These values help diagnose integration issues, as well as help with corrective actions.
      Authentication Type

      The instance’s authentication type:

      • Basic
      • OAuth
      API Credential Config
      • This field references the credential record used for authentication when Basic is selected as the Authentication Type.
      • It typically points to a Basic Auth credential stored securely in the system.
      OAuth Application Registry
      • The OAuth application registry used for cross-instance integrations.
      • This field is only available if OAuth was selected as the Authentication Type.
      OAuth User Profile

      The OAuth user profile used for cross-instance integrations.
    Note:
    See Scan Engine integrations for details on integration setup.