ConfirmationPrompt クラス

定義

[Android.Runtime.Register("android/security/ConfirmationPrompt", ApiSince=28, DoNotGenerateAcw=true)]
public class ConfirmationPrompt : Java.Lang.Object

[<Android.Runtime.Register("android/security/ConfirmationPrompt", ApiSince=28, DoNotGenerateAcw=true)>]
type ConfirmationPrompt = class
    inherit Object

継承

Object

JavaObject

Object

ConfirmationPrompt

属性

RegisterAttribute

注釈

確認プロンプトを表示するために使用されるクラス。

確認プロンプトは、特定のテキストを確認するためにユーザーに表示されるプロンプトであり、Android フレームワーク (カーネルを含む) が侵害された場合でも、ユーザーが特定のテキストを見たことを高い信頼で肯定的な応答が示す方法で実装されます。 これらの保証を使用して確認プロンプトを実装するには、専用のハードウェア サポートが必要であり、常に使用できるわけではありません。

確認プロンプトは、通常、外部エンティティ ( 証明書利用者 ) と共に次のように使用されます。 セットアップ手順は次のとおりです。 <ul><li> 最初に使用する前に、アプリケーションは android.security.keystore.KeyGenParameterSpec.Builder#setUserConfirmationRequired CONFIRMATION tag が設定されたキーペアを生成します。 AndroidKeyStore キーの構成証明 (たとえば、 android.security.keystore.KeyGenParameterSpec.Builder#setAttestationChallenge(byte[]) ) は、新しく生成されたキーの公開キー (次のKpub ) を含む証明書チェーンを生成するために使用されます。 <li> アプリケーションは Kpub と、デバイスの構成証明に起因する証明書チェーン を証明書利用者に送信します。 <li>証明書利用者は、ルート証明書の確認 (Google からの証明書など) を含む証明書チェーンを検証し、各証明書はチェーン内の次の証明書に署名し、Kpubで終わり、Kpubandroid.security.keystore.KeyGenParameterSpec.Builder#setUserConfirmationRequired CONFIRMATION tagが設定されていることを証明証明書がアサートします。 さらに、証明書利用者は Kpub を格納し、それを受信したデバイスに関連付けます。 </ul>

証明書利用者は通常、外部デバイス (たとえば、Bluetooth経由で接続) またはアプリケーション サーバーです。

ユーザー コンテンツの高い保証を必要とするトランザクションを実行する前に、アプリケーションは次の処理を行います: <ul><li> アプリケーションは 証明書利用者 から暗号化 nonce を取得し、これを (Builder ヘルパー クラスを介して) extraData として #presentPrompt presentPrompt() メソッドに渡します。 証明書利用者は、後の手順で使用するため、nonce をローカルに格納します。 <li>ユーザーがプロンプトを承認すると、コールバックでConfirmationCallback#onConfirmed onConfirmed(byte[])パラメーターとしてdataThatWasConfirmedが返されます。 この BLOB には、ユーザーに表示されたテキスト、 extraData パラメーター、および場合によっては他のデータが含まれます。 <li> アプリケーションは、前に作成したキーを使用して 確認応答 に署名し、BLOB と署名 を証明書利用者に送信します。 <li>証明書利用者は、署名がKpubで作成されたことを確認し、promptTextが想定されているものと一致し、extraData以前に作成された nonce と一致することを抽出します。 すべてのチェックに合格すると、トランザクションが実行されます。 </ul>

注: これはユーザーが承認した唯一の部分であるため、 promptText を確認することが重要です。 考えられるすべてのロケールに対してパーサーを記述しないようにするには、 証明書利用者 がデバイスで使用されているのと同じ文字列ジェネレーターを使用し、単純な文字列比較を実行することをお勧めします。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。