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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • Créez un profil d’intégration personnalisé pour suivre les abonnements logiciels et optimiser les licences périmées pour toutes les applications 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 administrateur ou développeur de l’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 périmètres 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é utilisateur 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 Tous > 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 avec laquelle vous effectuez l’intégration.
      Connexion et information d'identification Cliquez sur l’icône de recherche ( icône de recherche), 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 effectuez l’intégration.
      • Application : Spoke pour la connexion à l’application SaaS. Ce spoke peut être un spoke existant Hub d'intégration ou 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.
      • Prendre en charge 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’attribution 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 titulaire OAuth JWT.
      Cliquez sur Envoyer.
      Statut État du profil d'intégration. Les options disponibles 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 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 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 N° 8640000.
      ID client OAuth ID client que vous avez créé dans le compte administrateur ou développeur de l’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 Périmètres que vous avez activés pour votre application OAuth dans le compte administrateur ou développeur de l’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 méthode d’authentification différente, les champs disponibles sont déterminés par le modèle de configuration que vous avez créé.
    8. Cliquez sur Créer et accorder 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 Alias de connexion et d’informations d’identification. En cas d’échec de la connexion, 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 > Identifiants et supprimez l’enregistrement d’informations d’identification de 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 d’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.