Đăng nhập

Cách thường dùng: duyệt trong trình duyệt

webmati login --web --platform webmati

1. CLI in ra một đường link và mở trình duyệt (Approve this machine in the browser). Nếu chưa đăng nhập admin, bạn đăng nhập trước, rồi được đưa về đúng trang này.
2. Trang cho phép CLI hiện tên máy của bạn và website key sẽ dùng. Nếu bạn chưa nói website nào, trang cho bạn chọn trong các website của workspace đang mở (muốn website ở workspace khác thì đổi workspace ở thanh trên cùng).
3. Bấm Cho phép. Key được gửi thẳng về CLI qua 127.0.0.1 trên máy bạn, không nằm trong URL, không hiện trên màn hình. CLI kiểm tra key rồi lưu vào ~/.config/webmati/credentials.json (chỉ tài khoản của bạn đọc được).

CLI chờ tối đa 5 phút.

Chrome hỏi quyền truy cập mạng cục bộ

Chrome (và các trình duyệt cùng nhân) có thể hỏi quyền truy cập thiết bị trong mạng cục bộ khi trang gửi key về CLI. Chọn Cho phép: "thiết bị" ở đây chính là CLI đang chờ trên máy bạn (127.0.0.1). Nếu bạn từ chối, trang báo lỗi và tự thu hồi key vừa tạo; chạy lại lệnh login là được.

Key được làm gì, không được làm gì

Key mang quyền của chính bạn trên website này, như khi bạn dùng MCP: theme, trang, blog, ảnh, sản phẩm, đơn hàng, ngôn ngữ, cài đặt website, backend, tên miền, sao lưu, thống kê… Phần nào vai trò của bạn không có thì key cũng không có, và bạn mất quyền hay rời workspace thì key mất theo.

Key tạo trước ngày 12/10/2026 chỉ mang một danh sách quyền cố định: lệnh bị từ chối với missing scope: … — chạy webmati login --web một lần nữa. Lệnh bị từ chối với permission denied: … nghĩa là chính tài khoản bạn chưa có quyền đó trên website: chủ workspace cấp thêm cho vai trò của bạn.

Key hết hạn sau 30 ngày (mặc định của admin). Đổi bằng --days (1–90):

webmati login --web --platform webmati --days 7

Bạn thu hồi key bất cứ lúc nào trong admin: Cài đặt ▸ API Keys (key của CLI có tên webmati-cli@<tên máy>).

Chọn sẵn website: --store

Bỏ qua bước chọn trên trang bằng cách nói trước website (slug hoặc id):

webmati login --web --platform webmati --store my-shop

Chạy login --web bên trong một project thì không cần --store hay --platform: CLI đọc chúng từ webmati.toml.

Dùng key có sẵn: --key

Cho máy chủ CI hoặc khi không có trình duyệt, dùng một key tạo trong admin (Cài đặt ▸ API Keys). Đưa key qua stdin để nó không nằm lại trong lịch sử shell:

webmati login --key - --platform webmati --store my-shop

Dán key, nhấn Enter. Một key của workspace mở được mọi website trong workspace, nên hãy nói rõ --store. Trong CI, đặt biến môi trường WEBMATI_TOKEN thay cho login: biến này luôn được ưu tiên hơn key đã lưu.

Đăng xuất

webmati logout                                         # trong project: quên key của website này
webmati logout --platform webmati --store 42           # ngoài project: nói website (id)

logout chỉ xoá key khỏi máy. Key vẫn còn hiệu lực đến khi hết hạn hoặc bị thu hồi trong admin.

Nền tảng khác

--platform webmati chọn sẵn địa chỉ API và admin. Với một máy chủ riêng, chỉ định thẳng:

webmati login --web --api https://example.com/graphql --admin https://example.com

Tiếp theo

Lấy project về máy