授权政策文件部署定义了每个软件定义车辆 (SDV) 服务专属政策文件的指定存储位置。SDV 核心平台和 SDV IVI 平台的部署机制有所不同。
SDV 核心平台
SDV 核心平台使用 APEX 文件来打包服务软件包和服务软件包配置。服务 bundle 注册表组件会检索存储在 APEX 中的 SDV 服务 bundle 的授权政策。
APEX 是一个具有唯一名称(称为软件包名称)的签名软件包。每个 APEX 都可以包含多个服务软件包。每个服务 bundle 都在 APEX 的清单文件中声明了其元数据。
服务软件包元数据包含授权政策文件的路径,该文件应位于同一 APEX 中。
使用 SDV 上的身份 {sdv-vm-name}:{package.name}.{ServiceBundle}.{instance-name} 为 SDV 服务部署授权政策,如下所示:
- 将授权政策文件放入
package.nameAPEX 中。 - 通过将相应的授权政策路径添加到
authorization_policy_path字段,更新package.nameAPEX 中服务软件包清单文件中的ServiceBundle条目。 - 将
package.nameAPEX 部署到sdv-vm-name虚拟机中。
示例
(apex_root) sdv_service_bundles_manifest.textproto
sdv_service_bundle_metadata {
name: "SampleRpcServer"
version_number: 0
version_name: "0.1 Alpha"
native_library_path: "lib64/libsdv_sample_rpc.so"
# Path to the authorization policy file.
# Warning: Must be a relative path to the APEX root directory.
authorization_policy_path: "etc/authz/sample_rpc/permissions.textproto"
}
将授权政策文件放在 sdv_service_bundles_manifest.textproto 所在的同一 APEX 中的 etc/authz/sample_rpc/permissions.textproto 内。
SDV IVI 平台
SDV IVI 平台与 SDV 核心实现之间存在一些差异。在 SDV IVI 平台中:
- 没有服务包注册表。
- 应用基于 Java,并以 APK 形式提供。
- 代理不在 APEX 中。
由于这些因素,SDV 平台上的部署方式有所不同。
使用 SDV IVI 上的身份 {ivi-vm-name}:{package.name}.{ServiceBundle}/{instance-name} 为 SDV 服务部署授权政策,如下所示:
- 根据
{policy-dir}/{package.name}/{ServiceBundle}.textproto模式定义授权政策路径。- 其中
policy-dir是以下值之一:/product/etc/sdv_authz_policies/system/etc/sdv_authz_policies/system_ext/etc/sdv_authz_policies/vendor/etc/sdv_authz_policies
- 例如,
/vendor/etc/sdv_authz_policies/com.sdv.pkg/WindowManager.textproto是一个有效的授权政策路径。
- 其中
- 将授权政策放在
ivi-vm-name虚拟机上的授权政策路径中。
代理和测试支持
SDV 代理在 SDV 核心和 SDV IVI 上具有相同的授权政策部署。如果代理没有 APEX,其对应的授权政策必须位于配套的仅配置 APEX 中。
示例
(apex_root) sdv_service_bundles_manifest.textproto
sdv_service_bundle_metadata {
# Should match the bundle name in the FQIN registered by the SOME/IP broker agent
name: "SomeIpBroker"
# Version number of the config APEX
version_number: 1
# Version name of the config APEX
version_name: "1"
# Reference the manifest itself to mark the metadata as a config-only
# declaration.
native_library_path: "etc/sdv_service_bundles_manifest.textproto"
# Path to the authorization policy file for SOME/IP broker.
authorization_policy_path: "etc/config/access_control/someip_authz_policy.textproto"
}
虚拟机级授权政策
将虚拟机级政策放入软件包名称为 com.oem.sdv.authz 的 APEX 中。使用具有相应 <vm_name>.textproto 名称的专用文件。
如果对应的 <vm_name>.textproto 不存在,授权框架还会在同一 APEX 中查找 .default.textproto 文件。
理由
引入 .default.textproto 的原因有两个:
- 简化设置:对于某些 OEM,可能只需为所有 SDV 虚拟机设置
default.textproto,并仅为 IVI 虚拟机提供特殊的<vm-name>.textproto。 - 可更新性:如果车辆更新后出现新的虚拟机,则合理的
default.textproto可能足以避免更新所有虚拟机。
解析逻辑
在检查名为 <vm-name> 的虚拟机中的主体的权限时,授权框架会按以下顺序查找政策:
<vm-name>.textproto:如果存在,则根据它执行检查。如果该文件不存在,则回退到默认文件。.default.textproto:如果存在,则根据它执行检查。如果该代码不存在,则拒绝访问。
定义具有虚拟机级权限的 Soong 模块
该模块必须是软件包名称为 com.oem.sdv.authz 的 APEX。
将该值添加到 .mk 文件中:
SDV_VM_LEVEL_PERMISSIONS_MODULE := {soong.module.name}