Mobile Session Replay Privacy Options

Docs > Product Analytics > Session Replay > Mobile Session Replay > Mobile Session Replay Privacy Options

このページは日本語には対応しておりません。随時翻訳に取り組んでいます。
翻訳に関してご質問やご意見ございましたら、お気軽にご連絡ください。

概要

セッションリプレイは、あらゆる規模の組織が機密データや個人データを公開しないよう、プライバシーコントロールを提供します。データは Datadog が管理するクラウドインスタンスに保存され、静止時には暗号化されます。

セッションリプレイのデフォルトのプライバシーオプションは、エンドユーザーのプライバシーを保護し、重要な組織情報が収集されるのを防ぎます。

モバイルセッションリプレイを有効にすることで、RUM モバイル SDK を通じて記録される機密要素を自動的にマスクすることができます。データがマスクされると、そのデータは Datadog の SDK によって元の形で収集されないため、バックエンドに送信されることはありません。

きめ細かいマスキング

以下のマスキングモードを使用すると、アプリケーションごとにデフォルト設定を上書きできます。マスキングはきめ細かく制御できるため、テキストや入力内容、画像、タッチ操作などそれぞれ個別にオーバーライドして、ニーズに合わせたカスタム設定を行うことができます。

テキストと入力のマスキング

デフォルトでは、すべてのデータに対して mask_all 設定が有効になっています。この設定が有効な場合、画面上のすべてのテキストや入力内容が以下のようにマスクされます。

センシティブ入力をマスクする

mask_sensitive_inputs 設定を有効にすると、パスワードフィールドなどセンシティブと見なされるものを除き、すべてのテキストと入力内容が表示されます。

application.kt

    val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    .setTextAndInputPrivacy(TextAndInputPrivacy.MASK_SENSITIVE_INPUTS)
    .build()
    SessionReplay.enable(sessionReplayConfig)

AppDelegate.swift

    let sessionReplayConfig = SessionReplay.Configuration(
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: .maskSensitiveInputs,
        imagePrivacyLevel: imagePrivacyLevel,
        touchPrivacyLevel: touchPrivacyLevel
    )
    SessionReplay.enable(with: sessionReplayConfig)

App.tsx

    import {
        SessionReplay,
        SessionReplayConfiguration,
        TextAndInputPrivacyLevel,
    } from "@datadog/mobile-react-native-session-replay";

    const config: SessionReplayConfiguration = {
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: TextAndInputPrivacyLevel.MASK_SENSITIVE_INPUTS,
    }

    SessionReplay.enable(config)

すべての入力欄をマスクする

mask_all_inputs 設定を有効にすると、リプレイ中であらゆる入力欄がマスクされます。

application.kt

    val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    .setTextAndInputPrivacy(TextAndInputPrivacy.MASK_ALL_INPUTS)
    .build()
    SessionReplay.enable(sessionReplayConfig)

AppDelegate.swift

    let sessionReplayConfig = SessionReplay.Configuration(
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: .maskAllInputs,
        imagePrivacyLevel: imagePrivacyLevel,
        touchPrivacyLevel: touchPrivacyLevel
    )
    SessionReplay.enable(with: sessionReplayConfig)

App.tsx

    import {
        SessionReplay,
        SessionReplayConfiguration,
        TextAndInputPrivacyLevel,
    } from "@datadog/mobile-react-native-session-replay";

    const config: SessionReplayConfiguration = {
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: TextAndInputPrivacyLevel.MASK_ALL_INPUTS,
    }

    SessionReplay.enable(config)

すべてマスク

mask_all 設定を有効にすると、リプレイ上ですべてのテキストや入力欄がマスクされます。

application.kt

    val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    .setTextAndInputPrivacy(TextAndInputPrivacy.MASK_ALL)
    .build()
    SessionReplay.enable(sessionReplayConfig)

AppDelegate.swift

    let sessionReplayConfig = SessionReplay.Configuration(
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: .maskAll,
        imagePrivacyLevel: imagePrivacyLevel,
        touchPrivacyLevel: touchPrivacyLevel
    )
    SessionReplay.enable(with: sessionReplayConfig)

App.tsx

    import {
        SessionReplay,
        SessionReplayConfiguration,
        TextAndInputPrivacyLevel,
    } from "@datadog/mobile-react-native-session-replay";

    const config: SessionReplayConfiguration = {
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: TextAndInputPrivacyLevel.MASK_ALL,
    }

    SessionReplay.enable(config)

画像のマスキング

デフォルトでは、すべての画像に対して mask_all 設定が有効になっています。この設定が有効な場合、画面上のすべての画像がマスクされます。

すべての画像をマスクする

mask_all 設定が有効な場合、リプレイ上ではすべての画像が「Image」と表示されるプレースホルダーに置き換えられます。

application.kt

    val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    .setImagePrivacy(ImagePrivacy.MASK_ALL)
    .build()
    SessionReplay.enable(sessionReplayConfig)

AppDelegate.swift

    let sessionReplayConfig = SessionReplay.Configuration(
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: textAndInputPrivacyLevel,
        imagePrivacyLevel: .maskAll,
        touchPrivacyLevel: touchPrivacyLevel
    )
    SessionReplay.enable(with: sessionReplayConfig)

App.tsx

    import {
        SessionReplay,
        SessionReplayConfiguration,
        ImagePrivacyLevel,
    } from "@datadog/mobile-react-native-session-replay";

    const config: SessionReplayConfiguration = {
        replaySampleRate: sampleRate, 
        imagePrivacyLevel: ImagePrivacyLevel.MASK_ALL,
    }

    SessionReplay.enable(config)

コンテンツ画像をマスクする

システム画像を表示したままコンテンツをマスクしたい場合、以下の設定を選択できます。

iOS: mask_non_bundled_only 設定を使用すると、システムの一部ではないすべての画像が「Content Image」というプレースホルダーに置き換えられます。

Android: mask_large_only 設定を使用すると、100x100dp を超えるサイズの画像のみが「Content Image」というプレースホルダーに置き換えられます。

注: ここでの寸法はビューのサイズではなく、drawable リソースのサイズを指します。

Android で `mask_large_only` が有効な場合のアプリ画面例

application.kt

    val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    .setImagePrivacy(ImagePrivacy.MASK_LARGE_ONLY)
    .build()
    SessionReplay.enable(sessionReplayConfig)

iOS で `mask_non_bundled_only` が有効な場合のアプリ画面例

AppDelegate.swift

    let sessionReplayConfig = SessionReplay.Configuration(
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: textAndInputPrivacyLevel,
        imagePrivacyLevel: .maskNonBundledOnly,
        touchPrivacyLevel: touchPrivacyLevel
    )
    SessionReplay.enable(with: sessionReplayConfig)

App.tsx

    import {
        SessionReplay,
        SessionReplayConfiguration,
        ImagePrivacyLevel,
    } from "@datadog/mobile-react-native-session-replay";

    const config: SessionReplayConfiguration = {
        replaySampleRate: sampleRate, 
        imagePrivacyLevel: ImagePrivacyLevel.MASK_NON_BUNDLED_ONLY,
    }

    SessionReplay.enable(config)

すべての画像を表示する

mask_none 設定が有効になると、リプレイで表示されるすべての画像がマスクされずにそのまま表示されます。

application.kt

    val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    .setImagePrivacy(ImagePrivacy.MASK_NONE)
    .build()
    SessionReplay.enable(sessionReplayConfig)

AppDelegate.swift

    let sessionReplayConfig = SessionReplay.Configuration(
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: textAndInputPrivacyLevel,
        imagePrivacyLevel: .maskNone,
        touchPrivacyLevel: touchPrivacyLevel
    )
    SessionReplay.enable(with: sessionReplayConfig)

App.tsx

    import {
        SessionReplay,
        SessionReplayConfiguration,
        ImagePrivacyLevel,
    } from "@datadog/mobile-react-native-session-replay";

    const config: SessionReplayConfiguration = {
        replaySampleRate: sampleRate, 
        imagePrivacyLevel: ImagePrivacyLevel.MASK_NONE,
    }

    SessionReplay.enable(config)

タッチのマスキング

デフォルトでは、すべてのタッチに対して hide 設定が有効になっています。この設定が有効な場合、画面上で行われるすべてのタッチが非表示になります。

すべてのタッチを非表示にする

hide 設定が有効な場合、リプレイ中に発生するすべてのタッチが非表示になります。これがデフォルトの設定です。

application.kt

    val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    .setTouchPrivacy(TouchPrivacy.HIDE)
    .build()
    SessionReplay.enable(sessionReplayConfig)

AppDelegate.swift

    let sessionReplayConfig = SessionReplay.Configuration(
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: textAndInputPrivacyLevel,
        imagePrivacyLevel: imagePrivacyLevel,
        touchPrivacyLevel: .hide
    )
    SessionReplay.enable(with: sessionReplayConfig)

App.tsx

    import {
        SessionReplay,
        SessionReplayConfiguration,
        TouchPrivacyLevel,
    } from "@datadog/mobile-react-native-session-replay";

    const config: SessionReplayConfiguration = {
        replaySampleRate: sampleRate, 
        touchPrivacyLevel: TouchPrivacyLevel.HIDE,
    }

    SessionReplay.enable(config)

すべてのタッチを表示する

show 設定が有効な場合、リプレイ中に発生するすべてのタッチが表示されます。

application.kt

    val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    .setTouchPrivacy(TouchPrivacy.SHOW)
    .build()
    SessionReplay.enable(sessionReplayConfig)

AppDelegate.swift

    let sessionReplayConfig = SessionReplay.Configuration(
        replaySampleRate: sampleRate, 
        textAndInputPrivacyLevel: textAndInputPrivacyLevel,
        imagePrivacyLevel: imagePrivacyLevel,
        touchPrivacyLevel: .show
    )
    SessionReplay.enable(with: sessionReplayConfig)

App.tsx

    import {
        SessionReplay,
        SessionReplayConfiguration,
        TouchPrivacyLevel,
    } from "@datadog/mobile-react-native-session-replay";

    const config: SessionReplayConfiguration = {
        replaySampleRate: sampleRate, 
        touchPrivacyLevel: TouchPrivacyLevel.SHOW,
    }

    SessionReplay.enable(config)

プライバシーオーバーライド

前述のセクションでは、アプリケーション全体に適用されるグローバルなマスキングレベルについて説明しました。しかし、これらの設定はビュー単位でもオーバーライドが可能です。テキストと入力、画像、タッチ操作に対しては先ほどと同じプライバシーレベルが使用でき、さらに特定のビューを完全に非表示にする設定も追加されています。

オーバーライドを正しく認識させるためには、ビューのライフサイクルで可能な限り早い段階で適用する必要があります。そうすることで、Session Replay がオーバーライドの適用前にビューを処理してしまう事態を防げます。

プライバシーオーバーライドは、指定したビューおよびその子孫ビューに影響します。つまり、仮に画像オーバーライドをテキスト入力ビューに適用しても、実際にはすべての子ビューに対して有効となります。

オーバーライドは「最も近い親」の設定に従って動作します。もしビュー自体にオーバーライドがあればその設定が使われ、なければ階層内で最も近い親のオーバーライドを継承します。もし親にも設定がなければ、アプリケーション全体のマスキングレベルが適用されます。

SwiftUI ではプライバシーオーバーライドをサポートしていません。

テキストと入力のオーバーライド

テキストと入力のプライバシーをオーバーライドするには、対象のビューインスタンスで setSessionReplayTextAndInputPrivacy を呼び出し、TextAndInputPrivacy 列挙体の値を渡します。null を渡すとオーバーライドが解除されます。

application.kt

    // ビューにテキストと入力のオーバーライドを設定
    myView.setSessionReplayTextAndInputPrivacy(TextAndInputPrivacy.MASK_SENSITIVE_INPUTS)
    // ビューから画像オーバーライドを削除
    myView.setSessionReplayTextAndInputPrivacy(null)

テキストと入力のプライバシーをオーバーライドするには、対象のビューインスタンスで dd.sessionReplayOverrides.textAndInputPrivacy を設定し、TextAndInputPrivacyLevel 列挙体の値を指定します。nil を設定するとオーバーライドが解除されます。

AppDelegate.swift

    // ビューにテキストと入力のオーバーライドを設定
    myView.dd.sessionReplayOverrides.textAndInputPrivacy = .maskSensitiveInputs
    // ビューから画像オーバーライドを削除
    myView.dd.sessionReplayOverrides.textAndInputPrivacy = nil

画像のオーバーライド

画像のプライバシーをオーバーライドするには、対象のビューインスタンスで setSessionReplayImagePrivacy を呼び出し、ImagePrivacy 列挙体の値を渡します。null を渡すとオーバーライドが解除されます。

application.kt

    // ビューに画像オーバーライドを設定
    myView.setSessionReplayImagePrivacy(ImagePrivacy.MASK_ALL)
    // ビューから画像オーバーライドを削除
    myView.setSessionReplayImagePrivacy(null)

画像のプライバシーをオーバーライドするには、対象のビューインスタンスで dd.sessionReplayOverrides.imagePrivacy を設定し、ImagePrivacyLevel 列挙体の値を指定します。nil を設定するとオーバーライドが解除されます。

AppDelegate.swift

    // ビューに画像オーバーライドを設定
    myView.dd.sessionReplayOverrides.imagePrivacy = .maskAll
    // ビューから画像オーバーライドを削除
    myView.dd.sessionReplayOverrides.imagePrivacy = nil

タッチのオーバーライド

タッチのプライバシーをオーバーライドするには、対象のビューインスタンスで setSessionReplayTouchPrivacy を呼び出し、TouchPrivacy 列挙体の値を渡します。null を渡すとオーバーライドが解除されます。

application.kt

    // ビューにタッチオーバーライドを設定
    view.setSessionReplayTouchPrivacy(TouchPrivacy.HIDE)
    // ビューからタッチオーバーライドを削除
    view.setSessionReplayTouchPrivacy(null)

タッチのプライバシーをオーバーライドするには、対象のビューインスタンスで dd.sessionReplayOverrides.touchPrivacy を設定し、TouchPrivacyLevel 列挙体の値を指定します。nil を設定するとオーバーライドが解除されます。

AppDelegate.swift

    // ビューにタッチオーバーライドを設定
    myView.dd.sessionReplayOverrides.touchPrivacy = .hide
    // ビューからタッチオーバーライドを削除
    myView.dd.sessionReplayOverrides.touchPrivacy = nil

隠し要素のオーバーライド

完全に非表示にする必要がある機密要素には、hidden 設定を使用します。

要素が hidden に設定されると、リプレイ上では「Hidden」というラベルのプレースホルダーに置き換えられ、その子ビューは記録されません。

注: ビューを hidden としてマークしても、その要素に対するタッチ操作の記録は防げません。タッチ操作も隠したい場合は、要素を hidden にするのに加えてタッチのオーバーライドも併用してください。

要素を非表示にするには、setSessionReplayHidden(hide = true) を使用します。hide を false に設定するとオーバーライドが解除されます。

application.kt

    // ビューを非表示に設定
    myView.setSessionReplayHidden(hide = true)
    // ビューからオーバーライドを削除
    myView.setSessionReplayHidden(hide = false)

AppDelegate.swift

    // ビューを非表示に設定
    myView.dd.sessionReplayOverrides.hide = true
    // ビューからオーバーライドを削除
    myView.dd.sessionReplayOverrides.hide = false

注: hidden オーバーライドを nil に設定した場合は、false と同じ扱いになり、オーバーライドが無効化されます。

WebView に関する注意点

hidden と touch を除くプライバシーオーバーライドは、WebView ではサポートされていません。主にブラウザ SDK のプライバシー設定を使用して管理してください。
WebView を hidden としてマークした場合、リプレイ上ではプレースホルダーに置き換えられますが、WebView 自体はデータの収集と送信を継続します。これを避けるには、より細かい制御が可能なブラウザ SDK のプライバシー設定を使用することを推奨します。

マスキングの対象データとその方法

このセクションでは、Datadog のレコーダーがデータの種類に基づきマスキングをどのように処理し、そのデータがどのように定義されるかを説明します。

テストマスキング戦略

Datadog のマスキングルールでは、プライバシー設定の構成方法、テキストのタイプ、データの機密性に応じて、テキストフィールドのタイプごとに異なる戦略が適用されます。

テキストのマスキング戦略	説明	例
マスクなし	セッションリプレイでテキストを表示	`"Hello world"` → `"Hello world"`
スペース保持型マスク	表示される各文字を小文字の “x” に置換	`"Hello world"` → `"xxxxx xxxxx"`
固定長マスク	テキストフィールド全体を 3 つのアスタリスク (***) から成る定数に置換	`"Hello world"` → `"***"`

上記のテキスト戦略を念頭に、コンフィギュレーションで mask のデフォルトのプライバシールールを上書きしたい場合は、いくつかのオプションがあります。

以下のチャートは、Datadog で、ユーザーが構成で設定したルールを使用して、各テキストタイプにどのようにテキストマスキング戦略が適用されるかを示しています。

タイプ	すべて許可	すべてマスク	ユーザー入力をマスク
機密テキスト	固定長マスク	固定長マスク	固定長マスク
入力・オプションテキスト	マスクなし	固定長マスク	固定長マスク
静的テキスト	マスクなし	スペース保持型マスク	マスクなし
ヒントテキスト	マスクなし	固定長マスク	マスクなし

テキストのマスキングの定義

Datadog のレコーダーが各テキストタイプをどのように取り扱うかについては、以下の説明をご覧ください。

機密テキスト

機密テキストには、プラットフォーム固有の方法で識別が施されたパスワード、メールアドレス、電話番号や、各プラットフォームで用意されている機密性を示すその他のテキスト形式が含まれます。

これには、以下のテキスト内のパスワード、メールアドレス、電話番号が含まれます。

テキストフィールド (iOS)
テキストビュー (iOS)
編集テキスト (Android)
住所情報 (iOS + Android)
クレジットカード情報 (iOS)
ワンタイムコード (iOS)

入力・オプションテキスト

入力・オプションテキストとは、ユーザーがキーボードその他のテキスト入力デバイスを使って入力したテキスト、または選択要素内のカスタム (共通ではない) 値のことです。

以下のものが含まれます。

ユーザーが以下で入力したテキスト
- テキストフィールド (iOS)
- テキストビュー (iOS)
- 編集テキスト (Android)
ユーザーが以下で選択したオプション
- 値の選択ツール (iOS + Android)
- セグメント (iOS)
- ドロップダウンリスト (Android)
主な例外
- テキストフィールド、テキストビュー、編集テキストのプレースホルダー (ヒント) テキスト (ユーザー入力したものではないテキスト)
- テキストビューの編集不可能なテキスト (iOS).
- 日付選択ツールの月、日、年のラベル (共通の値)