====== 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 =====
{{:linrt:public:source-access-flow-fr.png?960|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.
[[https://support.linrt.com/|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 [[https://support.linrt.com/|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 =====
* Compte HelpDesk activé
* Clé publique envoyée via le ticket RSA Key soumission
* Enregistrement confirmé par le support
* Test SSH réussi
* Dépôt manifeste autorisé accessible
* Synchronisation Repo sur la branche approuvée
===== Résolution des problèmes =====
* **Permission denied (publickey) :** vérifier que le support a confirmé l’enregistrement de la clé ; contrôler les identités chargées et réessayer avec la bonne clé privée. Si nécessaire, ouvrir un ticket.
* **Test SSH réussi, mais dépôt Git introuvable / accès refusé :** vérifier l’URL exacte et les autorisations sur le dépôt ou la branche.
* **Le clonage HTTPS demande un identifiant ou un jeton :** une clé SSH n’authentifie pas le protocole HTTPS. Préférer l’URL SSH ou suivre la procédure HTTPS autorisée.
* **Host key verification failed :** arrêter et vérifier les empreintes officielles Bitbucket. Ne pas contourner ce contrôle.
* **Échec de repo sync sur un projet :** vérifier le manifeste/branche approuvés et les accès à chaque dépôt privé ; transmettre au HelpDesk les messages d’erreur expurgés d’informations sensibles.
===== 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 =====
* [[https://support.atlassian.com/bitbucket-cloud/docs/set-up-personal-ssh-keys-on-linux/|Atlassian — SSH on Linux]]
* [[https://support.atlassian.com/bitbucket-cloud/docs/set-up-personal-ssh-keys-on-windows/|Atlassian — SSH on Windows]]
* [[https://support.atlassian.com/bitbucket-cloud/docs/set-up-personal-ssh-keys-on-macos/|Atlassian — SSH on macOS]]
* [[https://support.atlassian.com/bitbucket-cloud/docs/configure-ssh-and-two-step-verification/|Atlassian — SSH host fingerprints and key types]]
* [[https://source.android.com/docs/setup/reference/repo|Google / Android Open Source Project — Repo commands]]
----
//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.//
[[https://support.linrt.com/|LinRT HelpDesk ↗]] · [[:fr:start|Wiki]]