Comment importer un dépôt privé
Un propriétaire de l’organisation ajoute un jeton en lecture seule pour l’hébergeur Git sous Intégrations → Hébergeurs de code. Ensuite, toute personne qui crée des épreuves peut importer depuis cet hébergeur.
Pour importer un dépôt privé, un propriétaire de l’organisation enregistre un jeton d’accès en lecture seule pour son hébergeur Git sous Intégrations, dans la section Hébergeurs de code. Kendor utilise ensuite ce jeton chaque fois qu’une personne de l’organisation vérifie ou importe un dépôt depuis cet hébergeur. Il y a un seul jeton par hébergeur, partagé par toute l’organisation.
Avant de commencer
- Seuls les Propriétaires peuvent ajouter, remplacer ou supprimer des jetons. Les éditeurs et les lecteurs peuvent ouvrir la page et voir quels hébergeurs sont connectés, mais pas les modifier.
- Les éditeurs et les propriétaires peuvent importer des dépôts privés une fois qu’un jeton est enregistré. Ils ne voient jamais le jeton lui-même.
Ajouter un jeton pour GitHub, GitLab ou Bitbucket
- Ouvrez Intégrations dans la barre latérale.
- Dans Hébergeurs de code, choisissez Connecter sur la carte GitHub, GitLab ou Bitbucket.
- Créez un jeton chez l’hébergeur (voir le tableau ci-dessous) et collez-le dans Jeton en lecture seule.
- Choisissez Enregistrer.
Kendor vérifie les jetons GitHub et GitLab auprès de l’hébergeur à l’enregistrement, et refuse celui que l’hébergeur rejette. Bitbucket n’a pas de vérification valable pour tous les types de jetons : un jeton Bitbucket est donc d’abord testé par votre prochain import.
Une fois enregistré, la page affiche Connecté, les quatre derniers caractères du jeton, la date d’ajout et la personne qui l’a ajouté.
Quel jeton créer
Kendor ne fait que lire les dépôts : utilisez donc un jeton qui ne peut pas pousser. L’indication sous le champ du jeton sur la page de chaque hébergeur dit la même chose :
| Hébergeur | Jeton | Autorisation |
|---|---|---|
| GitHub | Jeton d’accès personnel à granularité fine, avec Accès aux dépôts réglé sur les dépôts que vous importez (pas « Dépôts publics », la valeur par défaut) | Contents: Read-only |
| GitHub (alternative) | Jeton classique | Portée repo. Cela fonctionne, mais il peut aussi écrire dans tous les dépôts auxquels vous avez accès. |
| GitLab | Jeton d’accès personnel, de groupe ou de projet | read_repository |
| Bitbucket | Jeton d’accès de dépôt, de projet ou d’espace de travail | Repositories: Read |
Pour un jeton d’API Atlassian Bitbucket, renseignez aussi E-mail du compte (jetons d'API Atlassian uniquement) avec l’e-mail du compte Atlassian auquel appartient le jeton. Laissez-le vide pour les jetons d’accès de dépôt, de projet et d’espace de travail.
Astuce. Un jeton GitHub aide aussi pour les dépôts publics de github.com : les imports passent par la limite de débit propre à votre jeton plutôt que par la limite partagée.
Ajouter un serveur auto-hébergé
Les serveurs GitHub Enterprise Server, GitLab autogéré, Gitea et Forgejo s’ajoutent sur la carte Serveurs auto-hébergés. Kendor n’importe que depuis un serveur que votre organisation a ajouté, et chaque serveur a son propre jeton.
- Dans Hébergeurs de code, choisissez Connecter sur Serveurs auto-hébergés.
- Choisissez le Type de serveur : GitLab (autogéré), GitHub Enterprise Server ou Gitea ou Forgejo.
- Saisissez le Nom du serveur, comme
git.example.com. Saisissez uniquement le nom : pas de port, de chemin ni d’adresse IP. - Collez un Jeton en lecture seule avec les mêmes autorisations que pour la version cloud de cet hébergeur.
- Choisissez Ajouter le serveur.
Kendor vérifie le jeton auprès du serveur avant d’enregistrer. Si le serveur répond mais n’est pas du type que vous avez choisi, vous verrez un message indiquant qu’il ne ressemble pas à ce type de serveur.
Remarque. Le serveur doit être joignable depuis Internet en HTTPS sur le port standard. Kendor refuse les adresses de réseaux privés : un serveur uniquement disponible dans le réseau de votre entreprise ou via un VPN ne peut donc pas être utilisé. Bitbucket Data Center n’est pas pris en charge.
Comment les jetons sont stockés
- Les jetons sont chiffrés avant d’être stockés, et ne servent qu’à télécharger le dépôt que vous importez.
- Kendor n’affiche plus jamais un jeton après son enregistrement. La page affiche uniquement les quatre derniers caractères, la date d’ajout et la personne qui l’a ajouté.
- Un jeton n’est jamais envoyé qu’à l’hébergeur pour lequel il a été enregistré.
Remplacer ou supprimer un jeton
Sur la page de l’hébergeur, choisissez Remplacer pour coller un nouveau jeton, ou Supprimer pour l’effacer. La suppression demande d’abord une confirmation.
Une fois un jeton supprimé :
- Les exercices que vous avez déjà importés conservent leur code. Rien ne change dans vos épreuves ou vos entretiens de codage en direct.
- Les nouveaux imports de dépôts privés depuis cet hébergeur cessent de fonctionner tant que quelqu’un n’a pas de nouveau ajouté un jeton. Les dépôts publics sur github.com, gitlab.com et bitbucket.org s’importent toujours.
- Pour un serveur auto-hébergé, supprimer son jeton supprime aussi le serveur. Les liens qui y mènent sont alors traités comme un hébergeur inconnu.
Erreurs signalant un jeton manquant ou erroné
Quand un jeton réglerait l’échec d’une vérification, l’erreur comporte un lien Connectez-le dans les paramètres Intégrations qui s’ouvre dans un nouvel onglet. Les messages courants :
- Repository or ref not found … If it's private, connect a GitHub token. Les hébergeurs Git répondent « introuvable » pour les dépôts privés quand aucun jeton n’est envoyé. Vérifiez l’orthographe du lien et de la branche, puis ajoutez un jeton.
- Repository or ref not found … or the organization's token can't read it. Un jeton est enregistré, mais il ne couvre pas ce dépôt. Pour un jeton GitHub à granularité fine, ajoutez le dépôt à sa liste d’accès aux dépôts.
- … rejected the organization's token. Le jeton a expiré ou a été révoqué. Remplacez-le.
- … isn't connected. Add it under Settings → Integrations to import from it. Le lien pointe vers un serveur que votre organisation n’a pas ajouté. Ajoutez-le comme serveur auto-hébergé.
Après avoir corrigé le jeton, revenez en arrière et choisissez de nouveau Vérifier.