Сведения о авторизации GitHub Apps
Приложения, которые не принадлежат вам, вашей организации или GitHub Marketplace могут потребоваться проверить GitHub удостоверение или взаимодействовать с GitHub вами от вашего имени. Эти приложения могут запрашивать авторизацию для GitHub App выполнения этих действий. Если приложение запрашивает авторизацию, оно перенаправит вас на страницу с запросом GitHub на авторизацию приложения.
При авторизации GitHub Appнеобходимо убедиться, что владелец приложения доверяет и просматривает сведения, к которым приложение хочет получить доступ. Во время авторизации вам будет предложено предоставить GitHub App разрешение на выполнение всех следующих действий:
- Убедитесь, что удостоверениеGitHub: когда авторизовано, GitHub App вы сможете получить общедоступный GitHub профиль. Приложение также может получить некоторые сведения о частной учетной записи. Во время процесса авторизации вы узнаете, GitHub какие сведения о GitHub App учетной записи смогут получить доступ.
- Узнайте, к каким ресурсам можно получить доступ: когда авторизован, GitHub App вы сможете определить, к каким ресурсам можно получить доступ к приложению. Приложение может использовать это, например, чтобы отобразить соответствующий список репозиториев.
- Действовать от вашего имени: когда авторизовано, приложение может выполнять задачи от GitHub вашего имени. Это может включать создание проблемы или комментарий к запросу на вытягивание. Дополнительные сведения см. в разделе "О GitHub Apps действии от вашего имени".
Вы можете просматривать и отменять авторизацию в любое время. Дополнительные сведения см. в разделе Проверка и отзыв авторизации приложений GitHub.
О GitHub Apps действии от вашего имени
После авторизации GitHub Appприложение может действовать от вашего имени. Ситуации, в которых GitHub App действует от вашего имени, зависят от цели GitHub App и контекста, в котором он используется. Например, интегрированная среда разработки (IDE) может использовать GitHub App для взаимодействия от вашего имени для отправки изменений, созданных с помощью интегрированной среды разработки, обратно в репозитории GitHub.
Это GitHub App может сделать только то, что у вас и приложения есть разрешение. Например, если у вас есть доступ на запись к репозиторию, но GitHub App только есть доступ на чтение, приложение может только считывать содержимое репозитория, даже если он действует от вашего имени. Аналогичным образом, если у вас есть доступ к репозиториям A и Bдоступ к репозиториям и доступ GitHub App к репозиториям B , то Cприложение может получить доступ только к репозиторию B при действии от вашего имени. Дополнительные сведения о разрешениях, предоставленных пользователю GitHub App, см. в разделе "Разница между авторизацией и установкой".
Когда приложение действует от вашего имени, оно будет атрибутировать действие для вас в сочетании с приложением. Например, если приложение публикует комментарий от вашего имени, GitHub пользовательский интерфейс отобразит рисунок профиля вместе с идентиконом приложения в качестве автора проблемы.
Аналогично, если активность запускает соответствующую запись в журналах аудита и журналах безопасности, в логах вы будете указаны как актёр, но будет указано, что «programmatic_access_type» — это «GitHub App user-to-server token».
Разница между авторизацией и установкой
При установке учетной GitHub App записи или организации вы предоставляете приложению разрешение на доступ к запрошенным ресурсам организации и репозитория. Вы также указываете, к каким репозиториям может получить доступ приложение. Во время установки будет указано, GitHub App какие разрешения репозитория и организации предоставляются. Для получения дополнительной информации о том, что позволяют делать разные GitHub App права, см. Выбор разрешений для приложения GitHub.
Например, можно предоставить GitHub App разрешение на чтение метаданных репозитория и проблемы записи, а также предоставить GitHub App доступ ко всем репозиториям.
При авторизацииGitHub Appприложения вы предоставляете приложению доступ к учетной GitHub записи на основе разрешений учетной записи, запрошенных приложением. Во время процесса авторизации приложение указывает, какие ресурсы приложение может получить доступ к вашей учетной записи. При авторизации GitHub Appвы также предоставляете приложению разрешение на действия от вашего имени.
Например, вы можете предоставить GitHub App разрешение на чтение адресов электронной почты и запись gists.
Вы можете установить GitHub App приложение без авторизации. Аналогичным образом можно авторизовать приложение без установки приложения.
Дополнительные сведения об установке см. в разделе Установка приложения GitHub из стороннего производителя, Установка собственного приложения GitHub.