# Giấy phép offline

> Tệp giấy phép của bản tự host - nội dung, cách gắn bằng Secret, các trạng thái và ý nghĩa, ân hạn, chế độ chỉ đọc không khóa dữ liệu, gia hạn, lệnh license-status và chỉ số dx_license_days_left.

Bản tự host dùng **giấy phép offline**: một tệp `license.json` DataxLand cấp theo hợp đồng. Bản cài kiểm chữ ký của tệp bằng khóa
công khai có sẵn trong ảnh, **không gọi về DataxLand** và chạy được trong mạng kín.

## Nội dung tệp

Tệp JSON gồm định dạng (`dataxland-license/1`), mã khóa ký, phần nội dung và chữ ký số. Phần nội dung ghi:

| Trường | Ý nghĩa |
| --- | --- |
| `license_id` | Mã giấy phép |
| `customer` | Tên khách hàng |
| `edition`, `plan` | Phiên bản và gói (Doanh nghiệp) |
| `limits.workspaces` | Số workspace tối đa; `null` là không giới hạn |
| `limits.seats` | Số người dùng tối đa; `null` là không giới hạn |
| `features` | Danh sách tính năng theo hợp đồng, hiện ở trang quản trị |
| `issued_at`, `not_before`, `expires_at` | Ngày cấp, ngày bắt đầu hiệu lực, ngày hết hạn |
| `grace_days` | Số ngày ân hạn sau khi hết hạn, mặc định 30 |
| `deployment` | `selfhost` |

Sửa phần nội dung làm chữ ký sai và giấy phép thành không hợp lệ. Cần đổi giới hạn hay thời hạn, liên hệ DataxLand
để nhận tệp mới.

## Gắn giấy phép

```bash
kubectl -n dataxland create secret generic dataxland-license --from-file=license.json=./license.json
```

```yaml
license:
  existingSecret: dataxland-license
  key: license.json      # tên khóa trong Secret chứa tệp
```

Chart gắn tệp chỉ đọc vào `/etc/dataxland/license/license.json` của `api`, `worker` và `mcp`. Cài khi chưa có giấy phép thì
Helm in cảnh báo kèm lệnh tạo Secret và nâng cấp.

## Trạng thái

Bản cài kiểm giấy phép lúc khởi động, rồi lại **mỗi giờ** và **mỗi khi tệp đổi**.

| Trạng thái | Khi nào | Bản cài |
| --- | --- | --- |
| `valid` | Trong thời hạn | Hoạt động đủ, áp giới hạn workspace và người dùng |
| `grace` | Đã hết hạn, còn trong ân hạn | Như `valid`; trang quản trị hiện cảnh báo |
| `expired` | Hết cả ân hạn | Chỉ đọc |
| `not_yet_valid` | Chưa tới `not_before` | Chỉ đọc |
| `invalid` | Sai định dạng, sai chữ ký, khóa ký lạ, không dành cho bản tự host | Chỉ đọc |
| `missing` | Chưa gắn tệp | Chỉ đọc |

### Chế độ chỉ đọc

Chế độ chỉ đọc **không khóa dữ liệu của bạn**:

- Vẫn chạy: dashboard, hỏi Si, MCP, xuất dữ liệu, đăng nhập.
- Bị chặn: tạo workspace, mời người dùng, chạy build hoặc làm mới dữ liệu. API trả lỗi 402 mã `license_inactive`.

Dữ liệu dừng ở lần build cuối cùng cho tới khi có giấy phép hợp lệ.

### Giới hạn

- **Workspace**: đếm các workspace đang hoạt động trên toàn bản cài, gồm cả workspace mẫu.
- **Người dùng**: đếm các tài khoản chưa bị khóa trên toàn bản cài.

Đạt giới hạn thì không tạo thêm workspace hoặc không mời thêm người (lỗi 402 mã `license_limit`); những gì đang có vẫn dùng bình
thường. Khóa tài khoản không còn dùng sẽ giải phóng chỗ.

## Xem trạng thái

Trong ứng dụng: **Quản trị → Vận hành**, mục **Triển khai và giấy phép** hiện khách hàng, mã giấy phép, ngày hết hạn, số ngày
còn lại (gồm ân hạn), mức dùng so với giới hạn và danh sách tính năng.

Từ dòng lệnh:

```bash
kubectl -n dataxland exec deploy/dataxland-worker -- python -m pipelines.cli license-status
```

Lệnh in JSON gồm trạng thái giấy phép, mức dùng, chế độ cách ly, và trả mã thoát 1 khi giấy phép không còn hiệu lực, nên dùng
được trong script kiểm tra.

## Theo dõi hạn

`api` xuất chỉ số Prometheus `dx_license_days_left`: số ngày còn lại tới khi chuyển sang chỉ đọc (gồm ân hạn), nhãn `state`
là trạng thái hiện tại. Ví dụ luật cảnh báo:

```yaml
- alert: DataxLandLicenseExpiring
  expr: dx_license_days_left < 45
  for: 1h
  annotations:
    summary: Giấy phép DataxLand còn dưới 45 ngày; liên hệ DataxLand để gia hạn
```

## Gia hạn

1. Liên hệ DataxLand để nhận tệp giấy phép mới.
2. Thay nội dung Secret:

   ```bash
   kubectl -n dataxland create secret generic dataxland-license \
     --from-file=license.json=./license.json --dry-run=client -o yaml | kubectl apply -f -
   ```

3. Kubernetes cập nhật tệp đã gắn vào pod sau ít phút; bản cài thấy tệp đổi và đọc lại, **không cần khởi động lại**. Kiểm bằng
   `license-status` hoặc trang quản trị.

## Liên quan

- [Cài bằng Helm](/vi/docs/self-host/helm)
- [Chế độ cách ly mạng](/vi/docs/self-host/airgapped)
- [Gói Doanh nghiệp](/vi/enterprise)
