> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AWS CodeCommit
> Conecta AWS CodeCommit a Iru Compliance con un rol de IAM entre cuentas para recopilar el inventario de repositorios, la protección de ramas y el historial de solicitudes de extracción.
### Acerca de AWS CodeCommit
**CodeCommit** es **regional**, por lo que Iru recorre las regiones habilitadas. Adjunta **`AWSCodeCommitReadOnly`**, que incluye **`codecommit:GitPull`**, **`BatchGet*`**, **`Describe*`**, **`Get*`**, **`List*`** y la evaluación de aprobaciones de solicitudes de extracción. Si los repositorios usan una clave de **KMS administrada por el cliente**, añade **`kms:Decrypt`** para el ARN de esa clave.
### Cómo funciona
Iru se ejecuta en su propia cuenta de AWS. Para leer los repositorios de **CodeCommit** y los metadatos relacionados en tu cuenta, creas un **rol de IAM** que Iru puede **asumir** mediante **`sts:AssumeRole`**, protegido por el **External ID** del asistente, con permisos de solo lectura **`codecommit:`** (por ejemplo, **`AWSCodeCommitReadOnly`** o el JSON en línea de la pestaña [**AWS**](#aws)). A continuación, pegas el **ARN** del rol de vuelta en Iru.
| Detalle | Valor |
| - | - |
| **Categoría** | Herramientas para desarrolladores |
| **Autenticación** | Rol de IAM entre cuentas |
### Requisitos previos
* Permisos de IAM para **crear roles**.
* Al menos un repositorio de CodeCommit del que esperes obtener evidencia.
### Conectar AWS CodeCommit a Iru
Empieza aquí: abre el asistente de la fuente y copia la **política de confianza** (y anota el **ID externo**). Cuando estés listo para crear el rol en AWS, cambia a la pestaña [**AWS**](#aws) y sigue [**Crear el rol de IAM en AWS**](#create-the-iam-role-in-aws). Cuando tengas el **Role ARN**, vuelve a la pestaña [**Iru Compliance**](#iru-compliance) y completa [**Enviar el ARN del rol en Iru**](#submit-the-role-arn-in-iru) a continuación.
#### Obtener la política de confianza de Iru
En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.
Busca **AWS CodeCommit** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor**. Deja abierta la pestaña del asistente **Iru está solicitando acceso a servicios externos**.
El asistente muestra el JSON de la **política de confianza** que debe usar tu rol de IAM (**Principal** y **sts:ExternalId**). A continuación se muestra un **ejemplo** de la estructura; **copia el JSON activo de tu asistente** para que la cuenta, el ARN del principal y el ID externo coincidan exactamente.
```json copy=false lines theme={null}
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::753695775620:role/IruConnect"
},
"Condition": {
"StringEquals": {
"sts:ExternalId": "YOUR_EXTERNAL_ID"
}
},
"Action": "sts:AssumeRole"
}
]
}
```
Mantén abierta la pestaña del asistente de Iru como referencia y, a continuación, cambia a la pestaña [**AWS**](#aws) y sigue [**Crear el rol de IAM en AWS**](#create-the-iam-role-in-aws).
#### Enviar el ARN del rol en Iru
Termina primero la pestaña [**AWS**](#aws) (hasta [**Crear el rol de IAM en AWS**](#create-the-iam-role-in-aws)) para tener el **Role ARN** del nuevo rol.
Vuelve a la pestaña del asistente de Iru. Pega el **Role ARN** donde el conector lo solicite.
Selecciona **Submit Role**. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos** y, a continuación, vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta de **AWS CodeCommit** está **Activo**.
Completa [**Obtener la política de confianza de Iru**](#get-the-trust-policy-from-iru) en la pestaña [**Iru Compliance**](#iru-compliance) antes de crear este rol. Usa el **ID externo** y la política de confianza del asistente activo cuando configures **Trusted entity**.
#### Crear el rol de IAM en AWS
Abre **IAM** → **Roles** → **Create role**.
Elige **AWS account** → **Another AWS account**. Introduce **`753695775620`** (o el ID que muestre Iru). Habilita **Require external ID** y pega el ID externo de Iru.
Adjunta **`AWSCodeCommitReadOnly`**.
Si los repositorios usan una clave de KMS administrada por el cliente, añade una **política en línea** (sustituye **REGION**, **ACCOUNT**, **CMK-ID**):
```json lines theme={null}
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["kms:Decrypt"],
"Resource": "arn:aws:kms:REGION:ACCOUNT:key/CMK-ID"
}
]
}
```
Asigna un nombre al rol, créalo y copia el **Role ARN**. Vuelve a la pestaña [**Iru Compliance**](#iru-compliance) y completa [**Enviar el ARN del rol en Iru**](#submit-the-role-arn-in-iru).
Confirma que **Trust relationships** coincide con el JSON del asistente.
Continúa en la pestaña [**Iru Compliance**](#iru-compliance) para pegar el **Role ARN** y finalizar el asistente ([**Enviar el ARN del rol en Iru**](#submit-the-role-arn-in-iru)).
### Solución de problemas
Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
Añade **`kms:Decrypt`** para la CMK de ese repositorio.
Confirma que la **región** que usas en AWS coincide con la ubicación de los repositorios.
El ID externo no coincide.
### Consideraciones
Se anunció el **fin del acceso para nuevos clientes** de CodeCommit en **julio de 2024**: planifica las migraciones y retira esta fuente cuando se trasladen los repositorios.
### Artículos relacionados
Explora y gestiona todas las fuentes de Compliance.
Marcos, acciones y **Artefactos**.
Cómo encajan Endpoint, Compliance e Identity.
Sube, revisa y organiza la evidencia de fuentes y acciones.