awesome-otp

Connect to Viscosity VPN via awesome-otp

We often need to check the OTP token on the phone when logging in to the VPN or SSO, which can be troublesome and time-consuming if we use our cell phones to log in multiple times a day. To make it easier to log in with OTP token on computer, this article introduces a small tool(awesome-otp) to generate OTP token locally via terminal. Further, It also integrates with Viscosity for quick login. Maybe in the future it will integrate more OTP clients, such as WEB login, etc.

Prerequisite

• Nodejs environment, recommend using the latest version

Install

$ npm install -g awesome-otp

Sync the local OTP secret(key) to your server

• Generate the OTP secret, the secret will be generated in the ~/.otp_secret file and also copy to the clipboard automatically.

$ otp init

• Enroll a new token with the generated secret

Get the OTP Token with CLI

• Input the follow command, the token will be generated and copy to the clipboard. You can also add some prefix(with flag -p) to the token

$ otp token                              
# or
$ otp token -p "xyz" --no-info

Integrate with the Viscosity

• List all the Viscosity config to connect the VPN

$ otp viscosity -l
Config1: Connected
Config2: Disconnected
...

• Connect to the Viscosity with the follow command. You can configure this command through alias to any command you are comfortable with
  • xyz is on behalf of the PIN
  • Config1 is one of the config name from otp viscosity -l

$ otp token -p 'xyz' --no-info && otp viscosity -o 'Config1'

NOTE:

• Once you enter the above command, the Viscosity will automatically open and the cursor will automatically navigate to the password entry field. All you need to do now enter Paste and Enter shortcut keys in sequence.
• The above command can also be used to login the Web Token account.
• Support macOS only.
• Welcome to contact [e-mail] to fix and add features, if we can work together then it will definitely be awesome!