1
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?

「承認してから動く」処理の承認トークンで踏む5つの落とし穴|内容の束縛・二重実行・期限・署名・拒否の既定

1
Posted at

TL;DR

  • 承認は「誰が何を許したか」ではなく、「この内容を1回だけ、この期限までに」許したものとして持ちます。
  • 承認は、注文IDではなく実行内容のハッシュに結びつけます。承認後に金額などが変わると、承認が外れます。
  • 「未使用か確認してから使用済みにする」と、2つの処理が同時に動いたときに二重に実行されます。未使用の行だけを1文で更新し、更新できた行数で判定します。
  • 期限は、承認を出すときではなく、使う文の中で確認します。
  • トークンは鍵付きの HMAC で署名し、hmac.compare_digest で比較します。
  • 承認が True だと確認できたとき以外は、すべて拒否します。

この記事は承認フローの完成形ではなく、承認トークンまわりでつまずきやすい点の最小例です。

背景

xAI の Grok Bot の Bot Marketplace(2026-11-12 確認)には、承認なしでは動かないことを説明文にうたう Bot が並んでいます。たとえば送信については「nothing sends without your yes」、作成や変更については「never creates or changes anything without your exact yes」と書かれたものがあります。それらの内部実装は公開されていないため、この記事は Grok Bot の実装を説明するものではありません。同じ「承認してから動く」処理を自作するときに、承認をどう持つかを扱います。

実行環境

  • Python 3.14.4 / Linux / 標準ライブラリのみ(hashlib・hmac・json・sqlite3)
  • 各コードは単独で python3 case1.py のように実行できます。末尾の run_all.sh で5本をまとめて実行できます。
  • 承認の保存先は sqlite3 のメモリ上のデータベースです。外部への送信や実際の支払いはしません。

全体像

落とし穴1:承認が実行内容に結びついていない

再現コード

case1.py
import hashlib
import json


def digest(action):
    body = json.dumps(action, sort_keys=True, separators=(",", ":"), ensure_ascii=False)
    return hashlib.sha256(body.encode("utf-8")).hexdigest()


# 悪い例: 承認を「注文ID」だけに結びつける
approved_ids = {"A-100"}
request = {"op": "refund", "order": "A-100", "amount": 1000}
print("承認時の内容:", request)
request["amount"] = 100000  # 承認後に内容が書き換わる
print("ID照合で実行できる:", request["order"] in approved_ids)

# 良い例: 承認を「内容のハッシュ」に結びつける
original = {"op": "refund", "order": "A-100", "amount": 1000}
approved = {digest(original)}
print("同じ内容で実行できる:", digest(original) in approved)
print("金額を変えると実行できる:", digest(request) in approved)

# キーの並びが違っても同じ内容は同じハッシュになる
reordered = {"amount": 1000, "order": "A-100", "op": "refund"}
print("キー順だけ違う場合:", digest(reordered) == digest(original))
print("sort_keys なしの文字列は同じか:", json.dumps(original) == json.dumps(reordered))

出力

承認時の内容: {'op': 'refund', 'order': 'A-100', 'amount': 1000}
ID照合で実行できる: True
同じ内容で実行できる: True
金額を変えると実行できる: False
キー順だけ違う場合: True
sort_keys なしの文字列は同じか: False

承認を注文IDに結びつけると、承認後に金額が変わっても通ります。実行内容を json.dumps(..., sort_keys=True, separators=(",", ":")) で正規化してハッシュ化し、そのハッシュに承認を結びつけます。json モジュールのエンコーダは入力の順序を保つため、sort_keys なしでは同じ内容でもキー順が違うと別の文字列になります(出力の最終行)。

落とし穴2:確認してから更新すると二重に実行される

再現コード

case2.py
import sqlite3

db = sqlite3.connect(":memory:")
db.execute("CREATE TABLE approvals (id TEXT PRIMARY KEY, used INTEGER NOT NULL DEFAULT 0)")
db.execute("INSERT INTO approvals (id) VALUES ('ap-1')")
executed = []


def run(label):
    executed.append(label)


# 悪い例: 「未使用か」を確認してから、あとで「使用済み」にする
def check(approval_id):
    row = db.execute("SELECT used FROM approvals WHERE id = ?", (approval_id,)).fetchone()
    return row is not None and row[0] == 0


def mark_used(approval_id):
    db.execute("UPDATE approvals SET used = 1 WHERE id = ?", (approval_id,))


ok_a = check("ap-1")  # 処理Aが確認
ok_b = check("ap-1")  # 処理Bも、Aが印を付ける前に確認
if ok_a:
    mark_used("ap-1")
    run("A")
if ok_b:
    mark_used("ap-1")
    run("B")
print("確認してから更新:", executed)

# 良い例: 未使用の行だけを1文で更新し、更新できた行数で判定する
db.execute("UPDATE approvals SET used = 0")
executed.clear()


def consume(approval_id):
    cur = db.execute("UPDATE approvals SET used = 1 WHERE id = ? AND used = 0", (approval_id,))
    return cur.rowcount == 1


for label in ("A", "B"):
    if consume("ap-1"):
        run(label)
print("1文で消費:", executed)

出力

確認してから更新: ['A', 'B']
1文で消費: ['A']

悪い例は、同時に動く2つの処理が、どちらも「使用済み」の印を付ける前に確認した場合を、1つのスレッドで順番に再現しています。実際の競合ではなく、確認と更新が別の文であることによる隙間の再現です。良い例は、used = 0 の行だけを更新する1文にして、cursor.rowcount が 1 のときだけ実行します。Python の公式ドキュメントでは、rowcount は UPDATE などで変更された行数を表します。

落とし穴3:期限を使う文の中で確認していない

再現コード

case3.py
import sqlite3

db = sqlite3.connect(":memory:")
db.execute("CREATE TABLE approvals (id TEXT PRIMARY KEY, used INTEGER NOT NULL DEFAULT 0, expires_at INTEGER NOT NULL)")
TTL = 60
issued_at = 1000
db.execute("INSERT INTO approvals (id, expires_at) VALUES ('ap-1', ?)", (issued_at + TTL,))


# 悪い例: 期限は承認を発行するときにしか見ていない
def consume_no_expiry(approval_id):
    cur = db.execute("UPDATE approvals SET used = 1 WHERE id = ? AND used = 0", (approval_id,))
    return cur.rowcount == 1


print("1時間後に実行(期限を見ない):", consume_no_expiry("ap-1"))

# 良い例: 消費する文の中で期限も確認する。時刻は引数で渡す
db.execute("UPDATE approvals SET used = 0")


def consume(approval_id, now):
    cur = db.execute(
        "UPDATE approvals SET used = 1 WHERE id = ? AND used = 0 AND expires_at > ?",
        (approval_id, now),
    )
    return cur.rowcount == 1


print("1時間後に実行(期限を見る):", consume("ap-1", issued_at + 3600))
print("期限ちょうど:", consume("ap-1", issued_at + TTL))
print("期限の1秒前:", consume("ap-1", issued_at + TTL - 1))

出力

1時間後に実行(期限を見ない): True
1時間後に実行(期限を見る): False
期限ちょうど: False
期限の1秒前: True

発行時に期限を持たせても、使うときに見なければ1時間後でも通ります。消費する文の WHERE に expires_at > ? を入れ、時刻は引数で渡します。時刻を渡す形にすると、上のように期限ちょうどや1秒前も決まった結果で確かめられます。実運用では time.time() などの値を渡します。

落とし穴4:鍵のないトークンは誰でも作れる

再現コード

case4.py
import hashlib
import hmac

SECRET = b"example-only-secret"  # 例。実際の鍵はコードに書かず、環境から読む
action_digest = hashlib.sha256(b'{"amount":1000,"op":"refund","order":"A-100"}').hexdigest()


# 悪い例: 誰でも計算できる値を「承認トークン」にしている
def weak_token(digest):
    return hashlib.sha256(digest.encode()).hexdigest()


def weak_verify(digest, token):
    return token == weak_token(digest)


print("鍵なしの偽造が通る:", weak_verify(action_digest, weak_token(action_digest)))


# 良い例: 鍵付きのHMACで署名し、compare_digest で比較する
def sign(digest):
    return hmac.new(SECRET, digest.encode(), hashlib.sha256).hexdigest()


def verify(digest, token):
    return hmac.compare_digest(sign(digest), token)


token = sign(action_digest)
print("正しいトークン:", verify(action_digest, token))
print("鍵なしで計算した偽造:", verify(action_digest, weak_token(action_digest)))
other = hashlib.sha256(b"another action").hexdigest()
print("別の内容のトークンを流用:", verify(action_digest, sign(other)))

出力

鍵なしの偽造が通る: True
正しいトークン: True
鍵なしで計算した偽造: False
別の内容のトークンを流用: False

悪い例のトークンは、ハッシュから誰でも計算できます。鍵付きの HMAC で署名し、比較には hmac.compare_digest を使います。Python の公式ドキュメントは、外部から渡されたダイジェストの比較に == ではなく compare_digest を使うよう勧めています(タイミング攻撃の対策)。コード中の SECRET は説明用の例で、実際の鍵はコードに書かず、実行環境から読み込みます。

落とし穴5:承認が確認できないときに拒否していない

再現コード

case5.py
import sqlite3


# 悪い例: 値が「真っぽい」かどうかで判定し、例外は握りつぶして進む
def gate_loose(decision, db):
    try:
        db.execute("SELECT 1 FROM approvals LIMIT 1")
    except Exception:
        pass
    return bool(decision.get("approved"))


# 良い例: 承認が True と確認できたときだけ許可し、それ以外はすべて拒否する
def gate_strict(decision, db):
    try:
        db.execute("SELECT 1 FROM approvals LIMIT 1")
    except sqlite3.Error as e:
        print("  拒否理由:", type(e).__name__)
        return False
    return decision.get("approved") is True


db = sqlite3.connect(":memory:")
db.execute("CREATE TABLE approvals (id TEXT)")
broken = sqlite3.connect(":memory:")  # approvals テーブルがない状態

cases = [
    ("approved が true", {"approved": True}, db),
    ("approved が文字列 'false'", {"approved": "false"}, db),
    ("approved がない", {}, db),
    ("保存先に問い合わせられない", {"approved": True}, broken),
]
for name, decision, conn in cases:
    print(name)
    print("  loose :", gate_loose(decision, conn))
    print("  strict:", gate_strict(decision, conn))

出力

approved が true
  loose : True
  strict: True
approved が文字列 'false'
  loose : True
  strict: False
approved がない
  loose : False
  strict: False
保存先に問い合わせられない
  loose : True
  拒否理由: OperationalError
  strict: False

bool(decision.get("approved")) は、文字列 "false" を真として扱います。また、保存先への問い合わせで出た例外を握りつぶして先へ進むと、承認が確認できないまま実行されます。承認が True と確認できたときだけ許可し、値の形が想定外でも、保存先に問い合わせられなくても、拒否に倒します。

まとめ

  • 承認は実行内容のハッシュに結びつける。
  • 未使用の行だけを1文で更新し、更新できた行数で判定する。
  • 期限は消費する文の中で確認する。
  • 署名は鍵付きHMAC、比較は hmac.compare_digest。
  • 承認が確認できないときは、拒否を既定にする。

全部まとめて実行する

run_all.sh
set -eu
python3 --version
for case in case1.py case2.py case3.py case4.py case5.py; do
  echo "=== $case ==="
  python3 "$case"
done

参考

1
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
1
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?