Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[docs-scanner] 2FA account recovery instructions contain logical contradiction

Đang mở Phù hợp với người mới
#26,084 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
72/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
docker

Hướng nghiên cứu

Mở content/manuals/security/authentication/2fa/recover-hub-account.md và kiểm tra phần hiện tại "Recover your account without access". Xác minh quy trình đăng nhập và khôi phục 2FA thực tế của Docker, bao gồm việc tùy chọn thiết bị bị mất xuất hiện trước hay sau bước xác thực và liệu biểu mẫu Contact Support có bắt buộc hay không. Công việc được xem là hoàn tất khi các hướng dẫn khớp với trải nghiệm người dùng mà không đưa ra các bước mâu thuẫn.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

File: content/manuals/security/authentication/2fa/recover-hub-account.md

Issue

The "Recover your account without access" section instructs users to sign in with username and password when they've lost both their 2FA device and recovery code:

If you lost access to both your two-factor authentication application and your recovery code:

  1. Sign in to your Docker account with your username and password.
  2. Select I've lost my authentication device and I've lost my recovery code.
Why this matters

This is a logical contradiction that will confuse users in a critical account recovery situation. When 2FA is enabled on an account, signing in requires:

  1. Username and password
  2. The 2FA code from the authenticator app

If a user has lost their authentication device, they cannot provide the 2FA code, which means they cannot complete step 1 (signing in). The instructions don't explain how to bypass the 2FA prompt or access the "I've lost my authentication device" option without being able to sign in first.

A user following these instructions will be stuck at the sign-in page, unable to proceed to step 2 where they can indicate they've lost their device.

Suggested fix

Clarify the actual recovery flow. Possible approaches:

  1. If there's a "lost device" link on the sign-in page itself (before completing authentication), explain that:

    • Go to the sign-in page
    • Enter username and password
    • When prompted for 2FA code, select "I've lost my authentication device"
    • Then select "I've lost my recovery code"
  2. If users must contact support without being able to sign in at all, simplify to:

    • If you've lost both your authentication device and recovery code, you cannot sign in
    • Complete the Contact Support form with your primary email address for recovery instructions

The instructions should match the actual user experience when 2FA blocks sign-in.


Found by nightly documentation quality scanner

Ngôn ngữ chính
Markdown
Star
4.7k
Fork
8.5k
Merge trung bình
2 ngày 18 giờ
Pull request đã merge (30 ngày)
121

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của docker/docs

Tất cả issue của docker/docs

Issue tương tự

Thêm issue về Security

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.