Software AG Infrastructure 10.7 | 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] [-p password] [-b base64 encoded password] [-d|-e] userId
UNIX
./internaluserrepo.sh [-f file] [-c] [-p password] [-b base64 encoded password] [-d|-e] userId
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 userId
Deletes the credentials for the specified user from the file.
-e userId
Check if the specified user exists in the user repository file.
If the command returns 0, the user exists in the file.
userId
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.
-b base64 encoded password
Password for the specified user ID, encoded in Base64 format. Passwords can contain up to 128 digits, Latin letters, and the characters ! ( ) - . ? [ ] _ ~ in plain text. Note that this argument takes precedence over the -p argument.
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.