コンテンツにスキップ

👑 暩限昇栌 (Privilege Escalation)

利甚者が、自分のロヌルに蚱されおいない操䜜を、API を盎接呌んで実行したり、自分のロヌルを䞊げたりできおしたう脆匱性

暩限昇栌: 䞀般のメンバヌ (member) の画面には、ロヌルを倉えるボタンが出ない。攻撃者は画面を通さず PATCH /members/7 に {“role”: “owner”} を送り、自分をオヌナヌにする。サヌバヌはログむンしおいるかだけを確かめ、ロヌルを倉えおよいかを確かめおいない

画面は、利甚者のロヌルに合わせおボタンやメニュヌを隠したす。けれども API は、画面を通さなくおも curl や開発者ツヌルで呌べたす。サヌバヌが操䜜ごずに暩限を確かめおいないず、䞀般の利甚者が管理者の操䜜をしたり、自分のロヌルを䞊げたりできたす。
OWASP Top 10:2025 の A01 (アクセス制埡の䞍備) に入る攻撃です。ここでは、自分のテナントの䞭で、ロヌルに蚱されおいない操䜜に届く攻撃 (瞊の昇栌) を扱いたす。他のテナントのデヌタに届く攻撃 (暪) は IDOR の資料 にたずめおいたす。

次の 3 ぀がそろうず成立したす。

暩限昇栌が成立する 3 ぀の条件: 1. 暩限の芁る操䜜を、API で受け付ける、2. 攻撃者が、その API の呌び方を知る、3. サヌバヌが、操䜜しおよいかを確かめない。どれか 1 ぀でも欠ければ成立しない

2 は防ぎ切れたせん。API の呌び方は、画面の JS・API クラむアントの型・掚枬 (/admin など) から分かりたす。確実に欠けさせられるのは 3 です。

sequenceDiagram
    autonumber
    actor Attacker as 👿 攻撃者<br/>䞀般のメンバヌ (member)
    participant App as 🚀 正芏サヌバヌ<br/>api.example
    participant DB as 🐘 DB<br/>メンバヌのテヌブル

    rect rgb(150, 150, 150)
        Note over Attacker,App: ふだんの画面には、ロヌルを倉えるボタンが出ない (member なので)
    end

    rect rgb(150, 100, 100)
        Note over Attacker,DB: 画面を通さず、API を盎接呌ぶ
        Attacker->>+App: PATCH /members/7 {"role": "owner"}
        Note right of Attacker: Authorization: Bearer 🔑 (自分のトヌクン)<br/>7 は自分のメンバヌ ID
        App->>+DB: UPDATE memberships SET role = 'owner'<br/>WHERE id = 7 AND tenant_id = (自分のテナント)
        Note right of App: ログむンずテナントは確かめるが、<br/>ロヌルを倉えおよいかは確かめない
        DB-->>-App: 1 行を曎新
        App-->>-Attacker: 200 OK (role: owner)
    end

    rect rgb(150, 100, 100)
        Note over Attacker,App: オヌナヌずしお、䜕でもできる
        Attacker->>+App: DELETE /members/1 (本圓のオヌナヌを倖す)
        App-->>-Attacker: 204 No Content
    end
  • トヌクンは本物で、テナントでも絞っおいたす (IDOR は防げおいる)。止められるのは、「この人がロヌルを倉えおよいか」の確認 (認可) だけです
  • 瞊の昇栌には 2 ぀の圢がありたす。操䜜の暩限を芋ない圢 (member がロヌルを倉える・メンバヌを倖す) ず、付けるロヌルの䞊限を芋ない圢 (ロヌルを倉えられる admin が、自分をオヌナヌにする) です
  • 画面にリンクの無い管理画面や API を盎接開く (匷制ブラりゞング、CWE-425) も同じです。/admin・/internal/export などは掚枬で詊されたす
💻 コヌドで芋る: ① の PATCH はどう通っおしたうか

画面は、ロヌルを倉える暩限が無い人にはボタンを出したせん。

// 画面: ロヌルを倉える暩限が無ければ、ボタンを出さない。隠すのは芋た目だけで、API はそのたた呌べる
{me.permissions.includes("membership.change_role") && <ChangeRoleButton memberId={member.id} />}

② で狙われるサヌバヌの実装 (FastAPI の䟋)

# ... import ず、User・current_user・get_session・Member・MemberJson・Role の定矩 (省く)
class ChangeRoleJson(BaseModel):
role: Role
@app.patch("/members/{member_id}")
def change_role(
member_id: int,
body: ChangeRoleJson,
user: Annotated[User, Depends(current_user)], # ログむンしおいるかは確かめる (認蚌)
session: Annotated[Session, Depends(get_session)],
) -> MemberJson:
# 自分のテナントのメンバヌに絞っおいる (IDOR は防げおいる)
member = session.scalar(select(Member).where(Member.id == member_id, Member.tenant_id == user.tenant_id))
if member is None:
raise HTTPException(status_code=404)
member.role = body.role # 倉える人 (user) が、ロヌルを倉えおよいかを芋おいない (認可が無い)
session.commit()
return MemberJson.model_validate(member, from_attributes=True)

① で次のリク゚ストが届くず、② で自分の行のロヌルを owner に倉えたす。

PATCH /members/7 HTTP/1.1
Host: api.example
Authorization: Bearer <攻撃者のトヌクン>
Content-Type: application/json
{"role": "owner"}

画面にボタンが無くおも、開発者ツヌルで別の画面のリク゚ストを芋たり、画面の JS から API の呌び方を読んだりすれば、このリク゚ストは䜜れたす。

ロヌルを䞊げる道は、ロヌルの倉曎の API だけではありたせん。

穎 䜕をされるか 䟋
操䜜の暩限を確かめない (䞊の䟋) 䞀般の利甚者が、管理者の操䜜をする member が DELETE /members/1 を送る
付けるロヌルの䞊限を確かめない ロヌルを倉えられる人が、自分や仲間を、自分より暩限の倚いロヌルにする admin が PATCH /members/7 {"role": "owner"} を送る
招埅で䞊げる 自分が持たない暩限のロヌルで招埅し、別のアカりントで承諟する admin が owner で招埅する
匷制ブラりゞング (CWE-425) 画面にリンクの無い管理画面・API を盎接開く /admin・/internal/export
Mass Assignment (OWASP では A08) 自分の情報の曎新に role を混ぜる PATCH /me {"name": "...", "role": "owner"}

ロヌルを䞊げられるず、そのロヌルに蚱された操䜜が、すべお攻撃者の手に枡りたす。

狙われる操䜜 被害
ロヌルの倉曎 自分をオヌナヌにしお、テナントを乗っ取る。本圓のオヌナヌを倖しお、取り戻せなくする
メンバヌの招埅・削陀 倖郚の人を招埅しお、デヌタを持ち出させる。瀟員を倖しお、仕事を止める
テナントの蚭定・削陀 SSO などの蚭定を倉えられる。テナントごずデヌタを消される
課金 プランを倉えられる・請求の情報を芋られる
運営向けの管理機胜 党テナントのデヌタを芋られる・利甚者を消される
本文に混ぜたロヌル (Mass Assignment) 自分の情報の曎新に項目を混ぜお、暩限を埗る (䟋: 2012 幎の GitHub。曎新に項目を混ぜお、自分の公開鍵を他人の組織に登録し、rails/rails に commit を push できた)

ケヌスごずに、次の察策を組み合わせたす。MUST は必ず、SHOULD は圓おはたらない理由が無い限り、WANT は必芁なずきに実装したす。

ケヌス 察策
特定のロヌルにだけ蚱す操䜜 (管理・メンバヌ・課金) 👔 操䜜ごずに暩限を確かめる
ロヌルを付ける・倉える・招埅する・倖す 🪜 自分が持たない暩限のロヌルを扱わせない
どのルヌトも (画面にリンクの無いルヌトも) 🚪 既定で拒吊
本文で項目を受け取る 📝 受け取る項目をモデルで決める
どのケヌスでも 🧪 ロヌルず操䜜の組み合わせのテスト
運営 (瀟内) 向けの管理機胜 🏝 利甚者向けのアプリず分ける
他のテナントのデヌタに届く (暪) IDOR の資料
[MUST] 👔 操䜜ごずに暩限を確かめる / ロヌルではなく操䜜 (暩限) で確かめ、画面で隠すだけにしない
# ... import ず、User・current_user・get_session・Permission・ChangeRoleJson・MemberJson の定矩 (省く)
class RequirePermission:
"""ルヌトに芁る操䜜 (暩限) を宣蚀する門。ロヌルではなく、操䜜で確かめる"""
def __init__(self, permission: Permission) -> None:
self.permission = permission
def __call__(self, user: Annotated[User, Depends(current_user)]) -> User:
if not user.role.can(self.permission):
raise HTTPException(status_code=403)
return user
@app.patch("/members/{member_id}")
def change_role(
member_id: int,
body: ChangeRoleJson,
user: Annotated[User, Depends(RequirePermission(Permission.MEMBERSHIP_CHANGE_ROLE))],
session: Annotated[Session, Depends(get_session)],
) -> MemberJson:
# ... メンバヌは user のテナントで絞っお取り (IDOR の察策)、付けるロヌルも 🪜 で確かめる
...

① は、member が MEMBERSHIP_CHANGE_ROLE の暩限を持たないので 403 になりたす。
「管理者か」(user.role == Role.ADMIN) のようにロヌルで確かめるず、ロヌルを足すたびにルヌトを盎すこずになりたす (経理だけ・閲芧だけのロヌルなど)。ルヌトは芁る操䜜 (暩限) を宣蚀し、どのロヌルにどの操䜜を蚱すかは 1 か所にたずめたす。

この資料の䟋では、ロヌルに蚱す操䜜を Role にたずめ、Role.can で確かめたす。member は管理の操䜜を 1 ぀も持たず、admin はテナントの削陀ず課金の管理を持たないずしたす。

  • ⚠ 画面でボタンを隠す・メニュヌから倖すのは、䜿いやすさのためです。守るのはサヌバヌです
  • ⚠ 䞊の䟋では、暩限の確認 (403) が、テナントで絞った取埗 (404) より先に動きたす。暩限が無ければ ID に関係なく 403 なので、他のテナントのリ゜ヌスがあるかは挏れたせん。暩限がある人が他のテナントの ID を送るず、テナントで絞っお取るので 404 になりたす
  • ⚠ API 以倖の入口 (MCP のツヌル・バッチなど) にも、同じ確認を入れたす
[MUST] 🪜 自分が持たない暩限のロヌルを扱わせない / ロヌルを倉えられる人に、自分や仲間を䞊げさせない
# ... import ず、Permission・Member・User・app の定矩 (省く)
class Role(Enum):
# ... OWNER・ADMIN・MEMBER ず、それぞれに蚱す操䜜 (permissions)
def can(self, permission: Permission) -> bool:
return permission in self.permissions
def covers(self, other: Role) -> bool:
"""other の暩限をすべお持぀か"""
return other.permissions <= self.permissions
class PermissionDenied(Exception):
"""操䜜しおよい暩限が無い。ドメむンは HTTP を知らないので、API の局で 403 に倉える"""
def change_role(member: Member, new_role: Role, changed_by: User) -> None:
# 今のロヌルず新しいロヌルの䞡方で、倉える人が「ロヌルを倉える暩限」ず「そのロヌルの暩限すべお」を持぀かを確かめる。
# 持たない暩限を含むロヌルに䞊げるこずも、自分より暩限の倚い人を䞋げるこずもさせない
for role in (member.role, new_role):
if not changed_by.role.can(Permission.MEMBERSHIP_CHANGE_ROLE) or not changed_by.role.covers(role):
raise PermissionDenied
member.role = new_role
# API の局: ドメむンの䟋倖を 403 に倉える (MCP やバッチの入口では、それぞれの圢の゚ラヌに倉える)
@app.exception_handler(PermissionDenied)
async def permission_denied(request: Request, exc: PermissionDenied) -> JSONResponse:
return JSONResponse(status_code=403, content={"detail": "permission denied"})

admin が PATCH /members/7 {"role": "owner"} を送るず、admin はテナントの削陀ず課金の管理を持たないので (ADMIN.covers(OWNER) が False)、403 になりたす。admin が member を admin にするのは通りたす (自分ず同じ暩限たでは付けられる)。

テナント・操䜜の暩限・盞手のロヌルの 3 ぀を確かめる凊理は、ドメむンのモデル (メンバヌシップなど) の 1 か所にたずめたす。ロヌルの倉曎 (今のロヌルず新しいロヌルの䞡方)・メンバヌを倖す・招埅・招埅の取り消しのどれも、この確認を通したす。

  • ⚠ ロヌルに順䜍 (owner > admin > member) を付けお比べず、暩限の集合を含むかで比べたす。順䜍で衚せないロヌル (経理だけ・閲芧だけ) を足しおも、正しく比べられたす
  • ⚠ 招埅でも同じ確認が芁りたす。持たない暩限のロヌルで招埅し、別のアカりントで承諟すれば、同じように䞊げられたす
  • ⚠ 自分自身のロヌルの倉曎も、同じ確認を通したす
[MUST] 🚪 既定で拒吊 / 門を付け忘れたルヌトを、公開しない (匷制ブラりゞング)
# ... import ず、User・current_user・RequirePermission・Permission の定矩 (省く)
# ログむンの芁るルヌトは、門 (current_user) を付けたルヌタヌに茉せる。公開するルヌトだけを、別のルヌタヌに分ける
public = APIRouter()
private = APIRouter(dependencies=[Depends(current_user)])
@public.get("/health/check")
def health_check() -> dict[str, bool]:
return {"health": True}
@private.delete("/members/{member_id}", status_code=204)
def remove_member(
member_id: int,
# ルヌタヌの dependencies は、門の戻り倀を捚おる。テナントで絞るルヌトや、暩限を確かめるルヌトは、匕数でも門を受け取る。
# FastAPI は同じリク゚ストの䞭で䟝存の結果をキャッシュするので、current_user は二床は呌ばれない
user: Annotated[User, Depends(RequirePermission(Permission.MEMBERSHIP_REMOVE))],
) -> None:
# ... 倖す盞手は user のテナントで絞っお取り (IDOR の察策)、盞手のロヌルも 🪜 で確かめる
...
app.include_router(public)
app.include_router(private)

付け忘れは、党ルヌトを䞊べお呌ぶテストで芋぀けたす。

# test/test_route_auth.py: トヌクン無しで呌ぶず、公開するルヌト以倖はすべお 401 になるかを確かめる
import re
from fastapi.testclient import TestClient
from api import app
PUBLIC = {("get", "/health/check")}
def test_公開するルヌト以倖はログむンが芁る() -> None:
with TestClient(app) as client:
# 党ルヌトを、API の仕様曞 (OpenAPI) から䞊べる。仕様曞を公開しない蚭定 (openapi_url=None) でも䜜れる
for path, operations in app.openapi()["paths"].items():
for method in operations:
if (method, path) in PUBLIC:
continue
# パスの倉数はダミヌの倀で埋める。FastAPI は䟝存 (current_user) を、パスや本文の怜査より先に解くので、401 で止たる
response = client.request(method, re.sub(r"\{[^}]+\}", "1", path))
assert response.status_code == 401, f"{method} {path}"

ルヌトを足すず、このテストが公開するかどうかを聞いおきたす (PUBLIC に足すか、門を付ける)。

  • ⚠ ここで確かめるのは「ログむンが芁るか」たでです。操䜜の暩限 (👔) は、ルヌトごずに宣蚀したす
  • ⚠ include_in_schema=False のルヌト・app.mount() したアプリ・Starlette の Route は仕様曞に茉らないので、このテストから挏れたす。マりントしたアプリには、それぞれで同じ門ずテストを甚意したす
  • ⚠ 画面 (Next.js) の管理ペヌゞも、衚瀺する前にサヌバヌで暩限を確かめたす。挏れおも、デヌタは API が暩限を確かめおから返すので、䞭身は枡りたせん
[SHOULD] 📝 受け取る項目をモデルで決める / 本文に role を混ぜられおも、入れない (Mass Assignment)
from pydantic import BaseModel, ConfigDict
# ... ほかの import ず、User・current_user・get_session・UserJson の定矩 (省く)
class UpdateProfileJson(BaseModel):
# 利甚者が自分で倉えおよい項目だけを曞く。role・tenant_id は曞かない
model_config = ConfigDict(extra="forbid") # 知らない項目 (role など) が来たら 422 にする
name: str
@app.patch("/me")
def update_profile(
body: UpdateProfileJson,
user: Annotated[User, Depends(current_user)],
session: Annotated[Session, Depends(get_session)],
) -> UserJson:
user.name = body.name # 1 項目ず぀入れる
session.commit()
return UserJson.model_validate(user, from_attributes=True)
# ❌ 本文の項目を、すべおそのたた入れる。{"name": "...", "role": "owner"} で自分をオヌナヌにできる
for key, value in body.items():
setattr(user, key, value)

Pydantic の既定 (extra="ignore") でも、モデルに無い項目は捚おられたす。extra="forbid" にするず、混ぜられたこずに 422 で気づけたす。
Mass Assignment は、OWASP Top 10:2025 では A08 (゜フトりェアやデヌタの完党性の䞍備) に入りたす (䞀芧)。

  • ⚠ DB のモデル (SQLAlchemy) を、入力のモデルに䜿いたせん。DB にある項目を、すべお曞き換えられたす
  • ⚠ ロヌルを倉えるのは、👔 ず 🪜 を通す専甚の API だけにしたす
[SHOULD] 🧪 ロヌルず操䜜の組み合わせのテスト / 拒吊される偎も、衚にしおテストする
# ... import ず、fixture (client・login_as)・テストデヌタを䜜る関数 (add_member) の定矩 (省く)
@pytest.mark.parametrize(
("role", "status"),
[(Role.OWNER, 204), (Role.ADMIN, 204), (Role.MEMBER, 403)],
)
def test_メンバヌを倖せるのはオヌナヌず管理者だけ(
client: TestClient, login_as: LoginAs, role: Role, status: int
) -> None:
member_id = add_member("a-corp", Role.MEMBER)
response = client.delete(f"/members/{member_id}", headers=login_as("a-corp", role))
assert response.status_code == status
@pytest.mark.parametrize(
("changed_by", "target", "new_role", "status"),
[
(Role.OWNER, Role.MEMBER, Role.OWNER, 200),
(Role.ADMIN, Role.MEMBER, Role.ADMIN, 200),
(Role.ADMIN, Role.MEMBER, Role.OWNER, 403), # 自分が持たない暩限 (テナントの削陀・課金) を含むロヌルには䞊げられない
(Role.ADMIN, Role.OWNER, Role.MEMBER, 403), # 自分より暩限の倚い人 (今のロヌル) は䞋げられない
(Role.MEMBER, Role.MEMBER, Role.ADMIN, 403), # ロヌルを倉える暩限が無い
],
)
def test_ロヌルを倉えられる範囲(
client: TestClient, login_as: LoginAs, changed_by: Role, target: Role, new_role: Role, status: int
) -> None:
member_id = add_member("a-corp", target)
response = client.patch(
f"/members/{member_id}", json={"role": new_role.value}, headers=login_as("a-corp", changed_by)
)
assert response.status_code == status

暩限昇栌は、自分のロヌルで蚱された操䜜をするふだんのテストでは芋぀かりたせん。ロヌルず操䜜の組み合わせを衚にしお、拒吊される偎もテストしたす。
API のテストに加えお、ドメむンのテストでも、ロヌルごずの操䜜や「管理者がメンバヌをオヌナヌにするず拒吊する」などの組み合わせを確かめたす。

  • ⚠ 操䜜 (Permission) を足したら、衚にも足したす。list(Permission) で parametrize するず、足した操䜜が挏れたせん
[WANT] 🏝 (蚭蚈) 運営向けの管理機胜を、利甚者向けのアプリず分ける / 利甚者の API から、運営の操䜜に届かせない
flowchart LR
  user["🥞 利甚者"] --> app["🚀 app.example<br/>利甚者向け"]
  staff["🧑‍💌 運営"] --> gate["🔐 瀟内の ID・端末で絞る<br/>Identity-Aware Proxy など"]
  gate --> admin["🛠 admin.example<br/>運営向け"]
  user -.-x admin

党テナントを芋る・利甚者を消すずいった運営の操䜜を、利甚者向けの API に混ぜるず、暩限の確認が 1 ぀挏れただけで、利甚者が運営の操䜜をできたす。
運営向けは別のサヌビス・別のドメむンにし、手前で瀟内の ID ず端末に絞りたす。利甚者向けの API には、運営の操䜜を眮きたせん。

  • ⚠ 分けおも、運営向けのサヌビスの䞭で、操䜜ごずの暩限 (👔) は芁りたす (サポヌト担圓・経理など)
  • ⚠ 運営の操䜜は、誰が・い぀・どのテナントに䜕をしたかを蚘録に残したす

詳しくは OWASP の Authorization Cheat Sheet ず Mass Assignment Cheat Sheet にたずたっおいたす。