AIエンドポイントプロバイダによるAIスキャナー設定例

• 構成ファイルの構造: すべてのプロバイダに共通する必須フィールド
• OpenAIおよびOpenAI互換エンドポイント: OpenAI形式のチャット補完APIを通じて提供されるモデル
• Amazon Bedrock: AWS Bedrockでホストされているファウンデーションモデル
• Azure OpenAI: Azure OpenAIサービスとAzure AI Foundryのデプロイ
• Google Vertex AI: Google CloudでホストされているGeminiモデル
• カスタムHTTPエンドポイント: リクエストと対応テンプレートで説明されるその他のAPI
  • シンプルREST API
  • メッセージ配列を使用したChat completions API
  • ネストされたリクエストと対応の構造
• Trend Vision One–ホスト型ジャッジモデル: 独自のジャッジを持ち込むのではなく、トレンドのホスト型ジャッジを使用してください

構成ファイル構造

• version: 設定スキーマのバージョン、例えば2.9.0。AIスキャナーは古い1.xおよび2.xファイルを自動的に移行します。
• target: テスト中のAIアプリケーション
• judge:攻撃が成功したかどうかを評価するモデル
• attack_preset、attack_objectives、custom_prompts、またはagenticのいずれか: ターゲットに対して攻撃する方法。これらを組み合わせることができます。

• openaiとtrendai: Bearerスキームを使用してAuthorizationヘッダーで送信されます
• azureとauth_type: api_key: 設定変更できない固定api-keyヘッダーで送信
• custom: デフォルトではBearerスキームを使用してAuthorizationヘッダーに送信されます。ヘッダー名やプレフィックスを変更するには、auth_headerまたはauth_prefixフィールドを使用します。例えば、auth_prefix: "Token "です。
• bedrockとvertex: api_key_envは適用されません。これらのプロバイダーは、各セクションで説明されているように、AWSまたはGoogle Cloud認証情報チェーンを通じて認証されます。

• {{prompt}}: AIスキャナーは実行時にこのプレースホルダーを攻撃プロンプトに置き換えます。
• {{response}}: AIスキャナーはこの場所からモデル対応を抽出します。

重要 APIキーは環境変数に保存してください。APIキーを直接設定ファイルに含めないでください。検索を実行する前にapi_key_envという名前の環境変数を設定してください。

OpenAIおよびOpenAI互換エンドポイント

version: 2.9.0
name: OpenAI Compatible Scan
description: Security scan for an OpenAI-compatible chat endpoint
target:
  name: my-openai-app
  endpoint: https://api.openai.com/v1/
  api_key_env: TARGET_API_KEY
  openai:
    model: gpt-4o
    system_prompt: You are a helpful customer support assistant.
judge:
  name: judge
  endpoint: https://api.openai.com/v1/
  api_key_env: JUDGE_API_KEY
  openai:
    model: gpt-4o
settings:
  concurrency: 10
attack_preset: OWASP

Amazon Bedrock

version: 2.9.0
name: Bedrock Target Scan
description: Security scan for a Bedrock-hosted model
target:
  name: my-bedrock-app
  bedrock:
    region: us-east-1
    model: anthropic.claude-3-5-sonnet-20241022-v2:0
    temperature: 0.6
    system_prompt: You are a helpful AI assistant.
judge:
  name: judge
  endpoint: https://api.openai.com/v1/
  api_key_env: JUDGE_API_KEY
  openai:
    model: gpt-4o
attack_preset: OWASP

Azure OpenAI

version: 2.9.0
name: Azure OpenAI Target Scan
description: Security scan for an Azure OpenAI deployment
target:
  name: my-azure-app
  endpoint: https://my-resource.openai.azure.com
  api_key_env: TARGET_API_KEY
  azure:
    deployment_name: gpt-4o
    auth_type: api_key
    temperature: 0.6
    system_prompt: You are a helpful AI assistant.
judge:
  name: judge
  endpoint: https://api.openai.com/v1/
  api_key_env: JUDGE_API_KEY
  openai:
    model: gpt-4o
attack_preset: OWASP

Google Vertex AI

version: 2.9.0
name: Vertex AI Target Scan
description: Security scan for a Vertex AI-hosted Gemini model
target:
  name: my-gemini-app
  vertex:
    project: my-gcp-project
    location: us-central1
    model: gemini-2.5-flash
    temperature: 0.6
    system_prompt: You are a helpful AI assistant.
judge:
  name: judge
  endpoint: https://api.openai.com/v1/
  api_key_env: JUDGE_API_KEY
  openai:
    model: gpt-4o
attack_preset: OWASP

カスタムHTTPエンドポイント

• エンドポイントURL
• HTTP方式
• コンテンツタイプ宣言などのヘッダーフィールド
• リクエストボディのJSON構造には、{{prompt}}で示されたテキストプロンプトの位置が含まれています
• レスポンスボディのJSON構造には、モデル出力の位置が含まれており、{{response}}で示されています

シンプルなREST API

version: 2.9.0
name: Simple REST API Scan
description: Security scan for a basic text generation endpoint
target:
  name: my-text-api
  endpoint: https://api.example.com/v1/generate
  api_key_env: TARGET_API_KEY
  custom:
    method: POST
    headers:
      Content-Type: application/json
    request:
      input: "{{prompt}}"
      temperature: 0.2
    response:
      answer: "{{response}}"
judge:
  name: judge
  endpoint: https://api.openai.com/v1/
  api_key_env: JUDGE_API_KEY
  openai:
    model: gpt-4o
settings:
  concurrency: 10
attack_objectives:
  - name: System Prompt Leakage
    techniques:
      - None
    modifiers:
      - None
  - name: Sensitive Data Disclosure
    techniques:
      - None
    modifiers:
      - None

メッセージ配列を使用したチャット完了API

version: 2.9.0
name: Chat Completions API Scan
description: Security scan for a chat-style AI endpoint
target:
  name: my-chat-api
  endpoint: https://api.example.com/v1/chat/completions
  api_key_env: TARGET_API_KEY
  custom:
    method: POST
    headers:
      Content-Type: application/json
    request:
      model: my-model-v1
      messages:
        - role: system
          content: You are a helpful assistant.
        - role: user
          content: "{{prompt}}"
      stream: false
    response:
      choices:
        - finish_reason: stop
          index: 0
          message:
            content: "{{response}}"
            role: assistant
judge:
  name: judge
  endpoint: https://api.openai.com/v1/
  api_key_env: JUDGE_API_KEY
  openai:
    model: gpt-4o
settings:
  concurrency: 10
attack_objectives:
  - name: System Prompt Leakage
    techniques:
      - DAN (Do anything now)
    modifiers:
      - None
  - name: Malicious Code Generation
    techniques:
      - Ignore all previous instructions
    modifiers:
      - Base64 Encoding

ネストされたリクエストと対応の構造

version: 2.9.0
name: Nested Structure API Scan
description: Security scan for an endpoint with nested JSON payloads
target:
  name: my-nested-api
  endpoint: https://nlp.example.net/run
  api_key_env: TARGET_API_KEY
  custom:
    method: POST
    headers:
      Content-Type: application/json
    auth_prefix: "Token "
    request:
      payload:
        prompt: "{{prompt}}"
      config:
        temperature: 0.1
        max_tokens: 1000
    response:
      data:
        result:
          message: "{{response}}"
judge:
  name: judge
  endpoint: https://api.openai.com/v1/
  api_key_env: JUDGE_API_KEY
  openai:
    model: gpt-4o
settings:
  concurrency: 5
attack_objectives:
  - name: Sensitive Data Disclosure
    techniques:
      - Payload splitting
    modifiers:
      - Best-of-N Scrambling
  - name: Agent Tool Definition Leakage
    techniques:
      - None
    modifiers:
      - None

カスタムエンドポイントの制限

• JSONレスポンスのみ。AIスキャナーは非JSONレスポンスボディをサポートしていません。
• ストリーミングはありません。AIスキャナーは解析前に完全な対応本文を読み取るため、サーバ送信イベントやチャンクストリームをサポートしていません。
• 最初の配列要素のみ。対応テンプレートが配列を含む場合、AIスキャナーは常にインデックス0から抽出します。

ヒント アプリケーションがオフトピックのプロンプトをブロックするガードレールの背後にある場合、検索開始前にAI検索が送信する接続チェックを含め、チェックプロンプトを上書きするか、オプションのtarget.health_checkブロックで無効にすることができます。 target: health_check: enabled: true # set to false to skip the check entirely message: How can I do DC profiling?

Trend Vision Oneホスト型ジャッジモデル

version: 2.9.0
name: TrendAI Judge Example
description: Scan a customer OpenAI target with a Trend Vision One-hosted judge
target:
  name: customer-app
  endpoint: https://api.openai.com/v1/
  api_key_env: TARGET_API_KEY
  openai:
    model: gpt-4o
judge:
  name: trend-saas-judge
  api_key_env: TREND_AI_KEY
  trendai:
    region: us
attack_preset: OWASP

• us
• eu
• jp
• sg
• au
• in
• mea
• uk
• ca
• za