インストールについて GitHub Apps
GitHub ユーザーは、自分の個人アカウントまたは自分が所有するアカウントに GitHub Apps をインストールできます。 GitHub Appをインストールする場合は、要求したエンタープライズまたは組織化とリポジトリのアクセス許可をアプリに付与します。 アプリがリポジトリのアクセス許可を要求した場合は、 GitHub App がアクセスできるリポジトリも指定します。 企業にアプリをインストールすると、エンタープライズアクセス許可のみが付与されます。 組織とリポジトリのアクセス許可を付与するには、組織にアプリをインストールします。
インストールした GitHub Apps を定期的に確認する必要があります。 付与したアクセス許可を確認し、 GitHub App がアクセスできるリポジトリを変更できます。 アプリを使用しなくなった場合は、 GitHub App を一時停止または削除して、インストールされているアカウントが所有するリソースへのアクセスをブロックすることを検討してください。
インストールした GitHub Apps を確認するだけでなく、ユーザーの代わりに行動することを承認した GitHub Apps を確認できます。 詳しくは、「GitHub アプリの承認の確認と取り消し」をご覧ください。
確認または変更する対象の GitHub App への移動
-
企業にインストールされている GitHub App:
- GitHubの右上隅にあるプロファイル画像をクリックし、[エンタープライズ] をクリックします。
- 企業名の横にある [Settings] をクリックします。
- 上部のナビゲーション バーで [設定] をクリックします。
- サイド バーの [GitHub Apps をクリックします。 企業が所有する GitHub Apps の一覧が表示されます。
- Enterprise にインストールされているアプリの一覧を表示するには、[Installed Apps] タブに切り替えます。
- 確認または変更する GitHub App の横にある [ 構成] をクリックします。
-
組織にインストールされている GitHub App:
- GitHubの右上隅にあるプロファイル画像をクリックし、[組織] をクリックします。
- 組織名の横にある [設定] をクリックします。
- サイド バーの [サード パーティのアクセス] の下の [GitHub Apps をクリックします。 組織にインストールされている GitHub Apps の一覧が表示されます。
- 確認または変更する GitHub App の横にある [ 構成] をクリックします。
-
個人アカウントにインストールされている GitHub App:
- 任意のページで、右上隅にあるプロフィール画像をクリックしてから、[Settings] をクリックします。
- [統合] で、 [アプリケーション] をクリックします。
- [Installed GitHub Apps をクリックします。 個人用アカウントにインストールされている GitHub Apps の一覧が表示されます。
- 確認または変更する GitHub App の横にある [ 構成] をクリックします。
-
GitHub Appにアクセス権が付与されたリポジトリの場合:
メモ
次の手順では、 GitHub App がインストールされている組織または個人アカウントのアカウント設定に移動します。 その設定は、移動元のリポジトリだけでなく、そのアカウントでアプリがインストールされているすべてのリポジトリに影響します。
-
組織またはリポジトリのメイン ページに移動します。
-
[ 設定] をクリックします。
-
[Integrations](統合) で、[GitHub Apps をクリックします。 リポジトリへのアクセスが許可されている GitHub Apps の一覧が表示されます。
-
確認または変更する GitHub App の横にある [ 構成] をクリックします。
-
アクセス許可の確認
- 変更する GitHub App に移動します。 詳細については、「確認または変更するGitHub アプリへのアクセスを参照してください。
- [アクセス許可] で、 GitHub App が持つアクセス許可を確認します。 GitHub Appを有効にするさまざまなアクセス許可の詳細については、「GitHub アプリのアクセス許可の選択」を参照してください。
リポジトリ アクセスの変更
-
変更する GitHub App に移動します。 詳細については、「確認または変更するGitHub アプリへのアクセスを参照してください。
-
[リポジトリ アクセス] で、 [すべてのリポジトリ] または [選択したリポジトリのみ] を選択します。
-
前の手順で [リポジトリのみを選択 ] を選択した場合は、[ リポジトリの選択 ] ドロップダウンで、 GitHub App がアクセスするリポジトリを選択します。
GitHub Appが後でリポジトリを作成すると、そのリポジトリへのアクセス権もアプリに自動的に付与されます。
- [保存] をクリックします。
アクセスをブロックする
-
変更する GitHub App に移動します。 詳細については、「確認または変更するGitHub アプリへのアクセスを参照してください。
-
今後使用するために GitHub App をインストールしたまま、アカウントが所有するリソースへのアクセスを一時的にブロックするには、[ 一時停止] をクリックします。
GitHub Appを一時停止しても、アプリの承認 (アプリが個人アカウントにインストールされている場合)、またはアカウントのメンバーによるアプリの承認 (アプリが組織にインストールされている場合または企業) は影響を受けなくなります。 詳しくは、「GitHub アプリの承認」をご覧ください。
GitHub Appが以前に中断されていた場合は、[Unsuspend] をクリックしてアプリの中断を解除できます。 GitHub AppがGitHub App所有者によって中断された場合、アプリの中断を解除することはできません。
-
GitHub Appをアンインストールし、アカウントが所有するリソースへのアクセスをブロックするには、[アンインストール] をクリックします。
アカウントから GitHub App をアンインストールすると、アプリはそのアカウント内のリソースにアクセスできなくなります。 アプリが他のアカウントにインストールされている場合、そのアプリは引き続きユーザーに代わって他のアカウントにアクセスすることを許可される可能性があります。
GitHubの任意の場所でアプリがユーザーに代わって動作することを停止する場合は、ユーザー アカウントの [承認されたGitHub Apps] タブでアプリの承認を解除します。 これにより、ユーザーに代わってアプリに発行されたトークンは完全に無効になります。 詳しくは、「GitHub アプリの承認」をご覧ください。