Secure Variables

Store credentials in a fully encrypted manner.

The value is masked everywhere it appears in the user interface and logs.

The value is available to the Integration node only.

Name

Give the secure variable a name.

Value

Scenario

Description

Creating the secure variable

Enter the variable value and click Create.

The value is encrypted and cannot be seen again.

Editing the secure variable

The value is masked. You can replace it, but you cannot see it or partially edit it.

 

Note:

There is a character limit when setting the value on the screen Build > Content > Variables. The value should not exceed 150 characters. This limitation does not apply when setting the value while the task is running or assigning a value to a secure column in a datastore and reading the value back to the secure variable while the task is running.

Access to Secure Variables

Following are some general tips.

  • The Expression Builder has access to secure variables, dependent on the node it is opened from.

  • The Integration node is the only node that can be used to construct a URL with query parameters using secure variable values.

  • Studio accesses JSON formatted data through open form types and nodes like the Integration node. You can assign any JSON path result value to a secure variable except if the value is audio. You have no access to secure variables when using variables to create a JSON path.

Following are nodes and their level of access to secure variables.

Node

Level of Access

Biometrics

Prompt fields have no access to secure variables. You can store the enroll ID in a secure variable.

Blind Transfer

Expression builder has no access to secure variables.

Bridge Transfer

Expression builder has no access to secure variables.

Calendar

No access to secure variables.

Cloud STT

Prompt fields have no access to secure variables.

From the Speech Recognizer tab, you can assign the caller's transcribed responses and the confidence score associated with the transcribed text to secure variables. The entire message is then masked (**********) in the system log.

Conversation

No access to secure variables. If you assign a secure variable to any of the extracted words then the entire message is masked (**********) in the system log.

Datastore

Insert and update actions have access to secure variables. Secure variables can be used inside expressions and the expression builder has access to secure values. If a secure value is written to a non-secure column, the masked value (**********) is written. Fetch query conditions do not have access to data store secure columns.

Decision

Expression builder has access to secure variables and values. Comparisons allowed with data store secure column values.

Form

Access secure variables with open form types as follows.

  • Prompt text fields have no access to secure variables.

  • Can store the language ID and ds_boost_column in secure variables.

  • Can assign the transcribed text and the confidence score associated with the transcribed text to secure variables. The entire message is then masked (**********) in the system log.

Integration

Access secure variables in almost all places where variables are referenced.

Keyword Finder

If you assign a secure variable to the text detail (the caller's unstructured input) then assign secure variables to the extracted words, otherwise the masked value (**********) is written to the variables assigned to the extracted words.

Menu

No access to secure variables inside prompt fields.

Payment

Can store URL and request parameters in secure variables. You can assign response values to secure variables.

Prompt

No access to secure variables.

Prompt Recorder

No access to secure variables.

QforMe Add to Queue

No access to secure variables.

QforMe Check Waiter

No access to secure variables.

Record

No access to secure variables.

Reply

No access to secure variables.

Screenpop Transfer

Expression builder has no access to secure variables.

Send Email No access to secure variables.

Send SMS

No access to secure variables.

SIP Header

No access to secure variables.

Start

Can assign values to secure variables.

Text Form

Input text fields and query parameters have no access to secure variables.

Can store the language ID in a secure variable.

Can assign the transcribed text and the confidence score associated with the transcribed text to secure variables. The entire message is then masked (**********) in the system log.

Trigger Campaign

No access to secure variables.

Variable

The expression builder has access to secure values.

Variable

Return Value

Expression

Secure Variable

Write the result. Store securely.

All expressions.

Not a Secure Variable

Write the result.

A secure variable value is not used to evaluate the result.

A secure variable value is used to evaluate the result and the final function evaluated is in the following list.

  • Get String Length

  • Search String

  • Matches Regex

  • Compare

  • Conditions(AND/OR)

Not a Secure Variable

Write the masked value (**********).

A secure variable value is used to evaluate the result and the final expression is not among the list mentioned above.

Web Services

Node

Level of Access

Tone Analyzer

No access to secure variables.