Google Authenticator (简体中文) - ArchWiki

Jump to content

# Google Authenticator (简体中文)

From ArchWiki
翻译状态：本文是 Google_Authenticator 的翻译。上次翻译日期：2020-02-11。如果英文版本有所更改，则您可以帮助同步翻译。

Google Authenticator 使用一次性密码(One-time Passcodes)(OTP)进行两步验证。iOS、Android 和 Blackberry 上都提供了 OTP 生成器应用。两步验证的机制集成在Linux的 PAM 系统中。此指南显示了此两步验证机制的安装与配置。

## 安装

安装 libpam-google-authenticator 软件包或开发者版本 google-authenticator-libpam-gitAUR。

## 设置插入式验证模块(Pluggable Authentication Modules)

警告： 若通过 SSH 进行 Google Authenticator 的所有配置，在完成所有配置并测试正常之前，请勿关闭 SSH 会话，否则可能会无法登录。此外，最好在激活 PAM 之前生成密钥文件。

通常远程登录才需要设置两步验证。对应的PAM的配置在文件`/etc/pam.d/sshd`内。如果想全局使用谷歌两步身份验证，请小心的修改`/etc/pam.d/system-auth`，以免锁定自己从而不能登录。在本指南中，我们将在本地会话中编辑 SSH 登录配置文件`/etc/pam.d/sshd`，这样就算操作出错，也不会影响您的登录(但不是必须的)。

要同时输入 Unix 密码与两步验证码登录，请在 `/etc/pam.d/sshd`文件的system-remote-login行之上添加`pam_google_authenticator.so`：

     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 密码。交换`pam_google_authenticator.so`与 system-remote-login 两行会改变验证顺序。

警告： 只有生成密钥文件(见下)的用户才会被允许SSH登录。

要允许使用 Unix 密码或两步验证码登录，请修改:

     auth            sufficient      pam_google_authenticator.so

在文件`/etc/ssh/sshd_config`内开启质疑-应答认证(challenge-response authentication)：

     ChallengeResponseAuthentication yes

最后 重新加载 `sshd` 服务。

警告： 如果设置使用密钥登陆并禁止密码登录, OpenSSH 会忽略如上所有的配置。但是在 OpenSSH 6.2 版本以后，允许使用基于密钥和两步验证的验证。请参阅 SSH的双因素验证与公钥。

### 只对在本地网络外的登录启用两步验证

有时,我们只希望对不在本地网络内发起的 SSH 连接启用两步验证。此时，建立一个文件(比如`/etc/security/access-local.conf`)，然后仿照下面的例子配置你想要跳过两步验证的网络地址：

    # only allow from local IP range
    + : ALL : 192.168.20.0/24
    # Additional network: VPN tunnel ip range (in case you have one)
    + : ALL : 10.8.0.0/24
    + : ALL : LOCAL
    - : ALL : ALL

然后编辑你的`/etc/pam.d/sshd`，添加这一行:

    #%PAM-1.0
    #auth     required  pam_securetty.so     #disable remote root
    auth [success=1 default=ignore] pam_access.so accessfile=/etc/security/access-local.conf
    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

## 生成密钥文件

提示： 安装 qrencode 以在屏幕上生成可以扫描的二维码。扫描二维码以自动配置两步验证器。

每一个想要使用两步验证的用户需要在其用户目录生成一个密钥文件，使用命令google-authenticator来完成：

       $ google-authenticator
       Do you want authentication tokens to be time-based (y/n) y
       <这里是自动生成的二维码>
       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
       (是否拒绝多次重复使用相同的令牌？这将限制你每30s仅能登录一次，但会提醒/阻止中间人攻击。)

       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
       (是否将窗口时间由1分30秒增加到约4分钟？这将缓解时间同步问题。)

       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
       (是否启用此模块的登录频率限制，登录者将会被限制为最多在30秒内登录3次。)

建议您将备用令牌码保存在安全的地方(打印出来并放在一个安全的位置)，因为当丢失手机(即你的两步验证器)或其他原因不能使用两步验证器时，只能使用备用令牌码登录。它们同时也被保存在`~/.google_authenticator`，你可以在登录后随时查阅。

## 设置两步验证器

在你的手机上安装两步验证器软件。例如：

- FreeOTP : Android(Play商店)/iOS.
- Google Authenticator Android(Play商店)/iOS.

在软件中创建一个新验证，输入密钥(如例子中的'ZVZG5UZU4D7MY4DH')或扫描二维码来导入密钥，并依照屏幕提示输入验证码。

软件现在应该会显示一个每30秒更新的验证码。

## 测试

从另一台设备和/或另一个终端连接到完成了上述配置的主机:

    $ ssh hostname
     login as: <username>
     Verification code: <令牌码/备用令牌码>
     Password: <password>
    $

## 存储位置

如果想要改变密钥存储位置，请使用`--secret`参数:

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

然后更改`/etc/pam.d/sshd`内的路径配置:

    /etc/pam.d/sshd

    auth required pam_google_authenticator.so user=root secret=/PATH_FOLDER/${USER}

`user=root` 用于强制PAM使用root用户权限来搜索文件。

另外请注意，密钥文件的所有者是root，生成文件的用户只能读取文件(chmod: `400`)。

    $ chown root.root /PATH_FILE/SECRET_KEY_FILES
      chmod 400 /PATH_FILE/SECRET_KEY_FILES

## 用于桌面登陆

谷歌两步认证插件可以同时用于控制台与 GNOME 桌面登录。只需要在文件 `/etc/pam.d/login` 或 `/etc/pam.d/gdm-password` 内加入

       auth required pam_google_authenticator.so

## 生成两步验证代码

如果你在其他的系统也配置了Google Authenticator，那么如果手机丢失(即你的两步验证器)你就无法登录这些系统了。使用额外的两步验证代码生成方法有时很有帮助。

### 代码管理器

一个可以显示、生成、储存、管理两步验证代码的脚本可以从 gashellAUR 安装。此外，还有可替代的 auther 程序 auther-gitAUR。

### 命令行

生成两步验证代码最简单的方法是使用`oath-tool`。可以从 oath-toolkit 安装, 并这样使用:

    oathtool --totp -b ABC123

其中， `ABC123` 是配置密钥。

在绝大多数有足够的用户权限的Android系统上，Google Authenticator的数据库可以被拷贝出设备并直接访问。这是一个 SQLite3 数据库。你可以用以下的shell脚本读取Google Authenticator的数据库并对每一个储存的密钥生成动态的两步验证码。

    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

Categories:

- Authentication (简体中文)
- Google (简体中文)