AM
ZH-TW
免費開始
選單
類型

成員關係

使用者與帳戶之間含角色資訊的關聯,用於存取控制。

membership roles access-control permissions

成員關係

Membership 將使用者以特定角色連結到帳戶。使用者可同時在多個帳戶擁有 memberships,且角色可不同。

Schema

interface Membership {
  id: string; // "mbr..." - Unique identifier
  user_id: string; // User who has membership
  account_id: string; // Account membership is in
  role: MembershipRole;
}

type MembershipRole = "owner" | "member" | "viewer";

屬性

屬性型別說明
idstring帶有 mbr 前綴的 KSUID
user_idstring使用者參照
account_idstring帳戶參照
roleenum權限層級

角色

角色權限說明
owner完整權限,可管理成員與刪除帳戶
member可讀寫資源
viewer唯讀存取

多帳戶存取

User (uid_123)
├── Membership → Account A (role: owner)
├── Membership → Account B (role: member)
└── Membership → Account C (role: viewer)

Token Claims

存取帳戶時,token 會包含:

{
  "uid": "uid_123",
  "acc": "acc_A",
  "role": "owner"
}

範例

{
  "id": "mbr_2kHfPZcN9xW4mE8RtY7vB",
  "user_id": "uid_1jGePYbM8wV3lD7QsX6uA",
  "account_id": "acc_3lIfQZdO0yX5nF9SuY8wC",
  "role": "member"
}

相關