Hướng dẫn sử dụng ZoCloud Vào ZoCloud

Tổ chức, thành viên và bảo mật tài khoản

Tổ chức

Mọi project, database, tên miền, ví và hoá đơn thuộc về một tổ chức. Khi đăng ký, bạn có một tổ chức cá nhân. Cho công ty hoặc nhóm (mời thành viên, phân quyền, hoá đơn riêng):

  1. Menu tài khoản → Tài khoản → Tạo tổ chức.
  2. Đổi giữa các tổ chức bằng menu Tổ chức ở góc trái.

Mỗi tổ chức có ví, gói và thông tin xuất hoá đơn riêng. Tổ chức bị tạm khoá hiện banner "Tổ chức này đang bị tạm khóa. Vui lòng liên hệ hỗ trợ."

Vai trò

Quyền Chủ sở hữu Quản trị Developer Thanh toán Chỉ xem
Xem project, log, số liệu, mức dùng ✓ ✓ ✓ ✓ ✓
Deploy, đổi biến môi trường, scale, rollback; xem dữ liệu database (chỉ đọc) ✓ ✓ ✓
Tạo/xoá project, database, bucket, tên miền; sửa DNS, Cloudflare; chạy SQL có ghi ✓ ✓
Nạp tiền, đổi gói, hoá đơn; mua tên miền, e-mail ✓ ✓ ✓
Mời và gỡ thành viên ✓ ✓
Lấy mã chuyển tên miền đi, chuyển quyền sở hữu, đóng tổ chức ✓

Chỉ Chủ sở hữu mới phong hoặc bỏ vai trò Chủ sở hữu; tổ chức luôn phải còn ít nhất một Chủ sở hữu.

Mời thành viên

  1. Mục Thành viên → Mời thành viên.
  2. Nhập e-mail, chọn vai trò (Quản trị, Developer, Thanh toán, Chỉ xem), bấm Tạo lời mời.
  3. ZoCloud gửi lời mời qua e-mail và portal hiện đường link mời. Link chỉ hiện một lần, hiệu lực 7 ngày, và chỉ dùng được với đúng e-mail đã mời.
  4. Người được mời đăng nhập (hoặc đăng ký) bằng e-mail đó, xác minh e-mail, rồi bấm Tham gia. Tài khoản chưa xác minh e-mail không nhận được lời mời.

Lời mời chưa nhận hiện đang chờ. Đổi vai trò bằng ô vai trò cạnh tên thành viên; Gỡ để xoá khỏi tổ chức. Tự rời: Rời tổ chức.

Bắt buộc 2FA

Bật Bắt buộc xác thực 2 lớp (2FA) trong mục Thành viên: thành viên chưa bật 2FA không thao tác được trong tổ chức (kể cả bằng API token) cho đến khi bật 2FA trong tài khoản. Danh sách thành viên ghi đã bật 2FA / chưa bật 2FA.

Google Workspace

Thẻ Google Workspace (khi ZoCloud đã bật đăng nhập Google): gắn tổ chức với tên miền Google Workspace của công ty.

  1. Đăng nhập ZoCloud bằng một tài khoản Google Workspace thuộc tên miền đó (để chứng minh tên miền là của bạn).
  2. Chọn ai được tự vào: Không ai tự vào, hoặc người cùng tên miền tự vào với vai trò Developer / Chỉ xem.
  3. Tuỳ chọn Bắt buộc đăng nhập bằng Google.

Bảo mật tài khoản

Menu tài khoản → Tài khoản:

  • Mật khẩu: nhập Mật khẩu hiện tại và Mật khẩu mới. Đổi mật khẩu sẽ đăng xuất các phiên khác.
  • Xác thực hai bước: bấm Bật xác thực hai bước, thêm vào ứng dụng xác thực (Google Authenticator, 1Password…) rồi nhập mã đầu tiên. Từ đó mỗi lần đăng nhập cần mã 6 số.
  • Quên mật khẩu: ở trang đăng nhập bấm Quên mật khẩu? → Gửi liên kết (hiệu lực 1 giờ).

Token truy cập (API token)

Cho zo CLI, CI và AI agent. Menu tài khoản → Tài khoản → Token truy cập:

  1. Nhập Tên và Số ngày hiệu lực, bấm Tạo token.
  2. Sao chép ngay: token chỉ hiện một lần. Token có dạng zc_pat_….
  3. Thu hồi bất cứ lúc nào. Danh sách ghi Dùng lần cuối.

Token có đúng quyền của bạn trong từng tổ chức (theo vai trò). Dùng với API: Authorization: Bearer zc_pat_… tới https://api.zocloud.io/v1.

Hoạt động (nhật ký)

Mục Hoạt động: những gì thành viên, ZoCloud và hệ thống đã làm trong tổ chức, mới nhất trước (deploy, đổi biến, thêm tên miền, đổi gói, chạy truy vấn database…). Lọc theo App, Database, Tên miền, Lưu trữ, Thanh toán, Thành viên. Thao tác của nhân viên ZoCloud ghi Nhân viên ZoCloud. Bấm Cũ hơn để xem thêm.

Thông báo (Slack, Discord, webhook)

Mục Thông báo → Thêm thông báo:

  1. Gửi tới: Slack, Discord hoặc Webhook (HTTPS).
  2. Tên, Địa chỉ webhook (incoming webhook của Slack/Discord, hoặc endpoint HTTPS của bạn, cổng 443 hoặc 8443).
  3. Project: một project hoặc Mọi project.
  4. Sự kiện: Deploy chạy xong, Deploy thất bại, Service dừng đột ngột.
  5. Ngôn ngữ của tin nhắn.

Bấm Gửi thử để kiểm tra; Lịch sử gửi cho biết từng lần gửi.

Webhook của bạn: khi tạo, portal hiện khoá ký (secret) của endpoint, chỉ một lần. Mỗi request có header X-ZoCloud-Timestamp và X-ZoCloud-Signature: sha256=<hex>, với chữ ký là HMAC-SHA256(secret, timestamp + "." + body). Hãy kiểm tra chữ ký và từ chối timestamp cũ.

import crypto from "node:crypto";

function verify(req, rawBody, secret) {
  const ts = req.headers["x-zocloud-timestamp"];
  const sig = req.headers["x-zocloud-signature"];
  const want = "sha256=" + crypto.createHmac("sha256", secret).update(ts + "." + rawBody).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
  return fresh && crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(want));
}

ZoCloud cũng gửi e-mail cho các việc quan trọng: xác minh e-mail, lời mời, biên nhận nạp tiền, gia hạn gói (thành công hoặc chưa), app tạm dừng vì chưa thanh toán, deploy thất bại.

Hỗ trợ (ticket)

Mục Hỗ trợ → Ticket mới:

  1. Chủ đề: Kỹ thuật, Thanh toán, Tài khoản, Báo cáo lạm dụng, Khác.
  2. Tiêu đề và Nội dung: ghi rõ project, service và điều bạn thấy (lỗi, thời điểm). Đừng gửi mật khẩu.
  3. Bấm Gửi ticket.

Bạn nhận e-mail khi có trả lời; trả lời tiếp trong ticket rồi bấm Gửi. Thời hạn phản hồi đầu tiên tuỳ theo gói. Xong việc thì Đóng ticket; ticket đã đóng không mở lại được, hãy mở ticket mới nếu cần.

Trang trạng thái

https://app.zocloud.io/status (không cần đăng nhập) hiện tình trạng hệ thống ("Mọi hệ thống hoạt động bình thường", hoặc mức gián đoạn), các sự cố đang mở, lịch bảo trì và Thông báo trước đây. Sự cố và bảo trì đang diễn ra cũng hiện thành banner trên portal.