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

# Databricks

> Conecta Databricks a Iru Compliance con una URL de espacio de trabajo y un token de acceso de solo lectura para recopilar el inventario de usuarios y grupos, los permisos del espacio de trabajo, la configuración de seguridad de los clústeres y los controles de acceso de los ámbitos de secretos.

### Acerca de Databricks

Iru lee **usuarios y grupos**, **permisos del espacio de trabajo**, **configuraciones de clústeres**, **ámbitos de secretos** y **permisos de Unity Catalog** (donde se use Unity Catalog) desde la API REST de Databricks. La autenticación usa un token **Bearer**: un **token de acceso personal** creado en **User Settings** → **Developer** → **Access tokens**, o un token de **entidad de servicio**. Las solicitudes se dirigen al host de tu espacio de trabajo, por lo que Iru almacena primero la **URL del espacio de trabajo** y, a continuación, el token.

### Cómo funciona

```http theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

Databricks funciona **por espacio de trabajo**: cada espacio de trabajo tiene su propio host (por ejemplo, `https://dbc-1234abcd-5e6f.cloud.databricks.com` en AWS o `https://adb-1234567890.12.azuredatabricks.net` en Azure) y sus propios tokens. Un token solo es válido para el espacio de trabajo que lo emitió, así que conecta una fuente por cada espacio de trabajo del que necesites evidencia. Iru lee los **nombres de los ámbitos de secretos y sus listas de control de acceso**. No lee los **valores de los secretos**.

| Detalle | Valor |
| - | - |
| **Categoría** | Análisis |
| **Autenticación** | Bearer (token de acceso) |

Referencias oficiales: [Referencia de la API REST](https://docs.databricks.com/api/workspace/introduction), [Autenticación](https://docs.databricks.com/aws/en/dev-tools/auth/).

### Requisitos previos

* La **URL de tu espacio de trabajo**, copiada del navegador con la sesión iniciada en el espacio de trabajo.
* Acceso de **administrador del espacio de trabajo**. La creación de tokens puede estar restringida por la configuración del espacio de trabajo, y un token que no sea de administrador solo devuelve los permisos y clústeres que esa cuenta ya puede ver.
* Tokens de acceso personal **habilitados** para el espacio de trabajo. Si los administradores los han deshabilitado, usa una **entidad de servicio** en su lugar.
* Decide qué está dentro del alcance. Databricks te permite excluir espacios de trabajo o ámbitos de secretos, y los objetos excluidos no generan evidencia.

### Conectar Databricks a Iru

<Tabs>
  <Tab title="Databricks">
    <Note>
      Completa esta pestaña antes de conectar la fuente en Compliance.
    </Note>

    <Steps>
      <Step title="Iniciar sesión en el espacio de trabajo">
        Inicia sesión en el espacio de trabajo de Databricks que quieres que Iru lea, con una cuenta que tenga el rol de **admin**.
      </Step>

      <Step title="Abrir Settings">
        Selecciona tu **nombre de usuario** en la barra superior y, a continuación, **Configuración**.
      </Step>

      <Step title="Abrir Access tokens">
        Ve a **Developer** y, a continuación, selecciona **Gestionar** junto a **Access tokens**.
      </Step>

      <Step title="Generar un nuevo token">
        Selecciona **Generate new token**.
      </Step>

      <Step title="Asignar un nombre y establecer la vigencia">
        Introduce un **Comentario** como **Iru Compliance** y establece un **Lifetime** que tu equipo pueda controlar. La recopilación se detiene cuando un token caduca. Si dejas la vigencia en blanco, se crea un token que no caduca, lo que algunas políticas de seguridad no permiten.
      </Step>

      <Step title="Copiar el token y la URL del espacio de trabajo">
        Selecciona **Generar** y, a continuación, copia el valor del token **una sola vez** mientras Databricks lo muestra. Copia la **URL del espacio de trabajo** de la barra de direcciones del navegador (solo el esquema y el host, sin ruta final).
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      Termina primero la pestaña [**Databricks**](#databricks).
    </Note>

    <Steps>
      <Step title="Abrir 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="Activar Databricks">
        Busca **Databricks** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Introducir la URL del espacio de trabajo">
        Introduce la **URL del espacio de trabajo**. Confirma la URL de vista previa si el asistente muestra una.
      </Step>

      <Step title="Pegar el token Bearer">
        Pega el token en el campo **Bearer**.
      </Step>

      <Step title="Finalizar la conexión">
        Selecciona **Enviar credenciales**. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirmar que la fuente está activa">
        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 **Databricks** 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="La autenticación falla">
    Confirma que el token se creó en el **mismo espacio de trabajo** que la URL que introdujiste. Los tokens no se pueden usar entre espacios de trabajo.
  </Accordion>

  <Accordion title="La creación de tokens no está disponible en Settings">
    Un administrador del espacio de trabajo ha deshabilitado los tokens de acceso personal. Vuelve a habilitarlos o autentícate con una **entidad de servicio**.
  </Accordion>

  <Accordion title="Aparecen usuarios y clústeres, pero los permisos parecen incompletos">
    El token pertenece a una cuenta que no es de administrador y solo devuelve lo que esa cuenta puede ver. Vuelve a crearlo desde un administrador del espacio de trabajo.
  </Accordion>

  <Accordion title="No hay datos de Unity Catalog">
    Es lo esperado si el espacio de trabajo no usa Unity Catalog. Iru solo recopila datos de Unity Catalog cuando está presente.
  </Accordion>

  <Accordion title="La recopilación funcionó y luego se detuvo">
    El **Lifetime** del token ha transcurrido. Genera uno nuevo y vuelve a conectar.
  </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>
