POSTED BY
2025-02-25

プライベートなソースコードをオンラインでバージョン管理する場合GitHubではなく、GitLabのほうを使うことが多い。

GitLabに登録してまず一番最初に行うことは、作業サーバーからPush/Pullするため、SSHキー(公開鍵)の登録することである。これは、User Settings→SSH Keys→Add an SSH keyで、その場で作成(generate one)するか、既存の公開鍵(id_ed25519.pub/authorized_keys)を貼り付ける（秘密鍵id_ed25519ではない）。秘密鍵は自分で持っておく。

SSHキーを登録したら、作業サーバー側の.ssh/configに

Host gitlab.com
IdentityFile ~/.ssh/id_ed25519 #秘密鍵ファイル

などと秘密鍵を指定すれば、

git clone git@gitlab.com:my-group/my-project.git

などと、SSH経由でクローン・Push/Pullが可能となる。

ところで、GitLabのWEB管理画面にログインする場合、セキュリティの観点から、通常のID・パスワードを入力したあと、さらに携帯端末のワンタイムパスワードアプリからワンタイムパスワードを入れなければならない２段階認証を採用している。２段階認証の設定方法は、以下の通りである。

１、User Settings→Account→Two-Factor Authenticationページへ行く

２、携帯端末で、「FreeOTP」アプリをダウンロードして開く

３、GitLabのページに表示されているQRコードをFreeOTPアプリで読み取る

４、FreeOTPアプリで表示された数値文字列(PINコード)をGitLabのページに打ち込む

以上の作業で、次回のログインからは、ユーザー名とパスワード後、アプリで表示されたワンタイムパスワードを打ち込むことで晴れてログイン可能となる。

これはつまり、アプリの存在を忘れて携帯端末を初期化してしまった場合ログイン不可能となることを意味する。

そのようなときに備えて、GitLabの２段階認証設定完了画面でリカバリーコードが表示されていたはずである。これを打ち込めば、再度ログインできるわけだが、それに気づかず閉じてしまいリカバリーコードすら無い状態である。こんな場合どうするか？

このような場合でも、SSHキーの登録さえしていればその場で作業サーバーからリカバリーコードが取得できる。

作業サーバーで、以下のように打つ。

ssh git@gitlab.com 2fa_recovery_codes

Any existing recovery codes you saved will be invalidated. (yes/no)
yes

すると、以下のように１０通りのリカバリーコード１６進文字列が表示される。(*は実際の文字列)

Your two-factor authentication recovery codes are:

***************
***************
***************
***************
***************
***************
***************
***************
***************
***************

During sign in, use one of the codes above when prompted for
your two-factor code. Then, visit your Profile Settings and add
a new device so you do not lose access to your account again.

最初これをどうログイン画面で打つのかわからなかったが、なんてことはない、このなかのどれか１行好きなものを選んで、ワンタイムパスワードの代わりに入力するだけである。

Enter the code from the two-factor app on your mobile device. If you've lost your device, you may enter one of your recovery codes.

と表示されている。ワンタイムパスワード入力フォームに入れれば良いだけ。

このような経験をするともう２段階認証なんてヤメとか思うことがあろうが、２段階認証はプロジェクトグループの管理者が他の作業者を招待する際、その作業者がプロジェクトにアクセスするには２段階認証を必須とするという設定が可能であり、ほとんどの場合それを採用していると思われるので、面倒でも継続しておくべきであろう。