Inference hooksの設定

Inference hooksは、組織からのプロンプトを選択したAIセキュリティサーバーに送信し、Claudeが処理する前に各リクエストを保留して許可または拒否の判定を待ちます。このページでは、機能の有効化、サーバーの接続、適用の制御について順を追って説明します。Inference hooksの概要と使用すべき場面については、Inference hooksの概要を参照してください。AIセキュリティサーバー自体の構築については、Inference hooks統合の開発を参照してください。



始める前に

以下が必要です。

• claude.aiでのorganization:manage権限。組み込みのAdmin、Owner、Primary ownerロール、およびこの権限が付与されたカスタムロールがこれを保持しています。
• 判定リクエストを受け付けるAIセキュリティサーバーのHTTPSエンドポイント：ポート443上のhttps:// URLで、パブリックにルーティング可能なホスト上にあり、リダイレクトなしで到達可能なもの。完全なホスティング要件、およびサーバーの構築と署名付きリクエストの検証については、Inference hooks統合の開発を参照してください。



Inference hooksのセットアップ

適用には3つの状態があります。オフ（Enforce verdictsがオフ：AIセキュリティサーバーには一切連絡されず、プロンプトは検査されません）、シャドウ（Enforce verdictsがオンでModeがShadow modeに設定されている：AIセキュリティサーバーはプロンプトを受信して判定を返しますが、何もブロックされません）、適用中（Enforce verdictsがオンでModeがAllow the requestまたはBlock the requestに設定されている：拒否判定がリクエストをブロックします）。以下の手順では、新しい設定をオフから適用中まで進めます。



シャドウモード

シャドウモードは、何もブロックせずに本番トラフィックに対してフックを実行します。AIセキュリティサーバーは、適用時とまったく同じように管理対象プロンプトを受信して判定を返しますが、何もブロックされません。サーバーが拒否した場合や到達できない場合でも、すべてのリクエストがモデルに進み、エンドユーザーには何も表示されません。適用を開始する前に、組織の実際のトラフィックに対してポリシーを調整するために使用してください。

シャドウモードを使用するには、Failure handlingの下でModeをShadow modeに設定し、プロンプトがAIセキュリティサーバーに流れるようにEnforce verdictsをオンにします。有効な間、設定ページにはShadow mode — not blockingバッジが表示されます。シャドウモードを終了するには、ModeをAllow the requestまたはBlock the requestに戻します。適用がオンになると、判定が再び適用されます。



除外

Exclusionsの下で、メンバーがInference hooksの対象外となるロールを選択します。そのメンバーのプロンプトはAIセキュリティサーバーに送信されません。除外できるのは組織が作成したカスタムロールのみで、組み込みロールは提供されません。プレースホルダーにSelect roles to excludeと表示されているロールセレクターで選択し、各ロールを保持するユーザーはロール管理ページ（Manage roles）から管理します。除外の変更にはID管理権限が必要です。リストはデフォルトで空であり、除外されたロールがない場合、管理対象のすべてのリクエストが検査されます。

除外はユーザーのインタラクティブセッションに適用されます。マシン認証情報で認証されたトラフィックは常に検査されます。Claudeがリクエスト送信者のロールメンバーシップを解決できない場合、リクエストは検査なしで進行するのではなく、再試行可能なエラーでフェイルクローズします。除外リストへの変更は監査証跡に記録されます。



カスタムブロックプロンプトメッセージ

Custom blocked prompt messageの下で、AIセキュリティサーバーがリクエストを拒否したときにエンドユーザーに表示されるエラーに追加される、最大500文字のカスタムテキストを設定します（通常は連絡先や例外申請先など）。最終的なメッセージは、AIセキュリティサーバーのリクエストごとのdeny_reason（存在する場合）、空白行、そしてこのテキストの順になります。カスタムテキストが設定されていない場合、組み込みのデフォルトがユーザーに管理者への連絡を指示します。追加メッセージを完全にオフにして、ユーザーにdeny_reasonのみを表示することもできます。



AIセキュリティサーバーの監視

Inference hooks設定ページのエンドポイントヘルス領域には以下が表示されます。

• Endpoint status： Healthy、Tripped、Not enforcing、またはエンドポイントが保存される前はNot configured。
• Failures per minute： 過去2分間のWebhook失敗数の平均。
• Block rate： AIセキュリティサーバーの判定に占める拒否の割合。ロールアウト率が100未満の間に表示されます。
• Circuit breaker tripped： ブレーカーが最後にトリップした時刻（トリップした場合）。
• Recent errors： 各エントリはタイムスタンプ、エラータイプ、1行の理由に縮約されます。エントリにはリクエスト内容やエンドポイントURLは含まれません。

このパネルはベストエフォートです。Anthropicがカウンターを読み取れない場合、独自のエラーではなく、失敗ゼロおよびエラーなしと表示されるため、正常に見えるパネルだけではAIセキュリティサーバーが正常であることの証明にはなりません。Failures per minuteは、サーキットブレーカーをトリップさせないネットワークエラーやDNSエラーを含むすべての失敗をカウントするため、Circuit breaker trippedが空のままでも高い値になることがあります。



サーキットブレーカー

AIセキュリティサーバーに起因する持続的なWebhook失敗はサーキットブレーカーをトリップさせ、適用を停止します。サーバーには連絡されなくなり、検査対象のすべてのリクエストにFailure handlingの選択が適用されます。Block the requestが選択されている場合、対処するまで組織内のユーザーはブロックされます。ブレーカーがトリップすると、管理者にはclaude.aiの通知センターでも通知されます。

復旧するには、サーバーを修正してからEnforce verdictsを再度オンにしてブレーカーをリセットします。



署名シークレットのローテーション

Request signingの下のRotate secretをクリックして、署名シークレットを置き換えます。ローテーションは即時の切り替えです。新しいシークレットが生成されて一度だけ表示され、古いシークレットは取得できなくなり、両方のシークレットで署名されるリクエストは存在しないため、依存できる重複期間はありません。

ローテーション後も、以前のシークレットで署名されたリクエストが短時間届く可能性があります。AIセキュリティサーバーが切り替えをどのように処理すべきかについては、署名の検証を参照してください。



監査証跡

Inference hooksのアクティビティは、組織のActivity Feedに記録されます。設定変更、拒否、および障害処理設定の下で検査なしで進行したリクエストが含まれます。拒否レコードには、各拒否を自社システム内の対応するレコードと結合できる識別子が含まれています。



Inference hooksをオフにする

オフには2つのレベルがあります。

• Inference hooks設定ページでEnforce verdictsをオフにする：約1分以内に、組織からのプロンプトがAIセキュリティサーバーに送信されなくなります。すでに処理中のリクエストは古い設定で完了します。設定ページは引き続き利用可能なため、AIセキュリティサーバーの作業中に適用を一時停止する場合に使用してください。
• Data and privacy設定でAllow for your organizationをオフにする：プロンプトは検査されなくなり、再度オンにするまでInference hooks設定は利用できなくなります。エンドポイント設定、カスタムヘッダー、署名シークレットはいずれの場合も保持されます。再度オンにするとEnforce verdictsが強制的にオフになるため、準備ができたら適用を再度オンにしてください。



次のステップ