{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":5287,"path":"conversational-interfaces/virtual-agent/va-secure-text.md","title":"Secure Text user input control","bundle":null,"doc_type":null,"release":"australia","body":"\n# Secure Text user input control\n\nThe Secure Text control provides a means to encrypt sensitive information provided as simple text or other formats. Use this control to encrypt sensitive information in topics that use large language model \\(LLM\\) discovery.\n\nUse this control to gather and encrypt user information for topics using large language model \\(LLM\\) topic discovery. The Secure Text input also avoids sensitive information from being sent through an LLM.\n\n## Secure Text user input control properties\n\n<table id=\"table_khb_p5y_11c\"><thead><tr><th>\n\nProperty\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nNode name\n\n</td><td>\n\nName that identifies this Secure Text user input control node in the topic flow.\n\n</td></tr><tr><td>\n\nPrompt\n\n</td><td>\n\nText string or script that returns text. This value is used only when the default value isn’t specified. For example: `What is your password?`\n\n</td></tr><tr><td>\n\nInput format\n\n</td><td>\n\nText format that is validated when a user enters certain text items. When the input isn’t valid, the bot asks the user to reenter the text.\n\n Choose the format of the text item to be validated:\n\n -   Text: Any text string \\(no validation\\).\n-   Email: Format that consists of an email prefix \\(user name\\), the @ symbol, and domain.\n-   IP address \\(IPV4, IPV6\\): Data communication delivery format for internet Protocol version 4 or version 6.\n-   Phone number \\(E.164\\): Internationally recognized standard phone number format.\n-   URL: Web address format.\n-   Custom: A script that provides a validation rule for a custom text format. The script should include related error messages that are displayed when the expected format isn’t entered.\n\n For phone and IP address format examples, see [E.164 phone formats](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/r_ConfigureE.164PhoneNumberFields.md) and [IP address field types](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/r-IPAddressFieldType.md).\n\n</td></tr><tr><td>\n\nHash function\n\n</td><td>\n\nThe method digest algorithm based on the standard WS-Security specification.\n\n</td></tr><tr><td>\n\nEncryption salt\n\n</td><td>\n\nRandom data that is used as an additional input to a one-way function that hashes data.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nAdvanced\n\n</td></tr><tr><td>\n\nDefault value\n\n</td><td>\n\nA value for the user response to the prompt. For example, if you already know the user name, the default value might be `(Script Variables > Last username)`.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nConfirmation messages\n\n</td></tr><tr><td>\n\nInput completion confirmation\n\n</td><td>\n\nBot response shown to the user when the node interaction is complete. The message can be either a text string or a script that returns text. For example, if you're using dot-walking: `Thanks, (Input Variables > Username)!` Or if you're using a script, the acknowledgement might be: `Thanks, {{vaInputs.username}}!`\n\n</td></tr><tr><td>\n\nDefault value confirmation\n\n</td><td>\n\nMessage that asks the user to verify that the value in the Default value field is correct. This message is used instead of a value in the Prompt field. For example: `Are you (Script Variables > Username)?`\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nHide or skip this node\n\n</td></tr><tr><td>\n\nConditionally show this node\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true.\n\n</td></tr><tr><td>\n\nAllow user to skip this node\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for letting users skip this node in the conversation. The condition must evaluate to true. You can set this field using either the condition builder or a script.\n\n</td></tr><tr><td>\n\nSkip reprompting\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for letting users skip reprompting in the conversation. When a preceding node is revisited through a topic loopback or [Dialog Act](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/c_dialog-acts.md), the Virtual Agent bypasses this node and automatically retain its original value.\n\n</td></tr></tbody>\n</table>## Example Secure Text user input control\n\n<table id=\"table_ykg_dvy_11c\"><thead><tr><th>\n\nInput properties\n\n</th><th>\n\nInput prompt\n\n</th></tr></thead><tbody><tr><td>\n\n\\[Omitted image \"va-secure-text-input.png\"\\] Alt text: Secure Text user input basic properties include node name, prompt, input format, hash function, and encryption salt. Advanced options include Default value, Confirmation message, and Hide or skip this node.\n\n</td><td>\n\n\\[Omitted image \"va-secure-text-input-web.png\"\\] Alt text: Secure Text input shown in the web client. The text reads, “What is your first and last name?” and the user response is automatically hidden.\n\n</td></tr></tbody>\n</table>## Channel support\n\n**Note:** Asset library controls may display and function differently in other channels.\n\n|Channel|Support|Constraints|\n|-------|-------|-----------|\n|Web UI|Supported|None.|\n|Mobile UI|Supported|None.|\n|ServiceNow Otto panel|Supported|None.|\n|Microsoft Teams|Supported|None.|\n|Slack|Supported|Slack users can edit text previously entered in a conversation. However, Virtual Agent processes messages as they’re first entered. If a Slack user edits text input, such as a comment to update a case, then Virtual Agent doesn’t evaluate the edited update.|\n|Workplace|Supported|None.|\n|Facebook Messenger|Supported|The maximum character limit is 5000 characters.|\n|SMS Twilio|Supported|None.|\n|LINE|Supported|The maximum character limit is 5000 characters.|\n|WhatsApp|Supported|None.|\n|Apple Messages for Business|Supported|None.|\n|Alexa \\(Voice\\)|Supported|For screen devices, character limits may apply. For more information, see the [Alexa developer documentation](https://developer.amazon.com/en-US/docs/alexa/custom-skills/display-interface-reference.html).|\n\n**Parent Topic:**[Assistant Designer user input controls](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-user-inputs.md)\n\n"}}