# Авторизация приложений GitHub

Вы можете авторизовать получение сведений о вашей GitHub App учетной GitHub записи и внести изменения от вашего имени.

## Сведения о авторизации 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 действии от вашего имени](#about-github-apps-acting-on-your-behalf)".

Вы можете просматривать и отменять авторизацию в любое время. Дополнительные сведения см. в разделе [Проверка и отзыв авторизации приложений GitHub](/ru/enterprise-server@3.22/apps/using-github-apps/reviewing-and-revoking-authorization-of-github-apps).

## О 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, см. в разделе ["Разница между авторизацией и установкой](#difference-between-authorization-and-installation)".

Когда приложение действует от вашего имени, оно будет атрибутировать действие для вас в сочетании с приложением. Например, если приложение публикует комментарий от вашего имени, GitHub пользовательский интерфейс отобразит рисунок профиля вместе с идентиконом приложения в качестве автора проблемы.

![Снимок экрана: комментарий с аватаром пользователя с наложенным значком приложения identicon. Аватар выделен оранжевым контуром.](/assets/images/help/apps/github-app-acting-on-your-behalf.png)

Аналогично, если активность запускает соответствующую запись в журналах аудита и журналах безопасности, в логах вы будете указаны как актёр, но будет указано, что «programmatic\_access\_type» — это «GitHub App user-to-server token».

## Разница между авторизацией и установкой

При **установке** учетной GitHub App записи или организации вы предоставляете приложению разрешение на доступ к запрошенным ресурсам организации и репозитория. Вы также указываете, к каким репозиториям может получить доступ приложение. Во время установки будет указано, GitHub App какие разрешения репозитория и организации предоставляются. Для получения дополнительной информации о том, что позволяют делать разные GitHub App права, см. [Выбор разрешений для приложения GitHub](/ru/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app).

Например, можно предоставить GitHub App разрешение на чтение метаданных репозитория и проблемы записи, а также предоставить GitHub App доступ ко всем репозиториям.

![Снимок экрана: страница для установки приложения GitHub. Приложение запрашивает доступ на чтение метаданных и запись доступа к проблемам.](/assets/images/github-apps/install-app.png)

При **авторизации**GitHub Appприложения вы предоставляете приложению доступ к учетной GitHub записи на основе разрешений учетной записи, запрошенных приложением. Во время процесса авторизации приложение указывает, какие ресурсы приложение может получить доступ к вашей учетной записи. При авторизации GitHub Appвы также предоставляете приложению разрешение на действия от вашего имени.

Например, вы можете предоставить GitHub App разрешение на чтение адресов электронной почты и запись gists.

![Снимок экрана: страница авторизации приложения GitHub. Приложение запрашивает доступ на чтение к электронной почте и доступ на запись к gists.](/assets/images/github-apps/authorize-app.png)

Вы можете установить GitHub App приложение без авторизации. Аналогичным образом можно авторизовать приложение без установки приложения.

Дополнительные сведения об установке см. в разделе [Установка приложения GitHub из стороннего производителя](/ru/enterprise-server@3.22/apps/using-github-apps/installing-a-github-app-from-a-third-party), [Установка собственного приложения GitHub](/ru/enterprise-server@3.22/apps/using-github-apps/installing-your-own-github-app).