Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Vérifier les paires de clés intégrées au matériel avec l'attestation des clés

L'attestation des clés vous permet de vous assurer que les clés que vous utilisez dans votre application sont stockées dans le keystore intégré au matériel d'un appareil. Les sections suivantes décrivent comment valider les propriétés des clés intégrées au matériel et interpréter les données d'extension des certificats d'attestation.

Avant de commencer, assurez-vous que votre appareil prend en charge l'attestation des clés au niveau du matériel.

Avant de valider les propriétés des clés intégrées au matériel d'un appareil dans un environnement de production, assurez-vous que l'appareil prend en charge l'attestation des clés au niveau du matériel. Pour ce faire, vérifiez que la chaîne de certificats d'attestation contient un certificat racine signé avec la clé racine d'attestation Google et que l'élément attestationSecurityLevel, qui figure dans la structure de données de description de la clé, est défini sur le niveau de sécurité TrustedEnvironment ou StrongBox.

En outre, il est important de vérifier les signatures de la chaîne de certificats et de vous assurer qu'aucune des clés de la chaîne n'a été révoquée en consultant la liste des états de révocation des certificats. Ne faites entièrement confiance à l'attestation que si toutes sont valides et que la racine est la clé racine Google.

Récupérer et valider une paire de clés intégrée au matériel

Lors de l'attestation des clés, vous spécifiez l'alias d'une paire de clés et récupérez sa chaîne de certificats, que vous pouvez utiliser pour valider les propriétés de cette paire.

Si l'appareil prend en charge l'attestation des clés au niveau du matériel, le certificat racine de cette chaîne est signé à l'aide d'une clé racine d'attestation provisionnée de manière sécurisée sur le keystore intégré au matériel de l'appareil.

Pour implémenter l'attestation des clés, procédez comme suit :

Utilisez la méthode getCertificateChain() d'un objet KeyStore pour obtenir une référence à la chaîne de certificats X.509 associés au keystore intégré au matériel.
Envoyez les certificats à un serveur distinct de confiance pour la validation.

Attention : N'effectuez pas le processus de validation suivant sur le même appareil. Si le système Android de cet appareil est compromis, le processus de validation pourrait faire confiance à un élément non fiable.
Obtenez une référence à la bibliothèque d'analyse et de validation de la chaîne de certificats X.509 la plus adaptée à votre ensemble d'outils. Vérifiez que le certificat public racine est fiable et que chaque certificat signe le certificat suivant de la chaîne.
Vérifiez l'état de révocation de chaque certificat pour vous assurer qu'aucun des certificats n'a été révoqué.
Si vous le souhaitez, inspectez l'extension de certificat d'informations de provisionnement qui n'est présente que dans les chaînes de certificats les plus récentes.

Obtenez une référence à la bibliothèque d'analyseur CBOR la plus adaptée à votre ensemble d'outils. Recherchez le certificat le plus proche de la racine qui contient l'extension de certificat d'informations de provisionnement. Utilisez l'analyseur pour extraire de ce certificat les données de l'extension de certificat d'informations de provisionnement.

Pour en savoir plus, consultez la section sur l'extension d'informations de provisionnement.
Obtenez une référence à la bibliothèque d'analyseur ASN.1 la plus adaptée à votre ensemble d'outils. Recherchez le certificat le plus proche de la racine qui contient l'extension de certificat d'attestation des clés. Si l'extension de certificat d'informations de provisionnement était présente, l'extension de certificat d'attestation des clés doit figurer dans le certificat suivant. Utilisez l'analyseur pour extraire de ce certificat les données de l'extension de certificat d'attestation des clés.

Attention : Ne partez pas du principe que l'extension de certificat d'attestation des clés se trouve dans le certificat d'entité finale de la chaîne. Seule la première occurrence de l'extension de la chaîne peut être fiable. Toutes les autres instances de l'extension n'ont pas été émises par le matériel sécurisé. Elles pourraient avoir été émises par un pirate informatique qui étend la chaîne en tentant de créer de fausses attestations pour des clés qui ne sont pas fiables.

L'exemple d'attestation des clés utilise l'analyseur ASN.1 de Bouncy Castle pour extraire les données d'extension d'un certificat d'attestation. Vous pouvez utiliser cet exemple comme référence pour créer votre propre analyseur.

Pour en savoir plus, consultez la section sur le schéma de données de l'extension d'attestation des clés.
Vérifiez la cohérence des données d'extension que vous avez récupérées aux étapes précédentes et comparez-les à l'ensemble des valeurs que la clé intégrée au matériel devrait contenir.

Certificats racines

La fiabilité de l'attestation dépend du certificat racine de la chaîne. Les appareils Android ayant réussi les tests requis pour disposer de la suite d'applications Google, y compris Google Play, et lancés avec Android 7.0 (niveau d'API 24) ou version ultérieure doivent utiliser des clés d'attestation signées par le certificat racine d'attestation du matériel Google. Notez que l'attestation n'était pas requise avant Android 8.0 (niveau d'API 26). L'ensemble des certificats racine valides peut être téléchargé sous forme de tableau au format JSON.

Certificats racine

Les deux certificats racine suivants doivent être utilisés comme ancres de confiance lors de la validation d'une chaîne de certificats d'attestation de clé.

Certificats racine précédemment émis

Si le certificat racine de la chaîne d'attestation que vous recevez contient cette clé publique et qu'aucun des certificats de la chaîne n'a été révoqué, alors vous savez que :

Votre clé se trouve dans du matériel qui, selon Google, est sécurisé.
Il possède les propriétés décrites dans le certificat d'attestation.

Si la chaîne d'attestation comporte une autre clé publique racine, alors Google ne revendique pas la sécurité du matériel. Cela ne signifie pas que la sécurité de votre clé est compromise, mais que l'attestation ne prouve pas qu'elle se trouve dans du matériel sécurisé. Ajustez vos hypothèses de sécurité en conséquence.

Si le certificat racine ne contient pas la clé publique sur cette page, deux raisons sont probables :

L'appareil a probablement été lancé avec une version d'Android antérieure à 7.0 et ne prend donc pas en charge l'attestation du matériel. Dans ce cas, Android dispose d'une implémentation logicielle d'attestation qui produit le même type de certificat d'attestation, mais qui est signée avec une clé codée en dur dans le code source Android. Comme cette clé de signature n'est pas secrète, il est possible que l'attestation ait été créée par un pirate informatique qui prétend fournir du matériel sécurisé.
L'autre raison probable est que l'appareil n'est pas un appareil Google Play. Dans ce cas, le fabricant de l'appareil est libre de créer son propre certificat racine et de définir la signification de ses données d'attestation. Consultez la documentation du fabricant de l'appareil. Notez que Google n'a connaissance d'aucun fabricant d'appareils ayant utilisé cette méthode.

Rotation du certificat racine d'attestation du matériel

Google lance un nouveau certificat racine pour l'attestation des clés Android. Ce changement renforce la sécurité et la fiabilité du processus d'attestation pour les applications sensibles. Une nouvelle clé racine a été générée pour l'attestation des clés Android (KeyMint). La nouvelle racine est une clé ECDSA P-384.

Que devez-vous faire ?

Si votre application repose sur l'attestation des clés Android, ajoutez le nouveau certificat racine à vos magasins de confiance d'ici le 31 mars 2026. Téléchargez les anciens et les nouveaux certificats depuis https://android.googleapis.com/attestation/root.
Les appareils qui utilisent le provisionnement de clé à distance (RKP) commenceront à recevoir des certificats ancrés dans ce nouveau certificat en février 2026. Les appareils compatibles avec RKP utiliseront exclusivement la nouvelle racine d'ici le 10 avril 2026.
Mettez à jour vos processus d'attestation pour faire confiance aux certificats racine à la fois nouveaux et existants. Les anciens appareils avec des clés provisionnées en usine ne sont pas compatibles avec la rotation des clés et continuent d'utiliser l'ancienne racine.
Le schéma d'extension de certificat lui-même restera inchangé. Seule la racine sera modifiée.
Les formes lisibles par l'humain et par machine de la nouvelle racine seront disponibles publiquement.

Bonnes pratiques

N'interrogez pas un point de terminaison au sujet des racines de confiance au moment de l'exécution, car cette action crée des risques de sécurité. Gérez les modifications apportées aux racines de confiance à l'aide d'une procédure formelle.

Suppression progressive des clés d'usine : provisionnement de clés à distance (RKP)

Pour les appareils lancés avec Android 16, le système n'est compatible qu'avec le provisionnement RKP. Cette règle supprime progressivement les clés d'usine. Elle améliore la façon dont vous provisionnez et gérez les clés d'attestation, en s'appuyant sur la règle Android 15 où la prise en charge du RKP était facultative. Le provisionnement RKP empêche la fuite de clés, car le système ne programme pas les clés directement sur l'appareil. Vous ne pouvez pas supprimer ces clés de l'appareil. Si vous devez révoquer une clé, vous pouvez cibler la révocation sur un seul appareil.

Bibliothèques de validation des attestations

Utilisez la bibliothèque Kotlin de validation des attestations pour valider les chaînes de certificats d'attestation de clé. De plus, cette bibliothèque intègre déjà les nouveaux certificats racine. Si vous utilisez un autre outil de validation, nous vous recommandons de passer à la bibliothèque Kotlin. Elle est bien testée et couvre les cas extrêmes qui sont souvent manqués par les validateurs personnalisés.

Liste des états de révocation des certificats

Les clés d'attestation peuvent être révoquées pour plusieurs raisons, par exemple en cas de mauvaise gestion ou de suspicion d'extraction par un pirate informatique. Par conséquent, il est essentiel que l'état de chaque certificat d'une chaîne d'attestation soit validé par rapport à la liste officielle des états de révocation des certificats (LRC). Cette liste est gérée par Google et publiée à l'adresse suivante : https://android.googleapis.com/attestation/status. L'en-tête Cache-Control de la réponse HTTP détermine la fréquence de recherche des mises à jour afin qu'une requête réseau ne soit pas requise pour chaque certificat en cours de validation. Cette URL renvoie un fichier JSON contenant l'état de révocation des certificats dont l'état n'est pas valide. Le format du fichier JSON respecte la définition de schéma JSON suivante (brouillon 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
}

Exemple de LRC :

{
  "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"
    }
  }
}

Règle de révocation des certificats

L'attestation est le pilier de la lutte contre les utilisations abusives et de la confiance dans l'écosystème Android. Elle fournit une instruction vérifiable de manière chiffrée aux parties hors de l'appareil concernant l'état de démarrage de l'appareil.

Les certificats des clés d'attestation Android seront révoqués lorsque les clés seront compromises, car la validité de l'attestation est essentielle par nature. Cette section décrit une règle à appliquer lorsque des certificats sont révoqués. Cette règle est susceptible d'évoluer et de prendre en compte des cas de révocation supplémentaires avec le temps.

Quels sont les cas de révocation ?

Les clés d'attestation qui ont été divulguées peuvent toujours voir leurs certificats révoqués. Les divulgations peuvent être découvertes de différentes manières :

Analyse des données d'attestation en conditions réelles
Découverte de clés d'attestation sur les réseaux sociaux ou d'autres sites publics
Rapports provenant directement de chercheurs en sécurité

Une fois les certificats d'attestation découverts, ils seront révoqués : leur numéro de série est ajouté à la liste de révocation. Cela se produit généralement dans les jours qui suivent la découverte, mais peut prendre plus de temps dans de rares cas. Par exemple, la révocation des certificats pour les clés d'attestation divulguées est généralement retardée si les appareils concernés par la révocation peuvent être reprovisionnés de manière sécurisée. L'ampleur de l'impact de la révocation est également un facteur important pour les délais de révocation.

Vérifier les paires de clés intégrées au matériel avec l'attestation des clés

Avant de commencer, assurez-vous que votre appareil prend en charge l'attestation des clés au niveau du matériel.

Récupérer et valider une paire de clés intégrée au matériel

Certificats racines

Rotation du certificat racine d'attestation du matériel

Que devez-vous faire ?

Bonnes pratiques

Suppression progressive des clés d'usine : provisionnement de clés à distance (RKP)

Bibliothèques de validation des attestations

Liste des états de révocation des certificats

Règle de révocation des certificats

Quels sont les cas de révocation ?

Schéma des données de l'extension d'attestation des clés

Schéma des données de l'extension d'informations de provisionnement

Vérifier les paires de clés intégrées au matériel avec l'attestation des clés Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer, assurez-vous que votre appareil prend en charge l'attestation des clés au niveau du matériel.

Récupérer et valider une paire de clés intégrée au matériel

Certificats racines

Rotation du certificat racine d'attestation du matériel

Que devez-vous faire ?

Bonnes pratiques

Suppression progressive des clés d'usine : provisionnement de clés à distance (RKP)

Bibliothèques de validation des attestations

Liste des états de révocation des certificats

Règle de révocation des certificats

Quels sont les cas de révocation ?

Schéma des données de l'extension d'attestation des clés

Schéma des données de l'extension d'informations de provisionnement

Vérifier les paires de clés intégrées au matériel avec l'attestation des clés