====== 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]]