# Регистрация приложения GitHub Вы можете зарегистрировать GitHub App в личная учетная запись или в любой организации, у вас есть. ## О регистрации GitHub Apps Вы можете зарегистрировать GitHub App несколькими способами. * **Под личная учетная запись**. * **В организации, принадлежащей** вам. * **В организации**, которая предоставила вам разрешение на управление всеми приложениями. См. [Добавление и удаление менеджеров приложений GitHub в вашей организации](/ru/organizations/managing-programmatic-access-to-your-organization/adding-github-app-managers-in-your-organization). Пользователь или организация может зарегистрировать до 100 GitHub Apps, но не ограничивается количеством GitHub Apps можно установить в учетной записи. ## Регистрация GitHub App 1. В правом верхнем углу любой страницы на GitHubщелкните рисунок профиля. 2. Перейдите к настройкам учетной записи. * Для приложения, принадлежащих личная учетная запись, нажмите кнопку **"Параметры**". * Для приложения, принадлежащих организации: 1. Щелкните **Your organizations** (Ваши организации). 2. Справа от организации нажмите кнопку **"Параметры**". 3. На левой боковой панели щелкните ** Параметры разработчика**. 4. На левой боковой панели щелкните **GitHub Apps**. 5. Щелкните **"Создать" GitHub App**. 6. В поле "GitHub App name" введите имя приложения. Вы должны выбрать четкое и короткое имя. Имя не может превышать 34 символов. Имя приложения (преобразовано в нижний регистр, пробелы заменены `-`и специальные символы заменены) будут отображаться в пользовательском интерфейсе при выполнении действия приложения. Например, `My APp Näme` будет отображаться как `my-app-name`. Имя должно быть уникальным для GitHub. Вы не можете использовать то же имя, что и существующая учетная запись GitHub, если это не ваше имя пользователя или организации. 7. При необходимости в разделе "Описание" введите описание приложения. При установке приложения пользователи увидят это описание. 8. В поле "URL-адрес домашней страницы" введите полный URL-адрес веб-сайта приложения. Если у вас нет выделенного URL-адреса и код приложения хранится в общедоступный репозиторий, можно использовать этот URL-адрес репозитория. Кроме того, можно использовать URL-адрес учетной записи, владеющей приложением. 9. При необходимости в разделе "URL-адрес обратного вызова" введите полный URL-адрес для перенаправления после авторизации установки пользователем. Можно ввести до 10 URL-адресов обратного вызова. Чтобы добавить дополнительные URL-адреса обратного вызова, нажмите кнопку **"Добавить URL-адрес** обратного вызова". Если приложению не нужно действовать от имени пользователя (не нужно создавать маркер доступа пользователя), это поле будет игнорироваться. Если приложение использует поток устройств вместо потока веб-приложения для создания маркера доступа пользователя, это поле будет игнорироваться. Дополнительные сведения о URL-адресе обратного вызова см. в разделе [Сведения о URL-адресе обратного вызова авторизации пользователя](/ru/apps/creating-github-apps/setting-up-a-github-app/about-the-user-authorization-callback-url). Дополнительные сведения о создании маркера доступа пользователя для действия от имени пользователя см. в разделе \[AUTOTITLE и [Аутентификация с помощью приложения GitHub от имени пользователя](/ru/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user)]\(/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app). 10. При необходимости, чтобы запретить истечение срока действия маркеров доступа пользователей, отмените выбор **маркеров** авторизации пользователей. GitHub настоятельно рекомендует оставить этот параметр выбранным. Дополнительные сведения об обновлении маркеров с истекшим сроком действия и преимуществах маркеров доступа пользователей см. в разделе [Обновление маркеров доступа пользователей](/ru/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens). Если приложению не нужно создавать маркер доступа пользователей, это поле будет игнорироваться. 11. При необходимости, чтобы пользователи запросили авторизацию приложения при его установке, выберите **"Запросить авторизацию пользователя" (OAuth) во время установки**. Если пользователь авторизует приложение, приложение может создать маркер доступа пользователя для выполнения запросов API от имени пользователя и действия приложения атрибутов для пользователя. Дополнительные сведения см. в разделе \[AUTOTITLE и [Аутентификация с помощью приложения GitHub от имени пользователя](/ru/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user)]\(/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app). 12. При необходимости, если вы хотите использовать поток устройств для создания маркера доступа пользователей, выберите **"Включить поток** устройств". Дополнительные сведения см. в разделе [Генерация токена доступа пользователя для приложения GitHub](/ru/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app). 13. При необходимости в разделе "URL-адрес установки" введите URL-адрес для перенаправления пользователей после установки приложения. Если после установки требуется дополнительная настройка, вы можете использовать этот URL-адрес, чтобы сообщить пользователям, какие действия необходимо выполнить после установки. Дополнительные сведения см. в разделе [Сведения о URL-адресе установки](/ru/apps/creating-github-apps/setting-up-a-github-app/about-the-setup-url). Если вы выбрали **авторизацию пользователя запроса (OAuth) во время установки** на предыдущем шаге, вы не сможете ввести URL-адрес здесь. Вместо этого пользователи будут перенаправлены на URL-адрес обратного вызова в рамках потока авторизации, где можно описать дополнительную настройку. 14. При необходимости, если вы хотите перенаправить пользователей на URL-адрес установки после обновления установки, выберите **"Перенаправление" при обновлении**. Обновление включает добавление или удаление репозитория для установки. Если значение "URL-адрес установки" пусто, это будет игнорироваться. 15. При необходимости, если вы не хотите, чтобы приложение получало события веб-перехватчика, отмените выбор **"Активный**". Например, если приложение будет использоваться только для проверки подлинности или не требует ответа на веб-перехватчики, отмените выбор этого параметра. Дополнительные сведения см. в разделе [Использование вебхуков с приложениями GitHub](/ru/apps/creating-github-apps/setting-up-a-github-app/using-webhooks-with-github-apps). 16. Если вы выбрали **"Активный** " на предыдущем шаге в разделе "URL-адрес веб-перехватчика", введите URL-адрес, в который GitHub должен отправлять события веб-перехватчика. Дополнительные сведения см. в разделе [Использование вебхуков с приложениями GitHub](/ru/apps/creating-github-apps/setting-up-a-github-app/using-webhooks-with-github-apps). 17. При необходимости, если вы выбрали **"Активный** " на предыдущем шаге в разделе "Секрет веб-перехватчика", введите секретный маркер для защиты веб-перехватчиков. GitHub настоятельно рекомендует задать секрет веб-перехватчика. Дополнительные сведения см. в разделе [Использование вебхуков с приложениями GitHub](/ru/apps/creating-github-apps/setting-up-a-github-app/using-webhooks-with-github-apps). 18. Если вы ввели URL-адрес веб-перехватчика, в разделе "Проверка SSL" выберите, следует ли включить проверку SSL. GitHub настоятельно рекомендует включить проверку SSL. 19. В разделе "Разрешения" выберите необходимые для приложения разрешения. Для каждого разрешения выберите раскрывающееся меню и щелкните "Только\*\* для чтения", **"** Чтение" и\*\* "Запись" или **"Нет доступа**". Необходимо выбрать минимальные разрешения, необходимые для приложения. Дополнительные сведения см. в разделе [Выбор разрешений для приложения GitHub](/ru/apps/creating-github-apps/setting-up-a-github-app/choosing-permissions-for-a-github-app). 20. Если вы выбрали **"Активный** " на предыдущем шаге, чтобы указать, что приложение должно получать события веб-перехватчика, в разделе "Подписка на события", выберите события веб-перехватчика, которые вы хотите получить. Разрешения, выбранные на предыдущем шаге, определяют, какие события веб-перехватчика доступны. Дополнительные сведения о каждом событии веб-перехватчика см. в разделе [События и полезные данные веб-перехватчика](/ru/webhooks-and-events/webhooks/webhook-events-and-payloads). 21. В разделе "Где можно установить данные GitHub App?", выберите **только в этой учетной записи или **любой учетной записи****. Дополнительные сведения о параметрах установки см. в разделе [Как сделать приложение GitHub публичным или частным](/ru/apps/creating-github-apps/setting-up-a-github-app/making-a-github-app-public-or-private). 22. Нажмите кнопку **"Создать GitHub App**. ## Следующие шаги После регистрации GitHub Appвы хотите написать код, чтобы сделать GitHub App делать что-то. Примеры написания кода см. в следующих примерах: * [Быстрый старт для создания приложений GitHub](/ru/apps/creating-github-apps/writing-code-for-a-github-app/quickstart) * [Создание приложения GitHub, которое реагирует на события webhook](/ru/apps/creating-github-apps/guides/building-a-github-app-that-responds-to-webhook-events) * [Создание кнопки «Войти с помощью GitHub» с помощью приложения GitHub](/ru/apps/creating-github-apps/guides/building-a-login-with-github-button-with-a-github-app) * [Создание CLI с помощью приложения GitHub](/ru/apps/creating-github-apps/guides/building-a-cli-with-a-github-app) * [Создание аутентифицированных запросов API с помощью приложения GitHub в рабочем процессе GitHub Actions](/ru/apps/creating-github-apps/writing-code-for-a-github-app/making-authenticated-api-requests-with-a-github-app-in-a-github-actions-workflow) Вы должны стремиться следовать рекомендациям. Дополнительные сведения см. в разделе [Лучшие практики создания приложения на GitHub](/ru/apps/creating-github-apps/setting-up-a-github-app/best-practices-for-creating-a-github-app). После полной сборки данных GitHub App можно установить GitHub App и поделиться данными GitHub App с другими пользователями. Дополнительные сведения см. в разделе \[AUTOTITLE и [Установка собственного приложения GitHub](/ru/apps/using-github-apps/installing-your-own-github-app)]\(/apps/sharing-github-apps/sharing-your-github-app). Вы всегда можете вносить изменения в параметры данных GitHub App. Дополнительные сведения см. в разделе [Изменение регистрации приложения GitHub](/ru/apps/maintaining-github-apps/modifying-a-github-app).