Table des matières

Accéder aux dépôts sources des BSP LinRT

Guide public — activation de l’abonnement, enregistrement d’une clé SSH et accès aux sources Yocto BSP via Git et Repo.

Synoptique de la procédure d’accès

Synoptique de la procédure d’accès

Schéma : activation du profil et accès SSH. Chaque étape reste soumise aux autorisations de la souscription.

Qui peut demander un accès ?

Après validation de la souscription, les utilisateurs désignés par le client (de un à trois au maximum, selon le niveau de support souscrit) reçoivent chacun une invitation du HelpDesk LinRT. Les accès sont nominatifs et limités aux dépôts et branches autorisés par la souscription. Un compte HelpDesk ne donne pas, à lui seul, accès aux dépôts Git.

1. Activer son compte LinRT HelpDesk

Chaque utilisateur désigné reçoit un courriel d’invitation du support LinRT (HelpDesk). Il suit le lien d’activation, définit son mot de passe personnel et complète son profil. Si le message n’arrive pas, vérifier les courriers indésirables puis contacter le support par le portail officiel. Ne jamais transmettre son mot de passe HelpDesk.

LinRT HelpDesk ↗

2. Préparer son poste de développement

Les exemples utilisent un terminal Linux ou macOS, ou Git Bash sous Windows avec OpenSSH. Installer Git, OpenSSH et, pour synchroniser plusieurs dépôts Yocto, l’outil Google Repo. Vérifier Git et SSH :

ssh -V
git --version

3. Générer sa paire de clés SSH personnelle

Créer une paire de clés par utilisateur autorisé et, de préférence, par poste. Le ticket HelpDesk actuel s’intitule « RSA Key soumission » : l’exemple utilise donc RSA sur 4 096 bits. Bitbucket Cloud accepte aussi Ed25519, mais faire confirmer ce choix par LinRT avant utilisation. Définir une phrase secrète robuste. Ne pas écraser une clé existante.

mkdir -p "$HOME/.ssh"
chmod 700 "$HOME/.ssh"
ssh-keygen -t rsa -b 4096 -C "user@company.example" -f "$HOME/.ssh/linrt_bitbucket"

La commande crée une clé privée linrt_bitbucket (à conserver confidentielle) et une clé publique linrt_bitbucket.pub (à transmettre). Charger la clé privée dans l’agent SSH de la session :

eval "$(ssh-agent -s)"
ssh-add "$HOME/.ssh/linrt_bitbucket"

4. Ouvrir un ticket « RSA Key soumission »

Se connecter au HelpDesk LinRT puis ouvrir un ticket sous la rubrique RSA Key soumission. Indiquer l’entreprise abonnée, l’adresse email enregistrée de l’utilisateur autorisé et l’intégralité de la ligne du fichier .pub. L’empreinte SHA256 peut être ajoutée. Ne jamais joindre la clé privée, la phrase secrète, un mot de passe ou le dossier .ssh complet.

cat "$HOME/.ssh/linrt_bitbucket.pub"
ssh-keygen -lf "$HOME/.ssh/linrt_bitbucket.pub"

5. Attendre la confirmation du support LinRT

Le support LinRT vérifie la demande, enregistre la clé publique communiquée sur le service Bitbucket LinRT et confirme l’activation de la clé ainsi que les autorisations sur les dépôts concernés. La réponse au ticket autorise le lancement des tests. L’enregistrement de la clé et les droits d’accès aux dépôts sont deux vérifications distinctes.

6. Tester l’authentification SSH

Tester la connexion Bitbucket avec la clé privée correspondant au fichier .pub transmis. À la première connexion, comparer l’empreinte de la clé d’hôte du serveur à la référence officielle Atlassian avant de l’accepter.

ssh -T -i "$HOME/.ssh/linrt_bitbucket" -o IdentitiesOnly=yes git@bitbucket.org

Une authentification Bitbucket Cloud réussie affiche généralement :

authenticated via ssh key. You can use git to connect to Bitbucket.
Shell access is disabled

Le message « Shell access is disabled » est normal : Bitbucket fournit Git via SSH, pas de session shell interactive. Le succès du test SSH ne garantit pas l’accès à tous les dépôts privés LinRT. Vérifier séparément l’accès au dépôt manifeste autorisé :

git ls-remote git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git

7. Récupérer le dépôt des manifestes

À titre d’exemple, le dépôt de manifestes LinRT Oxygen peut être cloné en HTTPS. Attention : l’authentification Git en HTTPS est indépendante de l’authentification SSH. Cette commande récupère uniquement le dépôt Git des manifestes, et non l’ensemble des sources Yocto :

git clone https://bitbucket.org/linrt/linrt-multifb-oxygen-manifest.git

Si la méthode autorisée est SSH, utiliser plutôt l’URL SSH du dépôt :

git clone git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git

8. Initialiser et synchroniser les sources Yocto avec Repo

L’outil Repo lit le manifeste et récupère les différents projets Git. Exécuter les commandes suivantes dans un nouveau répertoire vide. L’exemple utilise la branche par défaut du dépôt manifeste. Pour une version précise d’Oxygen 5.x/6.x, appliquer exclusivement la branche et le fichier XML communiqués par le support LinRT : ne pas inventer de nom de branche.

mkdir -p "$HOME/linrt/oxygen-sources"
cd "$HOME/linrt/oxygen-sources"
repo init -u git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
repo sync -j4

Le manifeste peut référencer plusieurs serveurs et dépôts, avec leurs propres URL et droits d’accès. Le clonage HTTPS du manifeste ne configure pas automatiquement l’accès SSH aux autres dépôts.

Liste de vérification

Résolution des problèmes

Sécurité et cycle de vie des accès

Seules les clés publiques doivent être transmises. Protéger les clés privées par une phrase secrète, éviter les comptes partagés, retirer les clés d’anciens postes et signaler au HelpDesk tout départ d’utilisateur ou toute demande de révocation. Le mot de passe HelpDesk et la clé SSH Bitbucket répondent à deux usages différents.

Références officielles


Guide public d’intégration des abonnés. La disponibilité des dépôts et des branches dépend de la souscription et des autorisations validées par le support LinRT.

LinRT HelpDesk ↗ · Wiki