Retrieve-Credential function

Use the Retrieve-Credential function to specify the endpoint URL of the third-party password vault and to pass in required data for authentication.

General hash table variables

Variable Name

Data Type

Description

PfxData

Byte Array

PKCS#12 keystore containing client certificate and private key for authenticating with the third-party vault; this and the PfxPass are used together to instantiate an X509Certificate2 object for client certificate authentication.

PfxPass

SecureString

Password for access to the private key of the PfxData PKCS#12

Username

String

User name for authenticating with the vault

Password

String

The password or Token required for authenticating with the vault

VaultUrl

String

The vault endpoint URL

Specific hash table variables

Variable Name

Data Type

Description

ConnectorDN

Byte Array

The DN of the Adaptable Credential Connector

CredentialDN

SecureString

The DN of the Adaptable Credential

CredentialType

String

A credential type (string) that the Adaptable Credential object will represent (e.g. "Password Credential", "Username Password Credential", "Certificate Credential", "Private Key Credential", "Amazon Credential")

VarText1

String

Value for the text this custom field defined by the header at the top of your script

VarText2

String

Value for the text this custom field defined by the header at the top of your script

VarText3

String

Value for the text this custom field defined by the header at the top of your script

VarText4

String

Value for the text this custom field defined by the header at the top of your script

VarText5

String

Value for the text this custom field defined by the header at the top of your script

VarBool1

Boolean

Value for the yes/no custom field defined by the header at the top of your script (true|false)

VarBool2

Boolean

Value for the yes/no custom field defined by the header at the top of your script (true|false)

VarPass

String

Value for the text password custom field defined by the header at the top of your script

Returns

Return

Data Type

Description

Result

String

Shows "Success" to indicate the non-error completion state, or an error message if unsuccessful

Password

String

The retrieved credential password

Username

String

The retrieved credential user name