Software AG Infrastructure 10.3 | Setting Up Security | Creating or Editing Internal User Repository Files
 
Creating or Editing Internal User Repository Files
You can create or edit internal user repository files that contain user names and encrypted passwords using the Security Infrastructure Internal User Repository Command Line Tool. Files created with the Internal User Repository Command Line tool can be used with the InternalLoginModule.
Open a command window and go to the Software AG_directory /common/bin directory. To start the tool, use the appropriate command for your operating system from the table below.
System
Command
Windows
internaluserrepo.bat [-f file] [-c] [-d | -e] user_Id [-p password]
UNIX
./internaluserrepo.sh [-f file] [-c] [-d | -e] user_Id [-p password]
The following table describes the arguments for the command.
Argument
Description
-h
Print guidelines for using the tool.
-c
Create or edit a text repository file. To create a file named users.txt in the Software AG_directory /common/bin directory, specify -c but not -f. To create a file with a specific name and location, or to modify an existing file, specify - c and -f.
-f file
Location and name of the file to create or modify.
-d user_Id
Deletes the credentials for the specified user from the file.
-e user_Id
Check if the specified user exists in the user repository file.
If the command returns 0, the user exists in the file.
user_Id
If you have a users.txt file in the Software AG_directory /common/bin directory, use this argument without -d or -e to add a new user to the file. User names can contain up to 128 digits, Latin letters, and the characters ! ( ) - . ? [ ] _ ~.
-p password
Password for the specified user ID. Passwords can contain up to 128 digits, Latin letters, and the characters ! ( ) - . ? [ ] _ ~. If you do not specify this argument, the tool will prompt for the password.
The following table describes the appropriate exit code if the command fails.
Exit Code
Description
-1
User ID specified on -e argument not found in the repository file.
1
Password is not set. Specify a password.
2
User ID is too long.
3
User ID contains an invalid character.
4
Password contains an invalid character.
5
Password is too long.
6
Repository file lists more than one version.
7
Repository file lists a version in an unknown format.
8
Repository file does not list any version.
9
User does not have permissions required to create of modify the repository file.
10
User ID not specified on the command.
11
Specified parameters conflict or are invalid.