Store credentials

We can store credentials for URLs that require authentication, such as repositories, proxy servers, and response files. These storage files are used when we run silent installation scripts to access password protected servers. When we use a storage file, we must list repository and proxy server URLs in your response file preferences. A storage file does not make those preferences unnecessary.

If we store credentials for a response file on a server, we do not need to configure the URL in the Preferences before we create a storage file.

If we are storing credentials for a service repository, we must have an IBM user name and password. To register for an IBM user name and password, go to: http://www.ibm.com/account/profile. For information about service repositories, see Search service repositories.

The -keyring and -password options that are used to create key ring files are deprecated. Use the -secureStorageFile and -masterPasswordFile options to store user credentials. To store credentials in a key ring file, see Store credentials in a key ring file.

Installation Manager uses the Eclipse infrastructure to save credentials. When we use the -secureStorageFile and -masterPasswordFile options, we create a storage file that contains our credentials.

If we use an existing storage file, the new credentials are added and the previous credentials are not overwritten.

If we do not save our credentials, we are prompted to enter our credentials each time you access the repository.

For information about the input responseFile and the -secureStorageFile storage_file -masterPasswordFile master_password_file command-line arguments, see Installation Manager command-line arguments for silent mode. For more information about the imutilsc commands, see Commands for imutilsc.

Procedure

To store credentials in a storage file:

  1. If we do not have a master password file, create the file. The master password file is a text file that contains a passphrase. An example of a passphrase is: "This text is the master password."

    Tip: To secure this file, set permissions to restrict access to this file as appropriate for your operating system.

  2. From the command line, open the tools directory in the directory where we installed Installation Manager.

  3. Run the command: 
    imutilsc saveCredential   
	-url address | -passportAdvantage 
	-userName user_name -userPassword password 
	-secureStorageFile storage_file [-masterPasswordFile master_password_file] 
	[ -preferences com.ibm.cic.common.core.preferences.ssl.nonsecureMode=true|false ]
	[ -proxyHost proxy_host -proxyPort proxy_port
		[ -proxyUsername proxy_user_name 
		  -proxyUserPassword proxy_user_password ]
 		[ -useSocks ] ]   
	[ -verbose ]

    • Do not use -url and -passportAdvantage in the same command.

    • If we use the IBM service repositories, we can specify the http://www.ibm.com/software/repositorymanager/entitled/repository.xml value for the -url option. This value is a generic service repository that can be used for IBM packages.

    • We can specify the location of the storage file by including a file path in the name. If a file path is not included, a default location is used.
    • Enclose file paths that include spaces with double quotation marks.

    • We can specify only the com.ibm.cic.common.core.preferences.ssl.nonsecureMode preference key for the -preferences option. See Silent installation preference keys. The default value for the preference key is false.
  4. Repeat to store the credentials for multiple URLs in one storage file.


Results

Your credentials are saved in the storage file that you specified with the -secureStorageFile storage_file option.


What to do next

Create a response file that designates the proxy server and repository URLs in the Preferences.


Store credentials in a key ring file

For versions 1.6.1 and earlier, use the -keyring and -password options to save credentials.

To create a key ring file, use the Installation Manager imutilsc command-line tool from the Installation Manager tools directory to authenticate with repositories.

Installation Manager uses the Eclipse infrastructure to save credentials to a key ring file. When we use the -keyring keyring_file -password password argument, Eclipse creates a key ring file if a key ring file does not exist.

If we use an existing key ring file, the new credentials are added and the previous credentials are not overwritten.

If we do not want share your key ring with other users, we must create a key ring that only we can access. Multiple users can use the same instance of Installation Manager that is installed in either group mode or administrator mode. Some repositories might require credentials. If the default key ring location is used and we did not use the -password option when we created the key ring, other users can use our credentials to access the repository. Create a key ring using the -keyring and -password options with IBMIM, imcl, or imutilsc saveCredential.

If we do not save our credentials, we are prompted to enter our credentials each time you access the repository.

For information about the input responseFile and the -keyring keyring_file -password password command-line arguments, see Installation Manager command-line arguments for silent mode. For more information about key ring files, see the Eclipse workbench User Guide. For more information about imutilsc commands, see Commands for imutilsc.

Procedure

To store credentials in a key ring file using the Installation Manager imutilsc command:

  1. From the command line, open the tools directory.

  2. Run the command: 
    imutilsc saveCredential   
	-url address | -passportAdvantage 
	-userName user_name -userPassword password 
	-keyring keyring_file [ -password password ]  
	[ -preferences com.ibm.cic.common.core.preferences.ssl.nonsecureMode=true|false ]
	[ -proxyHost proxy_host -proxyPort proxy_port
		[ -proxyUsername proxy_user_name 
		  -proxyUserPassword proxy_user_password ]
 		[ -useSocks ] ]   
	[ -verbose ]

    • Do not use the -url and -passportAdvantage options in the same command.

    • We can specify the location of the key ring file by including a file path in the name. If a file path is not included, a default location is used.
    • Enclose file paths that include spaces with double quotation marks.

    • We can specify only the com.ibm.cic.common.core.preferences.ssl.nonsecureMode preference key for the -preferences option. See Silent installation preference keys. The default value for the preference key is false.
    The key ring file is saved to the specified location.
  3. Repeat these steps to store the credentials for multiple URLs in one key ring file.


Results

Your credentials are saved in the key ring file that you specified with the -keyring keyring_file option.


What to do next

Create a response file that designates the proxy server and repository URLs in the Preferences.
Home