Ta strona została przetłumaczona przez Cloud Translation API.

Sprawdzaj pary kluczy wspieranych sprzętowo za pomocą atestu kluczy

Potwierdzenie klucza zwiększa pewność, że klucze używane w aplikacji są przechowywane w sprzętowym magazynie kluczy urządzenia. W tych sekcjach opisano, jak weryfikować właściwości kluczy opartych na sprzęcie oraz interpretować dane rozszerzeń certyfikatów poświadczenia.

Uwaga: zanim sprawdzisz właściwości kluczy wspieranych sprzętowo urządzenia w środowisku produkcyjnym, upewnij się, że urządzenie obsługuje atestację kluczy na poziomie sprzętowym. W tym celu sprawdź, czy łańcuch certyfikatu atesta zawiera certyfikat główny, który jest podpisany kluczem głównym atesta Google, oraz czy element attestationSecurityLevel w strukturze danych opis klucza ma ustawiony poziom zabezpieczeń TrustedEnvironment lub StrongBox.

Ponadto ważne jest, aby zweryfikować podpisy w łańcuchu certyfikatów i sprawdzić, czy żaden z kluczy w łańcuchu nie został cofnięty. Aby to zrobić, skorzystaj z listy stanu cofnięcia certyfikatu. Jeśli nie wszystkie są prawidłowe i root to klucz główny Google, nie należy w pełni ufać uwierzytelnieniu. Pamiętaj jednak, że urządzenia z wycofanymi certyfikatami są równie godne zaufania co urządzenia, które obsługują tylko uwierzytelnianie oprogramowania. Posiadanie w pełni ważnego atestu to wyraźny pozytywny wskaźnik. Brak takiego dokumentu jest neutralnym, a nie negatywnym wskaźnikiem.

Pobieranie i weryfikowanie pary kluczy obsługiwanych sprzętowo

Podczas atestacji klucza podajesz alias pary kluczy i pobierasz jej łańcuch certyfikatów, którego możesz użyć do weryfikacji właściwości tej pary kluczy.

Jeśli urządzenie obsługuje uwierzytelnianie klucza na poziomie sprzętu, certyfikat główny w tym łańcuchu jest podpisany za pomocą klucza głównego uwierzytelniania, który jest bezpiecznie udostępniany w sprzętowym magazynie kluczy urządzenia.

Uwaga: na urządzeniach z weryfikacją klucza na poziomie sprzętu, Androidem 7.0 (poziom interfejsu API 24) lub nowszym oraz Usługami Google Play certyfikat główny jest podpisany kluczem głównym weryfikacji Google. Sprawdź, czy ten certyfikat główny znajduje się na liście w sekcji dotyczącej certyfikatów głównych.

Aby wdrożyć weryfikację kluczy, wykonaj te czynności:

Użyj metody getCertificateChain() obiektu KeyStore, aby uzyskać odwołanie do łańcucha certyfikatów X.509 powiązanych ze sprzętowym magazynem kluczy.
Prześlij certyfikaty na oddzielny serwer, któremu ufasz, w celu ich zweryfikowania.

Uwaga: nie wykonuj tej procedury weryfikacji na tym samym urządzeniu, na którym działa magazyn kluczy. Jeśli system Android na tym urządzeniu został przejęty, proces weryfikacji może zaufać niewiarygodnemu elementowi.
Uzyskaj odwołanie do biblioteki parsowania i weryfikacji łańcucha certyfikatów X.509, która jest najbardziej odpowiednia dla Twojego zestawu narzędzi. Sprawdź, czy certyfikat publiczny wierzchołka jest wiarygodny i czy każdy certyfikat podpisuje następny certyfikat w łańcuchu.
Sprawdź stan unieważnienia każdego certyfikatu, aby upewnić się, że żaden z nich nie został unieważniony.
Opcjonalnie sprawdź rozszerzenie certyfikatu informacji o zarządzaniu, które występuje tylko w nowszych łańcuchach certyfikatów.

Uzyskaj odwołanie do biblioteki parsowania CBOR, która jest najbardziej odpowiednia dla Twojego zestawu narzędzi. Znajdź najbliższy certyfikat główny, który zawiera informacje o wdrożeniu rozszerzenia certyfikatu. Użyj parsera, aby wyodrębnić z tego certyfikatu dane rozszerzenia certyfikatu informacji.

Więcej informacji znajdziesz w sekcji na temat schematu danych rozszerzenia informacji o obsłudze administracyjnej.
Uzyskaj odwołanie do biblioteki parsowania ASN.1, która jest najbardziej odpowiednia dla Twojego zestawu narzędzi. Znajdź najbliższy certyfikat główny, który zawiera rozszerzenie certyfikatu atesta klucza. Jeśli rozszerzenie certyfikatu z informacjami o obsługi administracyjnej było obecne, rozszerzenie certyfikatu poświadczenia klucza musi znajdować się w następnym certyfikacie. Użyj parsowania, aby wyodrębnić z tego certyfikatu dane rozszerzenia certyfikatu atesta.

Uwaga: nie zakładaj, że rozszerzenie certyfikatu atestu klucza znajduje się w certyfikacie liścia łańcucha. Tylko pierwsze wystąpienie rozszerzenia w łańcuchu może być wiarygodne. Wszystkie kolejne instancje rozszerzenia nie zostały wydane przez bezpieczny sprzęt i mogą być wydane przez atakującego, który rozszerzył łańcuch, próbując utworzyć fałszywe oświadczenia dla niezaufanych kluczy.

Plik z atestem klucza używa parsowania ASN.1 z Bouncy Castle do wyodrębniania danych rozszerzenia certyfikatu atesta. Możesz użyć tego przykładu jako punktu odniesienia do utworzenia własnego parsowania.

Więcej informacji znajdziesz w sekcji dotyczącej schematu danych rozszerzenia atestu kluczy.
Sprawdź spójność danych rozszerzenia uzyskanych w poprzednich krokach i porównaj je z zestawem wartości, które powinien zawierać klucz oparty na sprzęcie.

Certyfikaty główne

Zaufanie do zaświadczeń zależy od głównego certyfikatu łańcucha. Urządzenia z Androidem, które przeszły testy wymagane do obsługi pakietu aplikacji Google, w tym Google Play, i które zostały uruchomione z Androidem 7.0 (poziom interfejsu API 24) lub nowszym, powinny używać kluczy uwierzytelniania podpisanych certyfikatem ROOT Google Hardware Attestation. Pamiętaj, że atest nie był wymagany do wersji Androida 8.0 (poziom interfejsu API 26). Klucz publiczny głównego węzła ma postać:

Wydane wcześniej certyfikaty główne

Jeśli otrzymany certyfikat główny w łańcuchu potwierdzenia zawiera ten klucz publiczny i żaden z certyfikatów w łańcuchu nie został cofnięty, pamiętaj, że:

Klucz znajduje się w sprzęcie, który według Google jest bezpieczny.
Ma właściwości opisane w certyfikacie.

Jeśli łańcuch uwierzytelniania zawiera inny klucz publiczny głównego wierzchołka, Google nie składa żadnych oświadczeń dotyczących bezpieczeństwa sprzętu. Nie oznacza to, że klucz został przejęty, a jedynie, że atest nie dowodzi, że klucz jest przechowywany w bezpiecznym sprzęcie. Dostosuj odpowiednio założenia dotyczące zabezpieczeń.

Jeśli certyfikat główny nie zawiera klucza publicznego na tej stronie, może to być spowodowane 2 przyczynami:

Najprawdopodobniej urządzenie zostało uruchomione z wersją Androida niższą niż 7.0 i nie obsługuje weryfikacji za pomocą sprzętu. W tym przypadku Android ma implementację oprogramowania do przeprowadzania atesta, która generuje ten sam rodzaj certyfikatu, ale podpisany kluczem zakodowanym na stałe w źródle Androida. Ponieważ ten klucz podpisywania nie jest tajny, atest mógł zostać utworzony przez osobę przeprowadzającą atak, która podszywa się pod bezpieczny sprzęt.
Innym prawdopodobnym powodem jest to, że urządzenie nie jest urządzeniem Google Play. W takim przypadku producent urządzenia może utworzyć własny rdzeń i stwierdzić, cokolwiek chce, na temat tego, co oznacza weryfikacja. Zapoznaj się z dokumentacją producenta urządzenia. Pamiętaj, że Google nie wie o żadnym takim przypadku.

Lista stanów odwołania certyfikatów

Klucze uwierzytelniające mogą zostać cofnięte z różnych powodów, m.in. z powodu niewłaściwego ich użycia lub podejrzenia o wydobycie przez atakującego. Dlatego bardzo ważne jest, aby sprawdzać stan każdego certyfikatu w łańcuchu atestów względem oficjalnej listy stanów odwołanych certyfikatów (CRL). Ta lista jest utrzymywana przez Google i publikowana pod adresem: https://android.googleapis.com/attestation/status. Nagłówek Cache-Control w odpowiedzi HTTP określa, jak często sprawdzać dostępność aktualizacji, aby nie wymagać wysyłania żądania sieciowego w przypadku każdego weryfikowanego certyfikatu. Ten adres URL zwraca plik JSON zawierający stan unieważnienia wszystkich certyfikatów, które nie mają normalnego stanu ważności. Format pliku JSON musi być zgodny z definicją schematu JSON (wersja 07):

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "entries": {
      "description" : "Each entry represents the status of an attestation key. The dictionary-key is the certificate serial number in lowercase hex.",
      "type": "object",
      "propertyNames": {
        "pattern": "^[a-f1-9][a-f0-9]*$"
      },
      "additionalProperties": {
        "type": "object",
        "properties": {
          "status": {
            "description": "[REQUIRED] Current status of the key.",
            "type": "string",
            "enum": ["REVOKED", "SUSPENDED"]
          },
          "expires": {
            "description": "[OPTIONAL] UTC date when certificate expires in ISO8601 format (YYYY-MM-DD). Can be used to clear expired certificates from the status list.",
            "type": "string",
            "format": "date"
          },
          "reason": {
            "description": "[OPTIONAL] Reason for the current status.",
            "type": "string",
            "enum": ["UNSPECIFIED", "KEY_COMPROMISE", "CA_COMPROMISE", "SUPERSEDED", "SOFTWARE_FLAW"]
          },
          "comment": {
            "description": "[OPTIONAL] Free form comment about the key status.",
            "type": "string",
            "maxLength": 140
          }
        },
        "required": ["status"],
        "additionalProperties": false
      }
    }
  },
  "required": ["entries"],
  "additionalProperties": false
}

Przykładowy plik CRL:

{
  "entries": {
    "2c8cdddfd5e03bfc": {
      "status": "REVOKED",
      "expires": "2020-11-13",
      "reason": "KEY_COMPROMISE",
      "comment": "Key stored on unsecure system"
    },
    "c8966fcb2fbb0d7a": {
      "status": "SUSPENDED",
      "reason": "SOFTWARE_FLAW",
      "comment": "Bug in keystore causes this key malfunction b/555555"
    }
  }
}

Schemat danych rozszerzenia atestacji klucza

Schemat danych rozszerzenia informacji o obsłudze administracyjnej

Rozszerzenie informacji o obsłudze administracyjnej ma identyfikator OID 1.3.6.1.4.1.11129.2.1.30. Rozszerzenie zawiera informacje o urządzeniu znane serwerowi do obsługi administracyjnej. To rozszerzenie jest zgodne ze schematem CDDL.

  {
        1 : int,   ; certificates issued
  }

Mapa nie jest wersjonowana i można dodawać do niej nowe pola opcjonalne.

certs_issued: Przybliżona liczba certyfikatów wystawionych na urządzeniu w ciągu ostatnich 30 dni. Ta wartość może być używana jako sygnał do potencjalnych naruszeń, jeśli wartość jest większa od średniej o pewnych rzędach wielkości.