2FA cho Appwrite: cách thiết lập ứng dụng xác thực cho tài khoản Console

Appwrite có hai loại xác thực đa yếu tố (MFA), và rất dễ mở nhầm trang. Một loại là tính năng bạn tích hợp vào ứng dụng của mình cho người dùng của bạn. Loại kia bảo vệ chính tài khoản nhà phát triển của bạn, tài khoản bạn dùng để đăng nhập Appwrite Console và quản lý các tổ chức, dự án. Hướng dẫn này nói về loại thứ hai (Appwrite). Nếu bạn muốn MFA cho những người dùng ứng dụng của mình, Appwrite trình bày nội dung đó trong tài liệu Auth.

Với tài khoản Console, MFA là tùy chọn. Tài liệu của Appwrite nêu mã theo thời gian từ ứng dụng xác thực (TOTP) là phương thức được hỗ trợ và cho biết sẽ có thêm các yếu tố khác về sau (Appwrite). Chúng tôi dùng Authenticator App - Novaz trên iPhone trong các bước dưới đây, nhưng mọi ứng dụng xác thực đều làm theo cách tương tự.

Cách chúng tôi kiểm tra hướng dẫn này: các bước cho Appwrite lấy từ tài liệu của chính Appwrite và các ảnh chụp màn hình trong đó (có liên kết bên dưới), mà chúng tôi đã đọc vào ngày 21 tháng 10 năm 2026. Chúng tôi chưa thử các bước này trên một tài khoản Appwrite, nên có thể một nhãn hơi khác. Các bước trong Novaz đã được kiểm tra trên ứng dụng, phiên bản 1.0.5.

Bật MFA bằng ứng dụng xác thực

Trang của Appwrite khá ngắn, và phần chữ với ảnh chụp màn hình dùng nhãn hơi khác nhau. Các bước sau theo cả hai (Appwrite):

1. Đăng nhập Appwrite Console. Mở menu tài khoản ở góc trên bên phải và chọn Your account (tài khoản của bạn).
2. Vào cài đặt bảo mật. Trong ảnh chụp màn hình của Appwrite, đó là Security (bảo mật) trong danh sách bên trái, với thẻ Multi-factor authentication (xác thực đa yếu tố) trên trang.
3. Bật công tắc Multi-factor authentication.
4. Thêm ứng dụng xác thực. Phần chữ gọi nút này là Add authentication factor (thêm yếu tố xác thực); ảnh chụp màn hình cho thấy một hàng Authenticator app (ứng dụng xác thực) với nút Add (thêm).
5. Cửa sổ Scan QR code (quét mã QR) mở ra. Trong Novaz, chạm vào +, rồi Quét mã QR, và hướng camera vào mã. Nếu Console đang mở trên chính iPhone đó, hãy chụp ảnh màn hình và dùng Chọn ảnh. Xem cách quét mã QR trên cùng một iPhone.
6. Nếu không quét được, cùng cửa sổ đó có hiển thị Manual entry code (mã nhập thủ công) với một nút sao chép. Trong Novaz, chạm vào +, rồi Nhập khóa thủ công, nhập một tên như Appwrite vào ô Dịch vụ, và dán mã vào ô Khóa cài đặt. Xem Khóa cài đặt 2FA là gì?
7. Chọn Continue (tiếp tục) và nhập mã hiện tại từ Novaz để hoàn tất thiết lập.
8. Lưu các mã khôi phục (phần tiếp theo).

Tài liệu không nói mã có bao nhiêu chữ số hay bao lâu thì đổi. Quét mã QR là lựa chọn an toàn hơn, vì mã QR chuyển các thông số đó sang ứng dụng của bạn. Khóa nhập tay cho mã 6 chữ số sau mỗi 30 giây.

Mã khôi phục là cách duy nhất để vào lại

Appwrite nói điều này thẳng thắn hơn hẳn thông thường. Tài liệu của Appwrite gọi mã khôi phục là "the only way to access your account if you lose access to your authenticator app" (cách duy nhất để truy cập tài khoản nếu bạn mất quyền truy cập vào ứng dụng xác thực) (Appwrite). Tài liệu không mô tả kênh hỗ trợ nào cho tài khoản Console bị khóa.

Ảnh chụp màn hình cho thấy một hàng Recovery codes (mã khôi phục) với nút View (xem) trên cùng trang cài đặt, nên bạn có thể xem lại mã khi vẫn đang đăng nhập. Hãy cất một bản ở nơi khác ngoài điện thoại, chẳng hạn trong trình quản lý mật khẩu hoặc bản in. Nếu bạn không có bản sao lưu Novaz, hoặc bản sao lưu cũ hơn tài khoản Appwrite, các mã này là cách để bạn vào lại. Xem thêm ở Mã dự phòng 2FA.

Cùng ảnh chụp màn hình đó cũng liệt kê Email là một yếu tố, với mã dùng một lần gửi đến địa chỉ đã xác minh của tài khoản. Phần chữ của trang chỉ đề cập đến ứng dụng xác thực, nên dựa vào tài liệu, chúng tôi không thể cho bạn biết mã qua email có dùng làm phương án dự phòng khi đăng nhập được hay không.

Nếu Appwrite từ chối mã của bạn

Tài liệu của Appwrite không đề cập đến trường hợp mã bị từ chối. Nguyên nhân thường gặp nhất là đồng hồ của iPhone: mở Cài đặt › Cài đặt chung › Ngày & Giờ và bật Đặt tự động. Novaz cũng cảnh báo khi đồng hồ lệch từ 15 giây trở lên. Nếu bạn nhập khóa bằng tay, hãy kiểm tra xem đã sao chép đủ toàn bộ khóa chưa. Các nguyên nhân khác có trong Mã xác thực không hoạt động?

Đổi điện thoại

Appwrite không mô tả cách chuyển MFA sang điện thoại mới, cách thay ứng dụng xác thực, hay cách tắt MFA. Hãy làm những việc này khi bạn vẫn còn đăng nhập được bằng điện thoại cũ, từ cùng thẻ Multi-factor authentication. Nếu bạn đã bật sao lưu iCloud của Novaz hoặc đã xuất tệp sao lưu, bạn có thể khôi phục Appwrite trên điện thoại mới; nếu không có, bạn sẽ thêm Appwrite vào điện thoại mới như một tài khoản mới. Xem Cách chuyển ứng dụng xác thực sang iPhone mới.

Nếu bạn mất ứng dụng xác thực

Đăng nhập bằng một trong các mã khôi phục, rồi thiết lập lại ứng dụng xác thực trên điện thoại mới. Nếu không có mã khôi phục, tài liệu của Appwrite không đưa ra cách nào khác để vào lại tài khoản. Xem thêm ở Mất điện thoại có ứng dụng xác thực?

Trợ giúp chính thức của Appwrite

• Multi-factor authentication (xác thực đa yếu tố; cho tài khoản Console của bạn)
• Multi-factor authentication (Appwrite Auth, cho người dùng ứng dụng của bạn)
• Security (bảo mật)