Register a Service Exchange consumer

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 3 min. de leitura

    • Registering a new consumer in Service Exchange establishes an instance-to-instance integration between a provider and a consumer.

    Antes de Iniciar

    • Role required: admin
    • A provider record must have been created. See Set up a Service Exchange provider record.
    • A company or account must exist for the consumer in the provider’s instance, and a user or contact with the sn_sb_pro.consumer role must be associated with the company. If this is a production instance, the user must have a valid email address to receive the registration email.
    • Run the Key Management > Health (Diagnostics) to ensure that the Key Management Framework health check has passed. Your administrator must have the sn_kmf.admin and sn_kmf.cryptographic_manager roles to access the health diagnostics. If your administrator does not have access, follow the instructions in Assign Key Management Framework roles to grant the required roles.

    Por Que e Quando Desempenhar Esta Tarefa

    Register a new consumer by creating a registration task for the company and instance you want them to connect with. The company contact will receive an email when this registration task is created in a production instance or any other instance where email sending is enabled. If email sending is not enabled, the provider admin can copy the link from the registration task comments and send it to the consumer admin. The email contains instructions and a link that allows the consumer to complete the registration process.

    The following diagram shows the onboarding flow and the exchange of data between the Service Exchange provider and consumer instances.

    Figura 1. Service Exchange V2 KMF Crypto Module Key Exchange Onboarding Flow
    Service Exchange Key Exchange Onboarding flow
    Nota:
    When setting up two instances for demonstration purposes, it is vital to ensure that the consumer contact matches the user who is currently logged into the provider instance when attempting to complete the registration from the consumer instance. In the consumer instance, selecting the Connect to Provider option will open an OAUTH page in the provider instance, where the consumer admin must authenticate the OAUTH token. If the contact listed on the registration task does not match the logged-in user, this process will fail.

    Procedimento

    1. Navigate to All > Service Exchange Provider > Consumer Registrations and select New.
    2. Enter the following details:
      • Select the Company associated with the consumer instance being registered.
      • Select the contact details associated with the Company you have selected.
        Nota:
        This contact must be an admin user in the consumer instance, otherwise the registration process cannot be completed. On the provider instance, only a Service Exchange Consumer role is required.
      • Select the Lock icon on the URL field and enter the URL of the consumer ServiceNow instance.
    3. Select Save.
      After you save the registration record, the state changes to Awaiting Validation while the pre-onboarding scan suite runs validation checks in the background.
      The validation state changes to either Open or Validation Failed.
      • If all validation checks pass, the state changes to Open. An email is generated and sent to the consumer contact specified during registration if email sending is enabled. If email sending is not enabled, the admin must copy the link from the work notes and manually send it to the consumer admin. The consumer contact must follow the steps listed in the Connect to a provider to complete the registration process on the consumer instance.
      • If any validation checks fail, the state changes to Validation Failed. The registration record displays a validation failed banner indicating that one or more Pre-Onboarding suite checks did not pass with a link to the Health Dashboard. The consumer registration link is not generated until all issues are resolved.

    If the state is Validation Failed, you must resolve all issues identified during the pre-onboarding checks.

    1. Select the Health Dashboard links validation failed banner at the top of the registration record.
    2. Review and resolve all the pre-onboarding scan issues.

      After all issues are resolved, the state automatically changes to Open and the registration process resumes.