GitHub

GitHub se conecta con un token de acceso personal (fine-grained o classic). No hay opción de OAuth ni de GitHub App, y no se registra nada en GitHub aparte del propio token.

AppArch se comunica con api.github.com, así que solo se admite github.com. GitHub Enterprise Server no se admite.

Conexión

1. En GitHub abre Settings → Developer settings → Personal access tokens y crea un token.
2. En AppArch abre Credentials → Add credential → GitHub, pega el token y guarda. El nombre de organización o usuario es opcional.
3. Conecta proyectos de los repositorios que el token puede ver.

Permisos

• Token classic: el scope repo. Un token classic sin repo se rechaza al guardarlo. AppArch lee los scopes y la fecha de caducidad en GitHub antes de guardar el token.
• Token fine-grained: acceso de lectura a los repositorios que quieres auditar. Los tokens fine-grained no informan scopes, así que decide la prueba de conexión. Para que ArchPilot pueda comentar, el token necesita además Pull requests: Read and write.

Qué permite

• ArchPilot comenta en las pull requests.
• Los resultados de ArchScan / ArchSecurity de las ejecuciones de CI aparecen en el panel.

Un token no puede recibir webhooks; AppArch conoce los cambios de las pull requests mediante sondeo (polling), no mediante eventos instantáneos.

Caducidad

La fecha de caducidad que informa GitHub se muestra en la credencial. Un token caducado deja de funcionar; crea un token nuevo y añádelo como una credencial nueva.

CI

Añade el runner a GitHub Actions; consulta Añadir el runner a la CI.

Nota

Los comentarios los publica la cuenta propietaria del token; una cuenta bot dedicada los separa de la actividad de una persona. Consulta Activar ArchPilot.