Download PDF
Download page Synthetic Credential Vault for Web Monitoring.
Synthetic Credential Vault for Web Monitoring
Deployment Support
How to Use Synthetic Credential Vault
Go to > Tools > Manage Synthetic Credentials.
Add a credential in a key-value pair to Synthetic Credential Vault.
- Create a synthetic job using a synthetic script.
Inject the credential key into the synthetic script.
The job runs and retrieves the credential value associated with the credential key.
- The synthetic job runs and retrieves the credential value associated with the credential key.
Add Synthetic Credentials
In Synthetic Credential Vault, you can add credentials one-by-one or import multiple credentials.
Syntax Rules
This table describes credential syntax rules used for creating credentials and adding credentials to the synthetic scripts:
Element | Rule |
---|---|
Keys |
|
Values |
|
Credential key name (used in synthetic scripts) | "<%key%>" |
Add a Single Credential
If you want to use a combination of credentials, such as a username and password combination, you must create two separate credentials: one credential for the username and one for the password.
To add a single credential for a sample email:
Go to > Tools > Manage Synthetic Credentials.
Click Add.
Enter a key and value. Make sure you follow syntax rules.
- (Optional) Select an associated application. When you search for credentials in the synthetic script, associated credentials are suggested first.
Import Multiple Credentials
You can add multiple credentials at once using the Import button.
To add multiple credentials for sample emails and passwords:
Go to > Tools > Manage Synthetic Credentials.
Click Import.
Copy and paste credentials or type them line by line. Make sure you follow syntax rules.
- The maximum number of credentials that can be imported at once is 250.
- You cannot add associated applications to imported credentials. After importing, you must edit each credential individually to add the associated application.
Example
email_key=user123@email.com
password_key=Password123
email_key=user456@email.com
password_key=Password456
Use Credentials in a Synthetic Script
You can retrieve a credential value by inserting the corresponding credential key in a script. Credentials associated to a specific application appear first when you start typing the key in the script.
To create a synthetic job:
- Go to User Experience > Jobs > Add.
- Add your synthetic script. See Write Your First Script.
Locate the DOM element associated with your credential.
Enter the credential key using the syntax
"
<%key%>"
.Synthetic Script
driver.find_element_by_id("email").send_keys("<%email_key%>") driver.find_element_by_id("pass").send_keys("<%password_key%>")
CODE
User Permissions
In the Controller UI, you can configure roles, users, and groups with Account-level, read-only permission for Synthetic Credential Vault. See Create and Manage Custom Roles and End User Monitoring Permissions for more information.
As an admin-level user, we recommend you add a read-only role for Synthetic Credential Vault and assign that role to multiple users and/or groups.
To create a role in the Controller UI with read-only permission:
- In the Controller UI, go to > Administration > Roles.
- Under Roles, click Create.
- Add a role name, such as "Synthetic Credential Vault (read-only)."
- Under Account, click Add+.
- Check the "View Synthetic Credential Vault" box.
- Under User and Groups within this Role, add users and/or groups.
The table below describes permission differences between admin and read-only users for using Synthetic Credential Vault.
User Level | Permission |
---|---|
Admin | Requires "Administration," "Agents," and "Getting Started Wizard" permissions to:
|
Read-only |
|