脅威保護

​

モード

• Off (デフォルト) — チェックは実行されません。
• Normal — URL は Google Web Risk と照合され、マルウェア、ソーシャルエンジニアリング (フィッシング) 、不要なソフトウェアに関連するページやサイトが検出されます。スキャンした URL ごとに +2 クレジット。
• Zscaler — URL は、組織独自の Zscaler Internet Access (ZIA) テナントと照合されます。ブロックするよう選択した Zscaler 定義の URL カテゴリに加え、カスタム URL カテゴリとカスタム URL リストが対象です。以下の Zscaler モード を参照してください。スキャン料金なし — 分類は独自のテナントに対して実行されます。

​

ポリシー制御

• カスタムブラックリスト — 分類器を呼び出さずに常にブロックされる、完全一致のドメインまたはグロブ (例: *.example.com) 。
• カスタムホワイトリスト — 常に許可される、完全一致のドメインまたはグロブ。ホワイトリストは他のすべてのルールに優先するため、信頼するドメインがブロックされることはありません。
• ブロック対象の TLD — ラベル境界で照合され、無条件にブロックされるトップレベルドメイン (例: zip) 。
• リスクスコアのしきい値 — 分類器の判定をブロックとして扱う正規化スコア (0–100) のしきい値。低いほど厳格になります。デフォルトは 75 です。Normal モードに適用されます。Zscaler モードでは代わりにカテゴリによってブロックされます。
• 障害時ポリシー — 分類器に到達できない場合の動作: block (closed。デフォルトであり、セキュリティ制御として推奨) または allow (open) 。

​

Zscaler モード

• インライン分類 — URL はテナントの URL Lookup API を介して Zscaler 定義のカテゴリに分類され、拒否したカテゴリに属する URL はブロックされます。
• 同期されるカスタムルール — カスタム URL カテゴリ (URL リストとキーワード) および Zscaler 定義カテゴリへの追加は、スケジュールに従ってテナントから同期され、Firecrawl が直接評価します。これは、ZIA Lookup API がカスタム分類を返さないためです。ZIA で削除されたエントリは次回の同期時に削除されます。ダッシュボードから手動で 今すぐ同期 を実行することもできます。

​

テナントを接続する

​

容量と動作

• Map の結果はインラインで分類されず、ローカルルールのみ (リストと同期されたカスタムルール) に照らして評価されます。1 回の map で数千の URL が返されることがあり、それらを分類すると、取得されない可能性があるリンクに毎時の予算を消費してしまうためです。各 URL は、その URL のスクレイピング開始時に完全なチェックを受けます。
• Search の結果はインラインで分類され、blocked の結果は削除されます。これは Normal モードと同じです。結果内の一意の URL ごとに、毎時のルックアップ予算が消費されます。

​

ポリシーの設定

1. Enterprise Controls → 脅威保護 を開きます。
2. モードを選択し、リスクスコアのしきい値を設定して、ブラックリスト、ホワイトリスト、またはブロック対象の TLD エントリを追加します。
3. Zscaler モードの場合: テナント接続を入力し、接続テストを実行して、ブロックするカテゴリを選択し、同期間隔を設定します。
4. リクエストごとのオーバーライドを許可するかどうかを選択し、障害時ポリシーを設定します。
5. 保存します。変更は即時に反映され、次のリクエストから新しいポリシーに基づいて評価されます。

​

リクエストごとのオーバーライド

{
  "url": "https://example.com",
  "threatProtection": {
    "mode": "normal",
    "riskScoreThreshold": 50,
    "blacklist": ["*.risky.example"]
  }
}

​

URL がブロックされている場合

{
  "success": false,
  "code": "unsafe_domain_blocked",
  "error": "This URL (https://risky.example/landing) is blocked by your organization's threat protection policy (rule: blacklist). If you believe this is a mistake, contact your organization administrator to adjust the policy (e.g. whitelist the domain)."
}

• Scrape, バッチスクレイプ, extract, エージェント — ブロックされた対象では、その URL に対して unsafe_domain_blocked エラーが返されます。
• クロール — ブロックされたシード URL はリクエスト全体を失敗させます。クロールの途中で見つかったブロック済みのリンクはスキップされ、クロールは継続されます。
• Search, map — ブロックされた URL は、結果に表示して拒否するのではなく、返される結果から除外されます。

​

課金

• 独自のポリシー (ブラックリスト、ホワイトリスト、または ブロック対象の TLD への一致) のみで完結する判定では、分類器は呼び出されず、スキャン料金は課金されません。
• ブロックされたリクエストでも、判定を出したスキャン分は課金されます。
• スキャンは 1 回のスクレイピング内で重複排除されます。同じ URL へのリダイレクトによる再チェックでは元のスキャン結果が使われますが、別の URL に到達するリダイレクトは 2 回目のスキャンとなります。
• クロールとバッチスクレイプは、すべてのページを個別にチェックします。 判定がページ間で再利用されることはありません。トラフィックに関する情報は何も保存されないため (上記参照)、Normal モードでは、スクレイピングしたページごとに +2 クレジットかかると考えてください。クロールの途中で見つかってブロックされたリンクは、何ページからリンクされていても、クロールごとにそのスキャン分が 1 回だけ課金されます。
• Search と mapでは、結果セット内の各一意 URL をリクエストごとに 1 回スキャンするため、スキャン料金はスキャンされた結果数に応じて増加します。これは、結果が limit に合わせて切り詰められる場合、返される件数をわずかに上回ることがあります。

​

エラーリファレンス

​

注意事項

• このポリシーは組織全体に適用され、すべてのAPIキーとすべてのエンドポイントに自動的に適用されます。
• ホワイトリストが常に優先されるため、明示的に信頼されたドメイン上のURLが分類器やTLDルールによってブロックされることはありません。
• チェックはURLレベルですが、互換性のためにエラーコードunsafe_domain_blockedは変更されず維持されています。
• 障害時ポリシーがclosed (デフォルト) に設定されている場合、分類器で障害が発生すると、影響を受けるリクエストは暗黙的に許可されるのではなく、ブロックされます。
• SIEM Audit Loggingを設定すると、すべての判定が監査証跡に表示されます。イベントには、判定に使用されたルール、参照した分類器、脅威カテゴリ、およびZscalerによって分類されたURLの場合は、そのURLにセキュリティアラート分類が付与されていた際のsecurity_alertフラグが含まれます。