Aller au contenu

Autorisations des jetons

Pullwatch ne fait que lire. Donnez à un jeton les autorisations en lecture ci-dessous, et rien de plus. Quand il manque une autorisation pour une partie facultative, cette partie indique Autorisation requise avec un lien, et le reste continue de fonctionner.

Fine-grained token, sur les dépôts que vous voulez suivre :

Autorisation Nécessaire pour
Pull requests: Read les pull requests
Metadata: Read les dépôts (toujours obligatoire)
Contents: Read la vérification des dépendances (manifestes et fichiers de verrouillage)
Repository security advisories: Read les avis propres du dépôt
Code scanning alerts: Read facultatif, les alertes d’analyse du code
Secret scanning alerts: Read facultatif, le nombre d’alertes d’analyse des secrets ouvertes
Checks: Read et Commit statuses: Read facultatif, les checks de chaque pull request

Classic token : repo, plus security_events pour les alertes d’analyse du code et d’analyse des secrets.

Se connecter avec GitHub utilise la GitHub App Pullwatch, qui demande les mêmes autorisations en lecture. Le propriétaire de chaque installation les accepte ; quand l’app obtient une nouvelle autorisation, GitHub demande au propriétaire de l’accepter une nouvelle fois.

Créez le jeton sur votre propre serveur. Classic : repo et read:org, plus security_events pour les alertes. Créer un jeton dans l’éditeur de compte ouvre la page des jetons du serveur avec ces portées déjà remplies. Les fine-grained tokens demandent les mêmes autorisations que sur github.com.

Avec la GitHub CLI, Pullwatch exécute gh auth token --hostname <server>. Connectez-vous d’abord avec gh auth login --hostname <server>.

Portée Nécessaire pour
Code (Read) les pull requests, les tags et la vérification des dépendances
Project and Team (Read) la liste des projets
Advanced Security (Read) facultatif, les alertes Advanced Security

Avec Azure CLI, connectez-vous avec az login ; Pullwatch demande un jeton à az.

Un jeton d’accès personnel avec la portée read_api couvre les merge requests, les projets, les tags, les versions publiées, les commits et les fichiers. api fonctionne aussi, mais donne plus que ce dont Pullwatch a besoin. Avec la GitLab CLI, Pullwatch lit glab config get token --host <server>.

Avec gh, az ou glab, Pullwatch obtient le jeton de l’outil en ligne de commande : vous vous connectez donc dans cet outil et non dans Pullwatch. Les appels à ces outils expirent après 20 secondes.