// Copyright 2021, The Android Open Source Project // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //! This module implements functions to log audit events to binary security log buffer for NIAP //! compliance. use crate::globals::LOGS_HANDLER; use android_system_keystore2::aidl::android::system::keystore2::{ Domain::Domain, KeyDescriptor::KeyDescriptor, }; use libc::uid_t; use log_event_list::{LogContext, LogContextError, LogIdSecurity}; const TAG_KEY_GENERATED: u32 = 210024; const TAG_KEY_IMPORTED: u32 = 210025; const TAG_KEY_DESTROYED: u32 = 210026; const TAG_KEY_INTEGRITY_VIOLATION: u32 = 210032; const FLAG_NAMESPACE: i64 = 0x80000000; /// Encode key owner as either uid or namespace with a flag. fn key_owner(domain: Domain, nspace: i64, uid: i32) -> i32 { match domain { Domain::APP => uid, Domain::SELINUX => (nspace | FLAG_NAMESPACE) as i32, _ => { log::info!("Not logging audit event for key with unexpected domain"); 0 } } } /// Logs key generation event to NIAP audit log. pub fn log_key_generated(key: &KeyDescriptor, calling_app: uid_t, success: bool) { log_key_event(TAG_KEY_GENERATED, key, calling_app, success); } /// Logs key import event to NIAP audit log. pub fn log_key_imported(key: &KeyDescriptor, calling_app: uid_t, success: bool) { log_key_event(TAG_KEY_IMPORTED, key, calling_app, success); } /// Logs key deletion event to NIAP audit log. pub fn log_key_deleted(key: &KeyDescriptor, calling_app: uid_t, success: bool) { log_key_event(TAG_KEY_DESTROYED, key, calling_app, success); } /// Logs key integrity violation to NIAP audit log. pub fn log_key_integrity_violation(key: &KeyDescriptor) { with_log_context(TAG_KEY_INTEGRITY_VIOLATION, |ctx| { let owner = key_owner(key.domain, key.nspace, key.nspace as i32); ctx.append_str(key.alias.as_ref().map_or("none", String::as_str))?.append_i32(owner) }) } fn log_key_event(tag: u32, key: &KeyDescriptor, calling_app: uid_t, success: bool) { with_log_context(tag, |ctx| { let owner = key_owner(key.domain, key.nspace, calling_app as i32); ctx.append_i32(i32::from(success))? .append_str(key.alias.as_ref().map_or("none", String::as_str))? .append_i32(owner) }) } fn with_log_context(tag: u32, f: F) where F: Fn(LogContext) -> Result, { if let Some(ctx) = LogContext::new(LogIdSecurity, tag) { if let Ok(event) = f(ctx) { LOGS_HANDLER.queue_lo(move |_| { let _result = event.write(); }); } } }