From 58c8e3911001bd565445eafa50e75e8f47488719 Mon Sep 17 00:00:00 2001 From: Eran Messeri Date: Mon, 14 Jun 2021 14:37:35 +0100 Subject: [PATCH] KeyMint: Document KeyCharacteristics Document the various fields in KeyCharacteristics. Bug: 183737811 Test: That it compiles. Change-Id: I629001a3f5ac5d1e61ae6ffaa2702e3d32f56e52 --- .../hardware/security/keymint/KeyCharacteristics.aidl | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/security/keymint/aidl/android/hardware/security/keymint/KeyCharacteristics.aidl b/security/keymint/aidl/android/hardware/security/keymint/KeyCharacteristics.aidl index 25fdee3d75..f0df0487bc 100644 --- a/security/keymint/aidl/android/hardware/security/keymint/KeyCharacteristics.aidl +++ b/security/keymint/aidl/android/hardware/security/keymint/KeyCharacteristics.aidl @@ -32,6 +32,17 @@ import android.hardware.security.keymint.SecurityLevel; */ @VintfStability parcelable KeyCharacteristics { + /** + * The security level enforcing this collection of key properties. + */ SecurityLevel securityLevel = SecurityLevel.SOFTWARE; + + /** + * `authorizations` is a list of key properties that are enforced at this security level. + * A key can have different properties enforced by components of different security levels. + * For example, some properties are provided by the operating system, which has a + * different security level to the IKeyMintDevice. + * See the `keyCharacteristics` field in `KeyCreationResult` for more details. + */ KeyParameter[] authorizations; }