Authentification ServiceNow

Connectez UiPath à ServiceNow à l'aide d'un nom d'utilisateur et d'un mot de passe ou de l'authentification OAuth 2.0 dans Automation Suite.

UiPath prend en charge les types d'authentification suivants pour ServiceNow :

Type d’authentification	Description	Idéal pour
Basique (nom d'utilisateur/mot de passe)	Connexion directe avec un utilisateur de ServiceNow via l'authentification de base HTTPS.	Des configurations simples et non OAuth, parfaites pour les POC rapides
Accord de mot de passe OAuth 2.0	Nom d’utilisateur/mot de passe du compte de service plus les informations d’identification du client OAuth converties en jetons.	Des intégrations de service à service où OAuth est requis, mais que la connexion interactive n'est pas pratique.

Basique (nom d'utilisateur/mot de passe)

Champs de connexion

Champ	Description
Site Url	URL de l’instance ServiceNow complète, par exemple https://your-instance.service-now.com.​
Nom d'utilisateur (Username)	Nom d’utilisateur de l’intégration ServiceNow.​
Mot de passe (Password)	Mot de passe de l’utilisateur de l’intégration.​

Problèmes couramment rencontrés

Erreurs 4XX

• Vérifier l’URL de l’instance, le nom d’utilisateur et le mot de passe ; assurez-vous que le compte est actif et non verrouillé ou bloqué par des politiques d’adresse IP/de connexion.​
• Vérifiez que l'utilisateur peut lire sys_db_object , sys_dictionary et dispose des ACL nécessaires sur les tables cibles.
• Assurez-vous que votre instance ServiceNow n'est pas en veille.

Mot de passe OAuth 2.0

Champs de connexion

Champ	Description
Site Url	URL d’instance ServiceNow complète.
Nom d'utilisateur (Username)	Nom d'utilisateur du compte de service ServiceNow.
Mot de passe (Password)	Mot de passe de ce compte de service.
ID de client	ID client du client OAuth ServiceNow.​
Clé secrète du client	Clé secrète du client du même client OAuth.​

Configurer OAuth

Remarque :

La procédure suivante s'applique à Windows, Yokohama et aux versions antérieures de ServiceNow. Si vous utilisez Hub ou l'Australie, consultez Configurer OAuth pour Hub et l'Australie (intégration entrante).

Suivez les étapes Configurer 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 de votre région spécifique au cas où il existe des différences.

Pour référence, la procédure suivante explique 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 > Plug-ins et vérifiez que le statut du plug-in OAuth est défini sur Actif.

3. Accédez à Système OAuth > Registre des applications et sélectionnez Nouveau.
   • Lorsqu'on vous demande Quel type d'application OAuth ? sélectionnez Créer un point de terminaison d'API OAuth pour les clients externes.

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

5. Dans la liste Inscriptions d'applications , recherchez votre nouvelle application et sélectionnez le nom pour ouvrir la page des détails.
6. Cliquez sur l'icône de verrouillage à côté de Clé secrète du client pour afficher la valeur.
7. Take note of the Client Id and Client Secret values.
8. Saisissez l’URL de redirection suivante dans son champ correspondant: https://{yourDomain}/provisioning_/callback.

Configurer OAuth pour Modern et l'Australie (intégration entrante)

Pour les versions de Zium, Australie et ultérieures , ServiceNow a remplacé l’option Créer un point de terminaison d’API OAuth pour les clients externes par un flux d’intégration entrant simplifié configuré via la console d’identité de machine.

Suivez les étapes Configurer un octroi de code d’autorisation OAuth dans la documentation de ServiceNow pour créer une intégration entrante.

Lors de la configuration de l'intégration entrante, définissez l'URL de redirection (rappel) sur : https://{yourDomain}/provisioning_/callback.

Remarque :

• Décochez Autoriser l'accès uniquement aux API dans l'étendue sélectionnée si vous souhaitez que les contrôles d'accès et les politiques d'API des utilisateurs s'appliquent par défaut.
• Si vous activez Autoriser l’accès uniquement aux API dans l’étendue sélectionnée et que vous attribuez des étendues, l’étendue de l’API Tables est requise pour que l’intégration fonctionne.

Remarque :

La procédure d’intégration entrante de Z nombre/Australie est documentée pour le flux d’octroi du code d’autorisation OAuth. Si vous utilisez l'octroi de mot de passe OAuth 2.0, consultez la documentation de ServiceNow pour confirmer si la même configuration d'intégration entrante couvre également la configuration client d'octroi de mot de passe dans votre version de ServiceNow.

Ajouter la connexion ServiceNow

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

1. Sélectionnez Integration Service dans la barre de gauche.
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 votre type d'authentification préféré et entrez les informations d'identification requises.
5. Select Connect.
6. Saisissez ensuite votre nom d'utilisateur et votre mot de passe ServiceNow. L'application vous demande l'autorisation de vous connecter à votre compte ServiceNow et d'interagir avec les enregistrements. Sélectionnez Autoriser.

Pour de plus amples informations sur la création de connexions avec ServiceNow, consultez la Documentation produit de ServiceNow.

Rôles et autorisations ServiceNow

Le tableau suivant répertorie les rôles et autorisations minimum requis afin de créer une connexion et d'utiliser le connecteur ServiceNow. Les exigences s'appliquent à tous les types d'authentification.

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 de votre instance de ServiceNow. Elle est utilisée pour compiler une liste de tables dans le but d'exécuter des actions ou de déclencher des événements. Cela est nécessaire pour charger toutes vos tables lorsque vous utilisez 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 (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.

De plus, l'utilisateur doit également disposer du contrôle d'accès nécessaire pour les tables essentielles au scénario d'intégration. Par exemple, si vous avez l'intention de créer un utilisateur d'intégration capable d'exécuter des actions d'assistance ITIL classiques, 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 incluent déjà le contrôle d'accès pour ces tables. Mais si vous ne souhaitez pas attribuer de rôles système de base et si vous souhaitez fournir uniquement le contrôle d'accès essentiel requis pour l'utilisation du 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 ou tableaux spécifiques non couverts par les rôles système de base par défaut, nous vous recommandons de créer des rôles personnalisés et d'affecter le contrôle d'accès approprié selon vos besoins.

Vous devez fournir les nouveaux rôles avec les contrôles d’accès répertoriés dans le tableau suivant afin d’utiliser le connecteur/les activités ServiceNow. Par exemple, un utilisateur sans autorisations d'administrateur requiert le rôle personalize_dictionary pour accéder à la table sys_dictionary .

Table	Saisie de texte	Opération (Operation)
Tables (sys_db_object)	Enregistrer	Lu
Dictionnaire (sys_dictionary)	Enregistrer	Lu
Choix (sys_choice)	Enregistrer	Lu
Utilisateur (User) (sys_user)	Enregistrer	Lu
Classes de champ (sys_glide_object)	Enregistrer	Lu

Remarque :

La modification ou la création de contrôles d'accès est une fonctionnalité exclusive réservée à un utilisateur possédant le rôle security\_admin . Si vous avez des inquiétudes, il est conseillé de consulter votre administrateur ServiceNow. Vous pouvez trouver des informations supplémentaires dans les rôles à privilèges élevés.

Pour réaliser 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