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.

Creating Secure Variables

Follow these steps to create a secure variable.

1. From the Build menu, select Content.

2. From the tabs at the top of the screen, select Variables.

3. Click the arrow to the right of the Create Variable button to select the variable type.

   The options are: Create Variable, Create Audio Variable, and Create Secure Variable.

   

4. Fill in the properties for the secure variable.

   1. In the Name field, give the secure variable a name.

   2. In the Value field, enter the variable value.

   

5. Click Create.

   The value is encrypted and cannot be seen again.

Editing Secure Variables

You can replace the value, but you cannot see it or partially edit it.

1. From the Build menu, select Content.

2. From the tabs at the top of the screen, select Variables.

3. Locate the secure variable in the card deck and double-click the card.

4. Replace the value.

   In the Value field, the value is masked.

   

5. Click Update.

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 level 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 level 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 level 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.