Un webhook/servicehook entrante es una devolución de llamada (callback) definida por el usuario a través de HTTP. Puede usar los webhooks/servicehooks de DevOps para notificar a Fluid cuando ocurran ciertos eventos en DevOps. Por ejemplo, alertar a Fluid cuando se cree o elimine un elemento de trabajo. Su tablero de Fluid se mantiene actualizado sin necesidad de cargar nuevas tareas de forma masiva periódicamente, ni de integrar tareas manualmente.

Servicehook es la terminología de DevOps para un Webhook estándar de la industria; estos términos son iguales y pueden usarse indistintamente en este documento.

Por el momento, Fluid solo admite eventos CREATE y DELETE para tipos TASK de DevOps. Solo se admitirán los tipos TASK que haya configurado específicamente para la integración con su tablero de Fluid.

Debido a la complejidad que puede implicar DevOps, de forma predeterminada los servicehooks entrantes no están habilitados en sus instancias de cliente; comuníquese con su representante de Fluid Success, quien puede habilitar esta función y guiarlo durante el proceso de configuración.

Por motivos de seguridad, DevOps utiliza autenticación básica al enviar datos a Fluid. Este es el único protocolo de autenticación que admite DevOps. En cuanto a Fluid, usamos tokens PAT y validamos el nombre de usuario de la cuenta que enviará los eventos del webhook/servicehook entrante. Para obtener más información sobre los tokens PAT, consulte Creación de un token de acceso personal.

Para configurar el nombre de usuario de la cuenta que enviará mensajes a Fluid, siga los pasos que se indican a continuación.

- Haga clic en su perfil, en la parte superior derecha de Fluid, y seleccione "Consola de Administración"

Seleccione "Proveedores de Autenticación"

- Recorra la página y asegúrese de que la opción "Allow DevOps Incoming Webhook" que se muestra a continuación esté habilitada

Ingrese el nombre de usuario de la cuenta que enviará el token PAT para la autenticación. El nombre de usuario es el que está definido en "Gestión de usuarios" en Fluid. A continuación se muestra un ejemplo para el usuario David Burt, con el nombre de usuario david.burt

- Una vez completado, haga clic en Guardar.

La configuración del servicehook entrante de DevOps requiere indicarle a DevOps qué eventos enviar y cómo enviarlos a Fluid. Fluid cuenta con un endpoint HTTP Rest que se puede configurar dentro de DevOps.

Consulte este artículo para obtener información detallada sobre la configuración en DevOps. https://learn.microsoft.com/en-us/azure/devops/service-hooks/overview?view=azure-devops y https://learn.microsoft.com/en-us/azure/devops/service-hooks/troubleshoot?view=azure-devops

Registro de un servicehook a través de la consola de administración de DevOps. Asegúrese de que la cuenta con la que accede a DevOps tenga los privilegios de administrador correctos para configurar los servicehooks de DevOps.

- Vaya a la configuración de proyectos de DevOps 

 - Haga clic en + para crear un Servicehook

- Desplácese hasta el final, elija Web hooks en la navegación izquierda y haga clic en Next

- Elija "Work item created" en la lista desplegable Trigger on this type of event si desea generar eventos de creación hacia Fluid, o "Work item deleted" para generar eventos de eliminación.

Nota: por el momento solo se admiten los eventos Create y Delete

Opcionalmente, puede incluir filtros adicionales para controlar o limitar cuándo se generan estos eventos y se envían a Fluid. Debe intentar limitar estos eventos tanto como sea posible para cumplir con sus requisitos. Cada evento activará Fluid, por lo que solo deben incluirse los eventos que desee generar.

- Haga clic en Next

Esta es la Url a la que DevOps enviará información sobre el elemento que haya configurado. La Url es una Url específica de Fluid y se encargará de leer, validar y ejecutar el webhook cuando se reciba un mensaje.

Para encontrar la Url de su tablero, debe acceder a la configuración de integración del tablero de Fluid. Consulte el artículo Cómo configurar los tableros de DevOps para la integración para obtener más información.

Desplácese hacia abajo en la página de configuración de integración del tablero y busque la siguiente opción "Allow Incoming Webhooks from DevOps", al habilitar "Allow Incoming Webhooks from DevOps" aparecerá un cuadro de texto; esta es la Url que debe ingresar en el campo Url de DevOps mencionado anteriormente.

- Haga clic en el ícono de copiar al portapapeles a la derecha y péguelo en la interfaz de DevOps.

Nota informativa: los últimos 2 números de la Url son los identificadores de workspace/tablero respectivamente; representan el workspace (configuración) y el tablero exacto en el que desea que se cree la tarjeta (un workspace puede tener más de 1 tablero). En los ejemplos anteriores, 692 es el id del workspace (si hace clic en la página @ verá que es el mismo número en la url @). El 1108 es el tablero exacto de ese workspace. Si conoce el id del workspace y el id del tablero, puede construir esta url manualmente según sus necesidades.

Por motivos de seguridad, Fluid exige de forma opcional el uso de Basic Authentication al utilizar los Servicehooks de DevOps. Al usar la autenticación básica, configura una cuenta de Fluid que se utilizará para gestionar la solicitud entrante desde DevOps. Esta cuenta debe contar con los permisos necesarios de Fluid para crear o eliminar elementos en el tablero configurado.

- Ingrese el nombre de usuario de Fluid de la cuenta que se utilizará para gestionar esta solicitud desde DevOps.

Nota: este nombre de usuario debe ser el mismo que se configuró en la sección de proveedores de autenticación de Fluid de este documento. Si los nombres de usuario no coinciden, se devuelve un código HTTP 401, Unauthorized.

- Ingrese el token PAT del nombre de usuario de Fluid configurado anteriormente. Necesitará tener permisos de administrador para generar un token para una cuenta de Fluid diferente. Haga clic en su foto de perfil, en la parte superior derecha, y seleccione Gestión de usuarios

- Seleccione la cuenta que desea configurar con un token PAT

- Haga clic en "Generar token de acceso personal"

- Copie la cadena de contraseña en el cuadro de texto Basic Authentication Password.

- Puede dejar todos los demás campos con sus valores predeterminados

- Haga clic en Finish para completar este Servicehook.

Nota: deberá seguir los mismos pasos anteriores para crear un Servicehook para el evento Delete, pero elija "Work Item Deleted" al seleccionar el evento que activa el disparador.

- Una vez completado, verá una lista de los Servicehooks creados

• Creación de un token de acceso personal

• Cómo configurar la integración de Azure DevOps con los tableros de Fluid