Đăng nhập và quyền sử dụng Kit

Tách authentication khỏi entitlement của Kit, xác minh tài khoản đang dùng và làm mới credential mà không làm lộ secret.

Dùng trang này khi đăng nhập thất bại, hiển thị sai tài khoản hoặc đã đăng nhập nhưng không thể cài Kit.

Kiểm tra danh tính trước quyền sử dụng

ak whoami --json
ak licenses --json

Hai lệnh thực hiện cùng một truy vấn entitlement hiện hành. ak whoami nhấn mạnh tài khoản đang hoạt động; ak licenses trình bày cùng các grant theo từng Kit với wording tập trung vào Kit. Danh tính tài khoản và grant của Kit vẫn là hai fact riêng cần xác minh.

Kết quả chưa authentication từ ak whoami --json không phải lỗi lệnh: lệnh báo data.authenticated: false và thoát 0. Hãy đọc payload thay vì chỉ dựa vào mã thoát. Nếu tài khoản đúng nhưng Kit không có trong ak licenses, cài lại không thể thêm entitlement; hãy dùng tài khoản đã nhận Kit hoặc liên hệ hỗ trợ.

Đăng nhập lại

Đăng nhập bằng email bắt đầu luồng OTP:

ak login --email you@example.com

Với user API key từ web profile:

ak login --api-key ak_live_... --no-interactive

Không bao giờ đặt API key thật vào shell history, source control, ảnh chụp hoặc gói hỗ trợ. Đăng nhập bằng API key lưu private key cục bộ để xác thực lại; hãy bảo vệ khóa đó như một credential.

Nếu CLI session cục bộ đã cũ, chỉ xóa session đó rồi đăng nhập lại:

ak logout
ak login --email you@example.com
ak whoami --json
ak licenses --json

ak logout idempotent và thoát 0 khi không có CLI session. Lệnh xóa credential CLI cục bộ trước nhưng giữ nguyên paid App device session. Với session email có thể gia hạn, việc thu hồi từ xa là best-effort; registry không truy cập được không khiến CLI vẫn đăng nhập cục bộ.

Session cũ không có credential có thể gia hạn yêu cầu bạn đăng nhập lại. CLI nhận ra tình trạng này ngay cả khi lỗi khác bọc lỗi authentication và thêm hướng dẫn đăng nhập dành cho người dùng. CLI không tự thử lại thao tác hay fallback sang đăng nhập bằng API key; hãy đăng nhập rồi tự chạy lại lệnh. Trong quá trình cập nhật, lỗi gốc vẫn được truyền rõ ràng cùng hướng dẫn thay vì bị che mất.

Kích hoạt App là kiểm tra khác

ak login --license-key ak_license_... --no-interactive kích hoạt App device session. Nó không thay thế truy vấn entitlement hiện hành mà ak licenses dùng cho Kit. App license hợp lệ, đăng nhập CLI thành công và quyền dùng paid Kit là các trạng thái tài khoản có liên quan, nhưng trạng thái này không chứng minh trạng thái khác.

Lỗi mạng hoặc registry

Chạy kiểm tra sức khỏe có dùng mạng rồi so sánh với chế độ offline:

ak doctor --json
ak doctor --offline --json

Nếu chỉ lần chạy có mạng thất bại, hãy kiểm tra proxy, DNS, TLS và khả năng truy cập registry. Không chuyển kênh hoặc ghi đè registry như cách sửa đăng nhập thông thường. Lỗi stored session hoặc truy vấn registry thoát 1; flag không hợp lệ thoát 2.

Nếu vẫn thất bại

Export bằng chứng đã che dữ liệu nhạy cảm:

ak diagnostics export --json > agentkit-diagnostics.json

Xem lại tệp trước khi chia sẻ. Không đính kèm session file, OTP, API key hoặc license key.