GitHub

GitHub se connecte avec un jeton d’accès personnel (fine-grained ou classic). Il n’y a pas d’option OAuth ni GitHub App, et rien n’est enregistré côté GitHub hormis le jeton lui-même.

AppArch communique avec api.github.com ; seul github.com est donc pris en charge. GitHub Enterprise Server ne l’est pas.

Connexion

1. Sur GitHub, ouvrez Settings → Developer settings → Personal access tokens et créez un jeton.
2. Dans AppArch, ouvrez Credentials → Add credential → GitHub, collez le jeton et enregistrez. Le nom de l’organisation ou de l’utilisateur est facultatif.
3. Connectez des projets à partir des dépôts visibles par le jeton.

Permissions

• Jeton classic : le scope repo. Un jeton classic sans repo est refusé à l’enregistrement. AppArch lit les scopes et la date d’expiration auprès de GitHub avant d’enregistrer le jeton.
• Jeton fine-grained : accès en lecture aux dépôts à auditer. Les jetons fine-grained ne déclarent aucun scope ; c’est le test de connexion qui tranche. Pour qu’ArchPilot puisse commenter, le jeton a aussi besoin de Pull requests: Read and write.

Ce que cela permet

• ArchPilot commente les pull requests.
• Les résultats ArchScan / ArchSecurity des exécutions CI apparaissent dans le panneau.

Un jeton ne peut pas recevoir de webhooks ; AppArch apprend donc les changements des pull requests par interrogation périodique (polling) et non par événements instantanés.

Expiration

La date d’expiration signalée par GitHub est affichée sur l’identifiant. Un jeton expiré ne fonctionne plus ; créez un nouveau jeton et ajoutez-le comme nouvel identifiant.

CI

Ajoutez le runner à GitHub Actions - voir Ajouter le runner à la CI.

Note

Les commentaires sont publiés par le compte propriétaire du jeton ; un compte bot dédié les sépare de l’activité d’une personne. Voir Activer ArchPilot.