Vai trò

const roles = await openemail.roles.list()const role = await openemail.roles.get('role_…') const support = await openemail.roles.create({  name: 'Support',  description: 'Answers the shared inboxes and nothing else.',  permissions: ['emails:send', 'threads:write', 'labels:write'],}) console.log(support.permissions) await openemail.roles.update(support.id, {  permissions: [...support.permissions, 'templates:read'],}) await openemail.roles.delete(support.id, { reassignTo: 'role_…' }) const vocabulary = await openemail.roles.listPermissions()

support.permissions chứa sáu mục, không phải ba: emails:send kéo theo emails:read, threads:write kéo theo threads:read và labels:write kéo theo labels:read. Hãy đọc lại danh sách thay vì phỏng đoán.

Vai trò cho biết một người được phép LÀM gì. Họ được làm điều đó với những ĐỊA CHỈ nào là trục còn lại, và nằm ở openemail.members. Xem grantAddress và revokeAddress ở đó. “Được gửi thư” và “được gửi với tư cách invoices@” là hai câu khác nhau, và một không gian làm việc thuê thêm nhân viên hỗ trợ thứ hai sẽ thay đổi câu thứ hai mà không động đến câu thứ nhất.

Hãy rẽ nhánh theo editable và deletable thay vì theo tên của builtin. Cả hai chỉ là false đối với riêng vai trò chủ sở hữu, vốn có danh sách là “mọi quyền, kể cả những quyền được tạo ra vào năm sau” và được tính toán chứ không được lưu trữ; mọi vai trò khác đều trả về true cho cả hai, kể cả năm vai trò được khởi tạo sẵn cho một không gian làm việc. Một vai trò đã bị ai đó đổi tên vẫn trả lời đúng cả hai, còn tên của nó thì không còn cho bạn biết điều gì.

Một khóa được cấp gắn với một vai trò chỉ có thể thực hiện các scope của chính nó GIAO với các quyền của vai trò đó, được xác định theo từng yêu cầu tại ranh giới. Vì vậy, việc thu hẹp một vai trò sẽ thu hồi quyền của các khóa ngay lập tức mà không cần xoay vòng khóa nào, còn một khóa không có vai trò thì hoàn toàn không có giới hạn trên, khiến vai trò null trở thành trạng thái rộng nhất mà một khóa có thể có, chứ không phải hẹp nhất.

Đó cũng là lý do roles.delete bắt buộc phải có nơi để chuyển các khóa sang. Để chúng mồ côi sẽ xóa bỏ hoàn toàn giới hạn trên của chúng, âm thầm nâng quyền mọi thông tin xác thực mà vai trò đó đang giới hạn.