Skip to main content

Изменение регистрации приложения GitHub

После регистрации GitHub Appвы можете внести в него изменения.

О изменениях GitHub App

Вы можете изменить регистрацию GitHub App для изменения любого из параметров, выбранных при первоначальной регистрации приложения. Дополнительные сведения о параметрах, которые можно выбрать при регистрации GitHub App, см. в разделе "Регистрация приложения GitHub".

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

Вы также можете протестировать новые необязательные функции для GitHub App. Дополнительные сведения см. в разделе Активация дополнительных функций для приложений GitHub.

Переход к параметрам GitHub App

Чтобы изменить GitHub App, сначала перейдите на страницу параметров приложения.

  1. В правом верхнем углу любой страницы на GitHubщелкните фото профиля.
  2. Перейдите к настройкам учетной записи.
    • Для приложения, принадлежащих личная учетная запись, щелкните Параметры.
    • Для приложения, принадлежащих организации:
      1. Щелкните Your organizations (Ваши организации).
      2. Справа от организации щелкните Параметры.
  3. На левой боковой панели щелкните Параметры разработчика.
  4. На левой боковой панели щелкните GitHub Apps.
  5. Справа от GitHub App, которые нужно изменить, щелкните Изменить.

Изменение основных сведений о GitHub App

Вы можете изменить основные сведения о данных GitHub App, например имя приложения, описание приложения и URL-адрес домашней страницы приложения.

  1. Перейдите на страницу параметров для приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе "Переход к параметрам GitHub App в этой статье.
  2. В разделе "Основные сведения" измените данные GitHub App, которые вы хотите изменить.
  3. Нажмите кнопку Сохранить изменения.

Запрос авторизации пользователя (OAuth) во время установки

Вы можете предложить пользователям авторизовать данные GitHub App при его установке и создании маркера доступа пользователей. При запросе авторизации пользователя (OAuth) во время установки необходимо также указать URL-адрес обратного вызова, где пользователь будет перенаправлен после авторизации установки. Дополнительные сведения см. в разделе Создание маркера доступа пользователя для приложения GitHub.

  1. Перейдите на страницу параметров для приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе "Переход к параметрам GitHub App в этой статье.
  2. В разделе "Идентификация и авторизация пользователей" во время установки** выберите или отмените выбор **авторизации пользователя запроса (OAuth).
  3. В разделе "URL-адрес обратного вызова" введите полный URL-адрес для перенаправления после авторизации установки пользователем.

Включение или отключение потока устройства

Поток устройства можно использовать для авторизации пользователей для приложения без головы, например средства CLI или диспетчера учетных данных Git. Дополнительные сведения об использовании потока устройств с GitHub Appsсм. в разделе "Создание маркера доступа пользователя для приложения GitHub".

  1. Перейдите на страницу параметров для приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе "Переход к параметрам GitHub App в этой статье.
  2. В разделе "Идентификация и авторизация пользователей" выберите или отключите включение потока устройств.

Добавление или обновление URL-адреса установки

После установки приложения вы можете перенаправить пользователей на определенный URL-адрес. Дополнительные сведения см. в разделе Регистрация приложения GitHub.

При выборе запроса авторизации пользователя (OAuth) во время установки вы не сможете ввести URL-адрес установки. Вместо этого пользователи будут перенаправлены на URL-адрес обратного вызова в рамках потока авторизации, где можно описать дополнительную настройку. Дополнительные сведения см. в разделе Сведения о URL-адресе обратного вызова авторизации пользователя.

  1. Перейдите на страницу параметров для приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе "Переход к параметрам GitHub App в этой статье.
  2. В разделе "После установки" в поле "URL-адрес установки" введите URL-адрес, в котором вы хотите перенаправить пользователей после установки приложения.
  3. При необходимости, если вы хотите перенаправить пользователей на URL-адрес установки после обновления установки, выберите "Перенаправление" при обновлении. Обновление включает добавление или удаление репозитория для установки. Если значение "URL-адрес установки" пусто, это будет игнорироваться.

Изменение разрешений данных GitHub App

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

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

Изменение разрешений приложения также может изменить веб-перехватчики, на которые может подписаться ваше приложение, и действия, которые может предпринять ваше приложение с API. Дополнительные сведения см. в разделе Выбор разрешений для приложения GitHub.

  1. Перейдите на страницу параметров для приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе "Переход к параметрам GitHub App в этой статье.
  2. На боковой панели параметров GitHub Apps щелкните "Разрешения и события".
  3. В разделах "Разрешения репозитория", "Разрешения организации" и "Разрешения учетной записи" измените разрешения, которые вы хотите изменить. Для каждого типа разрешений выберите "Только для чтения", "Чтение и запись" или "Нет доступа" в раскрывающемся списке. Дополнительные сведения см. в разделе Выбор разрешений для приложения GitHub.
  4. При необходимости в разделе "Добавление заметки для пользователей" добавьте заметку, указывающую пользователям, почему вы изменяете разрешения, которые запрашивают GitHub App.
  5. Нажмите кнопку Сохранить изменения.

Активация или отключение веб-перехватчика GitHub App

Вы можете настроить GitHub App для получения веб-перехватчиков для определенных событий на GitHub и автоматически принимать меры по ним. Дополнительные сведения см. в разделе Использование веб-перехватчиков с приложениями GitHub.

  1. Перейдите на страницу параметров для приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе "Переход к параметрам GitHub App в этой статье.
  2. В разделе "Веб-перехватчик", чтобы включить или отключить веб-перехватчик, выберите или отмените выбор "Активный".
  3. Если вы выбрали "Активный " на предыдущем шаге в разделе "URL-адрес веб-перехватчика", введите URL-адрес, в который GitHub должен отправлять события веб-перехватчика.
  4. При необходимости, если вы выбрали "Активный " на предыдущем шаге в разделе "Секрет веб-перехватчика", введите секретный токен для защиты веб-перехватчиков. GitHub настоятельно рекомендует задать секрет веб-перехватчика.

Изменение подписок на события веб-перехватчика для GitHub App

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

Определенные события веб-перехватчика, которые можно выбрать для регистрации GitHub App, определяются типом разрешений, выбранных для вашего приложения. Сначала необходимо выбрать разрешения, которые требуется приложению, а затем подписаться на события веб-перехватчика, связанные с этим набором разрешений. Дополнительные сведения см. в разделе "Использование веб-перехватчиков с приложениями GitHub".

  1. Перейдите на страницу параметров для приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе "Переход к параметрам GitHub App в этой статье.
  2. Активируйте веб-перехватчик GitHub App . Дополнительные сведения см. в разделе "Активация или деактивация данных GitHub App веб-перехватчика" в этой статье.
  3. На боковой панели параметров GitHub Apps щелкните "Разрешения и события".
  4. В разделах "Разрешения репозитория", "Разрешения организации" и "Разрешения учетной записи" выберите разрешения, необходимые для событий, на которые будет подписано ваше приложение. Дополнительные сведения см. в разделе "Изменение разрешений для GitHub App".
  5. В разделе "Подписка на события" выберите события веб-перехватчика, которые вы хотите получать GitHub App.
  6. Нажмите кнопку Сохранить изменения.

Изменение видимости данных GitHub App

Параметры видимости данных GitHub App можно изменить, чтобы контролировать, кто может установить его. Общедоступные приложения нельзя сделать частными, если они установлены в других учетных записях. Дополнительные сведения см. в разделе Преобразование приложения GitHub в общедоступное или частное.

  1. Перейдите на страницу параметров для приложения, которое вы хотите изменить. Дополнительные сведения см. в разделе "Переход к параметрам GitHub App в этой статье.
  2. На боковой панели слева выберите Дополнительно.
  3. В разделе "Зона опасности" в зависимости от текущей видимости данных GitHub Appщелкните "Сделать общедоступным " или "Сделать закрытым".