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

Verificación de pares de claves respaldados por hardware con certificación de claves

La certificación de claves te brinda la confianza de que las claves que usas en tu app se conservan en el almacén de claves respaldado por hardware del dispositivo. En las siguientes secciones se describe cómo verificar las propiedades de las claves guardadas en hardware e interpretar los datos de extensión de las certificaciones.

Antes de comenzar, asegúrate de que tu dispositivo admita la certificación de claves a nivel del hardware

Antes de verificar las propiedades de las claves guardadas en hardware de un dispositivo en un entorno de producción, debes asegurarte de que el dispositivo admita certificación de claves a nivel del hardware. Para ello, debes comprobar que la cadena de certificación contenga un certificado raíz firmado por la clave raíz de certificación de Google y que el elemento attestationSecurityLevel dentro de la estructura de datos de la descripción de la clave se configure a nivel de seguridad de TrustedEnvironment o a nivel de seguridad de StrongBox.

Además, es importante verificar las firmas en la cadena de certificados y comprobar que ninguna de las claves de esta se haya revocado. Para ello, debes revisar la Lista de estado de revocación de certificados. A menos que todas sean válidas y que la raíz sea la clave raíz de Google, no confíes completamente en la certificación.

Recuperación y verificación de un par de claves guardado en hardware

Durante la certificación de claves, se especifica el alias de un par de claves y se recupera su cadena de certificados, que puedes usar para verificar las propiedades de ese par de claves.

Si el dispositivo admite certificación de claves a nivel del hardware, el certificado raíz de esta cadena se firma con una clave raíz de certificación que se aprovisiona de forma segura en el almacén de claves respaldado por hardware del dispositivo.

Para implementar la certificación de claves, haz lo siguiente:

Usa el método getCertificateChain() de un objeto KeyStore para obtener una referencia a la cadena de certificados X.509 asociada con el almacén de claves guardadas en hardware.
Envía los certificados a otro servidor de confianza para la validación.

Precaución: No completes el siguiente proceso de validación en el mismo dispositivo. Si el sistema Android de ese dispositivo está comprometido, es posible que el proceso de validación confíe en algo que no es confiable.
Obtén la referencia a la biblioteca de validación y análisis de la cadena de certificados X.509 que sea más adecuada para tu conjunto de herramientas. Verifica que el certificado público raíz sea confiable y que cada certificado firme el siguiente de la cadena.
Comprueba el estado de revocación de cada certificado para asegurarte de que no se haya revocado ninguno.
De manera opcional, inspecciona la extensión del certificado de información de aprovisionamiento que solo está presente en las cadenas de certificados más nuevas.

Obtén la referencia a la biblioteca de analizadores CBOR que sea más adecuada para tu conjunto de herramientas. Encuentra el certificado más cercano a la raíz que contiene la extensión del certificado de información de aprovisionamiento. Usa el analizador para extraer los datos de extensión del certificado de información de aprovisionamiento de ese certificado.

Consulta la sección sobre la extensión de información de aprovisionamiento para obtener más detalles.
Obtén la referencia a la biblioteca de analizadores de ASN.1 que sea más adecuada para tu conjunto de herramientas. Encuentra el certificado más cercano a la raíz que contiene la extensión del certificado de certificación de claves. Si la extensión del certificado de información de aprovisionamiento estaba presente, la extensión del certificado de certificación de claves debe estar en el certificado inmediatamente posterior. Usa el analizador para extraer los datos de extensión del certificado de certificación de claves de ese certificado.

Precaución: No des por sentado que la extensión del certificado de certificación de claves se encuentra en el certificado de entidad final de la cadena. Solo se puede confiar en la primera instancia de extensión de la cadena. El hardware seguro no emitió otras instancias de la extensión, y es posible que las haya emitido un atacante que extendió la cadena mientras intentaba crear certificaciones falsas para claves que no son de confianza.

En el ejemplo de certificación de claves, se usa el analizador ASN.1 de Bouncy Castle para extraer los datos de extensión de la certificación. Puedes usar este ejemplo como referencia para crear tu propio analizador.

Consulta la sección sobre el esquema de datos de extensión de certificación de claves para obtener más información.
Verifica la coherencia de los datos de extensión que recuperaste en los pasos anteriores y compáralos con el conjunto de valores que esperas que contenga la clave guardada en hardware.

Certificados raíz

El nivel de confianza de la certificación depende del certificado raíz de la cadena. Los dispositivos Android que hayan pasado la prueba necesaria para tener el conjunto de apps de Google, incluido Google Play, y que se hayan lanzado con Android 7.0 (nivel de API 24) o versiones posteriores deberían usar las claves firmadas por el certificado raíz de certificación de Google. Ten en cuenta que no se requirió la certificación hasta Android 8.0 (nivel de API 26). El conjunto de certificados raíz válidos se puede descargar como un array con formato JSON.

Certificados raíz

Los siguientes dos certificados raíz se deben usar como anclajes de confianza cuando se verifica una cadena de certificados de certificación de claves.

Certificados raíz emitidos anteriormente

Si el certificado raíz en la cadena de certificación que recibes contiene esta clave pública y no se revocó ninguno de los certificados de la cadena, significa lo siguiente:

Tu clave se encuentra en un hardware que Google considera seguro.
Tiene las propiedades que se describen en la certificación.

Si la cadena de certificación tiene otro certificado raíz, Google no realiza reclamaciones de seguridad sobre el hardware. Esto no significa que la clave esté comprometida; solo que la certificación no prueba que la clave esté en hardware seguro. Ajusta tus suposiciones de seguridad según corresponda.

Si el certificado raíz no contiene la clave pública que aparece en esta página, es posible que se deba a uno de los siguientes motivos:

Lo más probable es que el dispositivo se haya lanzado con una versión de Android anterior a la 7.0 y que no admita la certificación de hardware. En este caso, Android tiene una implementación de software de certificación que produce el mismo tipo de certificado, pero que se firma con una clave codificada a través del código fuente de Android. Como esta clave de firma no es secreta, es posible que un atacante haya creado la certificación fingiendo proporcionar un hardware seguro.
El otro motivo probable es que el dispositivo no sea de Google Play. En ese caso, el fabricante del dispositivo puede crear su propio certificado raíz y definir el significado de sus datos de certificación. Consulta la documentación del fabricante del dispositivo. Ten en cuenta que Google no conoce fabricantes que hayan hecho esto.

Rotación del certificado raíz de certificación de hardware

Google presenta un nuevo certificado raíz para la certificación de claves de Android. Este cambio mejora la seguridad y la confiabilidad del proceso de certificación para aplicaciones sensibles. Se generó una nueva clave raíz para la certificación de claves de Android (KeyMint). La nueva raíz es una clave ECDSA P-384.

Qué debe hacer

Si tu app depende de la certificación de claves de Android, agrega el nuevo certificado raíz a tus almacenes de confianza antes del 31 de marzo de 2026. Descarga los certificados nuevos y anteriores desde https://android.googleapis.com/attestation/root
Los dispositivos que usan el aprovisionamiento de claves remotas (RKP) comenzarán a recibir certificados basados en este nuevo certificado en febrero de 2026. Los dispositivos habilitados para RKP usarán exclusivamente la nueva raíz antes del 10 de abril de 2026.
Actualiza tus procesos de certificación para confiar en los certificados raíz nuevos y existentes. Los dispositivos más antiguos con claves aprovisionadas de fábrica no admiten la rotación de claves y continúan usando la raíz anterior.
El esquema de extensión de certificado en sí no cambiará; solo cambiará la raíz.
Las formas legibles por humanos y por máquinas de la nueva raíz estarán disponibles públicamente.

Prácticas recomendadas

No consultes un extremo para obtener raíces de confianza en el tiempo de ejecución, ya que esta acción crea riesgos de seguridad. Controla los cambios en las raíces de confianza a través de un proceso formal.

Eliminación gradual de claves de fábrica: Aprovisionamiento de claves remotas (RKP)

En el caso de los dispositivos que se lanzan con Android 16, el sistema solo admite RKP. Esta política elimina gradualmente las claves de fábrica. Mejora la forma en que aprovisionas y administras las claves de certificación, y se expande en la política de Android 15, en la que la compatibilidad con RKP era opcional. RKP evita la filtración de claves porque el sistema no programa claves directamente en el dispositivo. No puedes borrar estas claves del dispositivo. Si debes revocar una clave, puedes orientar la revocación a un solo dispositivo.

Bibliotecas de verificación de certificación

Usa la biblioteca de Kotlin de verificación de certificación para verificar las cadenas de certificados de certificación de claves. Además, esta biblioteca ya integra los nuevos certificados raíz. Si usas un verificador diferente, te recomendamos que cambies a la biblioteca de Kotlin. Está bien probada y cubre casos extremos que a menudo no detectan los verificadores personalizados.

Lista de estado de revocación de certificados

Las claves de certificación pueden revocarse por varios motivos, entre los que se incluyen el mal manejo o la posible extracción por parte de un atacante. Por lo tanto, es fundamental que se verifique el estado de cada certificado de una cadena de certificación con la lista de estado de revocación de certificados (CRL) oficial. Google mantiene esta lista, que se publica en https://android.googleapis.com/attestation/status. El encabezado Cache-Control en la respuesta HTTP determina la frecuencia con la que hay que comprobar si hay actualizaciones, de modo que no se requiere una solicitud de red para cada certificado que se verifica. Esta URL muestra un archivo JSON que contiene el estado de revocación de los certificados que no tienen un estado normal válido. El formato del archivo JSON cumple con la siguiente definición del esquema de JSON (borrador 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
}

Ejemplo de 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"
    }
  }
}

Política de revocación de certificados

La certificación forma la base de la lucha contra el abuso y la confianza en el ecosistema de Android. Proporciona una declaración verificable de forma criptográfica a terceros fuera del dispositivo sobre el estado de arranque del dispositivo.

Los certificados de las claves de certificación de Android se revocarán cuando las claves estén comprometidas, debido a la naturaleza crítica de la validez de la certificación. En esta sección, se describe una política para cuando se revocan los certificados. Es probable que esta política evolucione y enumere casos adicionales con el tiempo.

¿Qué califica para la revocación?

Las claves de certificación que se filtraron siempre son aptas para que se revoquen sus certificados. Las filtraciones se pueden descubrir de varias maneras, incluidas las siguientes:

Análisis de datos de certificación en la naturaleza
Descubrimiento de claves de certificación en redes sociales o en otros sitios públicos
Informes directamente de investigadores de seguridad

Una vez que se descubran, los certificados de certificación se revocarán agregando sus números de serie a la lista de revocación. Por lo general, esto sucederá en un plazo de varios días después del descubrimiento, pero puede tardar más en casos excepcionales. Por ejemplo, la revocación de certificados para claves de certificación filtradas suele demorarse si los dispositivos afectados por la revocación se pueden volver a aprovisionar de forma segura. La escala del impacto de la revocación también es un factor importante en los plazos de revocación.

Verificación de pares de claves respaldados por hardware con certificación de claves

Antes de comenzar, asegúrate de que tu dispositivo admita la certificación de claves a nivel del hardware

Recuperación y verificación de un par de claves guardado en hardware

Certificados raíz

Rotación del certificado raíz de certificación de hardware

Qué debe hacer

Prácticas recomendadas

Eliminación gradual de claves de fábrica: Aprovisionamiento de claves remotas (RKP)

Bibliotecas de verificación de certificación

Lista de estado de revocación de certificados

Política de revocación de certificados

¿Qué califica para la revocación?

Esquema de los datos de extensión de la certificación de claves

Esquema de los datos de extensión de la información de aprovisionamiento

Verificación de pares de claves respaldados por hardware con certificación de claves Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar, asegúrate de que tu dispositivo admita la certificación de claves a nivel del hardware

Recuperación y verificación de un par de claves guardado en hardware

Certificados raíz

Rotación del certificado raíz de certificación de hardware

Qué debe hacer

Prácticas recomendadas

Eliminación gradual de claves de fábrica: Aprovisionamiento de claves remotas (RKP)

Bibliotecas de verificación de certificación

Lista de estado de revocación de certificados

Política de revocación de certificados

¿Qué califica para la revocación?

Esquema de los datos de extensión de la certificación de claves

Esquema de los datos de extensión de la información de aprovisionamiento

Verificación de pares de claves respaldados por hardware con certificación de claves