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