Configuração de Conector de APIs do Service Graph para Gerenciamento de API do Azure usando Central do SGC

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura

    • Configure trabalhos de importação agendada para inserir dados Gerenciamento de API do Azure no seu CMDB.

    Antes de Iniciar

    Instale a Conector de APIs do Service Graph para Gerenciamento de API do Azure versão 1.0.0 ou posterior do ServiceNow Store. Para ServiceNow Storeetapas de instalação, consulte Instale uma aplicação da ServiceNow Store .
    Obtenha as credenciais do OAuth do administrador Azure. Anote os seguintes detalhes:
    • ID da aplicação (cliente)
    • Segredo do Cliente
    • ID do diretório (locatário)
    • URL de conexão

    Função necessária: cmdb_inst_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    O Playbook Experience para conectores de integração é ativado com Central do SGC em Espaço do CMDB. Para configurar o. Central do SGC aplicação, consulte Configuração da Central do SGC e para obter mais informações sobre como interagir com um playbook, consulte Interaja com o Playbook .

    Procedimento

    1. Navegar até Espaços > Espaço do CMDB.
    2. No Espaço do CMDB, selecione Central do SGC.
    3. Na página "Visão geral", selecione Criar conexão.
      Dica:
      Outra opção é selecionar Criar conexão na página "Todas as conexões".
    4. Na janela Criar conexão, selecione o tipo de conector Gerenciamento de API do Azure e selecione Criar conexão.
    5. Conclua os pré-requisitos iniciais ao configurar uma conexão pela primeira vez usando um conector.
      Nota:
      Esta etapa é necessária somente durante a primeira configuração. Consulte Execute tarefas de configuração inicial ao criar uma conexão no Central do SGC.
    6. Insira os detalhes da conexão e teste a conexão da API para importar dados do Gerenciamento de API do Azure.
      1. Na etapa Configuração do playbook, selecione a atividade Criar e testar conexão.
      2. No formulário, preencha os campos.
        Tabela 1. Formulário "Criar e testar conexão"
        Campo Descrição
        Nome da conexão de gerenciamento de API do Azure Nome para identificar o registro de conexão Gerenciamento de API do Azure.

        Por exemplo, Conexão de gerenciamento de API do Azure.
        URL de conexão URL base para se conectar ao serviço Gerenciamento de API do Azure.
        Nota:
        Este campo é definido automaticamente como o URL para se conectar à aplicação. Deixe o valor do campo como está.
        ID do cliente do OAuth ID da aplicação (cliente) do seu Azure aplicação cliente conforme observado em Antes de começar seção.
        Segredo do cliente do OAuth Segredo do cliente da sua aplicação cliente do Azure, conforme observado na seção Antes de começar.
        URL do token Oauth URL do token da sua aplicação cliente do Azure.
        Com base na região da sua aplicação cliente Azure, insira o URL do token em um dos seguintes formatos:
        • Global 
          https://login.microsoftonline.com/<tenantid>/oauth2/v2.0/token
        • Governo dos EUA
          https://login.microsoftonline.us/<tenantid>/oauth2/v2.0/token
        • China
          https://login.partner.microsoftonline.cn/<tenantid>/oauth2/v2.0/token
        • Alemanha
          https://login.microsoftonline.de/<tenantid>/oauth2/v2.0/token
        Onde <tenantid> é o ID do locatário da sua aplicação cliente do Azure, conforme observado na seção Antes de começar.
      3. Selecione Criar e testar conexão.
      4. Depois de concluir o teste de conexão, selecione Continuar.
    7. Opcional: Defina as propriedades de configuração da conexão.
      Nota:
      Para ignorar essa etapa, selecione Continuarna atividade Definir propriedades de configuração.
      1. Na etapa Configuração do playbook, selecione a atividade Definir propriedades de configuração.
      2. Preencha os detalhes da propriedade.
        Tabela 2. Propriedades de configuração da Gestão de API do Azure
        Propriedade Descrição
        Conexão da gestão de APIs Azure
        Escopo da Descoberta Escopo da Descoberta do Azure aplicação cliente. As opções disponíveis são:
        Grupo de gestão
        Selecione Grupo de gestão . ServiceNow a conta de serviço tem acesso aos dados em Azure grupo de gestão.
        Assinatura
        Selecione Assinatura . ServiceNow a conta de serviço tem acesso aos dados em Azure assinatura somente.
        Assinatura
        IDs de assinatura IDs de assinatura de Gerenciamento de API do Azure serviços .

        Para vários IDs de assinatura, separe-os com vírgulas. Se o escopo da descoberta estiver definido como Assinatura e este campo for deixado em branco, todas as assinaturas do locatário especificado nas credenciais serão descobertas.
        Grupo de gestão
        ID(s) do grupo de gestão IDs do grupo de gestão de Gerenciamento de API do Azure serviços .

        Para vários grupos de gestão, separe-os com vírgulas.
        Obter assinaturas de grupo aninhado Opção para habilitar a recuperação de dados de todas as assinaturas secundárias aninhadas quando Grupo de gestão está definido como o escopo da descoberta.

        Desabilite a propriedade para excluir assinaturas secundárias aninhadas.
        Configuração exclusiva opcional
        ExcludeServices Gerenciamento de API do Azure serviços que devem ser excluídos da conexão.

        Caso haja vários serviços, separe-os por vírgulas. Todos os gateways, exceto os listados na propriedade ExcludeServices, são extraídos.
        ResourceGroups Nome do grupo de recursos dos Gerenciamento de API do Azure serviços.

        Caso haja vários grupos de recursos, separe os nomes por vírgulas. Se você deixar este campo em branco, as fontes de dados no conector importarão dados de todos os grupos de recursos disponíveis.
        Configuração de dados de uso
        CollectUsageData Opção para habilitar a coleta de dados de uso para recuperar dados de uso da API por uma duração especificada.
      3. Selecione Continuar.
    8. Configure o cronograma de importação para importar dados em intervalos regulares.
      1. Na fase Configuração do playbook, selecione a atividade Configurar cronograma de importação.
      2. Expanda a importação de dados programada primária na lista Cronogramas de importação para selecionar Serviços de gestão de API programação de importação associada à sua conexão.
        Nota:
        O nome da conexão é prefixado ao nome da programação.
      3. Em Configurar programação de importação caixa de diálogo, selecione Ativo e preencha a programação de execução e os detalhes de tempo.

        Para obter mais informações, consulte Schedule a data import.

      4. Selecione Save (Salvar).
        Como alternativa, selecione Executar agora para executar a programação de importação imediatamente.
      5. Selecione Continuar.
    9. Em Configuração fase do playbook, selecione Confirme a criação da conexão atividade para verificar se a conexão foi criada.

    O que Fazer Depois

    Selecione Exibir todas as conexões para analisar os detalhes da conexão. A conexão criada é exibida na lista de Conexões instaladas.