ð ïž èšèšã»å®è£
éæ©èœèŠä»¶
Section titled âéæ©èœèŠä»¶â- ã¢ãžã¥ãŒã«æ§: ã¢ãžã¥ã©ã¢ããªã¹ã®åã¢ãžã¥ãŒã«ãç°¡åã«ãã€ã¯ããµãŒãã¹ã«ç§»è¡ã§ããããš
- 倿Žå®¹ææ§:
- æš©éãç°¡åã«å¢ãããããæžããããã§ããããš
- ããŒã«ãç°¡åã«å¢ãããããæžããããã§ããããš
- æ¡åŒµæ§: åºå®ã® RBAC ã§å§ããŠãããšããåç㪠RBAC (ããã³ãããšã«äœããããŒã«) ã«ããŠãäœãçŽããã«æžãããš
- èªå·±å®çµæ§: ãŠãŒã¶ãŒã®ããŒã«ã»æš©éãéœåºŠåãåãããã«å€å®ã§ããããš
- ãªã¢ã«ã¿ã€ã æ§: æš©éãããŒã«ãå€ãã£ãæã«ã§ããã ãæ©ãåæ ã§ããããš
- çœ®ææ§: IDaaS ãå·®ãæ¿ããŠããæš©éã®ä»çµã¿ãäœãçŽããã«æžãããš
- å®å šæ§: ããŒã«ãä»ãããäœã£ãããããšãã«ãèªåãæããªãæš©éãäžããããªã (æš©éã®ææ Œãé²ãã) ããš
èšèšæ¡
Section titled âèšèšæ¡â1. éäžå (Clerkå)
Section titled â1. éäžå (Clerkå)âã¯ã©ã¹ããã¡ã€ã«ã1ã¢ãžã¥ãŒã«(ãã€ã¯ããµãŒãã¹)ã§ããŒã«ãšæš©éãäžå 管çããæ¹åŒãæš©éãå¢ãããã³ã«æŽæ°ãå¿ èŠã«ãªãã
Clerk ãšã®éã: Clerk ã¯ããŒã«ãšæš©éãããã·ã¥ããŒãã®ããŒã¿ã§æã¡ã確ããããšã㯠Clerk ã«åãåããããã»ãã·ã§ã³ããŒã¯ã³ã«èŒã£ãæš©é (
feaã»o.perã»o.fpmããçµã¿ç«ãŠã) ãèªãã
flowchart LR
project("ð project ã¢ãžã¥ãŒã«")
other("ð§© ã»ãã®æ©èœã®ã¢ãžã¥ãŒã«")
subgraph tenant ["ð¢ tenant ã¢ãžã¥ãŒã«"]
role(["ð Role<br/>ownerã»adminã»member"])
projectPermission(["ð project.createã»project.delete"])
tenantPermission(["ð tenant.update"])
otherPermission(["ð ã»ãã®æ©èœã®æš©é"])
role -->|æš©éãæãã| projectPermission & tenantPermission & otherPermission
end
project -->|"ãªã¯ãšã¹ãã®ãã³ã«<br/>project.delete ãã§ããã"| tenant
other -->|ãªã¯ãšã¹ãã®ãã³ã«åãåããã| tenant
user(("ð€ ãŠãŒã¶ãŒ")) --> project & other
å®è£ äŸ
class Permission(Enum): # ããã³ã TENANT_UPDATE = "tenant.update" # ããã³ãã®ååã»èšå®ãå€ãã TENANT_DELETE = "tenant.delete" # ããã³ããåé€ãã # 課é BILLING_MANAGE = "billing.manage" # ãã©ã³ãå€ããã»è«æ±ãèŠã # ã¡ã³ã㌠MEMBERSHIP_INVITE = "membership.invite" # ã¡ã³ããŒãæåŸ
ããã»æåŸ
ãåãæ¶ã MEMBERSHIP_CHANGE_ROLE = "membership.change_role" # ã¡ã³ããŒã®ããŒã«ãå€ãã MEMBERSHIP_REMOVE = "membership.remove" # ã¡ã³ããŒãå€ã # ãããžã§ã¯ã (project ã¢ãžã¥ãŒã«) PROJECT_CREATE = "project.create" PROJECT_DELETE = "project.delete"
# backend/src/tenant/domain/model/membership/role.py
class Role(Enum): # (permissions ãš __new__ ã¯ä»ãšåã)
# ãã¹ãŠã®æš©éãæã€ã®ã§ãè¶³ããæš©éãæžããã«æžã OWNER = ("owner", frozenset(Permission)) ADMIN = ( "admin", frozenset( { Permission.TENANT_UPDATE, Permission.MEMBERSHIP_INVITE, Permission.MEMBERSHIP_CHANGE_ROLE, Permission.MEMBERSHIP_REMOVE, Permission.PROJECT_CREATE, Permission.PROJECT_DELETE, } ), ) MEMBER = ("member", frozenset({Permission.PROJECT_CREATE}))2. 忣å (IDDDå)
Section titled â2. 忣å (IDDDå)âåã¢ãžã¥ãŒã«ãèªåã®æš©éãæã¡ãããŒã«ã ãã tenant ã¢ãžã¥ãŒã«ã«åãåãããŠèªåã® Role ã«èš³ãæ¹åŒãããŒã«ãå¢ãããã³ã«ããã®ããŒã«ã«æš©éãèš±ãã¢ãžã¥ãŒã«ã® Role ã®åããæŽæ°ãå¿ èŠã«ãªã (åãã«ç¡ãããŒã«ã¯æåŠãã)ã
IDDD ãšã®éã: IDDD ã¯æš©éãæãããããã®äººã¯ Moderator ããŒã«ãããåãåãããŠã
Moderatorãªã©ã®å€ãªããžã§ã¯ãã«èš³ãã
flowchart LR
subgraph project ["ð project ã¢ãžã¥ãŒã«"]
projectRole(["ð Role (tenant ã®ããŒã«ã®åã)<br/>ownerã»adminã»member"])
projectPermission(["ð Permission<br/>project.create, ..."])
projectRole -->|æš©éãæãã| projectPermission
end
subgraph other ["ð§© ã»ãã®æ©èœã®ã¢ãžã¥ãŒã«"]
otherRole(["ð Role (tenant ã®ããŒã«ã®åã)"])
otherPermission(["ð Permission"])
otherRole -->|æš©éãæãã| otherPermission
end
subgraph tenant ["ð¢ tenant ã¢ãžã¥ãŒã«"]
role(["ð Role<br/>ownerã»adminã»member"])
permission(["ð Permission<br/>tenant.update, ..."])
role -->|æš©éãæãã| permission
end
project -->|"ãªã¯ãšã¹ãã®ãã³ã«<br/>ãã®äººã®ããŒã«ã¯äœã"| tenant
other -->|ãªã¯ãšã¹ãã®ãã³ã«åãåããã| tenant
user(("ð€ ãŠãŒã¶ãŒ")) --> project & other
å®è£ äŸ
# åã¢ãžã¥ãŒã«ããšã«å®çŸ©
class Role(Enum): """tenant ã®ããŒã«ãããã®ã¢ãžã¥ãŒã«ã§äœ¿ã圢ã«èš³ãããã®ãACL ã¢ããã¿ãŒã tenant ã®å
¬é IF ããäœã"""
OWNER = "owner" ADMIN = "admin" MEMBER = "member"
class Permission(Enum): """ãããžã§ã¯ãã®æäœãšããããèš±ãããŒã«"""
roles: frozenset[Role]
def __new__(cls, value: str, roles: set[Role]) -> Self: # Role ãšåãããvalue ã¯æååã®ãŸãŸã«ãããèš±ãããŒã«ãåãæäœããå¥åã«ãŸãšããããªããã permission = object.__new__(cls) permission._value_ = value permission.roles = frozenset(roles) return permission
# ãããžã§ã¯ã PROJECT_CREATE = ("project.create", {Role.OWNER, Role.ADMIN, Role.MEMBER}) PROJECT_DELETE = ("project.delete", {Role.OWNER, Role.ADMIN})3. åæµå (Kuberneteså)
Section titled â3. åæµå (Kuberneteså)âåã¢ãžã¥ãŒã«ãèªåã®æš©éãšããããèš±ãããŒã«ã®ååã宣èšããèµ·åæã« tenant ã¢ãžã¥ãŒã«ãžéããæ¹åŒãæ©èœãè¶³ããŠã tenant ã¢ãžã¥ãŒã«ã¯å€ããã«æžããtenant ã¢ãžã¥ãŒã«ããã¹ãŠã®æš©éãç¥ãã®ã§ãéäžåãšåãããããŒã«ã DB ã«ç§»ãã°ããã³ãããšã«äœãããŒã«ãæ±ãã (宣èšããèš±ãããŒã«ã¯ãæ¢å®ã®ããŒã«ã®äžèº«ã«ãªã)ãowner ã«ã¯ tenant ã¢ãžã¥ãŒã«ããã¹ãŠã®æš©éãèš±ãã®ã§ã宣èšã«ã¯æžããªãã
確ããæ¹ã¯ã次㮠2 ã€ããéžã¹ããtenant ã¢ãžã¥ãŒã«ã®ããŒã«ãšæš©éã¯ã©ã¡ããåãã§ãéãã®ã¯ç¢ºãããæã ãã
- tenant ã«èã: åã¢ãžã¥ãŒã«ã¯ããã®äººã¯ project.delete ãã§ããããã tenant ã¢ãžã¥ãŒã«ã«èããtenant ã¢ãžã¥ãŒã«ã確ããã
- æš©éã®éåãåãåã: åã¢ãžã¥ãŒã«ã¯ããã®äººã®æš©éã®éåãã tenant ã¢ãžã¥ãŒã«ããåãåããèŠãæš©éãããããèªåã§ç¢ºããããããŒã¯ã³ã«æš©éã®éåãèŒãããšãã¯ããã¡ãã«ãªã
Kubernetes ãšã®éã: Kubernetes ã¯ã³ã³ãããŒã«ãã¬ãŒã³ã®ã³ã³ãããŒã©ãŒããã©ãã« (
aggregate-to-adminãªã©) ã®ä»ãã ClusterRole ãåããŠããéãã£ãšåæµããããããã§ã¯èµ·åæã« 1 åéããã ãã
flowchart LR
user(("ð€ ãŠãŒã¶ãŒ"))
subgraph project ["ð project ã¢ãžã¥ãŒã«"]
projectPermission(["ð project.create â adminã»member<br/>project.delete â admin"])
end
subgraph other ["ð§© ã»ãã®æ©èœã®ã¢ãžã¥ãŒã«"]
otherPermission(["ð æš©é â èš±ãããŒã«"])
end
subgraph tenant ["ð¢ tenant ã¢ãžã¥ãŒã«"]
role(["ð Role<br/>ownerã»adminã»member"])
permission(["ð tenant.update<br/>project.createã»project.delete (åæµ)"])
role -->|æš©éãæãã| permission
end
user --> project & other
project -.->|èµ·åæã«å®£èšãæž¡ã| tenant
other -.->|èµ·åæã«å®£èšãæž¡ã| tenant
project -->|"ãªã¯ãšã¹ãã®ãã³ã«<br/>project.delete ãã§ããã<br/>(ãŸã㯠ãã®äººã®æš©éã®éå)"| tenant
other -->|ãªã¯ãšã¹ãã®ãã³ã«åãåããã| tenant
å®è£ äŸ
# project ã¢ãžã¥ãŒã«: æš©éãšããããèš±ãããŒã«ã®ååã宣èšãããèµ·åæã« AppModule.permissions ã§ tenant ã«éãã
class Permission(Enum): # (roles ãš __new__ 㯠2 ãšåã圢ãtenant ã® Role 㯠import ã§ããªãã®ã§ãããŒã«ã¯ååã§æžã)
PROJECT_CREATE = ("project.create", {"admin", "member"}) PROJECT_DELETE = ("project.delete", {"admin"})
# project ã¢ãžã¥ãŒã« (tenant ã«èã): tenant ã«ããã®äººã¯ project.delete ãã§ãããããèã
if not permission_service.can(tenant_id, user_id, Permission.PROJECT_DELETE): raise SystemException( ErrorCode.PERMISSION_DENIED, f"permission={Permission.PROJECT_DELETE.value}" )
# project ã¢ãžã¥ãŒã« (æš©éã®éåãåãåã): tenant ããããã®äººã®æš©éã®éåããåãåããèªåã§ç¢ºããã
# äŸ: {"tenant.update", "project.create", "project.delete"}permissions = permission_service.permissions_of(tenant_id, user_id)if Permission.PROJECT_DELETE.value not in permissions: raise SystemException( ErrorCode.PERMISSION_DENIED, f"permission={Permission.PROJECT_DELETE.value}" )
# tenant ã¢ãžã¥ãŒã«: 確ããæ¹ã«åãããŠãã§ãããã ããçããããæš©éã®éåããã®ãŸãŸè¿ã
def can(self, tenant_id: TenantId, user_id: UserId, permission: Enum) -> bool: # åã¢ãžã¥ãŒã«ã®æš©éã® Enum ãåãåããå€ã®æååã§æš©éã®éåãšæ¯ã¹ã return permission.value in self.permissions_of(tenant_id, user_id)
def permissions_of(self, tenant_id: TenantId, user_id: UserId) -> frozenset[str]: membership = self.__membership_repository.membership_of(tenant_id, user_id) if membership is None: return frozenset() # â¡ ã® Roleãæš©éã®å€ã®æååã®éåãæã€ role = self.__role_repository.role_of(membership.role_id) return role.permissions if role is not None else frozenset()æ¯èŒæ€èš
Section titled âæ¯èŒæ€èšâ⯠èšèšæ¡ã®ãšããã§æºããã»â³ æãå ããã°æºããã»Ã äœãçŽããªããšæºãããªã
| éæ©èœèŠä»¶ | 1. éäžå (Clerkå) | 2. 忣å (IDDDå) | 3. åæµå (Kuberneteså) |
|---|---|---|---|
| ã¢ãžã¥ãŒã«æ§ | â³ | ⯠| â³ |
| 倿Žå®¹ææ§ (æš©é) | à | ⯠| ⯠|
| 倿Žå®¹ææ§ (ããŒã«) | ⯠| à | â³ |
| æ¡åŒµæ§ | ⯠| à | ⯠|
| èªå·±å®çµæ§ | â³ | â³ | â³ |
| å®å šæ§ | ⯠| à | ⯠|
1. éäžå (Clerkå)
- ã¡ãªãã
- ããŒã«ãè¶³ãã»æžããã®ã¯ tenant ã® Role ã ã (倿Žå®¹ææ§ (ããŒã«))
- tenant ããã¹ãŠã®æš©éãç¥ã£ãŠããã®ã§ãããŒã«ã DB ã«ç§»ãã°åç㪠RBAC ã«ã§ãããåã¢ãžã¥ãŒã«ã¯å€ããªã (æ¡åŒµæ§)
- tenant ããã¹ãŠã®æš©éãç¥ãã®ã§ãããŒã«ãä»ãããšãã®æš©éã®ææ Œã®ç¢ºèªããã¹ãŠã®æš©éã«å¹ã (å®å šæ§)
- ããŒã«ãšæš©éã®äžèЧã 1 ãæã«ãããèŠéãããã
- ãã¡ãªãã
- ç§»ãäœæ¥ã¯åãåãããå ã tenant ã® API ã«æ¿ããã ãã ããç§»ããã¢ãžã¥ãŒã«ã®æš©é㯠tenant ã«æ®ããæ©èœãè¶³ããã³ã« tenant ãäžç·ã«ãªãªãŒã¹ããããšã«ãªããç¬ç«ããŠãªãªãŒã¹ã§ããªã (ã¢ãžã¥ãŒã«æ§)
- æ©èœãè¶³ããã³ã«ãæ©èœã®ã¢ãžã¥ãŒã«ãš tenant ã®äž¡æ¹ãå€ãããæ©èœã®ã¢ãžã¥ãŒã«ã ãã§æžãŸããã«ã¯ãæš©éãåã¢ãžã¥ãŒã«ã«ç§»ãäœãçŽãã«ãªã (倿Žå®¹ææ§ (æš©é))
- åç㪠RBAC ã«ãããšãæ¶ããæš©éã®æååãã«ã¹ã¿ã ããŒã«ã«æ®ãã®ã§ãèªããšãã«èœãšãåŠçãèŠã (æ¡åŒµæ§)
2. 忣å (IDDDå)
- ã¡ãªãã
- tenant ã«èãã®ã¯ããŒã«ã ããªã®ã§ãåãåãããå ã tenant ã® API ã«æ¿ããã°ãã€ã¯ããµãŒãã¹ã«åãããã (ã¢ãžã¥ãŒã«æ§)
- æš©éãè¶³ãã»æžããã®ã¯æ©èœã®ã¢ãžã¥ãŒã«ã ã (倿Žå®¹ææ§ (æš©é))
- 確ãããã®ã«èŠãã®ã¯ããŒã« 1 ã€ãªã®ã§ãããŒã¯ã³ã«èŒããŠãå°ãã (èªå·±å®çµæ§)
- ãã¡ãªãã
- ããŒã«ãè¶³ãã»æžãããšãtenant ã® Role ãšããã®ããŒã«ã«æš©éãèš±ãã¢ãžã¥ãŒã«ã® Role ã®åãã»èš³ãå€ããããã€ã¯ããµãŒãã¹ã«åããããšã¯ãããããäžç·ã«ãªãªãŒã¹ãããtenant ã ãã§æžãŸããã«ã¯ãããŒã«ã«èš±ãæš©éã tenant ã«ç§»ãäœãçŽãã«ãªã (倿Žå®¹ææ§ (ããŒã«))
- åã¢ãžã¥ãŒã«ã¯ã³ãŒãã«ããããŒã«ã«ããèš³ããªãã®ã§ãããã³ãããšã®ããŒã«ãæ±ããªã (æ¡åŒµæ§)
- tenant ã¯æ©èœã®æš©éãç¥ããªãã®ã§ãããŒã«ãä»ãããšãã®æš©éã®ææ Œã®ç¢ºèªããtenant ã®æš©éã«ããå¹ããªããæ©èœã®æš©éã¯ããããŒã« X ã«èš±ããªããX ãä»ããããããŒã«ã«ãèš±ãããšããæã®æ±ºãŸãã§å®ããããªã (å®å šæ§)
3. åæµå (Kuberneteså)
- ã¡ãªãã
- æš©éãè¶³ãã»æžããã®ã¯æ©èœã®ã¢ãžã¥ãŒã«ã®å®£èšã ãã§ãtenant ã¯å€ããªã (倿Žå®¹ææ§ (æš©é))
- tenant ããã¹ãŠã®æš©éãç¥ãã®ã§ãããŒã«ã DB ã«ç§»ãã°åç㪠RBAC ã«ã§ãããåã¢ãžã¥ãŒã«ã¯å€ããªã (æ¡åŒµæ§)
- tenant ããã¹ãŠã®æš©éãç¥ãã®ã§ãããŒã«ãä»ãããšãã®æš©éã®ææ Œã®ç¢ºèªããã¹ãŠã®æš©éã«å¹ã (å®å šæ§)
- æžãééããããŒã«ã®ååããéãªã£ãæš©éãèµ·åæã«èŠã€ãããã
- æš©éã®éåãåãåã確ããæ¹ãªãã1 ãªã¯ãšã¹ãã§ 1 ååãåãã°ãäœåºŠç¢ºãããŠãåãåããçŽããã«æžããç»é¢ã«ãã§ããæäœãããã®ãŸãŸè¿ãã
- ãã¡ãªãã
- èµ·åæã®åæµã¯ 1 ã€ã®ããã»ã¹ã®äžã§ããå¹ããªãããã€ã¯ããµãŒãã¹ã§ã¯ããããã€æã« tenant ãžæš©éãç»é²ããä»çµã¿ãèŠã (ã¢ãžã¥ãŒã«æ§)
- æ¢å®ã®ããŒã«ãè¶³ããšãtenant ã® Role ãšããã®ããŒã«ã«èš±ãæš©éã宣èšããŠããã¢ãžã¥ãŒã«ãå€ãã (倿Žå®¹ææ§ (ããŒã«))
- åç㪠RBAC ã«ãããšãæ¶ããæš©éã®æååãã«ã¹ã¿ã ããŒã«ã«æ®ãã®ã§ãèªããšãã«èœãšãåŠçãèŠã (æ¡åŒµæ§)
- fastship-py ã®
AppModuleã«ãæš©éã®å®£èšãè¶³ãå¿ èŠããã
ã©ã®æ¡ã«ãåœãŠã¯ãŸãããš
- å³ã®ãšãããªããã©ã®æ¡ããªã¯ãšã¹ãã®ãã³ã« tenant ã«åãåããããåãåãããã«ç¢ºãããã«ã¯ãããŒã¯ã³ã«èŒãããèŒããã®ã¯ã2 ã¯ããŒã«ã1ã»3 ã¯æš©éã®éåã§ãæš©éãå¢ããã»ã©å€§ãããªã (èªå·±å®çµæ§)
- ããŒã¯ã³ã¯ãæå±ããããã³ãã®æ°ã§ã倧ãããªããClerk ã®ããã«ãéžãã§ããããã³ãã®åã ãèŒãã (èªå·±å®çµæ§)
- åãåããã圢ãªããããŒã«ã®ä»ãæ¿ãã¯ããå¹ããããŒã¯ã³ã«èŒãããšãããŒã¯ã³ãåãããŸã§å¹ããªããèªå·±å®çµæ§ãšã¯åŒãæãã«ãªã (ãªã¢ã«ã¿ã€ã æ§)
- IDaaS ããåãåãã®ã¯ãŠãŒã¶ãŒ ID ã ãã§ãããŒã«ãšæš©é㯠tenant ã«æã€ãããŒã¯ã³ã«èŒãããšãããIDaaS ã®ã«ã¹ã¿ã ã¯ã¬ãŒã ã§ã¯ãªãèªåã§çºè¡ããããŒã¯ã³ã«èŒããã°ãIDaaS ãå·®ãæ¿ãããã (çœ®ææ§)
- åæµåããæš©éã®éåãåãåã確ããæ¹ã§äœããåã¢ãžã¥ãŒã«ã¯æš©éãšäžç·ã«æ¢å®ã®ããŒã«ãå ¬éããæ°ããæš©éãæ¢å®ã®ããŒã«ã«çŽä»ããã®ã¯ãæš©éãè¶³ãã¢ãžã¥ãŒã«èªèº«ã«ãããæš©éã ããå ¬éãããšãæ©èœãè¶³ããã³ã« tenant ã¢ãžã¥ãŒã«ã®çŽä»ããå€ããããšã«ãªããéäžåãšåãå°ãããšã«æ»ãããã
| ã¢ãžã¥ã©ã¢ããªã¹ | ãã€ã¯ããµãŒãã¹ | |
|---|---|---|
| tenant ãå šã¢ãžã¥ãŒã«ã®æš©éãéãã | èµ·åæã« CompositeModule.permissions ãã |
åãµãŒãã¹ã®ãããã€ã®ãã³ã«ãæ°ããçã® GET /internal/permissions ãã |
| åã¢ãžã¥ãŒã«ãæš©éã®éåãåãåã | tenant ã¢ãžã¥ãŒã«ãããåãããã»ã¹ã®äžã§ | å éšéä¿¡ããŒã¯ã³ã®ã¯ã¬ãŒã ãã |
ãã€ã¯ããµãŒãã¹ã§ã¯ãè¶³ããæš©éã¯ãã©ãã£ãã¯ãæ°ããçã«æµãåã«åã蟌ã¿ãçºè¡æžã¿ã®ããŒã¯ã³ãåããã®ãåŸ ã€ãå ã«æµããšãåã蟌ããŸã§ãšããŒã¯ã³ãåãããŸã§ãè¶³ããæš©éãèŠãæäœã owner ãå«ããŠæåŠããããæ¶ããæš©éã¯ãå€ãçããŸã 確ãããŠããã®ã§ãæµããåŸã«èœãšãã
sequenceDiagram
autonumber
participant CI as CI (project ã®ãããã€)
participant P as project ãµãŒãã¹ (æ°ããç)
participant T as tenant ãµãŒãã¹
participant B as å
¥å£ (BFF)
CI->>P: ãã©ãã£ãã¯ãæµããã«ãããã€ãã
CI->>T: project ã®æš©éãåã蟌ã (è¶³ãã ã)
T->>P: GET /internal/permissions
P-->>T: project.create (æ¢å®: adminã»member)<br/>project.delete (æ¢å®: admin)
T->>T: DB ã®äžèЧã«è¶³ã (åããªããã°ååã®äžèЧã®ãŸãŸ)
CI->>CI: å
éšéä¿¡ããŒã¯ã³ã®å¯¿åœ (5 å) ãåŸ
ã€
CI->>P: ãã©ãã£ãã¯ãæ°ããçã«æµã
CI->>T: project ã®æš©éãåã蟌ã¿çŽã (æ°ããçã«ç¡ãæš©éãèœãšã)
B->>T: IDaaS ã®ããŒã¯ã³ãšãéžãã§ããããã³ã
T-->>B: å
éšéä¿¡ããŒã¯ã³ (permissions ã¯ã¬ãŒã )
B->>P: DELETE /{tenant_id}/projects/{project_id}<br/>+ å
éšéä¿¡ããŒã¯ã³
P->>P: tenant_id ãããŒã¯ã³ãšåãã§ãpermissions ã« project.delete ãããã
â åã¢ãžã¥ãŒã«: æš©éãšæ¢å®ã®ããŒã«ã宣èšããå ¬éãã
Section titled ââ åã¢ãžã¥ãŒã«: æš©éãšæ¢å®ã®ããŒã«ã宣èšããå ¬éããâæš©éã® Enum ã®åºåº (fastship-py ã® Permissionãã¢ãžã¥ãŒã«ã® Permission ãšååãéãªãã®ã§ _Permission ãšã㊠import ãã)ãAppModule.permissions ãšãããã JSON ã«ããŠè¿ã GET /internal/permissions 㯠fastship-py ã«è¶³ãã
æš©éã® Enum ã¯ãã¡ã€ã³ã«çœ®ããªãã䜿ãã®ã¯ã«ãŒãã»ããŒã«ã®éãš core.py ã§ãã«ãŒã (port.adapter.resource) ãããŒã« (port.adapter.tool) 㯠lint-imports ã®èŠçŽã§ domain ã import ã§ããªãããã
@unique # å€ãéãªããšå¥åã«ãªãã2 ã€ç®ã®æ¢å®ã®ããŒã«ãé»ã£ãŠæšãŠãããããclass Permission(_Permission): # ãããžã§ã¯ã PROJECT_CREATE = ("project.create", {"admin", "member"}) PROJECT_DELETE = ("project.delete", {"admin"})
# project/core.py
class Project(AppModule): @property @override def permissions(self) -> list[_Permission]: return list(Permission)â¡ tenant: å šã¢ãžã¥ãŒã«ã®æš©éãéããããŒã«ãçµã¿ç«ãŠã
Section titled ââ¡ tenant: å šã¢ãžã¥ãŒã«ã®æš©éãéããããŒã«ãçµã¿ç«ãŠãâ
@dataclass(frozen=True)class Permission: """å
šã¢ãžã¥ãŒã«ã®æš©éã® 1 ä»¶ãã¢ãžã¥ã©ã¢ããªã¹ã§ã¯åã¢ãžã¥ãŒã«ã® Permission ããããã€ã¯ããµãŒãã¹ã§ã¯ JSON ããäœãã
tenant/permission/rbac.py ã® Permission (tenant èªèº«ã®æš©éã® Enum) ãšã¯å¥ç©ã1 ã€ã®ãã¡ã€ã«ã§äž¡æ¹ã¯ import ããªã """
value: str # ããªãœãŒã¹.æäœã # æ¢å®ã®ããŒã«ã®ååãowner ã¯æžããªã (ãã¹ãŠã®æš©éãæã€) default_roles: frozenset[str]
# tenant/domain/model/permission/permission_catalog.py
class PermissionCatalog(abc.ABC): """å
šã¢ãžã¥ãŒã«ã®æš©éã®äžèЧãã¢ãžã¥ã©ã¢ããªã¹ã§ã¯ãèµ·åæã® CompositeModule.permissions ããäœã"""
@abc.abstractmethod def permissions(self) -> list[Permission]: ...
# tenant/port/adapter/service/permission/http_permission_catalog.py (ãã€ã¯ããµãŒãã¹)
class HttpPermissionCatalog(PermissionCatalog): def refresh(self, service: str, url: str, *, prune: bool) -> None: """service ã®æš©éããæ°ããçã® url ããåã蟌ããCI ããããã€ã®äžã§ 2 ååŒã¶ã
ãã©ãã£ãã¯ãæµãå㯠prune=False ã§è¶³ãã ãã«ããæµããåŸã« prune=True ã§ãæ°ããçã«ç¡ãæš©éãèœãšã """ permissions = self.__client.get(f"{url}/internal/permissions") # éãªã£ãæš©éãç¥ããªãæ¢å®ã®ããŒã«ãããã°ãåã蟌ãŸãã«æ¢ãã (CI ãèœã¡ã) validate(permissions, self.__repository.all_except(service)) # åããªãã£ãã»æ¢ãããšã㯠DB ãæžãæããªããæ¶ãããšæ±ããšãã«ã¹ã¿ã ããŒã«ãããèœã¡ãå
šå¡ããã®æš©éã倱ã if prune: self.__repository.replace(service, permissions) else: self.__repository.merge(service, permissions)
@override def permissions(self) -> list[Permission]: return self.__repository.all()
# tenant/domain/model/role/role.py
# owner ã¯ãã¹ãŠã®æš©éãæã€ã®ã§ã宣èšã«ã¯æžããªãBUILT_IN_ROLE_NAMES = ("admin", "member")
@dataclass(frozen=True)class Role: """æš©éã®éåãæ¢å®ã®ããŒã« (åºå®) ãã«ã¹ã¿ã ããŒã« (åç) ããåãåœ¢ã§æã€"""
id: RoleId # æ¢å®ã®ããŒã«ã¯åå (ownerã»adminã»member)ãã«ã¹ã¿ã ããŒã«ã¯ UUID name: str permissions: frozenset[str] # æš©éã®å€ãããŒã¯ã³ã«ãã®ãŸãŸèŒãã
def covers(self, other: Role) -> bool: """other ã®æš©éããã¹ãŠæã€ããããŒã«ãä»ããã»äœããšãã«ç¢ºãããæš©éã®ææ Œãé²ã""" return other.permissions <= self.permissions
@staticmethod def built_in(permissions: list[Permission]) -> list[Role]: """æ¢å®ã®ããŒã«ããå
šã¢ãžã¥ãŒã«ã®å®£èšããçµã¿ç«ãŠããDB ã«ã¯å
¥ããªã""" owner = Role( RoleId("owner"), "owner", frozenset(permission.value for permission in permissions), ) return [owner] + [ Role( RoleId(name), name, frozenset( permission.value for permission in permissions if name in permission.default_roles ), ) for name in BUILT_IN_ROLE_NAMES ]
@staticmethod def custom( role_id: RoleId, name: str, stored: frozenset[str], permissions: list[Permission], ) -> Role: """ã«ã¹ã¿ã ããŒã«ã DB ããçµã¿ç«ãŠããäžèЧã«ç¡ãæš©é (æ¶ããæš©é) ã¯èœãšã""" return Role( role_id, name, stored & frozenset(permission.value for permission in permissions), )⢠tenant: å éšéä¿¡ããŒã¯ã³ãçºè¡ãã
Section titled â⢠tenant: å éšéä¿¡ããŒã¯ã³ãçºè¡ããâ
class TokenApplicationService: def issue(self, id_token: str, tenant_id: str) -> str: """IDaaS ã®ããŒã¯ã³ããéžãã§ããããã³ãã®æš©éã®éåãèŒããå
éšéä¿¡ããŒã¯ã³ã«æ¿ãããå
¥å£ (BFF) ãåŒã¶""" # IDaaS ããåãåãã®ã¯ãŠãŒã¶ãŒ ID ã ã user_id = self.__identity_provider.verify(id_token) membership = self.__membership_repository.membership_of( TenantId(tenant_id), user_id ) if membership is None: raise SystemException( ErrorCode.PERMISSION_DENIED, f"tenant_id={tenant_id} user_id={user_id.value}", ) # æ¢å®ã®ããŒã«ã¯ PermissionCatalog ãããã«ã¹ã¿ã ããŒã«ã¯ DB ãã role = self.__role_repository.role_of(membership.role_id) # æ¶ããã«ã¹ã¿ã ããŒã«ãä»ãããŸãŸã®ãšããã500 ã«ããæåŠãã if role is None: raise SystemException( ErrorCode.PERMISSION_DENIED, f"role_id={membership.role_id.value}" ) return self.__token_signer.sign( # éžãã§ããããã³ãã®åã ãèŒããæå±ããããã³ãã®æ°ã§ããŒã¯ã³ã倧ãããªããªãããã«ãã { "sub": user_id.value, "tenant_id": tenant_id, "permissions": sorted(role.permissions), }, # çãã»ã©ããŒã«ã®ä»ãæ¿ããæ©ãå¹ã (ãªã¢ã«ã¿ã€ã æ§)ãé·ãã»ã© tenant ã«åãåãããã«æžã (èªå·±å®çµæ§) expires_in=timedelta(minutes=5), )⣠åã¢ãžã¥ãŒã«: æš©éã®éåã§å€å®ãã
Section titled â⣠åã¢ãžã¥ãŒã«: æš©éã®éåã§å€å®ããâã«ãŒãã®é (GetCurrentUser) ãšãæš©éã®éåãåãããŒã (PermissionSource) 㯠fastship-py ã«è¶³ããéã¯ãpath ã® tenant_id ã®ããã³ãã«æå±ããŠããªããã° 404 (ããã³ããããããšãäŒãã)ãæš©éã®éåã«èŠãæš©éãç¡ããã° 403 ã§æåŠãããæ§æã§æ¿ããã®ã¯ PermissionSource ã®å®è£
ã ãã§ãã«ãŒãã¯å€ãããªãã
- ã¢ãžã¥ã©ã¢ããªã¹: IDaaS ã®ããŒã¯ã³ã確ãããtenant ã¢ãžã¥ãŒã«ããåãããã»ã¹ã®äžã§åã
- ãã€ã¯ããµãŒãã¹: å
éšéä¿¡ããŒã¯ã³ã tenant ã®å
¬ééµ (JWKS) ã§ç¢ºãããã¯ã¬ãŒã ããåããpath ã®
tenant_idãã¯ã¬ãŒã ãšéãã°ãæå±ããŠããªããšããšåãã 404 ã§æåŠãã
@router.delete("/{tenant_id}/projects/{project_id}")def delete_project( project_id: str, current_user: Annotated[ CurrentUser, Depends(GetCurrentUser(Permission.PROJECT_DELETE)) ],) -> None: # éã確ãããã®ã¯ãtenant_id ã®ããã³ãã§ããã®æš©éãããããã ãã # ãããžã§ã¯ãã¯å¿
ã current_user.tenant_id ã§çµã£ãŠåã (ã»ãã®ããã³ãã®ãããžã§ã¯ãã® ID ãæå®ãããŠãæ¶ããªã) ...