Delinea Secret Server (On-Premise) Secret Path Expressions

Path syntax: {Folder_path}/{secretKey}

Before Encoding

Using Folder Name:

secrets://delinea-vault/folder1/cred/applicationName/directoryName/Username

Important
The URL path should always start with the prefix, secrets://. Each part of the URL should be URL-encoded. Each URL attribute in the path is case-sensitive

After Encoding

After you encode the URL path, it should appear as follows:

Using Folder Name:

secrets://delinea-vault/folder1%2Fcred%2FapplicationName%2FdirectoryName/Username

The following is an explanation of the attributes of this URL:

• delinea-vault – Configured Credential Provider in the Credential Provider Section

• folder1%2Fcred%2FapplicationName%2FdirectoryName – Folder path

• Username – Secret Key which needs to be fetched from the Delinea Secret Server (On-Premise) - Secrets Manager.

Tip
Use urlencoder.org to encode your URL attributes.

Path syntax: {Folder_path}/{secretKey}

Before Encoding

Using Folder Name:

secrets://delinea-vault/folder1/cred/applicationName/directoryName/Password

Important
The URL path should always start with the prefix, secrets://. Each part of the URL should be URL-encoded. Each URL attribute in the path is case-sensitive

After Encoding

After you encode the URL path, it should appear as follows:

Using Folder Name:

secrets://delinea-vault/folder1%2Fcred%2FapplicationName%2FdirectoryName/Password

The following is an explanation of the attributes of this URL:

• delinea-vault – Configured Credential Provider in the Credential Provider Section

• folder1%2Fcred%2FapplicationName%2FdirectoryName – Folder path

• Password– Secret Key which needs to be fetched from the Delinea Secret Server (On-Premise) - Secrets Manager.

Tip
Use urlencoder.org to encode your URL attributes.

If any secret paths have a prefix or a suffix, you must append a query parameter to the secret path as follows:

• To add a prefix – ?prefix=<prefix>

  For example, if the secret value returned after evaluation is LocalAdmin, but the complete value required by the secret field is DomainOne\LocalAdmin then the secret path expression will be as follows to add the required prefix:

  secrets://delinea-vault/folder1%2Fcred%2FapplicationName%2FdirectoryName/Username?prefix=DomainOne%5C

• To add a suffix – ?suffix=<suffix>

  For example, if the secret value returned after evaluation is localadministrator, but the complete value required by the secret field is localadminstrator@sp.com then the secret path expression will be as follows to add the required suffix:

  secrets://delinea-vault/folder1 %2Fcred%2FapplicationName%2FdirectoryName/Username?suffix=%40sp.com

• To add a prefix and suffix – ?prefix=<prefix>& suffix=<suffix>

  For example, if the secret value returned after evaluation is LocalAdmin, but the complete value required by the secret field is DomainOne\LocalAdmin@sp.com then the secret path expression will be as follows to add the required prefix and suffix:

  secrets://delinea-vault/folder1 %2Fcred%2FapplicationName%2FdirectoryName/Username?prefix=DomainOne%5C&suffix=%40sp.com

Important
All input parameters must be encoded.

Standard format for credential path

secrets://{vault-name}/{folder path}/{secretKey}?prefix=someValue&suffix=someValue2

Note
The prefix and suffix are optional.