0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

BYOK型のAIプラグインで、請求の青天井を止める。1日あたりの利用上限をサーバー側で持つ実装

0
Posted at

先に答えを書きます。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まわりのことを書いています。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?