コンテンツにスキップ

機密性の高い画面

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

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

SDK はキーイベントやテキストを読み取らず、システムキーボード上のタッチも取得しません。キーボードはアプリの ウィンドウではないためです。アプリ自身が描画する PIN パッドやキーボード上のタッチは取得されるので、そうした 画面では一時停止してください。アプリが captureKey でキーの押下を報告 している場合、パスワードフィールドでは決して報告しないでください。

使いどころ

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

前提条件

使い方

一時停止と再開

import ai.dea.sdk.DeaSdk

DeaSdk.instance?.pause()
// … sensitive screen …
DeaSdk.instance?.resume()
  • pause() には必ず resume() を対にしてください。一時停止中の時間は アクションを増やさないため、一時停止のまま放置されたセッションは 決して十分にならず、分類は INSUFFICIENT のままです。
  • resume() は同意を上書きしません。ユーザーが同意していなければ、再開後も何も記録されません。
  • どちらもメインスレッドで呼び出してください。

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

例

アクティビティがフォアグラウンドにある間、一時停止する

import ai.dea.sdk.DeaSdk
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity

class PaymentActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_payment)
    }

    override fun onResume() {
        super.onResume()
        DeaSdk.instance?.pause()
    }

    override fun onPause() {
        DeaSdk.instance?.resume()
        super.onPause()
    }
}

フラグメントのビューが存在する間、一時停止する

import ai.dea.sdk.DeaSdk
import android.os.Bundle
import android.view.View
import androidx.fragment.app.Fragment

class PinFragment : Fragment(R.layout.fragment_pin) {
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        DeaSdk.instance?.pause()
    }

    override fun onDestroyView() {
        DeaSdk.instance?.resume()
        super.onDestroyView()
    }
}

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

import ai.dea.sdk.DeaSdk
import android.widget.EditText

fun EditText.pauseDeaWhileFocused() {
    setOnFocusChangeListener { _, hasFocus ->
        if (hasFocus) DeaSdk.instance?.pause() else DeaSdk.instance?.resume()
    }
}

// In your activity or fragment:
// findViewById<EditText>(R.id.password).pauseDeaWhileFocused()

フィールドにフォーカスが残ったまま画面が閉じる可能性がある場合は、画面が閉じるときにも resume() を 呼び出してください。

API

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