Zabezpieczone potwierdzenie w Androidzie

Aby pomóc Ci potwierdzać intencje użytkowników podczas inicjowania poufnych transakcji, takich jak dokonywanie płatności, obsługiwane urządzenia z Androidem 9 (API na poziomie 28) lub nowszym umożliwiają korzystanie z zabezpieczonego potwierdzenia w Androidzie. W tym procesie aplikacja wyświetla użytkownikowi prośbę o zatwierdzenie krótkiego oświadczenia, które potwierdza jego zamiar dokonania transakcji wymagającej większej ostrożności.

Jeśli użytkownik zaakceptuje oświadczenie, aplikacja może użyć klucza z Android Keystore do podpisania wiadomości wyświetlanej w oknie. Podpis z bardzo wysokim poziomem ufności wskazuje, że użytkownik zapoznał się z oświadczeniem i wyraził na nie zgodę.

Aby w aplikacji obsługiwać potwierdzenie użytkownika o wysokim poziomie bezpieczeństwa, wykonaj te czynności:

1. Wygeneruj asymetryczny klucz podpisywania za pomocą klasy KeyGenParameterSpec.Builder. Podczas tworzenia klucza przekaż true do setUserConfirmationRequired(). Zadzwoń też pod numer setAttestationChallenge(), przekazując odpowiednią wartość weryfikacyjną podaną przez podmiot polegający na tożsamości.

2. Zarejestruj nowo wygenerowany klucz i jego certyfikat poświadczenia u odpowiedniej strony ufającej.

3. Wyślij szczegóły transakcji na serwer, aby wygenerował i zwrócił binarny duży obiekt (BLOB) dodatkowych danych. Dodatkowe dane mogą obejmować dane do potwierdzenia lub wskazówki dotyczące analizowania, np. ustawienia regionalne ciągu promptu.

   Aby zwiększyć bezpieczeństwo, obiekt BLOB musi zawierać kryptograficzny numer jednorazowy, który chroni przed atakami typu replay i umożliwia rozróżnianie transakcji.

4. Skonfiguruj obiekt ConfirmationCallback informujący aplikację o tym, że użytkownik zaakceptował prośbę wyświetlaną w oknie potwierdzenia:

   Kotlin

   class MyConfirmationCallback : ConfirmationCallback() {
   
         override fun onConfirmed(dataThatWasConfirmed: ByteArray?) {
             super.onConfirmed(dataThatWasConfirmed)
             // Sign dataThatWasConfirmed using your generated signing key.
             // By completing this process, you generate a signed statement.
         }
   
         override fun onDismissed() {
             super.onDismissed()
             // Handle case where user declined the prompt in the
             // confirmation dialog.
         }
   
         override fun onCanceled() {
             super.onCanceled()
             // Handle case where your app closed the dialog before the user
             // responded to the prompt.
         }
   
         override fun onError(e: Exception?) {
             super.onError(e)
             // Handle the exception that the callback captured.
         }
     }

   Java

   public class MyConfirmationCallback extends ConfirmationCallback {
   
     @Override
     public void onConfirmed(@NonNull byte[] dataThatWasConfirmed) {
         super.onConfirmed(dataThatWasConfirmed);
         // Sign dataThatWasConfirmed using your generated signing key.
         // By completing this process, you generate a signed statement.
     }
   
     @Override
     public void onDismissed() {
         super.onDismissed();
         // Handle case where user declined the prompt in the
         // confirmation dialog.
     }
   
     @Override
     public void onCanceled() {
         super.onCanceled();
         // Handle case where your app closed the dialog before the user
         // responded to the prompt.
     }
   
     @Override
     public void onError(Throwable e) {
         super.onError(e);
         // Handle the exception that the callback captured.
     }
   }

   Jeśli użytkownik zatwierdzi okno, zostanie wywołane wywołanie zwrotne onConfirmed(). dataThatWasConfirmed BLOB to struktura danych CBOR, która zawiera m.in. tekst promptu wyświetlany użytkownikowi oraz dodatkowe dane przekazane do konstruktora ConfirmationPrompt. Użyj utworzonego wcześniej klucza do podpisania dataThatWasConfirmed BLOB, a następnie przekaż ten BLOB wraz z podpisem i szczegółami transakcji z powrotem do podmiotu polegającego na tożsamości.

   Aby w pełni wykorzystać gwarancję bezpieczeństwa, jaką zapewnia funkcja Protected Confirmation na Androidzie, po otrzymaniu podpisanego komunikatu strona ufająca musi wykonać te czynności:

   1. Sprawdź podpis wiadomości oraz łańcuch certyfikatów poświadczających klucza podpisywania.
   2. Sprawdź, czy certyfikat atestu ma ustawioną flagę TRUSTED_CONFIRMATION_REQUIRED, która wskazuje, że klucz podpisywania wymaga potwierdzenia przez zaufanego użytkownika. Jeśli klucz podpisu jest kluczem RSA, sprawdź, czy nie ma właściwości PURPOSE_ENCRYPT ani PURPOSE_DECRYPT.
   3. Sprawdź, czy extraData potwierdza, że ten komunikat dotyczy nowego żądania i nie został jeszcze przetworzony. Ten krok chroni przed atakami typu replay.
   4. Przeanalizuj promptText, aby uzyskać informacje o potwierdzonym działaniu lub żądaniu. Pamiętaj, że promptText to jedyna część wiadomości, którą użytkownik potwierdził. Strona ufająca nigdy nie może zakładać, że dane do potwierdzenia zawarte w extraData odpowiadają promptText.

5. Dodaj logikę podobną do tej, która jest pokazana w tym fragmencie kodu, aby wyświetlić okno:

   Kotlin

   // This data structure varies by app type. This is an example.
     data class ConfirmationPromptData(val sender: String,
             val receiver: String, val amount: String)
   
     val myExtraData: ByteArray = byteArrayOf()
     val myDialogData = ConfirmationPromptData("Ashlyn", "Jordan", "$500")
     val threadReceivingCallback = Executor { runnable -> runnable.run() }
     val callback = MyConfirmationCallback()
   
     val dialog = ConfirmationPrompt.Builder(context)
             .setPromptText("${myDialogData.sender}, send
                             ${myDialogData.amount} to
                             ${myDialogData.receiver}?")
             .setExtraData(myExtraData)
             .build()
     dialog.presentPrompt(threadReceivingCallback, callback)

   Java

     // This data structure varies by app type. This is an example.
     class ConfirmationPromptData {
         String sender, receiver, amount;
         ConfirmationPromptData(String sender, String receiver, String amount) {
             this.sender = sender;
             this.receiver = receiver;
             this.amount = amount;
         }
     };
     final int MY_EXTRA_DATA_LENGTH = 100;
     byte[] myExtraData = new byte[MY_EXTRA_DATA_LENGTH];
     ConfirmationPromptData myDialogData = new ConfirmationPromptData("Ashlyn", "Jordan", "$500");
     Executor threadReceivingCallback = Runnable::run;
     MyConfirmationCallback callback = new MyConfirmationCallback();
     ConfirmationPrompt dialog = (new ConfirmationPrompt.Builder(getApplicationContext()))
             .setPromptText("${myDialogData.sender}, send ${myDialogData.amount} to ${myDialogData.receiver}?")
             .setExtraData(myExtraData)
             .build();
     dialog.presentPrompt(threadReceivingCallback, callback);

Dodatkowe materiały

Więcej informacji o potwierdzeniu chronionym na Androidzie znajdziesz w tych materiałach.

Blogi

• Zabezpieczone potwierdzenie w Androidzie: podnoszenie bezpieczeństwa transakcji na wyższy poziom