Configurar um webhook bidirecional para o spoke do Jira

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

    • Configure um webhook para assinar Jira com um URL de retorno de chamada ServiceNow.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub
    • Ativar o Jira spoke
    • Função necessária: administrador

    Criar um token

    Crie um token para incorporar na URL do webhook Jira.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. No filtro[] navigat [] ion ,insira token_verification.list .
      O sistema exibe registros na tabela Verificações de token.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário de Verificação de token
      Campo Descrição
      Nome Nome exclusivo para identificar o token. Por exemplo, token do Jira.
      Descrição Descrição do token.
      Token Token de autenticação. Este token é criptografado e incorporado ao URL.

    Resultado

    O token foi criado para ser incorporado ao URL do webhook Jira.

    Registrar um Jira webhook em ServiceNow

    Registre um webhook [ Jira em ServiceNow para notificar o aplicativo ServiceNow quando determinados eventos ocorrerem em Jira.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Webhooks do Jira > Registros de webhook do Jira.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 2. Formulário de registro do Webhook do Jira
      Campo Descrição
      Nome Nome exclusivo para identificar o registro. Por exemplo, webhook do JIRA.
      Descrição Descrição do registro.
      Token Token de autenticação. Este token é criptografado e incorporado ao URL. Por exemplo, token do Jira.
      Caminho Jira caminho do webhook. Por padrão, este caminho é definido como api/sn_jira_spoke/jira_webhook_callbacks/wh_entry.
    4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    5. Clique em URL de retornode chamada .
      O sistema exibe a URL de allback webhook c.
    6. Copie e registre o webhook cURL de allback.

    Resultado

    O webhook Jira está registrado em sua instância ServiceNow.

    Adicionar uma URL de retorno de chamada no Jira

    Forneça um URL de retorno de chamada do webhook na suaJira conta do Atlassian para criar um webhook.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Faça login na sua Jira conta do Atlassian.
    2. Crie um webhook na sua conta da Atlassian.
    3. Insira a URL de retorno de chamada do webhook no campo URL .
      Consulte a documentação do portal Atlassian Developer para obter instruções sobre como criar um webhook.

    Resultado

    O URL de retorno de chamada é adicionado à sua Jira conta do Atlassian. Você pode criar políticas de roteamento e subfluxos de acordo com seus requisitos. Consulte Personalizar a webhook bidirecional para obter informações sobre a criação de novas políticas de roteamento e subfluxos.

    Personalizar a webhook bidirecional

    Crie uma política de roteamento de webhook e subfluxo de acordo com seus requisitos.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    A política de roteamento padrão no módulo Políticas de roteamento do WebHook do Jira aciona o subfluxo Processar Webhooks do Jira e notifica o aplicativo ServiceNow quando determinados eventos ocorrem em Jira. Consulte Jira Spoke para obter informações sobre os campos compatíveis com a política de roteamento padrão e os subfluxos. Para usar outros campos em seu subfluxo personalizado e personalizar as condições na política de roteamento, execute estas etapas.

    Procedimento

    1. Navegar até Todos > Flow Designer > Designer.
    2. Clique em Subfluxos.
    3. Crie uma cópia do subfluxo padrão, Processar Webhooks do Jira.
    4. Personalize o subfluxo de acordo com seus requisitos e publique-o. Consulte Criação de subfluxos para obter mais informações sobre como criar e usar subfluxos e Jira Spoke para obter informações sobre os campos compatíveis com a política de roteamento padrão e os subfluxos.
    5. Navegar até Webhooks do Jira > Políticas de roteamento do Jira WebHook.
    6. Clique em Nova.
    7. No formulário, preencha os campos.
      Tabela 3. Formulário de decisão
      Campo Descrição
      Rótulo Rótulo exclusivo para identificar a política de roteamento.
      Resposta padrão Opção para especificar se esta é a resposta padrão. A resposta padrão dé aplicável quando as condições não são atendidas.
      1. Clique no ícone de pesquisa ( ícone de pesquisa).
      2. Selecione o subfluxo necessário na lista Documento .
        Nota:
        Certifique-se de que o nome da tabela seja Fluxo [sys_hub_flow].
      Condição Condições a serem atendidas quando os eventos necessários ocorrerem em Jira. Confira Jira webhooks para obter informações sobre os campos compatíveis.
      Resposta Subfluxo que deve ser acionado quando as condições especificadas forem atendidas.
    8. Clique em Enviar.
      Nota:
      Essas políticas de roteamento são salvas nas tabelas de decisão. Os usuários são alertados para não atualizar ou modificar diretamente os dados dessas tabelas.

    Resultado

    A política de saída re o subfluxo foram criados.