Add and Reference Text Secrets

Updated 1 week ago by Rashmi Nanda Sahoo

You can add a text secret to the Secret Manager and use them in your resources like Pipelines and Connectors.

This topic describes how to add a text secret in Harness.

Before You Begin

Step 1: Add Text Secret

This topic assumes you have a Harness Project set up. If not, see Create Organizations and Projects.

Secrets can be added inline while setting up a Connector or other setting, and they can also be set up in the Account/Organization/Project resources.

These steps are for setting up a secret in the Account/Organization/Project resources. To do this, go to Project setup, Organization, or Account Resources.

Click Secrets.

Click Secret and select Text.

The Add new Encrypted Text settings appear.

Select the Secret Manager you will use to encrypt this secret.

Enter a name for the encrypted text. This is the name you will use to reference the text elsewhere in your resources.

Enter a value for the encrypted text.

Enter Description for your secret.

Enter Tags for your secret.

Click Save.

Step 2: Use the Encrypted Text in Connectors

All of the passwords and keys used in Harness Connectors are stored as Encrypted Text secrets in Harness.

You can either create the Encrypted Text secret first and then select it in the Connector or you can create/select it from the Connector by clicking Create or Select a Secret:

You can also edit it in the Connector.

Step 3: Reference the Encrypted Text by Identifier

For an Encrypted Text secret that's been scoped to a Project, you reference the secret in using the secret identifier in the expression: <+secrets.getValue("your_secret_Id")>.

For example, if you have a text secret with the identifier doc-secret, you can reference it in a Shell Script step like this:

echo "text secret is: " <+secrets.getValue("doc-secret")>

For Encrypted Text scoped to an Account, you reference them using account with the text secret identifier<+secrets.getValue("account.your_secret")>

Always reference a secret in an expression using its identifier. Names will not work.

Review: Invalid Characters in Secret Names

The following characters aren't allowed in the names of secrets:

 ~ ! @ # $ % ^ & * ' " ? / < > , ;

Review: Secrets in Outputs

When a secret is displayed in an output, Harness substitutes the secret value with asterisks so that the secret value is masked. Harness replaces each character in the name with an asterisk (*).

For example, here the secret values referenced in a Shell Script step are replaced with *****:

If you accidentally use a very common value in your secret, like whitespace, the * substitution might appear in multiple places in the output.

If you see an output like this, review your secret and fix the error.

Review: Secret Scope

When creating secrets, it's important to understand their scope in your Harness account.

A user can only create a secret according to the scope set by its Harness User permissions.

For example, when you create a new project or a new organization, a Harness Secret Manager is automatically scoped to that level.

Review: Line breaks and Shell-Interpreted Characters

A text secret can be referenced in a script and written to a file as well. For example, here is a secret decoded from base64 and written to a file:

echo <+secrets.getValue("my_secret")> | base64 -d > /path/to/file.txt

If you have line breaks in your secret value, you can encode the value, add it to a secret, and then decode it when you use it in a Harness step.

The previous example uses base64, but you can also write a secret to a file without it:

echo '<+secrets.getValue("long_secret")>' > /tmp/secretvalue.txt

If you do not use base64 and the secret value contains any character that are interpreted by the shell, it might cause issues.

In this case, you can use a special-purpose code block:

cat >/harness/secret_exporter/values.txt << 'EOF'


Sanitization only looks for an exact match of what is stored. So if you stored a base64 encoded value then only the base64 encoded value is sanitized.

For example, let say I have this multiline secret:

line 1
line 2
line 3

When it is base64 encoded, it results in bGluZSAxCmxpbmUgMgpsaW5lIDM=.

We can add this to a Harness secret named linebreaks and then decode the secret like this:

echo <+secrets.getValue("linebreaks")> | base64 -d

The result loses any secret sanitization.

Please Provide Feedback