PasswordUtil Object

Description

Enables you to use a credential management service to manage secrets and passwords used in your OpenText Functional Testing tests.

Currently, OpenText Functional Testing supports only AWS Secrets Manager and Azure Key Vault service.

Methods

Connect	Connects OpenText Functional Testing to a credential management service.
Disconnect	Disconnects OpenText Functional Testing from a credential management service.
GetSecret	Gets the value of a secret stored in a credential management service.
ListSecrets	Lists the names of secrets stored in a credential management service.
SetSecret	Creates a secret to be saved in a credential management service.
Setting	Enables you to configure settings for connecting to a credential management service.

Back to top

Connect Method

Description

Connects OpenText Functional Testing to a credential management service.

Syntax

PasswordUtil.Connect(serviceName, [settings])

Return Value

A Boolean.

IMPORTANT

Use one of the following ways to connect to a credential management service:

• Define the connection information in the Tools > Options > GUI Testing > Credential Manager pane and then use the Connect method (use an empty string as serviceName and leave settings empty). See the example.

  Note: In this case, OpenText Functional Testing connects to only the credential management service selected in the Credential Manager pane.

• Define the connection information using the Setting method and then use the Connect method with serviceName set to a service. See the example.

• Use only the Connect method with both parameters specified. See the example.

Example

Defining information in the Credential Manager pane and using the Connect method

Suppose you have already defined the connection information in the Tools > Options > GUI Testing > Credential Manager pane, you can use the following syntax to connect to a credential management service:

Copy code

PasswordUtil.Connect("")

Using the Setting and Connect methods

This example defines connection information using the Setting method and then uses the Connect method to connect to Azure Key Vault service.

Copy code

PasswordUtil.Setting "keyVaultName", "xxxxx"
PasswordUtil.Setting "tenantId", "xxxxx"
PasswordUtil.Setting "clientId", "xxxxx"
PasswordUtil.Setting "clientSecret", "xxxxxx"
PasswordUtil.Connect("Azure Key Vault")

Using the Connect method only

This example uses only the Connect method to connect to Azure Key Vault service.

Copy code

PasswordUtil.Connect("Azure Key Vault",  {
      "tenantId": "xxx",
      "clientId": "xxx",
      "clientSecret": "xxx",
      "keyVaultName": "xxx",
      })

Back to top

Disconnect Method

Description

Disconnects OpenText Functional Testing from a credential management service.

Syntax

PasswordUtil.Disconnect([serviceName])

Return Value

None.

IMPORTANT

To connect to a different credential management service, make sure to add a PasswordUtil.Disconnect step to disconnect from the current connection.

Example

The following example disconnects OpenText Functional Testing from AWS Secrets Manager if the connection result is successful.

Copy code

ret = PasswordUtil.Connect("AWS Secrets Manager")
If ret Then
    PasswordUtil.Disconnect "AWS Secrets Manager"
End If

Back to top

GetSecret Method

Description

Gets the value of a secret stored in a credential management service.

Syntax

PasswordUtil.GetSecret(name)

Return Value

A string.

Example

This example first connects OpenText Functional Testing to Azure Key Vault service and then gets the value of a secret named FirstKey.

Copy code

PasswordUtil.Connect("Azure Key Vault")
name = "FirstKey"
value = PasswordUtil.GetSecret("name")
Print value

Back to top

ListSecrets Method

Description

Lists the names of secrets stored in a credential management service.

Syntax

PasswordUtil.ListSecrets

Return Value

A string array.

Example

This example uses the ListSecrets method to return the total number of secrets and the name and value of each secret.

Copy code

Set list = Nothing
Set list = PasswordUtil.ListSecrets
If list Is Nothing Then
    Reporter.ReportEvent micFail,  "invalid settings", "Failed"
Else
    Reporter.ReportEvent micDone, "List Count", "list=" & list.Count
For Each e in list
        Reporter.ReportEvent micDone, "Key Name: "&e, "Key Secret: " & PasswordUtil.GetSecret(e)
Next
End If

Back to top

SetSecret Method

Description

Creates a secret to be saved in a credential management service.

Syntax

PasswordUtil.SetSecret(name, value)

Return Value

None

IMPORTANT

Make sure that you specify the KMS key ID before you use this method to create a secret in AWS Secrets Manager. You can either define the KMS key ID in the Tools > Options > GUI Testing > Credential Manager pane or use the Setting Method.

Example

This example first creates a secret named FirstKey and then returns the value of the secret.

Copy code

PasswordUtil.SetSecret "FirstKey", "1"
value = PasswordUtil.GetSecret("FirstKey")
Print value

Back to top

Setting Method

Description

Enables you to configure settings for connecting to a credential management service.

Syntax

PasswordUtil.Setting(name, value)

Return Value

None

IMPORTANT

• To successfully connect to Azure Key Vault service, you must specify the values of tenantId, clientId, clientSecret, and keyVaultName.

• To successfully connect to AWS Secrets Manager service, you must specify the values of regionEndpoint, accessKeyId, and secretAccessKey.

• This method overwrites the existing connection information defined in the Tools > Options > GUI Testing > Credential Manager pane.

Example

This example configures the required parameters and connects OpenText Functional Testing to Azure Key Vault service.

Copy code

PasswordUtil.Setting "keyVaultName", "xxxxx"
PasswordUtil.Setting "tenantId", "xxxxx"
PasswordUtil.Setting "clientId", "xxxxx"
PasswordUtil.Setting "clientSecret", "xxxxxx"
PasswordUtil.Connect("Azure Key Vault")

Back to top

See also:

• Crypt Object
• DataTable Object
• Description Object
• DeviceReplay Object
• DotNetFactory Object
• DTParameter Object
• DTSheet Object
• Environment Object
• Extern Object
• Parameter Object
• JSON Object
• JsonUtil Object
• MercuryTimers Object (Collection)
• MercuryTimer Object
• NV Object
• OptionalStep Object
• ParallelUtil Object
• LocalParameter Object
• PasswordUtil Object
• PathFinder Object
• PDFUtil Object
• Properties Object (Collection)
• QCUtil Object
• RandomNumber Object
• Recovery Object
• Remote Connection Object
• Reporter Object
• RepositoriesCollection Object
• Repository Object
• Services Object
• Setting Object
• SystemMonitor Object
• TestArgs Object
• TextUtil Object
• UIAutomation Object
• VisualRelation Object
• VisualRelations Object
• VisualRelationsCollection Object
• WebUtil Object
• XMLUtil Object