GitHub アプリの登録の変更

GitHub App を登録した後に変更を加えることができます。

この記事で

GitHub Appの変更について

GitHub App登録を変更して、アプリが最初に登録されたときに選択された設定を変更できます。 GitHub Appの登録時に選択できる設定の詳細については、GitHub アプリの登録 を参照してください。

たとえば、アプリの名前と説明、アプリに付与されるアクセス許可、アプリがサブスクライブする Webhook、またはアプリの可視性を変更できます。

GitHub Appの新しいオプション機能をテストすることもできます。 「GitHub アプリのオプション機能のアクティブ化」を参照してください。

GitHub App の設定に移動する

GitHub Appを変更するには、まずアプリ設定ページに移動します。

  1. GitHub の任意のページの右上隅にある、自分のプロフィール写真をクリックします。

  2. アカウント設定にアクセスしてください。

    • 個人用アカウントが所有するアプリの場合は、[設定] をクリックします。
    • 組織が所有するアプリの場合:
      1. [自分の組織] をクリックします。
      2. 組織の右側にある [設定] をクリックします。
    • Enterprise が所有するアプリの場合:
      1. Enterprise Managed Users を使用する場合は、[Enterprise] をクリックして Enterprise アカウントの設定に移動します。
      2. 個人用アカウントを使用する場合は、[Enterprise] をクリックしてから、Enterprise の右側にある [設定] をクリックします。

  3. GitHub App 設定にアクセスしてください。

    • 個人用アカウントまたは組織が所有するアプリの場合:
      1. 左側のサイドバーで、[ Developer settings] をクリックしてから、[GitHub Apps] をクリックします。
    • Enterprise が所有するアプリの場合:
      1. 左側のサイドバーで、 [設定] から GitHub Apps をクリックします。

  4. 変更する GitHub App の右で [編集] をクリックします。

GitHub App の基本情報の変更

アプリの名前、アプリの説明、アプリのホームページ URL など、 GitHub Appの基本情報を変更できます。

  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 は各組織の所有者またはユーザーに電子メールを送信し、アプリのアクセス許可を更新する要求を通知します。 新しいアクセス許可が承認されるまで、更新されたアクセス許可はインストールまたはユーザー認可に対して有効になりません。 インストール Webhook を使って、ユーザーがアプリの新しいアクセス許可を受け入れるタイミングを確認できます。

GitHub Appからアクセス許可または Webhook を削除すると、変更はすぐに有効になります。 アプリに以前に付与したアクセス許可を削除すると、アプリはそれらのリソースにアクセスできなくなります。

企業が所有するアプリのアクセス許可を変更すると、エンタープライズ所有者である場合は エンタープライズ内のアプリのすべてのインストールに対して変更が直ちに有効になります。 アプリ マネージャーの場合、変更は組織の所有者である組織でのみ自動的に受け入れられます。

アプリに初めてリポジトリ アクセス許可を追加する場合、更新を自動的に承認することはできません。 その場合、各組織の所有者は、アプリがアクセスできるリポジトリを選択できるように、更新プログラムを承認する必要があります。

アプリのアクセス許可を変更すると、アプリがサブスクライブできる Webhook や、アプリが API を使って実行できるアクションも変わる場合があります。 「GitHub アプリのアクセス許可の選択」を参照してください。

  1. 変更するアプリの設定ページに移動します。 詳細については、この記事の「GitHub App 設定への移動」を参照してください。
  2. GitHub Apps設定サイドバーで、[アクセス許可とイベント] をクリックします。
  3. セクション [リポジトリのアクセス許可]、[Organization のアクセス許可]、[アカウントのアクセス許可] で、変えたいアクセス許可を変更します。 アクセス許可の各タイプに、ドロップダウンから [読み取り専用]、[読み取りと書き込み]、[アクセスなし] のいずれかを選びます。 「GitHub アプリのアクセス許可の選択」を参照してください。
  4. 必要に応じて、[ユーザーにメモを追加] で、 GitHub App が要求するアクセス許可を変更する理由をユーザーに伝えるメモを追加します。
  5. [ 変更の保存] をクリックします。

GitHub App webhook のアクティブ化または非アクティブ化

GitHub Appで特定のイベントの Webhook を受信し、それらに対して自動的にアクションを実行するようにGitHubを構成できます。 「GitHub Apps での Webhook の使用」を参照してください。

  1. 変更するアプリの設定ページに移動します。 詳細については、この記事の「GitHub App 設定への移動」を参照してください。
  2. [Webhook] で Webhook を有効または無効にするには、 [アクティブ] をオンまたはオフにします。
  3. 前の手順で [アクティブ] を選択した場合は、[Webhook URL] に、webhook イベントの送信先 GitHub URL を入力します。
  4. 必要に応じて、前の手順で [アクティブ] を選んだ場合は、[Webhook シークレット] に、Webhook をセキュリティで保護するためのシークレット トークンを入力します。 GitHub Webhook シークレットを設定することを強く推奨しています。

の Webhook イベント サブスクリプションを変更する GitHub App

次の手順を使用して、 GitHub App がサブスクライブする Webhook イベントを変更できます。

GitHub App の登録で選択できる具体的な Webhook イベントは、アプリに対して選択したアクセス許可の種類によって決まります。 まず、アプリに付与するアクセス許可を選択する必要があります。これで、そのアクセス許可のセットに関連する Webhook イベントにアプリをサブスクライブできます。 「AUTOTITLE」を参照してください。

  1. 変更するアプリの設定ページに移動します。 詳細については、この記事の「GitHub App 設定への移動」を参照してください。
  2. GitHub App webhook をアクティブにします。 この記事の 「 GitHub App webhook のアクティブ化または非アクティブ化 」を参照してください。
  3. GitHub Apps設定サイドバーで、[アクセス許可とイベント] をクリックします。
  4. セクション [リポジトリのアクセス許可]、[組織のアクセス許可]、[アカウントのアクセス許可] で、アプリがサブスクライブするイベントに必要なアクセス許可を選びます。 GitHub Appのアクセス許可の変更を参照してください。
  5. 「Subscribe to Events」で、GitHub App が受信する Webhook イベントを選択します。
  6. [ 変更の保存] をクリックします。

GitHub App の可視性の変更

GitHub Appの表示設定を変更して、インストールできるユーザーを制御できます。 パブリック アプリは、他のアカウントにインストールされている場合、非公開にすることはできません。 「GitHub アプリをパブリックまたはプライベートにする」を参照してください。

企業が所有する GitHub App の可視性を変更することはできません。 GitHub Apps 企業が所有するものは、その企業内の組織 または企業自体 にのみインストールできます。

  1. 変更するアプリの設定ページに移動します。 詳細については、この記事の「GitHub App 設定への移動」を参照してください。
  2. 左側のサイドバーで、 [詳細設定] をクリックします。
  3. [危険ゾーン] で、 GitHub Appの現在の可視性に応じて、[ 公開 ] または [ 非公開にする] をクリックします。