IP制限
チームのAPIキーをIPアドレスまたはCIDR範囲の許可リストに制限し、承認済みネットワークからのみ利用できるようにします。サーバー側で適用されます。
IP制限を使うと、APIリクエストの送信元として許可するIPアドレスとCIDR範囲の許可リストをチームで管理できます。この許可リストは、認証済みのすべてのリクエストに対して認証時にサーバー側で適用されるため、APIキーが漏えいまたは不正に持ち出されても、承認済みネットワークの外では使用できません。
許可リストはチーム単位で適用されます。つまり、チームのすべてのAPIキーに一括で適用されます。
IP制限はエンタープライズ向け機能で、組織ごとに有効化されます。ご利用のアカウントで有効にするには、Firecrawlのアカウントチームまでお問い合わせください。
これは受信側の制御です。つまり、Firecrawlへのリクエストの送信元を制限するものです。送信側の制御 (Firecrawlからお使いのシステムへの通信で使われる固定送信元IP。これによりFirecrawlを許可リストに追加できます) をお探しの場合は、Enterprise featuresを参照してください。
追加できるエントリは次のとおりです。
- 単一の IPv4 アドレス — 例:
203.0.113.7 - 単一の IPv6 アドレス — 例:
2001:db8::1 - CIDR 範囲 (IPv4 または IPv6) — 例:
10.0.0.0/8、2001:db8::/32
IPv4-mapped IPv6 (::ffff:203.0.113.7) 経由で接続するクライアントは、照合前に IPv4 形式に正規化されるため、IPv4 のエントリで一致します。
許可リストは、空でない場合にのみ適用されます。空の許可リストは制限なしを意味するため、IP をまだ 1 つも設定していない段階でチーム自身がアクセスできなくなることはありません。
チーム管理者は、ダッシュボードのEnterprise Controls → IP Restrictionから許可リストを管理します。項目を追加または削除して保存すると、変更は約1分で反映されます。
このチェックは認証時に実行されるため、認証が必要なすべての対象に一律で適用されます。これには、すべての API バージョン、job のステータス確認およびキャンセル用エンドポイント、ならびに websocket のステータス接続が含まれます。リクエスト単位でこれを回避することはできません。
許可リストに含まれていない IP からのリクエストは、403 で拒否されます。
{
"success": false,
"error": "Request blocked: IP address 198.51.100.24 is not on this team's allowed IP list. Team admins can manage allowed IPs at https://www.firecrawl.dev/app/enterprise-controls?tab=ip-restriction"
}| ステータス | 発生条件 |
|---|---|
403 | リクエスト元の IP アドレスがチームの許可リストに含まれていません。 |
500 | 許可リストを検証できませんでした。リクエストは制限を回避せず、フェイルクローズ (拒否) されます。しばらくしてから再試行してください。 |
- IP Restrictions でクレジットが消費されることはありません。
- IP Restrictions は Key Restrictions とは独立しており、チームでは両方を併用できます。また、1 つのキーに対して format、endpoint、origin network による制限を同時に適用できます。