Configuração de Conector de APIs do Service Graph para AWS API Gateway 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 AWS API Gateway no seu CMDB.

    Antes de Iniciar

    Instale a Conector de APIs do Service Graph para AWS API Gateway versão 1.0.0 ou posterior do ServiceNow Store. Para ServiceNow Storeetapas de instalação, consulte Instale uma aplicação da ServiceNow Store .

    O mecanismo de autenticação usado pelo conector é Tipo de Assinatura da AWS (Técnica de Autenticação HMAC) com o token AWS STS (Security Token Service). Para obter informações sobre permissões, consulte Gateway de API do Conector do Service Graph para AWS - Instruções de configuração [KB1962734] artigo no Now Support Base de conhecimento.

    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 .

    Nota:
    Como alternativa, você pode configurar uma conexão padrão já disponível nas conexões instaladas ou de rascunho em Central do SGC. Ir para Tudo > Conectores do Service Graphe selecione Configuração para o conector no menu. Para saber mais sobre conexões instaladas e de rascunho, consulte Gerenciamento de conexões adicionadas para Conectores do Service Graph em Central do SGC.

    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. 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.
    5. Insira os detalhes da conexão e teste a conexão da API para importar dados do AWS API Gateway.
      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 do Gateway de API da AWS Nome para identificar o registro de conexão AWS API Gateway.

        Por exemplo, conexão SG-AWS-API-Gateway.
        Chave de acesso ID da chave de acesso do usuário do IAM com permissões para interagir com os recursos da AWS.
        Chave Secreta Chave de acesso secreta que corresponde ao ID da chave de acesso necessária para autenticar a conexão com segurança.
      3. Selecione Criar e testar conexão.
      4. Depois de concluir o teste de conexão, selecione Continuar.
    6. Opcional: Copiar propriedades de configuração de um existente AWS conexão.
      Nota:
      . Copiar propriedades de configuração a atividade é exibida somente quando um AWS a conexão já está configurada em sua instância.
      1. Em Configuração fase do playbook, selecione Copiar propriedades de configuração atividade.
      2. Em Conexão da AWS , selecione a conexão.
        Os valores das propriedades a seguir são copiados do selecionado AWS conexão:
        • ID da conta autônoma
        • ID da conta de gestão
        • GovCloud
        • STS assume a função
        • Regiões da AWS
        • Nome do agregador de configuração
        • Conta do agregador de configuração
        • Região do agregador de configuração
      3. Selecione Continuar.
      4. Depois de concluir o teste de conexão, selecione Continuar.
    7. Defina as propriedades de configuração da conexão.
      1. Na etapa Configuração do playbook, selecione a atividade Definir propriedades de configuração.
      2. Preencha os detalhes da propriedade.
        Nota:
        Se você optar por copiar as propriedades de configuração de um existente AWS conexão, as propriedades listadas na etapa 6.bsão copiados da conexão existente automaticamente.
        Tabela 2. AWS API Gateway propriedades de configuração
        Propriedade Descrição
        ID da conta de gestão ou ID da conta autônoma
        ID da conta de gestão ID da conta de gestão associada ao AWS API Gateway conta.
        ID da conta autônoma ID de uma conta de membro associada ao AWS API Gateway conta.
        Nome da função assumida do STS e regiões da AWS
        Nome da função assumida do STS O nome da função presumida do STS da AWS conta usado para consultar a API da Função presumida do STS para obter as credenciais da API.
        Regiões da AWS Lista de regiões separadas por vírgulas onde o AWS API Gateway reside.
        Definição do agregador de configuração
        ID da conta do agregador de configuração ID da conta da AWS em que o tipo de recurso do agregador no serviço de configuração da AWS foi configurado.
        Nome do agregador de configuração Nome do tipo de recurso do agregador no serviço de configuração da AWS.
        Região do agregador de configuração Região onde reside o tipo de recurso do agregador.
        Dados de uso de API
        CollectUsageData Opção para habilitar a coleta de dados de uso para recuperar dados de uso da API por uma duração especificada.
        Período de coleta em dias Duração em dias para coletar dados de uso da API.
        Configuração da nuvem do governo
        É nuvem do governo? Opção para indicar que a configuração da conexão é para o AWS GovCloud.
      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 REST de API gerenciada 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 configurada.

    O que Fazer Depois

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