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

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. 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 ver as etapas de instalação do ServiceNow Store, consulte Como instalar um aplicativo da loja da ServiceNow.
    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: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    O Playbook Experience para conectores de integração é ativado com o Central do SGC em Espaço do CMDB. Para obter mais informações sobre como interagir com um playbook, consulte Interagir com 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 configuração inicial. Consulte Executar 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) da sua aplicação cliente Azure, conforme observado na seção Antes de começar.
        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 de gestão de API do Azure
        Escopo da Descoberta Escopo de descoberta da aplicação cliente Azure. As opções disponíveis são:
        Grupo de gestão
        Selecione Grupo de gestão quando a conta de serviço ServiceNow tiver acesso aos dados dentro do grupo de gestão Azure.
        Assinatura
        Selecione Assinatura quando a conta de serviço ServiceNow tiver acesso aos dados somente na assinatura Azure.
        Assinatura
        ID(s) 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 de 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 gerenciamento, separe-os com vírgulas.
        Obter assinaturas de grupo aninhadas Opção para habilitar a recuperação de dados de todas as assinaturas secundárias aninhadas quando o Grupo de gestão estiver definido como o escopo de 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 ao longo de 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 a programação de importação dos Serviços de gestão de API do SGA Azure associada à sua conexão.
        Nota:
        O nome da conexão é prefixado ao nome da programação.
      3. Na caixa de diálogo Configurar programação de importação, marque a caixa de seleção 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. Na etapa Configuração do playbook, selecione a atividade Confirmar criação de conexão 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.