Como importar um repositório privado
Um proprietário da organização adiciona um token só de leitura para o anfitrião Git em Integrações → Hosts de código. Depois, qualquer pessoa que crie triagens pode importar a partir dele.
Para importar um repositório privado, um proprietário da organização guarda um token de acesso só de leitura para o respetivo anfitrião Git em Integrações, na secção Hosts de código. O Kendor usa então esse token sempre que alguém da organização verifica ou importa um repositório desse anfitrião. Há um token por anfitrião, partilhado por toda a organização.
Antes de começares
- Só os Proprietários podem adicionar, substituir ou remover tokens. Os editores e os leitores podem abrir a página e ver que anfitriões estão ligados, mas não os alterar.
- Os editores e os proprietários podem importar repositórios privados assim que um token estiver guardado. Nunca veem o token em si.
Adicionar um token para o GitHub, GitLab ou Bitbucket
- Abre Integrações na barra lateral.
- Em Hosts de código, escolhe Conectar no cartão do GitHub, GitLab ou Bitbucket.
- Cria um token no anfitrião (vê a tabela abaixo) e cola-o em Token só de leitura.
- Escolhe Guardar.
O Kendor verifica os tokens do GitHub e do GitLab com o anfitrião quando guardas, e recusa um que o anfitrião rejeite. O Bitbucket não tem uma verificação que funcione para todos os tipos de token, por isso um token do Bitbucket é testado primeiro pela tua próxima importação.
Depois de guardado, a página mostra Ligado, os últimos quatro carateres do token, a data em que foi adicionado e quem o adicionou.
Que token criar
O Kendor só lê repositórios, por isso usa um token que não consiga fazer push. A dica por baixo do campo do token na página de cada anfitrião diz o mesmo:
| Anfitrião | Token | Permissão |
|---|---|---|
| GitHub | Token de acesso pessoal de granularidade fina, com Repository access definido para os repositórios que importas (não "Public repositories", a predefinição) | Contents: Read-only |
| GitHub (alternativa) | Token clássico | Âmbito repo. Funciona, mas também pode escrever em todos os repositórios a que tens acesso. |
| GitLab | Token de acesso pessoal, de grupo ou de projeto | read_repository |
| Bitbucket | Token de acesso de repositório, de projeto ou de workspace | Repositories: Read |
Para um token de API Atlassian do Bitbucket, preenche também E-mail da conta (somente tokens de API da Atlassian) com o email da conta Atlassian a que o token pertence. Deixa vazio para tokens de acesso de repositório, de projeto e de workspace.
Dica. Um token do GitHub também ajuda com repositórios públicos do github.com: as importações passam pelo limite de pedidos do teu token em vez do partilhado.
Adicionar um servidor auto-alojado
Os servidores GitHub Enterprise Server, GitLab autogerenciado, Gitea e Forgejo são adicionados no cartão Servidores próprios. O Kendor só importa de um servidor que a tua organização tenha adicionado, e cada servidor tem o seu próprio token.
- Em Hosts de código, escolhe Conectar em Servidores próprios.
- Escolhe o Tipo de servidor: GitLab (autogerenciado), GitHub Enterprise Server ou Gitea ou Forgejo.
- Indica o Nome do servidor, como
git.example.com. Indica apenas o nome: sem porta, caminho nem endereço IP. - Cola um Token só de leitura com as mesmas permissões que para a versão cloud desse anfitrião.
- Escolhe Adicionar servidor.
O Kendor verifica o token com o servidor antes de guardar. Se o servidor responder mas não for do tipo que escolheste, vês uma mensagem a dizer que não parece ser esse tipo de servidor.
Nota. O servidor tem de ser acessível a partir da internet por HTTPS na porta standard. O Kendor recusa endereços em redes privadas, por isso um servidor disponível apenas dentro da rede da tua empresa ou por VPN não pode ser usado. O Bitbucket Data Center não é suportado.
Como os tokens são guardados
- Os tokens são encriptados antes de serem guardados, e só são usados para transferir o repositório que importas.
- O Kendor nunca volta a mostrar um token depois de o guardares. A página mostra apenas os últimos quatro carateres, a data em que foi adicionado e quem o adicionou.
- Um token só é enviado ao anfitrião para o qual foi guardado.
Substituir ou remover um token
Na página do anfitrião, escolhe Substituir para colar um novo token, ou Remover para o apagar. Remover pede-te primeiro que confirmes.
Depois de um token ser removido:
- Os desafios que já importaste mantêm o seu código. Nada nas tuas triagens ou entrevistas de programação ao vivo muda.
- As novas importações de repositórios privados desse anfitrião deixam de funcionar até alguém voltar a adicionar um token. Os repositórios públicos do github.com, gitlab.com e bitbucket.org continuam a importar.
- Para um servidor auto-alojado, remover o seu token remove também o servidor. As ligações para ele passam então a ser tratadas como um anfitrião desconhecido.
Erros que significam que falta um token ou que está errado
Quando um token resolveria uma verificação falhada, o erro tem uma ligação Conecte nas configurações de Integrações que abre num novo separador. As mensagens mais comuns:
- Repository or ref not found … If it's private, connect a GitHub token. Os anfitriões Git respondem "not found" para repositórios privados quando não é enviado nenhum token. Verifica a grafia da ligação e do ramo e depois adiciona um token.
- Repository or ref not found … or the organization's token can't read it. Há um token guardado, mas não cobre este repositório. Para um token do GitHub de granularidade fina, adiciona o repositório à lista de acesso a repositórios dele.
- … rejected the organization's token. O token expirou ou foi revogado. Substitui-o.
- … isn't connected. Add it under Settings → Integrations to import from it. A ligação aponta para um servidor que a tua organização não adicionou. Adiciona-o como servidor auto-alojado.
Depois de corrigires o token, volta atrás e escolhe Verificar outra vez.