Authentification ServiceNow

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
Code d’autorisation OAuth 2.0	L'utilisateur se connecte à ServiceNow et accorde l'accès à un client OAuth configuré dans ServiceNow.	Scénarios délégués par l'utilisateur en production, nécessitant une gouvernance solide et une révocation facile.
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.

Code d'autorisation OAuth 2.0

Cette méthode accorde l'accès à UiPath en émettant un jeton d'accès au lieu d'exiger votre nom d'utilisateur et votre mot de passe comme champs de connexion.

Remarque :

• Le flux d'octroi de code d'autorisation OAuth 2.0 est pris en charge uniquement dans ServiceNow établir les versions ultérieures.
• Callback URL for your app should be set to the value displayed on the Integration Service connection creation page, for example https://cloud.uipath.com/provisioning_/callback for Automation Cloud. See Set up OAuth for more details.
• Pour Internet, Yokohama et versions antérieures , utilisez l’option Créer un point de terminaison d’API OAuth pour les clients externes dans le Registre d’applications. Les applications OAuth 2.0 existantes configurées de cette façon continuent de fonctionner.
• Pour Zmail et Australie, ServiceNow a rendu obsolète l’option Créer un point de terminaison d’API OAuth pour les clients externes au profit d’une nouvelle configuration d’intégration entrante simplifiée dans la console d’identité de la machine. Voir Configurer OAuth pour Zmail et l'Australie (Intégration entrante) pour obtenir des conseils.

Champs de connexion

Champ	Description
Site Url	URL de l’instance ServiceNow complète (par exemple https://your-instance.service-now.com).​
ID de client	ID client du client OAuth du registre d’applications ServiceNow utilisé par UiPath.​
Secret du client	Clé secrète du client du même client OAuth.​

Problèmes couramment rencontrés

• Rediriger l’URL non concordante ou erreur de redirection non valide

  Confirmez que l’URL de redirection configurée dans le client OAuth de ServiceNow correspond exactement à l’URL de rappel indiquée dans UiPath.​

• Déjà authentifié dans ServiceNow : la page Accepter/Refuser s'affiche au lieu de l'écran de connexion

  Ce comportement est attendu lorsque votre navigateur dispose déjà d’une session ServiceNow active. Dans ce cas, ServiceNow ignore l'écran de connexion et affiche directement la page du consentement OAuth.

  • S'il s'agit du bon compte, cliquez sur Accepter pour terminer la connexion.
  • Si vous avez besoin d'utiliser un autre compte, déconnectez-vous de ServiceNow dans un autre onglet du navigateur ou réessayez le flux dans une fenêtre en mode incognito/privé, puis connectez-vous avec l'utilisateur prévu.

  Lorsque l'authentification unique est activée

  Dans certaines configurations Authentification unique, ni l'écran de connexion ni la page Accepter/Refuser le consentement ne s'affichent. ServiceNow suppose l’utilisateur actuellement authentifié et procède à la création de la connexion, qui peut ensuite échouer en raison d’autorisations manquantes.

  Dans ce scénario, utilisez une fenêtre en mode incognito/privée pour vous assurer que vous pouvez vous authentifier avec le bon utilisateur et les bonnes autorisations requises.

• La connexion et le consentement ont réussi, mais la création de la connexion a échoué

  L’utilisateur autorisé ne dispose pas d’ACL sur une ou plusieurs tables utilisées par le connecteur. Accordez l'accès en lecture aux métadonnées (sys_db_object, sys_dictionary) et des ACL de lecture/d'écriture aux tables métier pertinentes, puis retestez.​

• La connexion fonctionnait auparavant, mais échoue désormais avec des erreurs d’authentification ou de jeton

  Les jetons d'accès ou d'actualisation peuvent avoir expiré ou ont été révoqués (par exemple, après des modifications du mot de passe ou du client OAuth). Rouvrez la connexion dans UiPath et relancez l'autorisation. Si les problèmes persistent, vérifiez si le client OAuth ServiceNow a été modifié ou supprimé.

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. Type the redirect URL displayed on the Integration Service connection creation page, for example https://cloud.uipath.com/provisioning_/callback for Automation Cloud.

   

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.

When configuring the Inbound Integration, set the redirect (callback URL) to: https://{baseURL}/provisioning_/callback (for example, https://cloud.uipath.com/provisioning_/callback for Automation Cloud).

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.

Cycle de vie du jeton pour OAuth2.0 Code d'autorisation

Lors de la création de la connexion, UiPath redirige l'utilisateur vers ServiceNow ; l’utilisateur se connecte et approuve le client OAuth. UiPath échange le code d’autorisation contre un jeton d’accès et un jeton de réactualisation, en les stockant en toute sécurité.​ Les jetons d'accès sont de durée courte ; UiPath utilise automatiquement le jeton de réactualisation pour obtenir de nouveaux jetons d’accès jusqu’à ce que le jeton de réactualisation expire ou que le consentement soit révoqué.​ Si le client OAuth est supprimé ou que des jetons sont révoqués dans ServiceNow, la connexion UiPath doit être réautorisée.

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 dans votre instance 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 pour vos activités CRUD. image des documents
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 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 des utilisateurs en phase de conception dans nos activités ne se chargeront pas.

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 classiques d'assistance ITIL (par exemple, l'ouverture, la mise à jour et la fermeture 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 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 champs (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

Ajouter la connexion ServiceNow

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

1. Sélectionnez Orchestrator dans le lanceur du produit.
2. Sélectionnez un dossier, puis accédez à l'onglet Connexions .
3. Sélectionnez Ajouter une connexion (Add connecion).
4. Pour ouvrir la page de création de connexion, sélectionnez le connecteur dans la liste. Vous pouvez utiliser la barre de recherche pour trouver le connecteur.
5. Sélectionnez votre type d'authentification préféré et entrez les informations d'identification requises.
6. Select Connect.
7. 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.