Renaming user IDs to TightGate-Pro
These instructions describe the procedure for the automated renaming of user IDs in TightGate-Pro using a CSV file provided by the customer. Please note that the automated renaming works for all login types of TightGate-Pro user administration, with the exception of User administration with access data (user name and password).
Creation of the CSV list
The CSV file serves as the basis for the renaming and must fulfil the following requirements:
- File extension: .csv
- No table header (no headings)
- Field separator: Semicolon (;)
- No special characters or spaces. Allowed are only lower case letters (a-z), numbers (0-9) or the underscore _
Column definition
| Column | Contents | Notes |
|---|---|---|
| 1 | New user name | No umlauts, special characters or spaces |
| 2 | Old username | No umlauts, special characters or spaces |
A CSV file could therefore look like this:
- tgpro_change.csv
newname;oldname
Import / change / delete a CSV file
In order for the import to take place, the CSV list with the user names to be renamed must be created externally and copied into the transfer directory of the user config transfer directory at TightGate-Pro.
CSV import
The initial import of a CSV list is performed by importing the created CSV list. The CSV list must already be in the administrator's transfer directory config then it can be imported as maint can be imported.
- Login as user maint
- Navigate to: User administration → Import renaming list
- Select and import the previously uploaded CSV file
- The system confirms a successful import
Change CSV
A CSV list is changed by overwriting the existing list with a new CSV file. This must be created in advance and copied to the transfer directory of config transfer directory.
- Login as user maint
- Navigate to: User administration → Import renaming list
- Select and import the new CSV file previously uploaded
- The system confirms a successful import
- The new list completely replaces the previous list
Achtung
The import of a new list overwrites the previous list without a backup.
Delete CSV
A CSV list is deleted by overwriting the existing list with a new empty CSV file. This must be created in advance and copied to the transfer directory of config transfer directory.
- Login as user maint
- Navigate to: User administration → Import renaming list
- Select and import the empty previously uploaded CSV file
- The system confirms a successful import
- Delete the list: By importing an empty CSV file, the existing list can be overwritten and thus emptied.
Hinweis
All changes take effect immediately after the import on individual systems as well as in the cluster.
Customisation of the TightGate client
To ensure that the renaming also takes effect on the TightGate client, the content of the folder %APPDATA%\vnc must be deleted.
This is how the renaming works
The renaming takes place automatically the next time the affected user logs on.
The first time you log in with the new user name the system checks the list and if there is a match, the old user name is automatically renamed to the new user name, including the transfer of the associated data.
If the new user already exists because he/she logged in before the list was imported or has already been renamed from the list, the entry is ignored. the entry is ignored and no changes are made.
Hinweis
If the user administration of TightGate-Pro is carried out via Active Directory, please check whether the clear names are also retrieved from TightGate-Pro when logging in. clear names are also retrieved from the AD when logging in. If the function is activated, the new clear name is also retrieved from the AD when the user is renamed. If the function is deactivated, only the user ID will be renamed, but the clear name will be retained.
Summary
The renaming is based on a CSV file maintained by the customer and is carried out via the user maint user in TightGate-Pro. The change is made automatically at the next login, provided the conditions are met.