Vai al contenuto
KendorDocs

Come importare un repository privato

Per i proprietari ·

Un proprietario dell'organizzazione aggiunge un token di sola lettura per l'host Git in Integrazioni → Host di codice. Poi chiunque crei prove può importare da lì.

Per importare un repository privato, un proprietario dell'organizzazione salva un token di accesso di sola lettura per il suo host Git in Integrazioni, nella sezione Host di codice. Kendor usa poi quel token ogni volta che qualcuno nell'organizzazione verifica o importa un repository da quell'host. C'è un token per host, condiviso da tutta l'organizzazione.

Prima di iniziare

  • Solo i Proprietari possono aggiungere, sostituire o rimuovere i token. Editor e Visualizzatori possono aprire la pagina e vedere quali host sono collegati, ma non modificarli.
  • Editor e Proprietari possono importare repository privati una volta salvato un token. Non vedono mai il token stesso.

Aggiungere un token per GitHub, GitLab o Bitbucket

  1. Apri Integrazioni nella barra laterale.
  2. In Host di codice, scegli Collega sulla scheda GitHub, GitLab o Bitbucket.
  3. Crea un token sull'host (vedi la tabella sotto) e incollalo in Token di sola lettura.
  4. Scegli Salva.

Kendor verifica con l'host i token di GitHub e GitLab quando salvi, e rifiuta quello che l'host respinge. Per Bitbucket non esiste una verifica valida per ogni tipo di token, quindi un token Bitbucket viene messo alla prova per la prima volta dalla tua prossima importazione.

Una volta salvato, la pagina mostra Collegato, gli ultimi quattro caratteri del token, la data in cui è stato aggiunto e chi l'ha aggiunto.

Quale token creare

Kendor legge soltanto i repository, quindi usa un token che non possa fare push. Il suggerimento sotto il campo del token nella pagina di ogni host dice la stessa cosa:

Host Token Permesso
GitHub Fine-grained personal access token, con Repository access impostato sui repository che importi (non su "Public repositories", il valore predefinito) Contents: Read-only
GitHub (alternativa) Token classic Scope repo. Funziona, ma può anche scrivere su ogni repository a cui hai accesso.
GitLab Token di accesso personale, di gruppo o di progetto read_repository
Bitbucket Token di accesso di repository, di progetto o di workspace Repositories: Read

Per un token API Atlassian di Bitbucket, compila anche Email dell'account (solo token API Atlassian) con l'email dell'account Atlassian a cui appartiene il token. Lascialo vuoto per i token di accesso di repository, progetto e workspace.

Suggerimento. Un token GitHub aiuta anche con i repository pubblici di github.com: le importazioni passano dal limite di richieste del tuo token invece che da quello condiviso.

Aggiungere un server self-hosted

I server GitHub Enterprise Server, GitLab self-managed, Gitea e Forgejo si aggiungono dalla scheda Server self-hosted. Kendor importa solo da un server che la tua organizzazione ha aggiunto, e ogni server ha il proprio token.

  1. In Host di codice, scegli Collega su Server self-hosted.
  2. Scegli il Tipo di server: GitLab (self-managed), GitHub Enterprise Server o Gitea o Forgejo.
  3. Inserisci il Nome del server, come git.example.com. Inserisci solo il nome: niente porta, percorso o indirizzo IP.
  4. Incolla un Token di sola lettura con gli stessi permessi della versione cloud di quell'host.
  5. Scegli Aggiungi server.

Kendor verifica il token con il server prima di salvare. Se il server risponde ma non è del tipo che hai scelto, vedrai un messaggio che dice che non sembra quel tipo di server.

Nota. Il server deve essere raggiungibile da internet via HTTPS sulla porta standard. Kendor rifiuta gli indirizzi nelle reti private, quindi un server disponibile solo dentro la rete aziendale o tramite VPN non può essere usato. Bitbucket Data Center non è supportato.

Come vengono conservati i token

  • I token vengono cifrati prima di essere memorizzati e sono usati solo per scaricare il repository che importi.
  • Kendor non mostra mai più un token dopo che l'hai salvato. La pagina mostra solo gli ultimi quattro caratteri, la data in cui è stato aggiunto e chi l'ha aggiunto.
  • Un token viene inviato solo all'host per cui è stato salvato.

Sostituire o rimuovere un token

Nella pagina dell'host, scegli Sostituisci per incollare un nuovo token, oppure Rimuovi per eliminarlo. La rimozione chiede prima una conferma.

Dopo la rimozione di un token:

  • Le sfide che hai già importato conservano il loro codice. Nelle tue prove o nei tuoi colloqui di coding dal vivo non cambia nulla.
  • Le nuove importazioni di repository privati da quell'host smettono di funzionare finché qualcuno non aggiunge di nuovo un token. I repository pubblici su github.com, gitlab.com e bitbucket.org continuano a essere importati.
  • Per un server self-hosted, rimuovere il suo token rimuove anche il server. I link verso di esso vengono poi trattati come un host sconosciuto.

Errori che indicano un token mancante o errato

Quando un token risolverebbe una verifica fallita, l'errore include un link Collegalo nelle impostazioni Integrazioni che si apre in una nuova scheda. I messaggi più comuni:

  • Repository or ref not found … If it's private, connect a GitHub token. Gli host Git rispondono "non trovato" per i repository privati quando non viene inviato alcun token. Controlla l'ortografia del link e del branch, poi aggiungi un token.
  • Repository or ref not found … or the organization's token can't read it. Un token è salvato, ma non copre questo repository. Per un token GitHub fine-grained, aggiungi il repository al suo elenco di accesso ai repository.
  • … rejected the organization's token. Il token è scaduto o è stato revocato. Sostituiscilo.
  • … isn't connected. Add it under Settings → Integrations to import from it. Il link punta a un server che la tua organizzazione non ha aggiunto. Aggiungilo come server self-hosted.

Dopo aver sistemato il token, torna indietro e scegli di nuovo Verifica.

Questo articolo ti è stato utile?