設定驗證 App
- 開啟您的個人大頭貼選單並選擇 Edit profile(編輯個人檔案)。
- 選擇 Access → Password and authentication(存取權限 → 密碼與驗證)。
- 在 One-time password authenticator(一次性密碼驗證 App)下方,選擇 Register authenticator(設定驗證 App)。
將 GitLab 加入 Sign In
您可以使用 Sign In,這是我們的驗證 App,可在 iPhone 上產生驗證碼。
- 將設定用的 QR Code 顯示在另一台裝置的螢幕上,開啟 Sign In 並點擊 Add → Scan QR Code。
- 掃描條碼,檢視帳號詳細資訊,然後點擊 Add Account。
- 在 GitLab 輸入您目前的密碼與六位數驗證碼,然後選擇 Register with two-factor app(透過雙重認證 App 設定)。下載您的備用碼。
GitLab 除了 QR Code,也提供手動設定所需的資訊。在 Sign In 中,選擇 Add → Enter Setup Key,將 Service 設為 GitLab、Account 設為您的帳號名稱,將秘密金鑰貼到 Key 欄位中,然後點擊 Add Account。請妥善保管金鑰,不要與他人分享。
儲存備用碼
將 gitlab-recovery-codes.txt 安全地存放在手機以外的地方。每個備用碼只能使用一次。在驗證 App 提示出現時,選擇 Recover your account(復原您的帳號)以使用備用碼。
如果您無法使用備用碼,請參閱 GitLab 針對您的執行個體提供的復原說明。在更換手機前,請先準備好復原選項。
Git 與組織要求
在啟用雙重認證後,針對透過 HTTPS 進行的 Git 作業或 API 存取,請使用個人存取權杖代替密碼。群組或執行個體政策可能會強制要求使用雙重認證。相容的 WebAuthn 裝置則提供了另一種驗證選項。
如果驗證碼無法使用
請確認 Sign In 中的 GitLab 項目對應到您要登入的帳號。等待新的驗證碼出現,並在它更新前輸入。如果新驗證碼仍然無法使用,請確認 iPhone 已設定為自動調整日期與時間。
排除問題時,請保留仍可使用的登入狀態,並備妥帳號復原資訊。僅在 Sign In 中加入帳號,並不代表完成設定;您還需要讓服務接受驗證碼,並確認已啟用雙重認證。