MSO Cloud · Documentation

White-label

Source: docs/product/white-label.md Updated 2026-09-21
On this page

Một tổ chức được cấp quyền white-label thì khách của họ gặp trang đăng nhập mang nhận diện của chính tổ chức đó, và báo cáo PDF in tên thương hiệu của tổ chức ở chân trang thay vì tên nền tảng.

Dành cho: người vận hành nền tảng cấp quyền, và quản trị viên tổ chức muốn biết quyền đó mở ra những gì. Điều kiện trước: tài khoản super admin để bật; tổ chức đã có tên miền riêng nếu muốn khách vào bằng tên miền đó.

Một quyền, ba thứ mở ra#

Quyền nằm ở một cờ duy nhất trên tổ chức. Bật cờ đó mở đúng ba thứ:

Mở ra Ai thấy Chặn ở đâu khi chưa bật
Trang đăng nhập riêng của tổ chức khách chưa đăng nhập ngay trong truy vấn tra cứu trang, không chỉ ở giao diện
Xuất bản hoặc quay lui trang đăng nhập đó quản trị viên tổ chức thao tác bị từ chối
Tên thương hiệu trên chân trang PDF người nhận bản PDF chân trang lùi về tên nền tảng

Tab Trang đăng nhập trong Cài đặt của tổ chức cũng chỉ xuất hiện khi quyền đang bật. Mở thẳng đường dẫn khi chưa có quyền thì trang vẫn mở nhưng nói rõ quyền chưa được cấp.

Trang đăng nhập đã xuất bản của một tổ chức bị thu hồi quyền không tới được khách nữa, kể cả khi nội dung vẫn còn nguyên trong cơ sở dữ liệu: điều kiện nằm trong chính truy vấn tra cứu. Thu hồi nhận diện không đòi phải xoá nội dung.

Bật ở đâu#

Quản trị → Tổ chức (/admin/orgs) → mở ngăn của tổ chức → mục White-label.

Công tắc mang nhãn Bật white-label cho tổ chức này, và ngay dưới nó luôn có dòng giải thích: "Mở khoá trang đăng nhập riêng và tên thương hiệu trên chân trang PDF."

Khi công tắc bật, ô Tên trên chân trang PDF xuất hiện — tối đa 120 ký tự, gợi ý "Để trống để dùng tên nền tảng". Bỏ trống thì chân trang lấy tên nền tảng theo thứ tự: tên đặt trong cấu hình chung, rồi tên mặc định của bản dựng.

Ai được làm#

Cả hai thao tác — bật/tắt quyền và đặt tên chân trang — chỉ super admin làm được, và cả hai đều ghi vào nhật ký kiểm toán. Quản trị viên tổ chức không tự bật cho mình được: lược đồ cấu hình trang đăng nhập không nhận trường này, nên một yêu cầu gửi kèm sẽ bị từ chối chứ không bị bỏ qua âm thầm.

Một ngoại lệ có chủ ý: super admin xuất bản hoặc quay lui được trang đăng nhập của một tổ chức chưa có quyền. Trang xuất bản ra vẫn không tới được khách, vì lớp chặn nằm ở truy vấn tra cứu chứ không ở thao tác xuất bản.

Không thuộc quyền này#

Thứ nghe giống Thực ra do đâu quyết định
Tên miền riêng hoặc tên miền phụ của tổ chức cấu hình tên miền, độc lập với quyền này
Bảng màu và mực thương hiệu trong ứng dụng giao diện riêng của tổ chức, độc lập với quyền này
Đăng nhập OIDC hoặc LDAP/AD cấu hình riêng của từng cách đăng nhập

Tên miền và quyền white-label hay bị gộp làm một vì cùng chữ. Chúng tách nhau: một tổ chức có tên miền riêng mà chưa có quyền thì khách vào đúng tên miền đó nhưng gặp trang đăng nhập của nền tảng.

Giới hạn#

  • Tổ chức chọn được tên trên chân trang PDF, không chọn được câu chữ hay đường dẫn đi kèm — hai thứ đó thuộc cấu hình bản triển khai.
  • Không có mức cấp quyền theo từng thứ: không thể mở chân trang PDF mà giữ trang đăng nhập đóng.
  • Quyền được kiểm lại mỗi lần dựng trang và mỗi lần xuất PDF, nên tắt quyền có hiệu lực ngay, không cần dọn dữ liệu đã lưu.

Liên quan#