コンテンツにスキップ

機密性の高い画面

ヒューマンスコアリングユースケースの一部です。

パスワード、カード番号、ワンタイムコードなど、機密性の高い入力が画面に表示されている間は取得を 一時停止します。一時停止中、SDK は何も記録しません。セッションは継続し、再開すると取得は中断した ところから続きます。

使いどころ

  • ログイン画面や PIN 画面が開いている
  • 決済フォームが開いている
  • プライバシーポリシーで記録しないとしている画面

前提条件

使い方

一時停止と再開

import 'package:dea_sdk/dea_sdk.dart';

DeaSdk.instance?.pause();
// … sensitive screen …
DeaSdk.instance?.resume();
  • pause() には必ず resume() を対にしてください。一時停止中の時間は アクションを追加しないため、一時停止のまま放置された セッションは決して十分にならず、分類は insufficient のままです。
  • resume() は同意を上書きしません。ユーザーが同意していなければ、再開後も何も記録されません。
  • 一時停止中は、アプリが captureKey や capturePointer で報告する入力も破棄され、 カスタムイベントも同様です。

注: pause() と resume() はネストしません。pause() を何回呼んでいても、1 回の resume() で 取得が再開されます。そのため、アプリの 2 つの部分がそれぞれ独自に一時停止すると干渉します。先に再開 した方が、もう一方がまだ機密性の高い内容を表示している間に取得を再開してしまいます。一時停止の 責任者を 1 つに決めるか、自分で一時停止の回数を数えて、カウントがゼロに戻ったときにだけ resume() を呼んでください。

例

画面が表示されている間だけ一時停止する

import 'package:dea_sdk/dea_sdk.dart';
import 'package:flutter/material.dart';

class PaymentScreen extends StatefulWidget {
  const PaymentScreen({super.key});

  @override
  State<PaymentScreen> createState() => _PaymentScreenState();
}

class _PaymentScreenState extends State<PaymentScreen> {
  @override
  void initState() {
    super.initState();
    DeaSdk.instance?.pause();
  }

  @override
  void dispose() {
    DeaSdk.instance?.resume();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Payment')),
      body: const Column(children: [
        TextField(decoration: InputDecoration(labelText: 'Card number')),
        TextField(decoration: InputDecoration(labelText: 'CVC'), obscureText: true),
      ]),
    );
  }
}

パスワードフィールドにフォーカスがある間だけ一時停止する

import 'package:dea_sdk/dea_sdk.dart';
import 'package:flutter/material.dart';

class PasswordField extends StatefulWidget {
  const PasswordField({super.key});

  @override
  State<PasswordField> createState() => _PasswordFieldState();
}

class _PasswordFieldState extends State<PasswordField> {
  final _focus = FocusNode();

  @override
  void initState() {
    super.initState();
    _focus.addListener(() {
      if (_focus.hasFocus) {
        DeaSdk.instance?.pause();
      } else {
        DeaSdk.instance?.resume();
      }
    });
  }

  @override
  void dispose() {
    if (_focus.hasFocus) DeaSdk.instance?.resume();
    _focus.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return TextField(
      focusNode: _focus,
      obscureText: true,
      decoration: const InputDecoration(labelText: 'Password'),
    );
  }
}

API

メンバー 戻り値 説明
pause() void 記録を停止する。セッションは維持される
resume() void 記録を再開する