GitHub Connect について
GitHub Connectを有効化するには、GitHub Enterprise ServerのインスタンスとGitHub Enterprise Cloud のOrganizationまたはEnterpriseアカウントの両方で接続を設定しなければなりません。
接続を設定するには、プロキシの設定でgithub.com
および api.github.com
への接続が許可されていなければなりません。 詳細は「アウトバウンド Web プロキシサーバーを設定する」を参照してください。
GitHub Connectを有効化すると、Unified Searchや統合コントリビューションといった機能を使用できるようになります。 For more information about all of the features available, see "Managing connections between your enterprise accounts."
GitHub Enterprise ServerのインスタンスをGitHub Enterprise Cloudに接続すると、GitHub.com上のレコードに、接続に関する情報が保存されます:
- GitHub Enterprise Server ライセンスの公開鍵の部分
- GitHub Enterprise Server ライセンスのハッシュ
- GitHub Enterprise Server ライセンスの顧客名
- The version of GitHub Enterprise Server インスタンス
- The hostname of your GitHub Enterprise Server instance
- GitHub Enterprise Serverのインスタンスに接続しているGitHub.com上のOrganizationまたはEnterpriseアカウント
- GitHub.com へのリクエストの発行に GitHub Enterprise Serverのインスタンス が使用する認証トークン
GitHub Connectを有効化すると、GitHub Enterprise CloudのOrganizationまたはEnterpriseアカウントが所有しているGitHub Appも作成されます。 GitHub Enterprise Server は GitHub App のクレデンシャルを使って GitHub.com へのリクエストを発行します。
GitHub Enterprise Server は GitHub App からのクレデンシャルを保存します。 以下のクレデンシャルは、High Availability あるいはクラスタリング環境ではレプリケーションされ、GitHub Enterprise Serverバックアップユーティリティ が作成するスナップショットを含むあらゆるバックアップに保存されます。
- 1 時間にわたって有効な認証トークン
- 新しい認証トークンを生成するのに使われる秘密鍵
GitHub Connect を有効化しても、GitHub.com のユーザは GitHub Enterprise Server を変更できるようになりません。
GraphQL APIを利用したEnterpriseアカウントの管理に関する詳しい情報については、「Enterprise アカウント」を参照してください。
GitHub Connect の有効化
- GitHub Enterprise ServerのインスタンスとGitHub.comにサインインしてください。
- GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings(Enterpriseの設定)をクリックしてください。
- Enterpriseアカウントのサイドバーで、 Settings(設定)をクリックしてください。
- 左のサイドバーでGitHub Connectをクリックしてください。
- 「GitHub Connect is not enabled yet」の下で、「EnableGitHub Connect」をクリックします。 By clicking Enable GitHub Connect, you agree to the "GitHub Terms for Additional Products and Features."
- 接続したいEnterpriseアカウントまたはOrganizationの横にある「Connect」をクリックします。
Disconnecting a GitHub Enterprise Cloud organization or enterprise account from your enterprise account
GitHub Enterprise Cloudから切断すると、EnterpriseアカウントまたはOrganizationからGitHub ConnectGitHub Appが削除され、GitHub Enterprise Serverのインスタンスに保存されているクレデンシャルが削除されます。
-
GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings(Enterpriseの設定)をクリックしてください。
-
Enterpriseアカウントのサイドバーで、 Settings(設定)をクリックしてください。
-
左のサイドバーでGitHub Connectをクリックしてください。
-
切断しようとするEnterpriseアカウントまたはOrganizationの横にある「Disable GitHub Connect」をクリックします。
-
切断に関する情報を読み、「 Disable GitHub Connect」をクリックします。