外部コンテンツのインデックス作成のための GitLab の構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • GitLab.comでグループ所有者ユーザーアカウントの個人用アクセストークンを作成して、GitLab外部コンテンツコネクタがGitLabソースシステムにアクセスできるようにします。

    始める前に

    GitLab 外部コンテンツコネクタを使用するには、GitLab計画が次の条件をすべて満たしている必要があります。
    オファリング

    専用またはGitLab自己管理ではなく、GitLab.comオファリングGitLab使用する必要があります。

    GitLabオファリングの詳細については、「https://docs.gitlab.com/subscriptions/choosing_subscription/#choose-an-offering」を参照してください。

    グループ所有者ユーザーアカウント
    外部コンテンツコネクタでクロールするすべての公開およびプライベートのトップレベルグループを所有する GitLab.comユーザーアカウントが必要です。コネクタは、 GitLab ソースシステムから検索可能なコンテンツ、ユーザーアクセス権限、およびセキュリティプリンシパルを取得するときに、このユーザーを代理操作します。
    公開コンテンツの要件
    取得する公開コンテンツは、グループ所有者ユーザーが所有する公開トップレベルグループに含まれている必要があります。
    プライベートコンテンツの要件

    取得するプライベートコンテンツは、Ultimate サブスクリプションレベルのプライベートトップレベルグループに属している必要があります。このグループは、グループ所有者ユーザーが所有している必要があり、このプライベートグループのエンタープライズユーザーのアクセス権限が設定されている必要があります。(コネクタは、エンタープライズユーザーのユーザーアクセス権限とセキュリティプリンシパルのみを取得します)。

    GitLabサブスクリプション レベルの詳細については、「https://docs.gitlab.com/subscriptions/choosing_subscription/#choose-a-subscription-tier」を参照してください。GitLabエンタープライズユーザーの詳細については、「https://docs.gitlab.com/user/enterprise_user/」を参照してください。

    組織の GitLab.com インスタンスのグループ所有者ユーザーアカウントのログイン認証情報が必要です。

    必要なロール:なし

    このタスクについて

    GitLab外部コンテンツコネクタは、GitLab API と、クロールするすべてのトップレベルグループを所有するユーザーアカウントに設定されたread_apiスコープを持つ個人アクセストークンを使用して、GitLab.comソースシステムからコンテンツを取得します。コネクタは、 GitLab.com ソース システムから検索可能なコンテンツとセキュリティ プリンシパルを取得するときに、この個人用アクセス トークンを使用して、指定されたユーザーを偽装します。

    ServiceNow AI Platformインスタンスアドミンは、GitLab.comソースシステムに適切に接続できるように GitLab 外部コンテンツコネクタを構成するために、この個人アクセストークンを必要としています。

    手順

    1. 検索可能なコンテンツを取得するすべてのトップレベルグループを所有するユーザーとして https://gitlab.com/ にログインします。
    2. メニューでアバターを選択し、[ プロファイルの編集] を選択します。
      GitLab.com のユーザーメニューの [プロファイルを編集] リンク。
    3. [アクセス トークン] を選択し、[新しいトークンの追加] を選択します。
      [新しいトークンを追加] ボタンが表示されているGitLab.comの [アクセストークン] ページ。
    4. 新しい個人アクセストークンの名前、オプションの説明、および有効期限を入力します。
      注:
      有効期限を入力しない場合、トークンの有効期限は自動的に現在の日付より 365 日後に設定されます。
    5. 新しい個人アクセストークンの read_api スコープを選択します。
    6. [トークンを作成 (Create token)] を選択します。
      トークン名、説明、有効期限、スコープ、および [トークンを作成] ボタンが表示されているGitLab.comの [個人アクセストークン] フォーム。
    7. メッセージが表示されたら、コピー アイコン を選択して新しい個人用アクセス トークンをコピーし、安全な場所に保存します。
      新しい個人アクセストークンが表示されているGitLab.comの [アクセストークン] ページ。
      重要:
      コネクタアドミンは、GitLab外部コンテンツコネクタを作成するためにこの個人アクセストークンを必要とします。トークンを作成した後は、再度アクセスできなくなります。

    次のタスク

    コネクタアドミンに次のアイテムを提供します。
    • GitLabインスタンスの URL。これは通常、 https://gitlab.com/です。
    • ステップ 7 でコピーしたグループ所有者ユーザーの個人アクセストークン。

    コネクタアドミンは、GitLab.comインスタンスから検索可能なコンテンツとセキュリティプリンシパルを取得するためのGitLab外部コンテンツコネクタを構成するために、これらのアイテムを必要とします。

    GitLab外部コンテンツコネクターの作成と設定の詳細については、「GitLab外部コンテンツコネクタの作成」を参照してください。