Skip to main content

Acerca de Microsoft Azure DevOps

Iru lee proyectos, repositorios, directivas de rama, pull requests, pipelines de compilación y versión, usuarios y grupos, conexiones de servicio y eventos del registro de auditoría desde la API REST de Azure DevOps. La autenticación es OAuth 2.0 delegada a través de Microsoft Entra ID, con el mismo asistente Launch OAuth Authentication que las demás fuentes de Microsoft Azure. Inicias sesión con una cuenta de trabajo. Iru no solicita un token de acceso personal. La recopilación se limita a las organizaciones y los proyectos que esa cuenta ya puede ver. Se recopilan los nombres de las variables de los pipelines; los valores secretos no.

Cómo funciona

Iru usa el flujo de código de autorización de OAuth 2.0 de Microsoft contra Azure DevOps. Después de iniciar sesión y dar tu consentimiento en la ventana emergente, Iru recibe un token de acceso de corta duración y lo renueva automáticamente. Los ámbitos solicitados siguen el modelo de permisos de Azure DevOps (acceso de lectura como vso.code, vso.build, vso.release, vso.graph y vso.audit_log). No crees ni pegues un token de acceso personal. El asistente no lo aceptará. Referencias oficiales: Descripción general de la API REST, Autorizar el acceso a las API REST con OAuth 2.0.

Requisitos previos

  • Una cuenta de Microsoft Entra ID que pueda iniciar sesión en la organización de Azure DevOps que quieres que Iru lea (contoso de https://dev.azure.com/contoso).
  • Visibilidad de todos los proyectos que quieres que Iru lea. OAuth es delegado, por lo que Iru hereda el acceso a proyectos de esa cuenta. Una cuenta que no puede ver un proyecto no devuelve nada de él.
  • Ventanas emergentes del navegador permitidas para el sitio de Iru, para que se pueda abrir la pantalla de consentimiento de Microsoft. Decide el alcance de los proyectos: si las directivas de rama quedan fuera del alcance, Iru no puede verificar los controles de revisión de código o de aprobación.

Conectar Microsoft Azure DevOps a Iru

Completa esta pestaña antes de conectar la fuente en Compliance.
1

Inicia sesión en Azure DevOps

Inicia sesión en https://dev.azure.com/{your-organization} con la cuenta de Microsoft Entra ID que usarás en el asistente de Iru (el mismo tenant y la misma organización que quieres que Iru lea).
2

Confirma el acceso a los proyectos

Confirma que puedes abrir todos los proyectos del alcance. Iru solo puede recopilar lo que esta cuenta ya puede ver.
3

Permite ventanas emergentes en el navegador

Permite las ventanas emergentes para el nombre de host de Iru para que la pantalla de consentimiento de Microsoft pueda abrirse desde el asistente del conector.
4

Ten en cuenta los problemas con varios tenants

Si tu empresa usa varios tenants de Microsoft Entra ID, cierra la sesión de las cuentas personales de Microsoft en el mismo perfil del navegador, o usa una ventana privada, para que la ventana emergente de OAuth elija la cuenta de trabajo correcta.
5

No crees un token de acceso personal

Iru se autentica con OAuth 2.0. No pegues un PAT en el asistente.
Continúa en la pestaña Iru Compliance.

Solución de problemas

Revisa la configuración del bloqueador de ventanas emergentes para el sitio de Iru e inténtalo de nuevo.
Revisa la configuración del bloqueador de ventanas emergentes y, a continuación, inicia sesión con la cuenta de trabajo del tenant correcto de Microsoft Entra ID.
La cuenta que inicia sesión no tiene acceso de lectura a esos objetos. Inicia sesión con una cuenta que pueda ver todos los proyectos del alcance, o pide a un administrador que conceda ese acceso y vuelve a conectar.
La cuenta que completó OAuth no puede ver ese proyecto. Vuelve a conectar con una cuenta que tenga acceso a todos los proyectos del alcance.
Los tokens de acceso se renuevan mientras la conexión está activa. Si la actualización se interrumpe, desactiva y activa la fuente y, a continuación, vuelve a completar OAuth. No se trata de la caducidad de un PAT. Iru no usa un token de acceso personal para esta fuente.

Artículos relacionados

Gestión de fuentes

Explora y gestiona todas las fuentes de Compliance.

Introducción a Compliance

Marcos, acciones y Artefactos.

Descripción general de Iru

Cómo encajan Endpoint, Compliance e Identity.

Gestión de artefactos

Sube, revisa y organiza la evidencia de fuentes y acciones.