レート制限

​

認証試行（認証前）

• カウントされるのは、誤った 認証情報だけです。認証情報がない場合（トークンを 一度も送信していないクライアント）と認証に成功した場合は割り当てを消費しません。 認証に成功すると、その IP のカウンターがリセットされます。
• デフォルト：60秒間に10回失敗すると、その IP は5分間ロックアウトされます。
• デフォルトでは、loopback（127.0.0.1 / ::1）は除外されるため、ローカル CLI セッションが ロックアウトされることはありません。
• カウンターは認証情報クラスごとにスコープ設定されるため、ある対象への大量の試行が 別の対象を圧迫することはありません。スコープには、共有 Gateway トークン/パスワード、デバイストークン、Node ペアリング、ペアリング済み Node の再承認、 デバイスブートストラップトークン、watchOS チャレンジの発行が含まれます。

{
  "code": "INVALID_REQUEST",
  "message": "unauthorized: too many failed authentication attempts (retry later)",
  "retryable": true,
  "retryAfterMs": 297000,
  "details": {
    "code": "AUTH_RATE_LIMITED",
    "authReason": "rate_limited",
    "recommendedNextStep": "wait_then_retry"
  }
}

{
  "gateway": {
    "auth": {
      "rateLimit": {
        "maxAttempts": 10,
        "windowMs": 60000,
        "lockoutMs": 300000,
        "exemptLoopback": true
      }
    }
  }
}

​

ブラウザーオリジン接続

​

Webhook

​

コントロールプレーンの書き込み（認証後の安全策）

{
  "code": "UNAVAILABLE",
  "message": "rate limit exceeded for config.patch; retry after 35s",
  "retryable": true,
  "retryAfterMs": 34539,
  "details": { "method": "config.patch", "limit": "30 per 60s" }
}

​

ACP セッション作成

<method> の ACP セッション作成レート制限を超えました。<n>秒後に再試行してください。

​

再起動のクールダウン

​

運用上の注意

• すべてのリミッターはインメモリかつプロセス単位であり、複数の Gateway 間で 状態を共有しません。Gateway プロセスを置き換えると、Gateway が所有する カウンター（認証ロックアウト、Webhook スロットル、コントロールプレーンのバケット）はクリアされます。 再起動のクールダウンは意図的にプロセス内の再起動サイクルをまたいで維持されます。これが スロットリングの対象であり、プロセスの置き換え時にのみリセットされます。ACP セッション上限は そのトランスレーターインスタンスに属し、Gateway の再起動時ではなく、そのインスタンスが 再作成されたときにリセットされます。
• バケットマップには上限（エントリ数のハード上限と定期的な削除）があるため、 一意なキーを大量に送ってもメモリが無制限に増加することはありません。
• クライアントがリバースプロキシの背後にある場合、実効 IP は解決された クライアント IP です。プロキシヘッダーが実効 IP に影響を与える前にどのように検証されるかについては、 信頼済みプロキシ認証を参照してください。
• 再試行の通知方法は対象によって異なります。Gateway RPC リミッターは retryable: true と retryAfterMs を返し、Webhook 受信は Retry-After ヘッダー付きの HTTP 429 を使用し、ACP は待機時間をエラーメッセージに埋め込みます。 いずれの場合も、すぐに再試行せず、指定された期間だけバックオフしてください。