Configurer le spoke ServiceNow Remote Instance

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 5 minutes de lecture

    • Intégrez les instances locales et distantes ServiceNow en créant un point de terminaison d’API OAuth dans l’instance distante ServiceNow pour authentifier les demandes.

    Avant de commencer

    • Demander Hub d'intégration un abonnement.
    • Activez le spoke ServiceNow Remote Instance dans les instances distantes et locales ServiceNow .
      Remarque :
      Les termes instance distante et instance locale sont utilisés dans les contextes suivants :
      • Instance locale : il s’agit de l’instance ServiceNow à partir de laquelle la communication est initiée et établie.
      • Instance distante : il s’agit de l’instance ServiceNow avec laquelle l’instance locale communique.
    • Rôle requis : administrateur
      Remarque :
      Le rôle administrateur est requis pour configurer uniquement le spoke.

      Pour utiliser le spoke, assurez-vous que les utilisateurs de spoke disposent uniquement des autorisations minimales requises pour accéder aux données dans ServiceNow les tables. N’affectez pas de rôles de privilège élevé aux utilisateurs de ce spoke, sauf si cela est très nécessaire. Cette pratique permet d’assurer un accès contrôlé aux données.

      Les utilisateurs de l’intégration doivent disposer des rôles requis pour accéder à la table avec laquelle ils souhaitent interagir. En outre, ils ont besoin de rôles pour accéder aux tables Table [sys_db_object] et Entrée de dictionnaire [sys_dictionary] afin d’afficher les options dynamiques telles que les noms et les champs d’une table.

    Enregistrer l’instance distante ServiceNow en tant que fournisseur OAuth

    Enregistrez l’instance distante ServiceNow en tant que fournisseur OAuth afin que l’instance locale ServiceNow puisse demander des jetons OAuth 2.0.

    Avant de commencer

    • Dans l’instance distante ServiceNow :
      • Créez un point de terminaison d’API OAuth pour les clients externes. Dans URL de redirection, spécifiez l’URL de l’instance locale ServiceNow au format suivant : https://<nom-instance>.service-now.com/oauth_redirect.do. Pour plus d’informations, consultez Créer un point de terminaison pour que les clients accèdent à l’instance.
      • Copiez et enregistrez les valeurs ID client et Secret client.
    • Rôle requis : administrateur

    Procédure

    1. Accédez à la Tout > OAuth système > Registre d'application.
    2. Ouvrir pour l’enregistrement, RemoteSpoke.
    3. Renseignez ces valeurs sur le formulaire.
      Tableau 1. Formulaire des registres d'application
      Champ Description
      ID client ID client créé dans l’instance distante ServiceNow .
      Secret client Secret client créé dans l’instance distante ServiceNow .
      URL d'autorisation URL de l’instance distante ServiceNow au format suivant : https://<nom-instance>.service-now.com/oauth_auth.do.
      URL de jeton URL de l’instance distante ServiceNow au format suivant : https://<instance-name>.service-now.com/oauth_token.do.
      URL de redirection URL de l’instance locale ServiceNow au format suivant : https://<nom-instance>.service-now.com/oauth_redirect.do.
      Type d'accord par défaut Type d'accord utilisé pour établir le jeton. Sélectionnez Code d'autorisation.
      Durée de vie du jeton d'actualisation Durée de validité du jeton d'actualisation, en secondes. La durée par défaut est de 8 640 000 secondes.
      PKCE requis Option permettant aux clients publics d'exiger PKCE pour une autorisation.
      Remarque :
      Vous pouvez utiliser uniquement le code d'autorisation comme type d'accord par défaut lorsque PKCE est activé.
      Application Périmètre de l'application qui contient cet enregistrement.
      Accessible depuis Périmètre de l'application à partir duquel ce registre est accessible.
      Actif Option permettant d’utiliser activement le registre d’application.
    4. Cliquez avec le bouton droit de la souris sur l'en-tête du formulaire, puis cliquez sur Enregistrer.

    Créer un enregistrement d’informations d’identification pour l’instance distante ServiceNow

    Créez un enregistrement d’informations d’identification pour l’instance distante ServiceNow . Les alias de connexion et d’informations d’identification du spoke ServiceNow Remote Instance utilisent ces informations d’identification pour autoriser des actions.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Informations d'identification.
    2. Cliquez sur Nouveau.
      Le système affiche le message Quel type d’informations d’identification voulez-vous créer ?
    3. Sélectionnez Informations d'identification OAuth 2.0.
    4. Renseignez les champs du formulaire.
      Champ Valeur requise
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, Informations d’identification à distance.
      Actif Option permettant d'utiliser activement l'enregistrement des informations d'identification.
      Profil de l'entité OAuth Profil OAuth créé lors de l’inscription de l’instance distante ServiceNow en tant que fournisseur OAuth. Par exemple, sélectionnez RemoteSpoke default_profile.
      Ordre Ordre dans lequel les informations d'identification sont utilisées. Par exemple, saisissez 100.
    5. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Envoyer.
    6. Pour générer le jeton OAuth, cliquez sur le lien connexe Obtenir le jeton OAuth.

    Créer un enregistrement de connexion pour l’instance distante ServiceNow

    Créez un enregistrement de connexion pour votre instance distante ServiceNow . Les alias de connexion et d’informations d’identification du spoke ServiceNow Remote Instance utilisent ces connexions pour effectuer des actions.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Alias de connexion et d’informations d’identification.
    2. Ouvrez l’enregistrement d’alias, ServiceNowRemoteInstance.
    3. Dans l’onglet Connexions , cliquez sur Nouveau.
    4. Renseignez les champs du formulaire.
      Tableau 2. Formulaire Connexion HTTP(s)
      Champ Valeur requise
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, Connexion à distance.
      Informations d'identification Enregistrement d’informations d’identification créé pour l’instance distante ServiceNow . Par exemple, Informations d’identification à distance.
      Alias de connexion Enregistrement d'alias associé à cette connexion.
      Générateur d'URL
      Remarque :
      ne cochez pas la case.
      URL de connexion URL de l’instance distante ServiceNow . Par exemple, https://<nom-instance-distant>.service-now.com/.
      Actif Option permettant d'utiliser activement la connexion.
      Domaine Domaine dans lequel l'action ou l'activité s'exécute.
    5. Cliquez sur Envoyer.

    Créer un enregistrement d’informations d’identification pour l’instance locale ServiceNow

    Créez un enregistrement d’informations d’identification pour l’instance locale ServiceNow . Les alias de connexion et d’informations d’identification du spoke ServiceNow Remote Instance utilisent ces informations d’identification pour autoriser des actions.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Informations d'identification.
    2. Cliquez sur Nouveau.
      Le système affiche le message Quel type d’informations d’identification voulez-vous créer ?
    3. Sélectionnez Informations d'identification pour l'authentification de base.
    4. Renseignez les champs du formulaire.
      Champ Valeur requise
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, Informations d’identification locales.
      Nom d'utilisateur Nom d’utilisateur permettant de se connecter à l’instance locale ServiceNow .
      Mot de passe Mot de passe pour se connecter à l’instance locale ServiceNow .
      Actif Option permettant d'utiliser activement l'enregistrement des informations d'identification.
    5. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Envoyer.

    Créer un enregistrement de connexion pour l’instance locale ServiceNow

    Créez un enregistrement de connexion pour votre instance locale ServiceNow . Les alias de connexion et d’informations d’identification du spoke ServiceNow Remote Instance utilisent ces connexions pour effectuer des actions.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Alias de connexion et d’informations d’identification.
    2. Ouvrez l’enregistrement d’alias, ServiceNowRemoteInstanceLocalAlias.
    3. Dans l’onglet Connexions , cliquez sur Nouveau.
    4. Renseignez les champs du formulaire.
      Tableau 3. Formulaire Connexion HTTP(s)
      Champ Valeur requise
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, Connexion locale.
      Informations d'identification Enregistrement d’informations d’identification créé pour l’instance locale ServiceNow . Par exemple, Informations d’identification locales.
      Alias de connexion Enregistrement d'alias associé à cette connexion.
      URL de connexion URL de l’instance locale ServiceNow Par exemple, https://<nom-instance-local>.service-now.com/.
      Actif Option permettant d'utiliser activement la connexion.
      Domaine Domaine dans lequel l'action ou l'activité s'exécute.
    5. Cliquez sur Envoyer.