Tổ chức và chỗ ngồi
Cách bước thiết lập lần đầu tạo tổ chức của bạn, cách lời mời đưa người vào, và chỗ ngồi của mỗi người mang những gì.
Mỗi bản triển khai chỉ có một tổ chứcTổ chứcOrganisationKhông gian của công ty bạn trong portal. Mỗi bản triển khai chạy một tổ chức, trong chính tài khoản AWS của bạn.Mở trong Thuật ngữ. Bước thiết lập lần đầu tạo ra tổ chức đó, và mọi người dùng được portal đều có một chỗ ngồi (seat) trong tổ chức. Chỗ ngồi là thứ portal đọc ở mọi yêu cầu.
Quy tắc chính
- Mỗi bản triển khai một tổ chức. Bước thiết lập lần đầu tạo tổ chức cùng với chỗ ngồi của owner.
- Mỗi người một chỗ ngồi. Chỗ ngồi mang phòng ban, vai trò của người đó và việc họ có đang bị tạm khóa hay không.
- Lời mời phải khớp với địa chỉ đăng nhập. Khi chấp nhận, chỗ ngồi được ghi vào đúng tài khoản mà người đó đã đăng nhập.
- Không có chỗ ngồi thì không có quyền truy cập. Tài khoản không có dòng trong danh bạ sẽ bị từ chối.
Thiết lập lần đầu
Một bản triển khai mới chưa có tổ chức nào và chưa ai đăng nhập được. Người đầu tiên đăng ký, ở đây là Carol, sẽ tạo tổ chức. Hướng dẫn cho quản trị viên có ở Trình hướng dẫn thiết lập lần đầu.
-
Carol đăng ký và đăng nhập
Carol đăng ký tại Keycloak rồi đăng nhập. Token của cô chỉ nêu tên cô, chưa gắn với tổ chức nào.
-
Bước thiết lập hỏi hai câu
Tên tổ chức mà cô sẽ làm chủ, và người trong tổ chức sẽ đăng nhập ngay tại đây hay qua nhà cung cấp của công ty như Entra ID hoặc Okta.
-
Một yêu cầu tạo tất cả
Yêu cầu này tạo tổ chức và chỗ ngồi của Carol, ghi tổ chức và vai trò owner vào tài khoản của cô, rồi đăng ký nhà cung cấp trong Keycloak.
-
Đi qua Keycloak thêm một lần
Trình duyệt đi qua Keycloak thêm một lần để token của cô có tên tổ chức. Nếu thiếu bước này, mọi lời gọi sau đó đều trả 401.
Khi chưa có chỗ ngồi, người dùng chỉ được trả lời trên khu vực đăng ký:
| Phiên | Truy cập được |
|---|---|
| Chưa có chỗ ngồi | Chỉ khu vực đăng ký: ai đang đăng ký, một địa chỉ còn trống hay không, các route tạo và tham gia, và việc cấp thông tin xác thực cho SCIM (chỉ trả lời owner) |
| Đã có chỗ ngồi | Bị khu vực đăng ký từ chối, được trả về danh sách lời mời đang chờ, và được đưa về lại portal |
Khi bước thiết lập gặp sự cố
- Không đăng ký được nhà cung cấp. Keycloak và issuer của nhà cung cấp được kiểm tra khi địa chỉ vẫn còn trống, nên yêu cầu thất bại mà không ghi gì cả.
- Tổ chức đã được tạo, sau đó đăng ký nhà cung cấp thất bại. Tổ chức vẫn còn và đã có chủ. Hãy hoàn tất nhà cung cấp trong thiết lập tổ chức sau khi đăng nhập.
- Trang bị tải lại. Bước thiết lập vẫn giữ nguyên khi tải lại và không cho quay lui một khi đã ghi bất cứ thứ gì. Bước hiện tại được xác định từ các chỗ ngồi trong danh bạ.
Thông tin xác thực cho SCIM
Việc tạo tổ chức cũng sinh ra một thông tin xác thực OAuth để cấp tài khoản qua SCIM. Secret của nó chỉ hiện một lần. Khi bước thiết lập tiếp tục sau lúc tải lại, màn hình hiện client identifier, báo rằng secret không còn xem được và đề nghị tạo secret khác. Không có gì được cấp lại tự động khi vào trang, vì cấp secret mới sẽ làm mất hiệu lực secret mà nhà cung cấp đang giữ. Chi tiết ở Cấp tài khoản qua SCIM › Thông tin xác thực của connector.
Lời mời
Người muốn tham gia tổ chức sẽ đăng ký, đăng nhập rồi mở lời mời. Khi chấp nhận, chỗ ngồi đã hứa được ghi vào đúng tài khoản họ đang đăng nhập. Vì vậy địa chỉ trong lời mời phải trùng với địa chỉ đăng nhập, và màn hình từ chối hiển thị lời mời cho bất kỳ tài khoản nào khác.
| Quy tắc | Chi tiết |
|---|---|
| Hai cách vào | Đường link, mang một token và ghi nhận rằng lời mời đã được mở; hoặc màn hình đầu, liệt kê mọi lời mời đang chờ cho địa chỉ đã đăng nhập |
| Quyền được cấp | Quyết định ngay khi viết lời mời: thành viên hoặc quản trị viên, không bao giờ là owner, và một phòng banPhòng banDepartmentĐơn vị chi trả: sở hữu ngân sách, hạn mức và các mô hình mà thành viên được dùng. Mỗi người thuộc đúng một phòng ban.Mở trong Thuật ngữ cụ thể |
| Từ chối | Khác với thu hồi; địa chỉ vẫn có thể được mời lại |
| Link đã dùng | Mở lại sẽ báo như vậy, nhưng chỉ với địa chỉ mà lời mời nêu tên. Mọi lời từ chối khác trông giống hệt nhau, nên không ai dò được lời mời nào đang tồn tại |
| Sau SCIM | Nếu SCIM đã tạo người đó trước, việc chấp nhận sẽ hoàn tất chỗ ngồi ngay tại chỗ, giữ nguyên external id, các trường do nhà cung cấp quản lý, trạng thái và phòng ban |
Khi nhà cung cấp làm chủ danh bạ (chế độ IDP), việc gửi hoặc gửi lại lời mời bị từ chối và mọi người được đưa vào qua SCIM. Vẫn có thể thu hồi một lời mời đang mở. Xem Phòng ban › Chế độ thư mục.
Chỗ ngồi
Chỗ ngồi là một dòng trong danh bạ, định danh theo tổ chức và tài khoản. Mọi bảng có nhắc đến một người đều trỏ đến chỗ ngồi.
| Chỗ ngồi mang | Ý nghĩa |
|---|---|
| Phòng ban | Nhóm chi phí của người đó: đúng một. Xem Phòng ban |
| Vai tròVai tròRoleGói các quyền hạn. Mỗi người có một vai trò có sẵn — Org Owner, Org Admin hoặc Org User — và nhóm có thể cấp thêm vai trò tùy chỉnh.Mở trong Thuật ngữ | Vai trò của người đó trong tổ chức |
| Tạm khóa | Portal có đang tạm khóa người đó hay không |
Ba bản ghi cho biết ai đang hành động, và trong tổ chức nào:
| Bản ghi | Ý nghĩa |
|---|---|
| Phiên backend | Tổ chức mà trình duyệt đang hành động trong đó |
| Token máy | Nêu tên tổ chức và được đối chiếu với một chỗ ngồi như mọi bên gọi khác |
| Bản ghi đăng nhập thay | Quản trị viên đứng sau một phiên đang hành động thay người khác, và thời điểm kết thúc |
Tài khoản thiếu chỗ ngồi bị từ chối khi đăng nhập. Thay đổi về phòng ban, vai trò hay tạm khóa có hiệu lực ngay ở yêu cầu tiếp theo, vì chỗ ngồi được đọc lại mỗi lần. Xem Xác thực yêu cầu.
Phiên đăng nhập thay
Quản trị viên có đúng quyền hạn có thể hành động thay người dùng khác trong một khoảng thời gian giới hạn bằng đăng nhập thayXem dưới tư cách người khácView as someoneXem portal đúng như người khác thấy, để tái hiện sự cố. Cần quyền hạn riêng và được ghi vào nhật ký kiểm toán.Mở trong Thuật ngữ (“View as”); cách bắt đầu, kết thúc và ghi nhật ký có ở Phê duyệt truy cập › Đăng nhập thay.
Vì sao lại như vậy
Vì sao tổ chức và nhà cung cấp được tạo trong cùng một yêu cầu
Lần đi qua Keycloak thứ hai, bước đưa tổ chức vào token, nằm giữa việc tạo tổ chức và mọi thao tác khác mà trình duyệt có thể làm. Vì thế tổ chức và nhà cung cấp được tạo trong cùng một yêu cầu thay vì lần lượt.
Bên trong hệ thống
Yêu cầu tạo tổ chức ghi những gì
- Dòng tổ chức và chỗ ngồi của owner trong danh bạ của portal.
- Tổ chức và vai trò owner trên tài khoản Keycloak của owner, qua Keycloak Admin API.
- Bản đăng ký nhà cung cấp trong Keycloak, qua cùng API đó.
- Thông tin xác thực cho SCIM, với secret chỉ được lưu dưới dạng digest.