Claude API(Anthropicが提供するAIモデルのAPI)をAWS Lambdaから呼び出しているインフラ担当者、特にサーバーレス構成でAPIキーの漏えい対策を進めているSRE向けの話です。2024年11月5日からAnthropicが提供を始めたIPアロウリスト(許可されたIPアドレスだけを通す機能)を、設定手順を誤ったまま有効化すると、本番のLambda関数が丸ごと403エラーで止まる事態が起きます。導入を検討している、あるいはすでに検討中という方の判断材料になればと思います。
まず何が起きるかを整理します。
何が起きるか: サイレントに詰まるLambda
Claude IPアロウリストは、Claude Console(Anthropicの管理画面)の組織設定で有効にできる機能です。登録したIPアドレス以外からのリクエストは、HTTPステータス403・エラータイプpermission_errorで拒否されます。
厄介なのは、拒否がすぐには気づかれないケースがある点です。
毎日動くバッチなら即座に気づけますが、週1回や月1回しか実行されないLambda関数だと、有効化してから数日後に初めて403を踏みます。その頃には「何を変更したせいか」の記憶が薄れていて、原因調査に時間を取られます。
影響範囲は、Claude APIを直接APIキーで叩いている構成全般です。Messages・Message Batches・Token Counting・Models・Files・Skillsといったエンドポイント、加えてManaged Agents・Admin API・Compliance APIも対象に含まれます。
一方で、Amazon Bedrock経由でClaudeを利用している場合はこの機能の対象外です。Bedrock側はIAMロールやポリシー条件(aws:SourceVpceやaws:SourceIpなど)でアクセス制御する仕組みがすでにあるため、今回のアロウリストとは別レイヤーの話になります。
なぜ起きるか: LambdaはIPを持たない
原因を段階的に見ていきます。
1段階目: VPC未設定のLambdaは共有アドレスプールを使う
VPC(Virtual Private Cloud、AWSアカウント専用の仮想ネットワーク)の設定をしていないLambda関数は、AWSが管理する共有ネットワークの中で動きます。送信元IPは大きな共有プールから動的に割り当てられ、どのIPになるかは予測も固定もできません。
2段階目: 共有プールをアロウリストに入れても意味がない
この共有IPレンジをそのままアロウリストに登録しても、セキュリティ上の効果はほぼありません。同じレンジは他のAWS利用者も使っているため、APIキーが漏えいした攻撃者が同じリージョンで自分のLambda関数を起動すれば、同じIPレンジから簡単にアクセスできてしまいます。IP制限の本来の目的(漏えいしたキーを他人の環境から使わせない)が成立しなくなります。
3段階目: 固定IPにするにはNATゲートウェイが要る
Lambda関数の送信元IPを固定するには、関数を自分のVPC内のプライベートサブネットに配置し、出口の通信をNATゲートウェイ(プライベートアドレスを公開アドレスに変換するマネージドサービス)経由にする必要があります。このNATゲートウェイにElastic IP(アカウントに紐づく固定のパブリックIPv4アドレス)を割り当て、そのIPだけをClaude Consoleに登録します。
つまり「VPC設定なしのLambda」のまま先にアロウリストを有効化すると、固定IPという前提条件が整う前に制限がかかり、すべてのリクエストが弾かれる構造になっています。
自分のプロジェクトが該当するか確認する
該当するかどうかは、以下の観点で確認できます。
- Lambda関数の設定画面(またはTerraform/CDKのコード)で、VPC設定(
vpc_configやサブネットID)が指定されているか - 指定されている場合、そのサブネットがプライベートサブネットで、ルートテーブルの向き先がNATゲートウェイになっているか
- NATゲートウェイにElastic IPが紐づいているか(AWSコンソールのVPCダッシュボード、またはTerraformの
aws_eipリソースで確認) - Claude Consoleの組織設定でIPアロウリストがすでに有効になっていないか(有効化前に必ず確認)
- 対象のLambda関数がClaude APIをどの経路で呼んでいるか(直接api.anthropic.comを叩いているか、Bedrock経由か)
IaC(Infrastructure as Code、インフラをコードで管理する手法)でTerraformやPulumi、AWS CDKを使っている場合は、vpc_configブロックやaws_nat_gatewayリソースの有無をコード検索するのが最速です。手元にコードがなければ、AWSコンソールのLambda関数詳細ページの「設定」タブからVPC欄を見るだけでも判断できます。
対策の手順
1. まずNAT設定なしでアロウリストを有効化しない、という順序を守ります。
2. Lambda関数をプライベートサブネットに配置し、NATゲートウェイ経由でインターネットに出る構成をIaCで定義します。AWS CDKであれば、VPCにNATゲートウェイを作成し、LambdaのサブネットをプライベートタイプにするだけでElastic IPが自動的に割り当てられます。
3. NATゲートウェイのElastic IPを確認し、そのIPv4アドレス(例: 203.0.113.10)をClaude Consoleのアロウリスト設定に登録します。CIDR表記(203.0.113.0/24のような範囲指定)も使えますが、IPv4は/8より広い範囲、IPv6は/32より広い範囲は登録できない制限があります。
4. 登録後、実際にLambda関数からClaude APIを呼び出すテストを実行し、200系のレスポンスが返るか確認します。
5. エラーハンドリングのコードでは、エラーメッセージの文字列ではなくHTTPステータス(403)とエラータイプ(permission_error)で判定するようにします。メッセージ文言は変更される可能性があるため、文字列一致に依存すると将来壊れます。
6. 403の発生を検知するアラームを設定します。CloudWatch LogsのメトリクスフィルタでpermissionErrorやステータス403を検出し、SNS経由で通知する仕組みを組んでおくと、ユーザーからの問い合わせより先に気づけます。
7. 月1回しか動かないバッチなど、実行頻度の低いLambda関数があれば、個別にリストアップして設定漏れがないか確認します。
NATゲートウェイにはコストがかかる点も見ておく必要があります。時間課金に加えてデータ処理量に応じた従量課金が発生するため、常時起動しているLambda関数が多い構成では無視できない金額になります。アロウリスト対応のためだけにNATゲートウェイを新設する場合、既存のVPCに同様の構成がすでにあれば、それを共用できないかも確認する価値があります。
まとめ
Claude IPアロウリストは、APIキー漏えい時の被害範囲を狭める有効な仕組みですが、Lambdaのようにデフォルトで固定IPを持たないサーバーレス環境では、設定順序を間違えると自分自身をロックアウトします。
該当するかどうかは、Lambda関数のVPC設定とNATゲートウェイの有無をコードまたはコンソールで確認すれば判断できます。対応する場合は、NATゲートウェイとElastic IPを先に用意し、アロウリスト有効化は最後に回す順序を徹底してください。
あわせて、403を検知するアラームとステータスコードベースのエラーハンドリングを組んでおくと、実行頻度の低いジョブでの踏み抜きにも早く気づけます。