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

# Microsoft Azure Key Vault

> Conecta Azure Key Vault a Iru Compliance mediante OAuth para recopilar metadatos de almacenes, claves, secretos y certificados para auditorías sin exponer los valores secretos reales.

### Acerca de Microsoft Azure Key Vault

La fuente **Microsoft Azure Key Vault** lee la **configuración de los almacenes** y los **metadatos** de claves, secretos y certificados mediante **Azure Resource Manager**. **Iru no lee valores secretos, material de claves ni claves privadas**; solo recopila nombres, atributos, caducidad, configuración de acceso y campos similares que expone la API de administración.

Iru se autentica con **OAuth 2.0 delegado** (Microsoft Entra ID) como el usuario que completa el asistente. Todo lo que ese usuario no pueda leer en Azure no aparecerá en Iru.

### Cómo funciona

Iru usa el **flujo de código de autorización de OAuth 2.0** de Microsoft contra **Azure Resource Manager**. El ámbito solicitado es:

`https://management.azure.com/user_impersonation`

| Detalle | Valor |
| - | - |
| **Categoría** | Herramientas para desarrolladores |
| **Autenticación** | OAuth 2.0 (Microsoft Entra ID, Azure Resource Manager) |
| **Plan del proveedor** | Cualquier suscripción de Azure que tenga recursos de Key Vault |

#### Qué recopila Iru

| Tipo de datos | Notas |
| - | - |
| Configuración del almacén de claves | Nombre, ubicación, SKU (standard o premium), eliminación temporal, protección de purga |
| Claves (metadatos) | Identificadores, operaciones permitidas, estado habilitado, caducidad (**no** el material de las claves) |
| Secretos (metadatos) | Nombres, tipo de contenido, estado habilitado, caducidad (**no** los valores secretos) |
| Certificados (metadatos) | Identificadores, emisor, validez (**no** las claves privadas) |
| Directivas de acceso / RBAC | Qué principales tienen qué permisos en cada almacén |

Iru **no** modifica almacenes, objetos ni directivas de acceso.

Referencias oficiales: [Documentación de Azure Key Vault](https://learn.microsoft.com/azure/key-vault/), [API REST de Key Vault](https://learn.microsoft.com/rest/api/keyvault/), [Guía de RBAC de Key Vault](https://learn.microsoft.com/azure/key-vault/general/rbac-guide), [Roles integrados de seguridad](https://learn.microsoft.com/azure/role-based-access-control/built-in-roles/security).

### Requisitos previos

* Inicio de sesión de **Microsoft Entra ID** en el [portal de Azure](https://portal.azure.com).
* El rol integrado **Key Vault Reader** (recomendado) o **Reader**, asignado en el ámbito de la **suscripción** para obtener la cobertura más amplia de los almacenes, o en el ámbito de almacenes individuales si limitas la visibilidad de forma intencionada. **Key Vault Reader** incluye la lectura de los almacenes y de los metadatos de claves, secretos y certificados **sin** acceso a los secretos ni al material de las claves.
* **Ventanas emergentes** del navegador permitidas para que el asistente del conector pueda abrirse cuando habilites la fuente.

Confirma el acceso: **Subscriptions** → tu suscripción → **Access control (IAM)** → **View my access**.

Ejemplo de asignación de rol (sustituye los marcadores de posición):

```bash theme={null}
az role assignment create \
  --assignee <your-user-principal-name> \
  --role "Key Vault Reader" \
  --scope /subscriptions/<subscription-id>
```

### Conectar Microsoft Azure Key Vault a Iru

Usa primero **Microsoft Azure** para confirmar el acceso al portal y la cobertura de **Key Vault Reader** (o **Reader**) y, a continuación, completa OAuth en **Iru Compliance**. El asistente muestra **Step 1 of 1: Perform OAuth Authentication**.

<Tabs>
  <Tab title="Microsoft Azure">
    <Note>
      Completa esta pestaña antes de iniciar OAuth en **Iru Compliance**.
    </Note>

    <Steps>
      <Step title="Inicia sesión en el portal de Azure">
        Abre [portal.azure.com](https://portal.azure.com) e inicia sesión con la cuenta que usarás en el asistente de Iru.
      </Step>

      <Step title="Abre la suscripción de destino">
        Busca **Subscriptions** y abre la suscripción que contiene (o de la que dependen) los **Key Vaults** que Iru debe leer.
      </Step>

      <Step title="Verifica el acceso Key Vault Reader o Reader">
        Abre **Access control (IAM)** → **View my access**. Confirma que tienes **Key Vault Reader** en almacenes específicos o **Reader** en el ámbito de la suscripción, según **Requisitos previos**.
      </Step>

      <Step title="Permite ventanas emergentes en el navegador">
        Permite las **ventanas emergentes** para el nombre de host de **Iru** para que pueda abrirse la ventana de consentimiento de Microsoft.
      </Step>

      <Step title="Prepara el tenant correcto de Microsoft Entra ID">
        Si usas varios tenants, usa una sesión limpia del navegador para que OAuth inicie sesión en el tenant **de trabajo** propietario de los almacenes.
      </Step>
    </Steps>

    <Note>
      Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Primero completa la pestaña [**Microsoft Azure**](#microsoft-azure).
    </Note>

    <Steps>
      <Step title="Abre Sources">
        En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Navegación izquierda: Compliance expandido, Sources seleccionado" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Activa la integración">
        Busca **Microsoft Azure Key Vault** (establece **Categoría** en **Developer tools** o usa **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor** para iniciar el asistente del conector.
      </Step>

      <Step title="Inicia OAuth e inicia sesión">
        Selecciona **Launch OAuth Authentication**. Cuando se abra la ventana de Microsoft, inicia sesión con la misma cuenta que verificaste en el portal de Azure y selecciona **Accept** en la pantalla de consentimiento.
      </Step>

      <Step title="Finaliza la conexión">
        Cuando la ventana de OAuth se cierra e Iru completa el intercambio, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirma que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos**, luego vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta de **Microsoft Azure Key Vault** está **Activo**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Solución de problemas

<AccordionGroup>
  <Accordion title="No se abre nada al activar la fuente">
    Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
  </Accordion>

  <Accordion title="Lista de almacenes vacía o errores 403">
    Es posible que la cuenta que inició sesión no tenga **Key Vault Reader** o **Reader** en la suscripción o en los almacenes. Verifica las asignaciones de **IAM** (consulta **Requisitos previos**).
  </Accordion>

  <Accordion title="Tenant de Microsoft Entra incorrecto">
    **Cierra la sesión** en la ventana emergente de Microsoft e inicia sesión con la cuenta del tenant **correcto**.
  </Accordion>

  <Accordion title="Estado Broken">
    **Desactiva** y **activa** **Microsoft Azure Key Vault** en **Fuentes** y, a continuación, vuelve a completar OAuth.
  </Accordion>
</AccordionGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Gestión de fuentes" icon="plug" href="/es/compliance/sources-management">
    Explora y gestiona todas las fuentes de Compliance.
  </Card>

  <Card title="Introducción a Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

  <Card title="Descripción general de Iru" icon="layer-group" href="/es/iru/platform-overview/iru-overview">
    Cómo encajan Endpoint, Compliance e Identity.
  </Card>

  <Card title="Gestión de artefactos" icon="folder-open" href="/es/compliance/artifacts-management">
    Sube, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>