ServiceNow intégration - Amazon Quick
Avant de commencerConfiguration 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 OAuth application 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 OAuth applications (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.

Configuration ServiceNow OAuth

Avant de configurer Amazon Quick, créez un point de terminaison d' OAuth application 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' OAuth application

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

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

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

  3. Complétez le formulaire :

    • Nom : nom descriptif de l' OAuth application.

    • 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 par service, effectuez ces étapes supplémentaires après avoir enregistré l' OAuth application. 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 3.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 OAuth demande dans Système OAuth > Registre des applications. Ajoutez le champ Utilisateur de l'OAuth application 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'OAuth application 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 sont exécutées en tant qu'utilisateur de OAuth l'application configuré. 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

Une fois la ServiceNow OAuth configuration terminée, créez l'intégration dans Amazon Quick.

  1. Dans la console Amazon Quick, choisissez Integrations.

  2. Choisissez ServiceNowet cliquez sur le bouton Ajouter (plus « + »).

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

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

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

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

    1. Pour Authentification utilisateur (OAuth), configurez les champs suivants :

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

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

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

      • 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 ServiceNow OAuth application.

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

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

  5. Choisissez Créer et continuer.

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

  7. Choisissez Suivant.

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

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 l'enregistrement d'un 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 approuvés et pris en charge (CIs).
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. Les règles métier côté serveur et les ACLs 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

  • OAuth échec de l'autorisation : vérifiez que l'ID client et le secret du client correspondent aux valeurs de votre registre ServiceNow d'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'OAuth application 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' OAuthapplication 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.