blob: f78d98b9e0782c7aa47692065ea7e9c2a58da5d7 [file] [log] [blame]
Janis Danisevskis1af91262020-08-10 14:58:08 -07001// Copyright 2020, The Android Open Source Project
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7// http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
Janis Danisevskis1af91262020-08-10 14:58:08 -070015//! This crate implements the IKeystoreSecurityLevel interface.
16
Janis Danisevskis2ee014b2021-05-05 14:29:08 -070017use crate::attestation_key_utils::{get_attest_key_info, AttestationKeyInfo};
Pavel Grafovf45034a2021-05-12 22:35:45 +010018use crate::audit_log::{
19 log_key_deleted, log_key_generated, log_key_imported, log_key_integrity_violation,
20};
Janis Danisevskis2ee014b2021-05-05 14:29:08 -070021use crate::database::{CertificateInfo, KeyIdGuard};
22use crate::error::{self, map_km_error, map_or_log_err, Error, ErrorCode};
23use crate::globals::{DB, ENFORCEMENTS, LEGACY_MIGRATOR, SUPER_KEY};
24use crate::key_parameter::KeyParameter as KsKeyParam;
25use crate::key_parameter::KeyParameterValue as KsKeyParamValue;
26use crate::metrics::log_key_creation_event_stats;
27use crate::remote_provisioning::RemProvState;
28use crate::super_key::{KeyBlob, SuperKeyManager};
29use crate::utils::{
30 check_device_attestation_permissions, check_key_permission, is_device_id_attestation_tag,
31 key_characteristics_to_internal, uid_to_android_user, watchdog as wd, Asp,
32};
33use crate::{
34 database::{
35 BlobMetaData, BlobMetaEntry, DateTime, KeyEntry, KeyEntryLoadBits, KeyMetaData,
36 KeyMetaEntry, KeyType, SubComponentType, Uuid,
37 },
38 operation::KeystoreOperation,
39 operation::LoggingInfo,
40 operation::OperationDb,
41 permission::KeyPerm,
42};
Janis Danisevskis5cb52dc2021-04-07 16:31:18 -070043use crate::{globals::get_keymint_device, id_rotation::IdRotationState};
Shawn Willden708744a2020-12-11 13:05:27 +000044use android_hardware_security_keymint::aidl::android::hardware::security::keymint::{
Janis Danisevskis3541f3e2021-03-20 14:18:52 -070045 Algorithm::Algorithm, AttestationKey::AttestationKey,
Shawn Willden8fde4c22021-02-14 13:58:22 -070046 HardwareAuthenticatorType::HardwareAuthenticatorType, IKeyMintDevice::IKeyMintDevice,
47 KeyCreationResult::KeyCreationResult, KeyFormat::KeyFormat,
Max Bires8e93d2b2021-01-14 13:17:59 -080048 KeyMintHardwareInfo::KeyMintHardwareInfo, KeyParameter::KeyParameter,
49 KeyParameterValue::KeyParameterValue, SecurityLevel::SecurityLevel, Tag::Tag,
Janis Danisevskis1af91262020-08-10 14:58:08 -070050};
Andrew Walbrande45c8b2021-04-13 14:42:38 +000051use android_hardware_security_keymint::binder::{BinderFeatures, Strong, ThreadState};
Janis Danisevskis1af91262020-08-10 14:58:08 -070052use android_system_keystore2::aidl::android::system::keystore2::{
Janis Danisevskisa53c9cf2020-10-26 11:52:33 -070053 AuthenticatorSpec::AuthenticatorSpec, CreateOperationResponse::CreateOperationResponse,
Janis Danisevskisb2434d02021-04-20 12:49:27 -070054 Domain::Domain, EphemeralStorageKeyResponse::EphemeralStorageKeyResponse,
55 IKeystoreOperation::IKeystoreOperation, IKeystoreSecurityLevel::BnKeystoreSecurityLevel,
Janis Danisevskis1af91262020-08-10 14:58:08 -070056 IKeystoreSecurityLevel::IKeystoreSecurityLevel, KeyDescriptor::KeyDescriptor,
Janis Danisevskis5ed8c532021-01-11 14:19:42 -080057 KeyMetadata::KeyMetadata, KeyParameters::KeyParameters,
Janis Danisevskis1af91262020-08-10 14:58:08 -070058};
Janis Danisevskis212c68b2021-01-14 22:29:28 -080059use anyhow::{anyhow, Context, Result};
Janis Danisevskis1af91262020-08-10 14:58:08 -070060
61/// Implementation of the IKeystoreSecurityLevel Interface.
62pub struct KeystoreSecurityLevel {
63 security_level: SecurityLevel,
64 keymint: Asp,
Max Bires8e93d2b2021-01-14 13:17:59 -080065 hw_info: KeyMintHardwareInfo,
66 km_uuid: Uuid,
Janis Danisevskis1af91262020-08-10 14:58:08 -070067 operation_db: OperationDb,
Max Bires97f96812021-02-23 23:44:57 -080068 rem_prov_state: RemProvState,
Janis Danisevskis5cb52dc2021-04-07 16:31:18 -070069 id_rotation_state: IdRotationState,
Janis Danisevskis1af91262020-08-10 14:58:08 -070070}
71
Janis Danisevskis1af91262020-08-10 14:58:08 -070072// Blob of 32 zeroes used as empty masking key.
73static ZERO_BLOB_32: &[u8] = &[0; 32];
74
Janis Danisevskis2c084012021-01-31 22:23:17 -080075// Per RFC 5280 4.1.2.5, an undefined expiration (not-after) field should be set to GeneralizedTime
76// 999912312359559, which is 253402300799000 ms from Jan 1, 1970.
77const UNDEFINED_NOT_AFTER: i64 = 253402300799000i64;
78
Janis Danisevskis1af91262020-08-10 14:58:08 -070079impl KeystoreSecurityLevel {
80 /// Creates a new security level instance wrapped in a
Andrew Walbrande45c8b2021-04-13 14:42:38 +000081 /// BnKeystoreSecurityLevel proxy object. It also enables
82 /// `BinderFeatures::set_requesting_sid` on the new interface, because
Janis Danisevskis1af91262020-08-10 14:58:08 -070083 /// we need it for checking keystore permissions.
84 pub fn new_native_binder(
85 security_level: SecurityLevel,
Janis Danisevskis5cb52dc2021-04-07 16:31:18 -070086 id_rotation_state: IdRotationState,
Stephen Crane221bbb52020-12-16 15:52:10 -080087 ) -> Result<(Strong<dyn IKeystoreSecurityLevel>, Uuid)> {
Max Bires8e93d2b2021-01-14 13:17:59 -080088 let (dev, hw_info, km_uuid) = get_keymint_device(&security_level)
89 .context("In KeystoreSecurityLevel::new_native_binder.")?;
Andrew Walbrande45c8b2021-04-13 14:42:38 +000090 let result = BnKeystoreSecurityLevel::new_binder(
91 Self {
92 security_level,
93 keymint: dev,
94 hw_info,
95 km_uuid,
96 operation_db: OperationDb::new(),
97 rem_prov_state: RemProvState::new(security_level, km_uuid),
98 id_rotation_state,
99 },
100 BinderFeatures { set_requesting_sid: true, ..BinderFeatures::default() },
101 );
Max Bires8e93d2b2021-01-14 13:17:59 -0800102 Ok((result, km_uuid))
Janis Danisevskis1af91262020-08-10 14:58:08 -0700103 }
104
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700105 fn watch_millis(&self, id: &'static str, millis: u64) -> Option<wd::WatchPoint> {
106 let sec_level = self.security_level;
107 wd::watch_millis_with(id, millis, move || format!("SecurityLevel {:?}", sec_level))
108 }
109
Janis Danisevskis1af91262020-08-10 14:58:08 -0700110 fn store_new_key(
111 &self,
112 key: KeyDescriptor,
Shawn Willdendbdac602021-01-12 22:35:16 -0700113 creation_result: KeyCreationResult,
Hasini Gunasinghea020b532021-01-07 21:42:35 +0000114 user_id: u32,
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000115 flags: Option<i32>,
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700116 ) -> Result<KeyMetadata> {
Shawn Willdendbdac602021-01-12 22:35:16 -0700117 let KeyCreationResult {
118 keyBlob: key_blob,
119 keyCharacteristics: key_characteristics,
120 certificateChain: mut certificate_chain,
121 } = creation_result;
Janis Danisevskis1af91262020-08-10 14:58:08 -0700122
Max Bires8e93d2b2021-01-14 13:17:59 -0800123 let mut cert_info: CertificateInfo = CertificateInfo::new(
Shawn Willdendbdac602021-01-12 22:35:16 -0700124 match certificate_chain.len() {
125 0 => None,
126 _ => Some(certificate_chain.remove(0).encodedCertificate),
127 },
128 match certificate_chain.len() {
129 0 => None,
130 _ => Some(
131 certificate_chain
132 .iter()
133 .map(|c| c.encodedCertificate.iter())
134 .flatten()
135 .copied()
136 .collect(),
137 ),
138 },
139 );
140
Hasini Gunasinghea020b532021-01-07 21:42:35 +0000141 let mut key_parameters = key_characteristics_to_internal(key_characteristics);
142
143 key_parameters.push(KsKeyParam::new(
144 KsKeyParamValue::UserID(user_id as i32),
145 SecurityLevel::SOFTWARE,
146 ));
Janis Danisevskis04b02832020-10-26 09:21:40 -0700147
Janis Danisevskisb42fc182020-12-15 08:41:27 -0800148 let creation_date = DateTime::now().context("Trying to make creation time.")?;
149
Janis Danisevskis1af91262020-08-10 14:58:08 -0700150 let key = match key.domain {
Satya Tangirala60671e32021-03-04 16:12:19 -0800151 Domain::BLOB => KeyDescriptor {
152 domain: Domain::BLOB,
153 blob: Some(key_blob.to_vec()),
154 ..Default::default()
155 },
Janis Danisevskis1af91262020-08-10 14:58:08 -0700156 _ => DB
Janis Danisevskis93927dd2020-12-23 12:23:08 -0800157 .with::<_, Result<KeyDescriptor>>(|db| {
Satya Tangirala60671e32021-03-04 16:12:19 -0800158 let mut db = db.borrow_mut();
159
160 let (key_blob, mut blob_metadata) = SUPER_KEY
161 .handle_super_encryption_on_key_init(
162 &mut db,
163 &LEGACY_MIGRATOR,
164 &(key.domain),
165 &key_parameters,
166 flags,
167 user_id,
168 &key_blob,
169 )
170 .context("In store_new_key. Failed to handle super encryption.")?;
171
Janis Danisevskis7e8b4622021-02-13 10:01:59 -0800172 let mut key_metadata = KeyMetaData::new();
173 key_metadata.add(KeyMetaEntry::CreationDate(creation_date));
Janis Danisevskis7e8b4622021-02-13 10:01:59 -0800174 blob_metadata.add(BlobMetaEntry::KmUuid(self.km_uuid));
Janis Danisevskis93927dd2020-12-23 12:23:08 -0800175
Janis Danisevskis7e8b4622021-02-13 10:01:59 -0800176 let key_id = db
Janis Danisevskis93927dd2020-12-23 12:23:08 -0800177 .store_new_key(
Janis Danisevskis66784c42021-01-27 08:40:25 -0800178 &key,
Janis Danisevskis0cabd712021-05-25 11:07:10 -0700179 KeyType::Client,
Janis Danisevskis93927dd2020-12-23 12:23:08 -0800180 &key_parameters,
Janis Danisevskis7e8b4622021-02-13 10:01:59 -0800181 &(&key_blob, &blob_metadata),
Max Bires8e93d2b2021-01-14 13:17:59 -0800182 &cert_info,
Janis Danisevskis7e8b4622021-02-13 10:01:59 -0800183 &key_metadata,
Max Bires8e93d2b2021-01-14 13:17:59 -0800184 &self.km_uuid,
Janis Danisevskis93927dd2020-12-23 12:23:08 -0800185 )
186 .context("In store_new_key.")?;
Janis Danisevskis1af91262020-08-10 14:58:08 -0700187 Ok(KeyDescriptor {
188 domain: Domain::KEY_ID,
Janis Danisevskisaec14592020-11-12 09:41:49 -0800189 nspace: key_id.id(),
Janis Danisevskis1af91262020-08-10 14:58:08 -0700190 ..Default::default()
191 })
192 })
193 .context("In store_new_key.")?,
194 };
195
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700196 Ok(KeyMetadata {
197 key,
Janis Danisevskisa53c9cf2020-10-26 11:52:33 -0700198 keySecurityLevel: self.security_level,
Max Bires8e93d2b2021-01-14 13:17:59 -0800199 certificate: cert_info.take_cert(),
200 certificateChain: cert_info.take_cert_chain(),
Janis Danisevskis04b02832020-10-26 09:21:40 -0700201 authorizations: crate::utils::key_parameters_to_authorizations(key_parameters),
Janis Danisevskisb42fc182020-12-15 08:41:27 -0800202 modificationTimeMs: creation_date.to_millis_epoch(),
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700203 })
Janis Danisevskis1af91262020-08-10 14:58:08 -0700204 }
205
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700206 fn create_operation(
Janis Danisevskis1af91262020-08-10 14:58:08 -0700207 &self,
208 key: &KeyDescriptor,
209 operation_parameters: &[KeyParameter],
210 forced: bool,
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700211 ) -> Result<CreateOperationResponse> {
Janis Danisevskis1af91262020-08-10 14:58:08 -0700212 let caller_uid = ThreadState::get_calling_uid();
213 // We use `scoping_blob` to extend the life cycle of the blob loaded from the database,
214 // so that we can use it by reference like the blob provided by the key descriptor.
215 // Otherwise, we would have to clone the blob from the key descriptor.
216 let scoping_blob: Vec<u8>;
Janis Danisevskis7e8b4622021-02-13 10:01:59 -0800217 let (km_blob, key_properties, key_id_guard, blob_metadata) = match key.domain {
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700218 Domain::BLOB => {
219 check_key_permission(KeyPerm::use_(), key, &None)
220 .context("In create_operation: checking use permission for Domain::BLOB.")?;
Janis Danisevskis186d9f42021-03-03 14:40:52 -0800221 if forced {
222 check_key_permission(KeyPerm::req_forced_op(), key, &None).context(
223 "In create_operation: checking forced permission for Domain::BLOB.",
224 )?;
225 }
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700226 (
227 match &key.blob {
Janis Danisevskis1af91262020-08-10 14:58:08 -0700228 Some(blob) => blob,
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700229 None => {
230 return Err(Error::sys()).context(concat!(
231 "In create_operation: Key blob must be specified when",
232 " using Domain::BLOB."
233 ))
234 }
235 },
236 None,
Hasini Gunasinghe888dd352020-11-17 23:08:39 +0000237 None,
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000238 BlobMetaData::new(),
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700239 )
240 }
241 _ => {
Janis Danisevskisaec14592020-11-12 09:41:49 -0800242 let (key_id_guard, mut key_entry) = DB
243 .with::<_, Result<(KeyIdGuard, KeyEntry)>>(|db| {
Hasini Gunasinghe3ed5da72021-02-04 15:18:54 +0000244 LEGACY_MIGRATOR.with_try_migrate(&key, caller_uid, || {
245 db.borrow_mut().load_key_entry(
246 &key,
247 KeyType::Client,
248 KeyEntryLoadBits::KM,
249 caller_uid,
Janis Danisevskis186d9f42021-03-03 14:40:52 -0800250 |k, av| {
251 check_key_permission(KeyPerm::use_(), k, &av)?;
252 if forced {
253 check_key_permission(KeyPerm::req_forced_op(), k, &av)?;
254 }
255 Ok(())
256 },
Hasini Gunasinghe3ed5da72021-02-04 15:18:54 +0000257 )
258 })
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700259 })
260 .context("In create_operation: Failed to load key blob.")?;
Janis Danisevskis7e8b4622021-02-13 10:01:59 -0800261
262 let (blob, blob_metadata) =
263 key_entry.take_key_blob_info().ok_or_else(Error::sys).context(concat!(
264 "In create_operation: Successfully loaded key entry, ",
265 "but KM blob was missing."
266 ))?;
267 scoping_blob = blob;
268
Qi Wub9433b52020-12-01 14:52:46 +0800269 (
270 &scoping_blob,
271 Some((key_id_guard.id(), key_entry.into_key_parameters())),
272 Some(key_id_guard),
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000273 blob_metadata,
Qi Wub9433b52020-12-01 14:52:46 +0800274 )
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700275 }
276 };
Janis Danisevskis1af91262020-08-10 14:58:08 -0700277
Janis Danisevskisa53c9cf2020-10-26 11:52:33 -0700278 let purpose = operation_parameters.iter().find(|p| p.tag == Tag::PURPOSE).map_or(
Janis Danisevskis1af91262020-08-10 14:58:08 -0700279 Err(Error::Km(ErrorCode::INVALID_ARGUMENT))
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700280 .context("In create_operation: No operation purpose specified."),
Janis Danisevskis398e6be2020-12-17 09:29:25 -0800281 |kp| match kp.value {
282 KeyParameterValue::KeyPurpose(p) => Ok(p),
283 _ => Err(Error::Km(ErrorCode::INVALID_ARGUMENT))
284 .context("In create_operation: Malformed KeyParameter."),
285 },
Janis Danisevskis1af91262020-08-10 14:58:08 -0700286 )?;
287
Satya Tangirala2642ff92021-04-15 01:57:00 -0700288 // Remove Tag::PURPOSE from the operation_parameters, since some keymaster devices return
289 // an error on begin() if Tag::PURPOSE is in the operation_parameters.
290 let op_params: Vec<KeyParameter> =
291 operation_parameters.iter().filter(|p| p.tag != Tag::PURPOSE).cloned().collect();
292 let operation_parameters = op_params.as_slice();
293
Janis Danisevskis5ed8c532021-01-11 14:19:42 -0800294 let (immediate_hat, mut auth_info) = ENFORCEMENTS
295 .authorize_create(
296 purpose,
Qi Wub9433b52020-12-01 14:52:46 +0800297 key_properties.as_ref(),
298 operation_parameters.as_ref(),
Janis Danisevskise3f7d202021-03-20 14:21:22 -0700299 self.hw_info.timestampTokenRequired,
Janis Danisevskis5ed8c532021-01-11 14:19:42 -0800300 )
301 .context("In create_operation.")?;
Hasini Gunasinghe888dd352020-11-17 23:08:39 +0000302
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000303 let km_blob = SUPER_KEY
304 .unwrap_key_if_required(&blob_metadata, km_blob)
305 .context("In create_operation. Failed to handle super encryption.")?;
306
Stephen Crane221bbb52020-12-16 15:52:10 -0800307 let km_dev: Strong<dyn IKeyMintDevice> = self
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700308 .keymint
309 .get_interface()
310 .context("In create_operation: Failed to get KeyMint device")?;
Janis Danisevskis1af91262020-08-10 14:58:08 -0700311
Janis Danisevskisaec14592020-11-12 09:41:49 -0800312 let (begin_result, upgraded_blob) = self
313 .upgrade_keyblob_if_required_with(
314 &*km_dev,
315 key_id_guard,
Paul Crowley7a658392021-03-18 17:08:20 -0700316 &km_blob,
317 &blob_metadata,
Janis Danisevskisa53c9cf2020-10-26 11:52:33 -0700318 &operation_parameters,
Janis Danisevskisaec14592020-11-12 09:41:49 -0800319 |blob| loop {
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700320 match map_km_error({
321 let _wp = self.watch_millis(
322 "In KeystoreSecurityLevel::create_operation: calling begin",
323 500,
324 );
325 km_dev.begin(purpose, blob, &operation_parameters, immediate_hat.as_ref())
326 }) {
Janis Danisevskisaec14592020-11-12 09:41:49 -0800327 Err(Error::Km(ErrorCode::TOO_MANY_OPERATIONS)) => {
Janis Danisevskis186d9f42021-03-03 14:40:52 -0800328 self.operation_db.prune(caller_uid, forced)?;
Janis Danisevskisaec14592020-11-12 09:41:49 -0800329 continue;
Janis Danisevskis1af91262020-08-10 14:58:08 -0700330 }
Pavel Grafovf45034a2021-05-12 22:35:45 +0100331 v @ Err(Error::Km(ErrorCode::INVALID_KEY_BLOB)) => {
332 if let Some((key_id, _)) = key_properties {
333 if let Ok(Some(key)) =
334 DB.with(|db| db.borrow_mut().load_key_descriptor(key_id))
335 {
336 log_key_integrity_violation(&key);
337 } else {
338 log::error!("Failed to load key descriptor for audit log");
339 }
340 }
341 return v;
342 }
Janis Danisevskisaec14592020-11-12 09:41:49 -0800343 v => return v,
344 }
345 },
346 )
347 .context("In create_operation: Failed to begin operation.")?;
Janis Danisevskis1af91262020-08-10 14:58:08 -0700348
Janis Danisevskis5ed8c532021-01-11 14:19:42 -0800349 let operation_challenge = auth_info.finalize_create_authorization(begin_result.challenge);
Hasini Gunasinghe888dd352020-11-17 23:08:39 +0000350
Hasini Gunasinghe0aba68a2021-03-19 00:43:52 +0000351 let op_params: Vec<KeyParameter> = operation_parameters.to_vec();
352
Janis Danisevskis1af91262020-08-10 14:58:08 -0700353 let operation = match begin_result.operation {
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700354 Some(km_op) => self.operation_db.create_operation(
355 km_op,
356 caller_uid,
357 auth_info,
358 forced,
359 LoggingInfo::new(self.security_level, purpose, op_params, upgraded_blob.is_some()),
360 ),
361 None => {
362 return Err(Error::sys()).context(concat!(
363 "In create_operation: Begin operation returned successfully, ",
364 "but did not return a valid operation."
365 ))
366 }
Janis Danisevskis1af91262020-08-10 14:58:08 -0700367 };
368
Stephen Crane221bbb52020-12-16 15:52:10 -0800369 let op_binder: binder::public_api::Strong<dyn IKeystoreOperation> =
Janis Danisevskis1af91262020-08-10 14:58:08 -0700370 KeystoreOperation::new_native_binder(operation)
371 .as_binder()
372 .into_interface()
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700373 .context("In create_operation: Failed to create IKeystoreOperation.")?;
Janis Danisevskis1af91262020-08-10 14:58:08 -0700374
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700375 Ok(CreateOperationResponse {
376 iOperation: Some(op_binder),
Hasini Gunasinghe888dd352020-11-17 23:08:39 +0000377 operationChallenge: operation_challenge,
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700378 parameters: match begin_result.params.len() {
379 0 => None,
Janis Danisevskisa53c9cf2020-10-26 11:52:33 -0700380 _ => Some(KeyParameters { keyParameter: begin_result.params }),
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700381 },
Satya Tangiralae2016a82021-03-05 09:28:30 -0800382 // An upgraded blob should only be returned if the caller has permission
383 // to use Domain::BLOB keys. If we got to this point, we already checked
384 // that the caller had that permission.
385 upgradedBlob: if key.domain == Domain::BLOB { upgraded_blob } else { None },
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700386 })
Janis Danisevskis1af91262020-08-10 14:58:08 -0700387 }
388
Janis Danisevskise766edc2021-02-06 12:16:26 -0800389 fn add_certificate_parameters(
Janis Danisevskis5cb52dc2021-04-07 16:31:18 -0700390 &self,
Janis Danisevskise766edc2021-02-06 12:16:26 -0800391 uid: u32,
392 params: &[KeyParameter],
393 key: &KeyDescriptor,
394 ) -> Result<Vec<KeyParameter>> {
Janis Danisevskis212c68b2021-01-14 22:29:28 -0800395 let mut result = params.to_vec();
Janis Danisevskis2c084012021-01-31 22:23:17 -0800396 // If there is an attestation challenge we need to get an application id.
Janis Danisevskis212c68b2021-01-14 22:29:28 -0800397 if params.iter().any(|kp| kp.tag == Tag::ATTESTATION_CHALLENGE) {
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700398 let aaid = {
399 let _wp = self.watch_millis(
400 "In KeystoreSecurityLevel::add_certificate_parameters calling: get_aaid",
401 500,
402 );
403 keystore2_aaid::get_aaid(uid).map_err(|e| {
404 anyhow!(format!(
405 "In add_certificate_parameters: get_aaid returned status {}.",
406 e
407 ))
408 })
409 }?;
410
Janis Danisevskis212c68b2021-01-14 22:29:28 -0800411 result.push(KeyParameter {
412 tag: Tag::ATTESTATION_APPLICATION_ID,
413 value: KeyParameterValue::Blob(aaid),
414 });
415 }
Janis Danisevskis2c084012021-01-31 22:23:17 -0800416
Janis Danisevskise766edc2021-02-06 12:16:26 -0800417 if params.iter().any(|kp| kp.tag == Tag::INCLUDE_UNIQUE_ID) {
418 check_key_permission(KeyPerm::gen_unique_id(), key, &None).context(concat!(
419 "In add_certificate_parameters: ",
Janis Danisevskis83116e52021-04-06 13:36:58 -0700420 "Caller does not have the permission to generate a unique ID"
Janis Danisevskise766edc2021-02-06 12:16:26 -0800421 ))?;
Janis Danisevskis5cb52dc2021-04-07 16:31:18 -0700422 if self.id_rotation_state.had_factory_reset_since_id_rotation().context(
423 "In add_certificate_parameters: Call to had_factory_reset_since_id_rotation failed."
424 )? {
425 result.push(KeyParameter{
426 tag: Tag::RESET_SINCE_ID_ROTATION,
427 value: KeyParameterValue::BoolValue(true),
428 })
429 }
Janis Danisevskise766edc2021-02-06 12:16:26 -0800430 }
431
Bram Bonné5d6c5102021-02-24 15:09:18 +0100432 // If the caller requests any device identifier attestation tag, check that they hold the
433 // correct Android permission.
434 if params.iter().any(|kp| is_device_id_attestation_tag(kp.tag)) {
435 check_device_attestation_permissions().context(concat!(
436 "In add_certificate_parameters: ",
437 "Caller does not have the permission to attest device identifiers."
438 ))?;
439 }
440
Janis Danisevskis2c084012021-01-31 22:23:17 -0800441 // If we are generating/importing an asymmetric key, we need to make sure
442 // that NOT_BEFORE and NOT_AFTER are present.
443 match params.iter().find(|kp| kp.tag == Tag::ALGORITHM) {
444 Some(KeyParameter { tag: _, value: KeyParameterValue::Algorithm(Algorithm::RSA) })
445 | Some(KeyParameter { tag: _, value: KeyParameterValue::Algorithm(Algorithm::EC) }) => {
446 if !params.iter().any(|kp| kp.tag == Tag::CERTIFICATE_NOT_BEFORE) {
447 result.push(KeyParameter {
448 tag: Tag::CERTIFICATE_NOT_BEFORE,
449 value: KeyParameterValue::DateTime(0),
450 })
451 }
452 if !params.iter().any(|kp| kp.tag == Tag::CERTIFICATE_NOT_AFTER) {
453 result.push(KeyParameter {
454 tag: Tag::CERTIFICATE_NOT_AFTER,
455 value: KeyParameterValue::DateTime(UNDEFINED_NOT_AFTER),
456 })
457 }
458 }
459 _ => {}
460 }
Janis Danisevskis212c68b2021-01-14 22:29:28 -0800461 Ok(result)
462 }
463
Janis Danisevskis1af91262020-08-10 14:58:08 -0700464 fn generate_key(
465 &self,
466 key: &KeyDescriptor,
Shawn Willden8fde4c22021-02-14 13:58:22 -0700467 attest_key_descriptor: Option<&KeyDescriptor>,
Janis Danisevskis1af91262020-08-10 14:58:08 -0700468 params: &[KeyParameter],
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700469 flags: i32,
Paul Crowleyd5653e52021-03-25 09:46:31 -0700470 _entropy: &[u8],
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700471 ) -> Result<KeyMetadata> {
Janis Danisevskis1af91262020-08-10 14:58:08 -0700472 if key.domain != Domain::BLOB && key.alias.is_none() {
473 return Err(error::Error::Km(ErrorCode::INVALID_ARGUMENT))
474 .context("In generate_key: Alias must be specified");
475 }
Hasini Gunasinghea020b532021-01-07 21:42:35 +0000476 let caller_uid = ThreadState::get_calling_uid();
Janis Danisevskis1af91262020-08-10 14:58:08 -0700477
478 let key = match key.domain {
479 Domain::APP => KeyDescriptor {
480 domain: key.domain,
Hasini Gunasinghea020b532021-01-07 21:42:35 +0000481 nspace: caller_uid as i64,
Janis Danisevskis1af91262020-08-10 14:58:08 -0700482 alias: key.alias.clone(),
483 blob: None,
484 },
485 _ => key.clone(),
486 };
487
488 // generate_key requires the rebind permission.
Janis Danisevskis3541f3e2021-03-20 14:18:52 -0700489 // Must return on error for security reasons.
Janis Danisevskis1af91262020-08-10 14:58:08 -0700490 check_key_permission(KeyPerm::rebind(), &key, &None).context("In generate_key.")?;
Janis Danisevskis3541f3e2021-03-20 14:18:52 -0700491
492 let attestation_key_info = match (key.domain, attest_key_descriptor) {
493 (Domain::BLOB, _) => None,
Satya Tangiralafdb9c762021-03-09 22:34:22 -0800494 _ => DB
Janis Danisevskis3541f3e2021-03-20 14:18:52 -0700495 .with(|db| {
496 get_attest_key_info(
Satya Tangiralafdb9c762021-03-09 22:34:22 -0800497 &key,
498 caller_uid,
499 attest_key_descriptor,
500 params,
Janis Danisevskis3541f3e2021-03-20 14:18:52 -0700501 &self.rem_prov_state,
Satya Tangiralafdb9c762021-03-09 22:34:22 -0800502 &mut db.borrow_mut(),
503 )
504 })
505 .context("In generate_key: Trying to get an attestation key")?,
506 };
Janis Danisevskis5cb52dc2021-04-07 16:31:18 -0700507 let params = self
508 .add_certificate_parameters(caller_uid, params, &key)
Janis Danisevskis212c68b2021-01-14 22:29:28 -0800509 .context("In generate_key: Trying to get aaid.")?;
510
Stephen Crane221bbb52020-12-16 15:52:10 -0800511 let km_dev: Strong<dyn IKeyMintDevice> = self.keymint.get_interface()?;
Janis Danisevskis3541f3e2021-03-20 14:18:52 -0700512
513 let creation_result = match attestation_key_info {
514 Some(AttestationKeyInfo::UserGenerated {
515 key_id_guard,
516 blob,
517 blob_metadata,
518 issuer_subject,
519 }) => self
520 .upgrade_keyblob_if_required_with(
521 &*km_dev,
522 Some(key_id_guard),
Paul Crowley7a658392021-03-18 17:08:20 -0700523 &KeyBlob::Ref(&blob),
524 &blob_metadata,
Janis Danisevskis3541f3e2021-03-20 14:18:52 -0700525 &params,
526 |blob| {
527 let attest_key = Some(AttestationKey {
528 keyBlob: blob.to_vec(),
529 attestKeyParams: vec![],
530 issuerSubjectName: issuer_subject.clone(),
531 });
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700532 map_km_error({
533 let _wp = self.watch_millis(
534 concat!(
535 "In KeystoreSecurityLevel::generate_key (UserGenerated): ",
536 "calling generate_key."
537 ),
538 5000, // Generate can take a little longer.
539 );
540 km_dev.generateKey(&params, attest_key.as_ref())
541 })
Janis Danisevskis3541f3e2021-03-20 14:18:52 -0700542 },
543 )
544 .context("In generate_key: Using user generated attestation key.")
545 .map(|(result, _)| result),
546 Some(AttestationKeyInfo::RemoteProvisioned { attestation_key, attestation_certs }) => {
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700547 map_km_error({
548 let _wp = self.watch_millis(
549 concat!(
550 "In KeystoreSecurityLevel::generate_key (RemoteProvisioned): ",
551 "calling generate_key.",
552 ),
553 5000, // Generate can take a little longer.
554 );
555 km_dev.generateKey(&params, Some(&attestation_key))
556 })
557 .context("While generating Key with remote provisioned attestation key.")
558 .map(|mut creation_result| {
559 creation_result.certificateChain.push(attestation_certs);
560 creation_result
561 })
Janis Danisevskis3541f3e2021-03-20 14:18:52 -0700562 }
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700563 None => map_km_error({
564 let _wp = self.watch_millis(
565 concat!(
566 "In KeystoreSecurityLevel::generate_key (No attestation): ",
567 "calling generate_key.",
568 ),
569 5000, // Generate can take a little longer.
570 );
571 km_dev.generateKey(&params, None)
572 })
573 .context("While generating Key without explicit attestation key."),
Max Bires97f96812021-02-23 23:44:57 -0800574 }
Janis Danisevskis3541f3e2021-03-20 14:18:52 -0700575 .context("In generate_key.")?;
576
Hasini Gunasinghea020b532021-01-07 21:42:35 +0000577 let user_id = uid_to_android_user(caller_uid);
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000578 self.store_new_key(key, creation_result, user_id, Some(flags)).context("In generate_key.")
Janis Danisevskis1af91262020-08-10 14:58:08 -0700579 }
580
581 fn import_key(
582 &self,
583 key: &KeyDescriptor,
Paul Crowleyd5653e52021-03-25 09:46:31 -0700584 _attestation_key: Option<&KeyDescriptor>,
Janis Danisevskis1af91262020-08-10 14:58:08 -0700585 params: &[KeyParameter],
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700586 flags: i32,
Janis Danisevskis1af91262020-08-10 14:58:08 -0700587 key_data: &[u8],
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700588 ) -> Result<KeyMetadata> {
Janis Danisevskis1af91262020-08-10 14:58:08 -0700589 if key.domain != Domain::BLOB && key.alias.is_none() {
590 return Err(error::Error::Km(ErrorCode::INVALID_ARGUMENT))
591 .context("In import_key: Alias must be specified");
592 }
Hasini Gunasinghea020b532021-01-07 21:42:35 +0000593 let caller_uid = ThreadState::get_calling_uid();
Janis Danisevskis1af91262020-08-10 14:58:08 -0700594
595 let key = match key.domain {
596 Domain::APP => KeyDescriptor {
597 domain: key.domain,
Hasini Gunasinghea020b532021-01-07 21:42:35 +0000598 nspace: caller_uid as i64,
Janis Danisevskis1af91262020-08-10 14:58:08 -0700599 alias: key.alias.clone(),
600 blob: None,
601 },
602 _ => key.clone(),
603 };
604
605 // import_key requires the rebind permission.
606 check_key_permission(KeyPerm::rebind(), &key, &None).context("In import_key.")?;
607
Janis Danisevskis5cb52dc2021-04-07 16:31:18 -0700608 let params = self
609 .add_certificate_parameters(caller_uid, params, &key)
Janis Danisevskis212c68b2021-01-14 22:29:28 -0800610 .context("In import_key: Trying to get aaid.")?;
611
Janis Danisevskis1af91262020-08-10 14:58:08 -0700612 let format = params
613 .iter()
Janis Danisevskisa53c9cf2020-10-26 11:52:33 -0700614 .find(|p| p.tag == Tag::ALGORITHM)
Janis Danisevskis1af91262020-08-10 14:58:08 -0700615 .ok_or(error::Error::Km(ErrorCode::INVALID_ARGUMENT))
616 .context("No KeyParameter 'Algorithm'.")
Janis Danisevskis398e6be2020-12-17 09:29:25 -0800617 .and_then(|p| match &p.value {
618 KeyParameterValue::Algorithm(Algorithm::AES)
619 | KeyParameterValue::Algorithm(Algorithm::HMAC)
620 | KeyParameterValue::Algorithm(Algorithm::TRIPLE_DES) => Ok(KeyFormat::RAW),
621 KeyParameterValue::Algorithm(Algorithm::RSA)
622 | KeyParameterValue::Algorithm(Algorithm::EC) => Ok(KeyFormat::PKCS8),
623 v => Err(error::Error::Km(ErrorCode::INVALID_ARGUMENT))
624 .context(format!("Unknown Algorithm {:?}.", v)),
Janis Danisevskis1af91262020-08-10 14:58:08 -0700625 })
626 .context("In import_key.")?;
627
Stephen Crane221bbb52020-12-16 15:52:10 -0800628 let km_dev: Strong<dyn IKeyMintDevice> =
Janis Danisevskis104d8e42021-01-14 22:49:27 -0800629 self.keymint.get_interface().context("In import_key: Trying to get the KM device")?;
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700630 let creation_result = map_km_error({
631 let _wp =
632 self.watch_millis("In KeystoreSecurityLevel::import_key: calling importKey.", 500);
633 km_dev.importKey(&params, format, key_data, None /* attestKey */)
634 })
635 .context("In import_key: Trying to call importKey")?;
Janis Danisevskis1af91262020-08-10 14:58:08 -0700636
Hasini Gunasinghea020b532021-01-07 21:42:35 +0000637 let user_id = uid_to_android_user(caller_uid);
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000638 self.store_new_key(key, creation_result, user_id, Some(flags)).context("In import_key.")
Janis Danisevskis1af91262020-08-10 14:58:08 -0700639 }
640
641 fn import_wrapped_key(
642 &self,
643 key: &KeyDescriptor,
644 wrapping_key: &KeyDescriptor,
645 masking_key: Option<&[u8]>,
646 params: &[KeyParameter],
647 authenticators: &[AuthenticatorSpec],
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700648 ) -> Result<KeyMetadata> {
Janis Danisevskis32adc7d2021-02-07 14:04:01 -0800649 let wrapped_data: &[u8] = match key {
650 KeyDescriptor { domain: Domain::APP, blob: Some(ref blob), alias: Some(_), .. }
651 | KeyDescriptor {
652 domain: Domain::SELINUX, blob: Some(ref blob), alias: Some(_), ..
653 } => blob,
654 _ => {
655 return Err(error::Error::Km(ErrorCode::INVALID_ARGUMENT)).context(format!(
656 concat!(
657 "In import_wrapped_key: Alias and blob must be specified ",
658 "and domain must be APP or SELINUX. {:?}"
659 ),
660 key
661 ))
662 }
663 };
Janis Danisevskis1af91262020-08-10 14:58:08 -0700664
Janis Danisevskisaec14592020-11-12 09:41:49 -0800665 if wrapping_key.domain == Domain::BLOB {
666 return Err(error::Error::Km(ErrorCode::INVALID_ARGUMENT)).context(
667 "In import_wrapped_key: Import wrapped key not supported for self managed blobs.",
668 );
669 }
670
Hasini Gunasinghea020b532021-01-07 21:42:35 +0000671 let caller_uid = ThreadState::get_calling_uid();
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000672 let user_id = uid_to_android_user(caller_uid);
673
Janis Danisevskis1af91262020-08-10 14:58:08 -0700674 let key = match key.domain {
675 Domain::APP => KeyDescriptor {
676 domain: key.domain,
Hasini Gunasinghea020b532021-01-07 21:42:35 +0000677 nspace: caller_uid as i64,
Janis Danisevskis1af91262020-08-10 14:58:08 -0700678 alias: key.alias.clone(),
679 blob: None,
680 },
Janis Danisevskis32adc7d2021-02-07 14:04:01 -0800681 Domain::SELINUX => KeyDescriptor {
682 domain: Domain::SELINUX,
683 nspace: key.nspace,
684 alias: key.alias.clone(),
685 blob: None,
686 },
687 _ => panic!("Unreachable."),
Janis Danisevskis1af91262020-08-10 14:58:08 -0700688 };
689
Janis Danisevskis7e8b4622021-02-13 10:01:59 -0800690 // Import_wrapped_key requires the rebind permission for the new key.
Janis Danisevskis1af91262020-08-10 14:58:08 -0700691 check_key_permission(KeyPerm::rebind(), &key, &None).context("In import_wrapped_key.")?;
692
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000693 let (wrapping_key_id_guard, mut wrapping_key_entry) = DB
Janis Danisevskis1af91262020-08-10 14:58:08 -0700694 .with(|db| {
Hasini Gunasinghe3ed5da72021-02-04 15:18:54 +0000695 LEGACY_MIGRATOR.with_try_migrate(&key, caller_uid, || {
696 db.borrow_mut().load_key_entry(
697 &wrapping_key,
698 KeyType::Client,
699 KeyEntryLoadBits::KM,
700 caller_uid,
701 |k, av| check_key_permission(KeyPerm::use_(), k, &av),
702 )
703 })
Janis Danisevskis1af91262020-08-10 14:58:08 -0700704 })
705 .context("Failed to load wrapping key.")?;
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000706
707 let (wrapping_key_blob, wrapping_blob_metadata) = wrapping_key_entry
708 .take_key_blob_info()
709 .ok_or_else(error::Error::sys)
710 .context("No km_blob after successfully loading key. This should never happen.")?;
711
712 let wrapping_key_blob =
713 SUPER_KEY.unwrap_key_if_required(&wrapping_blob_metadata, &wrapping_key_blob).context(
714 "In import_wrapped_key. Failed to handle super encryption for wrapping key.",
715 )?;
Janis Danisevskis1af91262020-08-10 14:58:08 -0700716
Janis Danisevskis1af91262020-08-10 14:58:08 -0700717 // km_dev.importWrappedKey does not return a certificate chain.
718 // TODO Do we assume that all wrapped keys are symmetric?
719 // let certificate_chain: Vec<KmCertificate> = Default::default();
720
721 let pw_sid = authenticators
722 .iter()
723 .find_map(|a| match a.authenticatorType {
Janis Danisevskisa53c9cf2020-10-26 11:52:33 -0700724 HardwareAuthenticatorType::PASSWORD => Some(a.authenticatorId),
Janis Danisevskis1af91262020-08-10 14:58:08 -0700725 _ => None,
726 })
Janis Danisevskis32adc7d2021-02-07 14:04:01 -0800727 .unwrap_or(-1);
Janis Danisevskis1af91262020-08-10 14:58:08 -0700728
729 let fp_sid = authenticators
730 .iter()
731 .find_map(|a| match a.authenticatorType {
Janis Danisevskisa53c9cf2020-10-26 11:52:33 -0700732 HardwareAuthenticatorType::FINGERPRINT => Some(a.authenticatorId),
Janis Danisevskis1af91262020-08-10 14:58:08 -0700733 _ => None,
734 })
Janis Danisevskis32adc7d2021-02-07 14:04:01 -0800735 .unwrap_or(-1);
Janis Danisevskis1af91262020-08-10 14:58:08 -0700736
737 let masking_key = masking_key.unwrap_or(ZERO_BLOB_32);
738
Stephen Crane221bbb52020-12-16 15:52:10 -0800739 let km_dev: Strong<dyn IKeyMintDevice> = self.keymint.get_interface()?;
Janis Danisevskis104d8e42021-01-14 22:49:27 -0800740 let (creation_result, _) = self
741 .upgrade_keyblob_if_required_with(
742 &*km_dev,
743 Some(wrapping_key_id_guard),
Paul Crowley7a658392021-03-18 17:08:20 -0700744 &wrapping_key_blob,
745 &wrapping_blob_metadata,
Janis Danisevskis104d8e42021-01-14 22:49:27 -0800746 &[],
747 |wrapping_blob| {
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700748 let _wp = self.watch_millis(
749 "In KeystoreSecurityLevel::import_wrapped_key: calling importWrappedKey.",
750 500,
751 );
Janis Danisevskis104d8e42021-01-14 22:49:27 -0800752 let creation_result = map_km_error(km_dev.importWrappedKey(
753 wrapped_data,
Janis Danisevskis7e8b4622021-02-13 10:01:59 -0800754 wrapping_blob,
Janis Danisevskis104d8e42021-01-14 22:49:27 -0800755 masking_key,
756 &params,
757 pw_sid,
758 fp_sid,
759 ))?;
760 Ok(creation_result)
761 },
762 )
763 .context("In import_wrapped_key.")?;
Janis Danisevskis1af91262020-08-10 14:58:08 -0700764
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000765 self.store_new_key(key, creation_result, user_id, None)
Janis Danisevskis104d8e42021-01-14 22:49:27 -0800766 .context("In import_wrapped_key: Trying to store the new key.")
Janis Danisevskis1af91262020-08-10 14:58:08 -0700767 }
Janis Danisevskisaec14592020-11-12 09:41:49 -0800768
Paul Crowley7a658392021-03-18 17:08:20 -0700769 fn store_upgraded_keyblob(
770 key_id_guard: KeyIdGuard,
771 km_uuid: Option<&Uuid>,
772 key_blob: &KeyBlob,
773 upgraded_blob: &[u8],
774 ) -> Result<()> {
775 let (upgraded_blob_to_be_stored, new_blob_metadata) =
776 SuperKeyManager::reencrypt_if_required(key_blob, &upgraded_blob)
777 .context("In store_upgraded_keyblob: Failed to handle super encryption.")?;
778
Paul Crowley44c02da2021-04-08 17:04:43 +0000779 let mut new_blob_metadata = new_blob_metadata.unwrap_or_default();
Paul Crowley7a658392021-03-18 17:08:20 -0700780 if let Some(uuid) = km_uuid {
781 new_blob_metadata.add(BlobMetaEntry::KmUuid(*uuid));
782 }
783
784 DB.with(|db| {
785 let mut db = db.borrow_mut();
786 db.set_blob(
787 &key_id_guard,
788 SubComponentType::KEY_BLOB,
789 Some(&upgraded_blob_to_be_stored),
790 Some(&new_blob_metadata),
791 )
792 })
793 .context("In store_upgraded_keyblob: Failed to insert upgraded blob into the database.")
794 }
795
Janis Danisevskisaec14592020-11-12 09:41:49 -0800796 fn upgrade_keyblob_if_required_with<T, F>(
797 &self,
798 km_dev: &dyn IKeyMintDevice,
799 key_id_guard: Option<KeyIdGuard>,
Paul Crowley7a658392021-03-18 17:08:20 -0700800 key_blob: &KeyBlob,
801 blob_metadata: &BlobMetaData,
Janis Danisevskisaec14592020-11-12 09:41:49 -0800802 params: &[KeyParameter],
803 f: F,
804 ) -> Result<(T, Option<Vec<u8>>)>
805 where
806 F: Fn(&[u8]) -> Result<T, Error>,
807 {
Paul Crowley7a658392021-03-18 17:08:20 -0700808 match f(key_blob) {
Janis Danisevskisaec14592020-11-12 09:41:49 -0800809 Err(Error::Km(ErrorCode::KEY_REQUIRES_UPGRADE)) => {
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700810 let upgraded_blob = {
811 let _wp = self.watch_millis(
812 concat!(
813 "In KeystoreSecurityLevel::upgrade_keyblob_if_required_with: ",
814 "calling upgradeKey."
815 ),
816 500,
817 );
818 map_km_error(km_dev.upgradeKey(key_blob, params))
819 }
820 .context("In upgrade_keyblob_if_required_with: Upgrade failed.")?;
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000821
Paul Crowley7a658392021-03-18 17:08:20 -0700822 if let Some(kid) = key_id_guard {
823 Self::store_upgraded_keyblob(
824 kid,
825 blob_metadata.km_uuid(),
826 key_blob,
827 &upgraded_blob,
828 )
829 .context(
830 "In upgrade_keyblob_if_required_with: store_upgraded_keyblob failed",
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000831 )?;
Hasini Gunasinghedeab85d2021-02-01 21:10:02 +0000832 }
833
Janis Danisevskisaec14592020-11-12 09:41:49 -0800834 match f(&upgraded_blob) {
835 Ok(v) => Ok((v, Some(upgraded_blob))),
836 Err(e) => Err(e).context(concat!(
837 "In upgrade_keyblob_if_required_with: ",
838 "Failed to perform operation on second try."
839 )),
840 }
841 }
Paul Crowley8d5b2532021-03-19 10:53:07 -0700842 result => {
843 if let Some(kid) = key_id_guard {
844 if key_blob.force_reencrypt() {
845 Self::store_upgraded_keyblob(
846 kid,
847 blob_metadata.km_uuid(),
848 key_blob,
849 key_blob,
850 )
851 .context(concat!(
852 "In upgrade_keyblob_if_required_with: ",
853 "store_upgraded_keyblob failed in forced reencrypt"
854 ))?;
855 }
856 }
857 result
858 .map(|v| (v, None))
859 .context("In upgrade_keyblob_if_required_with: Called closure failed.")
860 }
Janis Danisevskisaec14592020-11-12 09:41:49 -0800861 }
862 }
Satya Tangirala3361b612021-03-08 14:36:11 -0800863
Janis Danisevskisb2434d02021-04-20 12:49:27 -0700864 fn convert_storage_key_to_ephemeral(
865 &self,
866 storage_key: &KeyDescriptor,
867 ) -> Result<EphemeralStorageKeyResponse> {
Satya Tangirala3361b612021-03-08 14:36:11 -0800868 if storage_key.domain != Domain::BLOB {
869 return Err(error::Error::Km(ErrorCode::INVALID_ARGUMENT)).context(concat!(
870 "In IKeystoreSecurityLevel convert_storage_key_to_ephemeral: ",
871 "Key must be of Domain::BLOB"
872 ));
873 }
874 let key_blob = storage_key
875 .blob
876 .as_ref()
877 .ok_or(error::Error::Km(ErrorCode::INVALID_ARGUMENT))
878 .context(
879 "In IKeystoreSecurityLevel convert_storage_key_to_ephemeral: No key blob specified",
880 )?;
881
882 // convert_storage_key_to_ephemeral requires the associated permission
883 check_key_permission(KeyPerm::convert_storage_key_to_ephemeral(), storage_key, &None)
884 .context("In convert_storage_key_to_ephemeral: Check permission")?;
885
886 let km_dev: Strong<dyn IKeyMintDevice> = self.keymint.get_interface().context(concat!(
887 "In IKeystoreSecurityLevel convert_storage_key_to_ephemeral: ",
888 "Getting keymint device interface"
889 ))?;
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700890 match {
891 let _wp = self.watch_millis(
892 concat!(
893 "In IKeystoreSecurityLevel::convert_storage_key_to_ephemeral: ",
894 "calling convertStorageKeyToEphemeral (1)"
895 ),
896 500,
897 );
898 map_km_error(km_dev.convertStorageKeyToEphemeral(key_blob))
899 } {
Janis Danisevskisb2434d02021-04-20 12:49:27 -0700900 Ok(result) => {
901 Ok(EphemeralStorageKeyResponse { ephemeralKey: result, upgradedBlob: None })
902 }
903 Err(error::Error::Km(ErrorCode::KEY_REQUIRES_UPGRADE)) => {
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700904 let upgraded_blob = {
905 let _wp = self.watch_millis(
906 "In convert_storage_key_to_ephemeral: calling upgradeKey",
907 500,
908 );
909 map_km_error(km_dev.upgradeKey(key_blob, &[]))
910 }
911 .context("In convert_storage_key_to_ephemeral: Failed to upgrade key blob.")?;
912 let ephemeral_key = {
913 let _wp = self.watch_millis(
914 "In convert_storage_key_to_ephemeral: calling convertStorageKeyToEphemeral (2)",
915 500,
916 );
917 map_km_error(km_dev.convertStorageKeyToEphemeral(key_blob))
918 }
Janis Danisevskisb2434d02021-04-20 12:49:27 -0700919 .context(concat!(
920 "In convert_storage_key_to_ephemeral: ",
921 "Failed to retrieve ephemeral key (after upgrade)."
922 ))?;
923 Ok(EphemeralStorageKeyResponse {
924 ephemeralKey: ephemeral_key,
925 upgradedBlob: Some(upgraded_blob),
926 })
927 }
928 Err(e) => Err(e)
929 .context("In convert_storage_key_to_ephemeral: Failed to retrieve ephemeral key."),
930 }
Satya Tangirala3361b612021-03-08 14:36:11 -0800931 }
Satya Tangirala04bca0d2021-03-08 22:27:54 -0800932
933 fn delete_key(&self, key: &KeyDescriptor) -> Result<()> {
934 if key.domain != Domain::BLOB {
935 return Err(error::Error::Km(ErrorCode::INVALID_ARGUMENT))
936 .context("In IKeystoreSecurityLevel delete_key: Key must be of Domain::BLOB");
937 }
938
939 let key_blob = key
940 .blob
941 .as_ref()
942 .ok_or(error::Error::Km(ErrorCode::INVALID_ARGUMENT))
943 .context("In IKeystoreSecurityLevel delete_key: No key blob specified")?;
944
945 check_key_permission(KeyPerm::delete(), key, &None)
946 .context("In IKeystoreSecurityLevel delete_key: Checking delete permissions")?;
947
948 let km_dev: Strong<dyn IKeyMintDevice> = self
949 .keymint
950 .get_interface()
951 .context("In IKeystoreSecurityLevel delete_key: Getting keymint device interface")?;
Janis Danisevskis2ee014b2021-05-05 14:29:08 -0700952 {
953 let _wp =
954 self.watch_millis("In KeystoreSecuritylevel::delete_key: calling deleteKey", 500);
955 map_km_error(km_dev.deleteKey(&key_blob)).context("In keymint device deleteKey")
956 }
Satya Tangirala04bca0d2021-03-08 22:27:54 -0800957 }
Janis Danisevskis1af91262020-08-10 14:58:08 -0700958}
959
960impl binder::Interface for KeystoreSecurityLevel {}
961
962impl IKeystoreSecurityLevel for KeystoreSecurityLevel {
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700963 fn createOperation(
Janis Danisevskis1af91262020-08-10 14:58:08 -0700964 &self,
965 key: &KeyDescriptor,
966 operation_parameters: &[KeyParameter],
967 forced: bool,
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700968 ) -> binder::public_api::Result<CreateOperationResponse> {
Hasini Gunasinghe5a893e82021-05-05 14:32:32 +0000969 let _wp = self.watch_millis("IKeystoreSecurityLevel::createOperation", 500);
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700970 map_or_log_err(self.create_operation(key, operation_parameters, forced), Ok)
Janis Danisevskis1af91262020-08-10 14:58:08 -0700971 }
972 fn generateKey(
973 &self,
974 key: &KeyDescriptor,
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700975 attestation_key: Option<&KeyDescriptor>,
Janis Danisevskis1af91262020-08-10 14:58:08 -0700976 params: &[KeyParameter],
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700977 flags: i32,
Janis Danisevskis1af91262020-08-10 14:58:08 -0700978 entropy: &[u8],
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700979 ) -> binder::public_api::Result<KeyMetadata> {
Hasini Gunasinghe5a893e82021-05-05 14:32:32 +0000980 // Duration is set to 5 seconds, because generateKey - especially for RSA keys, takes more
981 // time than other operations
982 let _wp = self.watch_millis("IKeystoreSecurityLevel::generateKey", 5000);
Hasini Gunasingheb7142972021-02-20 03:11:27 +0000983 let result = self.generate_key(key, attestation_key, params, flags, entropy);
Hasini Gunasinghe9617fd92021-04-01 22:27:07 +0000984 log_key_creation_event_stats(self.security_level, params, &result);
Pavel Grafov94243c22021-04-21 18:03:11 +0100985 log_key_generated(key, ThreadState::get_calling_uid(), result.is_ok());
Hasini Gunasingheb7142972021-02-20 03:11:27 +0000986 map_or_log_err(result, Ok)
Janis Danisevskis1af91262020-08-10 14:58:08 -0700987 }
988 fn importKey(
989 &self,
990 key: &KeyDescriptor,
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700991 attestation_key: Option<&KeyDescriptor>,
Janis Danisevskis1af91262020-08-10 14:58:08 -0700992 params: &[KeyParameter],
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700993 flags: i32,
Janis Danisevskis1af91262020-08-10 14:58:08 -0700994 key_data: &[u8],
Janis Danisevskis2c7f9622020-09-30 16:30:31 -0700995 ) -> binder::public_api::Result<KeyMetadata> {
Hasini Gunasinghe5a893e82021-05-05 14:32:32 +0000996 let _wp = self.watch_millis("IKeystoreSecurityLevel::importKey", 500);
Hasini Gunasingheb7142972021-02-20 03:11:27 +0000997 let result = self.import_key(key, attestation_key, params, flags, key_data);
Hasini Gunasinghe9617fd92021-04-01 22:27:07 +0000998 log_key_creation_event_stats(self.security_level, params, &result);
Pavel Grafov94243c22021-04-21 18:03:11 +0100999 log_key_imported(key, ThreadState::get_calling_uid(), result.is_ok());
Hasini Gunasingheb7142972021-02-20 03:11:27 +00001000 map_or_log_err(result, Ok)
Janis Danisevskis1af91262020-08-10 14:58:08 -07001001 }
1002 fn importWrappedKey(
1003 &self,
1004 key: &KeyDescriptor,
1005 wrapping_key: &KeyDescriptor,
1006 masking_key: Option<&[u8]>,
1007 params: &[KeyParameter],
1008 authenticators: &[AuthenticatorSpec],
Janis Danisevskis2c7f9622020-09-30 16:30:31 -07001009 ) -> binder::public_api::Result<KeyMetadata> {
Hasini Gunasinghe5a893e82021-05-05 14:32:32 +00001010 let _wp = self.watch_millis("IKeystoreSecurityLevel::importWrappedKey", 500);
Hasini Gunasingheb7142972021-02-20 03:11:27 +00001011 let result =
1012 self.import_wrapped_key(key, wrapping_key, masking_key, params, authenticators);
Hasini Gunasinghe9617fd92021-04-01 22:27:07 +00001013 log_key_creation_event_stats(self.security_level, params, &result);
Pavel Grafov94243c22021-04-21 18:03:11 +01001014 log_key_imported(key, ThreadState::get_calling_uid(), result.is_ok());
Hasini Gunasingheb7142972021-02-20 03:11:27 +00001015 map_or_log_err(result, Ok)
Janis Danisevskis1af91262020-08-10 14:58:08 -07001016 }
Satya Tangirala3361b612021-03-08 14:36:11 -08001017 fn convertStorageKeyToEphemeral(
1018 &self,
1019 storage_key: &KeyDescriptor,
Janis Danisevskisb2434d02021-04-20 12:49:27 -07001020 ) -> binder::public_api::Result<EphemeralStorageKeyResponse> {
Hasini Gunasinghe5a893e82021-05-05 14:32:32 +00001021 let _wp = self.watch_millis("IKeystoreSecurityLevel::convertStorageKeyToEphemeral", 500);
Satya Tangirala3361b612021-03-08 14:36:11 -08001022 map_or_log_err(self.convert_storage_key_to_ephemeral(storage_key), Ok)
1023 }
Satya Tangirala04bca0d2021-03-08 22:27:54 -08001024 fn deleteKey(&self, key: &KeyDescriptor) -> binder::public_api::Result<()> {
Hasini Gunasinghe5a893e82021-05-05 14:32:32 +00001025 let _wp = self.watch_millis("IKeystoreSecurityLevel::deleteKey", 500);
Pavel Grafov94243c22021-04-21 18:03:11 +01001026 let result = self.delete_key(key);
1027 log_key_deleted(key, ThreadState::get_calling_uid(), result.is_ok());
1028 map_or_log_err(result, Ok)
Satya Tangirala04bca0d2021-03-08 22:27:54 -08001029 }
Janis Danisevskis1af91262020-08-10 14:58:08 -07001030}