セキュリティ設定

セキュリティ設定では、データの秘匿化と保持を構成します。たとえば、これらの設定により、Cloud Logging と会話履歴におけるデータの秘匿化方法が制御されます。

セキュリティ設定はプロジェクト レベルで設定されます。プロジェクト内のエージェントへのアクセス権がある場合は、プロジェクト レベルのセキュリティ設定を表示できます。プロジェクト レベルのセキュリティ設定を更新するには、dialogflow.securitySettings.update 権限が必要です。Dialogflow でセキュリティ設定の更新が実装されるまでに、最大 1 時間かかることがあります。

注: 他の秘匿化オプションの詳細については、パラメータの秘匿化をご覧ください。

次の表に、設定をまとめます。設定の詳細については、SecuritySettings RPC リファレンスをご覧ください。

セキュリティ設定	説明
redaction_strategy	RedactionStrategy: 秘匿化の方法を定義します。
redaction_scope	RedactionScope: Dialogflow が秘匿化を適用するデータを定義します。Dialogflow は、アクセス権のないデータ（Cloud Logging など）を秘匿化しません。
inspect_template	string Sensitive Data Protection: 検査テンプレート名。このテンプレートを使用して、検査の基本設定を定義します。 エージェントのプロジェクトの Dialogflow サービス アカウント管理サービス サービス アカウントには、The DLP Inspect Templates Reader ロールが必要です。 空の場合、デフォルトの Sensitive Data Protection 検査構成が使用されます。 テンプレート名は、projects//locations//inspectTemplates/ または organizations//locations//inspectTemplates/ のいずれかの形式になります。 注: inspect_template は SecuritySettings と同じリージョンに配置する必要があります。
deidentify_template	string Sensitive Data Protection: 匿名化テンプレートの名前。このテンプレートを使用して、コンテンツの匿名化構成を定義します。 エージェントのプロジェクトの Dialogflow サービス アカウント管理サービス サービス アカウントには、DLP Deidentify Templates Reader ロールが必要です。 空の場合、Dialogflow は機密情報を [redacted] テキストに置き換えます。 テンプレート名は、projects//locations//deidentifyTemplates/ または organizations//locations//deidentifyTemplates/ のいずれかの形式になります。 注: deidentify_template は SecuritySettings と同じリージョンに配置する必要があります。
purge_data_types[]	PurgeDataType: 保持設定で削除がトリガーされたときに削除されるデータの種類のリスト。
audio_export_settings	AudioExportSettings: [] または [Participants.StreamingAnalyzeContent][] を使用して会話に音声を取り込む際に、会話後の分析用の音声エクスポート設定を制御します。 retention_strategy が REMOVE_AFTER_CONVERSATION に設定されているか、[audio_export_settings.gcs_bucket][] が空の場合、音声のエクスポートは無効になります。音声のエクスポートが有効になっている場合、音声は録音され、[audio_export_settings.gcs_bucket][] に保存されます。これは [audio_export_settings.gcs_bucket][] の保持ポリシーの対象となります。 この設定は、Sessions.DetectIntent または Sessions.StreamingDetectIntent を使用する暗黙的なセッションの音声入力には影響しません。
insights_export_settings	InsightsExportSettings: 会話の完了後に Insights への会話のエクスポート設定を制御します。 retention_strategy が REMOVE_AFTER_CONVERSATION に設定されている場合、ここで構成した内容に関係なく、Insights のエクスポートは無効になります。
data_retention	データの保持方法を指定するユニオン フィールド。保持ポリシーによってデータがパージされた場合でも、数日間はバックアップ ストレージに残る可能性があります。ただし、直接アクセスすることはできません。data_retention は次のいずれかになります。 — retention_window_days（int32）: 指定した日数だけデータを保持します。Dialogflow のデフォルトの 365 日の TTL（Agent Assist トラフィックの場合は 30 日）より小さい値を設定する必要があります。これより大きい値は無視され、デフォルトが使用されます。デフォルトより大きい値を設定すると無視されます。値が指定されていない場合や、0 に設定されている場合も、デフォルトの TTL が使用されます。データの保持構成が変更されると、変更後に作成されたデータにのみ適用されます。変更前に作成された既存のデータの TTL はそのまま残ります。 — retention_strategy: SecuritySettings.RetentionStrategy で定義された保持動作を指定します。

各ロケーションに複数のセキュリティ設定を構成できます。各エージェントは、適用するセキュリティ設定を指定します。各設定は、同じプロジェクトとロケーションにある複数のエージェントに適用できます。データ アプリケーション レベルの詳細については、データ アプリケーション レベルをご覧ください。

エージェントにセキュリティ設定を指定しない場合、Dialogflow は秘匿化を適用しません。

セキュリティ設定のリソースを作成する

特定のロケーションにセキュリティ設定リソースを作成するには:

コンソール

1. Dialogflow CX コンソールに移動する。
2. Google Cloud プロジェクトを選択します。
3. エージェントを選択します。
4. [エージェント設定] をクリックします。
5. [セキュリティ] タブをクリックします。
6. [セキュリティ設定を管理] をクリックします。CCAI コンソールが新しいタブで開きます。
7. CCAI コンソールで [セキュリティ設定を作成] をクリックします。
8. セキュリティ設定の構成を入力します。
9. [作成] をクリックします。

API

create メソッドの詳細については、SecuritySettings タイプをご覧ください。SecuritySettings API リファレンスに移動

SecuritySettings リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	SecuritySettings リソース	SecuritySettings リソース
RPC	SecuritySettings インターフェース	SecuritySettings インターフェース
C++	SecuritySettingssClient	利用できません
C#	SecuritySettingssClient	利用できません
Go	SecuritySettingssClient	利用できません
Java	SecuritySettingssClient	SecuritySettingssClient
Node.js	SecuritySettingssClient	SecuritySettingssClient
PHP	利用不可	利用できません
Python	SecuritySettingssClient	SecuritySettingssClient
Ruby	利用不可	利用できません

終了

エージェントのセキュリティ設定を指定する

エージェントのセキュリティ設定を指定するには:

コンソール

1. Dialogflow CX コンソールに移動する。
2. Google Cloud プロジェクトを選択します。
3. エージェントを選択します。
4. [エージェント設定] をクリックします。
5. [セキュリティ] タブをクリックします。
6. [セキュリティ設定] プルダウン メニューで設定を選択します。
7. [保存] をクリックします。

API

patch メソッドと update メソッドの詳細については、Agent タイプをご覧ください。Agent API リファレンスに移動

エージェント リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	エージェント リソース	エージェント リソース
RPC	エージェント インターフェース	エージェント インターフェース
C++	AgentsClient	利用できません
C#	AgentsClient	利用できません
Go	AgentsClient	利用できません
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	利用不可	利用できません
Python	AgentsClient	AgentsClient
Ruby	利用不可	利用できません

終了

注意: Sensitive Data Protection の検査テンプレートが定義されていない場合は、デフォルトのテンプレートが使用されます。デフォルトのテンプレートでは、一部の infoType 検出器のみが有効になっており、エンドユーザーの要件に従ってタイプを識別して削除するには信頼性が低い可能性があります。可能な限り、常に Sensitive Data Protection テンプレートを作成します。