先に答えを書きます。BYOK型(利用者が自分のAPIキーを入れて動かす形)のAIプラグインを作るなら、レート制限だけでは足りません。短時間の連打は弾けても、ゆっくり淡々と一日中投げられたら、請求は伸び続けます。必要なのは、1日あたりの総量の上限を、サーバー側で持つことです。
自分はAIチャットボットのプラグインを作っていて、この「利用制御」を入れました。実装と、途中で踏んだ罠を書きます。
レート制限では防げない形がある
よくあるのは、1分間に何回まで、という制限です。連打は止まります。
でも、たとえば30秒に1回、まる一日投げ続けられたら、どうでしょう。レート制限には引っかかりません。行儀よく、制限の内側で、延々と呼び続けられる。そして請求はサイト運営者に来ます。悪意のある人が自動化して一晩回すには、十分すぎる隙です。
守りたいのは「連打されないこと」ではなくて、「請求が想定を超えないこと」でした。だとすると、見るべきは頻度ではなく、総量です。
テーブルを1つ持つ
利用者ごと・日付ごとのカウンタを持ちます。
function myplugin_create_usage_table() {
global $wpdb;
$table = $wpdb->prefix . 'myplugin_usage';
$charset = $wpdb->get_charset_collate();
$sql = "CREATE TABLE {$table} (
id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
identifier VARCHAR(64) NOT NULL,
usage_date DATE NOT NULL,
count INT UNSIGNED NOT NULL DEFAULT 0,
PRIMARY KEY (id),
UNIQUE KEY uniq_id_date (identifier, usage_date)
) {$charset};";
require_once ABSPATH . 'wp-admin/includes/upgrade.php';
dbDelta($sql);
}
register_activation_hook(__FILE__, 'myplugin_create_usage_table');
identifier と usage_date に UNIQUE を張っておくのが肝です。次のアトミック加算が、これで書けるようになります。
カウントは、読んで足して書き戻さない
自分がいちばん踏みたくなかった罠が、ここです。
// ❌ NG:読む→足す→書き戻す(同時アクセスで更新が消える)
$count = (int) $wpdb->get_var(...);
$wpdb->update($table, ['count' => $count + 1], [...]);
読んでから書き戻すまでの間に、別のリクエストが同じ値を読むと、片方の +1 が消えます(lost update)。攻撃されている時ほどリクエストは重なるので、いちばん数えてほしい場面で、いちばん数え落とす。実際、自分は消費量のカウントでこれをやって、あとからアトミックな加算に直しました。
DB側で足させます。
/**
* 1回ぶん加算して、加算後の値を返す。
* INSERT ... ON DUPLICATE KEY UPDATE で、行の有無を気にせず1文で済ませる。
*/
function myplugin_increment_usage(string $identifier): int {
global $wpdb;
$table = $wpdb->prefix . 'myplugin_usage';
$today = current_time('Y-m-d'); // サイトのタイムゾーンで日付を切る
$wpdb->query($wpdb->prepare(
"INSERT INTO {$table} (identifier, usage_date, count)
VALUES (%s, %s, 1)
ON DUPLICATE KEY UPDATE count = count + 1",
$identifier, $today
));
return (int) $wpdb->get_var($wpdb->prepare(
"SELECT count FROM {$table} WHERE identifier = %s AND usage_date = %s",
$identifier, $today
));
}
count = count + 1 はDB側で処理されるので、同時に来ても取りこぼしません。行が無ければ作り、あれば足す、を1文でやれるのも楽です。
誰を数えるか(生のIPは保存しない)
ログイン中ならユーザーIDで数えられます。問題は、匿名の訪問者です。
IPで数えるのが現実的ですが、生のIPをそのまま保存するのは避けたい。個人情報になりますし、テーブルに残す理由もありません。ハッシュにして保存します。
function myplugin_get_identifier(): string {
if (is_user_logged_in()) {
return 'u_' . get_current_user_id();
}
$ip = isset($_SERVER['REMOTE_ADDR'])
? sanitize_text_field(wp_unslash($_SERVER['REMOTE_ADDR']))
: '';
// サイト固有の salt を混ぜてハッシュ化(生IPは保存しない)
return 'a_' . hash_hmac('sha256', $ip, wp_salt('secure_auth'));
}
ハッシュにしておけば、テーブルを見ても誰のIPかは分かりません。数えるのに必要なのは「同じ人か違う人か」だけで、IPそのものではないからです。
呼ぶ前に、確かめる
いちばん大事なのは、上限に達していたらAIを呼ばずに返すことです。呼んでから弾いても、お金はもう出ています。
function myplugin_handle_chat(string $message) {
$id = myplugin_get_identifier();
$limit = (int) get_option('myplugin_daily_limit', 20);
$used = myplugin_increment_usage($id); // 先に加算して、超えていたら返す
if ($used > $limit) {
return [
'ok' => false,
'message' => '本日の利用上限に達しました。また明日お試しください。',
];
}
return myplugin_call_ai($message); // ここで初めてAPIを叩く
}
先に加算してから判定すると、同時に大量に来ても、超えたぶんは全部弾けます。判定してから加算する順にすると、ぎりぎりの瞬間にすり抜ける隙ができます。
そして、この判定はサーバー側にあることが肝心です。JSでボタンを無効化しても、エンドポイントは直接叩けます。ブラウザ側の制御は、UIの親切であって、上限ではありません。
古い行を掃除する
放っておくとテーブルが太るので、定期的に消します。
add_action('myplugin_cleanup_usage', function () {
global $wpdb;
$table = $wpdb->prefix . 'myplugin_usage';
$wpdb->query($wpdb->prepare(
"DELETE FROM {$table} WHERE usage_date < %s",
date('Y-m-d', strtotime('-30 days'))
));
});
if (!wp_next_scheduled('myplugin_cleanup_usage')) {
wp_schedule_event(time(), 'daily', 'myplugin_cleanup_usage');
}
なお、WP-Cronはアクセスがあって初めて動く疑似cronなので、人の来ないサイトでは遅れます。掃除くらいなら遅れても困りませんが、そこは知っておくといいです。
正直なところ、これは万能ではありません
限界も書いておきます。
IPベースの識別は、完璧ではありません。同じ職場から複数人が来れば、まとめて1人として数えます。逆に、IPを変えられれば、上限は回避されます。つまりこれは「個人を正確に識別する仕組み」ではない。
それでも入れる価値があるのは、目的が識別ではなく、最悪の請求額に天井をつけることだからです。上限に達したらAIを呼ばない。この一点さえ守れていれば、どれだけ攻撃されても、請求は自分が決めた線で止まります。金額の心配が「最悪いくら」で見積もれるようになると、AIチャットボットは、ずいぶん置きやすくなりました。
早見でまとめ
- レート制限だけでは、ゆっくり一日中投げられる形を防げない。見るのは頻度より総量
- 利用者ごと・日付ごとのカウンタを持ち、(identifier, date) に UNIQUE を張る
- 加算は
INSERT ... ON DUPLICATE KEY UPDATE count = count + 1でアトミックに。read-modify-write は同時アクセスで数え落とす - 匿名の識別は、生IPを保存せず
hash_hmac+ salt で - 先に加算 → 超えていたらAIを呼ばずに返す。判定はサーバー側に置く
- IP識別は完璧ではない。目的は識別ではなく、請求に天井をつけること
役に立ったらストックして、AIまわりの実装で財布を守るとき見返してください。
ふだんはraplsworks.comで、WordPressプラグイン開発やClaude Codeまわりのことを書いています。
https://raplsworks.com/
先に答えを書きます。BYOK型(利用者が自分のAPIキーを入れて動かす形)のAIプラグインを作るなら、レート制限だけでは足りません。短時間の連打は弾けても、ゆっくり淡々と一日中投げられたら、請求は伸び続けます。必要なのは、1日あたりの総量の上限を、サーバー側で持つことです。
自分はAIチャットボットのプラグインを作っていて、この「利用制御」を入れました。実装と、途中で踏んだ罠を書きます。
レート制限では防げない形がある
よくあるのは、1分間に何回まで、という制限です。連打は止まります。
でも、たとえば30秒に1回、まる一日投げ続けられたら、どうでしょう。レート制限には引っかかりません。行儀よく、制限の内側で、延々と呼び続けられる。そして請求はサイト運営者に来ます。悪意のある人が自動化して一晩回すには、十分すぎる隙です。
守りたいのは「連打されないこと」ではなくて、「請求が想定を超えないこと」でした。だとすると、見るべきは頻度ではなく、総量です。
テーブルを1つ持つ
利用者ごと・日付ごとのカウンタを持ちます。
function myplugin_create_usage_table() {
global $wpdb;
$table = $wpdb->prefix . 'myplugin_usage';
$charset = $wpdb->get_charset_collate();
$sql = "CREATE TABLE {$table} (
id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
identifier VARCHAR(64) NOT NULL,
usage_date DATE NOT NULL,
count INT UNSIGNED NOT NULL DEFAULT 0,
PRIMARY KEY (id),
UNIQUE KEY uniq_id_date (identifier, usage_date)
) {$charset};";
require_once ABSPATH . 'wp-admin/includes/upgrade.php';
dbDelta($sql);
}
register_activation_hook(__FILE__, 'myplugin_create_usage_table');
identifier と usage_date に UNIQUE を張っておくのが肝です。次のアトミック加算が、これで書けるようになります。
カウントは、読んで足して書き戻さない
自分がいちばん踏みたくなかった罠が、ここです。
// ❌ NG:読む→足す→書き戻す(同時アクセスで更新が消える)
$count = (int) $wpdb->get_var(...);
$wpdb->update($table, ['count' => $count + 1], [...]);
読んでから書き戻すまでの間に、別のリクエストが同じ値を読むと、片方の +1 が消えます(lost update)。攻撃されている時ほどリクエストは重なるので、いちばん数えてほしい場面で、いちばん数え落とす。実際、自分は消費量のカウントでこれをやって、あとからアトミックな加算に直しました。
DB側で足させます。
/**
* 1回ぶん加算して、加算後の値を返す。
* INSERT ... ON DUPLICATE KEY UPDATE で、行の有無を気にせず1文で済ませる。
*/
function myplugin_increment_usage(string $identifier): int {
global $wpdb;
$table = $wpdb->prefix . 'myplugin_usage';
$today = current_time('Y-m-d'); // サイトのタイムゾーンで日付を切る
$wpdb->query($wpdb->prepare(
"INSERT INTO {$table} (identifier, usage_date, count)
VALUES (%s, %s, 1)
ON DUPLICATE KEY UPDATE count = count + 1",
$identifier, $today
));
return (int) $wpdb->get_var($wpdb->prepare(
"SELECT count FROM {$table} WHERE identifier = %s AND usage_date = %s",
$identifier, $today
));
}
count = count + 1 はDB側で処理されるので、同時に来ても取りこぼしません。行が無ければ作り、あれば足す、を1文でやれるのも楽です。
誰を数えるか(生のIPは保存しない)
ログイン中ならユーザーIDで数えられます。問題は、匿名の訪問者です。
IPで数えるのが現実的ですが、生のIPをそのまま保存するのは避けたい。個人情報になりますし、テーブルに残す理由もありません。ハッシュにして保存します。
function myplugin_get_identifier(): string {
if (is_user_logged_in()) {
return 'u_' . get_current_user_id();
}
$ip = isset($_SERVER['REMOTE_ADDR'])
? sanitize_text_field(wp_unslash($_SERVER['REMOTE_ADDR']))
: '';
// サイト固有の salt を混ぜてハッシュ化(生IPは保存しない)
return 'a_' . hash_hmac('sha256', $ip, wp_salt('secure_auth'));
}
ハッシュにしておけば、テーブルを見ても誰のIPかは分かりません。数えるのに必要なのは「同じ人か違う人か」だけで、IPそのものではないからです。
呼ぶ前に、確かめる
いちばん大事なのは、上限に達していたらAIを呼ばずに返すことです。呼んでから弾いても、お金はもう出ています。
function myplugin_handle_chat(string $message) {
$id = myplugin_get_identifier();
$limit = (int) get_option('myplugin_daily_limit', 20);
$used = myplugin_increment_usage($id); // 先に加算して、超えていたら返す
if ($used > $limit) {
return [
'ok' => false,
'message' => '本日の利用上限に達しました。また明日お試しください。',
];
}
return myplugin_call_ai($message); // ここで初めてAPIを叩く
}
先に加算してから判定すると、同時に大量に来ても、超えたぶんは全部弾けます。判定してから加算する順にすると、ぎりぎりの瞬間にすり抜ける隙ができます。
そして、この判定はサーバー側にあることが肝心です。JSでボタンを無効化しても、エンドポイントは直接叩けます。ブラウザ側の制御は、UIの親切であって、上限ではありません。
古い行を掃除する
放っておくとテーブルが太るので、定期的に消します。
add_action('myplugin_cleanup_usage', function () {
global $wpdb;
$table = $wpdb->prefix . 'myplugin_usage';
$wpdb->query($wpdb->prepare(
"DELETE FROM {$table} WHERE usage_date < %s",
date('Y-m-d', strtotime('-30 days'))
));
});
if (!wp_next_scheduled('myplugin_cleanup_usage')) {
wp_schedule_event(time(), 'daily', 'myplugin_cleanup_usage');
}
なお、WP-Cronはアクセスがあって初めて動く疑似cronなので、人の来ないサイトでは遅れます。掃除くらいなら遅れても困りませんが、そこは知っておくといいです。
正直なところ、これは万能ではありません
限界も書いておきます。
IPベースの識別は、完璧ではありません。同じ職場から複数人が来れば、まとめて1人として数えます。逆に、IPを変えられれば、上限は回避されます。つまりこれは「個人を正確に識別する仕組み」ではない。
それでも入れる価値があるのは、目的が識別ではなく、最悪の請求額に天井をつけることだからです。上限に達したらAIを呼ばない。この一点さえ守れていれば、どれだけ攻撃されても、請求は自分が決めた線で止まります。金額の心配が「最悪いくら」で見積もれるようになると、AIチャットボットは、ずいぶん置きやすくなりました。
早見でまとめ
- レート制限だけでは、ゆっくり一日中投げられる形を防げない。見るのは頻度より総量
- 利用者ごと・日付ごとのカウンタを持ち、(identifier, date) に UNIQUE を張る
- 加算は
INSERT ... ON DUPLICATE KEY UPDATE count = count + 1でアトミックに。read-modify-write は同時アクセスで数え落とす - 匿名の識別は、生IPを保存せず
hash_hmac+ salt で - 先に加算 → 超えていたらAIを呼ばずに返す。判定はサーバー側に置く
- IP識別は完璧ではない。目的は識別ではなく、請求に天井をつけること
役に立ったらストックして、AIまわりの実装で財布を守るとき見返してください。
ふだんはraplsworks.comで、WordPressプラグイン開発やClaude Codeまわりのことを書いています。