GitHubにログインできない原因と対処|2FA端末の紛失・パスワード・SSO

GitHubにログインできないときに、止まっている場所(パスワード・2FA・組織のSSO・コマンドラインの資格情報)を見分け、本人で戻せるもの、組織のオーナーに頼むもの、誰にも戻せないものを GitHub Docs に沿ってまとめました。2FAの端末をなくしたときのリカバリーコードとアカウント回復の申請、SSOの再認証とトークンの承認も扱います。

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

この記事の要点

  1. GitHub のサインインは github.com/login から行います。入れないときは、止まっている場所が「パスワード」「2FA」「組織の SSO」「コマンドラインの資格情報」のどれかによって、やることと戻せる人が変わります。
  2. パスワードと 2FA は本人が戻します。2FA の端末をなくしたらリカバリーコードか予備の方法で入り、どれも無ければアカウント回復を申請します。回復の手段をすべて失ったアカウントは、GitHub のサポートでも戻せません。
  3. 外部 ID のリンクの取り消しや、IdP が使えないときの回復コードなど、組織の側で止まっているものは組織のオーナーが扱います。SSO や 2FA を必須にする前に、影響を確かめて周知します。

入れないとき、誰が戻せるか

本人が戻せるサインインの画面・Settings で
パスワードを忘れたgithub.com/password_reset で再設定
2FA のコードが通らないアプリ・時刻・アカウントの項目を確かめる
2FA の端末をなくしたリカバリーコード・パスキーなどで入る
組織のリポジトリだけ開けないIdP で認証し直す
git や API が通らないトークンや SSH キーを作り直す・SSO で承認する
組織が 2FA を必須にした(メンバー)自分の 2FA を有効にすれば戻る
組織のオーナーに頼む組織の Settings・People で
別の外部 ID がリンクされているリンクを取り消す
IdP が使えないSSO の回復コードで入る
2FA の必須化で外れた外部コラボレーター本人が 2FA を有効にしたあと招待し直す
戻せないGitHub のサポートでも
2FA の資格情報と回復の手段をすべて失ったメールアドレスのリンクを外して、別のアカウントで使う

出典:GitHub Docs「アカウント復旧」「SSO での認証」「メンバーの SAML アクセス」「回復ポリシー」

GitHub のサインインは github.com/login から行います。入れないときは、止まっている場所が「パスワード」「2FA(2 要素認証)」「会社の組織の SSO(シングル サインオン)」「コマンドラインや API の資格情報」のどれなのかを先に見分けると、やることが決まります。

この記事は、Aurant Technologies の守高が書いています。当社は、GitHub を含む業務ツールを会社に入れ、社員が使いこなすまでを支援しています。GitHub は2023年3月から、コードを投稿するユーザーに 2FA を順に必須にしています(必須の 2 要素認証について)。2FA を有効にした人は、端末をなくすとパスワードだけでは入れません。ここでは、止まっている場所ごとに本人で戻れるのか、組織のオーナーに頼むのか、誰にも戻せないのかを分けてまとめます。2FA の設定のしかたと、締め出されないための予備の方法の選び方は「GitHubの2段階認証(2FA)設定方法」に分けました。SAML SSO の構築手順と、Enterprise Managed Users の運用は扱いません。画面の名前は GitHub Docs の日本語版(2026年10月13日に確認)の表記に合わせています。

入れないとき、止まっている場所を見分ける

どこで止まっているか

1

パスワードの画面で止まる

パスワードを忘れた・違うと言われる

2

パスワードの後の 2FA の画面で止まる

コードが通らない・端末が手元に無い

3

サインインはできるが、会社の組織のリポジトリだけ開けない

組織の SSO・組織の 2FA の必須化

4

ブラウザーでは入れるが、git や API が通らない

トークン・SSH キー・SSO の承認

当てはまる行がある下の、同じ名前の節へ進む
ブラウザーで入れても制限が出る「アカウントが制限されたとき」へ

出典:GitHub Docs「GitHubへの認証について」

会社が用意したマネージド ユーザー(Enterprise Managed Users)のアカウントは、会社の IdP(ID を管理するサービス)で認証します(GitHubへの認証について)。入れないときは、IdP の担当に確かめます。

パスワードの画面で止まる

パスワードを再設定する

github.com/password_resetメールアドレスを入れる
[パスワード リセット メールの送信]プライマリかバックアップのアドレス
メールのリンクを開く受け取ってから3時間以内
2FA を求められたら通すコードかリカバリーコードなど
新しいパスワードを2回入れる[パスワードの変更]

出典:GitHub Docs「GitHub アクセス資格情報の更新」

使えるのはプライマリとバックアップのメールアドレスだけです。バックアップのアドレスを選んでいなければ、確認済みのアドレスはすべてバックアップとして扱われます。届かないときは迷惑メールのフォルダを見ます。2FA を有効にしているアカウントは、リンクを開いたあとで 2FA を求められます。パスキーかセキュリティキー([Use passkey or security key])、GitHub Mobile のプッシュ通知、TOTP か SMS のコード、リカバリーコード([Verify])のどれかで通します(GitHub アクセス資格情報の更新)。

パスワードではなく Google か Apple のソーシャル ログインでアカウントを作った人は、そちらで入ります。パスキーを登録していれば、パスキーだけでパスワードと 2FA の両方を満たせます(GitHubへの認証について)。2FA を有効にしていないアカウントは、新しい端末やブラウザーから初めて入るときに、追加の確認を求められることがあります(GitHubへの認証について)。

2FA の画面で止まる

「Two-factor authentication failed」と出る

入れた認証コードが正しくないという表示です。アカウントの回復を申請する前に、使っている方法ごとに次を確かめるよう、GitHub は案内しています(二要素認証の問題を解決する方法)。GitHub のサポートは、SMS の配信を含めて 2FA の方法のトラブルを調べることはできないとしているので、ここは本人が確かめます。

2FA のコードが通らないときに確かめること
方法確かめること
TOTP アプリ2FA を設定したときのアプリか。アプリの中の正しいアカウントの項目か。端末の日付・時刻・タイムゾーンが自動設定になっているか。次のコードが出るのを待ってすぐ入れたか。コードは30秒ごとに変わる。空白は入れない
SMS端末と料金プランが SMS の受信に対応しているか(データ専用のプランなどは受け取れないことがある)。おやすみモードや迷惑メッセージを止めるアプリが邪魔していないか。電波が十分か。電源を入れ直す。地域の障害を携帯電話会社に確かめる
リカバリーコード「Recovery code authentication failed」なら、そのコードは無効。コードは xxxxx-yyyyy の形の10文字で、1つずつ入れる。一度使ったコードは使えない。2FA を有効にし直したり新しいセットを作ったりすると、古いセットは無効になる(既定のファイル名は github-recovery-codes.txt)

出典:GitHub Docs「二要素認証の問題を解決する方法」

TOTP アプリのクラウドへのバックアップがあれば、新しい端末に戻せることがあるので、回復の申請より先に試します(二要素認証の問題を解決する方法)。

2FA の端末をなくした・機種を変えて入れない

2FA の画面の[More options]から、予備の手段を選びます(二要素認証クレデンシャルをなくした際のアカウント復旧)。手元にあるものを上から順に試します。

2FA の端末が無いとき、自分ですぐ戻れるか

1

リカバリーコードが残っているか

[More options]→[2FA recovery code]。パスワードの再設定の途中でも使える

2

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

それで 2FA を通す。パスキーならパスワードも要らない

3

古い設定のフォールバック番号があるか

その番号に届くコードを入れる

どれか「はい」その場で戻れる
どれも無い[Begin account or email recovery]で回復を申請する

出典:GitHub Docs「アカウント復旧」「2FA でのアクセス」

まだサインインしたままのブラウザーが残っていれば、Settings の Password and authentication で「回復コード」の横の[表示]から、リカバリーコードを見直せます(2 要素認証リカバリ方法を設定する)。表示するときは、サインイン中でも認証を求められることがあります。この認証はパスワードでも通せます。一度通せば、2時間は聞かれません(Sudo モード)。

予備の手段が何も無い:アカウント回復を申請する

アカウント回復を申請する

[More options]2FA の画面で
[Begin account or email recovery]モーダルで開始する
メールのワンタイムパスワード求められたら入れて確認
確認の要素を選ぶこのデバイス・SSH キー・personal access token
サポートの確認を待つ3営業日以内にメールで返事

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

確認には、いま使っている端末で以前にそのアカウントに入ったことがあればその端末([Verify with this device])、または以前に設定した SSH キーか personal access token を使います。しばらく使っていない SSH キーはアカウントから消えていることがあり、使ったことがある方法でも確認に使えない場合があります。承認されれば回復を終えるリンクが、拒否されればサポートへの問い合わせ方法がメールで届きます。パスワードもわからないときは、先にパスワードの再設定を始め、2FA を求められたところで[Begin account or email recovery]を選びます。待っている間(3〜5日の待機期間)でも、2FA の資格情報かリカバリーコードが見つかれば、いつでも入れます(アカウント復旧)。検証済みの端末は Cookie で見分けているので、ブラウザーの Cookie を毎日消す設定だと、回復に使える端末がなくなります(必須の 2 要素認証について)。

どの回復の手段も使えなければ、そのアカウントには二度と入れません。GitHub のサポートは、2FA の資格情報か回復の手段を失った場合に、2FA が有効なアカウントへのアクセスを戻さず、本人確認などほかの方法での回復も受け付けないとしています。できるのは、ロックされたアカウントからメールアドレスのリンクを外して、新しいアカウントか別の既存のアカウントでそのアドレスを使うことと、パブリックのコンテンツをクローンやフォークすることです。組織のプライベートのコンテンツは、組織のほかのメンバーにクローンやフォークを頼みます(GitHub アカウント回復ポリシー)。入り直せたら、リカバリーコードを保存し直し、予備の方法を足しておきます。手順は「GitHubの2段階認証(2FA)設定方法」にまとめています。

組織のリポジトリだけ開けない

SAML SSO を使う組織では、組織のほとんどのリソースにアクセスしようとすると、GitHub が組織の IdP の画面に転送します。そこで認証すると、GitHub に戻ってきます。認証は定期的にし直す必要があり、IdP に別の指定が無ければ、その間隔は24時間です(シングル サインオンでの認証について)。Enterprise Managed Users でなければ、メンバーがサインインするのは GitHub.com の自分の個人アカウントのままです(SAML シングルサインオンを使うアイデンティティおよびアクセス管理について)。

組織のリポジトリだけ開けないときは、ブラウザーで https://github.com/orgs/組織名/sso を開くと、SSO のセッションを作り直せます。OAuth app や GitHub App を承認するときも、アクティブな SSO のセッションが要ります。組織が SSO を有効にしたあとは、以前に承認したアプリを承認し直します(シングル サインオンでの認証について)。

IdP で認証したのに入れず、その ID ではサインインできないというエラーが出る場合は、その外部 ID がすでに別の GitHub アカウントにリンクされています。組織では、1つの GitHub アカウントにリンクできる外部 ID は1つです。いまのアカウントで使うなら、前のアカウントからリンクを外すよう、組織の管理者に頼みます。設定によっては、管理者が IdP の側で ID を割り当て直す必要もあります。リンク済みと違う ID で入ろうとすると、リンクをし直すという警告が出ます。そのまま進めると、チームや組織に入れなくなることがあります(シングル サインオンでの認証について)。

組織が 2FA を必須にしていると、2FA の無いメンバーは、有効にするまで組織のリソースに入れません。安全な方法だけに絞る設定なら、SMS を登録したままの人も入れません(Organization で 2 要素認証を要求する)。なお、外部コラボレーターには SSO の認証は要りません(シングル サインオンでの認証について)。

ブラウザーでは入れるが、git や API が通らない

GitHub のパスワードで入れるのはブラウザーだけです。コマンドラインや API では、Git にパスワードを聞かれたところに personal access token を入れるか、Git Credential Manager などの認証情報ヘルパーを使います。Git のパスワードでの認証はすでに廃止されています(強力なパスワードの作成)。

昨日まで通っていたトークンが急に通らなくなったときは、失効を疑います。トークンは、作るときに決めた有効期限に達したとき、パブリックのリポジトリかパブリックの gist にプッシュされたとき、1年使われなかったときに、自動で取り消されます。期限切れや取り消されたトークンは戻せないので、作り直します(トークンの有効期限と取り消し)。

SSO を使う組織のリポジトリに git や API で入るには、組織での使用を承認した personal access token か SSH キーが要ります。personal access token (classic) と SSH キーは、作ったあとで承認します。fine-grained personal access token は、作るときに承認されます(シングル サインオンに使用する個人用アクセス トークンの認可)。

personal access token (classic) を SSO で承認する

Settingsプロフィール写真から
Developer settings左のサイドバー
Personal access token左のサイドバー
[トークン (クラシック)]classic のトークンの一覧
[SSO の構成]トークンの横
組織の右の[承認]ドロップダウンで

SSH キーは Settings → SSH and GPG keys で、同じく[SSO の構成]→[承認]

出典:GitHub Docs「個人用アクセス トークンの認可」「SSH キーの認可」「個人用アクセス トークン」

[SSO の構成]が出ないときは、IdP を通して一度は組織のリソースに認証しているかを確かめます。承認の前に、ブラウザーで組織に SSO で入って外部 ID をリンクしておく必要があります。一度承認したトークンやキーも、組織のオーナーが承認を取り消したとき、組織から外れたとき、トークンのスコープを変えたり作り直したりしたとき、期限が切れたときには、使えなくなります。一度でも SSO でその組織に認証して ID がリンクされていれば、SSO が強制されていなくても、使えるのはその組織で承認したトークンと SSH キーだけです。組織に承認を取り消された SSH キーは、もう一度承認できないので、新しいキーを作って承認します(シングル サインオンに使用する SSH キーの認可)。

組織の側でトークンを制限していることもあります。組織のオーナーは、personal access token (classic) や fine-grained personal access token で組織のリソースに入れないようにでき、有効期間の上限も決められます。上限に合わないトークンは、取り消されませんが組織には入れなくなります。fine-grained personal access token は、既定では組織のオーナーの承認が要ります(オーナー本人が作ったものは不要)。承認されるまでは、組織のパブリックのリソースを読むことしかできません(GitHub Docs 英語版「Setting a personal access token policy」)。classic のトークンを止めている組織に classic で入ろうとすると、403 で失敗します(個人用アクセス トークンを管理する)。

personal access token の2種類
項目fine-grainedclassic
入れる範囲1人のユーザーか1つの組織のリソースだけ。さらに特定のリポジトリに絞れるアクセスできるすべてのリポジトリ
権限細かいアクセス許可を選ぶスコープで選ぶ
組織の承認既定でオーナーの承認が要る(オーナーが作ったものは不要)承認の対象にならない(組織が classic を止めていなければ入れる)
有効期間の上限(組織のポリシー)既定で366日以内有効期限の要件なし
GitHub Docs の位置づけ特定のリポジトリに絞れるので、こちらが勧められている安全性が低いが、一部の機能はこちらでしか動かない

出典:GitHub Docs「個人用アクセス トークン」「トークン ポリシー」(英語版:Managing your personal access tokens・Setting a personal access token policy)。日本語版には、推奨や承認の既定が英語版と逆に読める訳の箇所があるため、英語版で確かめた

personal access token は、自分の代わりに GitHub のリソースに入るためのものです。組織の代わりに入るときや、長く動かし続ける連携には、GitHub App を使うよう GitHub Docs は書いています(個人用アクセス トークンを管理する)。personal access token は作ったユーザーに結び付いていて、その人がリソースへのアクセスを失うと自動化が止まることがあります。組織に入れた GitHub App はユーザーに依存せず、最初に入れた人が組織を離れても入ったままです(GitHub アプリをビルドするタイミングを決定する)。会社の自動化には、GitHub App を使うことをお勧めします。

アカウントが制限されたとき

GitHub が疑わしい動きを見つけると、サインイン中の個人アカウントを一時的に制限したり、停止したりすることがあります。制限されたら、まずパスワードを変え、知らないアプリ・キー・資格情報を消します。登録しているメールアドレスのアカウントも守ります。そのうえで、受信トレイと迷惑メールのフォルダで GitHub からのセキュリティのメールを探し、その指示に従います。それでも制限が残るとき、またはまったく入れないときは、GitHub のサポートに問い合わせます(許可されていないアクセスを防止する)。

組織のオーナーがやること

メンバーから「入れない」と言われたら、どこで止まっているかを聞きます。組織のオーナーが手を動かすのは、組織の側で止まっている場合です。パスワードや 2FA で止まっているなら、本人の手順で戻ります。

組織のオーナーが行うこと

別の外部 ID がリンクされた

リンクを取り消す

  • People → メンバー → [SAML ID のリンク]
  • 本人が正しい ID でやり直せる
  • SCIM の組織では SAML と SCIM のメタデータも消えるので、IdP の側で外す

トークン・キーを止めたい

承認を取り消す

  • 同じ画面の Authorized credentials
  • SAML の承認だけが消え、トークン自体は残る

IdP が使えない

SSO の回復コードで入る

  • [回復コードを使う]
  • 1つのコードは1回限りで、順に使う。入れるのは24時間

必須化で外れた人

組織に戻す

  • 2FA で外れた外部コラボレーター:本人が有効にしたあと招待し直す(メンバーは外れない)
  • SSO の強制で外れた人:本人が SSO で認証して入り直す
  • 3か月以内なら権限と設定が戻る

出典:GitHub Docs「メンバーの SAML アクセス」「IdP が使えないとき」「SAML SSO の施行」「2 要素認証の要求」

IdP が止まったときに組織に入るための SSO の回復コードは、組織の Settings の Security にある Authentication security で、「SAML シングル サインオン」の下の[リカバリ コードを保存]から、ダウンロード・印刷・コピーします。共有や配布をせず、パスワードマネージャーに保存するよう勧められています(組織の SAML シングル サインオンのリカバリコードをダウンロードする)。

オーナーが1人だけだと、その人に連絡がつかないときに組織のプロジェクトに入れなくなるおそれがあるので、GitHub は各組織で少なくとも2人をオーナーにするよう勧めています(組織の所有権の継続性を維持する)。GitHub のサポートは、2FA が有効なアカウントへのアクセスを戻しません(GitHub アカウント回復ポリシー)。オーナーの1人が 2FA の端末をなくして入れなくなっても組織の管理を続けられるよう、2人目のオーナーを置いておくことをお勧めします。原因を調べるときは、組織の Audit log を見ます。見られるのはオーナーだけで、過去180日のイベントが残り、既定では直近3か月分が表示されます(あなたの組織の監査ログを確認する)。2FA の必須化で外れた人も、Audit log で確かめられます(Organization で 2 要素認証を要求する)。

組織の設定を変える前に知っておくこと

組織の認証の設定には、オンにするとメンバーを組織から外したり、組織のリソースに入れなくしたりするものがあります。変える前に影響を確かめて周知します。

変えると、メンバーに何が起きるか

SAML SSO を強制する

組織の Authentication security

  • IdP で認証していないメンバーと管理者は組織から外れる(メールで通知)
  • 外部 ID の無いボット・サービスアカウントも外れる
  • 3か月以内に SSO で入り直せば、権限と設定が戻る

先にやる:一度は IdP で認証し、回復コードを保存する

2FA を必須にする

組織の Authentication security

  • 2FA の無いメンバー・課金マネージャーは組織のリソースに入れない
  • 2FA の無い外部コラボレーターは組織から外れる
  • 安全な方法だけに絞ると、SMS を使っている人も入れない

先にやる:メンバーの 2FA の有無を確かめて、設定を頼む

トークンのポリシー

組織の Personal access token

  • classic や fine-grained のトークンで組織に入れなくできる
  • 有効期間の上限に合わないトークンは組織に入れない
  • fine-grained のトークンに、オーナーの承認を求められる

先にやる:自動化に使っているトークンを洗い出す

出典:GitHub Docs「SAML SSO の施行」「2 要素認証の要求」「トークン ポリシー」

SAML SSO は、組織が GitHub Enterprise Cloud を使っている場合の機能です。有効にしただけなら、メンバーは IdP で認証する前でも組織のリソースに入れます。メンバーが外れるのは、強制したときです。全メンバーに SAML SSO 認証を要求するチェックボックスを外しておけば、メンバーに影響を与えずに試せます(組織における SAML シングルサインオンを施行する)。2FA の必須化で起きることの細部は「GitHubの2段階認証(2FA)設定方法」の後半にまとめています。

入れないときは、まず止まっている画面を確かめてください。本人で戻せるものは上の手順で試し、組織の側で止まっているものは、その画面と組織名を添えて組織のオーナーに連絡してください。GitHub を含む業務ツールのアカウントや権限を、誰が戻せるかまで決めて入れたいときのご相談は、Aurant Technologies の業務ツール導入・活用支援のページで受け付けています。

サービス一覧

業務ツール・Microsoft 365/Google Workspace・AI活用・データ基盤・広告運用・会計ソフト・LINE運用・アクセス解析の8領域で、選定から構築・定着まで支援しています。課題に近い領域からご覧ください。

AT
aurant technologies 編集

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

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