Azure DevOps

1

Generar un token de acceso personal de Azure DevOps

Accede a tu cuenta de Azure DevOps y genera un token de acceso personal (PAT) con permisos tanto de lectura como de escritura.

2

Integrar el token con Corgea

Ve a la página Integraciones de Corgea. Haz clic en el botón ”+” de Azure DevOps y guarda el token de forma segura.

3

Localizar proyectos de Azure DevOps en Corgea

Tras completar la configuración, ve a la página Proyectos. Los proyectos de Azure DevOps se muestran con un icono de Windows. Haz clic en el ”+” de la columna de acciones para iniciar el primer escaneo. También puedes seleccionar el nombre del proyecto y hacer clic en “Nuevo escaneo”.

4

Enviar una pull request a Azure DevOps

Desde la página de cualquier hallazgo asociado a un proyecto de Azure DevOps, puedes crear una pull request para corregirlo.

​

Opcional: configurar webhooks

1

Selecciona “Configuración del proyecto” situada en la parte inferior izquierda de la interfaz de Azure DevOps.

2

Haz clic en “Service Hooks”. Si no se carga de inmediato, puede que tengas que intentarlo varias veces.

3

Haz clic en el botón ”+” y elige “Web Hooks”.

4

Selecciona “Pull request creada” como evento de activación, ajusta las opciones que necesites y haz clic en “Siguiente”.

5

En la sección de Configuración, introduce la URL como https://www.corgea.app/azure_webhook/ o https://your_instance.corgea.app/azure_webhook/ para despliegues privados.

6

Abre una nueva pestaña del navegador, accede a la página de integraciones de Corgea y localiza tu integración con Azure. Copia el valor X-CORGEA-UUID.

7

Vuelve a la página de configuración de Azure DevOps Webhook y rellena la sección de cabeceras con:

• X-CORGEA-UUID: (valor UUID que copiaste)
• X-WEB-TOKEN: (legado/opcional; incluir solo si tu infraestructura externa lo requiere)

8

Haz clic en “Finalizar” para guardar la configuración. Ignora el botón “Probar” porque podría intentar activar escaneos para archivos a los que no tienes acceso.

9

Repite los mismos pasos para añadir un segundo webhook con “Pull request updated” como evento de activación. Usa la misma URL y cabeceras que el primer webhook.

10

Valida la configuración mediante la creación o actualización de una pull request. Si todo funciona, el historial del webhook mostrará un evento correcto y se iniciará un escaneo en la página de Escaneos de Corgea: https://www.corgea.app/scans/.

​

Habilitar respuestas a comentarios de pull requests de Azure DevOps

​

Requisitos previos

• Corgea Agent está habilitado para tu organización.
• Azure DevOps está conectado a Corgea.
• El PAT de la integración tiene el permiso Code: Read & write.
• Puedes crear suscripciones de Service Hooks en el proyecto de Azure DevOps.

​

Configurar Service Hooks

1. En Azure DevOps, abre tu proyecto.
2. Ve a Project settings -> Service hooks.
3. Selecciona Create subscription o +.
4. Elige Web Hooks, luego selecciona Next.
5. Selecciona Pull request commented on como desencadenador.
6. Si lo deseas, limita el Service Hook a un repositorio o una rama de destino.
7. Introduce la URL del webhook:
   • Nube de Corgea: https://www.corgea.app/azure_webhook/
   • Despliegue privado: https://<your-corgea-domain>/azure_webhook/
8. Añade esta cabecera HTTP: X-CORGEA-UUID: <your Azure DevOps integration UUID> El UUID está disponible en la página de Integraciones de Corgea.
9. Establece Resource details to send en All.
10. Prueba la suscripción y luego selecciona Finish.

​

Verifica la integración

1. Abre una pull request que contenga un hallazgo de Corgea.
2. Responde directamente a un comentario de Corgea, o dirígete a Corgea en el comentario.
3. Confirma que:
   • La entrega tiene éxito bajo Project settings -> Service hooks.
   • Corgea publica su respuesta en el mismo hilo de comentarios.

​

Resolución de problemas

• Confirma que el Service Hook está habilitado y utiliza Pull request commented on.
• Confirma que X-CORGEA-UUID coincida con la integración de Corgea correspondiente.
• Asegúrate de que Resource details to send esté establecido en All.
• Comprueba que el PAT de Azure DevOps no haya caducado y tenga acceso Code: Read & write.
• Confirma que el Corgea Agent está habilitado para la organización.