====== Zugriff auf die LinRT BSP-Quellcode-Repositories ======
**Öffentliche Anleitung — Abonnementfreigabe, Registrierung eines SSH-Schlüssels und Yocto-Quellcodezugriff mit Git und Repo.**
===== Ablaufübersicht für den Quellcodezugriff =====
{{:linrt:public:source-access-flow-de.png?960|Ablaufübersicht für den Quellcodezugriff}}
//Ablauf: Kontoaktivierung und SSH-Zugriff; alle Schritte erfordern entsprechende Freigaben.//
===== Wer kann Zugriff erhalten? =====
Nach Bestätigung des Abonnements lädt LinRT HelpDesk die vom Kunden benannten Personen einzeln ein (je nach Supportstufe maximal ein bis drei Benutzer). Der Zugriff ist personenbezogen und auf die freigegebenen Repositories und Branches begrenzt. Ein HelpDesk-Konto allein gewährt keinen Git-Zugriff.
===== 1. LinRT HelpDesk-Konto aktivieren =====
Jeder benannte Benutzer erhält eine Einladungs-E-Mail vom LinRT-Support, legt über den Aktivierungslink ein eigenes Passwort fest und vervollständigt sein Profil. Falls die Nachricht fehlt, Spamordner prüfen und das offizielle Portal verwenden. HelpDesk-Passwörter nicht weitergeben.
[[https://support.linrt.com/|LinRT HelpDesk ↗]]
===== 2. Entwicklungsrechner vorbereiten =====
Die Beispiele gelten für Linux-/macOS-Terminals sowie Git Bash unter Windows mit OpenSSH. Benötigt werden Git, OpenSSH und für Yocto-Multi-Repository-Checkouts das Google-Tool Repo. Versionen prüfen:
ssh -V
git --version
===== 3. Persönliches SSH-Schlüsselpaar erzeugen =====
Jeder berechtigte Benutzer sollte ein eigenes Schlüsselpaar nutzen, möglichst je Rechner. Das aktuelle HelpDesk-Ticket heißt „RSA Key soumission“, daher verwendet das Beispiel RSA mit 4096 Bit. Bitbucket Cloud unterstützt auch Ed25519; die Freigabe dafür vorher bei LinRT erfragen. Eine sichere Passphrase vergeben und vorhandene Schlüssel nicht überschreiben.
mkdir -p "$HOME/.ssh"
chmod 700 "$HOME/.ssh"
ssh-keygen -t rsa -b 4096 -C "user@company.example" -f "$HOME/.ssh/linrt_bitbucket"
Dabei entstehen ein **privater Schlüssel** ''linrt_bitbucket'' (geheim halten) und ein **öffentlicher Schlüssel** ''linrt_bitbucket.pub'' (weitergeben). Privaten Schlüssel in den lokalen SSH-Agent laden:
eval "$(ssh-agent -s)"
ssh-add "$HOME/.ssh/linrt_bitbucket"
===== 4. HelpDesk-Ticket „RSA Key soumission“ eröffnen =====
Im [[https://support.linrt.com/|LinRT HelpDesk]] ein Ticket mit dem Thema **RSA Key soumission** eröffnen. Firmenname, registrierte E-Mail-Adresse des berechtigten Benutzers und die **vollständige Zeile** aus der ''.pub''-Datei übermitteln; optional den SHA256-Fingerabdruck. **Niemals privaten Schlüssel, Passphrase, Passwort oder den kompletten ''.ssh''-Ordner senden.**
cat "$HOME/.ssh/linrt_bitbucket.pub"
ssh-keygen -lf "$HOME/.ssh/linrt_bitbucket.pub"
===== 5. Bestätigung vom LinRT-Support abwarten =====
Der LinRT-Support prüft die Anfrage, registriert den öffentlichen Schlüssel im LinRT-Bitbucket-Dienst und bestätigt die Einrichtung der relevanten Repository-Berechtigungen. Schlüsselregistrierung und Repository-Freigabe sind getrennte Prüfungen.
===== 6. SSH-Authentifizierung testen =====
Die Verbindung mit dem zugehörigen privaten Schlüssel testen. Bei der ersten Verbindung den **Host-Key-Fingerabdruck mit der offiziellen Atlassian-Referenz vergleichen**, bevor er akzeptiert wird.
ssh -T -i "$HOME/.ssh/linrt_bitbucket" -o IdentitiesOnly=yes git@bitbucket.org
Eine erfolgreiche Bitbucket-Cloud-Verbindung meldet normalerweise:
authenticated via ssh key. You can use git to connect to Bitbucket.
Shell access is disabled
„Shell access is disabled“ ist korrekt: Bitbucket bietet Git über SSH, aber keine interaktive Shell. Erfolgreiche SSH-Anmeldung bedeutet nicht automatisch Zugriff auf alle privaten Repositories. Das berechtigte Manifest-Repository gesondert testen:
git ls-remote git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
===== 7. Manifest-Repository abrufen =====
Beispielsweise lässt sich das LinRT-Oxygen-Manifest-Repository per HTTPS klonen. **Wichtig:** HTTPS- und SSH-Authentifizierung sind unabhängig. Der Befehl lädt nur das Manifest-Repository, nicht die gesamte Yocto-Quellcodebasis:
git clone https://bitbucket.org/linrt/linrt-multifb-oxygen-manifest.git
Wenn SSH freigegeben ist, stattdessen die SSH-Adresse verwenden:
git clone git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
===== 8. Yocto-Quellcode mit Repo initialisieren und synchronisieren =====
Repo liest das Manifest und ruft die aufgeführten Git-Projekte ab. Befehle in einem **neuen leeren Verzeichnis** ausführen. Das Beispiel nutzt den Standard-Branch. Für konkrete Oxygen-5.x-/6.x-Versionen ausschließlich den von LinRT-Support **freigegebenen Branch und die XML-Datei** verwenden.
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
Im Manifest können mehrere Repositories mit unterschiedlichen Protokollen referenziert sein. HTTPS-Klonen des Manifests richtet nicht automatisch SSH-Zugriff auf andere Repositories ein.
===== Prüfliste =====
* HelpDesk-Konto aktiviert
* Öffentlichen Schlüssel per RSA Key soumission übermittelt
* Bestätigung vom Support erhalten
* SSH-Test erfolgreich
* Manifest-Repository lesbar
* Repo-Synchronisierung mit freigegebenem Branch
===== Fehlerbehebung =====
* **Permission denied (publickey):** Schlüsselregistrierung, geladene Identitäten und Support-Freigabe prüfen.
* **SSH funktioniert, Git-Repository nicht:** URL und spezielle Repository-/Branch-Rechte prüfen.
* **HTTPS verlangt Anmeldedaten:** SSH-Schlüssel gelten nicht für HTTPS; SSH-URL oder freigegebenes HTTPS-Verfahren nutzen.
* **Host key verification failed:** Verbindung abbrechen und Host-Fingerabdruck mit Atlassian abgleichen.
* **repo sync schlägt fehl:** Manifest, Branch und Zugriffsrechte auf jedes private Projekt prüfen; bereinigte Fehlermeldungen an HelpDesk senden.
===== Sicherheit und Entzug von Zugriffsrechten =====
Nur öffentliche Schlüssel weitergeben. Private Schlüssel per Passphrase sichern, keine gemeinsam genutzten Benutzerkonten verwenden und beim Benutzerwechsel oder Geräteverlust die Sperrung über HelpDesk veranlassen. HelpDesk-Passwort und Bitbucket-SSH-Schlüssel erfüllen unterschiedliche Aufgaben.
===== Offizielle Referenzen =====
* [[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]]
----
//Öffentliche Einrichtungsanleitung. Repository- und Branch-Zugriff hängen vom Abonnement und den erteilten Berechtigungen ab.//
[[https://support.linrt.com/|LinRT HelpDesk ↗]] · [[:de:start|Wiki]]