# Đăng nhập một lần (SSO)

> Cho nhân viên đăng nhập DataxLand bằng tài khoản công ty qua Microsoft Entra ID, Google Workspace, Okta hoặc IdP OIDC / SAML 2.0; xác minh domain bằng DNS, tự cấp tài khoản và bắt buộc SSO.

SSO có ở gói **Doanh nghiệp**. Chủ sở hữu workspace cấu hình ở **Cài đặt → Bảo mật**.

## Cách hoạt động

- Kết nối SSO thuộc workspace chính của công ty, còn danh tính đi theo **domain email**: ai có email `@congty.vn` (domain đã xác
  minh) đăng nhập qua IdP của công ty, dù họ thuộc workspace nào.
- Hỗ trợ **OpenID Connect** (khuyến nghị: Entra ID, Google Workspace, Okta, Keycloak, Auth0…) và **SAML 2.0** (SP-initiated).
  DataxLand kiểm chữ ký `id_token` bằng khóa công khai của IdP, chữ ký SAML bằng chứng chỉ bạn dán vào (không tin chứng chỉ đi kèm
  thông điệp), cùng issuer, audience, hạn dùng và mã chống phát lại.
- **Tự cấp tài khoản (JIT)**: người thuộc domain đăng nhập lần đầu được tạo tài khoản và vào workspace với **vai trò mặc định**
  (có thể là vai trò tùy chỉnh). Tắt JIT thì chỉ người đã có tài khoản hoặc đã được mời mới vào được.

## 1. Tạo ứng dụng ở IdP

| IdP | Giao thức | Redirect / ACS | Issuer nhập vào DataxLand |
|---|---|---|---|
| Microsoft Entra ID | OIDC (App registrations → Web) | Redirect URI hiện ở trang Bảo mật | Directory (tenant) ID — DataxLand tự ghép `https://login.microsoftonline.com/<id>/v2.0` |
| Google Workspace | OIDC (Google Cloud → Credentials → OAuth client ID, Web) | Redirect URI | tự điền; nhập domain Google Workspace để chỉ nhận tài khoản công ty |
| Okta | OIDC (Applications → Web) hoặc SAML | Redirect URI hoặc ACS URL + Entity ID | Okta domain (vd. `congty.okta.com`) |
| IdP khác | OIDC hoặc SAML 2.0 | như trên | Issuer URL (https) |

Với SAML: tắt mã hóa assertion, chọn NameID dạng email (hoặc gửi thuộc tính `email`), tải chứng chỉ ký (X.509) dán vào DataxLand.
Metadata của DataxLand (SP) ở địa chỉ **Metadata của DataxLand** trên trang Bảo mật.

## 2. Xác minh domain

Thêm domain, rồi tạo ở DNS một bản ghi **TXT** tên `_dataxland.<domain>` với giá trị hiện trên trang (dạng
`dataxland-verification=…`). Bấm **Kiểm tra DNS**; DNS có thể mất vài phút đến vài giờ. Domain email công cộng (gmail.com,
outlook.com…) không dùng được. Một domain chỉ thuộc một workspace.

## 3. Bắt buộc SSO

Sau khi đã có domain xác minh và **một lần đăng nhập SSO thành công**, bật **Bắt buộc SSO**: người dùng của domain không đăng nhập
bằng mật khẩu hoặc Google được nữa, không tự đăng ký, không đặt lại mật khẩu. **Tài khoản phá kính** (tối đa 3, phải bật xác
thực hai lớp) vẫn đăng nhập bằng mật khẩu khi IdP gặp sự cố.

**Tin MFA của IdP**: bật khi IdP đã bắt buộc MFA; phiên SSO khi đó thỏa yêu cầu "bắt buộc 2FA" của workspace.

## Khi nhân viên nghỉ việc

Khóa tài khoản ở IdP thì họ không đăng nhập mới được. Phiên đang mở sống tối đa tới khi hết hạn (7 ngày không dùng); muốn chặn ngay,
xóa họ khỏi workspace ở **Thành viên & vai trò**. Đồng bộ tự động từ IdP (SCIM) sẽ có sau.

Mọi thay đổi cấu hình, domain, đăng nhập SSO, cấp tài khoản tự động và đăng nhập phá kính được ghi vào
[nhật ký kiểm toán](/vi/docs/workspace/audit-log).
