rate-limiting

レート制限（Symfony）

使用する場面

• ログイン、パスワードリセット、公開 API など、公開されている書き込みエンドポイントへの呼び出し頻度を制限するとき。
• スライディングウィンドウ、トークンバケット、固定ウィンドウのいずれかを選ぶとき。
• コントローラー属性、サービス、イベントサブスクライバーを通じたグローバル設定のいずれかでリミッターを適用するとき。
• Retry-After を含む正しい 429 を返すとき。
• 拒否するのではなく、トークンが解放されるまでブロックするとき。

デフォルトのワークフロー

1. 何を制限し、何を呼び出し元の識別に使うかを明確にします。
2. トラフィックの形状に合ったアルゴリズムを選び、レートとバーストを明示します。
3. リミッターごとに 1 つのエントリーを framework.rate_limiter の下に宣言します。
4. リクエストを拒否する場所で適用し、Retry-After を含む 429 で応答します。
5. テストで制限を実証します。通過する呼び出し、拒否される呼び出し、リセットを確認します。

ガードレール

• カウント対象は呼び出し元の識別情報によって決まります。プロキシの背後では、信頼されていないクライアントアドレスを使うと、すべての利用者が 1 人としてカウントされます。
• リミッターは認可の仕組みではありません。レートを制限しますが、権限を判断することはありません。
• 必ず 429 と Retry-After で拒否し、黙って破棄したり 500 を返したりしないでください。
• ストレージがプロセスごとのリミッターでは、複数のワーカー全体で制限できません。
• トークンの予約は呼び出し元のプロセスをブロックします。ウェブリクエストでは決して行わないでください。

段階的な情報開示

• 実行時の方針とリスク管理には、このファイルを使用します。
• 実装の詳細が必要な場合は、リファレンスを参照します。

出力要件

• アルゴリズム、レート、バーストを含むリミッターポリシー。
• 各リミッターを適用する場所と、呼び出し元の識別情報。
• ヘッダーを含む 429 レスポンスの形式。
• 呼び出しが受け入れられる場合、拒否される場合、リセットされる場合をカバーするテスト。

リファレンス

• reference.md