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 details)

Uploaded Source

File details

Details for the file gacli-1.0.3.tar.gz.

File metadata

  • Download URL: gacli-1.0.3.tar.gz
  • Upload date:
  • Size: 5.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for gacli-1.0.3.tar.gz
Algorithm Hash digest
SHA256 924a536c9a403b0d61526838f6199a0cdc7d2906ad53c5aed7f90a976aea9a7a
MD5 27f4c49665cf5f1f87af9bdbf34f750e
BLAKE2b-256 70cfe98e68f16f4dfb92c9f2630c8f09e6054f4e2e8955cd47915a3f6f46ac2c

See more details on using hashes here.

Supported by

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