GitHub Apps の可視性について
GitHub App は、パブリック、プライベート、または内部に設定することができます。GitHub App の登録をパブリックに設定すると、GitHub のすべてのユーザーがインストールと認可を実行できます。 GitHub App 登録をプライベートに設定した場合は、アプリを所有するアカウントでのみインストールできます。 認可できるのは、それを所有する organization のメンバーのみです。
GitHub Apps を所有するのが Enterprise アカウントの場合、または Enterprise 内の マネージド ユーザー アカウント である場合、表示範囲は "内部" です。 内部アプリは、その Enterprise と Enterprise 内の organization のみがインストールできます。また、Enterprise 内のユーザーのみが認可できます。 Enterprise のメンバーと非所属ユーザーはこのようなアプリを認可できますが、外部コラボレーターは認可できません。
Organization 所有のアプリケーションを Enterprise にインストールする場合は、Enterprise に移管するか、public
または internal
にします。 private
の場合は、organization にのみインストールできます。
所属していない GitHub Enterprise Server インスタンス内の Organization で GitHub App を使用できるようにする場合は、別の手順も行う必要があります。 詳しくは、「GitHub Enterprise Server で GitHub App を使用できるようにする」をご覧ください。
GitHub Enterprise Server ユーザーがツールを使用できることが重要な場合は、GitHub App の代わりに GitHub Actions を使うことを検討してください。 パブリック アクションは、GitHub Connect を使う GitHub Enterprise Server インスタンスで使用できます。 詳しくは、「GitHub Connect を使用して GitHub.com アクションへの自動アクセスを可能にする」と「エンタープライズの GitHub Actions について」 (GitHub Enterprise Server ドキュメント) をご覧ください。
GitHub App 登録の可視性を変更する方法については、「GitHub App 登録の変更」を参照してください。
パブリックのインストールフロー
公開 GitHub Apps には [Install] ボタンを含むランディング ページがあり、他のユーザーが自分のアカウントにアプリをインストールできます。 GitHub App が GitHub 上のすべてのユーザーに対してパブリックである場合は、GitHub Marketplace に公開することもできます。 詳細については、「アプリの GitHub Marketplace について」を参照してください。
プライベートのインストールフロー
プライベート GitHub Apps は、アプリ所有者のユーザーまたは組織アカウントでのみインストールできます。 アプリのランディング ページにはアプリに関する限定的な情報が表示されます。[Install] ボタンを使用できるのは、アプリを所有する organization の organization 所有者とアプリ マネージャー、または個人のアカウントが GitHub App を所有している場合は個人用アカウントのみです。
"内部" インストール フロー
Enterprise が所有する GitHub Apps と マネージド ユーザー アカウント が所有するアプリは、インストール URL を使って、その Enterprise と Enterprise 内の organization にのみインストールできます。 アプリをユーザー アカウントにインストールすることはできません。