Configurer API Connecteur du graphe de services pour Gestion des API Azure à l’aide de la configuration guidée

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 10 minutes de lecture
  • Configurez des tâches d’importation planifiée pour extraire Gestion des API Azure des données dans votre CMDB.

    Avant de commencer

    Important :
    À moins de problèmes, utilisez la vue, car la méthode de configuration guidée va être déconseillée SGC Central . Si une connexion est configurée à l’aide de la configuration guidée, la connexion peut ne pas apparaître dans la SGC Central vue.
    Dépendances et exigences :
    • L’application du magasin Integration Commons for CMDB, qui est automatiquement installée. Voir Éléments communs d’intégration pour CMDB.
    • L’application de stockage des modèles de classe CI CMDB, qui est automatiquement installée. Consultez Modèles de classe CI CMDB.
    • Le module d’extension ITOM Découverte License (com.snc.itom.discovery.license). Vous devez activer ce module d’extension.
    • Module d’extension Gestion des licences ITOM (com.snc.itom.license). Consultez Request Discovery.
    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 : admin

    Procédure

    1. Vérifiez que le périmètre de l’application est défini sur l’application API Connecteur du graphe de services pour Gestion des API Azure à l’aide du sélecteur d’application.
      Pour plus d’informations, voir Sélecteur d’application.
    2. Accédez à la Tout > Connecteurs du graphe de services > Gestion d'API Azure > Configuration.
    3. Sur la API Connecteur du graphe de services pour Gestion des API Azure page, vérifiez que l’option de démarrage rapide est sélectionnée, puis sélectionnez Continuer.
    4. Configurez les informations d’identification de l’authentification pour envoyer des demandes à l’application Gestion des API Azure .
      1. Dans la section Configurer la connexion et les informations d’identification de la API Connecteur du graphe de services pour Gestion des API Azure page, sélectionnez Démarrer.
      2. Configurez la connexion.
        1. Sélectionnez la tâche Configurer les informations d’identification d’authentification Azure .
        2. Sélectionnez Cliquer ici pour ouvrir la page Connexions dans un onglet de navigateur distinct.
        3. Recherchez et sélectionnez Modifier pour Connexion à Gestion des API Azure.
        4. Dans la section Informations de connexion de la fenêtre Modifier la connexion, renseignez les champs.
          Tableau 1. Information de connexion
          Champ Description
          Nom de connexion Gestion des API Azure Nom permettant d’identifier l’enregistrement de Gestion des API Azure connexion.

          Gestion des API Azure Connexion est le nom d’alias d’informations d’identification par défaut. Vous pouvez ajouter plusieurs instances Gestion des API Azure . Toutefois, essayez de ne pas modifier le nom de connexion par défaut.

          URL de connexion URL de base pour se connecter au Gestion des API Azure service.
          En fonction de la région de votre Azure application cliente, entrez l’URL dans l’un des formats suivants :
          • Global
            https://management.azure.com
          • Gouvernement des États-Unis
            htttps://management.usgovcloudapi.net
          • Chine
            https://management.chinacloudapi.cn
          • Allemagne
            https://management.microsoftazure.de/
        5. Renseignez les champs de la section Informations d’identification de la fenêtre Modifier la connexion.
          Tableau 2. Informations d'identification
          Champ Description
          ID client OAuth ID (client) de votre application cliente Azure, 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 de 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
          <tenantid> est l’ID de locataire de votre Azure application cliente, comme indiqué dans la section Avant de commencer .
        6. Sélectionnez Modifier et obtenir le jeton OAuth.
        7. Sélectionnez Mettre à jour.
        8. Une fois le flux de jetons OAuth terminé, revenez à la page de configuration guidée et définissez la tâche Configurer les informations d’identification d’authentification Azure comme terminée en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
      3. Configurez une connexion pour gérer les Azure ressources via Gestion des API Azure.
        1. Sélectionnez la tâche Configurer les propriétés .
        2. Dans la liste connexe Propriétés de connexion du graphe de services, entrez les valeurs de ces propriétés.
          Tableau 3. Connexion à Graphe de services : propriétés
          Propriété Description
          Période de collecte (jours) Durée en jours pour la collecte des données d’utilisation de l’API.
          CollectUsageData (en anglais seulement) Activez 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.
          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.
          Services d’exclusion 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.

          GetNestedGroupSubscriptions Activez 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éfinissez la propriété sur faux pour exclure les abonnements enfants imbriqués.

          ManagementGroupId ID des groupes de gestion des Gestion des API Azure services.

          Pour plusieurs groupes d’administration, séparez-les par des virgules.

          Taille de partition Taille de la partition pour Azure les API gérées si le chargement parallèle est activé.

          Accepte une valeur numérique supérieure à zéro. Si ce champ est vide, la valeur est automatiquement calculée.

          Groupes de ressources Nom du groupe de Gestion des API Azure ressources des services.

          Pour les groupes de ressources multiples, 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.

          SubscriptionId ID d’abonnements des Gestion des API Azure services.

          Pour plusieurs ID d’abonnement, séparez-les par des virgules. Si le périmètre de la détection 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.

          Conseil :
          Pour saisir une valeur de propriété, double-cliquez (ou utilisez le raccourci clavier) pour saisir une valeur dans la cellule Valeur de la propriété.
        3. Définissez la tâche Configurer les propriétés comme terminée en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
      4. Testez la connexion.
        1. Sélectionnez la tâche Test de la connexion .
        2. Pour tester la connexion, sélectionnez le lien connexe Test de la connexion .

          Le test de la connexion peut prendre quelques instants. La page est actualisée pour afficher les résultats des tests.

        3. Lorsque le champ État est défini sur Réussite, sélectionnez Mettre à jour.

          Si l’un des tests présente des erreurs, suivez les suggestions pour y remédier.

        4. Définissez la tâche Test de la connexion comme terminée en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
    5. Facultatif : Intégrez à plusieurs Gestion des API Azure instances.
      1. Dans la section Ajouter plusieurs instances de la API Connecteur du graphe de services pour Gestion des API Azure page, sélectionnez Démarrer.
      2. Activez la création de sources de données pour la nouvelle Gestion des API Azure connexion.
        1. Vérifiez que vous disposez des autorisations de modification pour la table Source de données [sys_data_source].
        2. Sélectionnez la tâche Mettre à jour l’accès à la source de données.
        3. Pour modifier l’enregistrement, sélectionnez le périmètre de l’application dans le sélecteur d’application.
        4. Dans la liste connexe Accès à l’application du formulaire Source de données qui s’ouvre dans un autre onglet, cochez les cases Peut créer, Peut mettre à jour et Peut supprimer .
        5. Sélectionnez Mettre à jour.
        6. Dans le sélecteur d’application, sélectionnez le périmètre de l’application Connecteur du graphe de services d’API pour Gestion des API Azure .
        7. Définissez la tâche Mettre à jour l’accès à la source de données comme terminée en sélectionnant la case à cocher Marquer comme terminé , puis sélectionnez Continuer.
      3. Activez la création d’une tâche d’importation planifiée pour la nouvelle Gestion des API Azure connexion.
        1. Assurez-vous de disposer des autorisations de modification pour la table Importation de données planifiée [scheduled_import_set].
        2. Sélectionnez la tâche Mettre à jour l’accès à Importation de données planifiée .
        3. Pour modifier l’enregistrement, sélectionnez le périmètre de l’application dans le sélecteur d’application.
        4. Dans la liste connexe Accès à l’application du formulaire Importation de données planifiée, cochez les cases Peut créer, Peut mettre à jour et Peut supprimer .
        5. Sélectionnez Mettre à jour.
        6. Dans le sélecteur d’application, sélectionnez le périmètre de l’application Connecteur du graphe de services d’API pour Gestion des API Azure .
        7. Définissez la tâche Mettre à jour l’accès à Importation de données planifiée sur terminée en sélectionnant la case à cocher Marquer comme terminé , puis sélectionnez Continuer.
      4. Videz le cache des tables Source de données [sys_data_source] et Importations de données planifiées [scheduled_import_set].
        1. Sélectionnez la tâche Effacer le cache des tables de source de données et d’importations de données planifiées .
        2. Pour modifier l’enregistrement, sélectionnez le périmètre de l’application dans le sélecteur d’application.
        3. Dans le champ Exécuter le script , entrez le code suivant :
          GlideTableManager.invalidateTable("sys_data_source");
          GlideCacheManager.flushTable("sys_data_source");
          GlideTableManager.invalidateTable("scheduled_import_set");
          GlideCacheManager.flushTable("scheduled_import_set");
          GlideTableManager.invalidateTable("sys_db_object");
          GlideCacheManager.flushTable("sys_db_object");
        4. Sélectionnez Exécuter le script.
        5. Dans le sélecteur d’application, sélectionnez le périmètre de l’application Connecteur du graphe de services d’API pour Gestion des API Azure .
        6. Définissez la tâche des tables Effacer le cache de la source de données et Importations de données planifiées sur terminer en sélectionnant Marquer comme terminé.
      5. Ajoutez une autre connexion pour la nouvelle Gestion des API Azure instance.
        1. Vérifiez que le périmètre de l’application est défini sur l’application Connecteur du graphe de services d’API pour Gestion des API Azure à l’aide du sélecteur d’application.
        2. Sélectionnez la tâche Ajouter une autre connexion , puis cliquez ici.
        3. Sur la page Connexions qui s’ouvre dans un autre onglet de navigateur, sélectionnez Ajouter une connexion.
        4. Dans la fenêtre Créer une connexion, renseignez les détails de connexion, d’informations d’identification et d’ID d’abonnement.
        5. Sélectionnez Créer et obtenir un jeton OAuth.
        6. Fermez la page Connexions et revenez à l’onglet de la page Configuration guidée.
        7. Définissez la tâche Ajouter une autre connexion à terminer en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
      6. Ajoutez des propriétés pour la nouvelle connexion.
        1. Vérifiez que le périmètre de l’application est défini sur l’application Connecteur du graphe de services d’API pour Gestion des API Azure à l’aide du sélecteur d’application.
        2. Sélectionnez la tâche Ajouter des propriétés aux nouvelles connexions .
        3. Dans la colonne Nom , sélectionnez le nom de la connexion que vous avez créé à l’étape 5.e.
        4. Dans la liste connexe Propriétés de connexion du graphe de services, entrez les valeurs de ces propriétés.

          Pour plus d’informations sur les propriétés, consultez 4.c.ii.

          Conseil :
          Pour saisir une valeur de propriété, double-cliquez (ou utilisez le raccourci clavier) pour saisir une valeur dans la cellule Valeur de la propriété.
        5. Définissez la tâche Ajouter des propriétés aux nouvelles connexions à terminer en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
      7. Testez la nouvelle connexion.
        1. Sélectionnez la tâche Tester les nouvelles connexions .
        2. Dans la colonne Nom , sélectionnez le nom de la connexion que vous avez créé à l’étape 5.e.
        3. Pour tester la connexion, sélectionnez le lien connexe Test de la connexion .

          Le test de la connexion peut prendre quelques instants. La page est actualisée pour afficher les résultats des tests.

        4. Lorsque le champ État est défini sur Réussite, sélectionnez Mettre à jour.

          Si l’un des tests présente des erreurs, suivez les suggestions pour y remédier.

        5. Définissez la tâche Test des nouvelles connexions à terminer en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
    6. Configurez la tâche planifiée pour l’importation de Gestion des API Azure données.
      1. Dans la section Configurer des tâches d’importation planifiée de la API Connecteur du graphe de services pour Gestion des API Azure page, sélectionnez Démarrer.
      2. Sélectionnez la tâche planifiée Services de gestion des API SGA Azure .
        Pour une configuration à instances multiples, sélectionnez l’importation planifiée créée avec la connexion dans l’étape 5.e.
      3. Sur le formulaire Importation de données planifiée, vérifiez les valeurs des champs.

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

      4. Cochez la case Actif pour activer la tâche planifiée.
      5. Dans le champ Exécuter , sélectionnez Périodiquement pour spécifier la fréquence d’exécution de la tâche.
      6. Sélectionnez Mettre à jour.
      7. Définissez la tâche Configurer des tâches d’importation planifiée à terminer en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
    7. Sur la API Connecteur du graphe de services pour Gestion des API Azure page, sélectionnez Terminé pour enregistrer vos changements.
    8. Dans la boîte de dialogue Terminer la configuration, sélectionnez Terminer pour terminer la configuration.
    9. Dans la zone de message qui s’affiche, sélectionnez Terminé.