Blank white background with no objects or features visible.

EMEAの皆様へ。TrueFoundryは、ヨーロッパ、中東、アフリカ全域で事業を拡大しています。詳細はこちら →

AI GatewayのSSOおよびSCIM設定ガイド

Published: 11月 20, 2026

要約
  • SSOとSCIMは異なる課題を解決します。 SSO(SAMLまたはOIDC)はログイン時に人間のユーザーを認証します。一方、SCIM 2.0はアカウントとそのグループメンバーシップの全ライフサイクルにわたってプロビジョニング、そして極めて重要な「プロビジョニング解除(アカウント削除・無効化)」を行います。両方が必要であり、SSO単体ではアクセス権が孤立して残ってしまいます。
  • SCIMが解決する失敗モードは、実に大きな害をもたらすものです。 APIキーの共有や手動でのオフボーディングでは、金曜日に退職した人物が月曜日にもまだ最も高額なモデルを呼び出せてしまいます。SCIMは、IdPがアカウントを無効化した瞬間に、どこからでも自動的にアクセス権を取り消します。
  • グループはコントロールサーフェス(制御面)です。 SCIMはユーザーとそのIdPグループをGatewayに同期します。グループをRBACロールにマッピングし、ロールによってチームが使用できるモデル、MCPサーバー、予算を制御します。アクセス権はIdPグループメンバーシップの属性となり、一元管理されます。
  • 設定は概念的に5つのステップで構成されます。 IdPアプリケーションの設定、SSO用のメタデータとクレームの交換、SCIMトークンとエンドポイントの発行、属性とグループのロールへのマッピング、そしてプロビジョニング、グループ変更、プロビジョニング解除のエンドツーエンドでのテストです。
  • これは単なる人間のログインだけでなく、エージェントガバナンスの基盤でもあります。 人間のアイデンティティがSSOとSCIMを通じてロールに流れるようになれば、同じロールとポリシーの仕組みをエージェントのアイデンティティ、ツールごとの詳細な認可、データレジデンシー制御へと拡張できます。

AI Gatewayにおけるセキュリティインシデントのほとんどは、決して風変わりなものではありません。退職した業務委託者のAPIキーが3週間後もまだ機能していたり、12個のノートブックに貼り付けられた共有の「チームキー」を誰かを困らせずにローテーションできなかったり、1人のエンジニアの記憶の中にしか存在しないモデルアクセス設定であったりします。エンタープライズAIのアクセス制御は、つまらない、防ぐことができたはずの方法で破綻します。そしてその対策は、他の本格的なエンタープライズシステムがすでに使用している配管と同じものです。認証のためのシングルサインオン(SSO)と、ライフサイクルのプロビジョニングのためのSCIMです。

本記事では、AIへのアクセスを静的キーではなくSSOとSCIM経由で実行しなければならない理由、各プロトコルの役割、それらがAI Gatewayの特有の要素(コンソールログイン、モデルアクセス、MCPサーバーアクセス、予算)にどのようにマッピングされるか、そして主要なアイデンティティプロバイダー(IdP)に対して概念的にどのように設定するかを解説します。本稿は、「AI GatewayをSSO配下に入れて」と言われ、単にウィザードをクリックするだけでなく、その仕組みを理解する必要があるプラットフォームエンジニアやセキュリティエンジニアに向けて書かれています。

チームが使用するすべてのモデルとMCPサーバーにSSOとSCIMを連携させたいですか? デモを予約する。

なぜ共有キーは失敗し、アイデンティティがそれを解決するのか

まず、ほとんどのチームが実際にやっていることから始めましょう。長寿命のAPIキー(多くはチームごとに1つ、時には会社全体で1つ)を使い回してGatewayを呼び出す方法です。これには構造的な問題が4つあり、その4つすべてがアイデンティティベースのアクセス制御によって解決されます。

  • 帰属性(アトリビューション)がない。 共有キーを使うと、すべてのリクエストが同じように見えます。トークンで400ドルの費用がかかったクエリを誰が実行したのかを特定できず、Gatewayが提供するはずのユーザーごとの可視性や予算管理が無効化されてしまいます。
  • ライフサイクルがない。 キーは誰かが退社したことを認識しませんし、気にすることもありません。キーを取り消すにはローテーションを行う必要がありますが、それは正当に使用している全員のキーを更新することを意味します。そのため、実際にはローテーションされることがなく、アクセス権が終了することもありません。
  • 粒度がない。 1つのキーは機能するか機能しないかのどちらかです。キーにゲート制御を行うためのアイデンティティが含まれていないため、「このチームは低価格モデルを使用してもよいが、最先端モデルは使用不可」といった制御ができません。
  • 中央制御がない。 アクセスポリシーはキーが存在する場所に分散して存在し、実質的にどこにも存在しないことになります。

SSOとSCIMはこれを、アクセス権が「アイデンティティプロバイダー(IdP)内であなたが誰であるか」および「どのグループに所属しているか」の関数となるモデルに置き換えます。認証はログイン時にアイデンティティを証明します。プロビジョニングは、誰が存在し、誰がどのグループに所属しているかというGateway側の情報を、IdPと自動的に同期させます。IdPがアカウントを無効化すると、手動のステップなしで、そのアカウントが到達していたすべての場所でアクセスが終了します。この「自動プロビジョニング解除」という単一の特性こそが、エンタープライズAIにとってこれが不可欠である理由です。

SSOとSCIMは同じものではない

両者は日常的に混同されがちですが、混同することこそが孤立したアクセス権(Orphaned Access)が発生する原因となります。SSOはユーザーをログインさせます。SCIMは、そもそもそのアカウントやグループメンバーシップが存在するかどうかを管理します。SSOは「認証イベント」であり、SCIMは「ライフサイクルの同期」です。

次元SSO (SAML / OIDC)SCIM 2.0
目的ログイン時にユーザーを認証するアカウントおよびグループメンバーシップのプロビジョニング、更新、プロビジョニング解除を行う
実行のタイミングログインごと(対話的)IdP内の変更をトリガーとして継続的(ユーザー不在で実行)
プロトコルSAML 2.0アサーション または OpenID Connect (OAuth 2.0) IDトークンREST/JSON上のSCIM 2.0(RFC 7643スキーマ、RFC 7644プロトコル)
保持する情報「今」ユーザーが誰であるか、およびアサーション内のクレーム(メールアドレス、グループ)完全なユーザーレコードとグループメンバーシップ(変更時にプッシュ配信)
これがないと破綻することユーザーが個別のパスワードを管理、中央ログインの不在、不十分なMFA設定オフボーディング後もアカウントやアクセス権が残留、グループ変更が伝播しない、手動のプロビジョニング解除
例え入館のたびに身分証をチェックする警備員身分証の発行・失効を行う人事プロセス

危険なのは、SSOを設定し、社員が社内アイデンティティでログインできているのを見て勝利を宣言してしまうことです。SSO単体の場合、IdPで誰かがオフボーディングされた際、その人物のログイン機能は失われますが、Gatewayが帯域外でアカウントとアクセス権をプロビジョニングしていた場合や、依然としてトークンやキーを保持している場合、アカウントとその権限は残存する可能性があります。SCIMは、IdPが「この人物は退職した」と告げたときに、Gateway内にアクセスしてアカウントとそのグループメンバーシップ削除する役割を果たします。両方が必要なのです。ログインを一元化しMFAで保護するためのSSOと、存在とアクセス権を信頼できる情報源(Source of Truth)に追従させるためのSCIMです。

AI Gatewayへのマッピング方法

AI Gatewayには保護すべき特定の対象があり、アイデンティティはそれらそれぞれに結合します。チェーンはアイデンティティプロバイダーから始まり、モデル、MCPサーバー、予算に対する具体的なポリシーへと繋がります。

Identity flow: the IdP (Okta, Entra ID, and the like) authenticates via SSO (SAML or OIDC) and provisions via SCIM into the gateway, where groups map to RBAC roles, and roles enforce policy on models, MCP servers, and budgets.
アイデンティティのフロー:IdP(Okta、Entra IDなど)はSSO(SAMLまたはOIDC)を介して認証を行い、SCIMを介してGatewayへとプロビジョニングします。GatewayではグループがRBACロールにマッピングされ、ロールがモデル、MCPサーバー、予算に対するポリシーを強制適用します。

チェーンを左から右へと進めてみましょう。

  1. コンソールおよびAPIアクセス用のSSO。 エンジニアがGatewayのコンソールを開くと、ローカルパスワードではなく、SAMLまたはOIDCを介してIdP経由で認証されます。アサーションまたはIDトークンはアイデンティティを証明し、クレームを保持します。同じアイデンティティがプログラムによるアクセスもバックアップするため、API呼び出しは匿名の共有キーではなく、実際の人物またはサービスに帰属させることができます。
  2. SCIMによるユーザーとグループの同期。 IdPは、ユーザーレコードとそのグループメンバーシップの変更が発生した際、GatewayのSCIMエンドポイントにそれらをプッシュします。IdPで「ml-platform」グループに追加された新しい社員は、誰もGatewayに触れることなく、そのグループのメンバーとしてGateway内に現れます。
  3. グループのRBACロールへのマッピング。 「ml-platform」グループがあるロールにマッピングされ、「finance-analysts」が別のロールにマッピングされるよう、一度だけ定義します。このマッピング設計の核心であり、アイデンティティが「認可(Authorization)」へと変わる場所です。
  4. ロールによるモデル、MCPサーバー、予算の制御。 ロールは権限(エンタイトルメント)を保持します。呼び出し可能なモデル、アクセス可能なMCPサーバー、適用されるレート制限やトークン予算などです。TrueFoundryはユーザー、チーム、モデルごとに予算とレート制限を強制適用し、違反時にはHTTP 429を返します。これにより、ロールはアクセスの許可と支出の上限設定の両方を行うことができます。

その結果、最も高額な最先端モデルや、機密性の高い社内MCPサーバーへのアクセスは、IdPグループメンバーシップの属性となります。アクセス権の付与はIdPでユーザーをグループに追加することで行い、取り消しはグループから削除することで行います。GatewayのRBACの詳細については詳細な認可(Fine-grained Authorization)で、また「そもそもこれをどう選べばいいのか」という広範なフレームワークについてはAI Gatewayの選び方で詳しく解説しています。

具体的なグループからロールへのマッピング例

抽象的な概念を具体化するためのマッピング例を以下に示します。ロール名と権限は自社のポリシーに合わせて調整してください。

IdPグループGatewayロール許可されるモデル許可されるMCPサーバー予算 / 制限
ml-platformplatform-admin最先端の推論モデルを含むすべて管理ツールを含むすべて高い月間予算、高いRPS
product-engapp-developer中位ティアのチャット+埋め込みモデル読み取り専用の社内データサーバー中規模予算、超えた場合は429
finance-analystsanalyst低価格チャットモデルのみ財務データサーバーのみ低予算、厳格なレート制限
contractorsrestrictedサンドボックスモデル1つのみ社内サーバーへのアクセス不可最小限の予算、短いトークン上限
(オフボーディング済み:全グループから削除)なしなしなしなし — アクセス権取り消し済み

最後の行こそが最も重要なポイントです。IdPグループからの削除(SCIMによって自動的に伝播されます)により、個人の権限は完全に無効化されます。チケットの起票も、手動でのキーローテーションも、「どこかにアクセス権が残っていないか」と心配する必要もありません。

TrueFoundryがどのようにIdPグループをGateway全体でRBACロールにマッピングするかをご覧ください。 デモを予約する。

ステップバイステップでの設定手順

実際の画面はアイデンティティプロバイダーによって異なりますが、概念的な手順はOkta、Entra ID、Google Workspace、その他のSAML/OIDCおよびSCIM 2.0対応IdPのいずれでも同じです。記憶に頼ってプロバイダー固有のラベルを創作するのではなく、フィールド名については各IdPの公式ドキュメントに従ってください。全体の流れは以下の通りです。

ステップ 1: IdPでアプリケーションを作成する。 アイデンティティプロバイダーで、Gatewayをエンタープライズアプリケーションとして登録します。これが、SSO設定と後述のSCIM設定の両方を保持するオブジェクトとなります。割り当てられたユーザーのみがプロビジョニングされるため、どのユーザーとグループをこのアプリケーションに割り当てるかをここで決定します。

ステップ 2: SSOを設定する(メタデータとクレーム)。 SAMLまたはOIDCのいずれかを選択します。SAMLの場合、メタデータを交換します。IdPはエンティティID、サインインURL、署名証明書を提供し、Gatewayはアサーション消費サービス(ACS)URLとエンティティIDを提供します。OIDCの場合、クライアントを登録して発行者URL、クライアントID、シークレットを交換し、リダイレクトURIを設定します。いずれの場合も、クレームを設定します。最低限ユーザーのメールアドレスまたは一意の識別子を含め、さらに非常に重要な要素としてユーザーのグループメンバーシップを含めます。グループこそがロールにマッピングされる対象だからです。グループクレームがアサーションまたはトークンに実際に含まれていることを確認してください。グループクレームの欠落は、ロールマッピングがサイレントに失敗する最も一般的な原因です。

ステップ 3: SCIMを有効化する(トークンとエンドポイント)。 プロビジョニング機能をオンにします。GatewayはSCIM 2.0ベースエンドポイント(URL)を公開し、管理者はIdPがそれを呼び出すことを認可するためのベアラートークンを生成します。エンドポイントとトークンをIdPのプロビジョニング設定に貼り付けます。IdPはSCIMエンドポイントを呼び出して接続をテストします。テストが成功すれば、IdPはGateway内でユーザーとグループの作成、読み取り、更新、無効化を行えるようになります。

ステップ 4: 属性とグループをロールにマッピングする。 IdPのユーザーフィールド(メールアドレス、表示名、外部ID)がGatewayのユーザーレコードに正しく反映され、SCIMグループのプッシュがGatewayのグループとして登録されるように属性マッピングを設定します。次に、Gateway側で、前述の表のように各グループをモデル、MCPサーバー、予算制限の権限を持つRBACロールにマッピングします。このマッピングがポリシーそのものとなるため、アクセスガバナンスの責任者によるレビューを受けてください。

ステップ 5: ライフサイクル全体をテストする。 ログインテストだけで運用を開始しないでください。ライフサイクルの3つのイベントすべてをテストします。

  • プロビジョニング(追加): IdPでテストユーザーをマッピング済みグループに追加し、Gateway上で正しいロールで表示されること、およびそのロールで許可されているモデルとサーバーのみを呼び出せることを確認します。
  • 変更(所属変更): IdPでテストユーザーのグループを変更し、Gatewayでのロールと権限が一致するように変更されることを確認します。
  • プロビジョニング解除(削除): IdPでテストユーザーを無効化し、SCIMによる無効化によってアクセス権が削除されること、および以前は成功していた呼び出しが失敗することを確認します。このステップによって、孤立したアクセス権の問題が実際に解決されたことが証明されます。

SCIMが自動化するライフサイクル

価値提案のすべては、従業員や業務委託者の在籍期間中に発生する3つのイベントに集約されており、SCIMは人間がGatewayに触れることなく、これら3つすべてを処理します。

The lifecycle SCIM automates: join (auto-provision the account and assign a role from group membership), move (a group change in the IdP changes gateway access), and leave (SCIM deprovision revokes access everywhere).
SCIMが自動化するライフサイクル:入社(アカウントを自動プロビジョニングし、グループメンバーシップからロールを割り当てる)、異動(IdPでのグループ変更がGatewayのアクセス権を変更する)、退職(SCIMのプロビジョニング解除がすべての場所でアクセス権を取り消す)。
  • 入社(Joiner)。 人事やIT部門は、オンボーディングの一環としてIdP内のグループに人物を追加します。SCIMはGatewayアカウントをプロビジョニングし、グループからロールへのマッピングを通じて、まさに適切な権限を付与します。本人は、Gateway側でのチケット発行なしで、入社初日から正常かつ適切にスコープ設定されたAIアクセス権を手にすることができます。
  • 異動(Mover)。 誰かがプロダクトエンジニアリングからMLプラットフォームチームに異動したとします。その人物のIdPグループメンバーシップが変更されます。SCIMはその変更を伝播させ、Gatewayでのロールが変更されます。これにより、最先端モデルへのアクセス権を獲得し、古いチームのデータサーバーへのアクセス権を失います。アクセス権は組織図に自動的に追従します。
  • 退職(Leaver)。 その人物がオフボーディングされます。IdPがアカウントを無効化します。SCIMはGatewayアカウントを無効化し、グループメンバーシップを削除します。すべての権限、すべてのモデル、すべてのMCPサーバー、すべての予算が即座にゼロになります。削除を忘れてしまうような手動のステップが存在しないため、退職した人物がアクセス権を維持したままになる時間窓(タイムラグ)は存在しません。

これを共有キーの世界と比較してみてください。入社は適切なキーを見つけて共有することを意味し、異動は自動的には何も変わらないことを意味し、退職は誰かがキーのローテーションを思い出す必要があることを意味します。しかしローテーションすると他の全員の環境も壊れてしまうため、結局実行されません。このライフサイクルのギャップこそが、まさにセキュリティブリーチ(侵害)が存在する場所なのです。

人間の先にあるもの:エージェントとデータレジデンシー

SSOとSCIMを通じた人間のアイデンティティ管理は基本ですが、エンタープライズAIのアクセス制御には、人間だけではカバーしきれない2つの側面があります。

第一に、エージェントも呼び出し元(Caller)であるということです。モデルやMCPサーバーを呼び出す自律型エージェントには、人間のキーを借りるのではなく、それ自身のアイデンティティ、ロール、予算が必要です。人間のグループをロールにマッピングするのと同じRBACの仕組みがエージェントのアイデンティティにも拡張され、エージェントは特定のツールへの最小権限アクセスと制限された予算を取得します。これはアイデンティティに関する取り組みの自然な延長線上にあるものです。AIエージェントのアイデンティティや、エンタープライズにおけるMCPガバナンスのMCP固有の制御を参照してください。

第二に、アイデンティティとデータがどこに存在するかが重要であるということです。認証とプロビジョニングは「誰が何を呼び出してよいか」を決定し、デプロイメントは「リクエストとそのデータが物理的にどこへ行くか」を決定します。TrueFoundryはSaaS、In-VPC、オンプレミス、あるいはエアギャップ環境としてデプロイできるため、アイデンティティを既存のIdPと統合しながら、データプレーンをご自社のネットワーク内に留めることができます。規制の厳しいワークロードにおいて、この分離は「使えるGateway」と「コンプライアンスの障害」を分ける決定的な違いとなります。仕組みの詳細はデータレジデンシーおよびコントロールプレーンとデータプレーンの分離で解説しています。

チームが陥りがちな間違い

SSOを設定してSCIMをスキップしてしまう。 ログインが一元化されて誰もが満足しますが、オフボーディング時にアカウントや権限が置き去りにされます。プロビジョニング解除を同期するものが何もないからです。SCIMのないSSOは認証を解決しますが、ライフサイクルを無視しています。必ず両方を設定してください。

プロビジョニング解除をテストしない。 新しいユーザーは初日からアクセスが必要になるため、プロビジョニング(追加)の経路はテストされます。しかし、実際に自社を守るプロビジョニング解除(削除)の経路は「大丈夫だろう」と推測で済まされてしまいがちです。設定を変更した際は必ず、テストアカウントを無効化し、以前は動作していた呼び出しが失敗することを確認してください。

グループクレームを忘れがち。 SSOは機能し、ユーザーはログインできますが、IdPアサーションにグループメンバーシップが含まれていなかったため、全員がデフォルトまたは空のロールに割り当てられてしまいます。ロールマッピングは、グループクレームが存在し、正しく名前が付けられていることに完全に依存しています。実際の文脈(アサーションまたはトークン)の中で必ず検証してください。

「バックアップ」として共有キーを残してしまう。 1つの管理者キーや緊急アクセス用(Break-glass)キーを有効なまま残しておくと、帰属性がなくなり、プロビジョニング解除もされないため、モデル全体が無効化されてしまいます。緊急アクセスが必要な場合は、恒久的な共有シークレットではなく、名前が特定され、監査され、短寿命の経路を作成してください。

全員を1つの広範なロールにマッピングしてしまう。 SCIMを介して単一の「全ユーザー」ロールにプロビジョニングすると、帰属性は得られますが最小権限の原則は満たされません。誰もが最先端モデルとすべてのMCPサーバーを呼び出せてしまうからです。グループからロールへのマッピングの目的は、粒度を持たせることです。実際のチームと実際の権限をモデル化してください。

結論

エンタープライズAIのアクセス制御の失敗は、複雑な理由で起きるわけではありません。共有キーがそれを使用していた人物よりも長生きしたから、オフボーディングが誰かが忘れた手動ステップだったから、誰がトークン予算を使い果たしたのか誰も特定できなかったから失敗するのです。SSOとSCIMは、アクセス制御を「アイデンティティの関数」とすることでこれらのギャップを埋めます。SSOはアイデンティティプロバイダーを通じてすべてのログインを認証し、SCIMは誰が存在し誰がどのグループに属しているかというGateway側の情報を、信頼できる情報源(IdP)と自動的に同期させます。

両方をセットアップし、グループを最小権限の原則に基づいた実際の権限を持つロールにマッピングし、信頼できるまでプロビジョニング解除の経路をテストしてください。そうすれば、最も高額なモデルや最も機密性の高いMCPサーバーへのアクセス権は、グループに人を追加することで付与し、削除することで取り消すことができるものになります。即座に、そしてあらゆる場所で。その同じアイデンティティ基盤は、その後、エージェントのアイデンティティ、ツールごとの詳細な認可、そして規制されたAIが必要とするデータレジデンシー制御へと引き継がれていきます。

AIスタックにおける「入社・異動・退職(JML)」アクセスの自動化を始めましょう。 デモを予約する。

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
11月 20, 2026
|
5 min read

GPT-6.1 Terra: API、ベンチマーク、料金体系、使い方ガイド

No items found.
11月 20, 2026
|
5 min read

Machine Learningの進化:Savinの歩みを深く掘り下げる

True MLトーク
11月 20, 2026
|
5 min read

CrewAI vs LangGraph: 違いを知る

比較
11月 20, 2026
|
5 min read

すべてのリクエストを評価:Confident AIとTrueFoundry AI Gateway

No items found.
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.
Take a quick product tour
Start Product Tour
Product Tour