Security settings are used to configure data redaction and data retention. For example, these settings control how data is redacted in Cloud logging and interaction logging used by Conversation history .
Security settings are set at the project level. If a user is granted access to an agent in a project, they can view project-level Security settings. To update project-level Security settings, a user should have the dialogflow.securitySettings. permission .
The following table provides summary descriptions of the settings. For more information on the settings, see the RPC SecuritySettings reference .
| Security settings | Description |
|---|---|
| redaction_strategy | Strategy used for redaction. |
| redaction_scope | The data redaction is applied to. |
| inspect_template | DLP inspect template name. There are no incremental costs when using DLP in Dialogflow CX. |
| deidentify_template | DLP deidentify template name. There are no incremental costs when using DLP in Dialogflow CX. |
| purge_data_types | Data to remove when a data retention purge is triggered. |
| retention_window_days | Number of days that data is retained. |
Multiple security settings can be configured in each location . Each agent can specify the security settings to apply, and each setting can be applied to multiple agents in the same project and location. For more information about how data is applied at varying levels, see the data application levels .
If no security settings are specified in an agent, no redaction will be applied.
Create a security settings resource
To create a security settings resource in a particular location:
Console
- Open the Dialogflow CX Console .
- Choose your Google Cloud project.
- Select your agent.
- Click Agent Settings.
- Click the Securitytab.
- Click Manage Security Settings. The CCAI console opens in a new tab.
- Click Create Security Settingsin the CCAI console.
- Enter security settings configuration.
- Click Create.
API
See the create
method for the SecuritySettings
type.
Select a protocol and version for the SecuritySettings reference:
| Protocol | V3 | V3beta1 |
|---|---|---|
|
REST
|
SecuritySettings resource | SecuritySettings resource |
|
RPC
|
SecuritySettings interface | SecuritySettings interface |
|
C++
|
SecuritySettingssClient | Not available |
|
C#
|
SecuritySettingssClient | Not available |
|
Go
|
SecuritySettingssClient | Not available |
|
Java
|
SecuritySettingssClient | SecuritySettingssClient |
|
Node.js
|
SecuritySettingssClient | SecuritySettingssClient |
|
PHP
|
Not available | Not available |
|
Python
|
SecuritySettingssClient | SecuritySettingssClient |
|
Ruby
|
Not available | Not available |
Specify a security setting in agent
To specify a security setting in agent:
Console
- Open the Dialogflow CX Console .
- Choose your Google Cloud project.
- Select your agent.
- Click Agent Settings.
- Click the Securitytab.
- Select the settings in Security settingsdrop down menu.
- Click Save.
API
See the patch/update
methods for the Agent
type.
Select a protocol and version for the Agent reference:
| Protocol | V3 | V3beta1 |
|---|---|---|
|
REST
|
Agent resource | Agent resource |
|
RPC
|
Agent interface | Agent interface |
|
C++
|
AgentsClient | Not available |
|
C#
|
AgentsClient | Not available |
|
Go
|
AgentsClient | Not available |
|
Java
|
AgentsClient | AgentsClient |
|
Node.js
|
AgentsClient | AgentsClient |
|
PHP
|
Not available | Not available |
|
Python
|
AgentsClient | AgentsClient |
|
Ruby
|
Not available | Not available |
