Configurer Connecteur du graphe de services d'API pour Azure API Management à l’aide de SGC Central

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 5 minutes de lecture

    • Configurez des tâches d’importation planifiées pour extraire des Gestion des API Azure données dans votre CMDB.

    Avant de commencer

    Installez Connecteur du graphe de services d'API pour Azure API Management la version 1.0.0 ou ultérieure à partir de .ServiceNow Store Pour ServiceNow Store connaître les étapes d’installation, consultez Installer une application ServiceNow Store.
    Obtenez les informations d’identification OAuth auprès de votre Azure administrateur. Notez les détails suivants :
    • ID (client) de l'application
    • Secret client
    • ID (locataire) du répertoire
    • URL de connexion
    Rôle requis : la table suivante répertorie les rôles requis pour chaque étape du playbook.
    Tableau 1. Rôle requis pour chaque étape du playbook
    Étape Rôle
    Prérequis administrateur
    Configuration SGC-Admin (sn_cmdb_int_util.sgc_admin) ou administrateur
    Remarque :
    Le rôle d’utilisateur admin est nécessaire pour exécuter des scripts en arrière-plan et pour fournir un accès aux tables globales à l’utilisateur SGC-Admin. Pour en savoir plus sur les rôles d’utilisateur de , reportez-vous à Connecteurs du graphe de services la section Rôles d'utilisateur Connecteur du graphe de services.

    Pourquoi et quand exécuter cette tâche

    L’expérience de playbook pour les connecteurs d’intégration est activée SGC Central avec le Espace de travail CMDB. Pour configurer l’application, consultez et pour en savoir plus sur l’interaction avec un playbook, consultez Configurer SGC CentralInteragir avec unSGC Central playbook.

    Remarque :
    Vous pouvez également configurer une connexion par défaut déjà disponible à partir des connexions installées ou brouillon dans .SGC Central Accéder à Tous > Connecteurs du graphe de services, puis sélectionnez Configuration pour le connecteur dans le menu. Pour en savoir plus sur les connexions installées et brouillon, reportez-vous à la section Gestion des connexions ajouté pour Connecteurs du graphe de services dans SGC Central.

    Procédure

    1. Accédez à la Espaces de travail > Espace de travail CMDB.
    2. Dans le Espace de travail CMDB, sélectionnez SGC Central.
    3. Sur la page Vue d’ensemble, sélectionnez Créer une connexion.
      Conseil :
      Vous pouvez également sélectionner Créer une connexion sur la page Toutes les connexions.
    4. Dans la fenêtre Créer une connexion, sélectionnez le type de Gestion des API Azure connecteur, puis sélectionnez Créer une connexion.
    5. Remplissez les prérequis initiaux lors de la configuration d’une connexion pour la première fois à l’aide d’un connecteur.
      Remarque :
      Cette étape n’est requise que lors de la première configuration. Consultez Effectuer les tâches de configuration initiale lors de la création d’une connexion dans SGC Central.
    6. Saisissez les détails de la connexion et testez la connexion de l’API pour l’importation de Gestion des API Azure données.
      1. À l’étape Configuration du playbook, sélectionnez l’activité Créer et tester la connexion .
      2. Remplissez les champs du formulaire.
        Tableau 2. Formulaire Créer et tester la connexion
        Champ Description
        Nom de connexion à Gestion des API Azure Nom permettant d’identifier l’enregistrement de Gestion des API Azure connexion.

        Par exemple, Connexion à Gestion des API Azure.
        URL de connexion URL de base pour se connecter au Gestion des API Azure service.
        Remarque :
        Ce champ est automatiquement défini sur l’URL de connexion à l’application. Laissez la valeur du champ telle quelle.
        ID client OAuth ID (client) de votre Azure application cliente, comme indiqué dans la section Avant de commencer .
        Secret client OAuth Secret client de votre Azure application cliente, comme indiqué dans la section Avant de commencer .
        URL du jeton OAuth URL du jeton de votre Azure application cliente.
        En fonction de la région de votre Azure application cliente, entrez l’URL du jeton dans l’un des formats suivants :
        • Global 
          https://login.microsoftonline.com/<tenantid>/oauth2/v2.0/token
        • Gouvernement des États-Unis
          https://login.microsoftonline.us/<tenantid>/oauth2/v2.0/token
        • Chine
          https://login.partner.microsoftonline.cn/<tenantid>/oauth2/v2.0/token
        • Allemagne
          https://login.microsoftonline.de/<tenantid>/oauth2/v2.0/token
        Où <tenantid> correspond à l’ID de locataire de votre Azure application cliente, comme indiqué dans la section Avant de commencer .
      3. Sélectionnez Créer et tester la connexion.
      4. Une fois le test de connexion terminé, sélectionnez Continuer.
    7. Facultatif : Définissez les propriétés de configuration pour la connexion.
      Remarque :
      Pour ignorer cette étape, sélectionnez Continuer pour l’activité Définir les propriétés de configuration .
      1. À l’étape Setup (Configuration ) du playbook, sélectionnez l’activité Set configuration properties (Définir les propriétés de configuration ).
      2. Renseignez les détails de la propriété.
        Tableau 3. Propriétés de configuration de Gestion des API Azure
        Propriété Description
        Connexion à la gestion d'API Azure
        Périmètre de Découverte Périmètre de découverte de l’application Azure cliente. Les options disponibles sont les suivantes :
        Groupe de gestion
        Sélectionnez Groupe d’administration lorsque le compte de ServiceNow service a accès aux données au sein du groupe d’administration Azure .
        Abonnement
        Sélectionnez Abonnement lorsque le compte de ServiceNow service a accès aux données de l’abonnement Azure uniquement.
        Abonnement
        ID d’abonnement ID d’abonnement des Gestion des API Azure services.

        Pour plusieurs ID d’abonnement, séparez-les par des virgules. Si le périmètre de découverte est défini sur Abonnement et que ce champ est laissé vide, tous les abonnements pour le locataire spécifié dans les informations d’identification sont détectés.
        Groupe de gestion
        ID de groupe de gestion ID des Gestion des API Azure groupes de gestion des services.

        Pour plusieurs groupes de gestion, séparez-les par des virgules.
        Obtenir des abonnements de groupes imbriqués Option permettant d’activer la récupération des données de tous les abonnements enfants imbriqués lorsque le groupe d’administration est défini comme périmètre de détection.

        Désactivez la propriété permettant d’exclure les abonnements enfants imbriqués.
        Configuration exclusive facultative
        ExcludeServices Gestion des API Azure Services qui doivent être exclus de la connexion.

        Pour plusieurs services, séparez-les par des virgules. Toutes les passerelles, à l’exception de celles répertoriées dans la ExcludeServices propriété, sont récupérées.
        Groupes de ressources Nom des services du groupe de Gestion des API Azure ressources.

        Pour plusieurs groupes de ressources, séparez leurs noms par des virgules. Si vous laissez ce champ vide, les sources de données du connecteur importent des données à partir de tous les groupes de ressources disponibles.
        Configuration des données d’utilisation
        CollectUsageData (en anglais seulement) option permettant d’activer la collecte des données d’utilisation pour récupérer les données d’utilisation de l’API sur une durée spécifiée.
      3. Sélectionnez Continuer.
    8. Configurez le calendrier d’importation pour importer des données à intervalles réguliers.
      1. À l’étape Setup (Configuration ) du playbook, sélectionnez l’activité Configure import schedule (Configurer le calendrier d’importation ).
      2. Développez l’importation de données planifiée parente dans la liste Importer les calendriers pour sélectionner le calendrier d’importation des services Gestion des API associé à votre connexion.
        Remarque :
        Le nom de la connexion est précédé du nom du calendrier.
      3. Dans la boîte de dialogue Configurer le calendrier d’importation , cochez la case Actif , puis renseignez les détails du calendrier et de l’heure d’exécution.

        Pour plus d'informations, consultez Schedule a data import.

      4. Sélectionnez Enregistrer.
        Vous pouvez également sélectionner Exécuter maintenant pour exécuter le calendrier d’importation immédiatement.
      5. Sélectionnez Continuer.
    9. À l’étape Configuration du playbook, sélectionnez l’activité Confirmer la création de la connexion pour vérifier si la connexion a été créée.

    Que faire ensuite

    Sélectionnez Afficher toutes les connexions pour examiner les détails de la connexion. La connexion créée apparaît dans la liste Connexions installées.

    Vous pouvez ensuite gérer les connexions à partir de la SGC Central vue du Espace de travail CMDB. Pour plus d'informations, consultez Gestion des connexions ajouté pour Connecteurs du graphe de services dans SGC Central.