要約
- Nulab連携 + 2要素認証を有効にしていると、NulabパスワードはHTTPS git認証に使えない
- Backlogの個人設定から Git(https)専用パスワード を発行して解決
状況
BacklogからHTTPS経由でgit cloneを実行したところ、IDとパスワードは合っているはずなのに認証エラーが発生した。
$ git clone https://xxx.backlog.jp/git/PROJECT/repo.git
Cloning into 'repo'...
Username for 'https://xxx.backlog.jp': your-id
Password for 'https://your-id@xxx.backlog.jp':
remote: Invalid username or password.
fatal: Authentication failed for 'https://xxx.backlog.jp/git/PROJECT/repo.git'
半日ほど悩んだ末、原因が判明した。
前提条件（環境）
- BacklogはNulabアカウントと連携済み
- Nulabで 2要素認証（2FA）を有効化 している
原因
Nulab連携をしている場合、git clone（HTTPS）のパスワードには通常Nulabのパスワードを使う。
しかし、Nulabで2要素認証を有効にしていると、NulabパスワードはHTTPS git認証に使えなくなる。
理由はシンプルで、HTTPS git認証には2FAを突破する仕組みがない。そのため、2FAを有効にした時点でNulabパスワードによるgit認証がブロックされる。
解決策：Backlog専用パスワードを発行する
以下の手順でGit(https)専用のパスワードを発行し、それを使う。
手順
- Backlogにログインする
- 画面右上の個人アイコン → 「個人設定」 を選択
- 左メニューの 「パスワード」 を選択
- 画面下部の 「新しいパスワードを発行」 で有効範囲を 「Git(https)」 に設定し、登録ボタンを押下
- 表示されたパスワードをgit clone時に使用する
$ git clone https://xxx.backlog.jp/git/PROJECT/repo.git
Username for 'https://xxx.backlog.jp': your-id
Password for 'https://your-id@xxx.backlog.jp': （発行されたパスワードを入力）
Cloning into 'repo'... ✅
まとめ
| 環境 | git clone時のパスワード |
|---|---|
| Nulab連携のみ | Nulabのパスワード |
| Nulab連携 + 2要素認証 | Backlog個人設定で発行した専用パスワード |
公式ドキュメントにも記載はあるが、エラーメッセージだけ見ていると気づきにくい。同じ状況でハマっている人の参考になれば幸いです。