1
0
mirror of synced 2026-01-24 06:01:08 -05:00
Files
docs/translations/ru-RU/content/developers/apps/building-github-apps/creating-a-github-app.md
2022-12-12 17:21:29 +00:00

86 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Создание приложения GitHub
intro: '{% data reusables.shortdesc.creating_github_apps %}'
redirect_from:
- /early-access/integrations/creating-an-integration
- /apps/building-integrations/setting-up-and-registering-github-apps/registering-github-apps
- /apps/building-github-apps/creating-a-github-app
- /developers/apps/creating-a-github-app
versions:
fpt: '*'
ghes: '*'
ghae: '*'
ghec: '*'
topics:
- GitHub Apps
ms.openlocfilehash: bca6b800f8ea6042e4cbcdb95bd39b56f61433c5
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: ru-RU
ms.lasthandoff: 09/05/2022
ms.locfileid: '146179090'
---
{% ifversion fpt or ghec %}Сведения об использовании манифестов приложений GitHub App, позволяющих создавать предварительно настроенные приложения GitHub, см. в разделе [Создание приложений GitHub из манифеста](/apps/building-github-apps/creating-github-apps-from-a-manifest/).{% endif %}
{% ifversion fpt or ghec %} {% note %}
**Примечание.** {% data reusables.apps.maximum-github-apps-allowed %}
{% endnote %} {% endif %}
{% data reusables.apps.settings-step %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %}
1. Нажмите кнопку **Создать приложение GitHub**.
![Кнопка создания нового приложения GitHub](/assets/images/github-apps/github_apps_new.png)
1. В поле "Имя приложения GitHub" введите имя вашего приложения.
![Поле для имени приложения GitHub](/assets/images/github-apps/github_apps_app_name.png)
Присвойте своему приложению краткое и понятное имя. Это имя должно отличаться от имени существующей учетной записи GitHub, если только это не ваше собственное имя пользователя или организации. Укороченная версия имени вашего приложения будет отображаться в пользовательском интерфейсе, когда ваша интеграция выполнит действие.
1. При необходимости в поле "Описание" введите описание приложения, которое будут видеть пользователи.
![Поле для описания приложения GitHub](/assets/images/github-apps/github_apps_description.png)
1. В поле «URL-адрес домашней страницы» введите полный URL-адрес веб-сайта вашего приложения.
![Поле для URL-адреса домашней страницы приложения GitHub](/assets/images/github-apps/github_apps_homepage_url.png) {% ifversion fpt or ghes or ghec %}
1. В поле "URL-адрес обратного вызова" введите полный URL-адрес для перенаправления после авторизации установки пользователем. Этот URL-адрес используется, если вашему приложению необходимо идентифицировать и авторизовать запросы от пользователя к серверу.
С помощью кнопки **Добавить URL-адрес обратного вызова** можно указать дополнительные URL-адреса обратного вызова, но не более 10.
![Кнопка добавления URL-адреса обратного вызова и поле для URL-адреса обратного вызова](/assets/images/github-apps/github_apps_callback_url_multiple.png) {% else %}
1. В поле "URL-адрес обратного вызова авторизации пользователя" введите полный URL-адрес для перенаправления после авторизации установки пользователем. Этот URL-адрес используется, если вашему приложению необходимо идентифицировать и авторизовать запросы от пользователя к серверу.
![Поле для URL-адреса обратного вызова авторизации пользователя вашего приложения GitHub](/assets/images/github-apps/github_apps_user_authorization.png)
{% endif %}
1. По умолчанию для повышения безопасности ваше приложение будет использовать маркеры авторизации пользователя с ограниченным сроком действия. Чтобы отказаться от использования маркеров пользователя с истекающим сроком действия, снимите флажок "Маркеры авторизации пользователя с истекающим сроком действия". Дополнительные сведения о настройке потока маркеров обновления и преимуществах маркеров пользователя с ограниченным сроком действия см. в разделе [Обновление маркеров доступа пользователя к серверу](/apps/building-github-apps/refreshing-user-to-server-access-tokens/).
![Флажок для согласия на истечение срока действия маркеров пользователей во время установки приложений GitHub](/assets/images/github-apps/expire-user-tokens-selection.png)
1. Если приложение авторизует пользователей с помощью потока OAuth, вы можете установить флажок **Запрашивать авторизацию пользователя (OAuth) во время установки**, чтобы позволить людям авторизовать приложение при его установке, экономя шаг. Если вы установите этот флажок, параметр "URL-адрес установки" станет недоступным, и после установки приложения пользователи будут перенаправляться на ваш URL-адрес обратного вызова авторизации пользователя. Дополнительные сведения см. в разделе [Авторизация пользователей во время установки](/apps/installing-github-apps/#authorizing-users-during-installation).
![Запрос авторизации пользователя во время установки](/assets/images/github-apps/github_apps_request_auth_upon_install.png){% ifversion device-flow-is-opt-in %}
1. Если приложение GitHub будет использовать поток устройства для идентификации и авторизации пользователей, установите флажок **Включить поток устройства**. Дополнительные сведения о потоке устройств см. в разделе [Авторизация приложений OAuth](/developers/apps/building-oauth-apps/authorizing-oauth-apps#device-flow).
![Снимок экрана: поле для включения потока устройства](/assets/images/oauth-apps/enable-device-flow.png) {% endif %}
1. Если после установки требуется дополнительная настройка, добавьте параметр "URL-адрес установки", чтобы перенаправлять пользователей после установки приложения.
![Поле для URL-адреса настройки приложения GitHub](/assets/images/github-apps/github_apps_setup_url.png)
{% note %}
**Примечание.** При установке флажка **Запрашивать авторизацию пользователя (OAuth) во время установки** на предыдущем шаге это поле становится недоступным, и после установки приложения люди будут перенаправляться на URL-адрес обратного вызова авторизации пользователя.
{% endnote %}
1. В поле "URL-адрес веб-перехватчика" введите URL-адрес, в который будут отправляться события. Каждое приложение получает собственный веб-перехватчик, который будет уведомлять вас о каждой установке или изменении приложения, а также о любых других событиях, на которые подписано приложение.
![Поле для URL-адреса веб-перехватчика приложения GitHub](/assets/images/github-apps/github_apps_webhook_url.png)
1. При необходимости в поле "Секрет веб-перехватчика" введите необязательный секретный маркер, используемый для защиты ваших веб-перехватчиков.
![Поле для добавления секретного маркера для веб-перехватчика](/assets/images/github-apps/github_apps_webhook_secret.png)
{% note %}
**Примечание.** Мы настоятельно рекомендуем задать секретный маркер. Дополнительные сведения см. в разделе [Обеспечение безопасности веб-перехватчиков](/webhooks/securing/).
{% endnote %}
1. В разделе "Разрешения" выберите разрешения, которые будет запрашивать ваше приложение. Для каждого типа разрешений в раскрывающемся меню выберите пункт **Только для чтения**, **Чтение и запись** или **Нет доступа**.
![Различные разрешения для приложения GitHub](/assets/images/github-apps/github_apps_new_permissions_post2dot13.png)
1. В разделе "Подписка на события" выберите события, которые должно получать ваше приложение.
1. Чтобы выбрать место установки приложения, установите флажок **Только в этой учетной записи** или **Любая учетная запись**. Дополнительные сведения о вариантах установки см. в разделе [Создание общедоступного или частного приложения GitHub](/apps/managing-github-apps/making-a-github-app-public-or-private/).
![Варианты установки для приложения GitHub](/assets/images/github-apps/github_apps_installation_options.png)
1. Нажмите кнопку **Создать приложение GitHub**.
![Кнопка для создания приложения GitHub](/assets/images/github-apps/github_apps_create_github_app.png)