Сведения об изменениях в GitHub App
Вы можете изменить регистрацию GitHub App, чтобы изменить любые параметры, выбранные при первоначальной регистрации приложения. Дополнительные сведения о параметрах, которые можно выбрать при регистрации GitHub App, см. в разделе Registering a GitHub App.
Например, можно изменить имя и описание приложения, разрешения, предоставленные приложению, веб-перехватчики, на которые подписано приложение, или видимость приложения.
Вы также можете протестировать новые дополнительные функции для GitHub App. Дополнительные сведения см. в разделе Активация дополнительных функций для приложений GitHub.
Переход к параметрам GitHub App
Чтобы изменить GitHub App, сначала перейдите на страницу параметров приложения.
-
Перейдите к настройкам учетной записи.
-
Для приложения GitHub App, принадлежащего учетной записи пользователя, нажмите на фото своего профиля в правом верхнем углу любой страницы и выберите Настройки.
-
Для приложения GitHub App, принадлежащего организации, нажмите на фото своего профиля в правом верхнем углу любой страницы и выберите Ваши организации. Затем нажмите Настройки справа от организации.
-
-
На левой боковой панели щелкните Параметры разработчика.
-
На левой боковой панели щелкните GitHub Apps.
1. Справа от GitHub App, которые нужно изменить, щелкните Изменить.
Изменение основных сведений GitHub App
Вы можете изменить основные сведения о GitHub App, например имя приложения, описание приложения и URL-адрес домашней страницы приложения.
- Перейдите на страницу параметров приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе Переход к параметрам GitHub App этой статьи.
- В разделе "Основные сведения" измените сведения о GitHub App, которые вы хотите изменить.
- Нажмите кнопку Сохранить изменения.
Запрос авторизации пользователя (OAuth) во время установки
Вы можете предложить пользователям авторизовать GitHub App при его установке и создании маркера доступа пользователя. При запросе авторизации пользователя (OAuth) во время установки необходимо также указать URL-адрес обратного вызова, по которому пользователь будет перенаправляться после авторизации установки. Дополнительные сведения см. в разделе Создание маркера доступа пользователя для Приложение GitHub.
- Перейдите на страницу параметров приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе Переход к параметрам GitHub App этой статьи.
- В разделе "Идентификация и авторизация пользователей" выберите или снимите флажок Запрашивать авторизацию пользователей (OAuth) во время установки.
- В разделе "URL-адрес обратного вызова" введите полный URL-адрес для перенаправления после авторизации установки пользователем.
Включение или отключение потока устройства
Поток устройства можно использовать для авторизации пользователей для безголового приложения, например средства CLI или диспетчера учетных данных Git. Дополнительные сведения об использовании потока устройства с GitHub Apps см. в разделе Создание маркера доступа пользователя для Приложение GitHub.
- Перейдите на страницу параметров приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе Переход к параметрам GitHub App этой статьи.
- В разделе "Идентификация и авторизация пользователей" выберите или снимите флажок Включить поток устройств.
Добавление или обновление URL-адреса установки
Вы можете перенаправлять пользователей на определенный URL-адрес после установки приложения. Дополнительные сведения см. в разделе Registering a GitHub App.
Если во время установки выбрать Запрос авторизации пользователя (OAuth), вы не сможете ввести URL-адрес установки. Вместо этого пользователи будут перенаправлены на URL-адрес обратного вызова в рамках потока авторизации, где можно описать дополнительную настройку. Дополнительные сведения см. в разделе Сведения о URL-адресе обратного вызова авторизации пользователя.
- Перейдите на страницу параметров приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе Переход к параметрам GitHub App этой статьи.
- В разделе "После установки" в поле "URL-адрес установки" введите URL-адрес, по которому вы хотите перенаправлять пользователей после установки приложения.
- Если вы хотите перенаправить пользователей по URL-адресу установки после обновления установки, выберите Перенаправить при обновлении. Обновление включает добавление или удаление репозитория для установки. Если параметр "URL-адрес установки" пуст, он будет игнорироваться.
Изменение разрешений GitHub App
Вы можете изменить разрешения на доступ, предоставленные GitHub App, выполнив следующие действия.
При изменении разрешений репозитория или организации приложения каждой учетной записи, в которой установлено приложение, потребуется утвердить новые разрешения. При изменении разрешений учетной записи приложения каждому пользователю, который авторизовать приложение, потребуется утвердить изменения разрешений. Обновленные разрешения не вступают в силу при установке или авторизации пользователя, пока не будут утверждены новые разрешения. Вы можете использовать веб-перехватчик установки , чтобы узнать, когда пользователи принимают новые разрешения для вашего приложения.
Изменение разрешений приложения также может изменить веб-перехватчики, на которые может подписаться ваше приложение, и действия, которые приложение может выполнять с API. Дополнительные сведения см. в разделе Выбор разрешений для Приложение GitHub.
- Перейдите на страницу параметров приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе Переход к параметрам GitHub App этой статьи.
- На боковой панели параметров GitHub Apps щелкните Разрешения & события.
- В разделах "Разрешения репозитория", "Разрешения организации" и "Разрешения учетной записи" измените разрешения, которые вы хотите изменить. Для каждого типа разрешений выберите в раскрывающемся списке "Только для чтения", "Чтение и запись" или "Нет доступа". Дополнительные сведения см. в разделе Выбор разрешений для Приложение GitHub.
- При необходимости в разделе "Добавление заметки для пользователей" добавьте заметку, сообщающую пользователям, почему вы изменяете разрешения, запрашиваемые GitHub App.
- Нажмите кнопку Сохранить изменения.
Активация или деактивация веб-перехватчика GitHub App
Вы можете настроить GitHub App для получения веб-перехватчиков для определенных событий в GitHub и автоматически выполнять с ними действия. Дополнительные сведения см. в разделе Использование веб-перехватчиков с приложениями GitHub.
- Перейдите на страницу параметров приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе Переход к параметрам GitHub App этой статьи.
- В разделе "Веб-перехватчик", чтобы включить или отключить веб-перехватчик, выберите или снимите флажок Активный.
- Если вы выбрали активный на предыдущем шаге, в разделе "URL-адрес веб-перехватчика" введите URL-адрес, по которому GitHub должен отправлять события веб-перехватчика.
- При необходимости, если вы выбрали активный на предыдущем шаге, в разделе "Секрет веб-перехватчика" введите маркер секрета для защиты веб-перехватчиков. GitHub настоятельно рекомендует задать секрет веб-перехватчика.
Изменение подписок на события веб-перехватчика GitHub App
Вы можете изменить события веб-перехватчика, на которые подписан GitHub App, выполнив следующие действия.
Конкретные события веб-перехватчика, которые можно выбрать для регистрации GitHub App, определяются типом разрешений, выбранных для приложения. Сначала необходимо выбрать разрешения, которые должны быть у приложения, а затем подписаться на события веб-перехватчика, связанные с этим набором разрешений. Дополнительные сведения см. в разделе Использование веб-перехватчиков с приложениями GitHub.
- Перейдите на страницу параметров приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе Переход к параметрам GitHub App этой статьи.
- Активируйте веб-перехватчик GitHub App. Дополнительные сведения см. в разделе Активация или деактивация веб-перехватчика GitHub App этой статьи.
- На боковой панели параметров GitHub Apps щелкните Разрешения & события.
- В разделах "Разрешения репозитория", "Разрешения организации" и "Разрешения учетной записи" выберите разрешения, необходимые для событий, на которые будет подписано ваше приложение. Дополнительные сведения см. в разделе Изменение разрешений GitHub App.
- В разделе "Подписка на события" выберите события веб-перехватчика, которые вы хотите получать GitHub App.
- Нажмите кнопку Сохранить изменения.
Изменение видимости GitHub App
Вы можете изменить параметры видимости GitHub App, чтобы контролировать, кто может его установить. Общедоступные приложения нельзя сделать частными, если они установлены в других учетных записях. Дополнительные сведения см. в разделе Преобразование приложения GitHub в общедоступное или частное.
- Перейдите на страницу параметров приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе Переход к параметрам GitHub App этой статьи. 1. На боковой панели слева выберите Дополнительно.
- В разделе "Опасная зона" в зависимости от текущей видимости GitHub App щелкните Сделать общедоступным или Сделать закрытым.