pub.security.outboundPasswords:getPassword

WmPublic. Retrieves a password from the password store for a given key.

Input Parameters

key	String Key of the password entry to be retrieved.
isInternal	String "true" if this is an internal password; "false" if it is public. By default, this is "false". If you specify incorrectly whether the password is internal or public, the retrieve operation will fail. (For more information about internal and public passwords, see Internal and Public Passwords.)

Output Parameters

value	WmSecureString Value of the retrieved password.
result	String "true" if the password value was successfully retrieved; "false" otherwise.
message	String "successful" or reason for failure.

Usage Notes

This is the basic process a flow service should follow to retrieve an outbound password:

1. Call pub.security.outboundPasswords:getPassword with the key to the password to be retrieved.

If the key is unknown, you can call pub.security.outboundPasswords:listKeys to retrieve a list of keys currently in the outbound password store.

The pub.security.outboundPasswords:getPassword service returns a WmSecureString object containing the retrieved password.

2. Call pub.security.util:convertSecureString to convert the password to a usable format.

The password can then be passed to the authenticating mechanism of the secure resource.

3. When done accessing the secure resource, call pub.security.util:destroySecureString to remove the password from memory.