| 1 | == Building and installing Google Authenticator == |
| 2 | |
| 3 | Note that this applies only to building the authenticator piece. Information on installing and using the token generator is available [[http://www.google.com/support/accounts/bin/answer.py?hl=en&answer=1066447|here]], with the caveat that if you're not planning on using two-factor authentication with your Google accounts, just download the app. Do NOT follow the instructions to configure your Google account. |
| 4 | |
| 5 | The following applies to making Google Authenticator part of the two-factor authentication procedures on your Linux box. |
| 6 | |
| 7 | Prerequisites: |
| 8 | |
| 9 | * C compiler with standard libraries and headers |
| 10 | * libpam (might be libpam0g) |
| 11 | * libpam-dev (might be libpam0g-dev) |
| 12 | * libpam-modules |
| 13 | * libpam-runtime |
| 14 | * any application-specific pam modules that might be applicable, such as libpam-ssh |
| 15 | * mercurial (the distributed source code control system) |
| 16 | * optional but highly desirable: libqrencode3 and libqrencode-dev |
| 17 | |
| 18 | Procedure: |
| 19 | |
| 20 | 1. Download source from code.google.com using the instructions at [[http://code.google.com/p/google-authenticator/source/checkout]] |
| 21 | 2. cd into the google-authenticator/libpam directory |
| 22 | 3. type "make" |
| 23 | 4. run it locally to make sure that it built correct. When it asks if you want to update your "~/.google_authenticator" file, type "n". Note that if you do not see a QR barcode on your screen, libqrencode-dev is not installed. The interaction should look something like this: |
| 24 | [[Image(Screenshot-sxmls@google-authenticator.png)]] |
| 25 | 5. If it looks healthy, with root privileges type "make install" |