Google Authenticator

提供: ArchWiki
2021年5月14日 (金) 21:28時点におけるBlackle0pard (トーク | 投稿記録)による版 (→‎コードの生成: 追加した項目を日本語訳に修正)
ナビゲーションに移動 検索に移動

Google Authenticator はワンタイムパスコード (OTP) による2段階認証を提供します。OTP 生成アプリケーションは iOS, Android, Blackberry で利用できます。S/KEY 認証と同じように認証機構は Linux の PAM システムに統合されています。このガイドではこの機構をインストール・設定する方法を示します。

インストール

libpam-google-authenticator パッケージをインストールしてください。開発版は google-authenticator-libpam-gitAUR でインストールできます。

PAM の設定

警告: SSH で設定を行っている場合は、全てが動作するか確認する前にセッションを終了してはいけません。自分自身をロックアウトしてしまう危険があります。また、PAM を有効にする前にキーファイルを生成するようにしてください。

大抵は2段階認証が必要になるのはリモートログインのときだけです。該当する PAM 設定ファイルは /etc/pam.d/sshd です。Google Authenticator をあらゆるところで使いたい場合、/etc/pam.d/system-auth に変更を加えます。ただし、その場合は自分を締め出してしまわないように細心の注意を払って下さい。このガイドでは /etc/pam.d/sshd を編集するので、ローカルセッションではとりあえず安全に設定することができます (絶対安全というわけではありません)。

Unix パスワードと OTP の両方を入力するために pam_google_authenticator.so を以下のように /etc/pam.d/sshd の system-remote-login 行の上に追加します:

auth            required        pam_google_authenticator.so
auth            include         system-remote-login
account         include         system-remote-login
password        include         system-remote-login
session         include         system-remote-login

こうすると Unix パスワードの前に OTP を尋ねるようになります。2つのモジュールの順番を入れ替えると訊かれる順序が逆になります。

警告: 秘密鍵ファイルを生成したユーザーだけが SSH を使ってログインできるようになります (下を参照)。

OTP または Unix パスワードのどちらかでログインできるようにするには:

auth            sufficient     pam_google_authenticator.so

/etc/ssh/sshd_config でチャレンジレスポンス認証を有効にします:

ChallengeResponseAuthentication yes

そして sshd の設定をリロードしてください:

# systemctl reload sshd
警告: SSH 鍵のペアによる認証を使っていてパスワードログインを無効化していた場合、OpenSSH はこれら全ての設定を無視します。ただし、OpenSSH 6.2 から、AuthenticationMethods を追加することで2段階認証と鍵による認証の両方を使うことができるようになっています。SSH 鍵#2段階認証と公開鍵 を見て下さい。

秘密鍵ファイルの生成

ヒント: QR コードを生成するには qrencode をインストールします。認証アプリで QR コードをスキャンすれば自動的に鍵が設定されます。

2段階認証を使用したい場合はユーザーのホームフォルダに秘密鍵ファイルを生成する必要があります。google-authenticator を使うことでとても簡単に生成することができます:

$ google-authenticator
Do you want authentication tokens to be time-based (y/n) y
<Here you will see generated QR code>
Your new secret key is: ZVZG5UZU4D7MY4DH
Your verification code is 269371
Your emergency scratch codes are:
  70058954
  97277505
  99684896
  56514332
  82717798

Do you want me to update your "/home/username/.google_authenticator" file (y/n) y

Do you want to disallow multiple uses of the same authentication
token? This restricts you to one login about every 30s, but it increases
your chances to notice or even prevent man-in-the-middle attacks (y/n) y

By default, tokens are good for 30 seconds and in order to compensate for
possible time-skew between the client and the server, we allow an extra
token before and after the current time. If you experience problems with poor
time synchronization, you can increase the window from its default
size of 1:30min to about 4min. Do you want to do so (y/n) n

If the computer that you are logging into is not hardened against brute-force
login attempts, you can enable rate-limiting for the authentication module.
By default, this limits attackers to no more than 3 login attempts every 30s.
Do you want to enable rate-limiting (y/n) y

緊急時のスクラッチコードを安全なところに保管しておくことを推奨します (例: コードを印刷して金庫にしまう)。携帯電話 (つまり OTP 生成ツール) をなくしてしまったときの唯一の (SSH による) ログイン手段となります。コードは ~/.google_authenticator にも保存されるので、ログインしている間はいつでも確認することが可能です。

OTP 生成ツールの設定

下記から携帯電話に生成ツールをインストールしてください。

アプリケーションメニューから適切なボタンをクリックして新しいアカウントを作成し、秘密鍵ファイルを生成したときに表示される URL から QR コードをスキャンするか、秘密鍵を手動で入力します (上の例では 'ZVZG5UZU4D7MY4DH')。

これで30秒ごとに新しく生成されるパスコードトークンをあなたの携帯で見ることができます。

テスト

他のマシンや他のターミナルウィンドウからホストに SSH で接続して認証システムが動作しているか確認してください:

$ ssh hostname
login as: <username>
Verification code: <generated/backup-code>
Password: <password>
$

秘密鍵の保存場所

秘密鍵ファイルの置き場所を変更したい場合、--secret フラグを使います:

$ google-authenticator --secret="/PATH_FOLDER/USERNAME"

/etc/pam.d/sshd を編集して PAM の設定も忘れずに変更してください:

/etc/pam.d/sshd
auth required pam_google_authenticator.so user=root secret=/PATH_FOLDER/${USER}

user=root を使うことで PAM は root ユーザーでファイルを検索します。

また、秘密鍵ファイルのパーミッションに注意してください。所有者だけがファイルを読み込めるように設定してください。例えば root を所有者とする場合:

# chown root:root /PATH_FILE/SECRET_KEY_FILES
# chmod 400 /PATH_FILE/SECRET_KEY_FILES

デスクトップログイン

Google Authenticator の PAM プラグインをコンソールのログインや GDM のログインで使うこともできます。以下を /etc/pam.d/login または /etc/pam.d/gdm-password ファイルに追加してください:

auth required pam_google_authenticator.so

コードの生成

OTP 生成アプリケーションをインストールした機器を紛失した場合、Google Authenticator が設定されたシステムにログインすることが出来なくなります。 コードを使用することで、機器を紛失した場合でもログインすることができるようになります。

コードの管理

gashellAURを使用することで、google authenticatorのコードを表示、作成、管理することが出来ます。代わりに、auther-gitAURを使うことも出来ます。

コマンドライン

oath-toolを使えば、簡単にコードを作成できます。oath-toolkitパッケージをインストールして、以下のコマンドを実行すれば作成できます。

$ oathtool --totp -b secret key

On most Android systems with sufficient user access, the Google Authenticator database can be copied off the device and accessed directly, as it is an sqlite3 database. This shell script will read a Google Authenticator database and generate live codes for each key found:

google-authenticator.sh
#!/bin/sh

# This is the path to the Google Authenticator app file.  It's typically located
# in /data under Android.  Copy it to your PC in a safe location and specify the
# path to it here.
DB="/path/to/com.google.android.apps.authenticator/databases/databases"

sqlite3 "$DB" 'SELECT email,secret FROM accounts;' | while read A
do
        NAME=`echo "$A" | cut -d '|' -f 1`
        KEY=`echo "$A" | cut -d '|' -f 2`
        CODE=`oathtool --totp -b "$KEY"`
        echo -e "\e[1;32m$CODE\e[0m - \e[1;33m$NAME\e[0m"
done