garmin-otp-authenticator

Garmin ConnectIQ Store Link

Most popular (by reviews) ConnectIQ Widget for One-Time Passwords as Second Factor Authentication (2FA) similar to Google Authenticator, Authy and the likes.

Keys can be entered directly and are stored encrypted using Garmin's application storage. This way, the secret keys will never leave your device and can provide a truly secure second factor!

Less secure, but more convenient: key data can be also added, exported and imported via widget settings.

Feedback via reviews appreciated and if you like this app, consider buying me a coffee: https://ko-fi.com/ch1bo

Features

• Instant preview of all One-Time Passwords
• Standalone, offline and no companion Smartphone App required
• Encrypted storage of keys, can be backed up and restored
• Direct input of names and keys on device
• Import/export and add new entries via settings
• Edit provider name, key and type from action menu
• Supported types
  • Timed One-Time Passwords (TOTP) using SHA1 with 30 sec interval and 6 digit codes (not configurable)
  • Counter-based One-Time Passwords (HOTP) using SHA1 with 6 digit codes (not configurable)
  • Steam Guard compatible One-Time Passwords
• Supports 150+ Garmin devices (touch, button, round, square, etc.)
• Supports 50+ entries (bounded by device memory)

Getting started

1. Add widget to your device and access it
2. Start via Configure, New provider
3. Pick a name for your first provider entry
4. Enter the secret key of your first provider key

• This step highly depends on the service use like to authenticate
• Usually you will be provided a QR Code
• If available, use "manual entry" to get access to the actual key
• Or you can use a QR Code Reader APP to decode the QR Code
• The secret key looks like: "32QXEKZZXO2ZVJJDWU2KTTDUZ52Q4USN"

5. Pick the provider type, most likely its a time-based (TOTP) code

Backup / Restore

Keys are stored encrypted using Garmin's application storage on the Device. In the past the application storage was not retained when updating a widget to a newer version, but this seems to be no issue anymore (since CIQ 3.0.0?). However, entered provider data along with secret keys are quite naturally wiped when removing or reinstalling the App.

To provide an easy way of data migration, e.g. when switching Garmin devices an export/import mechanism was added!

Export keys

To export keys from the encrypted application storage, open the menu in the "OTP Authenticator" widget (touch or menu button). When selecting "Export", all provider entries are copied into application properties until next start. You can access the exported data in the Settings of the widget.

IMPORTANT Secrets are available unencrypted in settings after exporting until the next start. Make sure you backup the exported data in a secure way, e.g. in your password manager with encrypted storage. Also, there is a chance that this leaks the payload to the garmin servers!

Import keys

Using the same approach as above, previously exported key data can be imported again via the Widget settings. On every widget start, all available data is loaded and cleared from the corresponding settings entry.

Text input

• If available the native text picker is used as it allows for most convenient text entry, even via remote typing from smartphone.
  • While often more comfortable, the native picker is limited to enter 31 characters at once.
  • Whenever hitting the maximum input length on secret keys, an additional text input item is added to enter the key in chunks of 31 characters.
• To use the builtin text input, opt-in via app settings ("Use legacy text input")
• Controls of legacy text input
  • Use up/down or swipe to switch characters
  • Tap or the select button picks a character
  • Swipe back or back button deletes a character
  • Long press the screen or the select button first asks confirmation, and if long pressed again, continues

Steam guard

This app does support the steam guard authentication code scheme. However, access onto the secret key is usually not provided by the setup.

If you have a rooted Android phone, you can read the secret key out of the installed and configured steam Android App.

The secret is located in a file at path /data/data/com.valvesoftware.android.steam.community/files/Steamguard* and can be read using adb or a local shell and su (thus the rooted phone requirement).

Future work / feature ideas

• Rotating code colors for counter-based OTP.
• Sort entries on demand
• Encrypt on export with AES
• Other device support - on demand
• Choosable interval and code length for Time-based
• Bigger font for Steam-Guard codes (requires custom font)
• Optional master password/PIN
• Other UI/UX improvements - feedback welcome!

Development

Due to very old libraries used in the Garmin SDK, notably in the simulator, modern Linux distributions and especially NixOS is hard to support. Thus, the current "best" practice is to use an Ubuntu docker image like this one, onto which I only needed to add make to get a docker image for my workflow:

docker build . -t connectiq
./run-in-docker.sh
developer@c2efd41df61f$ make start

The docker container uses the SDKs and Device files from the .Garmin/ working directory. To check for new and download SDK packages, launch sdkmanager from within the docker container. Also, for some tasks the Garmin IDE is helpful, available in the eclipse of the docker container.

While a default device is defined in Makefile, one can select the device to run tests for or start the simulator on with DEVICE=<device name in manifest>.

Testing

The codebase contains tests about the logic which can be run with make test, while the interface needs to be tested manually with the simulator using make start.

Testing with all supported devices on every change is obviously infeasible, but the following list of devices should be considered as they are in a way special or representative:

• fenix847mm: flagship model, ciq 5.0, amoled, touch, buttons, round
• fenix7xpro: ciq 5.0, bigger, mip screen, solar bezel
• fenix6spro: ciq 3.4, smaller, mip, buttons only, fenix 6 most popular (> 40%)
• vivoactive4: ciq 3.3, touch, less buttons, popular (> 13%)
• vivoactive3: ciq 3.1, no glance, different navigation
• venu3: touch, less buttons, different action view
• venusq2m: rectangular shape
• instinct2: semi-octagon shape with subscreen, black-white screen

To run all of these in sequence, use ./run-in-docker.sh ./test-all.sh. To advance from one device to the next in the manual test, the widget must stop gracefully, e.g. using the back button.

Full list of devices and their capabilities

License

The source code for garmin-otp-authenticator is released under the Mozilla Public License Version 2.0.

Lock icons created by Roundicons - Flaticon

Time icons created by Freepik - Flaticon

Counter icons created by Freepik - Flaticon

Brands and logotypes icons created by pictogramer - Flaticon