コンテンツにスキップ

機密性の高い画面

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

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

使いどころ

  • パスワードや PIN のフィールドにフォーカスがある
  • 支払いフォームが開いている
  • プライバシーポリシーで記録しないとしている画面

前提条件

  • SDK がインストールされ、初期化されていること。クイックスタートを参照してください。

使い方

一時停止と再開

import { DeaSdk } from '@dea/sdk';

DeaSdk.current?.pause();
// … sensitive input …
DeaSdk.current?.resume();

pause() には必ず resume() を対にしてください。一時停止中の時間は アクションを追加しないため、一時停止のまま放置された セッションは決して十分にならず、分類は 'insufficient' の ままです。pause() と resume() は同意の仕組みではありません。ユーザーが同意するまで取得を保留するには、 ユーザー同意を参照してください。

注: 何も呼ばなくても、SDK は <input type="password"> 内のキー入力からは何も記録せず(タイミング すら記録しません)、それ以外のキー入力からはキーの種類のみを記録し、文字は決して記録しません。 パスワードフィールド上のポインター入力や、カード番号やワンタイムコードなど他のフィールドでのキー入力の 種類とタイミングは、一時停止しない限り記録されます。

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

例

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

import { DeaSdk } from '@dea/sdk';

for (const field of document.querySelectorAll<HTMLInputElement>('input[type="password"]')) {
  field.addEventListener('focus', () => DeaSdk.current?.pause());
  field.addEventListener('blur', () => DeaSdk.current?.resume());
}

React: コンポーネントがマウントされている間は一時停止する

import { useEffect } from 'react';
import { DeaSdk } from '@dea/sdk';

export function PaymentForm() {
  useEffect(() => {
    DeaSdk.current?.pause();
    return () => DeaSdk.current?.resume();
  }, []);

  return <form>{/* card fields */}</form>;
}

API

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