Skip to main content

Google Authentication command line tools

Project description

gacli

gacli was created for used with google-authenticator. Thankfully, TOTP is an open standard so gacli may have additional applications.

The ga command line utility provides convenient access to TOTP verification codes:

usage: ga [-h] [-d] [-f FILE]

Copy newline terminated TOTP verification code to Mac OS X clipboard.

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug           print debug information
  -f FILE, --file FILE  Secret file

The debug option continually prints verification codes instead of copying a
single code to the clipboard.

Security

This application assumes you have secured your local computer disk or filesystem encryption. gacli is only safe with encryption:

Install

Choose either of the following installation methods:

  1. Simple Global

  2. VirtualEnv and User Bin (recommended)

Simple Global

  1. Please consider, again, using the VirtualEnv and User Bin method

  2. Install the pip python module, if you have not already done so.

  3. Install the gacli python module:

    sudo pip install gacli

VirtualEnv and User Bin

This installation method has the following requirements:

Installation:

  1. Create a new gacli virtualenv and install the gacli python module:

    mkvirtualenv -i gacli gacli
  2. Symlink ga to home bin:

    ln -s $(which ga) ~/bin/

Configuration

  1. See Security

  2. Copy the secret key from the first line of your .google_authenticator and put in ~/.ga

  3. Change permissions:

    chmod 0400 ~/.ga

GnuPG Protection

  1. Encrypt secret file:

    cat ~/.ga | gpg -aes -r EMAIL > .ga.gpg
  2. Delete unencrypted secret file:

    rm ~/.ga
  3. Add an alias to your .bashrc:

    alias gad='gpg -qd ~/.ga.gpg | ga -f -'

Requirements

  • Linux or Mac OS X

    • Linux utilizes xclip or xsel.

    • Mac OS X utilizes pbcopy

  • onetimepass

License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gacli-1.0.3.tar.gz (5.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page