Trong quá trình sử dụng EzyPlatform, mỗi tài khoản Admin được cấp một Access Token để xác thực khi gọi API hoặc thực hiện các thao tác yêu cầu quyền truy cập đặc biệt.
Thông thường, Access Token có thời hạn sử dụng nhất định. Khi token hết hạn, Admin sẽ phải đăng nhập lại hoặc tạo token mới để tiếp tục làm việc
Để giảm thao tác thủ công và đảm bảo hệ thống hoạt động liên tục, EzyPlatform cung cấp tính năng Tự động gia hạn Access Token cho Admin.
Khi được kích hoạt, hệ thống sẽ tự động theo dõi và gia hạn token trước khi hết hạn, giúp Admin luôn duy trì trạng thái đăng nhập và truy cập API ổn định.

Lợi ích của tính năng

Khi bật tính năng tự động gia hạn token:
  • Không cần tạo lại token thủ công khi token sắp hết hạn.
  • Giảm nguy cơ gián đoạn kết nối API.
  • Đảm bảo các tác vụ tự động hoạt động liên tục.
  • Hạn chế lỗi xác thực do token hết hạn.
  • Tiết kiệm thời gian quản trị hệ thống.

Cách kích hoạt tự động gia hạn token

Screenshot 2026-06-02 164903.png
Tại trang thông tin Admin Profile, bạn sẽ thấy tùy chọn:
  • Cho phép tự động gia hạn access token
Khi tích chọn tùy chọn này:
  • Hệ thống đánh dấu token được phép gia hạn tự động.
-Token sẽ được đưa vào danh sách theo dõi của trình gia hạn.
  • Không cần thực hiện thêm thao tác thủ công.

Trình làm mới Admin Access Token

Để quá trình gia hạn diễn ra tự động, EzyPlatform cung cấp một dịch vụ nền có tên: Trình làm mới admin access token
Dịch vụ này có nhiệm vụ:
  1. Quét các token được phép tự động gia hạn.
  2. Kiểm tra thời hạn sử dụng của từng token.
  3. Phát hiện các token sắp hết hạn.
  4. Gia hạn hoặc tạo token mới theo cấu hình hệ thống.
  5. Cập nhật lại thông tin token trong cơ sở dữ liệu.
Quá trình này hoàn toàn tự động và không yêu cầu người dùng can thiệp.

Các nút điều khiển

Screenshot 2026-06-02 165109.png
Trong phần Cài đặt thường, bạn có thể quản lý trình làm mới token bằng các nút sau:
  • Dừng: Dừng dịch vụ làm mới token.
Khi dịch vụ bị dừng:
  • Hệ thống không kiểm tra token.
  • Token sẽ không được gia hạn tự động.
  • Các token có thể hết hạn theo thời gian.
Chỉ nên sử dụng khi cần bảo trì hoặc kiểm tra hệ thống.
  • Khởi động lại: Khởi động lại dịch vụ làm mới token.
Nên sử dụng khi:
  • Vừa thay đổi cấu hình.
  • Vừa cập nhật hệ thống.
  • Muốn làm mới trạng thái hoạt động của trình gia hạn.

Cách thức hoạt động

Quy trình hoạt động của tính năng như sau:
flowchart TD
    A[Admin tạo Access Token]
    B[Bật Cho phép tự động gia hạn]
    C[Trình làm mới Access Token theo dõi]
    D[Kiểm tra thời hạn token định kỳ]
    E{Token sắp hết hạn?}
    F[Tiếp tục theo dõi]
    G[Gia hạn token]
    H[Cập nhật thời gian token]
    
    A --> B
    B --> C
    C --> D
    D --> E
    E -- Không --> F
    E -- Có --> G
    G --> H
    H --> F

Khi nào nên bật tính năng này?

Nên bật trong các trường hợp:
  • Hệ thống sử dụng API thường xuyên.
  • Có các tác vụ nền (background jobs).
  • Có ứng dụng bên ngoài kết nối tới EzyPlatform.
  • Muốn duy trì phiên làm việc dài hạn.
  • Hạn chế việc đăng nhập hoặc cấp lại token nhiều lần.

Một số lưu ý

  • Chỉ những token được bật Cho phép tự động gia hạn access token mới được hệ thống xử lý.
  • Nếu Trình làm mới admin access token bị dừng, việc gia hạn sẽ không diễn ra.
  • Việc xóa token sẽ hủy toàn bộ cơ chế gia hạn cho token đó.
  • Nên kiểm tra định kỳ trạng thái của trình làm mới token để đảm bảo dịch vụ luôn hoạt động.

Tóm lại

Tính năng Tự động gia hạn Access Token cho Admin giúp duy trì quyền truy cập liên tục mà không cần can thiệp thủ công. Khi kết hợp với Trình làm mới admin access token, hệ thống sẽ tự động theo dõi, gia hạn và cập nhật token khi cần thiết, giúp các API, dịch vụ nền và tác vụ quản trị hoạt động ổn định, giảm thiểu rủi ro gián đoạn do token hết hạn.