Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Mot de passe ou jeton d'accès de l'application Bitbucket
## Conditions préalables
Avant de commencer, vous devez ajouter les étendues d'autorisation appropriées au mot de passe ou au jeton d'accès de votre application Bitbucket.
Pour Bitbucket, le mot de passe ou le jeton d'accès de votre application doit avoir les champs d'application suivants.
+ **repository:read** : accorde l'accès en lecture à tous les référentiels auxquels l'utilisateur d'autorisation a accès.
+ **pullrequest:read** : accorde l'accès en lecture aux demandes d'extraction. Si votre projet possède un webhook Bitbucket, le mot de passe ou le jeton d'accès de votre application doit avoir cette portée.
+ **webhook** : accorde l'accès aux webhooks. Si votre projet comporte une opération webhook, le mot de passe ou le jeton d'accès de votre application doit avoir cette portée.
+ **compte** : accorde un accès en lecture aux informations du compte de l'utilisateur.
Pour plus d'informations, consultez [Scopes for Bitbucket Cloud REST API](https://developer.atlassian.com/cloud/bitbucket/bitbucket-cloud-rest-api-scopes/) et Bitbucket [Cloud OAuth sur le site Web de Bitbucket](https://confluence.atlassian.com/bitbucket/oauth-on-bitbucket-cloud-238027431.html).
## Connect Bitbucket avec un mot de passe d'application (console)
Pour utiliser la console afin de connecter votre projet à Bitbucket à l'aide d'un mot de passe d'application, procédez comme suit lorsque vous créez un projet. Pour plus d'informations, consultez [Création d'un projet de génération (console)](create-project.md#create-project-console).
1. Pour **Source provider (Fournisseur de source)**, choisissez **Bitbucket**.
1. Pour **Credential**, effectuez l'une des opérations suivantes :
+ Choisissez d'utiliser les informations d'identification du compte pour appliquer les informations d'identification source par défaut de votre compte à tous les projets.
1. Si vous n'êtes pas connecté à Bitbucket, choisissez **Gérer les informations d'identification du compte**.
1. Pour le **type d'identifiant,** choisissez le mot de **passe de l'application**.
+ Si vous avez choisi d'utiliser les informations d'identification au niveau du compte pour le **service**, choisissez le service que vous souhaitez utiliser pour stocker votre jeton et procédez comme suit :
1. Si vous choisissez d'utiliser **Secrets Manager**, vous pouvez choisir d'utiliser une connexion secrète existante ou d'en créer un nouveau, puis choisir **Enregistrer**. Pour plus d'informations sur la création d'un nouveau secret, consultez[Créez et stockez un jeton dans un secret du Gestionnaire de Secrets](asm-create-secret.md).
1. Si vous choisissez de l'utiliser **CodeBuild**, entrez votre nom d'utilisateur Bitbucket et le mot de passe de l'application, puis choisissez **Enregistrer**.
+ Sélectionnez **Utiliser les informations d'identification de remplacement pour ce projet uniquement** pour utiliser des informations d'identification source personnalisées afin de remplacer les paramètres d'identification de votre compte.
1. Dans la liste des informations d'identification renseignée, choisissez l'une des options sous Mot de **passe de l'application**.
1. Vous pouvez également créer un nouveau jeton de mot de passe d'application en sélectionnant **créer une nouvelle connexion par mot de passe d'application** dans la description.
## Connect Bitbucket avec un jeton d'accès (console)
Pour utiliser la console afin de connecter votre projet à Bitbucket à l'aide d'un jeton d'accès, procédez comme suit lorsque vous créez un projet. Pour plus d'informations, consultez [Création d'un projet de génération (console)](create-project.md#create-project-console).
1. Pour **Source provider (Fournisseur de source)**, choisissez **Bitbucket**.
1. Pour **Credential**, effectuez l'une des opérations suivantes :
+ Choisissez d'utiliser les informations d'identification du compte pour appliquer les informations d'identification source par défaut de votre compte à tous les projets.
1. Si vous n'êtes pas connecté à Bitbucket, choisissez **Gérer les informations d'identification du compte**.
1. Pour le **type d'identifiant**, choisissez **jeton d'accès personnel**.
+ Si vous avez choisi d'utiliser les informations d'identification au niveau du compte pour le **service**, choisissez le service que vous souhaitez utiliser pour stocker votre jeton et procédez comme suit :
1. Si vous choisissez d'utiliser **Secrets Manager**, vous pouvez choisir d'utiliser une connexion secrète existante ou d'en créer un nouveau, puis choisir **Enregistrer**. Pour plus d'informations sur la création d'un nouveau secret, consultez[Créez et stockez un jeton dans un secret du Gestionnaire de Secrets](asm-create-secret.md).
1. Si vous choisissez de l'utiliser **CodeBuild**, entrez votre jeton d'accès personnel Bitbucket, puis choisissez **Enregistrer**.
+ Sélectionnez **Utiliser les informations d'identification de remplacement pour ce projet uniquement** pour utiliser des informations d'identification source personnalisées afin de remplacer les paramètres d'identification de votre compte.
1. Dans la liste des informations d'identification renseignée, choisissez l'une des options sous **Jeton d'accès personnel**.
1. Vous pouvez également créer un nouveau jeton d'accès personnel en sélectionnant **créer une nouvelle connexion par jeton d'accès personnel** dans la description.
## Connectez Bitbucket à l'aide d'un mot de passe d'application ou d'un jeton d'accès (CLI)
Suivez ces étapes pour connecter votre projet à Bitbucket AWS CLI à l'aide d'un mot de passe d'application ou d'un jeton d'accès. Pour plus d'informations sur l'utilisation du AWS CLI with AWS CodeBuild, consultez le[Référence des commandes en ligne](cmd-ref.md).
1. Exécutez la commande **import-source-credentials** :
```
aws codebuild import-source-credentials --generate-cli-skeleton
```
Des données au format JSON apparaissent dans la sortie. Copiez les données dans un fichier (par exemple,`{{import-source-credentials.json}}`) situé sur l'ordinateur local ou sur l'instance où le AWS CLI est installé. Modifiez les données copiées comme suit, puis enregistrez vos résultats.
```
{
"serverType": "BITBUCKET",
"authType": "{{auth-type}}",
"shouldOverwrite": "{{should-overwrite}}",
"token": "{{token}}",
"username": "{{username}}"
}
```
Remplacez les éléments suivants :
+ {{server-type}}: valeur requise. Le fournisseur de source utilisé pour cette information d'identification. Les valeurs valides sont GITHUB, BITBUCKET, GITHUB\_ENTERPRISE, GITLAB et GITLAB\_SELF\_MANAGED.
+ {{auth-type}}: valeur requise. Type d'authentification utilisé pour se connecter à un référentiel. Les valeurs valides sont OAUTH, BASIC\_AUTH, PERSONAL\_ACCESS\_TOKEN, CODECONNECTIONS et SECRETS\_MANAGER. Car GitHub seul PERSONAL\_ACCESS\_TOKEN est autorisé. BASIC\_AUTH n'est autorisé qu'avec le mot de passe de l'application Bitbucket.
+ {{should-overwrite}}: valeur facultative. Définissez cette valeur sur `false` pour empêcher le remplacement des informations d'identification source du référentiel. Définissez cette valeur sur `true` pour remplacer les informations d'identification source du référentiel. La valeur par défaut est `true`.
+ {{token}}: valeur requise. Pour GitHub notre serveur d' GitHub entreprise, il s'agit du jeton d'accès personnel. Pour Bitbucket, il s'agit du jeton d'accès personnel ou du mot de passe de l'application. Pour le type d'authentification CODECONNECTIONS, il s'agit de l'ARN de connexion. Pour le type d'authentification SECRETS\_MANAGER, il s'agit de l'ARN secret.
+ {{username}}: valeur facultative. Ce paramètre est ignoré pour GitHub les fournisseurs de sources GitHub Enterprise Server.
1. Pour connecter votre compte à l'aide d'un mot de passe d'application ou d'un jeton d'accès, accédez au répertoire qui contient le `import-source-credentials.json` fichier que vous avez enregistré à l'étape 1 et réexécutez la **import-source-credentials** commande.
```
aws codebuild import-source-credentials --cli-input-json file://import-source-credentials.json
```
Les données au format JSON apparaissent dans la sortie avec un Amazon Resource Name (ARN).
```
{
"arn": "arn:aws:codebuild:{{region}}:{{account-id}}:token/{{server-type}}"
}
```
**Note**
Si vous exécutez la commande **import-source-credentials** avec le même type de serveur et de auth une seconde fois, le jeton d'accès stocké est mis à jour.
Une fois que votre compte est connecté à l'aide d'un mot de passe d'application, vous pouvez `create-project` l'utiliser pour créer votre CodeBuild projet. Pour de plus amples informations, veuillez consulter [Création d'un projet de génération (AWS CLI)](create-project.md#create-project-cli).
1. Pour afficher les mots de passe ou les jetons d'accès des applications connectées, exécutez la **list-source-credentials** commande.
```
aws codebuild list-source-credentials
```
Un objet `sourceCredentialsInfos` au format JSON apparaît dans la sortie :
```
{
"sourceCredentialsInfos": [
{
"authType": "{{auth-type}}",
"serverType": "BITBUCKET",
"arn": "{{arn}}"
}
]
}
```
Le `sourceCredentialsObject` contient la liste des informations d'identification de la source connectée :
+ L'élément `authType` est le type d'authentification utilisé par les informations d'identification. Cela peut être `OAUTH``BASIC_AUTH`,`PERSONAL_ACCESS_TOKEN`,`CODECONNECTIONS`, ou`SECRETS_MANAGER`.
+ Le `serverType` est le type de fournisseur de source. Cela peut être `GITHUB``GITHUB_ENTERPRISE`,`BITBUCKET`,`GITLAB`, ou`GITLAB_SELF_MANAGED`.
+ Le `arn` est l'ARN du jeton.
1. Pour vous déconnecter d'un fournisseur source et supprimer son mot de passe d'application ou ses jetons d'accès, exécutez la **delete-source-credentials** commande avec son ARN.
```
aws codebuild delete-source-credentials --arn {{arn-of-your-credentials}}
```
Des données au format JSON sont renvoyées avec un ARN des informations d'identification supprimées.
```
{
"arn": "arn:aws:codebuild:{{region}}:{{account-id}}:token/{{server-type}}"
}
```