View a markdown version of this page

ServiceNow intégration - Amazon Quick
Avant de commencerConfigurer ServiceNow OAuthConfigurer l'intégration dans Amazon QuickActions disponiblesLimitationsGestion et résolution des problèmes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ServiceNow intégration

Utilisez l' ServiceNow intégration pour effectuer des actions au sein de vos ServiceNow instances, notamment pour gérer les incidents, les problèmes, les demandes de modification, les articles de la base de connaissances et les pièces jointes. Cette intégration utilise l' ServiceNow API REST. Pour plus d'informations, consultez la section API REST dans la ServiceNow documentation.

La configuration de cette intégration comporte deux étapes. Vous devez d'abord configurer une application OAuth dans votre ServiceNow instance. Ensuite, vous créez l'intégration dans Amazon Quick et vous la connectez à votre ServiceNow application. Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultezMéthodes d’authentification.

Avant de commencer

Avant de configurer l'intégration, vérifiez que vous disposez des éléments suivants.

  • Une ServiceNow instance. Cette intégration est validée par rapport à la version de Xanadu.

  • Un compte ServiceNow utilisateur autorisé à créer des applications OAuth (adminrôle requis).

  • Pour l'authentification du service (informations d'identification du client), votre instance doit exécuter la version de Washington DC ou une version ultérieure.

  • Pour les conditions d'abonnement, voirConfiguration des intégrations dans la console.

Configurer ServiceNow OAuth

Avant de configurer Amazon Quick, créez un point de terminaison d'application OAuth dans votre ServiceNow instance. Effectuez toutes les étapes suivantes ServiceNow avant de passer à la console Amazon Quick.

Pour plus d'informations, consultez la section Créer un point de terminaison pour que les clients puissent accéder à l'instance dans la ServiceNow documentation.

Enregistrez l'application OAuth

Pour enregistrer l'application OAuth, procédez comme suit.

  1. Dans votre ServiceNow instance, accédez à Tout > System OAuth > Registre des applications et choisissez Nouveau.

  2. Choisissez Créer un point de terminaison d'API OAuth pour les clients externes.

  3. Complétez le formulaire :

    • Nom : nom descriptif de l'application OAuth.

    • URL de redirection — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

      Remplacez {region} par votre AWS région (par exemple,us-east-1).

  4. Sélectionnez Soumettre.

  5. Ouvrez à nouveau l'entrée de registre de l'application et cliquez sur l'icône représentant un cadenas à côté de Client Secret pour révéler la valeur.

  6. Copiez les valeurs d'ID client et de secret client. Vous en avez besoin lorsque vous configurez l'intégration dans Amazon Quick.

Étapes supplémentaires pour l'authentification du service (informations d'identification du client)

Si vous envisagez d'utiliser l'authentification de service, effectuez ces étapes supplémentaires après avoir enregistré l'application OAuth. Le type d'octroi des informations d'identification du client a été introduit dans la version de ServiceNow Washington DC. Pour plus d'informations, consultez Up Your OAuth2.0 Game : Inbound Client Credentials with Washington DC in the ServiceNow Community.

  1. Activez le type d'autorisation des informations d'identification du client. Naviguez jusqu'à sys_properties.list utiliser le navigateur de filtres et créez une nouvelle propriété système avec les valeurs suivantes :

    • Nom – glide.oauth.inbound.client.credential.grant_type.enabled

    • Type – true | false

    • Valeur : true

  2. Vérifiez que les plug-ins suivants sont installés (accédez à Admin > Gestionnaire d'applications) :

    • OAuth 2.0 () com.snc.platform.security.oauth

    • Fournisseur d'API REST (com.glide.rest)

    • Étendue de l'authentification (com.glide.auth.scope)

    • Plug-in d'étendue d'authentification de l'API REST () com.glide.rest.auth.scope

  3. Retournez à votre application OAuth dans System OAuth > Registre des applications. Ajoutez le champ utilisateur de l'application OAuth au formulaire s'il n'est pas visible (utilisez Configurer > Générateur de formulaires pour l'ajouter).

  4. Définissez l'utilisateur de l'application OAuth sur un utilisateur doté des autorisations appropriées, tel qu'un utilisateur ayant le rôle d'administrateur système.

Important

Avec l'authentification de service, toutes les actions s'exécutent en tant qu'utilisateur configuré de l'application OAuth. Tout utilisateur Amazon Quick ayant accès à cette intégration peut effectuer des actions en utilisant les autorisations de ce compte. Configurez les autorisations du compte en fonction des exigences de sécurité de votre organisation.

Configurer l'intégration dans Amazon Quick

Après avoir terminé la configuration ServiceNow OAuth, créez l'intégration dans Amazon Quick.

  1. Dans la console Amazon Quick, choisissez Connectors.

  2. Choisissez l'onglet Créer pour votre équipe.

  3. Trouvez et choisissez ServiceNow.

  4. Entrez les détails de l'intégration :

    • Nom : nom descriptif de votre ServiceNow intégration.

    • Description (facultatif) — Objectif de l'intégration.

  5. Choisissez votre type de connexion et renseignez les paramètres de connexion :

    1. Pour l'authentification utilisateur (OAuth), configurez les champs suivants :

      • URL de base — https://{your-instance}.service-now.com

      • ID client : ID client de votre application ServiceNow OAuth.

      • Secret client : secret client de votre application ServiceNow OAuth.

      • URL du jeton — https://{your-instance}.service-now.com/oauth_token.do

      • URL d'authentification — https://{your-instance}.service-now.com/oauth_auth.do

      • URL de redirection — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

    2. Pour l'authentification du service (informations d'identification du client), configurez les champs suivants :

      • Type d'authentification : Service-to-service OAuth

      • URL de base — https://{your-instance}.service-now.com

      • ID client : ID client de votre application ServiceNow OAuth.

      • Secret client : secret client de votre application ServiceNow OAuth.

      • URL du jeton — https://{your-instance}.service-now.com/oauth_token.do

  6. Choisissez Créer et continuer.

  7. Choisissez les utilisateurs avec lesquels partager l'intégration.

  8. Choisissez Suivant.

Pour l'authentification des utilisateurs, accédez à Connecteurs > le nom de votre ServiceNow connecteur, puis choisissez Se connecter pour terminer le flux d'autorisation OAuth.

Actions disponibles

Après avoir configuré l'intégration, les actions suivantes sont disponibles.

ServiceNow actions disponibles
Catégorie Action Description
Incidents Lister les incidents Récupérez les incidents existants.
Incidents Créer un incident Créez un enregistrement d'incident pour documenter un écart par rapport à une norme de fonctionnement attendue.
Incidents Afficher l'incident Récupérez les détails d'un incident spécifique.
Incidents Mettre à jour l'incident Mettez à jour un enregistrement d'incident.
Incidents Supprimer l'incident Supprimez un incident.
Problèmes Problèmes liés à la liste Récupérez les problèmes existants.
Problèmes Créer un problème Créez un nouvel enregistrement du problème.
Problèmes Afficher le problème Récupérez les détails d'un enregistrement de problème spécifique.
Problèmes Problème de mise à jour Mettez à jour un enregistrement de problème.
Problèmes Supprimer le problème Supprimez un problème.
Demandes de modification Demandes de modification de liste Récupérez toutes les demandes de modification.
Demandes de modification Créer une demande de modification Créez une demande de modification pour mettre en œuvre un processus contrôlé de modification des éléments de configuration (CI) approuvés et pris en charge.
Demandes de modification Afficher la demande de modification Récupérez des informations détaillées sur une demande de modification spécifique.
Demandes de modification Mettre à jour la demande de modification Modifiez une demande de modification.
Demandes de modification Supprimer la demande de modification Supprimez une demande de modification.
Articles de la base de connaissances Créer un article de la base de connaissances Créez un article de la base de connaissances. Nécessite le plugin Knowledge API (sn_km_api).
Articles de la base de connaissances Mettre à jour l'article de base de connaissances Modifiez un article de la base de connaissances.
Articles de la base de connaissances Supprimer un article de la base de connaissances Supprimez un article de la base de connaissances.
Pièces jointes Récupérer les métadonnées des pièces jointes Récupérez les métadonnées des fichiers joints.
Pièces jointes Récupérer les métadonnées des pièces jointes Récupérez les métadonnées d'un fichier joint spécifique.
Pièces jointes Récupérer le contenu des pièces jointes Récupérez le contenu de la pièce jointe binaire.
Pièces jointes Télécharger une pièce jointe binaire Téléchargez un fichier binaire sous forme de pièce jointe à un enregistrement spécifié.
Pièces jointes Télécharger une pièce jointe à un formulaire en plusieurs parties Téléchargez une pièce jointe en plusieurs parties.
Pièces jointes Supprimer la pièce jointe Supprimez une pièce jointe.
Utilisateurs Répertorier des utilisateurs Répertoriez tous les enregistrements utilisateur.
Système Choix de liste Récupérez les valeurs de la liste de choix dans la table sys_choice.
Note

Les actions spécifiques disponibles dépendent des autorisations configurées dans votre ServiceNow instance et de la méthode d'authentification utilisée.

Limitations

Cette intégration interagit ServiceNow via l'API REST, qui n'applique pas les politiques d'interface utilisateur, les actions d'interface utilisateur ou les scripts client. Ces règles s'appliquent uniquement dans l'interface ServiceNow du navigateur. Server-side les règles métier, les ACL et les politiques relatives aux données sont appliquées. Pour plus d'informations, consultez la section API REST dans la ServiceNow documentation.

Gestion et résolution des problèmes

Pour modifier, partager ou supprimer votre intégration, consultezGestion des intégrations existantes.

Problèmes d’authentification

  • L'autorisation OAuth échoue : vérifiez que l'ID client et le secret du client correspondent aux valeurs de votre registre d' ServiceNow applications. Vérifiez que l'URL de redirection ServiceNow correspond exactement à l'URL de votre configuration Amazon Quick.

  • L'authentification du service échoue : vérifiez que la propriété glide.oauth.inbound.client.credential.grant_type.enabled du système est définie surtrue. Vérifiez que le champ Utilisateur de l'application OAuth est renseigné dans l'enregistrement du registre de l'application.

Messages d'erreur courants

  • Les actions renvoient des erreurs d'autorisation : vérifiez que l' ServiceNow utilisateur ou l'utilisateur de l'application OAuth possède les rôles requis pour accéder aux tables cibles (par exemple, itil rôle pour la gestion des incidents).

  • Expiration de la connexion ou instance inaccessible : vérifiez que l'URL de base utilise le nom d' ServiceNow instance correct. Vérifiez que l' ServiceNow instance est accessible et qu'elle n'est pas en mode maintenance.