Điều kiện: đã chọn đúng Project, tài khoản có vai trò Tenant Admin hoặc Editor.

1. Tạo Access Key

1. Vào Configuration > Access Keys, bấm Create.
2. Điền thông tin:

   Trường	Bắt buộc	Mô tả
   Project	—	Project đang chọn, không đổi được
   Key Name	Có	1–64 ký tự: chữ thường a–z, số 0–9, _, -; bắt đầu bằng chữ thường; không trùng tên key khác trong Project. Ví dụ: chatbot_prod
   Key Type	Có	Serving Key (mặc định), CLI Key hoặc Model as a Service Key. Xem Ba loại Access Key
   Select Model	Có, với Model as a Service Key (ít nhất 1)	Chỉ hiện khi chọn Model as a Service Key. Chọn một hoặc nhiều mô hình mà key được phép gọi. Bấm x trên mô hình để bỏ chọn
   Expiration Date	Không	7 days, 30 days, 90 days (tính từ lúc tạo), hoặc một ngày sau hôm nay (key hết hạn lúc 23:59:59 ngày đó). Để trống: key không hết hạn

3. Bấm Generate. Nút chỉ bật khi mọi thông tin hợp lệ.
4. Bấm Copy để sao chép key và lưu ở nơi an toàn, rồi đóng.

⚠️ Quan trọng: Key đầy đủ chỉ hiển thị một lần duy nhất. Sau khi đóng, bạn không xem lại được. Nếu lỡ đóng mà chưa sao chép, hãy Rotate để lấy key mới.

Key mới có trạng thái Active và dùng được ngay.

Gợi ý:

• Đặt tên theo mục đích sử dụng, ví dụ chatbot_prod, laptop_ssh, để dễ nhận ra khi cần thu hồi.
• Mỗi ứng dụng hoặc mỗi máy dùng một key riêng.
• Đặt ngày hết hạn cho key dùng thử hoặc key tạm thời.

2. Sử dụng từng loại key

2.1. Serving Key: gọi Model Serving

1. Khi tạo Model Serving, chọn Serving Key ở ô Access Key.
2. Khi gọi endpoint, gửi key trong header:

   Authorization: Bearer <serving-key>
   

Xem ví dụ gọi API đầy đủ tại Tích hợp API và xử lý sự cố.

2.2. CLI Key: SSH vào GPU VM

1. Cài CLI của nền tảng trên máy bạn (Windows, Linux, macOS). Xem hướng dẫn cài tại GPU VM.
2. Đăng nhập, dán CLI Key khi được hỏi:

   rubick login
   

3. Xem danh sách GPU VM trong Project của key:

   rubick get vms
   

4. Mở SSH vào VM:

   rubick ssh -i <path_to_private_key> <vm_name_or_id>
   

   
   (Tùy chọn) Thêm VM vào cấu hình SSH để mở bằng VS Code Remote-SSH:

   rubick ssh-config <vm_name> --append
   

CLI Key thay cho việc mở IP công khai cho VM: kết nối SSH đi qua nền tảng, VM không cần IP public.

Giới hạn của phiên SSH:

• Phiên tự đóng sau 30 phút không có hoạt động, và tối đa 12 giờ kể từ khi mở.
• Mỗi GPU VM có tối đa 8 phiên SSH cùng lúc.
• Thu hồi hoặc xóa CLI Key sẽ chặn phiên SSH mới. Phiên đang mở không bị ngắt ngay, mà kết thúc theo các giới hạn trên.

2.3. Model as a Service Key: gọi mô hình trong Model Catalog

Cách nhanh nhất là tạo key ngay từ trang mô hình: mở mô hình trong Model Catalog, bấm Generate API Key, form tạo key mở ra với loại key và mô hình đã chọn sẵn.

Bạn có thể chọn thêm mô hình khác cho cùng một key. Key chỉ gọi được các mô hình đã chọn. Xem cách gọi tại Tạo API key và gọi mô hình.

3. Tìm và theo dõi key

Danh sách hiển thị Name, Status, Type, Created At, Expires, Last Used. Key được nhóm theo loại, key mới nhất ở trên.

• Tìm kiếm: gõ vào ô tìm kiếm.
• Làm mới: bấm Refresh để cập nhật danh sách.
• Last Used: cho biết key được dùng lần cuối khi nào. Key lâu không dùng nên được thu hồi.

Danh sách không bao giờ hiển thị giá trị key.

4. Rotate: đổi key mới

Dùng khi bạn làm mất key, nghi key bị lộ, hoặc muốn đổi key định kỳ.

1. Bấm Actions > Rotate Key, rồi xác nhận.
2. Sao chép key mới (chỉ hiển thị một lần).
3. Cập nhật key mới vào ứng dụng hoặc chạy lại rubick login.

Sau khi rotate, key giữ nguyên tên, loại, mô hình và ngày hết hạn. Key cũ sẽ ngừng hoạt động, vì vậy hãy cập nhật key mới vào mọi nơi đang dùng.

Chỉ rotate được key đang Active.

5. Revoke: thu hồi key

Dùng khi muốn ngừng một key nhưng vẫn giữ lại trong danh sách để tra cứu.

1. Bấm Actions > Revoke Key, rồi xác nhận.

Key chuyển sang Revoked và ngừng hoạt động sau khoảng 30 giây. Key đã thu hồi không kích hoạt lại được.

6. Xóa key

1. Bấm Actions > Delete Key.
2. Gõ chính xác tên key vào ô xác nhận.
3. Bấm Delete.

Key bị xóa vĩnh viễn, ngừng hoạt động sau khoảng 30 giây và không khôi phục được.

Trước khi thu hồi hoặc xóa: hãy kiểm tra ứng dụng, Model Serving hoặc máy nào đang dùng key, để tránh gián đoạn.