Saltar al contenido
KendorDocs

Cómo importar un repositorio privado

Para propietarios ·

Un propietario de la organización añade un token de solo lectura del servicio de Git en Integraciones → Servicios de código. Después, cualquiera que cree pruebas puede importar desde él.

Para importar un repositorio privado, un propietario de la organización guarda un token de acceso de solo lectura de su servicio de Git en Integraciones, en la sección Servicios de código. Kendor usa entonces ese token siempre que alguien de la organización comprueba o importa un repositorio de ese servicio. Hay un token por servicio, compartido por toda la organización.

Antes de empezar

  • Solo los Propietarios pueden añadir, reemplazar o quitar tokens. Los editores y los lectores pueden abrir la página y ver qué servicios están conectados, pero no cambiarlos.
  • Los editores y los propietarios pueden importar repositorios privados una vez guardado un token. Nunca ven el token en sí.

Añade un token para GitHub, GitLab o Bitbucket

  1. Abre Integraciones en la barra lateral.
  2. En Servicios de código, elige Conectar en la tarjeta de GitHub, GitLab o Bitbucket.
  3. Crea un token en el servicio (consulta la tabla de abajo) y pégalo en Token de solo lectura.
  4. Elige Guardar.

Kendor comprueba con el servicio los tokens de GitHub y GitLab al guardar, y rechaza el que el servicio no acepte. Bitbucket no tiene una comprobación que funcione con todos los tipos de token, así que un token de Bitbucket se prueba por primera vez en tu siguiente importación.

Una vez guardado, la página muestra Conectado, los cuatro últimos caracteres del token, la fecha en que se añadió y quién lo añadió.

Qué token crear

Kendor solo lee repositorios, así que usa un token que no pueda escribir. La indicación bajo el campo del token en la página de cada servicio dice lo mismo:

Servicio Token Permiso
GitHub Token de acceso personal de granularidad fina, con Repository access establecido en los repositorios que importas (no en «Public repositories», que es el valor por defecto) Contents: Read-only
GitHub (alternativa) Token clásico Ámbito repo. Funciona, pero también puede escribir en todos los repositorios en los que puedas escribir tú.
GitLab Token de acceso personal, de grupo o de proyecto read_repository
Bitbucket Token de acceso de repositorio, de proyecto o de workspace Repositories: Read

Para un token de API de Atlassian de Bitbucket, rellena también Email de la cuenta (solo tokens de API de Atlassian) con el correo de la cuenta de Atlassian a la que pertenece el token. Déjalo vacío para los tokens de acceso de repositorio, de proyecto y de workspace.

Consejo. Un token de GitHub también ayuda con los repositorios públicos de github.com: las importaciones pasan por el límite de peticiones propio de tu token en lugar del compartido.

Añade un servidor propio

Los servidores de GitHub Enterprise Server, GitLab autogestionado, Gitea y Forgejo se añaden en la tarjeta Servidores propios. Kendor solo importa desde un servidor que tu organización haya añadido, y cada servidor tiene su propio token.

  1. En Servicios de código, elige Conectar en Servidores propios.
  2. Elige el Tipo de servidor: GitLab (autogestionado), GitHub Enterprise Server o Gitea o Forgejo.
  3. Introduce el Nombre del servidor, como git.example.com. Introduce solo el nombre: sin puerto, ruta ni dirección IP.
  4. Pega un Token de solo lectura con los mismos permisos que en la versión en la nube de ese servicio.
  5. Elige Añadir servidor.

Kendor comprueba el token con el servidor antes de guardarlo. Si el servidor responde pero no es del tipo que elegiste, verás un mensaje que indica que no parece ese tipo de servidor.

Nota. El servidor debe ser accesible desde internet por HTTPS en el puerto estándar. Kendor rechaza las direcciones de redes privadas, así que no se puede usar un servidor disponible solo dentro de la red de tu empresa o mediante una VPN. Bitbucket Data Center no es compatible.

Cómo se guardan los tokens

  • Los tokens se cifran antes de guardarse y solo se usan para descargar el repositorio que importas.
  • Kendor nunca vuelve a mostrar un token después de guardarlo. La página solo muestra los cuatro últimos caracteres, la fecha en que se añadió y quién lo añadió.
  • Un token solo se envía al servicio para el que se guardó.

Reemplaza o quita un token

En la página del servicio, elige Reemplazar para pegar un token nuevo, o Eliminar para borrarlo. Eliminar te pide confirmación antes.

Cuando se quita un token:

  • Los retos que ya importaste conservan su código. No cambia nada en tus pruebas ni en tus entrevistas de programación en vivo.
  • Las nuevas importaciones de repositorios privados de ese servicio dejan de funcionar hasta que alguien vuelva a añadir un token. Los repositorios públicos de github.com, gitlab.com y bitbucket.org se siguen importando.
  • En un servidor propio, quitar su token también quita el servidor. Los enlaces a él se tratan entonces como un servicio desconocido.

Errores que indican que falta un token o que es incorrecto

Cuando un token solucionaría una comprobación fallida, el error incluye un enlace Conéctalo en los ajustes de Integraciones que se abre en una pestaña nueva. Los mensajes habituales (se muestran en inglés):

  • Repository or ref not found … If it's private, connect a GitHub token. Los servicios de Git responden «no encontrado» para los repositorios privados cuando no se envía ningún token. Comprueba la ortografía del enlace y de la rama y luego añade un token.
  • Repository or ref not found … or the organization's token can't read it. Hay un token guardado, pero no cubre este repositorio. En un token de GitHub de granularidad fina, añade el repositorio a su lista de acceso a repositorios.
  • … rejected the organization's token. El token ha caducado o se ha revocado. Reemplázalo.
  • … isn't connected. Add it under Settings → Integrations to import from it. El enlace apunta a un servidor que tu organización no ha añadido. Añádelo como servidor propio.

Después de arreglar el token, vuelve atrás y elige Comprobar otra vez.

¿Te ha resultado útil este artículo?