ð æš©éææ Œ (Privilege Escalation)
å©çšè ããèªåã®ããŒã«ã«èš±ãããŠããªãæäœããAPI ãçŽæ¥åŒãã§å®è¡ããããèªåã®ããŒã«ãäžãããã§ããŠããŸãè匱æ§
ç»é¢ã¯ãå©çšè
ã®ããŒã«ã«åãããŠãã¿ã³ãã¡ãã¥ãŒãé ããŸããããã©ã API ã¯ãç»é¢ãéããªããŠã curl ãéçºè
ããŒã«ã§åŒã¹ãŸãããµãŒããŒãæäœããšã«æš©éã確ãããŠããªããšãäžè¬ã®å©çšè
ã管çè
ã®æäœãããããèªåã®ããŒã«ãäžãããã§ããŸãã
OWASP Top 10:2025 ã® A01 (ã¢ã¯ã»ã¹å¶åŸ¡ã®äžå) ã«å
¥ãæ»æã§ããããã§ã¯ãèªåã®ããã³ãã®äžã§ãããŒã«ã«èš±ãããŠããªãæäœã«å±ãæ»æ (çžŠã®ææ Œ) ãæ±ããŸããä»ã®ããã³ãã®ããŒã¿ã«å±ãæ»æ (暪) 㯠IDOR ã®è³æ ã«ãŸãšããŠããŸãã
ð æ»ææé
Section titled âð æ»ææé âæ¬¡ã® 3 ã€ãããããšæç«ããŸãã
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.1Host: api.exampleAuthorization: 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"} |
ð¥ 被害äŸ
Section titled âð¥ 被害äŸâããŒã«ãäžãããããšããã®ããŒã«ã«èš±ãããæäœãããã¹ãŠæ»æè ã®æã«æž¡ããŸãã
| çãããæäœ | 被害 |
|---|---|
| ããŒã«ã®å€æŽ | èªåããªãŒããŒã«ããŠãããã³ããä¹ã£åããæ¬åœã®ãªãŒããŒãå€ããŠãåãæ»ããªããã |
| ã¡ã³ããŒã®æåŸ ã»åé€ | å€éšã®äººãæåŸ ããŠãããŒã¿ãæã¡åºãããã瀟å¡ãå€ããŠãä»äºãæ¢ãã |
| ããã³ãã®èšå®ã»åé€ | SSO ãªã©ã®èšå®ãå€ãããããããã³ãããšããŒã¿ãæ¶ããã |
| 課é | ãã©ã³ãå€ããããã»è«æ±ã®æ å ±ãèŠããã |
| éå¶åãã®ç®¡çæ©èœ | å šããã³ãã®ããŒã¿ãèŠãããã»å©çšè ãæ¶ããã |
| æ¬æã«æ··ããããŒã« (Mass Assignment) | èªåã®æ å ±ã®æŽæ°ã«é ç®ãæ··ããŠãæš©éãåŸã (äŸ: 2012 幎㮠GitHubãæŽæ°ã«é ç®ãæ··ããŠãèªåã®å ¬ééµãä»äººã®çµç¹ã«ç»é²ããrails/rails ã« commit ã push ã§ãã) |
ð¡ïž 察ç
Section titled âð¡ïž 察çâã±ãŒã¹ããšã«ã次ã®å¯Ÿçãçµã¿åãããŸãã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 ã«ãŸãšãŸã£ãŠããŸãã