Установите приложение 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 (app install).
• При привязке доски проекта к GitHub выберите The Zinn® GitHub app.

Вставьте Номер установки и продолжите. Мы проверяем установку перед сохранением каких-либо данных; номер, к которому нет доступа, никогда не сохраняется.

Что происходит дальше

• Репозитории, к которым вы предоставили доступ приложению, отображаются для развертывания сайта, и отправка изменений (push) запускает развертывание.
• Каждое выполняемое нами действие отображается в журнале аудита установки на GitHub под именем приложения, а не вашим.
• Чтобы предоставить доступ к другим репозиториям, измените права доступа приложения на той же странице Configure — ничего повторно подключать не требуется.

Если подключение не удается

Репозиторий отсутствует. Установка охватывает только выбранные вами репозитории. Откройте Configure и добавьте его.

Номер отклонен. Убедитесь, что это номер установки из адресной строки, а не собственный ID приложения, и что приложение все еще установлено — у удаленного приложения нет номера установки.

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

Подключение проходит, но затем возникает сбой. Ключ проходит аутентификацию, но ему не хватает разрешения, необходимого для действия. Создайте новый ключ с указанными выше разрешениями, затем отключите старое соединение и подключите новый ключ.

Отключение

Откройте Интеграции, найдите учетную запись и нажмите Отключить. Это немедленно удалит сохраненный ключ. Все процессы, которые его использовали, остановятся при следующем действии, а экраны, зависевшие от него, прямо сообщат об ошибке вместо незаметного сбоя.

Отключение не отменяет уже выполненные действия — записи, развертывания или настройки, измененные нами в вашей учетной записи, останутся в прежнем виде. Если вы считаете, что сам ключ мог быть скомпрометирован, также отзовите его у поставщика; отключение удаляет только нашу копию, но не их.