פריסה

פריסת קובץ מדיניות ההרשאות מגדירה את מיקום האחסון הייעודי לקובץ המדיניות הספציפי לכל שירות של רכב מוגדר-תוכנה (SDV). מנגנון הפריסה משתנה בין פלטפורמות SDV Core לבין פלטפורמות SDV IVI.

פלטפורמת הליבה של SDV

הפלטפורמה המרכזית של SDV משתמשת בקובצי APEX כדי לארוז חבילות שירות ואת ההגדרות שלהן. רכיב הרישום של חבילות השירות מאחזר את מדיניות ההרשאות של חבילות השירות של SDV שמאוחסנות ב-APEX.

‫APEX היא חבילה חתומה עם שם ייחודי שנקרא שם החבילה. כל APEX יכול להכיל כמה חבילות שירות. המטא-נתונים של כל חבילת שירות מוצהרים בקובץ המניפסט ב-APEX.

המטא-נתונים של חבילת השירות כוללים נתיב לקובץ מדיניות ההרשאה, שצריך להיות באותו APEX.

פורסים את מדיניות ההרשאות של שירות ה-SDV עם הזהות {sdv-vm-name}:{package.name}.{ServiceBundle}.{instance-name} ב-SDV באופן הבא:

  1. מציבים את קובץ מדיניות ההרשאות ב-APEX של package.name.
  2. מעדכנים את הרשומה ServiceBundle בקובץ המניפסט של חבילות השירות ב-APEX package.name על ידי הוספת הנתיב המתאים של מדיניות ההרשאות לשדה authorization_policy_path.
  3. פורסים את ה-APEX של package.name במכונה הווירטואלית של 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"
}

ממקמים את קובץ מדיניות ההרשאה ב-etc/authz/sample_rpc/permissions.textproto באותו APEX שבו נמצא sdv_service_bundles_manifest.textproto.

פלטפורמת SDV IVI

יש כמה הבדלים בין פלטפורמת SDV IVI לבין ההטמעות של SDV Core. בפלטפורמת SDV IVI:

  • אין רישום של חבילת שירות.
  • האפליקציות מבוססות על Java ומועברות בקובצי APK.
  • הסוכנים לא נמצאים ב-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. מציבים את מדיניות ההרשאה בנתיב של מדיניות ההרשאה במכונה הווירטואלית של 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 משתי סיבות:

  • הגדרה פשוטה: בחלק מיצרני הציוד המקורי, יכול להיות שמספיק להגדיר את default.textproto לכל המכונות הווירטואליות של ה-SDV, ולספק רק <vm-name>.textproto מיוחד למכונה הווירטואלית של ה-IVI.
  • אפשרות לקבל עדכונים: אם מופיעה מכונה וירטואלית חדשה אחרי עדכון הרכב, יכול להיות שערך default.textproto סביר יספיק כדי להימנע מעדכון כל המכונות הווירטואליות.

לוגיקת הפתרון

כשבודקים הרשאות של נושא ממכונה וירטואלית בשם <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}