セキュリティ設定

セキュリティ設定では、データの除去と保持を構成します。たとえば、これらの設定により、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 サービスの ID アカウント管理サービス アカウントには、エージェントのプロジェクトに The DLP Inspect Templates Reader のロールが必要です。 空の場合、デフォルトの Sensitive Data Protection 検査構成が使用されます。 テンプレート名は、projects//locations//inspectTemplates/ または organizations//locations//inspectTemplates/ のいずれかの形式になります。 注: inspect_template は SecuritySettings と同じリージョンに存在する必要があります。
deidentify_template	string Sensitive Data Protection: 匿名化テンプレート名。このテンプレートを使用して、コンテンツの匿名化の構成を定義します。 Dialogflow サービスの ID アカウント管理サービス アカウントには、エージェントのプロジェクトに 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: 会話の完了後に分析情報に会話をエクスポートする設定を制御します。 retention_strategy が REMOVE_AFTER_CONVERSATION に設定されている場合、ここで構成した内容に関係なく、分析情報のエクスポートは無効になります。
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 テンプレートを作成してください。