Seleccione sus preferencias de cookies

Usamos cookies esenciales y herramientas similares que son necesarias para proporcionar nuestro sitio y nuestros servicios. Usamos cookies de rendimiento para recopilar estadísticas anónimas para que podamos entender cómo los clientes usan nuestro sitio y hacer mejoras. Las cookies esenciales no se pueden desactivar, pero puede hacer clic en “Personalizar” o “Rechazar” para rechazar las cookies de rendimiento.

Si está de acuerdo, AWS y los terceros aprobados también utilizarán cookies para proporcionar características útiles del sitio, recordar sus preferencias y mostrar contenido relevante, incluida publicidad relevante. Para aceptar o rechazar todas las cookies no esenciales, haga clic en “Aceptar” o “Rechazar”. Para elegir opciones más detalladas, haga clic en “Personalizar”.

Contraseña de aplicación o token de acceso de Bitbucket

Modo de enfoque
Contraseña de aplicación o token de acceso de Bitbucket - AWS CodeBuild

Requisitos previos

Antes de comenzar, debe agregar los ámbitos de permisos adecuados para su contraseña de aplicación o token de acceso de Bitbucket.

Para Bitbucket, la contraseña de aplicación o el token de acceso deben tener los siguientes ámbitos.

  • repository:read: Concede acceso de lectura a todos los repositorios a los que tiene acceso el usuario de autorización.

  • pullrequest:read: Concede acceso de lectura a las solicitudes de extracción. Si su proyecto tiene un webhook de Bitbucket, entonces la contraseña de su aplicación o el token de acceso debe tener este ámbito.

  • webhook: Concede acceso a webhooks. Si su proyecto tiene una operación de webhook, entonces la contraseña de su aplicación o el token de acceso debe tener este ámbito.

Para obtener más información, consulte Scopes for Bitbucket Cloud REST API y OAuth on Bitbucket Cloud en el sitio web de Bitbucket.

Conectarse a Bitbucket con una contraseña de aplicación (consola)

Para utilizar la consola para conectar el proyecto a Bitbucket con una contraseña de aplicación, haga lo siguiente a la hora de crear un proyecto. Para obtener más información, consulte Creación de un proyecto de compilación (consola).

  1. En Source provider (Proveedor de código fuente), elija Bitbucket.

  2. En Credencial, realice una de las siguientes acciones:

    • Elija Credencial de origen predeterminada para aplicar la credencial de origen predeterminada de su cuenta a todos los proyectos.

      1. Si no está conectado a Bitbucket, elija Administrar la credencial de origen predeterminada.

      2. En Tipo de credencial, elija Contraseña de la aplicación.

      3. Si ha elegido Credencial de origen predeterminada, elija en Servicio el servicio que quiere usar para almacenar el token y haga lo siguiente:

        • Si decide usar Secrets Manager, puede elegir entre usar una conexión de secreto existente o crear un secreto nuevo y elegir Guardar. Para obtener más información sobre cómo crear un secreto nuevo, consulte Creación y almacenamiento de un token en un secreto de Secrets Manager.

        • Si decide usar CodeBuild, especifique su Nombre de usuario de Bitbucket y Contraseña de aplicación de Bitbucket y elija Guardar.

    • Elija Credencial de origen personalizada a fin de usar una credencial de este tipo para anular la configuración predeterminada de su cuenta.

      1. En Tipo de credencial, elija Contraseña de la aplicación.

      2. En Conexión, elija usar una conexión de secreto existente o cree un secreto.

Conexión de Bitbucket con un token de acceso (consola)

Si quiere utilizar la consola para conectar el proyecto a Bitbucket con un token de acceso, haga lo siguiente a la hora de crear un proyecto. Para obtener más información, consulte Creación de un proyecto de compilación (consola).

  1. En Source provider (Proveedor de código fuente), elija Bitbucket.

  2. En Credencial, realice una de las siguientes acciones:

    • Elija Credencial de origen predeterminada para aplicar la credencial de origen predeterminada de su cuenta a todos los proyectos.

      1. Si no está conectado a Bitbucket, elija Administrar la credencial de origen predeterminada.

      2. En Tipo de credencial, elija Token de acceso personal.

      3. Si ha elegido Credencial de origen predeterminada, elija en Servicio el servicio que quiere usar para almacenar el token y haga lo siguiente:

        • Si decide usar Secrets Manager, puede elegir entre usar una conexión de secreto existente o crear un secreto nuevo y elegir Guardar. Para obtener más información sobre cómo crear un secreto nuevo, consulte Creación y almacenamiento de un token en un secreto de Secrets Manager.

        • Si decide usar CodeBuild, escriba su Token de acceso de Bitbucket y elija Guardar.

    • Elija Credencial de origen personalizada a fin de usar una credencial de este tipo para anular la configuración predeterminada de su cuenta.

      1. En Tipo de credencial, elija Token de acceso personal.

      2. En Conexión, elija usar una conexión de secreto existente o cree un secreto.

Conexión de Bitbucket con una contraseña de aplicación o token de acceso (CLI)

Siga estos pasos a fin de utilizar la AWS CLI para conectar su proyecto a Bitbucket mediante una contraseña de aplicación o token de acceso. Para obtener información sobre cómo usar la AWS CLI con AWS CodeBuild, consulte Referencia de la línea de comandos.

  1. Ejecute el comando import-source-credentials:

    aws codebuild import-source-credentials --generate-cli-skeleton

    En el resultado se muestran datos con formato JSON. Copie los datos en un archivo (por ejemplo, import-source-credentials.json) en la ubicación del equipo o instancia local en la que haya instalado la AWS CLI. Modifique los datos copiados como se indica a continuación y guarde los resultados.

    { "serverType": "BITBUCKET", "authType": "auth-type", "shouldOverwrite": "should-overwrite", "token": "token", "username": "username" }

    Sustituya lo siguiente:

    • tipo-servidor: valor obligatorio. El proveedor de código fuente utilizado para esta credencial. Los valores válidos son GITHUB, BITBUCKET, GITHUB_ENTERPRISE, GITLAB y GITLAB_SELF_MANAGED.

    • tipo-autenticación: valor obligatorio. El tipo de autenticación que se utiliza para conectarse a un repositorio. Los valores válidos son OAUTH, BASIC_AUTH, PERSONAL_ACCESS_TOKEN, CODECONNECTIONS y SECRETS_MANAGER. Para GitHub, solo se permite PERSONAL_ACCESS_TOKEN. BASIC_AUTH solo está permitido con la contraseña de aplicación de Bitbucket.

    • should-overwrite: valor opcional. Establézcalo en false para impedir que se sobrescriban las credenciales de origen del repositorio. Establézcalo en true para sobrescribir las credenciales de origen del repositorio. El valor predeterminado es true.

    • token: valor obligatorio. Para GitHub o GitHub Enterprise Server, se trata del token de acceso personal. Para Bitbucket, este es el token de acceso personal o la contraseña de aplicación. Para el tipo de autenticación CODECONNECTIONS, es el ARN de la conexión. Para el tipo de autenticación SECRETS_MANAGER, es el ARN del secreto.

    • nombre de usuario: valor opcional. Este parámetro se ignora para los proveedores de fuentes de GitHub y GitHub Enterprise Server.

  2. Para conectar su cuenta con una contraseña de aplicación o un token de acceso, cambie al directorio que contiene el archivo import-source-credentials.json que ha guardado en el paso 1 y vuelva a ejecutar el comando import-source-credentials.

    aws codebuild import-source-credentials --cli-input-json file://import-source-credentials.json

    Los datos con formato JSON aparecen en el resultado con un nombre de recurso de Amazon (ARN).

    { "arn": "arn:aws:codebuild:region:account-id:token/server-type" }
    nota

    Si ejecuta el comando import-source-credentials con el mismo tipo de servidor y tipo de autorización una segunda vez, se actualiza el token de acceso almacenado.

    Una vez que su cuenta se conecta con una contraseña de aplicación, puede utilizar create-project para crear su proyecto de CodeBuild. Para obtener más información, consulte Crear un proyecto de compilación (AWS CLI).

  3. Para ver las contraseñas de aplicación o los tokens de acceso conectados, ejecute el comando list-source-credentials.

    aws codebuild list-source-credentials

    Un objeto sourceCredentialsInfos con formato JSON aparece en el resultado:

    { "sourceCredentialsInfos": [ { "authType": "auth-type", "serverType": "BITBUCKET", "arn": "arn" } ] }

    El sourceCredentialsObject contiene una lista de información de credenciales de código fuente conectado:

    • El authType es el tipo de autenticación que utilizan las credenciales. Este valor puede ser OAUTH, BASIC_AUTH, PERSONAL_ACCESS_TOKEN, CODECONNECTIONS o SECRETS_MANAGER.

    • El serverType es el tipo de proveedor de código fuente. Este valor puede ser GITHUB, GITHUB_ENTERPRISE, BITBUCKET, GITLAB o GITLAB_SELF_MANAGED.

    • El arn es el ARN del token.

  4. Para desconectarse de un proveedor de origen y eliminar sus tokens de acceso o contraseña de aplicación, ejecute el comando delete-source-credentials con su ARN.

    aws codebuild delete-source-credentials --arn arn-of-your-credentials

    Los datos con formato JSON se devuelven con un ARN de las credenciales eliminadas.

    { "arn": "arn:aws:codebuild:region:account-id:token/server-type" }
PrivacidadTérminos del sitioPreferencias de cookies
© 2025, Amazon Web Services, Inc o sus afiliados. Todos los derechos reservados.