メインコンテンツまでスキップ

外部サービスポリシーによるパートナーガードレールの適用

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページから Unity Gatewayサービスポリシー プレビューにオプトインすることで、この機能へのアクセスを制御できます。ワークスペース レベルのプレビューを管理するを参照してください。

外部サービス ポリシーは、Unity Gatewayを通過するトラフィックに対し、すでに使用しているガードレールベンダー(AIセキュリティサービスやデータ損失防止サービスなど)の判断を適用します。ガバナンス対象の呼び出しごとに、Databricksは評価対象のコンテンツをベンダーのEndpointに送信します。アプリケーションを変更することなく、ベンダーは判定を返し、Databricksはそれを適用します。

サービスポリシー をアタッチするのと同じ方法で、外部サービスポリシーを モデルサービス 、 モデルプロバイダーサービス 、または MCP サービス にアタッチします。

外部サービスのポリシーの仕組み​

外部サービスポリシーは3つのパーツで構成されています:

  • Unity Catalog HTTP 接続は、ベンダーのEndpoint URLとそのOAuth認証情報を格納します。複数のポリシーで1つの接続を共有できます。
  • 外部サービスポリシーはサービスに添付されます。接続に名前を付け、フェーズ、ランク、モード、およびオプションのポリシー構成を設定します。Databricksは各リクエストに対してそれを実行し、結果を強制します。
  • ベンダーのガードレールはコンテンツを検査し、判定 ALLOW または DENY を返し、オプションでその理由も返します。MCPツール呼び出しでは、ASK を返すこともでき、ユーザーの承認を待つために呼び出しを保留できます。

Databricksが送信するリクエストと、Databricksが予期する判定を定義するDatabricks外部ポリシーAPIをベンダーが実装する必要があります。外部サービスポリシーAPIリファレンスをベンダーと共有し、サポートしているかどうか、およびEndpointの詳細を確認してください。Databricksは、個々のベンダー向けの統合を構築または保守しません。

ベンダーがAPIを実装していない場合は、代わりに カスタムPythonポリシー からそのAPIを呼び出すことができます。

始める前に​

必要なもの:

  • Databricks外部ポリシーAPIを実装するガードレールベンダーのEndpointです。
  • そのEndpointのOAuth マシン間(M2M)認証情報:クライアントID、クライアントシークレット、およびベンダーのトークンEndpoint URL。OAuth M2Mのみがサポートされている認証方法です。APIキー、基本認証、およびユーザー対マシンOAuthはサポートされていません。
  • 接続を作成するための権限 :CREATE CONNECTION特権、および接続が格納されているカタログとスキーマに対するUSE CATALOGおよびUSE SCHEMA特権。
  • ポリシーをアタッチするための権限 :ガバナンスを適用するサービスで MANAGE、接続で USE CONNECTION、接続のカタログおよびスキーマで USE CATALOG および USE SCHEMA。

2 つの権限セットは、異なるユーザーに属している場合があります。ポリシーをアタッチする人物が CREATE CONNECTION を持っていない場合は、ベンダーの認証情報を管理する人物が事前に接続を作成し、USE CONNECTION を付与することができます。

ステップ 1: ベンダーへの接続を作成する​

接続は、ベンダーのEndpointと認証情報を格納するUnity Catalogオブジェクトです。次の2つの方法のいずれかで作成できます:

  • ポリシーの添付中 に、ポリシーフォームで [新しい接続の作成] を選択します。これは、単一のガードレールに対して最も迅速なオプションです。
  • 事前 : カタログ エクスプローラーまたは CREATE CONNECTION を使用して OAuth マシン間 (M2M) 認証を持つ HTTP 接続を作成し、ポリシー フォームで [既存の接続を使用] を選択します。複数のポリシーで 1 つのエンドポイントを共有する場合や、別のチームがベンダーの認証情報を管理している場合に、このオプションを使用します。外部サービスへの接続の作成を参照してください。

ポリシーフォームから接続を作成する場合は、以下を入力します。

フィールド

説明

接続名

Unity Catalog 接続の名前(例:external_guardrail)。

[カタログ] と [スキーマ]

接続が Unity Catalog 内に保存される場所。

ホスト

スキームを含むベンダーのホスト(例: https://api.example.com)。

API パス (オプション)

そのホスト上のパス(例:/ai-security/v1)。

認証タイプ

常に OAuth M2M を使用します。このフィールドは変更できません。

クライアント ID と クライアント シークレット

ベンダーが発行したサービスアカウントの認証情報。

トークンのエンドポイント

ベンダーのOAuthトークンURL(例:https://api.example.com/oidc/v1/token)。

OAuthスコープ (オプション)

ベンダーが必要とする場合は、guardrail.read guardrail.scan などのスペース区切りのスコープ。

フィールド

説明

接続名

Unity Catalog 接続の名前(例:external_guardrail)。

[カタログ] と [スキーマ]

接続が Unity Catalog 内に保存される場所。

ホスト

スキームを含むベンダーのホスト(例: https://api.example.com)。

API パス (オプション)

そのホスト上のパス(例:/ai-security/v1)。

認証タイプ

常に OAuth M2M を使用します。このフィールドは変更できません。

クライアント ID と クライアント シークレット

ベンダーが発行したサービスアカウントの認証情報。

トークンのエンドポイント

ベンダーのOAuthトークンURL(例:https://api.example.com/oidc/v1/token)。

OAuthスコープ (オプション)

ベンダーが必要とする場合は、guardrail.read guardrail.scan などのスペース区切りのスコープ。

通常、ベンダーは1つのEndpointから多くのポリシーを提供し、ステップ2で設定したポリシー設定を使用してそれらを区別します。通常、ポリシーごとではなく、ベンダーのEndpointごとに1つの接続を作成します。

ステップ2:外部サービスポリシーをアタッチする​

  1. ワークスペースのサイドバーで、[ AI Gateway ] をクリックします。

  2. 管理するサービスを選択します。 [Models] tabのモデルサービス、 [Providers] tabのモデルプロバイダーサービス、または [MCPs] tabのMCPサービスのいずれかを選択します。

  3. [ ポリシー ] タブ を開き、[ 新しいポリシー ] をクリックします。

  4. ポリシーの Name を入力します。

  5. ガードレールタイプ で、 外部 を選択します。

  6. サービスの他のポリシーに対する相対的な評価順序を制御するには、 ランク を設定します。最も低いランクがリクエスト時に最初にランし、レスポンス時に最後に実行されます。また、DENY はそれ以降のすべてのランクを停止します。同じランクでは、ブロックする LLM-as-a-judge ポリシーの DENY のみがベンダーの呼び出しをスキップします。カスタム SQL ポリシーまたは同じランクの別の順次ポリシーの DENY ではスキップされないため、ベンダーは引き続きコンテンツを受信します。ポリシーが拒否したときにベンダーの呼び出しをスキップするには、外部サービスポリシーのランクよりも前に評価されるランクに設定します。評価順序を参照してください。

  7. フェーズ で、 入力ガードレール (サービスの呼び出し前)、 出力ガードレール (応答後)、またはその両方を選択します。ベンダーがリクエストのみを検査する場合は、入力のみを選択してください。入力と出力は個別に評価されます。ストリーミング評価では、出力フェーズで応答ごとにベンダーを複数回呼び出すことができます。

  8. 接続を選択します。 [既存の接続を使用] を選択してリストから選択するか、 [新しい接続を作成] を選択して ステップ 1 のフィールドを入力します。

  9. (オプション) ポリシー設定(Policy configuration) で、{"profile": "strict"}などのJSONオブジェクトを入力します。Databricksはこの値を読み取りません。入力したとおりの正確なテキストが、リクエストごとにベンダーに送信されます。ベンダーのドキュメントには、受け入れられるキーが記載されています。ベンダーが必要としない場合は、空のままにします。

  10. Advanced options を展開し、 Mode を選択します。

    • [強制] はベンダーの決定を適用します。DENY が呼び出しをブロックします。
    • Log はポリシーを評価し、何もブロックせずに想定される判定結果を記録します。結果を unified trace table で確認します。ここでは、各評価が policy_evaluated イベントであり、想定される判定結果が policy.dry_run_action および policy.dry_run_reason に含まれています。ポリシー評価イベントを参照してください。サービスに inference table がある場合、結果はそこに記録されます。
  11. (オプション)モデルまたはモデルプロバイダーサービスで、 レスポンス評価 の下にある 完全なレスポンス評価 を選択します。

  12. 「 ポリシーの作成 」をクリックします。

Databricksでは、 Log モードから開始することを推奨しています。ポリシーに実際のトラフィックを流し、ブロックされる内容を確認してから、 Enforce に切り替えます。

注記

ログモードでは呼び出しがブロックされませんが、すべての評価によってベンダーへの呼び出しが引き続き行われ、ベンダー契約に含まれるクォータまたは呼び出しごとの料金が消費されます。課金対象の評価を確認できるように、起動する前に、統合トレーステーブルまたはサービス上の推論テーブルを設定してください。

ステップ 3: ポリシーをテストする​

ポリシーをアタッチまたは変更した後は、変更が伝播するまでしばらく時間を置いてからテストしてください。伝播には通常 60~90 秒かかります。

次に、ベンダーのガードレールが検知するはずのリクエストを送信します。 Enforce モードでは、Databricks は呼び出しをブロックし、他のブロック用サービスポリシーと同様に、databricks_service_policy オブジェクトを含む成功(HTTP 200)応答を返します。ポリシーの決定を参照してください。ブロック reason はベンダーの説明です。ベンダーが何も返さない場合、呼び出し元には次のdefaultの理由が表示されます。

アクセス拒否:このリクエストは、このサービスのポリシーによって許可されていません。

Databricks がベンダーに送信するデータ​

各評価で、Databricks は評価対象のコンテンツ、呼び出し元から提供されたリクエストタグ、管理対象サービスの識別子、およびユーザーが設定したポリシー構成をベンダーに送信します。コンテンツはサービスとフェーズによって異なります。

サービス

フェーズ

コンテンツが送信されました

MCP サービス

入力

ツール名とその引数。

MCP サービス

出力

元のツール呼び出しと共に出力されるツール結果。

モデル サービスまたはモデル プロバイダー サービス

入力

メッセージなどの完全なモデルリクエストボディ。

モデル サービスまたはモデル プロバイダー サービス

出力

評価対象のモデル応答と、それを生成したリクエスト。ストリーミング評価では、部分的な応答のスナップショットになることがあります。

サービス

フェーズ

コンテンツが送信されました

MCP サービス

入力

ツール名とその引数。

MCP サービス

出力

元のツール呼び出しと共に出力されるツール結果。

モデル サービスまたはモデル プロバイダー サービス

入力

メッセージなどの完全なモデルリクエストボディ。

モデル サービスまたはモデル プロバイダー サービス

出力

評価対象のモデル応答と、それを生成したリクエスト。ストリーミング評価では、部分的な応答のスナップショットになることがあります。

モデルのリクエストおよびレスポンスの本文は、呼び出し元が使用した API 形式(OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Gemini など)で送信されます。Databricks はそれらを共通の形式に変換しません。

Databricks は、呼び出し元の認証された ID を送信しません。リクエストにトレースがある場合、Databricks はそのトレース ID も送信するため、ベンダーの Logs 内の評価とリクエストを照合できます。

各外部ポリシーは、 Log モードを含め、 event.context.request_tags として呼び出し元から提供された要求タグを受け取ります。評価器に送信されるタグをフィルタリングすることはできません。外部ポリシーを構成する際は、機微な識別子、およびベンダーによるこのメタデータとの互換性と取り扱いを確認してください。タグは呼び出し元が指定する申告情報であり、本人確認やプロジェクトを利用する権利の証明にはなりません。リクエストにタグを設定する方法については、リクエストへのタグ付けをご覧ください。

ベンダーは、外部サービスポリシー API リファレンスに、完全な要求および応答形式を確認できます。

ポリシーをアタッチする前にネットワークエグレスを確認する​

外部サービスポリシーは、評価対象のコンテンツ (未加工のモデルの要求と応答、またはMCPツールの引数と結果などを含むことができます) をサードパーティのサービスに送信します。ポリシーをアタッチする前に、ベンダーのデータ処理プラクティスを確認し、接続のターゲットを確認してください。

Unity Catalog接続は、資格情報と接続構成を管理します。到達可能なネットワークの宛先は制限されません。外部サービスポリシーには制限付きネットワークポリシーが必要ないため、ワークスペースにネットワークポリシーがない場合、アウトバウンドアクセスは制限されず、ポリシーは構成済みの接続を通じて到達可能な任意のEndpointに評価済みコンテンツを送信できます。

Databricks では、承認されたポリシーサービスの送信先のみを許可する、アクセス制限された ネットワークポリシーの適用を推奨しています。接続とネットワークポリシーおよびServerlessエグレス制御のためのネットワークポリシーの管理を参照してください。

フェイルクローズドの動作​

Enforceモードでは、外部サービスポリシーはクローズドで失敗します。ベンダーのEndpointが失敗するか、Databricksが使用できない応答を返した場合、Databricksは呼び出しを拒否します。各ケースについては、 Databricks が各応答を処理する方法 を参照してください。ベンダーが利用できないときにトラフィックを通過させるためにEnforceモードで外部サービスポリシーを構成することはできません。

Enforce モードでは、ベンダーの可用性とレイテンシーが、制御対象となるすべてのコールのクリティカルパスに置かれます。

  • ベンダーのレイテンシと可用性を確認してから、ポリシーを適用してください。Databricks は、ベンダーが時間内に応答しない場合、その呼び出しを拒否します。
  • ログモードではEndpointの問題はマスクされません。障害が発生しているEndpointでも DENY の結果が記録されるため、ログモードで予期しない拒否が多数発生する場合は、エンフォースに切り替える前にEndpointを修正するサインです。

制限事項​

次の制限が適用されます:

  • 評決 : 外部サービスポリシーは ALLOW または DENY を返し、MCPツール呼び出しでは、ユーザーの承認を待つために ASK を返すことができます。コンテンツの墨消しや書き換えはできません。
  • 一度に1つのサービス : ポリシーを単一のサービスにアタッチします。単一のステップで多数のサービスに1つのポリシーをアタッチする機能は使用できません。
  • UIのみ :外部サービスポリシーの添付は、Unity Gateway UIを介して行います。REST API または Terraform を介した添付は利用できません。
  • OAuth M2M のみ : 接続には OAuth マシン間(M2M)認証を使用する必要があります。
  • ベンダーサポートが必要です :ベンダーは Databricks 外部ポリシー API を実装する必要があります。Databricks はベンダーごとのアダプターを提供していません。

トラブルシューティング​

症状

考えられる原因

ポリシーをアタッチした直後は、ポリシーの効果はありません。

伝播ウィンドウ内でテストを実行しました。通常、これには 60~90 秒かかります。しばらく待ってから、もう一度お試しください。

すべての呼び出しが拒否されます。

Endpointにアクセスできない、エラーが返される、またはタイムアウトが発生するため、ポリシーはフェイルクローズになります。接続のホスト、パス、認証情報を確認し、ベンダーに問い合わせてEndpointの稼働状態を確認してください。

すべての呼び出しが拒否され、結果が認識されないという理由が返されます。

ベンダーが ALLOW、 DENY、または ASK 以外の判定を返しました。ベンダーにお問い合わせください。

拒否された呼び出しには、ベンダーのものではなくdefaultの理由が表示されます。

ベンダーから理由が返されなかったため、Databricksにはdefaultのテキストが表示されます。

Log モードには結果が表示されません。

サービス上の統合トレーステーブルも推論テーブルも設定されていないため、Log モードの結果はクエリー可能などこにも記録されません。このポリシーは引き続きベンダーを呼び出します。

接続は保存されますが、呼び出しは失敗します。

資格情報またはトークンの Endpoint が間違っています。クライアント ID、クライアント シークレット、トークンの Endpoint、および必要なスコープをベンダーに確認してください。

症状

考えられる原因

ポリシーをアタッチした直後は、ポリシーの効果はありません。

伝播ウィンドウ内でテストを実行しました。通常、これには 60~90 秒かかります。しばらく待ってから、もう一度お試しください。

すべての呼び出しが拒否されます。

Endpointにアクセスできない、エラーが返される、またはタイムアウトが発生するため、ポリシーはフェイルクローズになります。接続のホスト、パス、認証情報を確認し、ベンダーに問い合わせてEndpointの稼働状態を確認してください。

すべての呼び出しが拒否され、結果が認識されないという理由が返されます。

ベンダーが ALLOW、 DENY、または ASK 以外の判定を返しました。ベンダーにお問い合わせください。

拒否された呼び出しには、ベンダーのものではなくdefaultの理由が表示されます。

ベンダーから理由が返されなかったため、Databricksにはdefaultのテキストが表示されます。

Log モードには結果が表示されません。

サービス上の統合トレーステーブルも推論テーブルも設定されていないため、Log モードの結果はクエリー可能などこにも記録されません。このポリシーは引き続きベンダーを呼び出します。

接続は保存されますが、呼び出しは失敗します。

資格情報またはトークンの Endpoint が間違っています。クライアント ID、クライアント シークレット、トークンの Endpoint、および必要なスコープをベンダーに確認してください。

次のステップ​