Criação de webhooks para enviar eventos de entrada para a Velocidade de mudança do DevOps usando token

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

    • Você deve criar webhooks para enviar eventos de entrada para a Velocidade de mudança do DevOps usando autenticação baseada em token.

    Para enviar eventos de entrada para uma instância da ServiceNow, você deve usar a seguinte estrutura de endpoint de API: 
    <instance_url>/api/sn_devops/v2/devops/tool/{capability}?toolId=<toolId>
    em que a capacidade pode ser plano, código ou orquestração.

    Você pode copiar os detalhes, como ID da ferramenta, URL da instância e assim por diante, selecionando Configurar manualmente no registro da ferramenta ou na etapa de configuração ao integrar a ferramenta. Você pode selecionar Cópia no campo apropriado para copiar o valor para a área de transferência. O rótulo do campo muda para Copiado , mas você pode copiar várias vezes. A imagem a seguir exibe a página de onde os valores podem ser copiados para a ferramenta GitHub na Velocidade de mudança do DevOps. GitHub Configurar webhooks manualmente

    Para autenticação de token, você deve passar o token como parte do cabeçalho de autorização ou dos parâmetros de consulta conforme os endpoints são protegidos. É possível usar um dos seguintes métodos:
    • Passe o token como um cabeçalho usando o seguinte formato: Nome do cabeçalho: Valor do cabeçalho de autorização: sn_devops.DevOpsToken <ToolId>:<Token> , Em que <ToolId> é o ID da ferramenta e <Token> é o token de autenticação copiado da página de registro da ferramenta.
    • Passe o token como um parâmetro de consulta no URL: Sn_devops/v2/devops/tool/_capability? ToolId: ToolId: <toolId>&ni.nolog.token=<Token> <instance_url> , Em que <ToolId> é o ID da ferramenta e <Token> é o token de autenticação copiado da página de registro da ferramenta.

    Para autenticação básica, você pode usar o seguinte endpoint V1: https://user:password@<instance_url>/api/sn_devops/v1/devops/tool/capability? ToolId: <toolId> Substitua usuário e senha por suas credenciais da ServiceNow.

    Se você tiver uma ferramenta personalizada ou um método de autenticação diferente, poderá implementar sua própria lógica de autenticação. Por exemplo, você pode implementar uma função authenticateToken em sua classe de manipulador. A função deve verificar o token e garantir a autenticação adequada. Você deve ter a função de administrador na ServiceNow para implementar sua própria lógica de autenticação.