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

GitHub Server Issues Microsoft 365 Copilot コネクタは、GitHub Issue データを Microsoft 365 に統合します。

この記事では、Organizationが GitHub Server Issues コネクタをデプロイできるように、GitHub 管理者が完了するために必要な構成手順について説明します。コネクタをデプロイする方法については、「 GitHub サーバーの問題コネクタをデプロイする」を参照してください。

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

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

タスク	役割
organization名を特定する	GitHub 管理者
ターゲット GitHub インスタンスへの API アクセスを確認する	GitHub 管理者
ID マッピングルールMicrosoft Entra ID識別する	GitHub 管理者
GitHub アカウントにサインインする	GitHub 管理者
検索管理者のアクセス許可を確認する	GitHub 管理者
認証にカスタム GitHub アプリを使用する	GitHub 管理者
GitHub Server API のレート制限を調整する	GitHub 管理者
ファイアウォール設定を構成する	ネットワーク管理者

organization名を特定する

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

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

GitHub Enterprise Server インスタンスに API 経由でアクセスできることを確認します。コネクタで問題のインデックスを作成するには、API アクセシビリティが必要です。

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

Microsoft Entra IDマッピングルールを定義します。インデックス付き GitHub データにアクセスするユーザーが、正確なアクセス許可マッピングを許可するために対応するMicrosoft Entra ID ID を持っていることを確認します。

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

検索管理者のアクセス許可を確認する

コネクタを設定するユーザーが、organizationの Microsoft 365 テナントの検索管理者であることを確認します。

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

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

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

タスク	役割
GitHub アプリを作成して構成する	GitHub 管理者
GitHub アプリの資格情報を作成する	GitHub 管理者
GitHub アプリをインストールする	GitHub 管理者
ファイアウォール設定を構成する	ネットワーク管理者

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

GitHub サーバーの問題コネクタで使用する GitHub アプリを作成するには:

GitHub で、右上のプロフィール写真を選択し、[組織] を選択し、コネクタがデータをプルするorganizationを選択します。

組織が強調表示されている GitHub のスクリーンショット

[organizationの概要] ページで、[設定] を選択します。

[設定] が強調表示されている GitHub のスクリーンショット

左側のサイドバーで、[ 開発者設定 ] まで下にスクロールし、[ GitHub Apps] を選択します。

GitHub Apps が強調表示されている GitHub のスクリーンショット

[ 新しい GitHub アプリ] を選択します。

新しい GitHub アプリが強調表示されている 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 アプリの [ 全般 ] ページで、[ 新しいクライアントシークレットの生成 ] を選択して、 クライアントシークレットを生成してコピーします。

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

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

$[Install & Authorize]$承認のインストール$ が強調表示されている GitHub のスクリーンショット$

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 サービスが再起動され、サービスが短時間中断される可能性があります。保存した後、構成がインスタンス全体に反映されるまでの時間を許可します。

ファイアウォール設定を構成する

セキュリティを強化するために、Azure SQL サーバーまたはデータベースの IP ファイアウォール規則を構成できます。詳細については、「 IP ファイアウォール規則」を参照してください。

ファイアウォール設定に次のクライアント IP 範囲を追加します。

Region	Microsoft 365 Enterprise	Microsoft 365 Government
NAM	52.250.92.252/30, 52.224.250.216/30	52.245.230.216/30, 20.141.117.64/30
EUR	20.54.41.208/30, 51.105.159.88/30	該当なし
APC	52.139.188.212/30, 20.43.146.44/30	該当なし

IP 制限により、コネクタが動作を停止し、クロールエラーが発生する可能性があります。この問題を解決するには、コネクタの IP アドレスを許可リストに追加します。

次の手順

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

Last updated on 2025-12-15