Ce que cette connexion vous apporte
Installer l’application Zinn® GitHub permet à un site d’effectuer des déploiements à partir de vos dépôts — et à un tableau de projet de rester synchronisé avec GitHub — sans avoir à nous transmettre de jeton personnel. Nous ne conservons que le numéro d’installation de l’application, qui est inutilisable à lui seul, et nous générons un jeton valable une heure chaque fois que nous en avons besoin. C’est le meilleur choix pour une organisation, car il n’appartient à aucune personne en particulier et ne cesse pas de fonctionner lors du départ d’un membre.
Avant de commencer
Un compte GitHub, ou des droits de propriétaire sur l’organisation dans laquelle vous souhaitez installer l’application. Les organisations qui interdisent les applications tierces nécessitent l’autorisation d’un propriétaire ; si cela n’est pas possible, utilisez plutôt un jeton à granularité fine (Connecter votre compte GitHub).
1. Créer la clé sur GitHub
Il n’y a aucune clé à créer. Installez l’application Zinn® GitHub sur votre compte personnel ou sur votre organisation, puis choisissez soit tous les dépôts, soit uniquement ceux que vous souhaitez que nous déployions.
Trouvez ensuite le numéro d’installation :
- Compte personnel — Settings → Applications → Installed GitHub Apps, puis Configure à côté de l’application Zinn®.
- Organisation — Your organizations → Settings → GitHub Apps, puis Configure à côté de l’application Zinn®.
Le numéro situé à la fin de la barre d’adresse sur cette page — par exemple github.com/settings/installations/12345678 — est le numéro d’installation.
2. La connecter ici
L’application se sélectionne là où elle est utilisée plutôt que sur l’écran Intégrations :
- Sur la connexion de dépôt d’un site, choisissez GitHub (app install).
- Sur le lien GitHub d’un tableau de projet, choisissez The Zinn® GitHub app.
Collez le Numéro d’installation et continuez. Nous vérifions l’installation avant d’enregistrer quoi que ce soit ; un numéro auquel nous ne pouvons pas accéder n’est jamais stocké.
Ce qui se passe ensuite
- Les dépôts que vous avez accordés à l’application apparaissent pour que le site puisse s’y déployer, et un push déclenche le déploiement.
- Chaque action que nous effectuons apparaît dans le journal d’audit de l’installation sur GitHub sous le nom de l’application, et non le vôtre.
- Pour nous donner accès à d’autres dépôts, modifiez l’accès aux dépôts de l’application sur la même page Configure — aucune reconnexion n’est nécessaire.
En cas de problème de connexion
Un dépôt est manquant. L’installation ne couvre que les dépôts que vous avez choisis. Ouvrez Configure et ajoutez-le.
Le numéro est refusé. Vérifiez qu’il s’agit bien du numéro d’installation figurant dans la barre d’adresse, et non de l’identifiant propre à l’application, et que l’application est toujours installée — une application désinstallée ne possède aucune installation.
La clé est indiquée comme rejetée. Il s’agit presque toujours de l’une de ces trois causes : un espace ou un saut de ligne copié avec la clé, une clé expirée, ou une clé révoquée ou régénérée après sa copie. Créez-en une nouvelle et collez-la à nouveau.
La connexion s’établit, mais une erreur survient ultérieurement. La clé s’authentifie mais ne dispose pas d’une autorisation requise par l’action. Créez une nouvelle clé avec les autorisations énumérées ci-dessus, puis déconnectez l’ancienne connexion et connectez la nouvelle clé.
Déconnexion
Ouvrez Integrations, trouvez le compte et appuyez sur Disconnect. Cela supprime immédiatement la clé stockée. Tout élément qui l’utilisait s’arrête lors de sa prochaine action, et les écrans qui en dépendaient le signalent au lieu d’échouer silencieusement.
La déconnexion n’annule pas ce qui a déjà été effectué — les enregistrements, déploiements ou paramètres que nous avons modifiés sur votre compte restent inchangés. Si vous pensez que la clé elle-même a pu faire l’objet d’une fuite, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la leur.