GitHub Connect の管理

GitHub Connect を有効にすると、お使いの GitHub Enterprise Server インスタンスの追加の機能とワークフローにアクセスできます。

この記事の内容

GitHub Connect について

GitHub Connect を有効にすると、お使いの GitHub Enterprise Server インスタンスの追加の機能とワークフローにアクセスできます。 詳しくは、「GitHub Connect について」を参照してください。

GitHub Connect を有効にするときに、お使いの GitHub Enterprise Server インスタンス と GitHub Enterprise Cloud の Enterprise アカウントとの間の接続を構成します。 接続には、ポート 443 または 80 経由の HTTPS が使用され、TLS によって保護されます。

GitHub Connect を有効にすると、Enterprise アカウントによって所有された GitHub App が GitHub Enterprise Cloud 上に作成されます。 GitHub Enterprise Server で GitHub App の資格情報を使って GitHub Enterprise Cloud への要求が発行されます。

GitHub Enterprise Server で GitHub App からの資格情報が保存されます。 次の資格情報が高可用性またはクラスター環境のすべてのノードにレプリケートされ、GitHub Enterprise Server Backup Utilities によって作成されたスナップショットを含むすべてのバックアップに保存されます。

  • 1 時間にわたって有効な認証トークン
  • 新しい認証トークンを生成するために使われる秘密キー

前提条件

GitHub Connect を使うには、GitHub.com で GitHub Enterprise Cloud を使う Enterprise アカウントを持っている必要があります。 GitHub Enterprise Cloud は、ご利用のプランに既に含まれている場合があります。

注: GitHub.com のエンタープライズ アカウントに請求する必要があります。 GitHub Enterprise Cloud の無料試用版またはクレジット カード払いのエンタープライズ アカウントは、お使いの GitHub Enterprise Server インスタンス に接続できません。

GitHub.com の Enterprise アカウントで IP 許可リストを使う場合、お使いの GitHub Enterprise Server インスタンスの IP アドレスまたはネットワークを GitHub.com の IP 許可リストに追加する必要があります。 詳しくは、GitHub Enterprise Cloud のドキュメントの「Enterprise でセキュリティ設定のポリシーを適用する」をご覧ください。

接続を構成するには、プロキシ構成で github.com、api.github.com、uploads.github.com への接続が許可されている必要があります。 詳しくは、「アウトバウンドの Web プロキシ サーバーの設定」を参照してください。

GitHub Connect の有効化

GitHub Connect を有効にするには、GitHub Enterprise Server と GitHub Enterprise Cloud の両方で Enterprise 所有者になる必要があります。

  1. お使いの GitHub Enterprise Server インスタンスと GitHub.com にサインインします。

  2. GitHub Enterprise Server の右上で、ご自分のプロフィール フォトをクリックしてから、 [Enterprise 設定] をクリックします。

    GitHub Enterprise Server のプロファイル写真をクリックしたときに表示されるドロップダウン メニューのスクリーンショット。 [エンタープライズ設定] オプションが濃いオレンジ色の枠線で強調表示されています。

  3. [Enterprise アカウント] サイドバーで、 [GitHub Connect] をクリックします。

  4. [GitHub Connect はまだ有効になっていません] で、 [GitHub Connect を有効にする] をクリックします。 [GitHub Connect を有効にする] をクリックすると、「追加の製品および機能に適用される GitHub 条件」に同意したことになります。

  5. 接続しようとする Enterprise アカウントの右側にある [接続] をクリックします。

GitHub Connect を無効にする

Enterprise 所有者は GitHub Connect を無効にすることができます。

GitHub Enterprise Cloud から切断すると、Enterprise アカウントから GitHub Connect GitHub App が削除され、お使いの GitHub Enterprise Server インスタンス に保存されている資格情報が削除されます。

  1. GitHub Enterprise Server の右上で、ご自分のプロフィール フォトをクリックしてから、 [Enterprise 設定] をクリックします。

    GitHub Enterprise Server のプロファイル写真をクリックしたときに表示されるドロップダウン メニューのスクリーンショット。 [エンタープライズ設定] オプションが濃いオレンジ色の枠線で強調表示されています。

  2. [Enterprise アカウント] サイドバーで、 [GitHub Connect] をクリックします。

  3. "GitHub Connect" で、切断する Enterprise アカウントの右側にある [GitHub Connect を無効にする] をクリックします。

  4. 切断に関する情報を読んでから、 [GitHub Connect を無効にする] をクリックします。