機密性の高い画面¶
ヒューマンスコアリングユースケースの一部です。
パスワード、カード番号、ワンタイムコードなど、機密性の高い入力が画面にある間は取得を一時停止します。一時停止中、 SDK は何も記録しません。セッションは継続し、再開すると取得は中断した箇所から続きます。
使いどころ¶
- ログイン画面や PIN 画面が開いているとき
- 決済フォームが開いているとき
- プライバシーポリシーで記録しないとしている画面
前提条件¶
- SDK がインストールされ、初期化されている。クイックスタートを参照してください。
使い方¶
一時停止と再開¶
import * as Dea from '@dea/react-native';
await Dea.pause();
// … sensitive screen …
await Dea.resume();
- 呼び出しは行った順に実行されます。機密性の高い内容をまったく取得させたくない場合は、表示する前に
pause()を await してください。 pause()には必ずresume()を対にしてください。一時停止中の時間は アクションを追加しないため、一時停止したままのセッションは 決して十分にならず、分類はinsufficientのままです。resume()は同意を上書きしません。ユーザーが同意していなければ、再開後も何も記録されません。
注:
pause()とresume()はネストしません。pause()を何回呼び出していても、1 回のresume()で取得が 再開されます。そのため、アプリ内の 2 つの部分がそれぞれ独自に一時停止すると干渉します。先に再開した方が、 もう一方がまだ機密性の高い内容を表示している間に取得を再開してしまいます。一時停止の担い手をひとつに するか、一時停止の回数を自分で数え、回数がゼロに戻ったときだけresume()を呼び出してください。
例¶
画面が表示されている間一時停止する¶
import {useEffect} from 'react';
import {TextInput, View} from 'react-native';
import * as Dea from '@dea/react-native';
export function PaymentScreen() {
useEffect(() => {
Dea.pause().catch(() => {});
return () => {
Dea.resume().catch(() => {});
};
}, []);
return (
<View>
<TextInput placeholder="Card number" keyboardType="number-pad" />
<TextInput placeholder="CVC" secureTextEntry />
</View>
);
}
画面にフォーカスがある間一時停止する(React Navigation)¶
ナビゲーターを使うと、別の画面が上にプッシュされても元の画面はマウントされたままです。代わりにフォーカス時に 一時停止します。
import {useCallback} from 'react';
import {useFocusEffect} from '@react-navigation/native';
import * as Dea from '@dea/react-native';
export function usePauseDea() {
useFocusEffect(
useCallback(() => {
Dea.pause().catch(() => {});
return () => {
Dea.resume().catch(() => {});
};
}, []),
);
}
パスワードフィールドにフォーカスがある間一時停止する¶
import {TextInput} from 'react-native';
import * as Dea from '@dea/react-native';
export function PasswordField() {
return (
<TextInput
placeholder="Password"
secureTextEntry
onFocus={() => Dea.pause().catch(() => {})}
onBlur={() => Dea.resume().catch(() => {})}
/>
);
}
API¶
| メンバー | 戻り値 | 説明 |
|---|---|---|
pause() |
Promise<void> |
記録を停止する。セッションは保持される |
resume() |
Promise<void> |
記録を再開する |