Authentification ServiceNow

Prérequis

Pour établir la connexion, vous devez donner au connecteur la possibilité de récupérer le jeton d'accès OAuth et activer les activités pour envoyer avec succès des requêtes à l'API ServiceNow.

Authentification multiple

Pour en savoir plus sur l'authentification multiple, cliquez ici.

Pour créer une connexion multi-authentification, vous devez :

1. Suivez les étapes de configuration d'OAuth dans la documentation de ServiceNow.

2. Sélectionnez Integration Service dans Automation Suite.

3. Dans la liste Connecteurs , sélectionnez ServiceNow. Vous pouvez également utiliser la barre de recherche pour affiner le connecteur.
4. Sélectionnez le bouton Ajouter une connexion (Add connection).
5. Vous êtes maintenant redirigé vers la page de connexion.
6. Cliquez sur l'icône pour modifier votre type d'authentification.
7. Sélectionnez le mécanisme d'authentification approprié.
8. Entrez les informations requises et cliquez sur Connecter ( Connect).

Configurer OAuth

Suivez les étapes de configuration d'OAuth dans la documentation de ServiceNow.

Bien que les étapes documentées soient probablement les mêmes dans toutes les régions de la plate-forme ServiceNow, il est recommandé de suivre les étapes pour votre région spécifique au cas où il y aurait des différences (par exemple, Madrid, New York, etc.)

Pour référence, voici comment nous configurons OAuth pour nos exemples.

1. Connectez-vous à votre instance ServiceNow (par exemple, https://<span>dev74293.service-now.com/login</span>)

2. Accédez à Définitions système ( System Definitions) > Plug-ins (Plugins) et vérifiez que le statut du plug-in OAuth est défini sur Actif(Active).

   
   

   

   
   

3. Accédez à Système OAuth > Registre d'applications (Application Registry) et cliquez sur Nouveau (New).

   • Lorsqu’on lui demande Quel type d’application OAuth ?, cliquez sur Créer un point de terminaison d'API OAuth pour les clients externes ( Create an OAuth API endpoint for external clients) .

     
     

     

     
     
4. Saisissez un nom pour votre application (par ex. UiPathQuickstart) et cliquez sur Soumettre (Submit) (en cas de réussite, vous êtes redirigé vers votre liste Registres d'applications ( Application Registries )).
   
   

   

   
   
5. Dans la liste Registres d'applications ( Application Registries ), recherchez votre nouvelle application et cliquez sur son nom pour ouvrir la page de détails.
6. Cliquez sur l'icône de verrouillage à côté de Clé secrète du client (Client Secret) pour afficher la valeur.
7. Notez les valeurs ID du client ( Client Id ) et Clé secrète du client (Client Secret) .

8. Saisissez l’URL de redirection suivante dans son champ correspondant : https://{yourDomain}/provisioning_/callback.

   
   

   

   
   

Ajouter la connexion ServiceNow

Pour créer une connexion à votre instance ServiceNow, vous devez effectuer les étapes suivantes :

1. Sélectionnez Integration Service dans Automation Suite.

2. Dans la liste Connecteurs , sélectionnez ServiceNow. Vous pouvez également utiliser la barre de recherche pour affiner le connecteur.
3. Sélectionnez le bouton Se connecter à ServiceNow .
4. Sélectionnez le bouton Ajouter une connexion (Add connection).
5. Vous êtes maintenant redirigé vers la page de connexion. Saisissez l' URL du site ( Site URL), l' ID de client (Client ID) et la Clé secrète du client ( Client secret ) et cliquez sur Se connecter ( Connect).
   
   

   

   
   
6. Ensuite, entrez votre nom d'utilisateur et votre mot de passe ServiceNow. L'application vous demande la permission de se connecter à votre compte ServiceNow et d'interagir avec les enregistrements. Cliquez sur Autoriser ( Allow).
7. Votre connexion a été ajoutée.

Pour plus d'informations sur la création de connexions avec ServiceNow, reportez-vous à la documentation produit ServiceNow.

Rôles et autorisations ServiceNow

Table ServiceNow	Opération (Operation)	Raison de l'accès
Tables (sys_db_object)	Lu	Le module/table Tables fonctionne comme un référentiel qui contient une ligne correspondant à chaque table dans votre instance ServiceNow. Il est utilisé pour compiler une liste de tables dans le but d’exécuter des actions ou de déclencher des événements. Ceci est nécessaire pour charger toutes vos tables lorsque vous cliquez sur la liste déroulante Sélectionner un objet (Select Object) pour vos activités CRUD.
Dictionnaire (sys_dictionary)	Lu	Cette table englobe les données des colonnes respectives d'une table particulière dans votre instance ServiceNow. Cette table est nécessaire pour charger les champs d'entrée et de sortie lorsque vous sélectionnez une table pour effectuer une action.
Choix (sys_choice)	Lu	La table Choix (Choice) contient les valeurs des options qui apparaissent dans les listes de choix, ainsi que les valeurs recherchées dans nos activités sélectionnées. Sans cela, les recherches de la phase de conception dans nos activités ne pourront pas être chargées.
Utilisateur (User)(sys_user)	Lu	La table Choix (Choice) contient du texte traduit pour les options qui apparaissent dans les listes de choix, ainsi que pour les recherches dans nos activités sélectionnées. Sans cela, les recherches liées à l’utilisateur au moment de la conception dans nos activités ne pourront pas être chargées.

En outre, l'utilisateur doit également posséder le contrôle d'accès requis pour les tables essentielles du scénario d'intégration. Par exemple, si vous souhaitez créer un utilisateur d'intégration capable d'exécuter les actions classiques de l'assistance ITIL (par exemple, ouvrir, mettre à jour et fermer des incidents, des problèmes, des modifications et des éléments de gestion de la configuration), vous devez attribuer le rôle itil .

Création de rôles personnalisés

Certains rôles du système de base, tels que admin , englobent déjà le contrôle d'accès pour ces tables. Toutefois, si vous ne souhaitez pas attribuer de rôles système de base et que vous souhaitez ne fournir que le contrôle d'accès essentiel requis pour utiliser le connecteur ServiceNow, vous pouvez envisager de créer un rôle personnalisé avec les autorisations d'accès nécessaires.

Pour accorder l'accès exclusivement à des tables spécifiques ou des tables non couvertes par les rôles du système de base par défaut, nous recommandons donc la création de rôles personnalisés et l'attribution du contrôle d'accès approprié selon les besoins.

Une fois les étapes mentionnées précédemment effectuées, il est essentiel de fournir à votre nouveau rôle les contrôles d'accès suivants afin d'utiliser le connecteur/les activités ServiceNow.

Table	Saisie de texte	Opération (Operation)
Tables (sys_db_object)	Enregistrer	Lu
Dictionnaire (sys_dictionary)	Enregistrer	Lu
Choix (sys_choice)	Enregistrer	Lu
utilisateur (sys_user)	Enregistrer	Lu

Remarque :

La modification ou la création d'un contrôle d'accès est une capacité exclusive aux utilisateurs possédant le rôle security_admin . En cas d'interrogation, il est conseillé de consulter votre administrateur ServiceNow. Vous pouvez trouver des informations supplémentaires dans les rôles à privilèges élevés.

En plus de ce qui précède, pour effectuer des exécutions d'activité ou de déclencheur, vous devez également fournir d'autres contrôles d'accès.

Par exemple, si votre scénario spécifique consiste à lancer un workflow avec un incident ServiceNow ou à créer un incident ServiceNow, les contrôles d'accès suivants doivent être accordés.

Table	Saisie de texte	Opération (Operation)
Incident	Enregistrer	Lu
Incident	Enregistrer	Écriture