การทำให้ใช้งานได้

การติดตั้งใช้งานไฟล์นโยบายการให้สิทธิ์จะกำหนดตำแหน่งพื้นที่เก็บข้อมูลที่กำหนดไว้สำหรับไฟล์นโยบายที่เฉพาะเจาะจงสำหรับบริการ Software-Defined Vehicle (SDV) แต่ละรายการ กลไกการติดตั้งใช้งานจะแตกต่างกันไปตามแพลตฟอร์ม SDV Core และ SDV IVI

แพลตฟอร์มหลักของ SDV

แพลตฟอร์มหลักของ SDV ใช้ไฟล์ APEX สำหรับแพ็กเกจกลุ่มบริการและการกำหนดค่ากลุ่มบริการ คอมโพเนนต์รีจิสทรีของแพ็กเกจบริการจะดึงข้อมูลนโยบายการให้สิทธิ์สำหรับแพ็กเกจบริการ SDV ที่จัดเก็บไว้ใน APEX

APEX เป็นแพ็กเกจที่รับรองแล้วซึ่งมีชื่อที่ไม่ซ้ำกันซึ่งเรียกว่าชื่อแพ็กเกจ APEX แต่ละรายการสามารถมีแพ็กเกจบริการได้หลายรายการ แต่ละ Service Bundle จะมีการประกาศข้อมูลเมตาในไฟล์ Manifest ใน APEX

ข้อมูลเมตาของแพ็กเกจบริการมีเส้นทางไปยังไฟล์นโยบายการให้สิทธิ์ ซึ่งควรอยู่ใน APEX เดียวกัน

ติดตั้งใช้งานนโยบายการให้สิทธิ์สำหรับบริการ SDV ด้วยข้อมูลประจำตัว {sdv-vm-name}:{package.name}.{ServiceBundle}.{instance-name} ใน SDV ดังนี้

  1. ใส่ไฟล์นโยบายการให้สิทธิ์ใน package.name APEX
  2. อัปเดตรายการ ServiceBundle ในไฟล์ Manifest ของแพ็กเกจบริการใน APEX package.name โดยเพิ่มเส้นทางนโยบายการให้สิทธิ์ที่เกี่ยวข้องลงในช่อง authorization_policy_path
  3. ติดตั้งใช้งาน package.name APEX ใน sdv-vm-name VM

ตัวอย่าง

(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"
}

วางไฟล์นโยบายการให้สิทธิ์ใน etc/authz/sample_rpc/permissions.textproto ภายใน APEX เดียวกันกับที่ sdv_service_bundles_manifest.textproto อยู่

แพลตฟอร์ม IVI ของ SDV

แพลตฟอร์ม SDV IVI และการใช้งาน SDV Core มีความแตกต่างกันบางประการ ในแพลตฟอร์ม SDV IVI ให้ทำดังนี้

  • ไม่มีรีจิสทรีแพ็กเกจบริการ
  • แอปต่างๆ จะใช้ Java เป็นหลักและนำส่งในรูปแบบ APK
  • Agent ไม่ได้อยู่ใน APEX

ปัจจัยเหล่านี้ทำให้การติดตั้งใช้งานบนแพลตฟอร์ม SDV แตกต่างออกไป

ติดตั้งใช้งานนโยบายการให้สิทธิ์สำหรับบริการ SDV ด้วยข้อมูลประจำตัว {ivi-vm-name}:{package.name}.{ServiceBundle}/{instance-name} ใน SDV IVI ดังนี้

  1. กำหนดเส้นทางนโยบายการให้สิทธิ์ตามรูปแบบ {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 เป็นเส้นทางนโยบายการให้สิทธิ์ที่ถูกต้อง
  2. ใส่นโยบายการให้สิทธิ์ในเส้นทางนโยบายการให้สิทธิ์ใน VM ของ ivi-vm-name

ตัวแทนและการสนับสนุนการทดสอบ

ตัวแทน SDV มีการติดตั้งใช้งานนโยบายการให้สิทธิ์เหมือนกันทั้งใน SDV Core และ 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"
}

นโยบายการให้สิทธิ์ระดับ VM

ใส่นโยบายระดับ VM ใน APEX ที่มีชื่อแพ็กเกจ com.oem.sdv.authz ใช้ไฟล์เฉพาะที่มีชื่อ <vm_name>.textproto ที่สอดคล้องกัน

หากไม่มี <vm_name>.textproto ที่เกี่ยวข้อง เฟรมเวิร์กการให้สิทธิ์จะค้นหาไฟล์ .default.textproto ใน APEX เดียวกันด้วย

เหตุผล

เราเปิดตัว .default.textproto ด้วยเหตุผล 2 ประการ ดังนี้

  • การตั้งค่าที่ง่ายขึ้น: สำหรับ OEM บางราย การตั้งค่า default.textproto สำหรับ SDV VM ทั้งหมดอาจเพียงพอแล้ว และให้ระบุ <vm-name>.textproto พิเศษสำหรับ IVI VM เท่านั้น
  • ความสามารถในการอัปเดต: หาก VM ใหม่ปรากฏขึ้นหลังจากการอัปเดตยานพาหนะ default.textproto ที่สมเหตุสมผลอาจเพียงพอที่จะหลีกเลี่ยงการอัปเดต VM ทั้งหมด

ตรรกะการแก้ไขปัญหา

เมื่อตรวจสอบสิทธิ์สำหรับเรื่องจาก VM ที่ชื่อ <vm-name> เฟรมเวิร์กการให้สิทธิ์จะค้นหานโยบายตามลำดับต่อไปนี้

  1. <vm-name>.textproto: หากมี ให้ทำการตรวจสอบตามข้อมูลนี้ หากไม่มีไฟล์ดังกล่าว ให้กลับไปใช้ไฟล์เริ่มต้น
  2. .default.textproto: หากมี ให้ทำการตรวจสอบตามข้อมูลนี้ หากไม่มี ให้ปฏิเสธการเข้าถึง

กำหนดโมดูล Soong ด้วยสิทธิ์ระดับ VM

โมดูลต้องเป็น APEX ที่มีชื่อแพ็กเกจ com.oem.sdv.authz

เพิ่มค่าลงในไฟล์ .mk ดังนี้

SDV_VM_LEVEL_PERMISSIONS_MODULE := {soong.module.name}