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

Bitbucket Cloud, dịch vụ lưu trữ Git của Atlassian tại bitbucket.org, cho bạn đăng nhập bằng tài khoản Atlassian (Bitbucket), nhưng xác minh hai bước của nó là một cài đặt riêng. Atlassian mô tả hai lớp kiểm tra, một cho tài khoản và một cho Bitbucket. Khi bật cả hai, bạn có thể gặp hai lời nhắc nhập mã liên tiếp, và mã của lớp này không dùng được cho lớp kia (Atlassian).

Cài đặt riêng của Bitbucket, được nói đến ở đây, chấp nhận ứng dụng xác thực theo thời gian (TOTP) hoặc khóa bảo mật FIDO U2F. Trang trợ giúp của họ không nhắc đến tin nhắn SMS (Bitbucket). Tính năng này là tùy chọn, trừ khi một không gian làm việc Bitbucket Premium bắt buộc nó trước khi bạn truy cập được các kho mã riêng tư (Bitbucket). Với lớp tài khoản, xem trợ giúp về xác minh hai bước của Atlassian.

Các bước dùng Authenticator App - Novaz trên iPhone; các ứng dụng xác thực khác cũng 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 Bitbucket lấy từ các trang trợ giúp Bitbucket Cloud, bài viết cơ sở kiến thức và nhật ký thay đổi dành cho nhà phát triển của chính Atlassian (có liên kết bên dưới), mà chúng tôi đã đọc vào ngày 20 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 Bitbucket, 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.

Trước khi bắt đầu: SSH và mật khẩu

Bitbucket liệt kê các yêu cầu sau (Bitbucket):

• Một khóa SSH trên tài khoản. Khi bật xác minh hai bước, các thao tác từ xa của Git được kỳ vọng đi qua SSH, nên hãy chuyển các remote, ứng dụng Git và công cụ build sang SSH trước.
• Một địa chỉ email đã xác nhận và mật khẩu tài khoản Atlassian. Chưa có mật khẩu? Bitbucket nói hãy đặt mật khẩu qua chức năng khôi phục mật khẩu, rồi đăng nhập lại.

Trang về xác minh hai bước vẫn gợi ý dùng mật khẩu ứng dụng (app password) cho HTTPS và API, nhưng nhật ký thay đổi của Bitbucket đã lên lịch ngừng hẳn chúng vào ngày 28 tháng 7 năm 2026 (Bitbucket). Thứ thay thế, token API, không yêu cầu xác minh hai bước (Bitbucket).

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

1. Trong Bitbucket, chọn biểu tượng bánh răng Settings (cài đặt), rồi Personal Bitbucket settings (cài đặt Bitbucket cá nhân) (Bitbucket).
2. Trong Security (bảo mật), chọn Two-step verification (xác minh hai bước). Địa chỉ trực tiếp là bitbucket.org/account/settings/two-step-verification/manage (Bitbucket).
3. Kiểm tra các yêu cầu, nhập mật khẩu tài khoản Atlassian và chọn Set up two-step verification (thiết lập xác minh hai bước).
4. Khi mã QR xuất hiện, chạm vào + trong Novaz, chọn Quét mã QR và hướng camera vào mã. Trên cùng một 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.
5. Nếu quét không được, các ô Account (tài khoản) và Key (khóa) của Bitbucket chứa cùng thông tin. Trong Novaz, chạm vào +, rồi Nhập khóa thủ công, nhập Bitbucket vào Dịch vụ, và dán Key vào Khóa cài đặt. Xem Khóa cài đặt 2FA là gì?
6. Nhập mã Novaz hiện tại vào Verification code (mã xác minh).
7. Tải xuống hoặc chép lại các mã khôi phục.

Mã có 6 chữ số (Bitbucket), nhưng không trang nào nêu chu kỳ, và khóa nhập tay trong Novaz luôn tạo mã 30 giây, nên hãy quét nếu có thể. Từ đó, mỗi lần đăng nhập đều hỏi mã trong Verification code, rồi Verify (xác minh). Bitbucket không nhắc đến việc ghi nhớ thiết bị.

Sáu mã khôi phục

Bạn nhận 6 mã khôi phục, mỗi mã dùng được một lần, nhập vào Verification code như mã từ ứng dụng. Hãy giữ ít nhất hai mã chưa dùng: Bitbucket cần đủ số đó để tạo mã mới hoặc tắt xác minh hai bước. Show recovery codes (hiện mã khôi phục) trên trang Two-step verification hiển thị chúng; khi đã dùng hết cả 6, hãy chọn Can't find codes? (không tìm thấy mã?) ở đó (Bitbucket).

Nếu bạn mất iPhone và không có bản sao lưu Novaz, hoặc chỉ có bản tạo trước khi thêm Bitbucket, các mã này là đường vào lại tài khoản. Hãy cất chúng tách khỏi điện thoại. Xem thêm ở Mã dự phòng 2FA.

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

Trợ giúp của Bitbucket gợi ý các bước kiểm tra sau (Bitbucket, Bitbucket):

• Nhập các chữ số liền một dãy, không có khoảng trắng.
• Đọc đúng mục. Khi xác minh của tài khoản Atlassian cũng bật, bạn sẽ có hai mục, và chúng không thay thế cho nhau được.
• Đừng dùng lại mã khôi phục.
• Chỉnh đồng hồ: lệch 30 đến 60 giây là mã hỏng. Trên iPhone, bật Cài đặt › Cài đặt chung › Ngày & Giờ › Đặt tự động, hoặc tắt rồi bật lại nếu đã bật, rồi đợi mã mới. Novaz đưa ra cảnh báo khi đồng hồ lệch từ 15 giây trở lên.

Vẫn không được? Hãy dùng một mã khôi phục, và xem Mã xác thực không hoạt động?

Chuyển sang điện thoại mới

Cách của Bitbucket là tắt xác minh hai bước rồi bật lại (Bitbucket). Khi điện thoại cũ còn hoạt động, mở Two-step verification, nhập mã từ điện thoại đó hoặc một mã khôi phục, chọn Disable two-step verification (tắt xác minh hai bước), rồi thiết lập lại với điện thoại mới và lưu các mã mới.

Trong Novaz, sao lưu iCloud hoặc tệp sao lưu sẽ khôi phục các tài khoản trên iPhone mới, nên mã vẫn hoạt động mà không cần làm vậy. Nếu không có, mỗi tài khoản phải thêm lại từ đầu trên iPhone 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

Bắt đầu bằng một mã khôi phục. Bitbucket cũng nhắc đến việc lấy các mã này qua SSH, nhưng không đưa ra các bước.

Nếu không còn mã nào, một bài viết cơ sở kiến thức tháng 3 năm 2026 mô tả cách khôi phục qua email (Atlassian):

1. Ở lời nhắc nhập mã, chọn Forgot code (quên mã), rồi Send recovery email (gửi email khôi phục). Trang trợ giúp chính gọi mục này là Can't find codes?, nên nhãn có thể khác.
2. Email đầu tiên chỉ bảo bạn chờ. 24 giờ sau, email thứ hai mang đến một liên kết đăng nhập dùng một lần (hãy xem cả thư rác).
3. Liên kết hết hạn sau 24 giờ và cho bạn đăng nhập với xác minh hai bước đã tắt. Hãy thiết lập lại.

Thời gian chờ không thể rút ngắn: "Atlassian cannot disable two-step verification for any Bitbucket user account" (Atlassian không thể tắt xác minh hai bước cho bất kỳ tài khoản người dùng Bitbucket nào) (Bitbucket). Nếu email không được, bài viết gợi ý gửi phiếu yêu cầu đến bộ phận hỗ trợ Atlassian.

Nếu tài khoản Atlassian của bạn cũng bật xác minh hai bước, hãy gỡ lớp đó trước bằng khóa khôi phục khẩn cấp 24 ký tự của nó. Xem thêm ở Mất điện thoại có ứng dụng xác thực?

Tắt 2FA

Trong Two-step verification, nhập mã từ ứng dụng hoặc mã khôi phục, chọn Disable two-step verification, và xác nhận bằng Disable (tắt) (Bitbucket). Nếu bạn đang bắt buộc xác minh hai bước với nội dung mình quản lý, hãy bỏ chọn Require two-step verification (yêu cầu xác minh hai bước) trong Access controls (kiểm soát truy cập) trước (Bitbucket). Sau đó, xóa mục Bitbucket khỏi Novaz bằng Xóa tài khoản.

Trợ giúp chính thức của Bitbucket và Atlassian

• Enable two-step verification (bật xác minh hai bước)
• Log into or connect to Bitbucket Cloud (đăng nhập hoặc kết nối với Bitbucket Cloud)
• Navigating Bitbucket Cloud and Atlassian Two-Step Verification for Bitbucket Cloud Users (xác minh hai bước của Bitbucket Cloud và Atlassian dành cho người dùng Bitbucket Cloud)
• How to Disable/Reset 2FA on Bitbucket Cloud and Atlassian Account (cách tắt/đặt lại 2FA trên Bitbucket Cloud và tài khoản Atlassian)
• Bitbucket Cloud Login Fails with "Invalid two step verification code" error (đăng nhập Bitbucket Cloud thất bại với lỗi mã xác minh hai bước không hợp lệ)
• Enforce two step verification (access control) option is greyed out on premium plan (tùy chọn bắt buộc xác minh hai bước bị mờ trên gói Premium)
• Control access to private content in a workspace (kiểm soát truy cập nội dung riêng tư trong không gian làm việc)
• Control access to your private content (kiểm soát truy cập nội dung riêng tư của bạn)
• API tokens (token API)
• Bitbucket Cloud changelog (nhật ký thay đổi của Bitbucket Cloud)
• Manage two-step verification for your Atlassian account (quản lý xác minh hai bước cho tài khoản Atlassian)