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

Assembla は、Perforce、Subversion、Git のリポジトリをプロジェクト管理ツールとともにホストしているので（Assembla）、Assembla のログインがソースコードを守っていることもよくあります。認証アプリを使った2要素認証（2FA）に対応しており、ポートフォリオのオーナーはポートフォリオの全員に2FA を義務づけることができます。ほかのサービスと違う点が2つあります。設定画面に表示されるのは QR コードだけで、入力用のキーはありません。また、2FA を有効にすると、リポジトリのクライアントではパスワードが使えなくなります（Assembla）。

このガイドでは iPhone の Authenticator App - Novaz を使います。時間ベースのコードを生成する認証アプリなら、どれでも手順は同じです。

このガイドの確認方法: Assembla の手順は、下にリンクした Assembla 公式ヘルプセンター（2FA の記事のスクリーンショットを含む）に基づいています（2026年10月21日に確認）。Assembla のアカウントで実際に試してはいないため、ラベルが多少異なる場合があります。Novaz の手順は、アプリのバージョン 1.0.5 で確認しています。

始める前に

• SSO でサインインしている場合： Assembla によると、シングルサインオンを使っているアカウントにはパスワードがなく、パスワードがないと Assembla 自身の2FA を有効にできません（Assembla）。
• ポートフォリオで Google の2FA を使っている場合： 同じ記事には、ポートフォリオが Google の2FA を必須にしている場合はその方法が優先されると書かれています。それ以上の説明はありません。
• アプリの一覧は古い： Assembla の一覧にはまだ Windows Phone が含まれていますが、コードは標準的な時間ベースのコードなので、Novaz でも同じ QR コードをスキャンできます。

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

Assembla のヘルプで説明されている手順です（Assembla）。

1. ページ上部のアバターをクリックします。
2. My Profile（マイプロフィール）› Two-factor authentication（2要素認証）を選択します。ページには2要素認証が現在無効であることが表示され、QR コードが表示されます。
3. Novaz で + をタップし、QR コードをスキャン をタップして、パソコンの画面に表示されたコードにカメラを向けます。Assembla を同じ iPhone で開いている場合は、スクリーンショットを撮り、+ をタップしてから 写真を選ぶ をタップします。詳しくは同じ iPhone で QR コードをスキャンする方法をご覧ください。
4. Confirm current password（現在のパスワードを確認）に Assembla のパスワードを入力します。
5. Enter the six-digit code from the application（アプリの6桁のコードを入力）に、Novaz に表示されている現在のコードを入力します。
6. Enable（有効にする）をクリックします。
7. Assembla から渡されるリカバリーコードのファイルを保存します。iPhone をなくしたときは、これがアカウントに戻る手段になります。

ページに設定キーはない

Assembla の画面にはテキストのキーが表示されません。iPhone でスキャンできない場合の回避策として、ヘルプではデスクトップの QR リーダーなど別の読み取りアプリで QR コードを解読し、otpauth:// リンクを取り出す方法が紹介されています。そのリンクの secret= の部分がキーです。Novaz では + › キーを手動で入力 で、設定キー に入力します。詳しくは2FA の設定キーとは？をご覧ください。

Novaz ではスキャンするほうが簡単です。手入力するキーは16文字以上が必要ですが、Assembla はキーの長さを示していません。

リカバリーコードのファイル

2FA を有効にすると、Assembla からリカバリーコードのファイルが渡されます。iPhone をなくし、Novaz のバックアップがない場合や、最後にバックアップファイルを作ったあとで Assembla を追加した場合は、このファイルがアカウントに戻る手段になります。その iPhone がなくてもアクセスできる場所に保管してください。ファイルにいくつのコードが含まれるのか、新しいコードを入手する方法はあるのかは、Assembla のヘルプに書かれていません。詳しくは2FA のバックアップコードをご覧ください。

Git、SVN、Perforce のクライアント

2FA をオンにすると、外部のクライアントではユーザー名とパスワードでコードのチェックアウトやコミットができなくなります。代わりに API キーを作成します（Assembla、Assembla）。

1. アバターをクリックし、My Profile › API Applications & Sessions（API アプリケーションとセッション）を選択します。
2. Repository access（リポジトリへのアクセス）にチェックを入れ、Create（作成）をクリックします。
3. クライアントでは、Assembla のユーザー名と、パスワードの代わりに API シークレットを使ってサインインします。

必須になっている場合

ポートフォリオの管理者が必須化をオンにすると（More（その他）› Portfolio Admin（ポートフォリオ管理）を開き、Two-factor Authentication セクションで Enabled（有効）を選んで Update 2FA Settings（2FA 設定を更新））、2FA を設定していないメンバーは次回のサインイン時に設定する必要があります。設定するまで、Assembla には一切アクセスできません（Assembla）。

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

Assembla のヘルプには、コードが受け付けられない場合についての案内がありません。最もよくある原因は iPhone の時計のずれです。iPhone で 設定 › 一般 › 日付と時刻 を開き、自動設定 をオンにします。時計が15秒以上ずれていると、Novaz が警告を表示します。ほかの原因については認証アプリのコードが使えない場合をご覧ください。

機種変更するとき、iPhone をなくしたとき、オフにするとき

Assembla では3つとも同じ方法で対処します。2FA をオフにし、新しいデバイスでもう一度オンにします（Assembla）。

1. アバターをクリックし、My Profile › Two-factor Authentication を選択します。
2. Confirm current password にパスワードを入力します。
3. Enter the six-digit code from the application にコードを入力します。iPhone をなくした場合は、未使用のリカバリーコードをこの欄に入力すると Assembla は説明しています。
4. Disable（無効にする）をクリックします。これで2FA を設定し直せます。

Novaz のバックアップなしで機種変更する場合は、古い iPhone がまだ使えるうちにこの操作を行ってください。iCloud バックアップやバックアップファイルがあれば、代わりに新しい iPhone でアカウントを復元できます。詳しくは認証アプリを新しい iPhone に移行する方法をご覧ください。

iPhone とリカバリーファイルの両方をなくした場合は、support@assembla.com にメールしてアカウントをリセットしてもらうよう Assembla は案内しています。サポートがどのような証明を求めるのか、どれくらい時間がかかるのかは、ヘルプに書かれていません。認証アプリの入った iPhone をなくした場合もご覧ください。

Assembla 公式ヘルプ

• Using Two-Factor Authentication with your Assembla Account
• Working on my Repos with Third Party Authentication
• Assembla: Managed Cloud Hosting For Perforce, SVN & Git