本文へスキップ
Novaz Authenticator入手

Bitbucket の2FA：認証アプリの設定方法

執筆：Novaz チーム · 更新日：2026年11月5日
Novaz の手順はバージョン 1.0.5 で確認済み

このページは英語のガイドを翻訳したものです。サービスのウェブサイト上のボタンやメニューは、日本語では名称が多少異なる場合があります。

このページの内容
  1. 始める前に：SSH とパスワード
  2. 認証アプリで2FA を有効にする
  3. 6個のリカバリーコード
  4. Bitbucket がコードを受け付けない場合
  5. 新しいスマートフォンへの移行
  6. 認証アプリをなくした場合
  7. 2FA をオフにする
  8. Bitbucket と Atlassian の公式ヘルプ

Atlassian の Git ホスティングサービスである Bitbucket Cloud（bitbucket.org）には Atlassian アカウントでサインインしますが（Bitbucket）、Bitbucket の2段階認証（two-step verification）は別の設定です。Atlassian は、アカウント用と Bitbucket 用の2つの確認があると説明しています。両方をオンにすると、コードの確認画面が2回続けて表示されることがあり、一方のコードはもう一方では通りません（Atlassian）。

ここで扱う Bitbucket 独自の設定では、時間ベース（TOTP）の認証アプリか、FIDO U2F のセキュリティキーを使います。ヘルプページには SMS についての記載はありません（Bitbucket）。任意ですが、Bitbucket Premium のワークスペースによっては、プライベートリポジトリにアクセスする前に必須とされる場合があります（Bitbucket）。アカウント側の設定については、Atlassian の2段階認証のヘルプをご覧ください。

手順では iPhone の Authenticator App - Novaz を使います。ほかの認証アプリでも同じ流れです。

このガイドの確認方法: Bitbucket の手順は、下にリンクした Atlassian 公式の Bitbucket Cloud ヘルプページ、ナレッジベースの記事、開発者向けの変更履歴に基づいています（2026年10月20日に確認）。Bitbucket のアカウントで実際に試してはいないため、ラベルが多少異なる場合があります。Novaz の手順は、アプリのバージョン 1.0.5 で確認しています。

始める前に：SSH とパスワード

Bitbucket は次の要件を挙げています（Bitbucket）。

  • アカウントに登録した SSH キー。 2段階認証をオンにすると、Git のリモート操作は SSH 経由で行う前提になるため、先にリモート、Git クライアント、ビルドツールを切り替えておきます。
  • 確認済みのメールアドレスと Atlassian アカウントのパスワード。 まだパスワードがない場合は、パスワードの復旧から設定してからもう一度ログインするよう Bitbucket は案内しています。

2段階認証のページでは、HTTPS と API にはまだアプリパスワードを勧めていますが、Bitbucket の変更履歴では、アプリパスワードは2026年7月28日に完全に廃止される予定とされていました（Bitbucket）。後継の API トークンには、2段階認証は必要ありません（Bitbucket）。

認証アプリで2FA を有効にする

  1. Bitbucket で Settings（設定）の歯車アイコンを選択し、Personal Bitbucket settings（個人用 Bitbucket 設定）を選択します（Bitbucket）。
  2. Security（セキュリティ）で Two-step verification（2段階認証）を選択します。直接のアドレスは bitbucket.org/account/settings/two-step-verification/manage です（Bitbucket）。
  3. 要件を確認し、Atlassian アカウントのパスワードを入力して、Set up two-step verification（2段階認証を設定）を選択します。
  4. QR コードが表示されたら、Novaz で + をタップし、QR コードをスキャン を選んでカメラを向けます。同じ iPhone の場合は、代わりにスクリーンショットを撮って 写真を選ぶ を使います。詳しくは同じ iPhone で QR コードを読み取る方法をご覧ください。
  5. スキャンできない場合は、Bitbucket の Account（アカウント）と Key（キー）の欄に同じ情報が表示されています。Novaz で + をタップし、キーを手動で入力 をタップして、サービス に Bitbucket と入力し、Key の内容を 設定キー に貼り付けます。詳しくは2FA の設定キーとは？をご覧ください。
  6. Novaz に表示されている現在のコードを Verification code（確認コード）に入力します。
  7. リカバリーコードをダウンロードするか書き留めます。

コードは6桁ですが（Bitbucket）、間隔を示しているページはなく、Novaz で手入力したキーは常に30秒ごとのコードになるため、できればスキャンしてください。設定後は、ログインのたびに Verification code にコードを入力し、Verify（確認）を選びます。デバイスの記憶については、Bitbucket は触れていません。

6個のリカバリーコード

リカバリーコードは6個発行され、それぞれ1回使えます。認証アプリのコードと同じように Verification code に入力します。未使用のものを少なくとも2個は残しておいてください。新しいコードを作るときや2段階認証をオフにするときに、Bitbucket はその数を求めます。Two-step verification ページの Show recovery codes（リカバリーコードを表示）でコードを表示できます。6個すべてを使い切った場合は、同じページで Can't find codes?（コードが見つからない場合）を選びます（Bitbucket）。

iPhone をなくし、Novaz のバックアップがない場合や、Bitbucket を追加する前のバックアップしかない場合は、これらのコードがアカウントに戻る手段になります。スマートフォンとは別の場所に保管してください。詳しくは2FA のバックアップコードをご覧ください。

Bitbucket がコードを受け付けない場合

Bitbucket のヘルプでは、次の確認を勧めています（Bitbucket、Bitbucket）。

  • 数字はスペースを入れずに続けて入力します。
  • 正しい項目を見ているか確認します。Atlassian アカウントの2段階認証もオンにしている場合は項目が2つあり、互いに代用できません。
  • リカバリーコードを再利用しないでください。
  • 時計を合わせます。30〜60秒のずれでコードは使えなくなります。iPhone では 設定 › 一般 › 日付と時刻 › 自動設定 をオンにするか、すでにオンなら一度オフにしてからオンに戻し、新しいコードを待ちます。時計が15秒以上ずれると、Novaz が警告を表示します。

それでも解決しない場合は、リカバリーコードを使い、認証アプリのコードが使えない場合をご覧ください。

新しいスマートフォンへの移行

Bitbucket の方法は、2段階認証をオフにしてから再びオンにすることです（Bitbucket）。古いスマートフォンが使えるうちに Two-step verification を開き、そのコードかリカバリーコードを入力して Disable two-step verification（2段階認証を無効にする）を選択し、新しいスマートフォンで設定して、新しいコードを保存します。

Novaz では、iCloud バックアップやバックアップファイルで新しい iPhone にアカウントを復元できるので、この作業なしでコードはそのまま使えます。バックアップがない場合は、各アカウントを新しい iPhone に一から追加することになります。認証アプリを新しい iPhone に移行する方法をご覧ください。

認証アプリをなくした場合

まずはリカバリーコードを使います。Bitbucket は SSH 経由でリカバリーコードを取得する方法にも触れていますが、手順は示していません。

コードが残っていない場合は、2026年3月のナレッジベースの記事で、メールによる復旧が説明されています（Atlassian）。

  1. コードの入力画面で Forgot code（コードを忘れた）を選択し、Send recovery email（復旧用メールを送信）を選択します。メインのヘルプページではこれを Can't find codes? と呼んでいるため、ラベルが異なる場合があります。
  2. 最初のメールには、待つようにとだけ書かれています。24時間後、2通目のメールで1回限りのログインリンクが届きます（迷惑メールフォルダも確認してください）。
  3. リンクは24時間で期限切れになり、リンクを使うと2段階認証がオフの状態でログインできます。設定し直してください。

この待ち時間は短縮できません。「Atlassian cannot disable two-step verification for any Bitbucket user account」（Atlassian は、どの Bitbucket ユーザーアカウントについても2段階認証を無効にできません）と書かれています（Bitbucket）。メールがうまくいかない場合、記事では Atlassian サポートへのチケットを勧めています。

Atlassian アカウントでも2段階認証を使っている場合は、先に24文字の緊急用復旧キーでそちらを解除します。詳しくは認証アプリの入った iPhone をなくした場合をご覧ください。

2FA をオフにする

Two-step verification で認証アプリのコードかリカバリーコードを入力し、Disable two-step verification を選択して、Disable（無効にする）で確定します（Bitbucket）。自分が管理するコンテンツで2段階認証を必須にしている場合は、先に Access controls（アクセス制御）の Require two-step verification（2段階認証を必須にする）のチェックを外します（Bitbucket）。その後、Novaz から アカウントを削除 で Bitbucket の項目を削除します。

Bitbucket と Atlassian の公式ヘルプ

ほかのガイド：開発者ツール