GitHubの2段階認証(2FA)設定方法|方式の選び方と組織での必須化
GitHubの2段階認証(2FA)の設定方法を、TOTP アプリでの手順、方式の選び方、端末をなくしたときの戻り方、Organization で必須にしたときに起きることまで、GitHub Docs に沿ってまとめました。設定するときにリカバリーコードと予備の方法までそろえておくのが、締め出されないための要点です。
目次 クリックで開く
この記事の要点
- GitHub の2段階認証(公式の呼び名は「2 要素認証」、2FA)は、Settings → Password and authentication の「2 要素認証」から設定します。最初に設定できるのは TOTP アプリ(認証アプリ)か SMS で、GitHub は TOTP アプリを勧めています。
- GitHub のサポートは、2FA の資格情報と回復の手段をすべて失ったアカウントのアクセスを戻しません。設定するときに、リカバリーコードの保存と、2つ目の方法(パスキー・セキュリティキー・GitHub Mobile)の追加まで済ませます。
- Organization で 2FA を必須にすると、未設定のメンバーは組織のリソースに入れなくなり、外部コラボレーターは組織から外れます。必須にする前に、設定状況を確かめて周知します。
締め出されないために、最初にそろえる3つ
主の方法
TOTP アプリ
- QR コードを読み、6桁のコードを入れる
- クラウドにバックアップできるアプリが勧められている
予備の方法
パスキー・セキュリティキー・GitHub Mobile
- TOTP か SMS を設定したあとで足す
- パスキーは予備としてだけ使える
回復の手段
リカバリーコードなど
- 16個のコードをダウンロードして保管
- SSH キー、personal access token、検証済みデバイスも、サポートの確認を経て使える
出典:GitHub Docs「2 要素認証を設定する」「必須の 2 要素認証について」「2 要素認証リカバリ方法を設定する」
GitHub の2段階認証は、「2 要素認証を有効にする」から設定します。場所は、プロフィール写真から Settings を開き、サイドバーの Access にある Password and authentication を選んだ画面の「2 要素認証」の欄です(2 要素認証を設定する)。最初に設定できるのは TOTP アプリか SMS で、GitHub は TOTP アプリを強く勧めています。
この記事は、Aurant Technologies の守高が書いています。当社は、業務システムの開発と、業務ツールの導入・運用を支援しています。2FA の設定であとで困るのは、スマートフォンをなくしたときや、機種を変えたときです。GitHub のサポートは、2FA の資格情報と回復の手段をすべて失ったアカウントのアクセスを戻さないとしています(二要素認証クレデンシャルをなくした際のアカウント復旧)。ここでは、設定の手順に加えて、締め出されないために最初に何をそろえるか、会社の Organization で必須にするときに何が起きるかをまとめます。画面の名前は、GitHub Docs の日本語版(2026年10月13日に確認)の表記に合わせています。
2FA が必須になる人と、期限
GitHub は2023年3月から、GitHub.com でコードを投稿するユーザーに、2FA の有効化を順に求めています。対象のグループに選ばれると通知のメールが届き、45日間の登録期間が始まります。期間内に有効にせず、7日間の猶予も過ぎると、2FA を有効にするまで GitHub.com にアクセスできません(必須の 2 要素認証について)。
対象になるのは、次のような行動をしたアカウントです(同)。
- ほかのユーザーにアプリやアクションを公開した
- リポジトリのリリースを作った
- 重要度の高いリポジトリに貢献した、またはその管理者や共同作成者になった
- リポジトリやほかのユーザーがいる組織の、オーナーになった
- パッケージを発行したリポジトリの管理者や共同作成者になった
- エンタープライズの管理者になった
この条件は、今後変わることがあるとされています。
| 気になること | GitHub Docs の説明 |
|---|---|
| 会社の SSO で2段階認証をしている | 必須の対象に選ばれたら、GitHub.com でも 2FA の登録が要る。ただし、求められるのは初回と機密性の高い操作のときだけで、毎日あらためて求められることはほとんどない |
| メールでの確認がある | メールの確認は 2FA として数えない |
| 電話番号を出したくない | 電話番号が要るのは SMS を使うときだけ。TOTP アプリを主の方法にすればよい |
| 期限を過ぎたら、自動化も止まるか | アカウントの personal access token や OAuth のトークンは、引き続き動く。ただし 2FA を有効にするまで、新しいトークンは作れず、新しいアプリも承認できない |
| 2FA を設定した直後 | 28日間の確認期間に入る。その間に 2FA を一度通せば終わる。通さなければ28日目に求められ、通せなければ案内に沿って設定し直す |
| 対象外の人 | Enterprise Managed Users と、オンプレミスの GitHub Enterprise Server のユーザー(必須の 2FA は GitHub.com のパスワードを持つユーザーにだけかかる) |
出典:GitHub Docs「必須の 2 要素認証について」「2 要素認証を設定する」
方式の選び方:主の方法と、予備の方法
GitHub の 2FA の主な方法は次の5つで、最初に設定できるもの(主の方法)と、あとから足すもの(予備の方法)に分かれます。GitHub は、主の方法に TOTP アプリを、予備にパスキーかセキュリティキーを、それが無ければ GitHub Mobile を勧めています(必須の 2 要素認証について)。
| 方法 | 主か予備か | GitHub Docs の位置づけ |
|---|---|---|
| TOTP アプリ(認証アプリ) | 主(最初に設定できる) | 主の方法として勧められている。アプリは問わない。クラウドにバックアップできるアプリが勧められている |
| SMS | 主(最初に設定できる) | TOTP アプリを使うことが強く勧められている。SMS は傍受やフィッシングに弱く、地域によっては届きにくいか使えない。SMS で 2FA を設定したメンバーを、Organization や Enterprise が締め出すことがある |
| パスキー | 予備だけ | パスワードと 2FA の両方を1回で満たす。なくしやすく、端末をまたぐ同期が十分でないため、今は主の方法にできない |
| セキュリティキー | 予備だけ | TOTP か SMS を設定したあとで足す |
| GitHub Mobile | 予備 | パスキーやセキュリティキーが無いときの予備に勧められている。2FA を求められたときにプッシュ通知で承認する(ブラウザに出る2桁の番号を入れることがある) |
出典:GitHub Docs「2 要素認証を設定する」「必須の 2 要素認証について」「パスキーの概要」「2 要素認証を使用したGitHubへのアクセス」
パスキーは、Windows Hello、Face ID、Touch ID などで登録でき、2FA を使っている人なら、パスワードと 2FA をまとめて1回で済ませられます(パスキーの概要・2 要素認証を設定する)。ただし、GitHub は今のところパスキーを主の方法として受け付けていないので(必須の 2 要素認証について)、先に TOTP アプリを設定し、そのあとで足します。
TOTP アプリは、スマートフォンに入れるのが一般的ですが、GitHub はデスクトップなら KeePassXC、ブラウザのプラグインなら 1Password も挙げています(同)。複数の端末で同じ TOTP を使いたいときは、設定するときに各端末で同時に QR コードを読むか、「セットアップ キー」を控えておきます(2 要素認証を設定する)。
TOTP アプリで設定する手順
TOTP アプリで 2FA を有効にする
出典:GitHub Docs「2 要素認証を設定する」
QR コードを読めないときは「セットアップ キー」を選ぶと、TOTP アプリに手で入れるためのシークレットが表示されます。アプリが表示した6桁のコードを、GitHub の「Verify the code from the app」の欄に入れます。最後に「リカバリ コードの保存」で[ダウンロード]を押し、安全な場所に保存してから[リカバリ コードを保存しました]を押すと、2FA が有効になります(2 要素認証を設定する)。
| 項目 | 値 |
|---|---|
| 型 | TOTP |
| ラベル | GitHub:<GitHub のユーザー名> |
| シークレット | [セットアップ キー]で表示されるキー |
| 発行者 | GitHub |
| アルゴリズム・桁数・時間 | SHA1・6桁・30秒(いずれも既定) |
出典:GitHub Docs「2 要素認証を設定する」
リカバリーコードは16個あり、1つにつき1回だけ使えます。既定のファイル名は github-recovery-codes.txt です。Password and authentication の「回復コード」の[表示]から、いつでもダウンロードし直せます。新しいセットを作ると、前のコードはすべて使えなくなります。パスワードマネージャーに保存するのが勧められています(2 要素認証リカバリ方法を設定する・アカウント復旧)。
リカバリーコードのほかに、SSH キー、personal access token、以前にログインしたことのある端末(検証済みデバイス)も、サポートの確認を経て回復に使えます。ただし、確認には数日かかり、申請が通らないこともあります。personal access token を回復用に作るときは、スコープに「repo」を選び、SSH キーはキーの種類を「認証」にします(同)。ブラウザの Cookie を毎日消す設定にしていると、検証済みデバイスとして使えなくなるので、GitHub.com の Cookie は残しておくよう勧められています(必須の 2 要素認証について)。
機種を変えるとき:2FA を無効にせずに方法を変える
機種変更で TOTP アプリを入れ直すときや、SMS の電話番号を変えるときは、2FA を無効にせずに方法だけを変えます。Password and authentication の「2 要素メソッド」で、変える方法の[編集]を選びます。TOTP アプリなら新しいアプリで QR コードを読み、コードを入れて[保存]します。SMS の番号を変えるときは、CAPTCHA を済ませて新しい番号を入れ、届いたコードを入れて[保存]します。[保存]するまでは、今の方法がそのまま使えます(2 要素認証方法の変更)。
機種を変えるとき(TOTP アプリ)
2FA を無効にして入れ直すと、リカバリーコードが作り直される。2FA を必須にしている組織のリソースにも、無効の間は入れない
出典:GitHub Docs「2 要素認証方法の変更」「2 要素認証リカバリ方法を設定する」
2FA をいったん無効にしてから有効にし直すと、リカバリーコードが作り直されます(2 要素認証リカバリ方法を設定する)。さらに、2FA を必須にしている組織のメンバーや課金マネージャーは、無効にしている間、その組織のリソースにアクセスできなくなります。その組織のプライベートリポジトリの外部コラボレーターは、組織を離れないと 2FA を無効にできません。組織の側の説明では、無効にした外部コラボレーターは組織から外れるとされています。必須の 2FA の対象になった人は、そもそも 2FA を無効にできません(個人アカウントの 2 要素認証を無効化する・Organization で 2 要素認証を要求する)。機種変更のときは、無効にせずに方法だけを変えてください。
端末をなくして 2FA が通らないとき
2FA が通らないとき、自分で戻れるか
リカバリーコードが手元にあるか
[More options]→[2FA recovery code]
パスキーかセキュリティキーを登録してあるか
それでサインインする
出典:GitHub Docs「二要素認証クレデンシャルをなくした際のアカウント復旧」
サインインの 2FA の画面で、[More options]から予備の手段を選びます。使える手段は次の表のとおりです。このほか、古い設定で予備の SMS 番号(フォールバック番号)を登録している人は、それも使えます(二要素認証クレデンシャルをなくした際のアカウント復旧)。
| 手段 | やり方 | かかる時間 |
|---|---|---|
| リカバリーコード | [More options]→[2FA recovery code]で、未使用のコードを1つ入れる | すぐ |
| パスキー・セキュリティキー | 登録していれば、それでサインインする(パスキーならパスワードも要らない) | すぐ |
| 検証済みデバイス・SSH キー・personal access token | [More options]→[Begin account or email recovery]。登録メールに届くワンタイムパスワードで確かめ、回復に使う手段を選ぶ | GitHub のサポートが確かめ、3営業日以内にメールで返事が来る。公式には、待機期間を3〜5日とする記載もある。しばらく使っていない SSH キーは削除されていることがあり、申請が拒否されることもある |
| どれも無い | GitHub のサポートでもアクセスは戻せない。ロックされたアカウントからメールアドレスを外して、別のアカウントに付け直すことはできる | — |
出典:GitHub Docs「二要素認証クレデンシャルをなくした際のアカウント復旧」
回復の申請を待っている間でも、2FA の資格情報かリカバリーコードが見つかれば、いつでも入れます。パスワードも忘れた場合は、先に https://github.com/password_reset でパスワードの再設定を申し込みます。リセットのメールのリンクは3時間以内に開く必要があります(同)。
個人で使うなら、リカバリーコードとパスキーかセキュリティキーの両方を用意しておけば、締め出される心配はかなり減ります。組織の画面で見られるのは 2FA を有効にしているかどうかまでなので、会社で使うアカウントなら、どの予備の手段を登録したかを本人に申告してもらい、控えておくことをお勧めします。
会社の Organization で 2FA を必須にする
Organization のオーナーは、メンバー・外部コラボレーター・課金マネージャー全員に 2FA を必須にできます。GitHub Free・GitHub Team のプランと、GitHub Enterprise Cloud・Enterprise Server の組織で使えます。ただし、Enterprise Managed Users の組織は除きます(Organization で 2 要素認証を要求する)。
Organization で 2FA を必須にする
出典:GitHub Docs「Organization で 2 要素認証を要求する」
| 誰 | 2FA が無いとどうなるか |
|---|---|
| メンバー・課金マネージャー | 2FA を有効にするまで、組織のリソースにアクセスできない。メンバーの資格は残り、シートも使い続ける |
| 外部コラボレーター | 組織から外れ、リポジトリとプライベートリポジトリのフォークにアクセスできなくなる。外れてから3か月以内に本人が 2FA を有効にし、オーナーが招待し直せば、元の権限に戻せる |
| ボット・サービスアカウント | 外部コラボレーターなら、2FA を設定しないと外れる |
| 組織のただ一人のオーナー | 組織の 2FA の必須を外さない限り、自分の 2FA を無効にできない |
出典:GitHub Docs「Organization で 2 要素認証を要求する」
必須にする前に、メンバーと外部コラボレーターに 2FA の設定を頼み、誰がすでに使っているかを確かめておくよう勧められています。[Only allow secure two-factor methods]を同時にオンにすると、使えるのはパスキー、セキュリティキー、認証アプリ、GitHub Mobile だけになります。SMS など安全でない方法を登録したままの人は組織のリソースにアクセスできなくなるので、前もって SMS を削除するよう伝えておきます。外れた人は、組織の Audit log を action:org.remove_outside_collaborator で検索すると確かめられます(同)。
コマンドラインと API は、パスワードでは入れない
2FA とは別に、GitHub のパスワードで入れるのはブラウザだけで、コマンドラインや API ではほかの資格情報を使います(強力なパスワードの作成)。HTTPS の URL で Git を使うときは、パスワードを聞かれたところに personal access token を入れるか、Git Credential Manager を使います。SSH の URL を使っているなら、2FA を有効にしても何も変わりません(2 要素認証を使用したGitHubへのアクセス)。personal access token の作り方は「個人用アクセス トークンを管理する」にあります。パスワードの条件は、数字と小文字を含む8文字以上か、文字の種類を問わない15文字以上です(強力なパスワードの作成)。
GitHub の 2FA を設定したら、その日のうちにリカバリーコードを保存し、予備の方法を1つ足してください。端末をなくしたときに自分で戻れるのは、そのどちらかがある場合です。社内の開発ツールや業務ツールのアカウントの決め方のご相談は、Aurant Technologies の業務ツール導入・活用支援のページで受け付けています。
サービス一覧
業務ツール・Microsoft 365/Google Workspace・AI活用・データ基盤・広告運用・会計ソフト・LINE運用・アクセス解析の8領域で、選定から構築・定着まで支援しています。課題に近い領域からご覧ください。





