====== Acceso a los repositorios de código fuente de LinRT BSP ======
**Guía pública — activación de la suscripción, registro de una clave SSH y acceso a los fuentes Yocto mediante Git y Repo.**
===== Esquema del proceso de acceso =====
{{:linrt:public:source-access-flow-es.png?960|Esquema del proceso de acceso}}
//Esquema: activación de la cuenta y acceso SSH; se requiere autorización para cada etapa.//
===== ¿Quién puede solicitar acceso? =====
Tras la aprobación de la suscripción, LinRT HelpDesk invita individualmente a los usuarios designados por el cliente (de uno a tres como máximo, según el plan de soporte). El acceso es personal y se limita a los repositorios y ramas autorizados. Disponer de una cuenta HelpDesk no concede automáticamente acceso a Git.
===== 1. Activar la cuenta LinRT HelpDesk =====
Cada usuario designado recibe un correo de invitación del soporte LinRT. Debe seguir el enlace, establecer una contraseña personal y completar su perfil. Si no recibe el mensaje, compruebe la carpeta de correo no deseado y utilice el portal oficial. No comparta su contraseña de HelpDesk.
[[https://support.linrt.com/|LinRT HelpDesk ↗]]
===== 2. Preparar el equipo de desarrollo =====
Los ejemplos funcionan en terminales Linux/macOS o Git Bash de Windows con OpenSSH. Se necesitan Git, OpenSSH y, para varios repositorios Yocto, la herramienta Google Repo. Compruebe las herramientas:
ssh -V
git --version
===== 3. Crear un par de claves SSH =====
Utilice una clave personal por usuario autorizado y, preferiblemente, por equipo. El ticket actual se llama « RSA Key soumission »; el ejemplo usa RSA de 4096 bits. Bitbucket Cloud también admite Ed25519, pero confirme previamente su aceptación con LinRT. Proteja la clave mediante una frase de contraseña y no sobrescriba claves existentes.
mkdir -p "$HOME/.ssh"
chmod 700 "$HOME/.ssh"
ssh-keygen -t rsa -b 4096 -C "user@company.example" -f "$HOME/.ssh/linrt_bitbucket"
Se generan una **clave privada** ''linrt_bitbucket'' (secreta) y una **clave pública** ''linrt_bitbucket.pub'' (compartible). Añada la clave privada al agente SSH:
eval "$(ssh-agent -s)"
ssh-add "$HOME/.ssh/linrt_bitbucket"
===== 4. Abrir el ticket « RSA Key soumission » =====
Entre en el [[https://support.linrt.com/|HelpDesk LinRT]] y cree un ticket de tipo **RSA Key soumission**. Adjunte el nombre de la empresa suscrita, el correo registrado del usuario y **toda la línea** del archivo ''.pub''. Opcionalmente, incluya la huella SHA256. **Nunca envíe la clave privada, frase secreta, contraseña ni el directorio ''.ssh'' completo.**
cat "$HOME/.ssh/linrt_bitbucket.pub"
ssh-keygen -lf "$HOME/.ssh/linrt_bitbucket.pub"
===== 5. Esperar la confirmación de LinRT Support =====
El soporte revisa la solicitud, registra la clave pública en Bitbucket LinRT y confirma que se han habilitado los permisos correspondientes. El registro de la clave y la autorización del repositorio son comprobaciones distintas.
===== 6. Probar la autenticación SSH =====
Pruebe la conexión con la clave privada correspondiente. En la primera conexión, **verifique la huella de la clave del servidor con la referencia oficial de Atlassian** antes de aceptarla.
ssh -T -i "$HOME/.ssh/linrt_bitbucket" -o IdentitiesOnly=yes git@bitbucket.org
Una respuesta correcta de Bitbucket Cloud suele incluir:
authenticated via ssh key. You can use git to connect to Bitbucket.
Shell access is disabled
« Shell access is disabled » es normal: Bitbucket permite Git por SSH pero no una consola interactiva. La autenticación SSH no garantiza permisos para todos los repositorios. Compruebe el repositorio de manifiestos autorizado:
git ls-remote git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
===== 7. Descargar el repositorio de manifiestos =====
Como ejemplo, los manifiestos de LinRT Oxygen pueden clonarse por HTTPS. **Importante:** la autenticación HTTPS es independiente de las claves SSH. Esto descarga solo los manifiestos, no todos los fuentes Yocto:
git clone https://bitbucket.org/linrt/linrt-multifb-oxygen-manifest.git
Si el método aprobado es SSH, use la dirección SSH del repositorio:
git clone git@bitbucket.org:linrt/linrt-multifb-oxygen-manifest.git
===== 8. Inicializar y sincronizar fuentes Yocto con Repo =====
Repo procesa el manifiesto y descarga los proyectos Git. Ejecute lo siguiente en un **directorio vacío**. Se usa la rama predeterminada; para una versión Oxygen 5.x/6.x específica, siga la **rama y el XML indicados por LinRT Support**.
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
El manifiesto puede contener distintos repositorios y protocolos. Clonar el manifiesto por HTTPS no configura automáticamente el acceso SSH a otros repositorios.
===== Lista de verificación =====
* Cuenta HelpDesk activada
* Clave pública enviada mediante ticket RSA Key soumission
* Confirmación de registro recibida
* Autenticación SSH correcta
* Repositorio de manifiestos accesible
* Repo sincronizado con la rama aprobada
===== Solución de problemas =====
* **Permission denied (publickey):** compruebe el registro de la clave, las identidades cargadas y los permisos comunicados por soporte.
* **SSH correcto pero repositorio inaccesible:** verifique la URL y los permisos específicos del repositorio y la rama.
* **HTTPS solicita credenciales:** las claves SSH no autentican HTTPS; utilice la URL SSH o el procedimiento HTTPS autorizado.
* **Host key verification failed:** deténgase y compare con las huellas oficiales; no omita la comprobación.
* **repo sync falla:** compruebe rama, manifiesto y permisos para cada repositorio; envíe registros depurados al HelpDesk.
===== Seguridad y revocación =====
Comparta solo claves públicas; proteja las privadas con una frase secreta. No comparta cuentas. Solicite al HelpDesk la revocación de las claves de equipos antiguos o usuarios que abandonan el proyecto. La cuenta HelpDesk y la autenticación SSH son independientes.
===== Referencias oficiales =====
* [[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]]
----
//Guía pública de incorporación. La disponibilidad de los repositorios depende de la suscripción y de los permisos concedidos.//
[[https://support.linrt.com/|LinRT HelpDesk ↗]] · [[:es:start|Wiki]]