Инсталирайте приложението на Zinn® за GitHub, за да можем да внедряваме без дълготраен токен

Какво Ви носи свързването

Инсталирането на приложението Zinn® GitHub позволява на даден сайт да се внедрява от Вашите хранилища — а на проектно табло да остане в синхрон с GitHub — без да ни предоставяте личен токен. Ние съхраняваме само инсталационния номер на приложението, който сам по себе си е неизползваем, и генерираме токен с валидност един час всеки път, когато ни е необходим такъв. Това е по-добрият избор за организация, тъй като не принадлежи на никое конкретно лице и не спира да работи, когато някой напусне.

Преди да започнете

Акаунт в GitHub или права на собственик в организацията, където искате да инсталирате приложението. Организациите, които забраняват приложения на трети страни, изискват собственик да разреши това; ако това не е възможно, използвайте токен с детайлно определени права (Свържете Вашия GitHub акаунт).

1. Създайте ключа в GitHub

Няма ключ за създаване. Инсталирайте приложението Zinn® GitHub във Вашия личен акаунт или Вашата организация и изберете или всички хранилища, или само тези, които искате да внедряваме.

След това намерете инсталационния номер:

• Личен акаунт — Settings → Applications → Installed GitHub Apps и Configure до приложението Zinn®.
• Организация — Your organizations → Settings → GitHub Apps и Configure до приложението Zinn®.

Номерът в края на адресната лента на тази страница — например github.com/settings/installations/12345678 — е инсталационният номер.

2. Свържете го тук

Приложението се избира там, където се използва, а не на екрана Интеграции:

• При свързване на хранилище на сайт, изберете GitHub (инсталация на приложение).
• При връзка с GitHub на проектно табло, изберете Приложението Zinn® GitHub.

Поставете Инсталационния номер и продължете. Ние проверяваме инсталацията, преди да запазим каквото и да било; номер, до който нямаме достъп, никога не се съхранява.

Какво следва

• Хранилищата, за които сте предоставили достъп на приложението, се появяват, за да може сайтът да се внедрява от тях, а качването с push го внедрява.
• Всяко действие, което предприемаме, се появява в одитния лог на инсталацията в GitHub под името на приложението, а не под Вашето.
• За да ни предоставите повече хранилища, променете достъпа на приложението до хранилища на същата страница Configure — нищо не изисква повторно свързване.

Ако не се свързва

Липсва хранилище. Инсталацията обхваща само хранилищата, които сте избрали. Отворете Configure и го добавете.

Номерът е отхвърлен. Проверете дали това е инсталационният номер от адресната лента, а не собственият идентификатор на приложението, както и дали приложението е все още инсталирано — деинсталираното приложение няма инсталация.

Показва се съобщение, че ключът е отхвърлен. Почти винаги е едно от три неща: интервал или нов ред, копиран заедно с него, ключ с изтекъл срок или ключ, който е бил оттеглен или повторно генериран, след като сте го копирали. Създайте нов и го поставете отново.

Свързва се, но по-късно нещо се проваля. Ключът се удостоверява, но му липсва разрешение, от което действието се нуждае. Създайте нов ключ с изброените по-горе разрешения, след това прекъснете старата връзка и свържете новия ключ.

Прекъсване на връзката

Отворете Интеграции, намерете акаунта и натиснете Прекъсване на връзката. Това незабавно изтрива съхранения ключ. Всичко, което го е използвало, спира при следващото си действие, а екраните, които са зависили от него, съобщават за това, вместо тихо да се сринат.

Прекъсването на връзката не отменя вече направеното — записите, внедряванията или настройките, които сме променили във Вашия акаунт, остават такива, каквито са. Ако смятате, че самият ключ може да е изтекъл, оттеглете го и при доставчика; прекъсването на връзката премахва нашето копие, а не тяхното.