レート制限：検証と対応
レート制限のテスト手法、証拠、監視、アラート、修復、およびインシデント対応手順を提供します。このリファレンスは、採用境界、障害時の動作、および観測可能な証拠を固定しつつ、環境固有の制限は設定可能なままにします。
パッケージの状態: リファレンスコンテキストは人間によるレビュー準備完了。契約およびテストシナリオは完成していますが、採用実装がこれらを通過したという主張はしていません。
決定
レート制限については、保護された境界での脅威モデルとサーバー強制の制御を採用します。ブロックは代表的な正常系、境界値、拒否、障害、回復ケースから構成されるリリースおよび回帰契約として扱います。このテストブロックは検証と対応に特化しています。このパッケージはリファレンス契約であり、採用チームは自環境の証拠に基づいて数値制限、プロバイダー、管轄、運用責任者を選択する必要があります。
範囲
- レート制限のアクター、入力、出力、状態、ポリシーまたはスキーマバージョン、およびこのテストブロックの検証と対応に必要な外部に見える結果。
- 主要および代替インターフェース、バックグラウンド作業、キャッシュ、統合、サポートパス、および同じ境界を検証可能な証拠。
- リファレンスを安全に適用するために必要な採用固有の設定、展開、回復、および検証責任。
このブロックの対象外
- すべての採用者に対して普遍的なベンダー、フレームワーク、管轄、数値閾値、保持期間、またはサービスレベル目標を選択すること。
- パッケージ化されたシナリオが下流の実装で実行されたことや、このリファレンスが法的、セキュリティ、アクセシビリティ認証を付与することの主張。
契約
- 制御を選択する前に、資産、アクター、信頼境界、攻撃者の能力、悪用ケース、前提条件、および残存リスクを明示する。
- 身元、ポリシー、整合性、新鮮さ、またはリソーススコープが確立できない場合は、保護された操作を閉塞（fail closed）する。
- クライアント提供の身元情報のみに依存せず、アクター、資格情報、テナント、リソース、およびインフラ容量ごとに作業と試行を制限する。
- 秘密情報や機密ペイロードをログに含めず、制御バージョン、相関、判断、および安全な理由を証拠として保持する。
- すべての判断を伴う実行について、フィクスチャバージョン、環境、設定、観測結果、および証拠の場所を記録する。
- 製品障害、依存障害、テストインフラ障害、および結論が出ない証拠をレポートで区別する。
- コスト単位、対象階層、ウィンドウまたはトークンモデル、バースト、予約容量、ハードキャップ、ヘッダー、およびリトライ動作を定義する。
- 可能な限り高価値の対象を認証し、グローバルな過負荷保護は回避可能なクライアント識別子から独立させる。
- 検証と対応のバリアントでは、この宣言された境界を強制する：レート制限のテスト手法、証拠、監視、アラート、修復、およびインシデント対応手順を提供する。
実装ガイダンス
- リスククラスを網羅する最小の決定論的フィクスチャセットを構築し、プライバシー安全なレビュー後に本番由来のケースを追加する。
- フレームワークやベンダーの詳細を選択する前に、レート制限の入力、出力、アクター、状態、不変条件、副作用、および証拠をモデル化する。
- 適用されるレート制限契約またはポリシーバージョンをマテリアル状態と共に保存し、マイグレーション、リプレイ、およびサポート判断の帰属を可能にする。
- 制御された展開の背後にあるパスを導入し、期待結果と観測結果を比較し、採用証拠が完了するまでテスト済みの回復ルートを保持する。
障害処理と安全策
- 制御の劣化は保護された境界を維持し、所有するインシデント信号を発し、可用性維持のためだけにアクセスを許可しない。
- 無効または矛盾するレート制限状態は拒否または隔離され、実装は権限を拡大または効果を重複させる値を推測しない。
- リトライは制限され、耐久的な身元を使用する。使い切った後は、作業は検査可能な終端状態に達し、責任者が明確である。
検証と運用
- クリーンな状態からスイートを2回実行し、順序、リトライ、および並列実行が判定を変えないことを確認する。
- レート制限の成功、拒否、検証失敗、依存障害、リトライ使い切り、および回復を契約バージョンごとに監視し、機密ペイロードの次元は含めない。
- ポリシー、スキーマ、依存関係、マイグレーション、または境界の変更後に正負のフィクスチャを再実行し、結果の証拠を保持する。
採用の前提
- 例の名前と値は具体的なフィクスチャであり、普遍的なデフォルトではない。採用者は文書化された証拠と所有権を通じて置き換える。
- 採用システムは認証済みの身元、耐久的な操作または記録バージョン、制限されたテレメトリ、および制御された変更パスを提供できる。
このパッケージの実行可能に見える例はフィクスチャおよび受け入れ契約です。構造とメタデータを検証するためにコレクションバリデータを実行し、ターゲットリポジトリでシナリオを翻訳・実行して実装証拠を記録してください。