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

# Bitbucket Cloud

> Conecta Bitbucket Cloud a Iru Compliance con un token de API de Atlassian mediante autenticación HTTP Basic para recopilar evidencia de espacios de trabajo, repositorios y revisiones de solicitudes de incorporación de cambios.

### Acerca de Bitbucket Cloud

El conector de **Bitbucket Cloud** recopila los metadatos de **repositorios**, **espacios de trabajo**, **proyectos** y **equipos** que tus auditorías esperan en torno a la gestión de cambios y las revisiones de acceso. Iru se autentica con **HTTP Basic Auth**: el **correo electrónico de tu cuenta de Atlassian** como nombre de usuario y un **token de API de Atlassian** como contraseña (las contraseñas simples se rechazan).

### Cómo funciona

Los clientes envían credenciales codificadas en Base64:

```http theme={null}
Authorization: Basic base64(email:api_token)
```

Atlassian está **retirando las contraseñas de aplicación**: crea **tokens de API** para el trabajo nuevo y migra todo lo que aún use secretos heredados antes de que dejen de funcionar.

| Detalle | Valor |
| - | - |
| **Categoría** | Herramientas para desarrolladores |
| **Autenticación** | Autenticación Basic (correo electrónico + token de API) |

Documentación: [Gestionar tokens de API](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/), [Tokens de API de Bitbucket](https://support.atlassian.com/bitbucket-cloud/docs/create-an-api-token/), [Introducción a REST](https://developer.atlassian.com/cloud/bitbucket/rest/intro/).

### Requisitos previos

* Acceso a los **espacios de trabajo** de Bitbucket de los que esperas obtener evidencia.
* Permiso para crear **tokens de API** en tu Atlassian ID.

### Conectar Bitbucket Cloud a Iru

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

    <Steps>
      <Step title="Abrir la configuración de la cuenta de Atlassian">
        Con la sesión iniciada en Bitbucket Cloud (o en cualquier aplicación de Atlassian con la misma cuenta de Atlassian), selecciona el **icono de tu perfil** y, a continuación, **Account settings** (a veces con la etiqueta **Atlassian account**).
      </Step>

      <Step title="Abrir Security y los tokens de API">
        Elige **Seguridad** y, a continuación, **Create and manage Tokens de API** (el texto puede ser **Tokens de API**).
      </Step>

      <Step title="Crear un token de API con alcances">
        Selecciona **Create API token with scopes** (o la opción equivalente más cercana). Estás creando un token de API de Atlassian que Bitbucket aceptará para la autenticación Basic en Iru.
      </Step>

      <Step title="Configurar el token">
        Asigna una etiqueta al token (por ejemplo, **Iru Compliance**). Elige una fecha de caducidad (los tokens duran hasta **365 días**). Concede alcances de **lectura** en repositorios, espacios de trabajo y equipos para que se ajusten a lo que referencian tus controles.
      </Step>

      <Step title="Copiar el token">
        Crea el token y copia el valor **inmediatamente**; Atlassian solo lo muestra una vez. Lo usarás junto con tu correo electrónico de Atlassian en el paso **Enviar credenciales** de Iru.
      </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 [**Bitbucket Cloud**](#bitbucket-cloud).
    </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 Bitbucket">
        Busca **Bitbucket** (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 autenticación Basic">
        Cuando el asistente solicite la autenticación Basic, introduce tu **correo electrónico de Atlassian** como nombre de usuario y el **token de API** como contraseña.
      </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 **Bitbucket** 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="401 Unauthorized">
    Usa **correo electrónico + token de API**, no el nombre de usuario de Bitbucket ni tu contraseña de Atlassian.
  </Accordion>

  <Accordion title="Token caducado">
    Genera un nuevo token en Account settings y actualiza Iru.
  </Accordion>

  <Accordion title="Faltan espacios de trabajo">
    Asegúrate de que la cuenta de Atlassian pertenezca a todos los espacios de trabajo de los que esperas obtener datos.
  </Accordion>

  <Accordion title="Contraseñas de aplicación heredadas">
    Sustitúyelas por tokens de API: las contraseñas de aplicación están obsoletas.
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Los tokens caducan: los recordatorios en el calendario evitan interrupciones silenciosas…" icon="circle-info">
    Los tokens caducan: los recordatorios en el calendario evitan interrupciones silenciosas.
  </Card>

  <Card title="Los alcances de lectura impiden que Iru modifique repositorios o solicitudes…" icon="shield">
    Los alcances de lectura impiden que Iru modifique repositorios o solicitudes de incorporación de cambios.
  </Card>
</CardGroup>

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