Hub documentation
二要素認証(2FA)
二要素認証(2FA)
2要素認証を使用すると、2つの方法でユーザーの身元を確認できるため、パスワードが漏洩した場合でも、承認された個人のみがアカウントにアクセスできるようにする追加のセキュリティが提供されます。
2要素認証を有効にする場合、ログインのたびに以下を入力する必要があります。
- ユーザー名またはメールアドレス & パスワード(通常のログイン認証情報)
- 2段階目の手順として、2要素認証のいずれかの方法を使用します:
- あなたのパスキーの1つ
- 認証アプリから取得したワンタイムセキュリティコード
二要素認証(2FA)を有効にする
2要素認証は、認証設定の「2要素認証」セクションから管理します。このセクションには、2要素認証の方式(passkeyと認証アプリ)がリスト表示され、2要素認証が有効になっている場合、リカバリーコードも表示されます。
2要素認証を有効にするには、まず少なくとも1つの方法が必要です。「Passkeys」セクションからパスキーを追加するか、認証アプリを設定してください(下記を参照)。パスキーのみを使用している場合は、「Two-factor authentication」セクションの「Turn on」をクリックしてください。認証アプリを設定すると、2要素認証が自動的に有効になります。

認証アプリを設定する
ワンタイムパスワードで認証アプリを設定するには:
Hugging Face Hub 上で:
- 認証設定に移動します
- 「2要素認証」セクションで、「認証アプリ」の横にある「セットアップ」をクリックします
お使いのデバイス(通常はスマートフォン)で:
- 互換性のあるアプリケーションをインストールしてください。例:
- Authy
- Google Authenticator
- Microsoft Authenticator
- FreeOTP
- アプリケーションでは、以下の2つの方法のいずれかで新しいエントリを追加します:
- 画面に表示されているHubのコードをデバイスのカメラでスキャンすると、エントリが自動的に追加されます
- 画面に表示されるセットアップキーを入力して、エントリを手動で追加します
Hugging Face Hub 内:
- Enter the six-digit pin number from your authentication device into “6-digit code from the app”
- 保存

正しいPINを入力し、2要素認証がまだ有効になっていなかった場合、Hubはリカバリーコードのリストを表示します。これらをダウンロードし、安全な場所に保管してください。
ログインするたびに、および30日ごとに2FAの認証を求められるようになります
新しい認証アプリに移行するには、「Authenticator app」の横にある「Reset」をクリックします。削除するには、「Remove」をクリックします。ただし、これは2段階目の代わりに少なくとも1つのパスキーを使用できる場合のみ可能です。それ以外の場合は、2要素認証を無効にしてください。
パスキーを使用する
2要素認証が有効な場合、パスキーのいずれかを2段階目の認証に使用できます。認証アプリをお持ちでない場合、最後のパスキーは削除できません。先に認証アプリを設定するか、2要素認証を無効にしてください。

リカバリーコード
2FAの有効化に成功した直後、生成されたリカバリーコードのセットをダウンロードするよう求められます。パスキーや認証アプリへのアクセスを失った場合、これらのリカバリーコードのいずれかを使用してアカウントにログインできます。
- 各コードは、アカウントへのサインインに1回のみ使用できます
- コードをコピーして印刷するか、安全な場所に保存するためにダウンロードしてください。ダウンロードを選択した場合、ファイル名はhuggingface-recovery-codes.txtです。

リカバリーコードを紛失した場合、または新しいコードを生成したい場合は、認証設定ページを使用できます。
2要素認証の復旧コードを再生成
2FAの復旧コードを再生成するには:
- 認証設定にアクセスします
- 2FAをすでに有効にしている場合は、「Two-factor authentication」セクション内の「Recovery codes」の横にある「View」をクリックしてください
- Recoveryコードを再生成をクリックします
2FAの復旧コードを再生成した場合、それらを保存してください。以前に作成された復旧コードは使用できません。
2要素認証を有効にしてサインイン
2FAを有効にしてサインインする場合、手順は標準的なサインイン手順とわずかに異なります。ユーザー名とパスワードを入力した後、追加のプロンプトが表示されます。プロンプトの指示に従い、パスキーのいずれかを使用するか、ワンタイムパスワード認証アプリのPINを入力するか、リカバリーコードを使用してサインインを完了してください。複数の方法を設定している場合は、プロンプトから切り替えることができます。
パスワードではなくパスキーでサインインする場合、2段階目のプロンプトは表示されません。


2段階認証を無効にする
2FAを無効にするには:
- 認証設定にアクセスします
- 「2要素認証」セクションで、「無効にする」をクリックします。
これにより、認証アプリとリカバリーコードが削除されます。パスキーは保持されるため、パスワードなしでサインインし続けることができます。
復旧オプション
認証デバイスへのアクセスができなくなった場合でも、アカウントへのアクセスを回復できます。
- 2要素認証を有効にした際に保存した復旧コードがある場合は、それを使用してください
- 2段階認証に関するヘルプの依頼
リカバリーコードを使用する
リカバリーコードを使用するには:
- Hubのサインインページで、ユーザー名またはメールアドレス、およびパスワードを入力してください。
- 2要素認証を求められる場合、「リカバリーコードを使用する」をクリックします。
- リカバリーコードのいずれかを入力してください
リカバリーコードを使用すると、そのコードを再利用することはできません。保存した他のリカバリーコードは引き続き使用できます。
2段階認証に関するヘルプの依頼
パスワードを忘れた場合や、2要素認証の認証情報を失った場合は、サポート ([email protected]) までご連絡いただき、アカウントへのアクセスを回復してください。SSH キーやパーソナルアクセストークンなどのリカバリー用認証要素を使用して、本人確認を行う必要があります。
Update on GitHub