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:承認が実行内容に結びついていない
再現コード
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:確認してから更新すると二重に実行される
再現コード
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:期限を使う文の中で確認していない
再現コード
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:鍵のないトークンは誰でも作れる
再現コード
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:承認が確認できないときに拒否していない
再現コード
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。 - 承認が確認できないときは、拒否を既定にする。
全部まとめて実行する
set -eu
python3 --version
for case in case1.py case2.py case3.py case4.py case5.py; do
echo "=== $case ==="
python3 "$case"
done