GitHub Server Knowledge コネクタインジェスト用の GitHub サービスを設定する

GitHub Server Knowledge Microsoft 365 Copilot コネクタを使用すると、組織は GitHub Enterprise リポジトリから Markdown とテキストベースのナレッジをMicrosoft 365 Copilotおよび Microsoft Search エクスペリエンスにインデックスを作成できます。この記事では、organizationが GitHub Server Knowledge コネクタをデプロイする前に、GitHub 管理者が完了する必要がある構成手順について説明します。

コネクタをデプロイする方法については、「 GitHub Server Knowledge コネクタをデプロイする」を参照してください。

セットアップチェックリスト

次のチェックリストは、環境の構成とコネクタの前提条件の設定に関連する手順の一覧です。

タスク	役割
organization名を特定する	GitHub 管理者
ターゲット GitHub インスタンスへの API アクセスを確認する	GitHub 管理者
ID マッピングルールMicrosoft Entra ID定義する	GitHub 管理者
GitHub アカウントにサインインする	GitHub 管理者
認証用のカスタム GitHub アプリを構成する	GitHub 管理者
GitHub Server API のレート制限を調整する	GitHub 管理者

organization名を特定する

コネクタのセットアップに使用する GitHub organizationを決定します。

ターゲット GitHub インスタンスへの API アクセスを確認する

GitHub Enterprise インスタンスに API 経由でアクセスできることを確認します。

マッピングルールMicrosoft Entra ID定義する

インデックス付き GitHub データにアクセスするユーザーが、正確なアクセス許可マッピングを有効にするために、対応するMicrosoft Entra ID ID を持っていることを確認します。マッピングオプションには、電子メール、ログイン、および名前の属性が含まれます。

シングルサインオン (SSO) を使用して認証するエンタープライズマネージドユーザーの場合は、コネクタを設定する前にアカウントがサインインしていることを確認してください。 GitHub 認証フローでは、現在、構成中の SSO ベースのサインインはサポートされていません。

認証にカスタム GitHub アプリを使用する

最も効率的なセットアップエクスペリエンスを実現するために、Microsoft が管理する GitHub アプリを使用します。

独自の GitHub アプリを認証に使用することもできます。このオプションを選択した場合は、次のチェックリストの手順に従ってセットアップを完了します。

タスク	役割
GitHub アプリを作成して構成する	GitHub 管理者
GitHub アプリの資格情報を作成する	GitHub 管理者
GitHub アプリをインストールする	GitHub 管理者

GitHub アプリを作成して構成する

GitHub サービスを構成するための適切なアクセス許可が割り当てられていることを確認します。詳細については、「organizationのロール」を参照してください。

GitHub Server Knowledge コネクタで使用する GitHub アプリを作成するには:

GitHub で、右上のプロフィール写真を選択し、[Organization]\(組織\) を選択し、コネクタがデータをプルするorganizationを選択します。
[organizationの概要] ページで、[設定] を選択します。
左側のサイドバーで、[ 開発者設定 ] まで下にスクロールし、[ GitHub Apps] を選択します。
[ 新しい GitHub アプリ] を選択します。
アプリを構成します。
- GitHub アプリ名: 任意の名前を入力します。
- ホームページ URL: ブラウザーのアドレスバーから URL をコピーします。
- コールバック URL:
  - Microsoft 365 for enterprise の場合: https://gcs.office.com/v1.0/admin/oauth/callback
  - Microsoft 365 Government の場合: https://gcsgcc.office.com/v1.0/admin/oauth/callback
[Webhook] オプションをオフにします。
次のアクセス許可を設定します。

リポジトリのアクセス許可
- コンテンツ - 読み取り専用
- メタデータ - 読み取り専用
- 管理 - 読み取り専用
組織のアクセス許可
- メンバー - 読み取り専用
- 管理 - 読み取り専用
アカウントのアクセス許可
- Email アドレス - 読み取り専用
[ この GitHub アプリをインストールできる場所] で、[ 任意のアカウント] を選択し、[ GitHub アプリの作成] を選択します。

GitHub アプリの資格情報を作成する

GitHub アプリの [ 全般 ] ページで、[ 新しいクライアントシークレットの生成 ] を選択して、 クライアントシークレットを生成してコピーします。

GitHub アプリをインストールする

GitHub アプリの [ 全般 ] ページで、[アプリのインストール] を選択 します。
アプリをインストールするorganizationを選択します。

GitHub Server API のレート制限を調整する

プル要求、問題、ナレッジファイルなど、大量の GitHub データを取り込む場合、GitHub Server 環境の API レート制限構成は、インジェストプロセスの完了速度に直接影響します。 GitHub Server では、ユーザーまたはトークンごとに 1 時間あたり 15,000 件の認証済み要求の既定の API 制限が適用されます。この制限では、より小さなデータセットがサポートされますが、数十万または数百万の項目が処理されると、インジェストが遅くなる可能性があります。

organizationでスループットを向上させる必要がある場合は、API レート制限を引き上げることができます。制限が大きいほど、コネクタはアイテムをより迅速に取得できますが、GitHub Server インフラストラクチャの負荷も増加します。レート制限設定を更新する前に、増加した要求ボリュームをサポートするために、環境に適切な CPU 容量、ストレージ I/O、およびネットワーク帯域幅があることを確認します。制限を更新した後、システムパフォーマンスを監視して、より高いスループットで安定したインジェストを確保します。

レート制限の設定に関する推奨事項

次の表のガイダンスを使用して、GitHub 環境のプル要求のおおよその数に基づいて適切なレート制限設定を選択するのに役立ちます。

項目のおおよその数	推奨レート制限設定	インジェストを完了するまでのおおよその時間
最大 100,000	既定のレート制限設定を使用する (通常のインジェスト速度)	該当なし
100,000 から 1,000,000	レート制限を 30,000 要求/時間に引き上げる	2 日から 1 週間
1,000,000 以上	30,000 要求/時間以上を使用する (サーバーの容量に応じて)	1 ~ 2 週間 (環境の負荷によって異なります)

API レート制限設定を更新する

API 要求の制限を増やすには、次の手順を実行します。

管理者アカウントを使用して GitHub Server インスタンスにサインインします。
右上隅の [ サイト管理者 ] を選択して、管理モードに入ります。詳細については、「レート制限の構成」を参照してください。
左側のウィンドウで、[管理コンソール] (またはバージョンに応じて管理コンソール) を選択します。
[ レート制限 ] タブを開きます。
[HTTP API レート制限を有効にする] が選択されていることを確認します。
[ API 要求 (1 時間あたり) – 認証済み] で、レート制限値 ( 30000 など) を入力します。
[ 設定の保存] を選択します。

GITHub Server の [レート制限] タブのスクリーンショット。API 要求と [保存] 設定が強調表示されています。

注:

変更を保存すると、特定の GitHub Server サービスが再起動され、サービスが短時間中断される可能性があります。保存した後、構成がインスタンス全体に反映されるまでの時間を許可します。

次の手順

GitHub Server Knowledge コネクタをデプロイする

Last updated on 2025-12-15