> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/zen-firewall/zen-features/setting-up-rate-limiting-for-routes.md).
# ルートのレート制限を設定する
### はじめに
Aikido の Zen Firewall では、 **ルートにレート制限を設定できます** アプリケーションを悪用から守るために、過度なパスワードリセット要求の防止などができます。レート制限は、Webページ、REST API ルート、および GraphQL API に設定できます。
{% hint style="warning" %}
レート制限は、lambda またはサーバーレス環境では利用できません
{% endhint %}
### 対応機能
* 特定のルートにレート制限を設定する
* ワイルドカード\*ルートを追加して、複数のルートにレート制限を設定する
* IP アドレスまたは [ユーザー ID](https://help.aikido.dev/doc/block-users-with-zen/docbO6Nm6Zb1#how-to-identify-and-block-users)、または [カスタムグループ ID](#how-it-works) （例: B2B SaaS の会社 ID）
* アプリ全体ではなく、特定のルートの保護を無効にできます。
* [ローカルホスト](http://localhost) または 127.0.0.1 は、レート制限の対象になりません
> レート制限は、個々の IP アドレスまたは [ユーザー識別](https://help.aikido.dev/doc/block-users-with-zen/docbO6Nm6Zb1#how-to-identify-and-block-users)に基づいています。\
> たとえば、制限が 1 分あたり 10 リクエストの場合:
>
> * ❌ **ブロック**: 1 つの IP から 11 件のリクエストが送信されると
> * ✅ **許可:** 11 個の異なる IP がそれぞれ 1 件ずつリクエストする
>
> これにより、複数のユーザーからの通常のトラフィックを許可しつつ、悪用を防ぐことができます。
### レート制限の設定方法
手順 1: 特定のアプリに移動し、Routes タブを開きます
手順 2: レート制限を適用したい特定のルートのアクションメニューを開きます。［レート制限を設定］をクリックするとモーダルが開きます。
**ステップ 3**: **レート制限を有効にする** をオンにし、時間枠あたりに許可するリクエスト数を指定します。ルートを更新して保存します。
> 設定の変更が反映されるまで最大 1 分かかります。
### 複数のルートに一度にレート制限を設定する
ワイルドカードルートを追加することで、複数のルートに一度にレート制限を設定できます。
**手順 1.** Routes ページで、 **ルートを追加。**
**手順 2.** ワイルドカードルートを追加するには、\* を追加します `*` ルート内に
**手順 3.** ワイルドカードが一覧に表示されます。上記と同じ方法でレート制限の設定を続けてください。
## 仕組み
### **処理順序**
Aikido Zen は、次の優先順位でレート制限を適用します:
1. グループレベル
2. ユーザーレベル
3. IP レベル
リクエストがより高いレベル（例: グループ）でレート制限されると、下位レベル（ユーザーまたは IP）は評価されません。
### **スライディングウィンドウ**
動的に前へスライドし続ける移動時間枠を使用してイベントを追跡します。特定の時刻にリセットされる固定ウィンドウとは異なり、スライディングウィンドウは最新期間（例: 直近 60 秒）のローリングカウントを維持します。これにより、短時間のトラフィックスパイクがウィンドウ境界で制限を回避してしまうような境界ケースを防げます。
### **ルート選択（ワイルドカード）**
Zen はまず、レート制限を適用する完全一致のルート（ワイルドカードなし）を選択します。完全一致のルートが見つからない場合は、最も低い制限に基づいてワイルドカード一致が適用されます。同時に適用される制限は 1 つだけで、1 件のリクエストが複数の制限に引っかかることはありません。
### **グループベースのレート制限**
ユーザーグループのリクエスト数を制限するには、 `setRateLimitGroup` 関数を使用できます。チームや会社ごとにリクエスト数を制限したい場合に便利です。レート制限グループが設定されている場合、設定されたレート制限はそのグループにのみ適用され、個々のユーザーや IP アドレスには適用されませんのでご注意ください。
対象:
* [Node.js](https://github.com/AikidoSec/firewall-node/blob/main/docs/user.md#rate-limiting-groups)
* [Python](https://github.com/AikidoSec/firewall-python/blob/main/docs/user.md#rate-limiting-groups)
* [Java](https://github.com/AikidoSec/firewall-java/blob/main/docs/user.md#rate-limiting-groups)
* 他のエージェントも近日対応予定です
## 例外
* [特定のユーザーのレート制限を削除するには、レート制限を無効にできます。](/docs/docs-ja/zen-firewall/zen-features/blocking-users-with-zen-firewall.md#remove-rate-limiting) これにより、そのユーザーに対してすべてのレート制限がバイパスされます。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.aikido.dev/docs/docs-ja/zen-firewall/zen-features/setting-up-rate-limiting-for-routes.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.