Skip to content
Release: Australia · Updated: 2026-05-05 · Official documentation · View source

Register your instance

Register each participating ServiceNow instance in the My SN Instances table before configuring any instance-to-instance integration.

Before you begin

Before registering, gather the following for each instance:

  • The exact instance name matching the instance_name system property (typically the subdomain — for example, companyname from companyname.service-now.com).
  • The full instance URL in the format https://instancename.service-now.com. Omit www., trailing slashes, and any path after the domain.
  • The environment type: Development, Production, or Test. Only one instance in your stack may be designated Production.

Role required: Scan Engine Admin (sn_se.scan_engine_admin)

Procedure

  1. Navigate to ALL > Impact > Configuration > Scan Engine Properties and open the My SN Instances related list tab.

  2. Select New for each instance and populate the following fields.

FieldValue
Instance NameMust match the `instance_name` system property.
Instance URL`https://instancename.service-now.com`
EnvironmentDevelopment, Production, or Test.
Authentication Type- Basic: See Configure the Basic authentication method - OAuth: - Configure the OAuth authentication method development instance - Configure the OAuth authentication method production instance
API Credential ConfigThe authentication record for this instance.
  1. Promote or export the My SN Instances list to all instances that will use Scan Engine integrations.

  2. On each target instance, open the imported production record and select Validate Connection.

    Connection Status updates to Connection valid on success.

What to do next

If validation fails, resolve the root cause before retrying. Repeated failed attempts can trigger the account lockout policy. Refer to Validate your instance connection for additional information.

  • Configure the OAuth authentication method development instance
    Set up OAuth authentication for instance-to-instance Scan Engine integrations using several stages, an integration user account, an OAuth2 configuration record, and provider and client application registries.
  • Configure the Basic authentication method
    Confirm an integration user, create a Basic authentication record, then connect your instances using basic authentication. Basic authentication is supported but OAuth is recommended for production environments.
  • Validate your instance connection
    Validate the connection between registered instances to confirm that authentication and My SN Instances configuration are correct before enabling integrations.
  • Recover from account lockout
    Unlock the integration user account and clear the password reset flag after repeated failed validation attempts trigger the account lockout policy.

Parent Topic:Configure Scan Engine integrations