ServiceNow

Ce connecteur est disponible dans les produits et régions suivants :

Service	classe	Régions
Copilot Studio	Premium	Toutes les régions Power Automate , à l’exception des éléments suivants :      - China Cloud géré par 21Vianet
Applications logiques	Norme	Toutes les régions Logic Apps , à l’exception des suivantes :      - Us Department of Defense (DoD)
Power Apps	Premium	Toutes les régions Power Apps , à l’exception des suivantes :      - China Cloud géré par 21Vianet
Power Automate	Premium	Toutes les régions Power Automate , à l’exception des éléments suivants :      - China Cloud géré par 21Vianet

Contact
Nom	Microsoft
URL	https://learn.microsoft.com/connectors/service-now/

Métadonnées du connecteur
Éditeur	Microsoft
Website	https://www.servicenow.com/
Politique de confidentialité	https://www.servicenow.com/privacy-statement.html
Catégories	Website

Problèmes connus et limitations

1. Lorsque vous utilisez l’action Créer un enregistrement , il n’est pas possible de spécifier la description complète de l’enregistrement. La valeur du champ est ignorée en raison de Service-Now limitations de l’API REST.

2. L’action Obtenir les enregistrements peut renvoyer une erreur « Table non valide » ou une autre erreur dans Power Apps. Pour les implémentations de Power Apps, le travail suggéré consiste à utiliser l’action Obtenir des enregistrements dans Power Automate et à renvoyer les données à Power Apps.

3. Le connecteur prend actuellement en charge uniquement les URL d’instance se terminant par « service-now.com ». L’utilisation de domaines alternatifs tels que « servicenowservices.com » peut entraîner des erreurs de connexion. Dans ce cas, en particulier lors de l’utilisation du nouveau domaine ServiceNow dans GCC, il est recommandé d’utiliser l’authentification de base.

4. Si vous rencontrez une erreur contextuelle indiquant « Redirect_uri non valide », copiez l’URL complète de la fenêtre contextuelle et extrayez le paramètre redirect_uri (par exemple, redirect_uri=https%3a%2f%2ftip1-shared.consent.azure-apim.net%2fredirect). Après le décodage de l’URL (en remplaçant %3a par : et %2f par /), mettez à jour le champ URL de redirection dans le registre d’applications OAuth de votre instance ServiceNow, comme illustré dans l’image ci-dessous. Ensuite, essayez de rajouter la connexion.

Comment configurer une connexion ServiceNow Power Platform qui utilise l’ID Microsoft Entra

Il existe deux types de connexion :

1. MICROSOFT Entra ID OAuth à l’aide du certificat : il s’agit d’un type d’authentification basé sur des jetons d’application dans lequel une application inscrite dans l’ID Entra peut être utilisée pour accéder à ServiceNow en obtenant un jeton avec la ressource définie comme application d’ID Entra représentant ServiceNow.

2. Microsoft Entra ID OAuth à l’aide de la connexion utilisateur : il s’agit d’un type d’authentification basé sur un jeton utilisateur où l’utilisateur final peut se connecter à l’application Entra ID 1P (Application ServiceNow Connector 1p) et obtenir un jeton d’accès avec l’étendue définie pour l’application Entra ID du représentant ServiceNow.

Étapes de création d’une connexion OAuth d’ID Microsoft Entra à l’aide du certificat

Étape 1 : Inscrire une « Application A » dans Microsoft Entra ID pour l’intégration OIDC à ServiceNow. Il s’agit de l’application d’ID Entra représentant ServiceNow.

• Accéder aux inscriptions > d’applications Nouvelle inscription pour créer une inscription d’application

  • Nom : n’importe quel nom de choix

  • URI de redirection : non obligatoire

• Ajouter aud, email & upn aux revendications sous « Revendications facultatives »

Étape 2 : Inscrire le même ID qu’un fournisseur OIDC dans ServiceNow

• Accédez à la vérification System OAuth > Application Registry > New > Configure an OIDC provider des jetons d’ID

  • Nom : n’importe quel nom de choix
  • ID client : « Application A » créée à l’étape client ID 1
  • Clé secrète client : cela n’est pas réellement utilisé, n’importe quelle valeur peut être définie

• Dans le formulaire d’inscription du fournisseur OIDC, ajoutez une nouvelle configuration de fournisseur OIDC. Sélectionnez l’icône de recherche dans le champ Configuration du fournisseur OAuth OIDC pour ouvrir les enregistrements des configurations OIDC, sélectionnez « Nouveau ».

  • Fournisseur OIDC : ID Microsoft Entra
  • URL des métadonnées OIDC : l’URL doit être au format https://login.microsoftonline.com/<tenantID>/.well-known/openid-configuration, remplacer tenantID par Directory (tenant) ID
  • Durée de vie du cache de configuration OIDC : 120
  • Application : Global
  • Revendication de l’utilisateur : oid
  • Champ utilisateur : ID d’utilisateur
  • Activer la vérification des revendications JTI : Désactivé

• Sélectionnez « Envoyer » et mettez à jour le formulaire d’entité OAuth OIDC

Étape 3 : Inscrire une « Application B » dans Microsoft Entra ID pour l’utilisation du connecteur. Il s’agit de l’application qui joue le rôle d’un utilisateur disposant d’autorisations élevées dans l’instance ServiceNow

• Accédez à la création App registrations > New registration d’une application

  • Nom : n’importe quel nom de choix
  • Dans Certificats &secrets, chargez le fichier .cer du certificat Dans le cas d’un certificat SNI, ajoutez trustedCertificateSubjects simplement le manifeste de l’application avec les éléments appropriés authorityId et subjectName

Étape 4 : Créer un utilisateur système dans ServiceNow. Il s’agit de l'« Application B » en tant qu’utilisateur dans l’instance ServiceNow

• Accédez à la création User Administration > Users d’un utilisateur

  • ID utilisateur : ID d’objet du principal de service « Application B » créé à l’étape 3
  • Vérification Web service access only

Étape 5 : Se connecter à l’aide du connecteur – Copilot Studio – Configuration du connecteur

• Configurez le connecteur avec les informations suivantes et connectez-vous :

  • Nom de l’instance : nom de l’instance de ServiceNow
  • ID de locataire : ID de locataire du locataire Microsoft Entra
  • ID client : ID client de « Application B » créé à l’étape 3
  • URI de ressource : ID client de « Application A » créé à l’étape 1 (et non l’URI de l’application)
  • Secret du certificat client : fichier .pfx du certificat créé à l’étape 3
  • Mot de passe du certificat : mot de passe du fichier .pfx

Étapes de création d’une connexion utilisateur OAuth ID Microsoft Entra

Pour configurer une connexion de connexion utilisateur OAuth OAuth ID Microsoft Entra, suivez l’étape 1 et l’étape 2, comme indiqué dans la section d’authentification par certificat ci-dessus.

L’étape 1 reste la même. À l’étape 2, mettez à jour la revendication utilisateur vers Upn ou une propriété de revendication personnalisée à partir du jeton (pour les fournisseurs d’identité tiers autres que Entra) dans ServiceNow. Le champ utilisateur doit correspondre au champ de table utilisateur système ServiceNow contenant l’upn ou l’ID utilisateur.

Les étapes 3 et 4 de la section d’authentification par certificat ci-dessus ne sont pas requises. Au lieu de cela, « Application B » est une application 1p créée pour le connecteur ServiceNow. L’application ci-dessous doit recevoir des autorisations dans l’application A.

ID « Application B » : c26b24aa-7874-4e06-ad55-7d06b1f79b63

Lors de la création de la connexion pour le connecteur ServiceNow, l’utilisateur doit sélectionner « Connexion utilisateur d’ID Microsoft Entra » comme type d’authentification et doit uniquement fournir le nom de l’instance ServiceNow et l’ID de ressource (qui serait l’identificateur de « Application A »). Après cela, le bouton de connexion prend l’utilisateur par le biais de la connexion d’ID Entra à l’aide de son propre compte.

L’utilisation d’un fournisseur d’identité tiers ou d’une incompatibilité de données existant entre l’utilisateur dans Entra ID et la table des utilisateurs ServiceNow

• S’il existe une incompatibilité entre la propriété d’identificateur de l’utilisateur dans le jeton d’ID Entra et la valeur de l’identificateur utilisateur figurant dans la table ServiceNow
  • Par exemple, le jeton contient l’upn complet (ainsi que le domaine – abc@contoso.com) et la table utilisateurs ServiceNow contient uniquement l’identificateur de l’utilisateur (abc). Il est recommandé d’ajouter un attribut personnalisé au jeton qui contient une valeur qui correspond à l’identificateur utilisateur dans l’identificateur ServiceNow en appliquant une formule, puis en tirant parti de cette nouvelle propriété pour effectuer le mappage de revendication à l’étape 2.
  • Documentation Microsoft Learn décrivant le processus d’ajout d’une nouvelle propriété de revendication : https://learn.microsoft.com/entra/external-id/customers/how-to-add-attributes-to-token

« Comment configurer une connexion ServiceNow Power Platform qui utilise Microsoft Entra ID » fait référence :

• OIDC (ID externe Token Authentication) pour les API REST - Support et résolution des problèmes
• Connecteur Microsoft Graph du catalogue ServiceNow | Microsoft Learn

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Authentification de base	Se connecter à l’aide de l’authentification de base	Toutes les régions	Non partageable
Microsoft Entra ID OAuth à l’aide du certificat	OAuth avec Microsoft Entra ID à l’aide du certificat PFX.	POWERPLATFORM uniquement	Partageable
Connexion de l’utilisateur Microsoft Entra ID	Connexion avec les informations d’identification d’ID Microsoft Entra	Toutes les régions	Non partageable
Utiliser Oauth2	Se connecter avec Oauth2	Toutes les régions	Non partageable
Valeur par défaut [DÉCONSEILLÉE]	Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.	Toutes les régions	Non partageable

Authentification de base

ID d’authentification : basicAuthentication

Applicable : Toutes les régions

Se connecter à l’aide de l’authentification de base

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom	Type	Descriptif	Obligatoire
Instance	ficelle	Nom de l’instance pour service-now.com ou URL personnalisée pour le compte migré	Vrai
Nom d’utilisateur	ficelle	Nom d’utilisateur de cette instance	Vrai
Mot de passe	securestring	Mot de passe de ce compte	Vrai

ID Microsoft Entra OAuth à l’aide du certificat

ID d’authentification : aadOAuthCert

Applicable : POWERPLATFORM uniquement

OAuth avec Microsoft Entra ID à l’aide du certificat PFX.

Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs

Nom	Type	Descriptif	Obligatoire
Nom de l’instance	ficelle	Nom de l’instance utilisé pour identifier l’URl du site ServiceNow	Vrai
ID du locataire	ficelle		Vrai
ID de client	ficelle		Vrai
URI de ressource	ficelle		Vrai
Secret du certificat client	clientCertificate	Secret de certificat client autorisé par cette application	Vrai

Connexion de l’utilisateur Microsoft Entra ID

ID d’authentification : entraIDUserLogin

Applicable : Toutes les régions

Connexion avec les informations d’identification d’ID Microsoft Entra

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom	Type	Descriptif	Obligatoire
URI de ressource	ficelle		Vrai
Nom de l’instance	ficelle	Nom de l’instance utilisé pour identifier l’URL du site ServiceNow	Vrai

Utiliser Oauth2

ID d’authentification : oauth2ServiceNow

Applicable : Toutes les régions

Se connecter avec Oauth2

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom	Type	Descriptif	Obligatoire
Nom de l’instance	ficelle	Nom de l’instance utilisé pour identifier l’URl du site ServiceNow	Vrai
ID client	ficelle	ID utilisé pour identifier cette application avec le fournisseur de services	Vrai
Clé secrète client	securestring	Secret partagé utilisé pour authentifier cette application auprès du fournisseur de services	Vrai

Valeur par défaut [DÉCONSEILLÉE]

Applicable : Toutes les régions

Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom	Type	Descriptif	Obligatoire
Instance	ficelle	Nom de l’instance pour service-now.com ou URL personnalisée pour le compte migré	Vrai
Nom d’utilisateur	ficelle	Nom d’utilisateur de cette instance	Vrai
Mot de passe	securestring	Mot de passe de ce compte	Vrai

Limitations

Nom	Appels	Période de renouvellement
Appels d’API par connexion	600	60 secondes

Actions

Charger un fichier binaire en tant que pièce jointe (préversion)	Charge un fichier binaire en tant que pièce jointe dans un enregistrement spécifié
Charger une pièce jointe à plusieurs parties (préversion)	Charger une pièce jointe à partir d’un formulaire multipart
Créer un enregistrement	Créez un enregistrement dans une table ServiceNow.
Mettre à jour l’enregistrement	Met à jour un enregistrement pour un type d’objet ServiceNow comme « Incidents »
Obtenir des articles sur les connaissances	Retourne une liste d’articles de la base de connaissances (Ko) qui peuvent être recherchés et filtrés
Obtenir des catalogues	Récupère une liste de catalogues
Obtenir des types d’enregistrements	Répertorie les types d’enregistrements disponibles
Obtenir des éléments de catalogue	Récupère une liste d’éléments de catalogue en fonction des paramètres spécifiés, comme un texte de recherche ou un catalogue.
Obtenir les catégories de catalogue	Récupère la liste des catégories d’un catalogue spécifique
Obtenir les métadonnées de pièce jointe (préversion)	Récupérer des métadonnées pour les pièces jointes
Obtenir l’élément de catalogue	Récupérez un élément de catalogue spécifique.
Obtenir un enregistrement	Obtient un enregistrement pour un type d’objet ServiceNow comme « Incidents »
Récupérer le contenu de pièce jointe (préversion)	Récupérer le contenu de pièce jointe
Récupérer les métadonnées de pièce jointe (préversion)	Récupérer les métadonnées de pièce jointe
Répertorier les enregistrements	Obtient les enregistrements d’un certain type d’objet ServiceNow comme « Incidents »
Supprimer un enregistrement	Supprime un enregistrement pour un type d’objet ServiceNow comme « Incidents »
Supprimer une pièce jointe (préversion)	Supprimer une pièce jointe
Élément de commande	Commandes ou achète un élément de catalogue spécifique.

Charger un fichier binaire en tant que pièce jointe (préversion)

Charger une pièce jointe à plusieurs parties (préversion)

Créer un enregistrement

Mettre à jour l’enregistrement

Obtenir des articles sur les connaissances

Obtenir des catalogues

Obtenir des types d’enregistrements

Obtenir des éléments de catalogue

Obtenir les catégories de catalogue

Obtenir les métadonnées de pièce jointe (préversion)

Obtenir l’élément de catalogue

Obtenir un enregistrement

Récupérer le contenu de pièce jointe (préversion)

Récupérer les métadonnées de pièce jointe (préversion)

Répertorier les enregistrements

Supprimer un enregistrement

Supprimer une pièce jointe (préversion)

Élément de commande

Définitions

UploadAttachmentResponse

GetTypesResponse

GetCatalogsResponse

GetCatalogCategoriesResponse

GetCatalogItemsResponse

GetCatalogItemResponse

OrderItemResponse

GetArticlesResponse