As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conexões da aplicação do Bitbucket
<a name="connections-bitbucket-app"></a>

Você pode usar o Bitbucket para se conectar com CodeBuild. As conexões da aplicação do Bitbucket têm suporte por meio do [Conexões de código da AWS](https://docs.aws.amazon.com/dtconsole/latest/userguide/welcome-connections.html).

**nota**  
CodeConnections está disponível em menos regiões do que CodeBuild. Você pode usar conexões entre regiões em CodeBuild. Conexões criadas em regiões de aceitação não podem ser usadas em outras regiões. Para saber mais, consulte [Endpoints e cotas do Conexões de código da AWS](https://docs.aws.amazon.com/general/latest/gr/codestar_connections.html).

**Topics**
+ [Etapa 1: criar uma conexão com o Bitbucket (console)](#connections-bitbucket-console)
+ [Etapa 2: conceder acesso à função IAM do CodeBuild projeto para usar a conexão](#connections-bitbucket-role-access)
+ [Etapa 3: Configurar CodeBuild para usar a nova conexão](#connections-bitbucket-account-credential)

## Etapa 1: criar uma conexão com o Bitbucket (console)
<a name="connections-bitbucket-console"></a>

Use essas etapas para usar o CodeBuild console para adicionar uma conexão ao seu projeto no Bitbucket.

**Para criar uma conexão com o Bitbucket**
+ Siga as instruções no *Guia do usuário do Developer Tools* para [Criar uma conexão com o Bitbucket](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create-bitbucket.html).

**nota**  
Em vez de criar ou usar uma conexão existente na sua conta, você pode usar uma conexão compartilhada de outra AWS conta. Para obter mais informações, consulte [Compartilhar conexões com AWS contas](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-share.html).

## Etapa 2: conceder acesso à função IAM do CodeBuild projeto para usar a conexão
<a name="connections-bitbucket-role-access"></a>

Você pode conceder acesso à função IAM do CodeBuild projeto para usar os tokens do Bitbucket fornecidos pela sua conexão.

**Para conceder acesso à função IAM do CodeBuild projeto**

1. Crie uma função do IAM para seu CodeBuild projeto seguindo as instruções [CodeBuild Permitir interagir com outros AWS serviços](setting-up-service-role.md) para seu CodeBuild projeto.

1. Ao seguir as instruções, adicione a seguinte política do IAM ao papel CodeBuild do seu projeto para conceder acesso à conexão.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "codeconnections:GetConnectionToken",
                   "codeconnections:GetConnection"
               ],
               "Resource": [
                   "arn:aws:iam::*:role/Service*"
               ]
           }
       ]
   }
   ```

------

## Etapa 3: Configurar CodeBuild para usar a nova conexão
<a name="connections-bitbucket-account-credential"></a>

Você pode configurar uma conexão como uma credencial no nível da conta e usá-la em um projeto.

------
#### [ Console de gerenciamento da AWS ]

**Para configurar uma conexão como uma credencial de nível de conta no Console de gerenciamento da AWS**

1. Em **Provedor de origem**, escolha **Bitbucket**. 

1. Em **Credencial**, siga um destes procedimentos:
   + Escolha **Credencial de origem padrão** para usar a credencial de origem padrão da conta e aplicá-la a todos os projetos.

     1. Se você não estiver conectado ao Bitbucket, escolha **Gerenciar credencial de origem padrão**.

     1. Para **Tipo de credencial**, escolha **CodeConnections**.

     1. Em **Conexão**, escolha usar uma conexão existente ou crie uma.
   + Escolha **Credencial de origem personalizada** para usar uma credencial de origem personalizada para substituir as configurações padrão da conta.

     1. Para **Tipo de credencial**, escolha **CodeConnections**.

     1. Em **Conexão**, escolha usar uma conexão existente ou crie uma.

------
#### [ AWS CLI ]

**Para configurar uma conexão como uma credencial de nível de conta no AWS CLI**
+ Abra um terminal (Linux, macOS ou Unix) ou um prompt de comando (Windows). Use o AWS CLI para executar o **import-source-credentials** comando, especificando o `--auth-type``--server-type`, e `--token` para sua conexão.

  Use o seguinte comando:

  ```
  aws codebuild import-source-credentials --auth-type CODECONNECTIONS --server-type BITBUCKET --token <connection-arn>
  ```

------

Para obter mais informações sobre como configurar vários tokens em seu CodeBuild projeto, consulte[Configurar vários tokens como credenciais no nível de origem](multiple-access-tokens.md#asm-source-credential).