The Token2 Configuration Tool (token2-config.exe) is a command-line program that allows you to set the seed and configuration of Token2 TOTP tokens. This tool is useful for managing and customizing Token2 tokens to suit your specific needs.
Kindly be aware that this tool is designed specifically for use with 2nd generation TOTP NFC Programmable tokens and may not be compatible with older models.
To optimize its performance, it is recommended to use an NFC Device from Token2, although other devices are likely to function effectively as well.
To use the Token2 Configuration Tool, you can run the program with various command-line arguments. Below is a list of available options and their descriptions:
The "seed" group of arguments allows you to specify the token seed, which is essential for generating TOTP codes.
-s, --seed: Set the seed. For Base32 format, the seed can be up to a maximum of 32 characters.--hex: If set to true, the tool accepts the value of the --seed argument to be in hex format, without performing Base32 to hex conversion.The "configuration" group of arguments enables you to configure the TOTP token settings:
-t, --time: Set the time. This should be provided as a UNIX timestamp. You can use '0' to set the current device time.-e, --step: Set the time step of the OTP. You can choose from the following options: 1 (30 seconds) or 2 (60 seconds).-a, --algo: Set the OTP algorithm. You can choose from the following options: 1 (SHA1) or 2 (SHA256).-p, --sleep: Set the screen sleep timeout. You can choose from the following options: 1 (15 seconds), 2 (30 seconds), 3 (60 seconds), or 4 (120 seconds).--reader: Select the reader by specifying its number if there are multiple readers available. If not defined, the tool will use the first reader.-r, --results-file: Specify the results file for saving the serial number of tokens and seed values.-l, --log: Set the logging level. The available levels are DEBUG, INFO, WARNING, ERROR, and CRITICAL.Here are some example commands that demonstrate how to use the Token2 Configuration Tool:
Example 1 (Base32 with config arguments):
token2-config.exe --seed JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP --time 0 --step 1 --algo 1 --sleep 2
Example 2 (seed in hex format):
token2-config.exe --seed 48656c6c6f21deadbeef48656c6c6f21deadbeef --hex true
The Token2 Configuration Tool is a powerful command-line utility that simplifies the process of configuring Token2 TOTP tokens. You can customize your tokens, set the seed, and adjust various parameters to meet your specific requirements.
For additional details on the available options and their usage, please refer to the program's help message:
token2-config.exe --help
Thank you for using the Token2 Configuration Tool. If you have any questions or encounter any issues, please don't hesitate to reach out for support.