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

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

Подготовка: убедитесь, что ваше устройство поддерживает аттестацию ключей на аппаратном уровне

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

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

Как получить и проверить пару ключей с аппаратной защитой

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

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

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

  1. Используйте метод getCertificateChain() объекта KeyStore, чтобы получить ссылку на цепочку сертификатов X.509, связанных с аппаратным хранилищем ключей.
  2. Отправлять сертификаты на отдельный доверенный сервер для проверки.

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

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

  4. Проверьте статус отзыва каждого сертификата, чтобы убедиться, что ни один из них не был отозван.

  5. При необходимости проверьте расширение сертификата с информацией о подготовке, которое присутствует только в новых цепочках сертификатов.

    Получите ссылку на библиотеку синтаксического анализатора CBOR, которая лучше всего подходит для вашего набора инструментов. Найдите ближайший к корневому сертификат, который содержит расширение сертификата с информацией о подготовке. Используйте синтаксический анализатор, чтобы извлечь из сертификата данные расширения сертификата с информацией о подготовке.

    Подробную информацию вы найдете в разделе Расширение с информацией о подготовке.

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

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

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

    Подробную информацию вы найдете в разделе Схема данных расширения для аттестации ключей.

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

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

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

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

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

-----BEGIN CERTIFICATE-----
MIIFHDCCAwSgAwIBAgIJAPHBcqaZ6vUdMA0GCSqGSIb3DQEBCwUAMBsxGTAXBgNV
BAUTEGY5MjAwOWU4NTNiNmIwNDUwHhcNMjIwMzIwMTgwNzQ4WhcNNDIwMzE1MTgw
NzQ4WjAbMRkwFwYDVQQFExBmOTIwMDllODUzYjZiMDQ1MIICIjANBgkqhkiG9w0B
AQEFAAOCAg8AMIICCgKCAgEAr7bHgiuxpwHsK7Qui8xUFmOr75gvMsd/dTEDDJdS
Sxtf6An7xyqpRR90PL2abxM1dEqlXnf2tqw1Ne4Xwl5jlRfdnJLmN0pTy/4lj4/7
tv0Sk3iiKkypnEUtR6WfMgH0QZfKHM1+di+y9TFRtv6y//0rb+T+W8a9nsNL/ggj
nar86461qO0rOs2cXjp3kOG1FEJ5MVmFmBGtnrKpa73XpXyTqRxB/M0n1n/W9nGq
C4FSYa04T6N5RIZGBN2z2MT5IKGbFlbC8UrW0DxW7AYImQQcHtGl/m00QLVWutHQ
oVJYnFPlXTcHYvASLu+RhhsbDmxMgJJ0mcDpvsC4PjvB+TxywElgS70vE0XmLD+O
JtvsBslHZvPBKCOdT0MS+tgSOIfga+z1Z1g7+DVagf7quvmag8jfPioyKvxnK/Eg
sTUVi2ghzq8wm27ud/mIM7AY2qEORR8Go3TVB4HzWQgpZrt3i5MIlCaY504LzSRi
igHCzAPlHws+W0rB5N+er5/2pJKnfBSDiCiFAVtCLOZ7gLiMm0jhO2B6tUXHI/+M
RPjy02i59lINMRRev56GKtcd9qO/0kUJWdZTdA2XoS82ixPvZtXQpUpuL12ab+9E
aDK8Z4RHJYYfCT3Q5vNAXaiWQ+8PTWm2QgBR/bkwSWc+NpUFgNPN9PvQi8WEg5Um
AGMCAwEAAaNjMGEwHQYDVR0OBBYEFDZh4QB8iAUJUYtEbEf/GkzJ6k8SMB8GA1Ud
IwQYMBaAFDZh4QB8iAUJUYtEbEf/GkzJ6k8SMA8GA1UdEwEB/wQFMAMBAf8wDgYD
VR0PAQH/BAQDAgIEMA0GCSqGSIb3DQEBCwUAA4ICAQB8cMqTllHc8U+qCrOlg3H7
174lmaCsbo/bJ0C17JEgMLb4kvrqsXZs01U3mB/qABg/1t5Pd5AORHARs1hhqGIC
W/nKMav574f9rZN4PC2ZlufGXb7sIdJpGiO9ctRhiLuYuly10JccUZGEHpHSYM2G
tkgYbZba6lsCPYAAP83cyDV+1aOkTf1RCp/lM0PKvmxYN10RYsK631jrleGdcdkx
oSK//mSQbgcWnmAEZrzHoF1/0gso1HZgIn0YLzVhLSA/iXCX4QT2h3J5z3znluKG
1nv8NQdxei2DIIhASWfu804CA96cQKTTlaae2fweqXjdN1/v2nqOhngNyz1361mF
mr4XmaKH/ItTwOe72NI9ZcwS1lVaCvsIkTDCEXdm9rCNPAY10iTunIHFXRh+7KPz
lHGewCq/8TOohBRn0/NNfh7uRslOSZ/xKbN9tMBtw37Z8d2vvnXq/YWdsm1+JLVw
n6yYD/yacNJBlwpddla8eaVMjsF6nBnIgQOf9zKSe06nSTqvgwUHosgOECZJZ1Eu
zbH4yswbt02tKtKEFhx+v+OTge/06V+jGsqTWLsfrOCNLuA8H++z+pUENmpqnnHo
vaI47gC+TNpkgYGkkBT6B/m/U01BuOBBTzhIlMEZq9qkDWuM2cA5kW5V3FJUcfHn
w1IdYIg2Wxg7yHcQZemFQg==
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIICIjCCAaigAwIBAgIRAISp0Cl7DrWK5/8OgN52BgUwCgYIKoZIzj0EAwMwUjEc
MBoGA1UEAwwTS2V5IEF0dGVzdGF0aW9uIENBMTEQMA4GA1UECwwHQW5kcm9pZDET
MBEGA1UECgwKR29vZ2xlIExMQzELMAkGA1UEBhMCVVMwHhcNMjUwNzE3MjIzMjE4
WhcNMzUwNzE1MjIzMjE4WjBSMRwwGgYDVQQDDBNLZXkgQXR0ZXN0YXRpb24gQ0Ex
MRAwDgYDVQQLDAdBbmRyb2lkMRMwEQYDVQQKDApHb29nbGUgTExDMQswCQYDVQQG
EwJVUzB2MBAGByqGSM49AgEGBSuBBAAiA2IABCPaI3FO3z5bBQo8cuiEas4HjqCt
G/mLFfRT0MsIssPBEEU5Cfbt6sH5yOAxqEi5QagpU1yX4HwnGb7OtBYpDTB57uH5
Eczm34A5FNijV3s0/f0UPl7zbJcTx6xwqMIRq6NCMEAwDwYDVR0TAQH/BAUwAwEB
/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFFIyuyz7RkOb3NaBqQ5lZuA0QepA
MAoGCCqGSM49BAMDA2gAMGUCMETfjPO/HwqReR2CS7p0ZWoD/LHs6hDi422opifH
EUaYLxwGlT9SLdjkVpz0UUOR5wIxAIoGyxGKRHVTpqpGRFiJtQEOOTp/+s1GcxeY
uR2zh/80lQyu9vAFCj6E4AXc+osmRg==
-----END CERTIFICATE-----
  
Ранее выпущенные корневые сертификаты
-----BEGIN CERTIFICATE-----
MIIFYDCCA0igAwIBAgIJAOj6GWMU0voYMA0GCSqGSIb3DQEBCwUAMBsxGTAXBgNV
BAUTEGY5MjAwOWU4NTNiNmIwNDUwHhcNMTYwNTI2MTYyODUyWhcNMjYwNTI0MTYy
ODUyWjAbMRkwFwYDVQQFExBmOTIwMDllODUzYjZiMDQ1MIICIjANBgkqhkiG9w0B
AQEFAAOCAg8AMIICCgKCAgEAr7bHgiuxpwHsK7Qui8xUFmOr75gvMsd/dTEDDJdS
Sxtf6An7xyqpRR90PL2abxM1dEqlXnf2tqw1Ne4Xwl5jlRfdnJLmN0pTy/4lj4/7
tv0Sk3iiKkypnEUtR6WfMgH0QZfKHM1+di+y9TFRtv6y//0rb+T+W8a9nsNL/ggj
nar86461qO0rOs2cXjp3kOG1FEJ5MVmFmBGtnrKpa73XpXyTqRxB/M0n1n/W9nGq
C4FSYa04T6N5RIZGBN2z2MT5IKGbFlbC8UrW0DxW7AYImQQcHtGl/m00QLVWutHQ
oVJYnFPlXTcHYvASLu+RhhsbDmxMgJJ0mcDpvsC4PjvB+TxywElgS70vE0XmLD+O
JtvsBslHZvPBKCOdT0MS+tgSOIfga+z1Z1g7+DVagf7quvmag8jfPioyKvxnK/Eg
sTUVi2ghzq8wm27ud/mIM7AY2qEORR8Go3TVB4HzWQgpZrt3i5MIlCaY504LzSRi
igHCzAPlHws+W0rB5N+er5/2pJKnfBSDiCiFAVtCLOZ7gLiMm0jhO2B6tUXHI/+M
RPjy02i59lINMRRev56GKtcd9qO/0kUJWdZTdA2XoS82ixPvZtXQpUpuL12ab+9E
aDK8Z4RHJYYfCT3Q5vNAXaiWQ+8PTWm2QgBR/bkwSWc+NpUFgNPN9PvQi8WEg5Um
AGMCAwEAAaOBpjCBozAdBgNVHQ4EFgQUNmHhAHyIBQlRi0RsR/8aTMnqTxIwHwYD
VR0jBBgwFoAUNmHhAHyIBQlRi0RsR/8aTMnqTxIwDwYDVR0TAQH/BAUwAwEB/zAO
BgNVHQ8BAf8EBAMCAYYwQAYDVR0fBDkwNzA1oDOgMYYvaHR0cHM6Ly9hbmRyb2lk
Lmdvb2dsZWFwaXMuY29tL2F0dGVzdGF0aW9uL2NybC8wDQYJKoZIhvcNAQELBQAD
ggIBACDIw41L3KlXG0aMiS//cqrG+EShHUGo8HNsw30W1kJtjn6UBwRM6jnmiwfB
Pb8VA91chb2vssAtX2zbTvqBJ9+LBPGCdw/E53Rbf86qhxKaiAHOjpvAy5Y3m00m
qC0w/Zwvju1twb4vhLaJ5NkUJYsUS7rmJKHHBnETLi8GFqiEsqTWpG/6ibYCv7rY
DBJDcR9W62BW9jfIoBQcxUCUJouMPH25lLNcDc1ssqvC2v7iUgI9LeoM1sNovqPm
QUiG9rHli1vXxzCyaMTjwftkJLkf6724DFhuKug2jITV0QkXvaJWF4nUaHOTNA4u
JU9WDvZLI1j83A+/xnAJUucIv/zGJ1AMH2boHqF8CY16LpsYgBt6tKxxWH00XcyD
CdW2KlBCeqbQPcsFmWyWugxdcekhYsAWyoSf818NUsZdBWBaR/OukXrNLfkQ79Iy
ZohZbvabO/X+MVT3rriAoKc8oE2Uws6DF+60PV7/WIPjNvXySdqspImSN78mflxD
qwLqRBYkA3I75qppLGG9rp7UCdRjxMl8ZDBld+7yvHVgt1cVzJx9xnyGCC23Uaic
MDSXYrB4I4WHXPGjxhZuCuPBLTdOLU8YRvMYdEvYebWHMpvwGCF6bAx3JBpIeOQ1
wDB5y0USicV3YgYGmi+NZfhA4URSh77Yd6uuJOJENRaNVTzk
-----END CERTIFICATE-----
  
-----BEGIN CERTIFICATE-----
MIIFHDCCAwSgAwIBAgIJANUP8luj8tazMA0GCSqGSIb3DQEBCwUAMBsxGTAXBgNV
BAUTEGY5MjAwOWU4NTNiNmIwNDUwHhcNMTkxMTIyMjAzNzU4WhcNMzQxMTE4MjAz
NzU4WjAbMRkwFwYDVQQFExBmOTIwMDllODUzYjZiMDQ1MIICIjANBgkqhkiG9w0B
AQEFAAOCAg8AMIICCgKCAgEAr7bHgiuxpwHsK7Qui8xUFmOr75gvMsd/dTEDDJdS
Sxtf6An7xyqpRR90PL2abxM1dEqlXnf2tqw1Ne4Xwl5jlRfdnJLmN0pTy/4lj4/7
tv0Sk3iiKkypnEUtR6WfMgH0QZfKHM1+di+y9TFRtv6y//0rb+T+W8a9nsNL/ggj
nar86461qO0rOs2cXjp3kOG1FEJ5MVmFmBGtnrKpa73XpXyTqRxB/M0n1n/W9nGq
C4FSYa04T6N5RIZGBN2z2MT5IKGbFlbC8UrW0DxW7AYImQQcHtGl/m00QLVWutHQ
oVJYnFPlXTcHYvASLu+RhhsbDmxMgJJ0mcDpvsC4PjvB+TxywElgS70vE0XmLD+O
JtvsBslHZvPBKCOdT0MS+tgSOIfga+z1Z1g7+DVagf7quvmag8jfPioyKvxnK/Eg
sTUVi2ghzq8wm27ud/mIM7AY2qEORR8Go3TVB4HzWQgpZrt3i5MIlCaY504LzSRi
igHCzAPlHws+W0rB5N+er5/2pJKnfBSDiCiFAVtCLOZ7gLiMm0jhO2B6tUXHI/+M
RPjy02i59lINMRRev56GKtcd9qO/0kUJWdZTdA2XoS82ixPvZtXQpUpuL12ab+9E
aDK8Z4RHJYYfCT3Q5vNAXaiWQ+8PTWm2QgBR/bkwSWc+NpUFgNPN9PvQi8WEg5Um
AGMCAwEAAaNjMGEwHQYDVR0OBBYEFDZh4QB8iAUJUYtEbEf/GkzJ6k8SMB8GA1Ud
IwQYMBaAFDZh4QB8iAUJUYtEbEf/GkzJ6k8SMA8GA1UdEwEB/wQFMAMBAf8wDgYD
VR0PAQH/BAQDAgIEMA0GCSqGSIb3DQEBCwUAA4ICAQBOMaBc8oumXb2voc7XCWnu
XKhBBK3e2KMGz39t7lA3XXRe2ZLLAkLM5y3J7tURkf5a1SutfdOyXAmeE6SRo83U
h6WszodmMkxK5GM4JGrnt4pBisu5igXEydaW7qq2CdC6DOGjG+mEkN8/TA6p3cno
L/sPyz6evdjLlSeJ8rFBH6xWyIZCbrcpYEJzXaUOEaxxXxgYz5/cTiVKN2M1G2ok
QBUIYSY6bjEL4aUN5cfo7ogP3UvliEo3Eo0YgwuzR2v0KR6C1cZqZJSTnghIC/vA
D32KdNQ+c3N+vl2OTsUVMC1GiWkngNx1OO1+kXW+YTnnTUOtOIswUP/Vqd5SYgAI
mMAfY8U9/iIgkQj6T2W6FsScy94IN9fFhE1UtzmLoBIuUFsVXJMTz+Jucth+IqoW
Fua9v1R93/k98p41pjtFX+H8DslVgfP097vju4KDlqN64xV1grw3ZLl4CiOe/A91
oeLm2UHOq6wn3esB4r2EIQKb6jTVGu5sYCcdWpXr0AUVqcABPdgL+H7qJguBw09o
jm6xNIrw2OocrDKsudk/okr/AwqEyPKw9WnMlQgLIKw1rODG2NvU9oR3GVGdMkUB
ZutL8VuFkERQGt6vQ2OCw0sV47VMkuYbacK/xyZFiRcrPJPb41zgbQj9XAEyLKCH
ex0SdDrx+tWUDqG8At2JHA==
-----END CERTIFICATE-----
  
-----BEGIN CERTIFICATE-----
MIIFHDCCAwSgAwIBAgIJAMNrfES5rhgxMA0GCSqGSIb3DQEBCwUAMBsxGTAXBgNV
BAUTEGY5MjAwOWU4NTNiNmIwNDUwHhcNMjExMTE3MjMxMDQyWhcNMzYxMTEzMjMx
MDQyWjAbMRkwFwYDVQQFExBmOTIwMDllODUzYjZiMDQ1MIICIjANBgkqhkiG9w0B
AQEFAAOCAg8AMIICCgKCAgEAr7bHgiuxpwHsK7Qui8xUFmOr75gvMsd/dTEDDJdS
Sxtf6An7xyqpRR90PL2abxM1dEqlXnf2tqw1Ne4Xwl5jlRfdnJLmN0pTy/4lj4/7
tv0Sk3iiKkypnEUtR6WfMgH0QZfKHM1+di+y9TFRtv6y//0rb+T+W8a9nsNL/ggj
nar86461qO0rOs2cXjp3kOG1FEJ5MVmFmBGtnrKpa73XpXyTqRxB/M0n1n/W9nGq
C4FSYa04T6N5RIZGBN2z2MT5IKGbFlbC8UrW0DxW7AYImQQcHtGl/m00QLVWutHQ
oVJYnFPlXTcHYvASLu+RhhsbDmxMgJJ0mcDpvsC4PjvB+TxywElgS70vE0XmLD+O
JtvsBslHZvPBKCOdT0MS+tgSOIfga+z1Z1g7+DVagf7quvmag8jfPioyKvxnK/Eg
sTUVi2ghzq8wm27ud/mIM7AY2qEORR8Go3TVB4HzWQgpZrt3i5MIlCaY504LzSRi
igHCzAPlHws+W0rB5N+er5/2pJKnfBSDiCiFAVtCLOZ7gLiMm0jhO2B6tUXHI/+M
RPjy02i59lINMRRev56GKtcd9qO/0kUJWdZTdA2XoS82ixPvZtXQpUpuL12ab+9E
aDK8Z4RHJYYfCT3Q5vNAXaiWQ+8PTWm2QgBR/bkwSWc+NpUFgNPN9PvQi8WEg5Um
AGMCAwEAAaNjMGEwHQYDVR0OBBYEFDZh4QB8iAUJUYtEbEf/GkzJ6k8SMB8GA1Ud
IwQYMBaAFDZh4QB8iAUJUYtEbEf/GkzJ6k8SMA8GA1UdEwEB/wQFMAMBAf8wDgYD
VR0PAQH/BAQDAgIEMA0GCSqGSIb3DQEBCwUAA4ICAQBTNNZe5cuf8oiq+jV0itTG
zWVhSTjOBEk2FQvh11J3o3lna0o7rd8RFHnN00q4hi6TapFhh4qaw/iG6Xg+xOan
63niLWIC5GOPFgPeYXM9+nBb3zZzC8ABypYuCusWCmt6Tn3+Pjbz3MTVhRGXuT/T
QH4KGFY4PhvzAyXwdjTOCXID+aHud4RLcSySr0Fq/L+R8TWalvM1wJJPhyRjqRCJ
erGtfBagiALzvhnmY7U1qFcS0NCnKjoO7oFedKdWlZz0YAfu3aGCJd4KHT0MsGiL
Zez9WP81xYSrKMNEsDK+zK5fVzw6jA7cxmpXcARTnmAuGUeI7VVDhDzKeVOctf3a
0qQLwC+d0+xrETZ4r2fRGNw2YEs2W8Qj6oDcfPvq9JySe7pJ6wcHnl5EZ0lwc4xH
7Y4Dx9RA1JlfooLMw3tOdJZH0enxPXaydfAD3YifeZpFaUzicHeLzVJLt9dvGB0b
HQLE4+EqKFgOZv2EoP686DQqbVS1u+9k0p2xbMA105TBIk7npraa8VM0fnrRKi7w
lZKwdH+aNAyhbXRW9xsnODJ+g8eF452zvbiKKngEKirK5LGieoXBX7tZ9D1GNBH2
Ob3bKOwwIWdEFle/YF/h6zWgdeoaNGDqVBrLr2+0DtWoiB1aDEjLWl9FmyIUyUm7
mD/vFDkzF+wm7cyWpQpCVQ==
-----END CERTIFICATE-----
  

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

  1. Ваш ключ находится на аппаратном обеспечении, которое Google считает безопасным.
  2. У него есть свойства, описанные в сертификате аттестации.

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

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

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

Отказ от заводских ключей: удаленная инициализация ключей (RKP)

На устройствах, выпущенных с Android 16, система поддерживает только RKP. Это правило постепенно отменяет заводские ключи. Это улучшает процесс инициализации ключей аттестации и управления ими, расширяя правила Android 15, в которых поддержка RKP была необязательной. RKP предотвращает утечку ключей, поскольку система не программирует ключи непосредственно на устройстве. Удалить эти ключи с устройства нельзя. Если вам нужно отозвать ключ, вы можете сделать это для одного устройства.

Библиотеки для проверки подтверждения

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

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

Ключи подтверждения могут быть отозваны по ряду причин, включая неправильное обращение или подозрение на извлечение злоумышленником. Поэтому крайне важно проверять статус каждого сертификата в цепочке аттестации по официальному списку отзыва сертификатов (CRL). Этот список поддерживается Google и опубликован на странице https://android.googleapis.com/attestation/status. Заголовок Cache-Control в HTTP-ответе определяет, как часто нужно проверять наличие обновлений, чтобы не отправлять сетевой запрос для каждого проверяемого сертификата. Этот URL возвращает файл JSON, содержащий статус отзыва для всех сертификатов, которые не имеют нормального действительного статуса. Формат файла JSON соответствует следующему определению JSON Schema draft 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's X.509 serialNumber integer formatted as a lowercase hexadecimal string with leading zeros stripped.",
      "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
}

Пример 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"
    }
  }
}

Просроченные заводские ключи: по-прежнему надежные

Устройства, выпущенные до 2021 года, имеют ключи аттестации с истекшим сроком действия сертификатов. Эти ключи по-прежнему считаются надежными, если они не указаны в списке отзыва сертификатов. Рекомендуем по-прежнему доверять сертификатам, связанным с корневым сертификатом с субъектом SERIALNUMBER=f92009e853b6b045, независимо от периода действия сертификата. Однако важно, чтобы период действия сертификатов удаленной инициализации ключей (RKP) по-прежнему проверялся. Более короткий срок действия сертификатов RKP – важная часть модели угроз, которая позволяет быстрее реагировать на взломы. Библиотека Kotlin для проверки аттестации ключей корректно обрабатывает срок действия во всех случаях.

Правила отзыва сертификатов

Аттестация – это основа борьбы со злоупотреблениями и доверия в экосистеме Android. Она предоставляет сторонним сервисам криптографически подтвержденные данные о состоянии загрузки устройства.

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

В каких случаях можно отозвать согласие?

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

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

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

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

Схема данных расширения с информацией о подготовке