Эта страница переведена с помощью Cloud Translation API.

Проверка пар аппаратных ключей с помощью аттестации ключей

Аттестация ключей дает вам больше уверенности в том, что ключи, которые вы используете в своем приложении, хранятся в аппаратном хранилище ключей устройства. В следующих разделах описывается, как проверить свойства аппаратных ключей и как интерпретировать данные расширения сертификатов аттестации.

Примечание. Прежде чем проверять свойства аппаратных ключей устройства в среде производственного уровня, убедитесь, что устройство поддерживает аттестацию ключей на аппаратном уровне. Для этого убедитесь, что цепочка сертификатов аттестации содержит корневой сертификат, подписанный корневым ключом аттестации Google, и что для элемента attestationSecurityLevel в структуре данных описания ключа установлен уровень безопасности TrustedEnvironment или уровень безопасности StrongBox .

Кроме того, важно проверить подписи в цепочке сертификатов и убедиться, что ни один из ключей в цепочке не был отозван, проверив список статусов отзыва сертификатов . Если все они действительны и корневой ключ не является корневым ключом Google, не доверяйте полностью аттестации. Однако обратите внимание, что устройства, содержащие отозванные сертификаты, по крайней мере, заслуживают такого же доверия, как и устройства, которые поддерживают только аттестацию программного обеспечения. Наличие полностью действительной аттестации является сильным положительным показателем. Отсутствие такового является нейтральным, а не отрицательным показателем.

Получение и проверка пары аппаратных ключей

Во время аттестации ключей вы указываете псевдоним пары ключей и получаете ее цепочку сертификатов, которую можно использовать для проверки свойств этой пары ключей.

Если устройство поддерживает аттестацию ключей на аппаратном уровне, корневой сертификат в этой цепочке подписывается с использованием корневого ключа аттестации, который безопасно предоставляется в аппаратное хранилище ключей устройства.

Примечание. На устройствах, которые поставляются с аттестацией ключа на аппаратном уровне, Android 7.0 (уровень API 24) или выше и службами Google Play, корневой сертификат подписывается корневым ключом аттестации Google. Убедитесь, что этот корневой сертификат входит в число перечисленных в разделе о корневых сертификатах .

Чтобы реализовать аттестацию ключей, выполните следующие действия:

Используйте метод getCertificateChain() объекта KeyStore , чтобы получить ссылку на цепочку сертификатов X.509, связанных с аппаратным хранилищем ключей.
Отправьте сертификаты на отдельный сервер, которому вы доверяете, для проверки.
Внимание: не выполняйте следующий процесс проверки на том же устройстве, что и хранилище ключей. Если система Android на этом устройстве взломана, это может привести к тому, что процесс проверки будет доверять чему-то ненадежному.
Получите ссылку на библиотеку анализа и проверки цепочки сертификатов X.509, которая наиболее подходит для вашего набора инструментов. Убедитесь, что корневой общедоступный сертификат заслуживает доверия и что каждый сертификат подписывает следующий сертификат в цепочке.
Проверьте статус отзыва каждого сертификата, чтобы убедиться, что ни один из сертификатов не был отозван.
При необходимости проверьте расширение сертификата с информацией об обеспечении, которое присутствует только в новых цепочках сертификатов.
Получите ссылку на библиотеку анализатора CBOR, которая наиболее подходит для вашего набора инструментов. Найдите ближайший к корню сертификат, содержащий расширение сертификата с информацией об обеспечении . Используйте анализатор для извлечения данных расширения сертификата с информацией об обеспечении из этого сертификата.
Дополнительные сведения см. в разделе о схеме данных расширения информации обеспечения .
Получите ссылку на библиотеку анализатора ASN.1, которая наиболее подходит для вашего набора инструментов. Найдите ближайший к корню сертификат, содержащий расширение сертификата аттестации ключа . Если расширение сертификата информации обеспечения присутствовало, расширение сертификата аттестации ключа должно находиться в следующем за ним сертификате. Используйте анализатор для извлечения данных расширения сертификата аттестации ключа из этого сертификата.
Внимание: не предполагайте, что расширение сертификата аттестации ключа находится в конечном сертификате цепочки. Доверять можно только первому появлению расширения в цепочке. Любые дальнейшие экземпляры расширения не были выпущены защищенным оборудованием и могли быть выпущены злоумышленником, расширяющим цепочку при попытке создать поддельные аттестации для ненадежных ключей.
В образце Key Attestation используется анализатор ASN.1 из Bouncy Castle для извлечения данных расширения сертификата аттестации. Вы можете использовать этот пример как справочник для создания собственного синтаксического анализатора.
Дополнительные сведения см. в разделе о схеме данных расширения аттестации ключей .
Проверьте данные расширения, полученные на предыдущих шагах, на предмет согласованности и сравните их с набором значений, которые, как вы ожидаете, будет содержать ключ с аппаратной поддержкой.

Корневые сертификаты

Надежность аттестации зависит от корневого сертификата цепочки. Устройства Android, прошедшие тестирование, необходимое для установки набора приложений Google, включая Google Play, и запущенные с Android 7.0 (уровень API 24) или выше, должны использовать ключи аттестации, подписанные корневым сертификатом аттестации оборудования Google. Обратите внимание, что аттестация не требовалась до Android 8.0 (уровень API 26). Корневой открытый ключ выглядит следующим образом:

Ранее выданные корневые сертификаты

Если корневой сертификат в полученной вами цепочке аттестаций содержит этот открытый ключ и ни один из сертификатов в цепочке не был отозван , вы знаете, что:

Ваш ключ находится в оборудовании, которое Google считает безопасным; и
Он обладает свойствами, описанными в сертификате аттестации.

Если в цепочке аттестации есть какой-либо другой корневой открытый ключ, Google не делает никаких заявлений о безопасности оборудования. Это не означает, что ваш ключ скомпрометирован, просто аттестация не доказывает, что ключ находится на защищенном оборудовании. Соответственно скорректируйте свои предположения о безопасности.

Если корневой сертификат не содержит открытого ключа на этой странице, есть две вероятные причины:

Скорее всего, устройство выпущено с версией Android ниже 7.0 и не поддерживает аттестацию оборудования. В этом случае в Android имеется программная реализация аттестации, которая создает такой же сертификат аттестации, но подписанный ключом , жестко запрограммированным в исходном коде Android . Поскольку этот ключ подписи не является секретом, аттестация могла быть создана злоумышленником, претендующим на предоставление безопасного оборудования.
Другая вероятная причина заключается в том, что устройство не является устройством Google Play. В этом случае производитель устройства может свободно создать свой собственный корень и делать любые заявления о том, что означает аттестация. Обратитесь к документации производителя устройства. Обратите внимание, что на момент написания этой статьи Google не знает ни одного производителя устройств, который сделал это.

Список статусов отзыва сертификатов

Ключи аттестации могут быть отозваны по ряду причин, включая неправильное обращение или подозрение на их извлечение злоумышленником. Поэтому крайне важно, чтобы статус каждого сертификата в цепочке аттестации проверялся по официальному списку статусов отзыва сертификатов (CRL). Этот список поддерживается Google и публикуется по адресу: https://android.googleapis.com/attestation/status . Заголовок Cache-Control в ответе HTTP определяет, как часто проверять наличие обновлений, чтобы для каждого проверяемого сертификата не требовался сетевой запрос. Этот URL-адрес возвращает файл JSON, содержащий статус отзыва для всех сертификатов, которые не имеют нормального действительного статуса. Формат файла JSON соответствует следующему определению схемы JSON ( проект 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
}

Пример списка отзыва сертификатов:

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

Устаревшие списки отзыва сертификатов

URL-адреса CRL, встроенные в устаревшие сертификаты аттестации, продолжают работать. Новые сертификаты аттестации больше не содержат расширение URL-адреса CRL. Статус устаревших сертификатов также включен в список статусов аттестации, поэтому разработчики могут безопасно переключаться на использование списка статусов аттестации как для новых, так и для устаревших сертификатов. Пример того, как правильно проверить ключи аттестации Android, включен в пример Key Attestation .

Схема данных расширения ключевой аттестации

Расширение аттестации ключа имеет OID 1.3.6.1.4.1.11129.2.1.17 . Расширение хранит информацию в соответствии со схемой ASN.1. Чтобы просмотреть схему, соответствующую используемой вами версии аттестации, выберите соответствующую вкладку в следующем списке схем:

Версия 300

KeyDescription ::= SEQUENCE {
    attestationVersion  300,
    attestationSecurityLevel  SecurityLevel,
    keyMintVersion  INTEGER,
    keyMintSecurityLevel  SecurityLevel,
    attestationChallenge  OCTET_STRING,
    uniqueId  OCTET_STRING,
    softwareEnforced  AuthorizationList,
    hardwareEnforced  AuthorizationList,
}

SecurityLevel ::= ENUMERATED {
    Software  (0),
    TrustedEnvironment  (1),
    StrongBox  (2),
}

AuthorizationList ::= SEQUENCE {
    purpose  [1] EXPLICIT SET OF INTEGER OPTIONAL,
    algorithm  [2] EXPLICIT INTEGER OPTIONAL,
    keySize  [3] EXPLICIT INTEGER OPTIONAL,
    digest  [5] EXPLICIT SET OF INTEGER OPTIONAL,
    padding  [6] EXPLICIT SET OF INTEGER OPTIONAL,
    ecCurve  [10] EXPLICIT INTEGER OPTIONAL,
    rsaPublicExponent  [200] EXPLICIT INTEGER OPTIONAL,
    mgfDigest  [203] EXPLICIT SET OF INTEGER OPTIONAL,
    rollbackResistance  [303] EXPLICIT NULL OPTIONAL,
    earlyBootOnly  [305] EXPLICIT NULL OPTIONAL,
    activeDateTime  [400] EXPLICIT INTEGER OPTIONAL,
    originationExpireDateTime  [401] EXPLICIT INTEGER OPTIONAL,
    usageExpireDateTime  [402] EXPLICIT INTEGER OPTIONAL,
    usageCountLimit  [405] EXPLICIT INTEGER OPTIONAL,
    noAuthRequired  [503] EXPLICIT NULL OPTIONAL,
    userAuthType  [504] EXPLICIT INTEGER OPTIONAL,
    authTimeout  [505] EXPLICIT INTEGER OPTIONAL,
    allowWhileOnBody  [506] EXPLICIT NULL OPTIONAL,
    trustedUserPresenceRequired  [507] EXPLICIT NULL OPTIONAL,
    trustedConfirmationRequired  [508] EXPLICIT NULL OPTIONAL,
    unlockedDeviceRequired  [509] EXPLICIT NULL OPTIONAL,
    creationDateTime  [701] EXPLICIT INTEGER OPTIONAL,
    origin  [702] EXPLICIT INTEGER OPTIONAL,
    rootOfTrust  [704] EXPLICIT RootOfTrust OPTIONAL,
    osVersion  [705] EXPLICIT INTEGER OPTIONAL,
    osPatchLevel  [706] EXPLICIT INTEGER OPTIONAL,
    attestationApplicationId  [709] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdBrand  [710] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdDevice  [711] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdProduct  [712] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdSerial  [713] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdImei  [714] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdMeid  [715] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdManufacturer  [716] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdModel  [717] EXPLICIT OCTET_STRING OPTIONAL,
    vendorPatchLevel  [718] EXPLICIT INTEGER OPTIONAL,
    bootPatchLevel  [719] EXPLICIT INTEGER OPTIONAL,
    deviceUniqueAttestation  [720] EXPLICIT NULL OPTIONAL,
    attestationIdSecondImei  [723] EXPLICIT OCTET_STRING OPTIONAL,
}

RootOfTrust ::= SEQUENCE {
    verifiedBootKey  OCTET_STRING,
    deviceLocked  BOOLEAN,
    verifiedBootState  VerifiedBootState,
    verifiedBootHash OCTET_STRING,
}

VerifiedBootState ::= ENUMERATED {
    Verified  (0),
    SelfSigned  (1),
    Unverified  (2),
    Failed  (3),
}

Версия 200

KeyDescription ::= SEQUENCE {
    attestationVersion  200,
    attestationSecurityLevel  SecurityLevel,
    keyMintVersion  INTEGER,
    keyMintSecurityLevel  SecurityLevel,
    attestationChallenge  OCTET_STRING,
    uniqueId  OCTET_STRING,
    softwareEnforced  AuthorizationList,
    hardwareEnforced  AuthorizationList,
}

SecurityLevel ::= ENUMERATED {
    Software  (0),
    TrustedEnvironment  (1),
    StrongBox  (2),
}

AuthorizationList ::= SEQUENCE {
    purpose  [1] EXPLICIT SET OF INTEGER OPTIONAL,
    algorithm  [2] EXPLICIT INTEGER OPTIONAL,
    keySize  [3] EXPLICIT INTEGER OPTIONAL,
    digest  [5] EXPLICIT SET OF INTEGER OPTIONAL,
    padding  [6] EXPLICIT SET OF INTEGER OPTIONAL,
    ecCurve  [10] EXPLICIT INTEGER OPTIONAL,
    rsaPublicExponent  [200] EXPLICIT INTEGER OPTIONAL,
    mgfDigest  [203] EXPLICIT SET OF INTEGER OPTIONAL,
    rollbackResistance  [303] EXPLICIT NULL OPTIONAL,
    earlyBootOnly  [305] EXPLICIT NULL OPTIONAL,
    activeDateTime  [400] EXPLICIT INTEGER OPTIONAL,
    originationExpireDateTime  [401] EXPLICIT INTEGER OPTIONAL,
    usageExpireDateTime  [402] EXPLICIT INTEGER OPTIONAL,
    usageCountLimit  [405] EXPLICIT INTEGER OPTIONAL,
    noAuthRequired  [503] EXPLICIT NULL OPTIONAL,
    userAuthType  [504] EXPLICIT INTEGER OPTIONAL,
    authTimeout  [505] EXPLICIT INTEGER OPTIONAL,
    allowWhileOnBody  [506] EXPLICIT NULL OPTIONAL,
    trustedUserPresenceRequired  [507] EXPLICIT NULL OPTIONAL,
    trustedConfirmationRequired  [508] EXPLICIT NULL OPTIONAL,
    unlockedDeviceRequired  [509] EXPLICIT NULL OPTIONAL,
    creationDateTime  [701] EXPLICIT INTEGER OPTIONAL,
    origin  [702] EXPLICIT INTEGER OPTIONAL,
    rootOfTrust  [704] EXPLICIT RootOfTrust OPTIONAL,
    osVersion  [705] EXPLICIT INTEGER OPTIONAL,
    osPatchLevel  [706] EXPLICIT INTEGER OPTIONAL,
    attestationApplicationId  [709] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdBrand  [710] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdDevice  [711] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdProduct  [712] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdSerial  [713] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdImei  [714] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdMeid  [715] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdManufacturer  [716] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdModel  [717] EXPLICIT OCTET_STRING OPTIONAL,
    vendorPatchLevel  [718] EXPLICIT INTEGER OPTIONAL,
    bootPatchLevel  [719] EXPLICIT INTEGER OPTIONAL,
    deviceUniqueAttestation  [720] EXPLICIT NULL OPTIONAL,
}

RootOfTrust ::= SEQUENCE {
    verifiedBootKey  OCTET_STRING,
    deviceLocked  BOOLEAN,
    verifiedBootState  VerifiedBootState,
    verifiedBootHash OCTET_STRING,
}

VerifiedBootState ::= ENUMERATED {
    Verified  (0),
    SelfSigned  (1),
    Unverified  (2),
    Failed  (3),
}

Версия 100

KeyDescription ::= SEQUENCE {
    attestationVersion  100,
    attestationSecurityLevel  SecurityLevel,
    keyMintVersion  INTEGER,
    keyMintSecurityLevel  SecurityLevel,
    attestationChallenge  OCTET_STRING,
    uniqueId  OCTET_STRING,
    softwareEnforced  AuthorizationList,
    hardwareEnforced  AuthorizationList,
}

SecurityLevel ::= ENUMERATED {
    Software  (0),
    TrustedEnvironment  (1),
    StrongBox  (2),
}

AuthorizationList ::= SEQUENCE {
    purpose  [1] EXPLICIT SET OF INTEGER OPTIONAL,
    algorithm  [2] EXPLICIT INTEGER OPTIONAL,
    keySize  [3] EXPLICIT INTEGER OPTIONAL,
    digest  [5] EXPLICIT SET OF INTEGER OPTIONAL,
    padding  [6] EXPLICIT SET OF INTEGER OPTIONAL,
    ecCurve  [10] EXPLICIT INTEGER OPTIONAL,
    rsaPublicExponent  [200] EXPLICIT INTEGER OPTIONAL,
    mgfDigest  [203] EXPLICIT SET OF INTEGER OPTIONAL,
    rollbackResistance  [303] EXPLICIT NULL OPTIONAL,
    earlyBootOnly  [305] EXPLICIT NULL OPTIONAL,
    activeDateTime  [400] EXPLICIT INTEGER OPTIONAL,
    originationExpireDateTime  [401] EXPLICIT INTEGER OPTIONAL,
    usageExpireDateTime  [402] EXPLICIT INTEGER OPTIONAL,
    usageCountLimit  [405] EXPLICIT INTEGER OPTIONAL,
    noAuthRequired  [503] EXPLICIT NULL OPTIONAL,
    userAuthType  [504] EXPLICIT INTEGER OPTIONAL,
    authTimeout  [505] EXPLICIT INTEGER OPTIONAL,
    allowWhileOnBody  [506] EXPLICIT NULL OPTIONAL,
    trustedUserPresenceRequired  [507] EXPLICIT NULL OPTIONAL,
    trustedConfirmationRequired  [508] EXPLICIT NULL OPTIONAL,
    unlockedDeviceRequired  [509] EXPLICIT NULL OPTIONAL,
    creationDateTime  [701] EXPLICIT INTEGER OPTIONAL,
    origin  [702] EXPLICIT INTEGER OPTIONAL,
    rootOfTrust  [704] EXPLICIT RootOfTrust OPTIONAL,
    osVersion  [705] EXPLICIT INTEGER OPTIONAL,
    osPatchLevel  [706] EXPLICIT INTEGER OPTIONAL,
    attestationApplicationId  [709] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdBrand  [710] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdDevice  [711] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdProduct  [712] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdSerial  [713] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdImei  [714] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdMeid  [715] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdManufacturer  [716] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdModel  [717] EXPLICIT OCTET_STRING OPTIONAL,
    vendorPatchLevel  [718] EXPLICIT INTEGER OPTIONAL,
    bootPatchLevel  [719] EXPLICIT INTEGER OPTIONAL,
    deviceUniqueAttestation  [720] EXPLICIT NULL OPTIONAL,
}

RootOfTrust ::= SEQUENCE {
    verifiedBootKey  OCTET_STRING,
    deviceLocked  BOOLEAN,
    verifiedBootState  VerifiedBootState,
    verifiedBootHash OCTET_STRING,
}

VerifiedBootState ::= ENUMERATED {
    Verified  (0),
    SelfSigned  (1),
    Unverified  (2),
    Failed  (3),
}

Версия 4

KeyDescription ::= SEQUENCE {
    attestationVersion  4,
    attestationSecurityLevel  SecurityLevel,
    keymasterVersion  INTEGER,
    keymasterSecurityLevel  SecurityLevel,
    attestationChallenge  OCTET_STRING,
    uniqueId  OCTET_STRING,
    softwareEnforced  AuthorizationList,
    hardwareEnforced  AuthorizationList,
}

SecurityLevel ::= ENUMERATED {
    Software  (0),
    TrustedEnvironment  (1),
    StrongBox  (2),
}

AuthorizationList ::= SEQUENCE {
    purpose  [1] EXPLICIT SET OF INTEGER OPTIONAL,
    algorithm  [2] EXPLICIT INTEGER OPTIONAL,
    keySize  [3] EXPLICIT INTEGER OPTIONAL,
    digest  [5] EXPLICIT SET OF INTEGER OPTIONAL,
    padding  [6] EXPLICIT SET OF INTEGER OPTIONAL,
    ecCurve  [10] EXPLICIT INTEGER OPTIONAL,
    rsaPublicExponent  [200] EXPLICIT INTEGER OPTIONAL,
    rollbackResistance  [303] EXPLICIT NULL OPTIONAL,
    earlyBootOnly  [305] EXPLICIT NULL OPTIONAL,
    activeDateTime  [400] EXPLICIT INTEGER OPTIONAL,
    originationExpireDateTime  [401] EXPLICIT INTEGER OPTIONAL,
    usageExpireDateTime  [402] EXPLICIT INTEGER OPTIONAL,
    noAuthRequired  [503] EXPLICIT NULL OPTIONAL,
    userAuthType  [504] EXPLICIT INTEGER OPTIONAL,
    authTimeout  [505] EXPLICIT INTEGER OPTIONAL,
    allowWhileOnBody  [506] EXPLICIT NULL OPTIONAL,
    trustedUserPresenceRequired  [507] EXPLICIT NULL OPTIONAL,
    trustedConfirmationRequired  [508] EXPLICIT NULL OPTIONAL,
    unlockedDeviceRequired  [509] EXPLICIT NULL OPTIONAL,
    allApplications  [600] EXPLICIT NULL OPTIONAL,
    creationDateTime  [701] EXPLICIT INTEGER OPTIONAL,
    origin  [702] EXPLICIT INTEGER OPTIONAL,
    rootOfTrust  [704] EXPLICIT RootOfTrust OPTIONAL,
    osVersion  [705] EXPLICIT INTEGER OPTIONAL,
    osPatchLevel  [706] EXPLICIT INTEGER OPTIONAL,
    attestationApplicationId  [709] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdBrand  [710] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdDevice  [711] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdProduct  [712] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdSerial  [713] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdImei  [714] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdMeid  [715] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdManufacturer  [716] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdModel  [717] EXPLICIT OCTET_STRING OPTIONAL,
    vendorPatchLevel  [718] EXPLICIT INTEGER OPTIONAL,
    bootPatchLevel  [719] EXPLICIT INTEGER OPTIONAL,
    deviceUniqueAttestation  [720] EXPLICIT NULL OPTIONAL,
}

RootOfTrust ::= SEQUENCE {
    verifiedBootKey  OCTET_STRING,
    deviceLocked  BOOLEAN,
    verifiedBootState  VerifiedBootState,
    verifiedBootHash OCTET_STRING,
}

VerifiedBootState ::= ENUMERATED {
    Verified  (0),
    SelfSigned  (1),
    Unverified  (2),
    Failed  (3),
}

Версия 3

KeyDescription ::= SEQUENCE {
    attestationVersion  3,
    attestationSecurityLevel  SecurityLevel,
    keymasterVersion  INTEGER,
    keymasterSecurityLevel  SecurityLevel,
    attestationChallenge  OCTET_STRING,
    uniqueId  OCTET_STRING,
    softwareEnforced  AuthorizationList,
    hardwareEnforced  AuthorizationList,
}

SecurityLevel ::= ENUMERATED {
    Software  (0),
    TrustedEnvironment  (1),
    StrongBox  (2),
}

AuthorizationList ::= SEQUENCE {
    purpose  [1] EXPLICIT SET OF INTEGER OPTIONAL,
    algorithm  [2] EXPLICIT INTEGER OPTIONAL,
    keySize  [3] EXPLICIT INTEGER OPTIONAL,
    digest  [5] EXPLICIT SET OF INTEGER OPTIONAL,
    padding  [6] EXPLICIT SET OF INTEGER OPTIONAL,
    ecCurve  [10] EXPLICIT INTEGER OPTIONAL,
    rsaPublicExponent  [200] EXPLICIT INTEGER OPTIONAL,
    rollbackResistance  [303] EXPLICIT NULL OPTIONAL,
    activeDateTime  [400] EXPLICIT INTEGER OPTIONAL,
    originationExpireDateTime  [401] EXPLICIT INTEGER OPTIONAL,
    usageExpireDateTime  [402] EXPLICIT INTEGER OPTIONAL,
    noAuthRequired  [503] EXPLICIT NULL OPTIONAL,
    userAuthType  [504] EXPLICIT INTEGER OPTIONAL,
    authTimeout  [505] EXPLICIT INTEGER OPTIONAL,
    allowWhileOnBody  [506] EXPLICIT NULL OPTIONAL,
    trustedUserPresenceRequired  [507] EXPLICIT NULL OPTIONAL,
    trustedConfirmationRequired  [508] EXPLICIT NULL OPTIONAL,
    unlockedDeviceRequired  [509] EXPLICIT NULL OPTIONAL,
    allApplications  [600] EXPLICIT NULL OPTIONAL,
    creationDateTime  [701] EXPLICIT INTEGER OPTIONAL,
    origin  [702] EXPLICIT INTEGER OPTIONAL,
    rootOfTrust  [704] EXPLICIT RootOfTrust OPTIONAL,
    osVersion  [705] EXPLICIT INTEGER OPTIONAL,
    osPatchLevel  [706] EXPLICIT INTEGER OPTIONAL,
    attestationApplicationId  [709] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdBrand  [710] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdDevice  [711] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdProduct  [712] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdSerial  [713] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdImei  [714] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdMeid  [715] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdManufacturer  [716] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdModel  [717] EXPLICIT OCTET_STRING OPTIONAL,
    vendorPatchLevel  [718] EXPLICIT INTEGER OPTIONAL,
    bootPatchLevel  [719] EXPLICIT INTEGER OPTIONAL,
}

RootOfTrust ::= SEQUENCE {
    verifiedBootKey  OCTET_STRING,
    deviceLocked  BOOLEAN,
    verifiedBootState  VerifiedBootState,
    verifiedBootHash OCTET_STRING,
}

VerifiedBootState ::= ENUMERATED {
    Verified  (0),
    SelfSigned  (1),
    Unverified  (2),
    Failed  (3),
}

Версия 2

KeyDescription ::= SEQUENCE {
    attestationVersion  2,
    attestationSecurityLevel  SecurityLevel,
    keymasterVersion  INTEGER,
    keymasterSecurityLevel  SecurityLevel,
    attestationChallenge  OCTET_STRING,
    uniqueId  OCTET_STRING,
    softwareEnforced  AuthorizationList,
    hardwareEnforced  AuthorizationList,
}

SecurityLevel ::= ENUMERATED {
    Software  (0),
    TrustedEnvironment  (1),
}

AuthorizationList ::= SEQUENCE {
    purpose  [1] EXPLICIT SET OF INTEGER OPTIONAL,
    algorithm  [2] EXPLICIT INTEGER OPTIONAL,
    keySize  [3] EXPLICIT INTEGER OPTIONAL,
    digest  [5] EXPLICIT SET OF INTEGER OPTIONAL,
    padding  [6] EXPLICIT SET OF INTEGER OPTIONAL,
    ecCurve  [10] EXPLICIT INTEGER OPTIONAL,
    rsaPublicExponent  [200] EXPLICIT INTEGER OPTIONAL,
    activeDateTime  [400] EXPLICIT INTEGER OPTIONAL,
    originationExpireDateTime  [401] EXPLICIT INTEGER OPTIONAL,
    usageExpireDateTime  [402] EXPLICIT INTEGER OPTIONAL,
    noAuthRequired  [503] EXPLICIT NULL OPTIONAL,
    userAuthType  [504] EXPLICIT INTEGER OPTIONAL,
    authTimeout  [505] EXPLICIT INTEGER OPTIONAL,
    allowWhileOnBody  [506] EXPLICIT NULL OPTIONAL,
    allApplications  [600] EXPLICIT NULL OPTIONAL,
    creationDateTime  [701] EXPLICIT INTEGER OPTIONAL,
    origin  [702] EXPLICIT INTEGER OPTIONAL,
    rollbackResistant  [703] EXPLICIT NULL OPTIONAL,
    rootOfTrust  [704] EXPLICIT RootOfTrust OPTIONAL,
    osVersion  [705] EXPLICIT INTEGER OPTIONAL,
    osPatchLevel  [706] EXPLICIT INTEGER OPTIONAL,
    attestationApplicationId  [709] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdBrand  [710] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdDevice  [711] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdProduct  [712] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdSerial  [713] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdImei  [714] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdMeid  [715] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdManufacturer  [716] EXPLICIT OCTET_STRING OPTIONAL,
    attestationIdModel  [717] EXPLICIT OCTET_STRING OPTIONAL,
}

RootOfTrust ::= SEQUENCE {
    verifiedBootKey  OCTET_STRING,
    deviceLocked  BOOLEAN,
    verifiedBootState  VerifiedBootState,
}

VerifiedBootState ::= ENUMERATED {
    Verified  (0),
    SelfSigned  (1),
    Unverified  (2),
    Failed  (3),
}

Версия 1

KeyDescription ::= SEQUENCE {
    attestationVersion  1,
    attestationSecurityLevel  SecurityLevel,
    keymasterVersion  INTEGER,
    keymasterSecurityLevel  SecurityLevel,
    attestationChallenge  OCTET_STRING,
    uniqueId  OCTET_STRING,
    softwareEnforced  AuthorizationList,
    hardwareEnforced  AuthorizationList,
}

SecurityLevel ::= ENUMERATED {
    Software  (0),
    TrustedEnvironment  (1),
}

AuthorizationList ::= SEQUENCE {
    purpose  [1] EXPLICIT SET OF INTEGER OPTIONAL,
    algorithm  [2] EXPLICIT INTEGER OPTIONAL,
    keySize  [3] EXPLICIT INTEGER OPTIONAL,
    digest  [5] EXPLICIT SET OF INTEGER OPTIONAL,
    padding  [6] EXPLICIT SET OF INTEGER OPTIONAL,
    ecCurve  [10] EXPLICIT INTEGER OPTIONAL,
    rsaPublicExponent  [200] EXPLICIT INTEGER OPTIONAL,
    activeDateTime  [400] EXPLICIT INTEGER OPTIONAL,
    originationExpireDateTime  [401] EXPLICIT INTEGER OPTIONAL,
    usageExpireDateTime  [402] EXPLICIT INTEGER OPTIONAL,
    noAuthRequired  [503] EXPLICIT NULL OPTIONAL,
    userAuthType  [504] EXPLICIT INTEGER OPTIONAL,
    authTimeout  [505] EXPLICIT INTEGER OPTIONAL,
    allowWhileOnBody  [506] EXPLICIT NULL OPTIONAL,
    allApplications  [600] EXPLICIT NULL OPTIONAL,
    creationDateTime  [701] EXPLICIT INTEGER OPTIONAL,
    origin  [702] EXPLICIT INTEGER OPTIONAL,
    rollbackResistant  [703] EXPLICIT NULL OPTIONAL,
    rootOfTrust  [704] EXPLICIT RootOfTrust OPTIONAL,
    osVersion  [705] EXPLICIT INTEGER OPTIONAL,
    osPatchLevel  [706] EXPLICIT INTEGER OPTIONAL,
}

RootOfTrust ::= SEQUENCE {
    verifiedBootKey  OCTET_STRING,
    deviceLocked  BOOLEAN,
    verifiedBootState  VerifiedBootState,
}

VerifiedBootState ::= ENUMERATED {
    Verified  (0),
    SelfSigned  (1),
    Unverified  (2),
    Failed  (3),
}

В следующем списке представлено описание каждого элемента схемы:

КлючОписание

Эта последовательность значений представляет общую информацию о паре ключей, проверяемой посредством аттестации ключей, и обеспечивает легкий доступ к дополнительным сведениям.

attestationVersion

Версия функции ключевой аттестации.

Ценить	Версия
1	Ключевой мастер версии 2.0
2	Ключевой мастер версии 3.0
3	Ключевой мастер версии 4.0
4	Ключевой мастер версии 4.1
100	КейМинт версия 1.0
200	КейМинт версии 2.0
300	КейМинт версии 3.0

attestationSecurityLevel

Уровень безопасности аттестации.

Предупреждение. Несмотря на то, что можно подтвердить ключи, хранящиеся в системе Android (то есть, если для параметра attestationSecurityLevel установлено значение Software), вы не можете доверять этим подтверждениям, если система Android окажется скомпрометированной.

keymasterVersion / keyMintVersion

Версия уровня аппаратной абстракции (HAL) Keymaster или KeyMint.

Ценить	Версия
0	Keymaster версии 0.2 или 0.3
1	Ключевой мастер версии 1.0
2	Ключевой мастер версии 2.0
3	Ключевой мастер версии 3.0
4	Ключевой мастер версии 4.0
41	Ключевой мастер версии 4.1
100	КейМинт версия 1.0
200	КейМинт версии 2.0
300	КейМинт версии 3.0

keymasterSecurityLevel / keyMintSecurityLevel

Уровень безопасности реализации Keymaster/KeyMint.

attestationChallenge

Содержит задачу, заданную во время создания ключа. Проверьте, соответствует ли это значение значению, предоставленному вашим сервером и хранящемуся в теге авторизации Tag::ATTESTATION_CHALLENGE . В противном случае ваша служба может быть уязвима для повторного воспроизведения старых сертификатов аттестации.

uniqueId

Это значение идентифицирует устройство, но только в течение ограниченного периода времени. Он вычисляется и используется только системными приложениями. Во всех остальных приложениях uniqueId пуст.

softwareEnforced

Необязательный. Список авторизации Keymaster/KeyMint, который применяется системой Android, а не доверенной средой выполнения (TEE) устройства. Информация в этом списке авторизации собирается или генерируется кодом, который является частью платформы и хранится в системном разделе устройства. Содержимому этого списка авторизации можно доверять, если на устройстве установлена операционная система, совместимая с моделью безопасности платформы Android. Все сертифицированные устройства Android соответствуют этой модели безопасности, поэтому, если устройство заблокировано и проверенное состояние загрузки — Verified , значения здесь должны быть надежными. На модифицированном устройстве, где загрузчик разблокирован, пользователь может установить операционную систему, не соответствующую модели безопасности платформы Android, поэтому значения в этом поле могут быть выбраны пользователем произвольно.

hardwareEnforced

Необязательный. Список авторизации Keymaster/KeyMint, который обеспечивается доверенной средой выполнения устройства (TEE). Информация в этом списке авторизации собирается или генерируется кодом, который является частью защищенного оборудования и не контролируется платформой. Например, информация в этом списке авторизации поступает из загрузчика устройства или TEE, работающего на устройстве. Поля в этом списке авторизации, которые не заданы напрямую KeyMint, предоставляются другими частями защищенного оборудования (например, загрузчиком) через безопасные каналы связи, которые не предполагают доверия к платформе. Разница между защищенным оборудованием и системой Android заключается в том, что пользователь не может изменять код, работающий на защищенном оборудовании (прошивке), поэтому он не может изменить значения в этом списке авторизации.

Уровень безопасности

Эта структура данных указывает степень защиты функции программного обеспечения, например пары ключей, в зависимости от ее местоположения внутри устройства.

Поскольку структура данных является перечислением, она принимает ровно одно из следующих значений:

хранилище ключей: Логика создания и управления функцией реализована в системе Android. Для создания и хранения пар ключей это место менее безопасно, чем TEE, но более безопасно, чем пространство процесса вашего приложения.
Доверенная среда: Логика создания функции и управления ею реализована в защищенном оборудовании, таком как TEE. С точки зрения создания и хранения пар ключей это место более безопасно, поскольку защищенное оборудование обладает высокой устойчивостью к удаленному компрометации.
Сейф: Логика создания и управления функцией реализована в специальном аппаратном модуле безопасности . С точки зрения создания и хранения пар ключей это место более безопасно, поскольку оно устойчиво к удаленному взлому и аппаратным атакам на модуль.
Программное обеспечение: Логика создания и управления этой функцией реализована в реализации KeyMint или Keymaster, которая не работает в безопасной среде. Для создания и хранения пар ключей это место менее безопасно, чем TEE, но более безопасно, чем пространство процесса вашего приложения.

Список авторизации

Эта структура данных содержит сами свойства пары ключей, определенные на уровне аппаратной абстракции (HAL) Keymaster или KeyMint. Вы сравниваете эти значения с текущим состоянием устройства или с набором ожидаемых значений, чтобы убедиться, что пара ключей по-прежнему действительна для использования в вашем приложении.

Каждое имя поля соответствует одноименному тегу авторизации Keymaster/KeyMint. Например, поле keySize в списке авторизации соответствует тегу авторизации Tag::KEY_SIZE .

Спецификация интерфейса AIDL содержит исчерпывающую информацию о тегах авторизации. Это определяет значение идентификатора и тип каждого тега, а также указывает, будет ли каждый тег присутствовать в списке авторизации hardwareEnforced (указывая, что тег применяется в безопасной среде) или в списке авторизации softwareEnforced (указывая, что тег применяется Android, обычно Keystore).

Каждое поле в следующем списке является необязательным:

purpose

Соответствует тегу авторизации Tag::PURPOSE , который использует значение идентификатора тега, равное 1.

algorithm

Соответствует тегу авторизации Tag::ALGORITHM , который использует значение идентификатора тега 2.

В объекте AuthorizationList аттестации значением алгоритма всегда является RSA или EC .

keySize

Соответствует тегу авторизации Tag::KEY_SIZE , который использует значение идентификатора тега 3.

digest

Соответствует тегу авторизации Tag::DIGEST , который использует значение идентификатора тега, равное 5.

padding

Соответствует тегу авторизации Tag::PADDING , который использует значение идентификатора тега 6.

ecCurve

Соответствует тегу авторизации Tag::EC_CURVE , который использует значение идентификатора тега 10.

Набор параметров, используемых для создания пары ключей эллиптической кривой (EC), которая использует ECDSA для подписи и проверки, в хранилище ключей системы Android.

rsaPublicExponent

Соответствует тегу авторизации Tag::RSA_PUBLIC_EXPONENT , который использует значение идентификатора тега 200.

mgfDigest

Присутствует только в версии аттестации ключа >= 100.

Соответствует тегу авторизации Tag::RSA_OAEP_MGF_DIGEST KeyMint, который использует значение идентификатора тега 203.

rollbackResistance

Присутствует только в версии аттестации ключа >= 3.

Соответствует тегу авторизации Tag::ROLLBACK_RESISTANT , который использует значение идентификатора тега 303.

earlyBootOnly

Присутствует только в версии аттестации ключа >= 4.

Соответствует тегу авторизации Tag::EARLY_BOOT_ONLY , который использует значение идентификатора тега 305.

activeDateTime

Соответствует тегу авторизации Tag::ACTIVE_DATETIME , который использует значение идентификатора тега 400.

originationExpireDateTime

Соответствует тегу авторизации Tag::ORIGINATION_EXPIRE_DATETIME Keymaster, который использует значение идентификатора тега 401.

usageExpireDateTime

Соответствует тегу авторизации Tag::USAGE_EXPIRE_DATETIME , который использует значение идентификатора тега 402.

usageCountLimit

Соответствует тегу авторизации Tag::USAGE_COUNT_LIMIT , который использует значение идентификатора тега 405.

noAuthRequired

Соответствует тегу авторизации Tag::NO_AUTH_REQUIRED , который использует значение идентификатора тега 503.

userAuthType

Соответствует тегу авторизации Tag::USER_AUTH_TYPE , который использует значение идентификатора тега 504.

authTimeout

Соответствует тегу авторизации Tag::AUTH_TIMEOUT , который использует значение идентификатора тега 505.

allowWhileOnBody

Соответствует тегу авторизации Tag::ALLOW_WHILE_ON_BODY , который использует значение идентификатора тега 506.

Позволяет использовать ключ по истечении времени ожидания аутентификации, если пользователь все еще носит устройство на своем теле. Обратите внимание, что безопасный датчик на теле определяет, носит ли устройство на теле пользователя.

trustedUserPresenceRequired

Присутствует только в версии аттестации ключа >= 3.

Соответствует тегу авторизации Tag::TRUSTED_USER_PRESENCE_REQUIRED , который использует значение идентификатора тега 507.

Указывает, что этот ключ можно использовать только в том случае, если пользователь предоставил доказательство физического присутствия. Несколько примеров включают следующее:

Для ключа StrongBox — аппаратная кнопка, жестко подключенная к контакту на устройстве StrongBox.
Для ключа TEE аутентификация по отпечатку пальца обеспечивает доказательство присутствия, пока TEE имеет исключительный контроль над сканером и выполняет процесс сопоставления отпечатков пальцев.

trustedConfirmationRequired

Присутствует только в версии аттестации ключа >= 3.

Соответствует тегу авторизации Tag::TRUSTED_CONFIRMATION_REQUIRED , который использует значение идентификатора тега 508.

Указывает, что ключ можно использовать только в том случае, если пользователь предоставляет подтверждение подписываемых данных с помощью токена утверждения. Дополнительные сведения о том, как получить подтверждение пользователя, см. в разделе Android Protected Confirmation .

Примечание. Этот тег применим только к клавишам, которые используют функцию SIGN .

unlockedDeviceRequired

Присутствует только в версии аттестации ключа >= 3.

Соответствует тегу авторизации Tag::UNLOCKED_DEVICE_REQUIRED , который использует значение идентификатора тега 509.

allApplications

Соответствует тегу авторизации Tag::ALL_APPLICATIONS , который использует значение идентификатора тега 600.

Указывает, могут ли все приложения на устройстве получить доступ к паре ключей.

applicationId

Соответствует тегу авторизации Tag::APPLICATION_ID , который использует значение идентификатора тега 601.

creationDateTime

Соответствует тегу авторизации Tag::CREATION_DATETIME , который использует значение идентификатора тега 701.

origin

Соответствует тегу авторизации Tag::ORIGIN , который использует значение идентификатора тега 702.

rollbackResistant

Присутствует только в версиях 1 и 2 аттестации ключей.

Соответствует тегу авторизации Tag::ROLLBACK_RESISTANT , который использует значение идентификатора тега 703.

rootOfTrust

Соответствует тегу авторизации Tag::ROOT_OF_TRUST , который использует значение идентификатора тега 704.

Подробнее см. в разделе, описывающем структуру данных RootOfTrust .

osVersion

Соответствует тегу авторизации Tag::OS_VERSION , который использует значение идентификатора тега 705.

Версия операционной системы Android, связанная с Keymaster, в виде шестизначного целого числа. Например, версия 8.1.0 представлена как 080100.

Только Keymaster версии 1.0 или выше включает это значение в список авторизации.

osPatchLevel

Соответствует тегу авторизации Tag::PATCHLEVEL , который использует значение идентификатора тега 706.

Месяц и год, связанные с исправлением безопасности, которое используется в Keymaster, в виде шестизначного целого числа. Например, патч от августа 2018 года представлен как 201808.

Только Keymaster версии 1.0 или выше включает это значение в список авторизации.

attestationApplicationId