Sébastien MAIMON

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

Publié le
#notes
#Git
#Bitbucket
#SSH
#DevOps
#Configuration
#Sécurité
#Terminal

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

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.