Bỏ qua đến nội dung
AI Portal Docs
Trên trang này Thiết lập lần đầu 1/9

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.

  1. 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.

  2. 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.

  3. 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.

  4. Đ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ênTruy cập được
Chưa có chỗ ngồiChỉ 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ồiBị 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ắcChi 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ấpQuyế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ốiKhác với thu hồi; địa chỉ vẫn có thể được mời lại
Link đã dùngMở 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 SCIMNế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 banNhó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óaPortal 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 backendTổ chức mà trình duyệt đang hành động trong đó
Token máyNê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 thayQuả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.

Liên quan

AI Portal Docs
EN VI