USB Tokens and SmartCards
TheGreenBow VPN client supports USB Tokens as a mean to increase identify authentication,
to enforce security policy while keeping it simple for users and IT managers.
If you successfully qualified a new token which doesn't appear yet in our qualified token list,
please don't hesitate to submit your feedback to our support:
Send the VPN Client version, the token model, and if required the vpnconf.ini file you wrote. We will add this token to our list.
How to declare a new Token
The syntax for declaring an ATR in the file "vpnconf.ini" is:
- atr: Token ATR code
- mask: Token mask code
- scname: Token name
- manufacturer: Token manufacturer's name
- pkcs11DllName: PKCS#11 middleware file
- registry: Value in the registry that points to the complete path of the DLL
This information is available from the Token manufacturer.
- The "vpnconf.ini" file must be saved in the same folder as tgbike.exe (install folder).
- If the PKCS#11 DLL (here as pkcs11.dll) is not in c:\windows\system32\ then "registry" must be set.
- Registry is the value in the registry that points to the complete path of the DLL.
The syntax is HKEY_LOCAL_MACHINE:<registry key>:<value in the registry key>.
For example, if a value "DllPath" with content "C:\Program Files\TheGreenBow\TheGreenBow VPN\pkcs11.dll"
is created in "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\App Paths\\TgbIke.exe",
registry line is : "HKEY_LOCAL_MACHINE:SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\App Paths\\TgbIke.exe:DllPath".
Since release 4.6, the VPN Client may take into account new Token ATR Code as soon as they are
declared in an initialization file called "vpnconf.ini".
See above how to declare a new token.
The software can't find middleware
In case of the middleware was not found:
1. Check in the file "vpnconf.ini" that the keys "pkcs11DllName" and "registry" are correct (See How to declare a new Token ATR Code above)
2. Check that the file indicated in the key "pkcs11DllName" in the "vpnconf.ini" file, exists on the system.