Créer un profil d’intégration personnalisé

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • Créez un profil d’intégration personnalisé pour suivre les abonnements logiciels et optimiser les licences expirées pour toute application SaaS.

    Avant de commencer

    Avant de créer un profil d’intégration personnalisé dans votre ServiceNow instance, configurez une méthode d’authentification dans le compte d’administrateur ou de développeur d’application SaaS. Par exemple, créez une application OAuth ou un jeton d’API.

    Si vous créez une application OAuth, assurez-vous d’activer les champs d’application appropriés. L’application a besoin de champs d’application pour lire les utilisateurs, lire l’activité des utilisateurs et modifier ou supprimer des utilisateurs. Ces champs d’application permettent à l’intégration d’obtenir une liste d’utilisateurs, d’obtenir l’activité des utilisateurs et de récupérer les abonnements inutilisés. Enregistrez l’ID client et le secret client pour l’application OAuth. Vous entrerez ces valeurs dans votre ServiceNow instance.

    Si vous créez un jeton d’API, enregistrez la valeur du jeton d’API. Vous entrerez cette valeur dans votre ServiceNow instance.

    Rôle requis : sam_integrator ou admin

    Procédure

    1. Accédez à la Tout > Licence SaaS > Administration > Créer un profil et sélectionnez Profil d’intégration personnalisé.
    2. Renseignez les champs du formulaire.
      Tableau 1. Formulaire Profil d’intégration
      Champ Valeur
      Nom d'affichage Nom de votre choix. Par exemple, le nom de l’application SaaS que vous intégrez.
      Connexion et information d'identification Cliquez sur l’icône de recherche (icône Rechercher), puis cliquez sur Nouveau. Renseignez les champs du formulaire Alias de connexion et d’informations d’identification.
      • Nom : Nom de votre choix. Par exemple, app_alias, où app est le nom de l’application SaaS avec laquelle vous intégrez.
      • Application : spoke pour la connexion à l’application SaaS. Il peut s’agir d’un spoke existant Hub d'intégration ou d’un nouveau spoke que vous avez créé. Vous pouvez modifier l’application dans la section Développeur de l’icône Paramètres système Paramètres.
      • Type : connexion et informations d’identification.
      • Type de connexion : HTTP.
      • Prise en charge de plusieurs connexions actives : non sélectionné.
      • Politique des nouveaux essais par défaut : politique des nouveaux essais HTTP par défaut.
      • Modèle de configuration : si vous utilisez le type d’accord de code d’autorisation OAuth, Code d’autorisation OAuth. Si vous utilisez un jeton d’API, authentification de base avec clé API. Si vous utilisez une autre méthode d’authentification, créez un modèle de configuration. Pour plus d’informations, consultez Créer un modèle de configuration et Configurer un modèle pour le type d’attribution OAuth JWT Bearer.
      Cliquez sur Envoyer.
      Statut État du profil d'intégration. Les options sont Brouillon et Publié. Cette valeur est automatiquement renseignée.
      Type de profil Intégration personnalisée. Cette valeur est automatiquement renseignée.
    3. Cliquez sur Enregistrer.
    4. Ouvrez l’enregistrement d’alias de connexion et d’informations d’identification en cliquant sur l’icône d’aperçu ( icône d’aperçu), puis sur Ouvrir l’enregistrement.
    5. Cliquez sur le lien connexe Créer une nouvelle connexion et de nouvelles informations d’identification .
    6. Si vous utilisez le modèle de configuration du code d’autorisation OAuth, remplissez le formulaire comme indiqué.
      Tableau 2. Formulaire Créer une connexion et des informations d'identification
      Champ Valeur
      URL de connexion URL de base pour l’API.
      URL d'autorisation Point de terminaison du code d'autorisation OAuth.
      URL de jeton Point de terminaison OAuth utilisé pour récupérer et actualiser les jetons d’accès.
      URL de révocation du jeton Point de terminaison OAuth pour révoquer les jetons d’accès.
      URL de redirection OAuth https:// instance.service-now.com/oauth_redirect.do, où instance est le nom de votre ServiceNow instance.
      Durée de vie du jeton d'actualisation 8640000.
      ID client OAuth ID client que vous avez créé dans le compte d’administrateur ou de développeur d’application SaaS.
      Secret client OAuth Secret client que vous avez créé dans le compte administrateur ou développeur de l’application SaaS.
      Périmètres OAuth Champs d’application que vous avez activés pour votre application OAuth dans le compte d’administrateur ou de développeur d’application SaaS.
    7. Si vous utilisez le modèle de configuration Authentification de base avec clé API, remplissez le formulaire comme indiqué.
      Tableau 3. Formulaire Créer une connexion et des informations d'identification
      Champ Valeur
      URL de connexion URL de votre compte SaaS.
      Nom d'utilisateur Adresse e-mail de l’utilisateur administrateur qui a créé le jeton d’API dans le compte administrateur ou développeur de l’application SaaS.
      Clé API Jeton d’API créé dans le compte administrateur ou développeur de l’application SaaS.
      Remarque :
      Si vous utilisez une autre méthode d’authentification, les champs disponibles sont déterminés par le modèle de configuration que vous avez créé.
    8. Cliquez sur Créer et autorisez l’accès à l’intégration.
      Conseil :
      Connectez-vous à votre compte administrateur d’application SaaS dans un nouvel onglet de navigateur pour vous assurer que l’intégration se connecte au compte approprié.
      Si la connexion réussit, un nouvel enregistrement de connexion est créé dans la liste connexe Connexions de l’enregistrement d’alias de connexion et d’informations d’identification. Si la connexion échoue, vous devez supprimer l’enregistrement de connexion, l’enregistrement d’informations d’identification et l’enregistrement du registre d’application qui ont été créés lors de la tentative de connexion.
      • Accédez à la Connexions et informations d'identification > Connexions et supprimez l’enregistrement de connexion de l’application SaaS.
      • Accédez à la Connexions et informations d'identification > Informations d'identification et supprimez l’enregistrement des informations d’identification pour l’application SaaS.
      • Accédez à la OAuth système > Registre d'application et supprimez l’enregistrement du registre d’application pour l’application SaaS.
      Revenez à l’enregistrement de l’alias de connexion et d’informations d’identification pour l’application SaaS et cliquez sur le lien connexe Créer une nouvelle connexion et informations d’identification pour retenter la connexion.