Descoberta de gateway de API da AWS

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura

    • As aplicações ServiceNow Descoberta e Mapeamento de serviços podem encontrar gateways de API da AWS e conexões com outras entidades. A descoberta de alguns desses recursos requer a atualização da aplicação  Padrões de descoberta e mapeamento de serviços a partir da ServiceNow Store.

    Descoberta e Mapeamento de serviços usam o padrão Amazon AWS API Gateway para executar a descoberta horizontal e de cima para baixo.

    Você pode usar esse padrão na plataforma ServiceNow usando a versão Kingston ou posterior.

    Solicitar aplicativos na Store

    Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.

    Pré-requisitos

    Conta de serviço da AWS com credenciais
    Em Now Platform®, configure a conta de serviço com o seguinte:
    • Um ID de conta, que é o ID da conta da Amazon ao qual o Gateway de API pertence. Use o ID da conta como ele aparece no Console de Gestão da AWS. Você pode executar a descoberta a partir do formulário de conta de serviço.
    • As credenciais adequadas da AWS necessárias para que o ID da conta alcance a nuvem da AWS.

    Consulte Contas de serviço para Descoberta e Mapeamento de serviços na documentação do produto.

    Conjunto de atualizações
    Se sua instância estiver nas versões Jakarta ou Istanbul, importe o conjunto de atualizações fornecido em KB0679927: Conjunto de atualizações de descoberta de cima para baixo do AWS Lambda. Este conjunto de atualizações é necessário para Mapeamento de serviços.
    Acesso de usuário
    No Console da AWS, forneça a um usuário permissões para executar a função apigateway:GET apenas para a ação GET no Gateway de API.

    Dados coletados pelo Descoberta durante a descoberta horizontal

    Tabela e campo Informações adicionais
    Cloud Gateway [cmdb_ci_cloud_gateway]
    ID do objeto O ID do gateway.
    Descrição resumida A descrição resumida do gateway.
    Nome DNS [cmdb_ci_dns_name]
    Nome O nome ou endereço IP exclusivo do host DNS.
    Endereço IP O endereço IP do host DNS.
    Endpoint de nome de recurso da AWS [cmdb_ci_endpoint_arn]
    Host O nome do host ou endereço IP do endpoint.
    ARN O ID (nome de recurso da Amazon) de outras entidades da AWS às quais o gateway se conecta.

    Relacionamentos de item de configuração (IC)

    Esses relacionamentos são criados para oferecer suporte à descoberta do Gateway de API da AWS:
    IC Relacionamento IC
    Gateway de Nuvem

    [cmdb_ci_cloud_gateway]

    		 Uses:Used by Nome DNS

    [cmdb_ci_dns_name]
    Hosted on:Hosts Datacenter da AWS [cmdb_ci_aws_datacenter]

    O datacenter da AWS tem relacionamentos com outros ICs da AWS, como zonas de disponibilidade, contas de serviço e assim por diante. Consulte AWS e Azure Cloud Discovery na documentação do produto para obter detalhes adicionais.

    Conexões descobertas pelo Mapeamento de serviços durante a descoberta de cima para baixo

    Mapeamento de serviços executa a descoberta de cima para baixo dos Gateways de API da AWS no contexto de serviços de aplicações. Ele descobre conexões de saída dos Gateways de API da AWS:
    • AWS Lambda
    • Link do VPC para nuvem privada virtual
    • Endpoint HTTP definido como a URL configurada no Gateway de API

    Solução de problemas

    Se o processo de mapeamento não prosseguir conforme o esperado, siga as sugestões a seguir.
    Sintoma Causa Solução
    A Descoberta falha. A mensagem de descoberta contém as informações sobre um erro causado pelo tempo limite de REST. Há muitos ICs enviando a resposta da chamada REST na implantação. O MID Server não pode processar a resposta da chamada REST sem exceder o limite de tempo controlado pelo parâmetro mid.sa.cloud.request_timeout. Por padrão, o parâmetro mid.sa.cloud.request_timeout é definido como 30000 milissegundos.
    Aumente o valor deste parâmetro no relevante MID Server e execute a descoberta novamente.
    Nota:
    Se a lista relacionada Parâmetros de configuração para o MID Server relevante não mostrar este parâmetro, talvez seja necessário adicioná-lo.
    O Designer de padrões falha durante uma sessão de depuração. A mensagem do Designer de padrões contém informações sobre um erro causado por um tempo limite. O Designer de padrões falha devido a um tempo limite durante a depuração de padrão (e não durante a descoberta). Por padrão, o parâmetro sa.debugger.max_timeout é definido como 240 segundos.

    Aumente o valor desse parâmetro no MID Server relevante.