How to add new token?

Using Flipper Authenticator Companion (FAC) app

This option is the most user-friendly and convenient way to add new token.

Checkout official repo to get this app running on your machine.

Using CLI

1. Launch Flipper Authenticator application
2. Provide PIN if you setup it
3. Connect to your Flipper using some telnet agent or just use web-based agent.
4. Run totp add <token_name> command, where <token_name> is some user-friendly name of the token which will allow you to identify it
5. Enter token secret and confirm it with <ENTER> key

Optionally totp add command may accept following options

• -a <algo>, where <algo> is token hashing algorithm (could be sha1, sha256 or sha512, steam)
• -d <digits>, where <digits> is number of digits to generate (could be 5, 6 or 8)
• -l <duration>, where <duration> is token lifetime duration in seconds (must be between 15 and 255)

These options are optional and need to be passed only in case if you are strongly sure that default values are not acceptable for your case.

Manually updating config file

It is possible to copy&paste plain token secret straight into config file. To do that, take a look at config file format description and use it as a reference to add new token straight in config file. Then use plain token secret for TokenSecret section. Finally, run Flipper Authenticator app to make sure your newly added token is added and to let application encrypt it.

Some providers (ex. Amazon) shows token secrets as a grouped string (ex. XXXX ZZZZ YYYY NNNN MMMM), it is fine to use such a string if you are entering token secret manually or using CLI, however it is not allowed to use such a string to copy&paste it straight to a config file. In such a scenario you need to drop all the whitespaces from your token secret before putting it into config file.

Using built-in GUI

This option is not that convenient, but still could be used.

1. Launch Flipper Authenticator application
2. Provide PIN if you setup it
3. Press "OK" button to open application menu
4. Using navigation keys select option "Add new token"
5. On the new screen use navigation keys to provide all the required information
6. Once all the information provided - focus "Confirm" button on the screen and confirm adding new token by pressing "OK" button on Flipper Zero device