許可する操作を先に表へ書く
この実験の文書DはAが所有し、Bへ閲覧だけを許しています。Cは認証済みでも共有されていません。未認証の要求には主体を割り当てません。許可表では、AのGETとPUT、BのGETを許し、BのPUTとCのGETを拒否します。最初にこの表を作ることで、実装に合わせて試験の正解を決めてしまうことを避けます。認証されているかどうかだけで操作を許すと、BやCの失敗例を見逃します。また、PUTを拒否した応答が返っても、その前に本文が変更されていれば十分な拒否ではありません。ステータス、返却内容、保存する状態の三つを比較します。ここで検証するのは一つの文書に対する読み取りと更新の境界です。検索や添付ファイルなど、実装していない別経路まで保護されたと一般化しません。
実験用の認証と認可を区別する
コードはローカルの127.0.0.1でHTTPサーバーを起動し、空いているポートを自動で使います。token-Aなどの固定文字列を主体へ対応させる辞書は、試験の入力を切り替えるための模型です。本番用の安全なログイン機能を実装したことにはなりません。主体が決まった後の認可だけを対象として、誰に何を許すかを確かめます。要求にuser_id=Aを加えても、主体は試験用セッション辞書が返すBのままです。この区別が、外部の申告から勝手に所有者へ変われないことの試験になります。実際のサービスでは、セッションの発行、推測しにくさ、期限、失効、通信路の保護なども別に実装する必要があります。ここではそれらを省略した条件を明記し、固定トークンの文字列を認証方式の推奨例として使わないようにします。
許可前に状態を変えない
processは主体を確認し、要求先を確認し、操作の許可を決めた後でだけ本文を更新します。writeが真でも、所有者でなければ更新へ進みません。閲覧許可の分岐にはnot writeという条件があるため、Bの閲覧権限が更新へ流用されない構造です。拒否応答にはerrorだけを入れ、本文の値を含めません。これらは単なる表示の工夫ではなく、情報や状態を外へ出す前に判断するという契約です。実験では更新する本文を固定のupdatedにしているため、入力文書の構文検査やサイズ制限の教材ではありません。認可の条件を一つずつ追えるよう、変更する情報を小さくしています。実際のAPIへ応用する場合は、要求の解析やデータの検証も必要ですが、その成功を認可の代わりにはしません。どの条件を通った後に書込みが起きるかを確認してください。
独立したサーバーと要求で確認する
Python 3.12以降でコード全体をpermission_test.pyへ保存して実行します。標準ライブラリだけを使い、外部のサーバーや本番DBへは接続しません。HTTPを通した要求を送るため、関数へ直接引数を渡すだけの試験とは異なり、ヘッダーと要求方法の取り出しも通ります。ローカルの要求にはプロキシを使わない設定を明示しています。文書はメモリ上にある架空データで、プロセスを終えると消えます。全てのassertが通ると、所有者、閲覧者、別利用者、未認証、主体の偽装入力、共有取り消しの確認が済んだことを表示します。finallyでサーバーを停止し、スレッドが終わったことを待つため、再実行で前の試験のサーバーを使い回しません。ポート番号そのものではなく、各要求への応答と状態が期待どおりかを比較してください。
import json, threading, urllib.request, urllib.error
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
sessions = {'token-A':'A', 'token-B':'B', 'token-C':'C'}
doc = {'id':'D', 'owner':'A', 'readers':{'B'}, 'body':'draft'}
class Handler(BaseHTTPRequestHandler):
def log_message(self, *args): pass
def respond(self, status, payload):
data = json.dumps(payload).encode()
self.send_response(status)
self.send_header('Content-Type', 'application/json')
self.send_header('Content-Length', str(len(data)))
self.end_headers()
self.wfile.write(data)
def process(self, write):
actor = sessions.get(self.headers.get('Authorization','').removeprefix('Bearer '))
if actor is None:
return self.respond(401, {'error':'unauthenticated'})
if self.path.split('?')[0] != '/documents/D':
return self.respond(404, {'error':'not found'})
allowed = actor == doc['owner'] or (not write and actor in doc['readers'])
if not allowed:
return self.respond(403, {'error':'forbidden'})
if write:
doc['body'] = 'updated'
return self.respond(200, {'body':doc['body']})
def do_GET(self): self.process(False)
def do_PUT(self): self.process(True)
server = ThreadingHTTPServer(('127.0.0.1',0), Handler)
thread = threading.Thread(target=server.serve_forever, daemon=True)
thread.start()
opener = urllib.request.build_opener(urllib.request.ProxyHandler({}))
def request(actor, method='GET', suffix=''):
headers = {'Authorization':'Bearer token-'+actor} if actor else {}
req = urllib.request.Request(f'http://127.0.0.1:{server.server_port}/documents/D'+suffix, headers=headers, method=method)
try:
response = opener.open(req, timeout=3)
except urllib.error.HTTPError as error:
response = error
with response:
return response.status, json.loads(response.read())
try:
assert request('A')[0] == 200
assert request('B')[0] == 200
for actor, method, expected in [('B','PUT',403), ('C','GET',403), (None,'GET',401)]:
status, body = request(actor, method)
assert status == expected and 'body' not in body and doc['body'] == 'draft'
assert request('B','PUT','?user_id=A')[0] == 403
assert request('A','PUT') == (200, {'body':'updated'})
doc['readers'].clear()
assert request('B')[0] == 403
print('owner/read-only/stranger/anonymous/spoof/revocation: passed')
finally:
server.shutdown(); thread.join(); server.server_close()拒否の確認だけで終わらない
試験の前半ではAとBの読み取りが通ることを確認し、その後に拒否される操作を並べます。BのPUT、CのGET、未認証のGETでは、それぞれ期待するステータスと本文が返らないことを確認します。本文がdraftのままであることも、拒否ごとに検査します。最後にAのPUTを実行するとupdatedへ変わるため、全ての更新を禁止するだけの実装ではこの試験に通りません。この成功例と失敗例の組が、機能を保ちつつ境界を守ることを確認します。また、認可のエラーが401か403かという表示の違いだけを暗記する教材ではありません。主体が見つかったか、操作が許されるかを異なる条件として扱った結果です。製品の情報開示方針によっては応答の詳細を変えることもありますが、その場合も保存状態と機密な本文の扱いを一緒に確認します。
共有取り消しと申告値を変える
Bがuser_id=Aというクエリを付けてPUTを送っても、主体をクエリから取らないので拒否されます。これは、正しい形式の入力を送れたことと、本人や所有者として認められたことが別であるという例です。共有を取り消す試験ではreadersを空にした後、同じBのGETが拒否されることを確認します。前に読めたという事実を、その後の全ての要求の許可へ使っていません。ただし、過去に既に届いた本文のコピーが消えたことまでは試験していません。また、並行した更新と検査の間の競合をこの単純なコードで解決したとも言えません。実際の保存先へ移す際には、権限の検査と書込みの整合性、キャッシュの失効などを別に設計します。試験で動かした範囲を明記し、単一の成功から未実装の保証まで広げないようにします。
課題は許可表を一行だけ変える
課題としてBへ更新も許す共有規則へ変更したい場合、どこを変え、どの試験を変えるかを考えます。解答では、所有者だけがwriteできる現在の条件を、操作別の共有規則を参照する設計へ改めます。BのPUTを成功に変える一方、CのPUTと未認証のPUTは拒否のままにし、共有取り消し後にはBのPUTも拒否します。単にnot writeを消すだけでは、閲覧者を全て編集者へ変えることになり、将来の別の閲覧者まで意図せず広げる可能性があります。許可表の変更を先に書いてから、必要な条件と回帰試験を選びます。この課題の解答は設計上の変更案であり、掲載コードを変更済みという意味ではありません。実行した結果と追加課題の予想を分け、元の実験がどの規則を検証したかを残してください。