Configurer API Connecteur du graphe de services pour Gestion des API Azure à l’aide de SGC Central

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 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

    Installez API Connecteur du graphe de services pour Gestion des API Azure la version 1.0.0 ou ultérieure à partir du ServiceNow Store. Pour connaître les étapes d'installation de ServiceNow Store, 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 : admin

    Pourquoi et quand exécuter cette tâche

    L’expérience de playbook pour les connecteurs d’intégration est activée avec SGC Central .Espace de travail CMDB Pour plus d’informations sur l’interaction avec un playbook, consultez Interagir avec le playbook.

    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 conditions préalables initiales lors de la première configuration d’une connexion à l’aide d’un connecteur.
      Remarque :
      Cette étape n’est nécessaire 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 des Gestion des API Azure données.
      1. À l’étape Configuration du playbook, sélectionnez l’activité Créer et tester la connexion .
      2. Renseignez les champs du formulaire.
        Tableau 1. 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 pour se connecter à 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 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
        Où <tenantid> est 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 Configuration du playbook, sélectionnez l’activité Définir les propriétés de configuration .
      2. Renseignez les détails de la propriété.
        Tableau 2. Propriétés de configuration de Gestion des API Azure
        Propriété Description
        Connexion à Gestion des 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’abonnements 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.
        Groupe de gestion
        ID de groupe(s) de gestion ID des groupes de gestion des Gestion des API Azure services.

        Pour plusieurs groupes d’administration, séparez-les par des virgules.
        Obtenir des abonnements de groupe 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 en option
        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.
        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.
        Configuration des données d’utilisation
        CollectUsageData (en anglais seulement) Option permettant d’activer la collecte de 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 Configuration du playbook, sélectionnez l’activité Configurer le calendrier d’importation .
      2. Développez l’importation de données planifiée parente dans la liste Calendriers d’importation pour sélectionner le calendrier d’importation des services de gestion des API SGA Azure 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 immédiatement le calendrier d’importation.
      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.