Ce que cela vous apporte
L'installation de l'application Zinn® GitHub permet à un site de se déployer à partir de vos référentiels, et à un tableau de projet de rester synchronisé avec GitHub, sans nous confier de jeton personnel. Nous ne conservons que le numéro d'installation de l'application, qui est inutile en soi, et nous générons un jeton d'une durée d'une heure chaque fois que nous en avons besoin. C'est le meilleur choix pour une organisation, car il n'appartient à personne en particulier et ne cesse pas de fonctionner lorsqu'une personne s'en va.
Avant de commencer
Un compte GitHub, ou des droits de propriétaire sur l'organisation où vous souhaitez installer l'application. Les organisations qui interdisent les applications tierces exigent qu'un propriétaire les autorise ; 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 pas de clé à créer. Installez l'application Zinn® GitHub sur votre compte personnel ou votre organisation, et choisissez soit tous les référentiels, soit uniquement ceux que vous souhaitez que nous déployions.
Recherchez ensuite le numéro d'installation :
- Compte personnel — Paramètres → Applications → Applications GitHub installées, et Configurer à côté de l'application Zinn®.
- Organisation — Vos organisations → Paramètres → Applications GitHub, et Configurer à côté de l'application Zinn®.
Le numéro situé à la fin de la barre d'adresse de cette page, par exemple github.com/settings/installations/12345678, est le numéro d'installation.
2. L'associer ici
L'application est choisie là où elle est utilisée plutôt que sur l'écran Intégrations :
- Sur la connexion au référentiel d'un site, choisissez GitHub (installation d'application).
- Sur le lien GitHub d'un tableau de projet, choisissez L'application Zinn® GitHub.
Collez le Numéro d'installation et continuez. Nous vérifions l'installation avant d'enregistrer quoi que ce soit ; un numéro que nous ne pouvons pas joindre n'est jamais stocké.
Que se passe-t-il ensuite ?
- Les référentiels que vous avez accordés à l'application apparaissent pour permettre au site de s'y déployer, et une modification déclenche un 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 référentiels, modifiez l'accès aux référentiels de l'application sur la même page Configurer — aucune reconnexion n'est nécessaire.
Si la connexion ne s'établit pas
Il manque un référentiel. L'installation ne couvre que les référentiels que vous avez choisis. Ouvrez Configurer et ajoutez-le.
Le numéro est refusé. Vérifiez qu'il s'agit du numéro d'installation de la barre d'adresse et non de l'identifiant de l'application, et que l'application est toujours installée — une application désinstallée n'a pas d'installation.
Le message indique que la clé a été rejetée. C'est presque toujours l'une de ces trois causes : un espace ou un saut de ligne copié avec elle, une clé qui a expiré, ou une clé qui a été révoquée ou régénérée après que vous l'avez copiée. Créez-en une nouvelle et collez-la à nouveau.
La connexion s'établit, mais une action ultérieure échoue. La clé s'authentifie mais il lui manque une autorisation nécessaire à 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 Intégrations, recherchez le compte et appuyez sur Déconnecter. Cela supprime immédiatement la clé stockée. Tout ce qui l'utilisait s'arrête lors de sa prochaine action, et les écrans qui en dépendaient l'indiquent au lieu d'échouer silencieusement.
La déconnexion n'annule pas ce qui a déjà été fait — les enregistrements, les déploiements ou les paramètres que nous avons modifiés sur votre compte restent tels quels. Si vous pensez que la clé elle-même a pu fuiter, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la leur.
Cet article n'a pas encore été traduit dans votre langue, vous lisez donc la version anglaise.