Configuration multi-comptes Bitbucket avec SSH sur une même machine

Pourquoi configurer plusieurs comptes Bitbucket ?

La gestion de plusieurs comptes Bitbucket (personnel et professionnel) sur une même machine nécessite une configuration spécifique pour :

• Séparer les accès professionnels et personnels
• Garantir la sécurité des différents comptes
• Éviter les conflits d’authentification
• Maintenir une traçabilité claire des contributions

Prérequis

Avant de commencer, assurez-vous d’avoir :

• Git installé sur votre machine
• Un terminal avec accès SSH
• Vos identifiants Bitbucket pour chaque compte
• Les droits d’administration sur votre machine

Configuration étape par étape

1. Création des clés SSH

Pour chaque compte Bitbucket, créez une paire de clés SSH unique :

ssh-keygen -t ed25519 -b 4096 -C "votre.email@domaine.com" -f ~/.ssh/bitbucket-compte1
ssh-keygen -t ed25519 -b 4096 -C "email.pro@entreprise.com" -f ~/.ssh/bitbucket-compte2

Note de sécurité : Utilisez une passphrase forte pour chaque clé.

2. Ajout des clés à l’agent SSH

Activez et configurez l’agent SSH :

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/bitbucket-compte1
ssh-add ~/.ssh/bitbucket-compte2

3. Configuration SSH

Éditez ou créez le fichier ~/.ssh/config :

# Compte personnel
Host bitbucket.org-personnel
    HostName bitbucket.org
    User git
    IdentityFile ~/.ssh/bitbucket-compte1
    IdentitiesOnly yes

# Compte professionnel
Host bitbucket.org-pro
    HostName bitbucket.org
    User git
    IdentityFile ~/.ssh/bitbucket-compte2
    IdentitiesOnly yes

4. Ajout des clés publiques sur Bitbucket

1. Connectez-vous à Bitbucket
2. Accédez à Paramètres SSH
3. Ajoutez la clé publique correspondante à chaque compte :

   cat ~/.ssh/bitbucket-compte1.pub
   cat ~/.ssh/bitbucket-compte2.pub

Utilisation quotidienne

Cloner un nouveau dépôt

Utilisez l’alias d’hôte correspondant au compte :

# Pour le compte personnel
git clone git@bitbucket.org-personnel:workspace/repo.git

# Pour le compte professionnel
git clone git@bitbucket.org-pro:workspace/repo.git

Mettre à jour un dépôt existant

Pour les dépôts déjà clonés, mettez à jour l’URL remote :

git remote set-url origin git@bitbucket.org-personnel:workspace/repo.git

Configuration Git par dépôt

Dans chaque dépôt, configurez l’identité Git appropriée :

# Configuration locale au dépôt
git config user.name "Votre Nom"
git config user.email "email@correspondant.com"

Vérification de la configuration

Testez la connexion pour chaque compte :

ssh -T git@bitbucket.org-personnel
ssh -T git@bitbucket.org-pro

Dépannage

Problèmes courants

1. Erreur de permission : Vérifiez les droits sur les fichiers SSH

   chmod 600 ~/.ssh/bitbucket-*
   chmod 700 ~/.ssh

2. Clé non reconnue : Vérifiez que l’agent SSH a bien chargé la clé

   ssh-add -l

Ressources additionnelles

• Documentation officielle Bitbucket
• Guide SSH Atlassian

Cette configuration vous permet de travailler efficacement avec plusieurs comptes Bitbucket sur une même machine, en maintenant une séparation claire entre vos différents contextes d’utilisation.