GitHubの2段階認証(2FA)設定方法|方式の選び方と組織での必須化

GitHubの2段階認証(2FA)の設定方法を、TOTP アプリでの手順、方式の選び方、端末をなくしたときの戻り方、Organization で必須にしたときに起きることまで、GitHub Docs に沿ってまとめました。設定するときにリカバリーコードと予備の方法までそろえておくのが、締め出されないための要点です。

この記事をシェア:
目次 クリックで開く

この記事の要点

  1. GitHub の2段階認証(公式の呼び名は「2 要素認証」、2FA)は、Settings → Password and authentication の「2 要素認証」から設定します。最初に設定できるのは TOTP アプリ(認証アプリ)か SMS で、GitHub は TOTP アプリを勧めています。
  2. GitHub のサポートは、2FA の資格情報と回復の手段をすべて失ったアカウントのアクセスを戻しません。設定するときに、リカバリーコードの保存と、2つ目の方法(パスキー・セキュリティキー・GitHub Mobile)の追加まで済ませます。
  3. 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 要素認証について)。

対象になるのは、次のような行動をしたアカウントです(同)。

  • ほかのユーザーにアプリやアクションを公開した
  • リポジトリのリリースを作った
  • 重要度の高いリポジトリに貢献した、またはその管理者や共同作成者になった
  • リポジトリやほかのユーザーがいる組織の、オーナーになった
  • パッケージを発行したリポジトリの管理者や共同作成者になった
  • エンタープライズの管理者になった

この条件は、今後変わることがあるとされています。

必須の 2FA でよく迷う点
気になること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 要素認証について)。

2FA の方法
方法主か予備か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 を有効にする

Settingsプロフィール写真から
Password and authenticationサイドバーの Access
「2 要素認証を有効にする」「2 要素認証」の欄
QR コードを読むアプリに出た6桁を入れる
リカバリーコードを保存[ダウンロード]→[リカバリ コードを保存しました]

出典:GitHub Docs「2 要素認証を設定する」

QR コードを読めないときは「セットアップ キー」を選ぶと、TOTP アプリに手で入れるためのシークレットが表示されます。アプリが表示した6桁のコードを、GitHub の「Verify the code from the app」の欄に入れます。最後に「リカバリ コードの保存」で[ダウンロード]を押し、安全な場所に保存してから[リカバリ コードを保存しました]を押すと、2FA が有効になります(2 要素認証を設定する)。

TOTP アプリに手で入れるときの値
項目値
型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 アプリ)

新しい端末に TOTP アプリを入れる古い端末はまだ消さない
Password and authentication「2 要素メソッド」
変える方法の[編集]2FA は無効にしない
新しいアプリで QR コードを読む6桁のコードを入れる
[保存]ここで初めて切り替わる

2FA を無効にして入れ直すと、リカバリーコードが作り直される。2FA を必須にしている組織のリソースにも、無効の間は入れない

出典:GitHub Docs「2 要素認証方法の変更」「2 要素認証リカバリ方法を設定する」

2FA をいったん無効にしてから有効にし直すと、リカバリーコードが作り直されます(2 要素認証リカバリ方法を設定する)。さらに、2FA を必須にしている組織のメンバーや課金マネージャーは、無効にしている間、その組織のリソースにアクセスできなくなります。その組織のプライベートリポジトリの外部コラボレーターは、組織を離れないと 2FA を無効にできません。組織の側の説明では、無効にした外部コラボレーターは組織から外れるとされています。必須の 2FA の対象になった人は、そもそも 2FA を無効にできません(個人アカウントの 2 要素認証を無効化する・Organization で 2 要素認証を要求する)。機種変更のときは、無効にせずに方法だけを変えてください。

端末をなくして 2FA が通らないとき

2FA が通らないとき、自分で戻れるか

1

リカバリーコードが手元にあるか

[More options]→[2FA recovery code]

2

パスキーかセキュリティキーを登録してあるか

それでサインインする

どちらか「はい」すぐ自分で戻れる
両方「いいえ」[Begin account or email recovery]で申請し、サポートの確認を待つ

出典:GitHub Docs「二要素認証クレデンシャルをなくした際のアカウント復旧」

サインインの 2FA の画面で、[More options]から予備の手段を選びます。使える手段は次の表のとおりです。このほか、古い設定で予備の SMS 番号(フォールバック番号)を登録している人は、それも使えます(二要素認証クレデンシャルをなくした際のアカウント復旧)。

2FA が通らないときに使える手段
手段やり方かかる時間
リカバリーコード[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 を必須にする

Your organizationsプロフィール画像から
組織の Settings組織名の下
Authentication securityサイドバーの Security
[Organization 内のすべてのユーザーに 2 要素認証を要求する][保存]→[Confirm]

出典: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領域で、選定から構築・定着まで支援しています。課題に近い領域からご覧ください。

AT
aurant technologies 編集

上場企業からスタートアップまで、数多くのデータ分析基盤構築・AI導入プロジェクトを主導。単なる技術提供にとどまらず、MA/CRM(Salesforce, Hubspot, kintone, LINE)導入によるマーケティング最適化やバックオフィス業務の自動化など、常に「事業数値(売上・利益)」に直結する改善実績多数。

この記事が役に立ったらシェア: