> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corgea.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket

> Guía completa para configurar Bitbucket con Corgea

La integración de Bitbucket con Corgea te permite escanear proyectos y crear pull requests para correcciones de código directamente desde la plataforma Corgea.

<Steps>
  <Step title="Crear un usuario dedicado para Corgea (opcional)">
    Aunque no es obligatorio, recomendamos crear una cuenta de usuario dedicada en Bitbucket para la integración con Corgea. Esto ayuda a distinguir las acciones automatizadas de Corgea de la actividad de tu cuenta personal y ofrece una mejor auditabilidad.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_user.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=e6294580d18378439c15ea8cc252d23a" style={{ borderRadius: '0.5rem' }} alt="Crear usuario de Bitbucket" width="1916" height="864" data-path="images/bitbucket_user.png" />
    </Frame>
  </Step>

  <Step title="Generar un token de acceso a la API">
    Navega hasta el <a href="https://id.atlassian.com/manage-profile/security/api-tokens" target="_blank">Página de Atlassian API Tokens</a> y haz clic en "Crear token de API con ámbitos" para comenzar.

    <Warning>
      **Los tokens API no son lo mismo que los tokens de workspace.** Los tokens API están asociados a tu cuenta de usuario de Atlassian. Puedes generar y gestionar tus tokens personales de API desde el enlace proporcionado arriba.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_create_access_token.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=d2c2690dcd87c35b1651ece83f037c9f" style={{ borderRadius: '0.5rem' }} alt="Crear API Token" width="904" height="333" data-path="images/bitbucket_create_access_token.png" />
    </Frame>

    Proporciona un nombre descriptivo para tu token y establece la fecha de caducidad en un año a partir de hoy. Esto garantiza que el token siga siendo válido durante un periodo prolongado, manteniendo las mejores prácticas de seguridad.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_token_name.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=86506d715f1fbf86a5ef1ca858b4acc2" style={{ borderRadius: '0.5rem' }} alt="Nombre del token y caducidad" width="813" height="839" data-path="images/bitbucket_token_name.png" />
    </Frame>

    Selecciona **Bitbucket** de la lista de aplicaciones para conceder acceso a Bitbucket a este token.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_app_selection.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=eed318e49348eea6d137a651c8b8238f" style={{ borderRadius: '0.5rem' }} alt="Seleccionar la aplicación Bitbucket" width="789" height="673" data-path="images/bitbucket_app_selection.png" />
    </Frame>

    Configura los ámbitos necesarios para la integración de Corgea. Habilita los siguientes:

    <div class="alert alert-info" role="alert">
      <strong>Ámbitos requeridos:</strong>

      <ul class="mb-0 mt-2">
        <li><code>Repositorios: "read:repository:bitbucket", "write:repository:bitbucket"</code></li>
        <li><code>Solicitudes de pull: "read:pullrequest:bitbucket", "write:pullrequest:bitbucket"</code></li>
        <li><code>Webhooks: "read:webhook:bitbucket", "write:webhook:bitbucket", "delete:webhook:bitbucket"</code></li>
        <li><code>Información general: "read:user:bitbucket", "read:workspace:bitbucket"</code></li>
      </ul>
    </div>

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_token_scopes.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=c91333a78a6849ae68c22f5e412356c5" style={{ borderRadius: '0.5rem' }} alt="Objetivos de Token" width="1022" height="787" data-path="images/bitbucket_token_scopes.png" />
    </Frame>

    Revisa tu configuración y haz clic en "Crear token" para generar el token de acceso.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_create_token.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=391d9ebffbe9a06bbdcc1da964bbc0df" style={{ borderRadius: '0.5rem' }} alt="Crear Token" width="781" height="866" data-path="images/bitbucket_create_token.png" />
    </Frame>

    Después de crear el token, haz clic en el botón de copiar para copiar el valor del token. Necesitarás este token en el siguiente paso y no volverá a mostrarse.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_copy_token.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=56a741f0624cf8e64937ab63911f2fc3" style={{ borderRadius: '0.5rem' }} alt="Token de copia" width="691" height="798" data-path="images/bitbucket_copy_token.png" />
    </Frame>
  </Step>

  <Step title="Configurar la integración de Bitbucket en Corgea">
    Accede a tu panel de Corgea en `corgea.app` o `{your-instance}.corgea.app` y navega a la página de Integraciones usando la barra lateral o el enlace de integraciones.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_integration_page.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=bf73904b1aca7582ef3bb21b875a5df5" style={{ borderRadius: '0.5rem' }} alt="Página de Integraciones de Corgea" width="1897" height="840" data-path="images/bitbucket_integration_page.png" />
    </Frame>

    En la sección "Integraciones de Repositorio de Código", localiza Bitbucket y haz clic en el icono más (+) para crear una nueva integración.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_new_integration.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=2540b183bd20606f310c7e707db71b67" style={{ borderRadius: '0.5rem' }} alt="Nueva integración" width="1675" height="457" data-path="images/bitbucket_new_integration.png" />
    </Frame>

    Completa el formulario de integración con la siguiente información:

    * **Slug de espacio de trabajo**: Tu identificador de espacio de trabajo en Bitbucket
    * **Dirección de correo electrónico**: El correo asociado a la cuenta de Bitbucket utilizada para generar el token de la API
    * **Token de acceso**: El token de API que copiaste en el paso anterior
    * **Nombre de integración** (opcional): Un nombre personalizado para identificar esta integración si gestionas varios espacios de trabajo de Bitbucket

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_create_modal.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=3c61d1f0340dddd0bd12f89eede8f529" style={{ borderRadius: '0.5rem' }} alt="Crear modal de integración" width="835" height="701" data-path="images/bitbucket_create_modal.png" />
    </Frame>

    Corgea valida tus credenciales automáticamente. Si alguna información es incorrecta, recibirás un mensaje de error con detalles sobre lo que debe corregirse.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_modal_validation.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=a895ec1f7b3e0ccb9cfe3e0940e19bed" style={{ borderRadius: '0.5rem' }} alt="Validación" width="910" height="720" data-path="images/bitbucket_modal_validation.png" />
    </Frame>

    Tras la validación exitosa, verás un mensaje de confirmación indicando que la integración ha terminado. Los webhooks se configuran automáticamente durante este proceso, por lo que no se requiere una configuración manual de webhooks. Puedes ver los detalles de la integración, incluido el estado del webhook, desde la página de integraciones.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_success_message.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=bb62edb596c23ba63a62942e39112b4f" style={{ borderRadius: '0.5rem' }} alt="Mensaje de éxito" width="1700" height="629" data-path="images/bitbucket_success_message.png" />
    </Frame>
  </Step>
</Steps>