2FA cho balena: cách thiết lập ứng dụng xác thực cho balenaCloud

Tài khoản balenaCloud kiểm soát các nhóm thiết bị kết nối: mã chạy trên chúng, quyền truy cập SSH vào chúng, và các khóa API có thể thay đổi tất cả những thứ đó. Vì vậy, tài khoản này cần nhiều hơn một mật khẩu. Xác thực hai yếu tố (2FA) của balena là tùy chọn và dùng một phương thức: mã theo thời gian từ ứng dụng xác thực (TOTP). Tài liệu không có tùy chọn tin nhắn SMS (balena, balena). Hướng dẫn này dùng Authenticator App - Novaz trên iPhone, 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 balena lấy từ tài liệu của chính balena (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. Về trường hợp bị khóa ngoài tài khoản, chúng tôi cũng đọc các câu trả lời của đội ngũ balena trên diễn đàn chính thức của họ. Chúng tôi chưa thử bất kỳ điều gì trong số này trên một tài khoản balenaCloud, nên có thể một vài 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 2FA bằng ứng dụng xác thực

Tài liệu về tài khoản của balena mô tả các bước sau (balena):

1. Đăng nhập bảng điều khiển balenaCloud. Nhấp vào hồ sơ ở góc trên bên phải và mở trang Preferences (tùy chọn).
2. Mở thẻ Two-factor Authentication (xác thực hai yếu tố) và nhấp vào Enable two-factor authentication (bật xác thực hai yếu tố).
3. balena hiển thị một mã QR và ô Pairing code (mã ghép nối). Trong Novaz, chạm vào +, rồi Quét mã QR, và hướng camera vào mã trên màn hình máy tính. Nếu bảng điều khiển đang mở trên chính iPhone đó, hãy chụp ảnh màn hình, chạm vào +, rồi Chọn ảnh. Xem cách quét mã QR trên cùng một iPhone.
4. Nhập mã 6 chữ số từ Novaz vào ô Pairing code.
5. balena sẽ hiển thị các mã khôi phục của bạn. Hãy tải chúng xuống và cất giữ ở nơi an toàn, rồi nhấp vào OK.

Tài liệu lưu ý rằng 2FA chỉ bật khi ghép nối thành công, nên bạn không thể tự khóa mình ngoài tài khoản nếu bỏ dở giữa chừng.

Tài liệu của balena không nhắc đến khóa dạng chữ để nhập thay cho việc quét, và không nói mã bao lâu đổi một lần. Hãy quét mã QR: mã này mang các thông số của mã sang ứng dụng. Nếu bạn tìm thấy khóa và nhập bằng Nhập khóa thủ công, Novaz sẽ mặc định mã 6 chữ số, đổi mỗi 30 giây. Xem Khóa cài đặt 2FA là gì?

Danh sách ứng dụng đã được kiểm chứng của balena nêu tên Google Authenticator, Authy và 1Password. Novaz không có trong danh sách, nhưng tạo cùng loại mã TOTP chuẩn.

Nếu bạn đăng nhập bằng SAML

Nếu bạn dùng đăng nhập một lần của công ty và gặp lỗi mỗi lần thử bật 2FA, balena gợi ý đăng xuất, đăng nhập lại và thử lại ngay (balena).

Khi balena hỏi mã

Sau khi thiết lập, balena hỏi mã từ ứng dụng ở lần đăng nhập tiếp theo, sau khi bạn đã nhập tên người dùng và mật khẩu (balena). Tài liệu không nhắc đến thiết bị được ghi nhớ hay tin cậy.

Trên dòng lệnh, balena login nhận email, mật khẩu và mã 2FA của bạn, hoặc cho phép bạn cấp quyền cho CLI từ bảng điều khiển, hoặc chấp nhận token phiên hay khóa API (balena). Khóa API không bao giờ hết hạn trừ khi bị thu hồi và mang toàn bộ quyền của bạn (balena), vì vậy hãy bảo vệ chúng như mã khôi phục.

Giữ mã khôi phục

Mã khôi phục là phương án dự phòng duy nhất mà balena ghi trong tài liệu. Đó là cách để bạn vào lại nếu mất điện thoại mà không có bản sao lưu Novaz, hoặc chỉ có bản sao lưu được tạo trước khi bạn thêm balena. Hãy cất giữ chúng trong trình quản lý mật khẩu hoặc trên giấy, ở nơi khác ngoài điện thoại. Xem thêm ở Mã dự phòng 2FA.

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

Tài liệu của balena cho biết mã sẽ ngừng hoạt động khi bộ đếm ngược trong ứng dụng hết, nên hãy nhập mã khi nó vẫn còn hiển thị. Nếu mã mới vẫn liên tục thất bại, hãy kiểm tra đồng hồ của iPhone: Cài đặt › Cài đặt chung › Ngày & Giờ › Đặt tự động. Novaz cảnh báo khi đồng hồ lệch từ 15 giây trở lên. 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

Tài liệu của balena không mô tả cách chuyển 2FA sang điện thoại mới. Các bước họ có đưa ra là tắt rồi bật lại. Khi vẫn còn điện thoại cũ, hãy tắt 2FA, rồi bật lại và quét mã QR mới bằng iPhone mới. Nếu bạn đã bật sao lưu iCloud của Novaz hoặc lưu tệp sao lưu, khôi phục nó trên iPhone mới là cách đơn giản hơn: mã vẫn tiếp tục hoạt động. 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. Nếu không có, tài liệu của balena không có cách tự xử lý. Nơi được ghi trong tài liệu để nhận trợ giúp là mục hỗ trợ sản phẩm trên diễn đàn của balena (balena).

Trong một chủ đề trên diễn đàn năm 2023, các câu trả lời từ đội ngũ balena, trong đó có một người kiểm duyệt diễn đàn được liệt kê, đã mô tả quy trình. Mã khôi phục là cách nhanh nhất để chứng minh tài khoản là của bạn. Nếu không có, balena kiểm tra xem bạn có giữ nửa riêng tư (private key) của một khóa SSH mà bạn đã thêm vào tài khoản balenaCloud hay không. Bạn ký một chuỗi ký tự họ đưa và gửi kết quả riêng cho một thành viên đội ngũ balena, không bao giờ đăng công khai. Khi chữ ký được xác nhận, balena gỡ 2FA để bạn có thể đăng nhập chỉ bằng mật khẩu (balena forums). Thông tin này đến từ các câu trả lời trên diễn đàn, không phải từ tài liệu, và balena không nói việc này mất bao lâu. Nếu bạn dùng SSH với thiết bị của mình, hãy giữ khóa đó. Xem thêm ở Mất điện thoại có ứng dụng xác thực?

Tắt 2FA

Quay lại thẻ Two-factor Authentication trong tùy chọn và nhấp vào Disable two-factor authentication (tắt xác thực hai yếu tố). balena sẽ hỏi mật khẩu tài khoản trước (balena). Nếu bạn đăng ký bằng GitHub hoặc Google và chưa bao giờ đặt mật khẩu, bạn có thể thêm mật khẩu trong thẻ Account details (thông tin tài khoản) của cùng trang.

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

• Account management (quản lý tài khoản)
• Security (bảo mật)
• Enterprise Single Sign-On (SSO): Introduction (đăng nhập một lần cho doanh nghiệp: giới thiệu)
• Balena CLI reference (latest) (tài liệu tham khảo balena CLI, bản mới nhất)
• Getting Help (nhận trợ giúp)
• Disable 2FA Reset without recovery codes (chủ đề trên balenaForums có câu trả lời từ đội ngũ balena)