Um webhook/servicehook de entrada é um callback definido pelo usuário via HTTP. Você pode usar webhooks/servicehooks do DevOps para notificar o Fluid quando determinados eventos ocorrem no DevOps. Por exemplo, alertar o Fluid quando um item de trabalho é criado ou excluído. Seu quadro Fluid é mantido atualizado sem que você precise fazer uploads em massa periódicos de novas tarefas ou integrar tarefas manualmente.

Servicehook é a terminologia do DevOps para um Webhook padrão da indústria; esses termos são iguais e podem ser usados de forma intercambiável neste documento.

O Fluid suporta eventos de CRIAÇÃO e EXCLUSÃO apenas para tipos de TAREFA do DevOps no momento. Apenas os tipos de TAREFA que você configurou especificamente para o seu quadro Fluid para integração serão suportados.

Devido à complexidade que pode estar envolvida com o DevOps, por padrão, os servicehooks de entrada não estão habilitados nas instâncias do seu cliente. Entre em contato com seu representante de Sucesso do Fluid, que pode habilitar esse recurso e orientá-lo durante o processo de configuração.

Por segurança, o DevOps usa autenticação básica ao enviar dados para o Fluid. Este é o único protocolo de autenticação suportado pelo DevOps. Com relação ao Fluid, usamos tokens PAT e validamos o nome de usuário da conta que enviará os eventos de webhook/servicehook de entrada. Para saber mais sobre tokens PAT, consulte Criando um Token de Acesso Pessoal.

Para configurar o nome de usuário da conta que enviará mensagens ao Fluid, siga os passos abaixo.

- Clique no seu perfil no canto superior direito do Fluid e selecione "Administration Console"

Selecione "Authentication Providers"

- Navegue pela página e certifique-se de que a opção abaixo "Allow DevOps Incoming Webhook" está habilitada

Insira o nome de usuário da conta que enviará o token PAT para autenticação. O nome de usuário conforme definido em "User management" no Fluid. Abaixo está um exemplo para o usuário David Burt, com nome de usuário david.burt

- Quando concluído, clique em Salvar.

A configuração do servicehook de entrada do DevOps requer configuração para informar ao DevOps quais eventos e como enviar esses eventos ao Fluid. O Fluid possui um endpoint HTTP Rest que pode ser configurado no DevOps.

Consulte este artigo para configuração detalhada no DevOps. https://learn.microsoft.com/en-us/azure/devops/service-hooks/overview?view=azure-devops e https://learn.microsoft.com/en-us/azure/devops/service-hooks/troubleshoot?view=azure-devops

Registrando um servicehook via console de administração do DevOps. Certifique-se de que a conta com a qual você está acessando o DevOps possui os privilégios de administrador corretos para configurar servicehooks do DevOps.

- Acesse as configurações de projetos do DevOps 

 - Clique em + Para criar um Servicehook

- Role até o final e escolha Web hooks na navegação à esquerda e clique em Avançar

- Escolha "Work item created" na lista suspensa Acionar neste tipo de evento se quiser gerar eventos de criação para o Fluid, ou "Work item deleted" para que eventos de exclusão sejam gerados.

Nota: No momento, apenas eventos de Criação e Exclusão são suportados

Você pode opcionalmente incluir filtros adicionais para controlar/limitar quando esses eventos são gerados e enviados ao Fluid. Você deve tentar limitar esses eventos ao máximo possível para atender aos seus requisitos. Cada evento acionará o Fluid, portanto, apenas os eventos que você deseja gerar devem ser incluídos.

- Clique em Avançar

Esta é a URL que o DevOps usará para enviar informações sobre o item que você configurou. A URL é uma URL específica do Fluid e irá ler, validar e executar a ação do webhook quando uma mensagem for recebida.

Para encontrar a URL do seu quadro, você precisa acessar a configuração de integração do Quadro Fluid. Consulte o artigo Como configurar quadros do DevOps para integração para mais informações.

Role para baixo na página de configuração do quadro de integração e encontre a configuração abaixo "Allow Incoming Webhooks from DevOps", habilite "Allow Incoming Webhooks from DevOps" e uma caixa de texto aparecerá; esta é a URL que você deve inserir no campo de URL do DevOps acima.

- Clique no ícone de copiar para a área de transferência à direita e cole na interface do DevOps.

Informação: Os últimos 2 números da URL são os identificadores do workspace/quadro respectivamente; eles representam o workspace (config) e o quadro exato no qual você deseja que o cartão seja criado (workspaces podem ter mais de 1 quadro). Nos exemplos acima, 692 é o id do workspace (se você clicar na página @ verá que este é o mesmo número na URL @). O 1108 é o quadro exato para este workspace. Se você conhece o id do workspace e o id do quadro, pode construir esta URL manualmente para atender às suas necessidades.

Por razões de segurança, o Fluid impõe o requisito opcional de Autenticação Básica ao usar Servicehooks do DevOps. Ao usar autenticação básica, você configura uma Conta Fluid que será usada para lidar com a solicitação de entrada do DevOps. Esta conta precisa ter as permissões Fluid pré-requisitadas para Criar/Excluir Itens no quadro configurado.

- Insira o nome de usuário Fluid da conta que será usada para lidar com esta solicitação do DevOps.

Nota: Este nome de usuário precisa ser o mesmo nome de usuário que foi configurado na seção de provedores de autenticação do Fluid neste documento. Se os nomes de usuário não forem iguais, um código HTTP 401, Não Autorizado será retornado.

- Insira o token PAT para o nome de usuário Fluid configurado acima. Você precisará ter permissão de administrador para gerar um token para uma conta Fluid diferente. Clique na foto do seu perfil no canto superior direito e selecione Gerenciamento de Usuários

- Selecione a conta que deseja configurar com um token PAT

- Clique em "Generate Personal Access Token"

- Copie a string de senha na caixa de texto Senha da Autenticação Básica.

- Você pode deixar todos os campos restantes com seus valores padrão

- Clique em Concluir para finalizar este Servicehook.

Nota: Você precisará seguir os mesmos passos acima para criar um Servicehook para o evento de Exclusão, mas escolha "Work Item Deleted" ao selecionar o evento de acionamento.

- Após concluído, você verá uma lista dos Servicehooks criados

• Criando um Token de Acesso Pessoal

• Como configurar a integração do Azure DevOps com o Fluid Boards