פריסת קובץ מדיניות ההרשאות מגדירה את מיקום האחסון הייעודי לקובץ המדיניות הספציפי לכל שירות של רכב מוגדר-תוכנה (SDV). מנגנון הפריסה משתנה בין פלטפורמות SDV Core לבין פלטפורמות SDV IVI.
פלטפורמת הליבה של SDV
הפלטפורמה המרכזית של SDV משתמשת בקובצי APEX כדי לארוז חבילות שירות ואת ההגדרות שלהן. רכיב הרישום של חבילות השירות מאחזר את מדיניות ההרשאות של חבילות השירות של SDV שמאוחסנות ב-APEX.
APEX היא חבילה חתומה עם שם ייחודי שנקרא שם החבילה. כל APEX יכול להכיל כמה חבילות שירות. המטא-נתונים של כל חבילת שירות מוצהרים בקובץ המניפסט ב-APEX.
המטא-נתונים של חבילת השירות כוללים נתיב לקובץ מדיניות ההרשאה, שצריך להיות באותו APEX.
פורסים את מדיניות ההרשאות של שירות ה-SDV עם הזהות {sdv-vm-name}:{package.name}.{ServiceBundle}.{instance-name} ב-SDV באופן הבא:
- מציבים את קובץ מדיניות ההרשאות ב-APEX של
package.name. - מעדכנים את הרשומה
ServiceBundleבקובץ המניפסט של חבילות השירות ב-APEXpackage.nameעל ידי הוספת הנתיב המתאים של מדיניות ההרשאות לשדהauthorization_policy_path. - פורסים את ה-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 באופן הבא:
- מגדירים את הנתיב של מדיניות ההרשאה לפי התבנית
{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 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>, מסגרת ההרשאות מחפשת כללי מדיניות בסדר הבא:
-
<vm-name>.textproto: אם הוא קיים, הבדיקה תתבצע על פיו. אם הוא לא קיים, חוזרים לקובץ ברירת המחדל. -
.default.textproto: אם הוא קיים, הבדיקה תתבצע על פיו. אם הוא לא קיים, הגישה נדחית.
הגדרת מודול Soong עם הרשאות ברמת ה-VM
המודול חייב להיות APEX עם שם החבילה com.oem.sdv.authz.
מוסיפים את הערך לקובץ .mk:
SDV_VM_LEVEL_PERMISSIONS_MODULE := {soong.module.name}