Skip to main content

​
Acerca de GitLab

El conector de GitLab lee los metadatos de proyectos, la pertenencia a grupos, la protección de ramas, la configuración de CI/CD y (cuando tu plan y tu token lo permiten) los eventos orientados a auditoría de tu grupo de GitLab.com o de tu instancia autoadministrada. Los datos aparecen como artefactos en Iru Compliance para asignarlos a acciones y controles. Iru envía las credenciales mediante el encabezado PRIVATE-TOKEN de GitLab, normalmente con un token de acceso personal para que las lecturas puedan abarcar los grupos y proyectos que elijas.

​
Cómo funciona

La API REST de GitLab se autentica con el encabezado PRIVATE-TOKEN:
Los tokens de acceso personal suelen ser la mejor opción porque pueden abarcar varios proyectos y grupos. Los tokens limitados a un proyecto o a un grupo funcionan, pero pueden restringir la evidencia que Iru puede recopilar. Documentación: Tokens de acceso personal, Autenticación de REST, Ámbitos de los tokens.

​
Requisitos previos

  • Acceso en GitLab a los grupos y proyectos que interesan al cumplimiento.
  • Propietario o Maintainer del grupo cuando necesites lecturas de pertenencia y de tipo auditoría (las necesidades exactas dependen de tus controles).
  • En GitLab autoadministrado, confirma que Iru apunte a la URL base de tu instancia (no solo a gitlab.com).
Punto de partida para los ámbitos Añade ámbitos solo cuando tu equipo de seguridad requiera lecturas más profundas.

​
Conectar GitLab a Iru

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

Inicia sesión en GitLab

Abre tu instancia de GitLab (gitlab.com o la URL autoadministrada) e inicia sesión con un usuario que pueda crear tokens de acceso personal para los espacios de nombres que Iru debe leer.
2

Abre tu perfil

Selecciona tu avatar en la esquina superior derecha y, a continuación, elige Edit profile (o Preferences en algunas versiones).
3

Abre Access Tokens

En la barra lateral izquierda de tu perfil, selecciona Access Tokens (a veces en User settings → Access Tokens).
4

Añade un token nuevo

Selecciona Add new token (o Create personal access token).
5

Establece el nombre, la caducidad y los ámbitos

Introduce un nombre (por ejemplo, Iru Compliance). Establece una caducidad (GitLab la exige; tu administrador puede limitar la duración máxima). Elige los ámbitos de lectura indicados en Requisitos previos de este artículo.
6

Crea y copia el token

Crea el token y cópialo de inmediato. GitLab solo lo muestra una vez. Los tokens suelen empezar por glpat-.
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.
Confirma la cadena completa del token, comprueba la caducidad y verifica que la cuenta siga teniendo acceso a los grupos de destino.
Amplía los ámbitos o eleva el rol del proyecto o grupo: tu token no puede leer endpoints a los que tu cuenta no tiene acceso.
Asegúrate de que la integración apunte al nombre de host de tu instancia y de que las rutas de red permitan las llamadas salientes de Iru.
Algunas API de auditoría requieren funciones Premium/Ultimate: compara tu nivel de GitLab con la evidencia que espera tu marco.

​
Consideraciones

Los tokens caducan según un calendario: rótalos con antelación y actualiza…

Los tokens caducan según un calendario: rótalos con antelación y actualiza el conector.

GitLab aplica límites de velocidad; los grupos grandes pueden tardar…

GitLab aplica límites de velocidad; los grupos grandes pueden tardar más durante la primera sincronización.

Iru lee la configuración expuesta por la API: no…

Iru lee la configuración expuesta por la API; no reescribe pipelines ni la configuración de los repositorios.

​
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.