====== Accesso ai repository sorgente del BSP LinRT ======
**Guida pubblica — attivazione dell’abbonamento, registrazione della chiave SSH e accesso alle sorgenti Yocto tramite Git e Repo.**
===== Schema della procedura di accesso =====
{{:linrt:public:source-access-flow-it.png?960|Schema della procedura di accesso}}
//Schema: attivazione dell’account e accesso SSH, subordinati alle autorizzazioni previste.//
===== Chi può richiedere l’accesso? =====
Dopo la convalida dell’abbonamento, gli utenti indicati dal cliente (da uno a un massimo di tre in base al livello di supporto) ricevono un invito personale da LinRT HelpDesk. I permessi sono nominativi e limitati ai repository e ai rami autorizzati. Un account HelpDesk non garantisce automaticamente l’accesso a Git.
===== 1. Attivare l’account LinRT HelpDesk =====
Ogni utente designato riceve un’email di invito dal supporto LinRT, segue il collegamento, imposta la password personale e completa il profilo. Se il messaggio manca, controllare la posta indesiderata e utilizzare il portale ufficiale. Non condividere la password.
[[https://support.linrt.com/|LinRT HelpDesk ↗]]
===== 2. Preparare la postazione di sviluppo =====
Gli esempi usano terminali Linux/macOS o Git Bash su Windows con OpenSSH. Installare Git, OpenSSH e, per il download di più repository Yocto, lo strumento Google Repo. Verificare le versioni:
ssh -V
git --version
===== 3. Generare la coppia di chiavi SSH =====
Usare chiavi personali per ciascun utente e preferibilmente per ogni postazione. Il ticket HelpDesk attuale si chiama « RSA Key soumission »; l’esempio usa RSA a 4096 bit. Bitbucket Cloud supporta anche Ed25519, ma verificare prima la relativa autorizzazione con LinRT. Impostare una passphrase forte e non sovrascrivere chiavi esistenti.
mkdir -p "$HOME/.ssh"
chmod 700 "$HOME/.ssh"
ssh-keygen -t rsa -b 4096 -C "user@company.example" -f "$HOME/.ssh/linrt_bitbucket"
Vengono create una **chiave privata** ''linrt_bitbucket'' (segreta) e una **chiave pubblica** ''linrt_bitbucket.pub'' (condivisibile). Caricare la chiave privata nell’agente SSH:
eval "$(ssh-agent -s)"
ssh-add "$HOME/.ssh/linrt_bitbucket"
===== 4. Aprire un ticket « RSA Key soumission » =====
Accedere al [[https://support.linrt.com/|LinRT HelpDesk]] e aprire un ticket nella categoria **RSA Key soumission**. Indicare azienda abbonata, email registrata dell’utente e **l’intera riga** del file ''.pub''. Facoltativamente aggiungere l’impronta SHA256. **Non inviare mai chiave privata, passphrase, password o l’intera cartella ''.ssh''.**
cat "$HOME/.ssh/linrt_bitbucket.pub"
ssh-keygen -lf "$HOME/.ssh/linrt_bitbucket.pub"
===== 5. Attendere la conferma di LinRT Support =====
Il supporto verifica la richiesta, registra la chiave pubblica sul servizio Bitbucket LinRT e conferma l’abilitazione dei permessi sui repository appropriati. Registrazione della chiave e autorizzazioni dei repository sono controlli distinti.
===== 6. Testare l’autenticazione SSH =====
Provare la connessione con la chiave privata corrispondente. Al primo collegamento, **confrontare l’impronta della chiave host con i riferimenti ufficiali Atlassian** prima di accettarla.
ssh -T -i "$HOME/.ssh/linrt_bitbucket" -o IdentitiesOnly=yes git@bitbucket.org
Una risposta positiva di Bitbucket Cloud normalmente include:
authenticated via ssh key. You can use git to connect to Bitbucket.
Shell access is disabled
« Shell access is disabled » è normale: Bitbucket fornisce Git via SSH, non una shell interattiva. Un test SSH riuscito non significa accesso a tutti i repository privati. Controllare separatamente il repository dei manifest autorizzato:
git ls-remote git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
===== 7. Recuperare il repository dei manifest =====
Per esempio, il repository dei manifest di LinRT Oxygen può essere clonato via HTTPS. **Attenzione:** l’autenticazione HTTPS è distinta da quella SSH. Questa operazione scarica soltanto i manifest, **non** tutti i sorgenti Yocto:
git clone https://bitbucket.org/linrt/linrt-multifb-oxygen-manifest.git
Se il protocollo approvato è SSH, utilizzare invece l’URL SSH del repository:
git clone git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
===== 8. Inizializzare e sincronizzare le sorgenti Yocto con Repo =====
Repo legge il manifest e recupera i vari progetti Git. Eseguire i comandi in una **nuova directory vuota**. L’esempio usa il ramo predefinito; per una versione specifica Oxygen 5.x/6.x applicare soltanto il **ramo e il file XML forniti dal supporto LinRT**.
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
Un manifest può contenere repository diversi e URL con protocolli differenti. Il clone HTTPS del manifest non configura automaticamente l’accesso SSH agli altri repository.
===== Lista di controllo =====
* Account HelpDesk attivato
* Chiave pubblica inviata con ticket RSA Key soumission
* Conferma del supporto ricevuta
* Test SSH riuscito
* Repository dei manifest accessibile
* Repo sincronizzato sul ramo approvato
===== Risoluzione dei problemi =====
* **Permission denied (publickey):** verificare registrazione della chiave, identità caricate e conferma del supporto.
* **Test SSH corretto ma repository non accessibile:** controllare URL e diritti specifici per repository/ramo.
* **HTTPS richiede credenziali:** la chiave SSH non autentica HTTPS. Usare l’URL SSH o la procedura HTTPS approvata.
* **Host key verification failed:** fermarsi e verificare l’impronta ufficiale; non ignorare l’errore.
* **repo sync non riesce:** verificare manifest, ramo e autorizzazioni per ogni repository; inviare log privi di segreti al HelpDesk.
===== Sicurezza e revoca delle autorizzazioni =====
Trasmettere soltanto chiavi pubbliche. Proteggere quelle private con una passphrase, evitare account condivisi e richiedere al HelpDesk la revoca quando cambia una postazione o un utente lascia il progetto. Password HelpDesk e chiave SSH Bitbucket sono distinte.
===== Riferimenti ufficiali =====
* [[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]]
----
//Guida pubblica per gli abbonati. Repository e rami disponibili dipendono dall’abbonamento e dalle autorizzazioni confermate.//
[[https://support.linrt.com/|LinRT HelpDesk ↗]] · [[:it:start|Wiki]]