GitHub Connect について
GitHub Connectを有効化するには、GitHub Enterprise Server インスタンスとGitHub Enterprise Cloud のOrganizationまたはEnterpriseアカウントの両方で接続を設定しなければなりません。
接続を設定するには、プロキシの設定でgithub.com
および api.github.com
への接続が許可されていなければなりません。 詳細は「アウトバウンド Web プロキシサーバーを設定する」を参照してください。
GitHub Connectを有効化すると、Unified Searchや統合コントリビューションといった機能を使用できるようになります。 使用できるすべての機能についての詳細は、「 GitHub Enterprise ServerとGitHub Enterprise Cloudの間の接続を管理する」を参照してください。
GitHub Enterprise Server インスタンスをGitHub Enterprise Cloudに接続すると、GitHub.com上のレコードに、接続に関する情報が保存されます:
- GitHub Enterprise Server ライセンスの公開鍵の部分
- GitHub Enterprise Server ライセンスのハッシュ
- GitHub Enterprise Server ライセンスの顧客名
- GitHub Enterprise Server インスタンス のホスト名
- GitHub Enterprise Server インスタンス のバージョン
- 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 にサインインします。
1. Navigate to your enterprise account by visiting https://HOSTNAME/enterprises/ENTERPRISE-NAME
, replacing HOSTNAME
with your instance's hostname and ENTERPRISE-NAME
with your enterprise account's name.
- Enterpriseアカウントのサイドバーで、 Settings(設定)をクリックしてください。
- 左のサイドバーでGitHub Connectをクリックしてください。
- 「GitHub.com is not enabled yet」の下で、「EnableGitHub Connect」をクリックします。 「Enable GitHub Connect,」をクリックすると、 GitHub Enterprise ライセンスアグリーメントの GitHub Connect に関する補遺に合意したことになります。
- 接続したいEnterpriseアカウントまたはOrganizationの横にある「Connect」をクリックします。
GitHub Enterprise Server インスタンスGitHub Enterprise CloudOrganizationまたはEnterpriseアカウントを切断する
GitHub Enterprise Cloudから切断すると、EnterpriseアカウントまたはOrganizationからGitHub ConnectGitHub Appが削除され、GitHub Enterprise Server インスタンスに保存されているクレデンシャルが削除されます。
-
Navigate to your enterprise account by visiting
https://HOSTNAME/enterprises/ENTERPRISE-NAME
, replacingHOSTNAME
with your instance's hostname andENTERPRISE-NAME
with your enterprise account's name. -
Enterpriseアカウントのサイドバーで、 Settings(設定)をクリックしてください。
-
左のサイドバーでGitHub Connectをクリックしてください。
-
切断しようとするEnterpriseアカウントまたはOrganizationの横にある「Disable GitHub Connect」をクリックします。
-
切断に関する情報を読み、「 Disable GitHub Connect」をクリックします。