Integrar o ThousandEyes com o token de chave de REST API

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura

    • Integre usando uma chave de API para estabelecer uma comunicação segura e automatizar a troca de dados via REST API. Isso simplifica a integração, permitindo o acesso contínuo aos serviços e aprimorando a eficiência operacional.

    Antes de Iniciar

    Função necessária: evt_mgmt_integration

    Procedimento

    1. Navegar até Tudo > Serviços web do sistema > Políticas de acesso de API > Chave de REST API.
      Navegação da REST API
    2. Selecione Novo.
    3. No formulário, preencha os campos.
      Nota:
      O usuário precisa ser criado com a função evt_mgmt_integration. Crie um novo na tabela sys_user para usar aqui para facilitar o acesso correto.
      Tabela 1. Chave de API
      Campo Descrição
      Nome Nome para identificar a chave de REST API
      Descrição Descrição da chave de REST API.
      Ativo Status da chave de REST API.
      Usuário Usuário associado à chave de REST API. Use o ícone de pesquisa para selecionar o usuário.
      Escopo de autenticação Opção para adicionar escopo de autenticação para gerenciar a autoridade da chave de REST API.
      Token A chave de REST API gerada. Copie a chave para usar como parte da chamada de REST API no Cabeçalho ou no Parâmetro de consulta.
      Vencimento Prazo após o qual a credencial não é mais válida. Um valor vazio significa que não há vencimento.
    4. Desbloqueie o escopo de autenticação e adicione: UserAccount.
    5. Use o menu formulário e selecione Salvar.

      O sistema gera um token e o salva no campo Token. Para ver o token, use o ícone de cadeado e copie a exibição de conteúdo abaixo do campo. Este é o valor do parâmetro de consulta (ou cabeçalho) quando o outro sistema envia uma solicitação de REST API para a ServiceNow.

      Token de REST API gerado no campo Token.

    Resultado

    Agora você está pronto para começar a enviar eventos. Em sua ferramenta de monitoramento, você pode enviar eventos com o cabeçalho ou o parâmetro de consulta: x-sn-apikey. Por exemplo: 
    https://[INSTANCENAME].service-now.com/api/sn_em_connector/em/inbound_event?source=[SOURCENAME]&sys_id=[SYSID OF PUSH CONNECTOR INSTANCE]&x-sn-apikey=[AUTH TOKEN]