Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/digitalsanctum/gars
Google Authenticator CLI.
https://github.com/digitalsanctum/gars
cli google-authenticator mfa mfa-workflow rust rust-cli
Last synced: 3 months ago
JSON representation
Google Authenticator CLI.
- Host: GitHub
- URL: https://github.com/digitalsanctum/gars
- Owner: thesurlydev
- License: mit
- Created: 2020-04-17T22:25:25.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-02-24T21:31:50.000Z (over 1 year ago)
- Last Synced: 2024-07-26T22:22:08.370Z (4 months ago)
- Topics: cli, google-authenticator, mfa, mfa-workflow, rust, rust-cli
- Language: Rust
- Homepage: https://crates.io/crates/gars
- Size: 21.5 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Google Authenticator for Rust (GARS)
If you use [Google Authenticator](https://github.com/google/google-authenticator) for multi-factor authentication (MFA) and would like to automate authentication, then GARS is for you.
## Install from source
```shell
cargo install --path .
```
## Usage
Create an environment variable with your Google Authenticator secret:
```bash
export GA_SECRET=YOUR_GA_SECRET_HERE
```
Run `gars` from the command line.
```bash
$ gars
123456
```
`gars` will return the latest Google Authenticator generated number associated with the given GA secret to stdout.
Tested on Ubuntu Linux and Mac OS X.
## Why was GARS created
MFA is great for added security but makes it difficult to automate things.
## What is Google Authenticator
Google Authenticator is a software-based authenticator by Google that implements two-step verification services using the Time-based One-time Password Algorithm and HMAC-based One-time Password algorithm, for authenticating users of software applications.
It's also one of several mechanisms that [Okta](https://www.okta.com/) uses for MFA.
## Credit
This is just a simple wrapper around the [google-authenticator](https://crates.io/crates/google-authenticator) library.