التحكّم في الوصول التقديري (DAC)

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

غالبًا ما تحتاج عناصر نظام الملفات والخدمات التي تتم إضافتها إلى الإصدار إلى معرّفات فريدة منفصلة، تُعرف باسم معرّفات Android (AID). في الوقت الحالي، تستخدِم العديد من الموارد، مثل الملفات والخدمات، معرّفات AID الأساسية (التي يحدّدها Android) بدون داعٍ. وفي العديد من الحالات، يمكنك استخدام معرّفات AID التي يحدّدها المصنّع الأصلي للجهاز (OEM) بدلاً من ذلك.

وفّرت الإصدارات الأقدم من Android (الإصدار 7.x والإصدارات الأقدم) آلية عناوين AID باستخدام ملف android_filesystem_config.h خاص بالجهاز لتحديد إمكانات نظام الملفات و/أو عناوين AID المخصّصة لجهات التصنيع الأصلية للأجهزة. ومع ذلك، كان هذا النظام غير سهل الاستخدام لأنه لم يكن يتيح استخدام أسماء مألوفة لأرقام تعريف المصنّعين الأصليّين للأجهزة، ما يتطلّب منك تحديد الرقم الأساسي لحقول المستخدم والمجموعة بدون طريقة لربط اسم مألوف برقم التعريف.

تتيح الإصدارات الأحدث من Android (الإصدار 8.0 والإصدارات الأحدث) طريقة جديدة ل توسيع إمكانات نظام الملفات. تتيح هذه الطريقة الجديدة ما يلي:

• مواقع مصادر متعددة لملفات الضبط (تتيح إعدادات قابلة للتوسيع للإنشاء)
• التحقّق من صحة قيم معرّفات AID الخاصة بصانعي الأجهزة الأصليين أثناء مرحلة الإنشاء
• إنشاء عنوان AID مخصّص من المصنّع الأصلي للجهاز يمكن استخدامه في الملفات المصدر عند الحاجة
• ربط اسم مألوف بقيمة AID الفعلية لجهة التصنيع الأصلية تتيح استخدام وسيطات سلاسل غير رقمية للمستخدم والمجموعة، أي "foo" بدلاً من "2901".

تشمل التحسينات الإضافية إزالة صفيف android_ids[] من system/core/libcutils/include/private/android_filesystem_config.h. تتوفّر هذه السلسلة الآن في Bionic كمصفوفة تم إنشاؤها بالكامل بشكل خاص، مع أدوات وصول باستخدام getpwnam() وgetgrnam(). (يؤدي ذلك إلى توليد ملفّات ثنائية ثابتة عند تعديل معرّفات AID الأساسية). للحصول على أدوات وملف README يحتوي على مزيد من التفاصيل، يُرجى الرجوع إلى build/make/tools/fs_config.

إضافة أرقام تعريف Android

أزال الإصدار 8.0 من Android صفيف android_ids[] من "مشروع Android المفتوح المصدر" (AOSP). بدلاً من ذلك، يتم إنشاء جميع الأسماء المتوافقة مع ميزة "المساعدة الذكية" منملف الرأس system/core/libcutils/include/private/android_filesystem_config.h عند إنشاء صفيف Bionic android_ids[]. تلتقط الأدوات أي define مطابقة AID_* ويصبح * هو الاسم باللغة الإنجليزية.

على سبيل المثال، في private/android_filesystem_config.h:

#define AID_SYSTEM 1000

يصبح:

• الاسم السهل: system
• uid: ‏ 1000
• gid: ‏ 1000

لإضافة معرّف AID جديد لنظام AOSP الأساسي، ما عليك سوى إضافة #define إلى ملف العنوان android_filesystem_config.h. يتم إنشاء معرّف AID عند إنشاء التطبيق وإتاحته للواجهات التي تستخدِم معلَمات المستخدِم والمجموعة. تتحقّق الأدوات من أنّ معرّف AID الجديد ليس ضمن نطاقات APP أو OEM، كما تراعي التغييرات في هذه النطاقات ومن المفترض أن تتم إعادة الضبط تلقائيًا عند حدوث تغييرات أو عند إضافة نطاقات جديدة محجوزة لمصنّع المعدّات الأصلية.

ضبط معرّفات AID

لتفعيل آلية AIDs الجديدة، اضبط TARGET_FS_CONFIG_GEN في ملف BoardConfig.mk. يحتوي هذا المتغيّر على قائمة بملفات الإعدادات ، ما يتيح لك إلحاق الملفات حسب الحاجة.

وفقًا للاصطلاح، تستخدم ملفات الإعدادات الاسم config.fs، ولكن في الممارسة، يمكنك استخدام أي اسم. تكون ملفات config.fs بتنسيق ملف ConfigParser ini في Python وتتضمّن قسمًا للحدود القصوى (لضبط قدرات نظام الملفات) وقسمًا لأرقام تعريف المعلِنين (لضبط أرقام تعريف المعلِنين المصنّعين الأصليّين للأجهزة).

ضبط قسم "أحرف كبيرة"

يتيح قسم "الحدود القصوى" ضبط إمكانات نظام الملفات على عناصر نظام الملفات ضمن الإصدار (يجب أن يتيح نظام الملفات نفسه أيضًا هذه الوظيفة).

بما أنّ تشغيل خدمة ثابتة بصفتها مشرفًا في Android يؤدي إلى تعطُّل مجموعة أدوات اختبار التوافق (CTS)، كانت المتطلبات السابقة للاحتفاظ بإحدى الإمكانات أثناء تنفيذ عملية أو خدمة تتضمن إعداد الإمكانات ثم استخدام setuid/setgid مع معرّف جهاز Android (AID) المناسب للتشغيل. باستخدام الأقواس العليا، يمكنك تخطّي هذه المتطلبات والسماح للنواة بتنفيذها نيابةً عنك. عند منح main() الإذن بالتحكم، ستحصل العملية على الإمكانات التي تحتاج إليها حتى تتمكّن خدمتك من استخدام مستخدم ومجموعة غير مُدرَجين في مجموعة الجذر (هذه هي الطريقة المفضّلة لبدء الخدمات المميّزة).

يستخدم قسم الأحرف الكبيرة البنية التالية:

للاطّلاع على مثال على الاستخدام، يُرجى الاطّلاع على استخدام إمكانات نظام الملفات.

ضبط قسم AID

يحتوي قسم AID على معرّفات AID الخاصة بصانعي الأجهزة الأصليين ويستخدم البنية التالية:

للحصول على أمثلة على الاستخدام، يُرجى الاطّلاع على تحديد أسماء ملف تعريف الارتباط لجهة التصنيع واستخدام ملفات تعريف الارتباط لجهة التصنيع.

أمثلة على الاستخدام

توضّح الأمثلة التالية بالتفصيل كيفية تحديد معرّف AID الخاص بصانع الجهاز الأصلي واستخدامه وكيفية تفعيل إمكانات نظام الملفات. يجب أن تبدأ أسماء معرّفات AID الخاصة بالمصنّعين الأصليين للأجهزة ([AID_name]) باسم قسم مثل "vendor_" لضمان عدم تعارضها مع أسماء AOSP المستقبلية أو الأقسام الأخرى.

تحديد أسماء المعرّفات الفريدة للأجهزة من المصنّعين الأصليين

لتحديد معرّف AID الخاص بصانع الجهاز الأصلي، أنشئ ملف config.fs واضبط قيمة AID. على سبيل المثال، في device/x/y/config.fs، اضبط ما يلي:

[AID_VENDOR_FOO]
value: 2900

بعد إنشاء الملف، اضبط المتغيّر TARGET_FS_CONFIG_GEN وأشِر إليه في BoardConfig.mk. على سبيل المثال، في device/x/y/BoardConfig.mk، اضبط ما يلي:

TARGET_FS_CONFIG_GEN += device/x/y/config.fs

يمكن للنظام الآن استخدام معرّف الإعلان المخصّص في إصدار جديد.

استخدام معرّفات AID الخاصة بالمصنّعين الأصليين للأجهزة

لاستخدام معرّف AID الخاص بصانع المعدّات الأصلية، أدرِج oemaids_headers في ملف Makefile المرتبط برمز C وأضِف #include "generated_oem_aid.h"، ثم ابدأ باستخدام المعرّفات المعلَن عنها. على سبيل المثال، في my_file.c، أضِف ما يلي:

#include "generated_oem_aid.h"
…

If (ipc->uid == AID_VENDOR_FOO) {
  // Do something
...

في ملف Android.bp المرتبط، أضِف ما يلي:

header_libs: ["oemaids_headers"],

إذا كنت تستخدم ملف Android.mk، أضِف ما يلي:

LOCAL_HEADER_LIBRARIES := oemaids_headers

استخدام أسماء سهلة القراءة

في Android 9، يمكنك استخدام الاسم المعرِّف لأي واجهة متوافقة مع أسماء معرّفات AID. مثلاً:

• في الأمر chown في some/init.rc:

  chown vendor_foo /vendor/some/vendor_foo/file
  

• في service في some/init.rc:

  service vendor_foo /vendor/bin/foo_service
      user vendor_foo
      group vendor_foo
  

وبما أنّ عملية الربط الداخلي من الاسم السهل إلى المعرّف المطلق للمستخدم تتم من خلال /vendor/etc/passwd و/vendor/etc/group، يجب تركيب قسم المصنّع.

ربط الأسماء السهلة القراءة

يتيح نظام التشغيل Android 9 ربط اسم مألوف بقيمة AID الفعلية لجهة التصنيع الأصلية. يمكنك استخدام سلاسل غير رقمية للوسيطات الخاصة بالمستخدم والمجموعة، أي "vendor_foo" بدلاً من "2901".

التحويل من المعرّف الإعلاني إلى الأسماء الودية

بالنسبة إلى معرّفات AID الخاصة بجهات التصنيع، كان نظام التشغيل Android 8.x يتطلّب استخدام oem_#### مع getpwnam والدوالّ المشابهة، وكذلك في الأماكن التي تتعامل مع عمليات البحث باستخدام getpwnam (مثل نصوص برمجية init). في Android 9، يمكنك استخدام الصديقَين getpwnam وgetgrnam في Bionic للقيام بعمليات التحويل من معرّفات Android (AID) إلى الأسماء الودية والعكس.

استخدام إمكانات نظام الملفات

لتفعيل إمكانات نظام الملفات، أنشئ قسمًا للملفّات ذات الحجم الكبير في ملف config.fs. على سبيل المثال، في device/x/y/config.fs، أضِف القسم التالي:

[system/bin/foo_service]
mode: 0555
user: AID_VENDOR_FOO
group: AID_SYSTEM
caps: SYS_ADMIN | SYS_NICE

بعد إنشاء الملف، اضبط TARGET_FS_CONFIG_GEN للإشارة إلى هذا الملف في BoardConfig.mk. على سبيل المثال، في device/x/y/BoardConfig.mk، اضبط ما يلي:

TARGET_FS_CONFIG_GEN += device/x/y/config.fs

عند تنفيذ الخدمة vendor_foo، تبدأ بإمكانات CAP_SYS_ADMIN وCAP_SYS_NICE بدون استدعاء setuid وsetgid. بالإضافة إلى ذلك، لم تعُد سياسة SELinux لخدمة vendor_foo تحتاج إلى إذنَي setuid وsetgid ويمكن حذفها.

ضبط عمليات الاستبدال (الإصدارات 6.x و7.x من Android)

نقل نظام التشغيل Android 6.0 fs_config وتعريفات البنية المرتبطة (system/core/include/private/android_filesystem_config.h) إلى system/core/libcutils/fs_config.c حيث يمكن تعديلها أو إلغاؤها بواسطة الملفات الثنائية المثبَّتة في /system/etc/fs_config_dirs و /system/etc/fs_config_files. من خلال استخدام قواعد مطابقة وتحليل منفصلة للأدلة والملفات (التي يمكن أن تستخدم تعبيرات منتظمة إضافية) ، تمكّن نظام التشغيل Android من معالجة الأدلة والملفات في جدولَين مختلفَين. لم تسمح تعريفات البنية في system/core/libcutils/fs_config.c فقط بقراءة الأدلة والملفات في وقت التشغيل، بل يمكن للمضيف استخدام الملفات نفسها أثناء وقت التصميم لإنشاء صور نظام الملفات على النحو الموضّح في ${OUT}/system/etc/fs_config_dirs و ${OUT}/system/etc/fs_config_files.

على الرغم من أنّه تم استبدال طريقة إلغاء الإعدادات لتوسيع نظام الملفات بنظام الإعدادات المُركّبة الذي تم تقديمه في Android 8.0، سيظل بإمكانك استخدام الطريقة القديمة إذا أردت ذلك. توضّح الأقسام التالية بالتفصيل كيفية إنشاء ملفات الإلغاء ودمجها وضبط نظام الملفات.

إنشاء ملفات إلغاء

يمكنك إنشاء الملفَين الثنائيَين المتوافقَين /system/etc/fs_config_dirs و /system/etc/fs_config_files باستخدام أداة fs_config_generate في build/tools/fs_config. تستخدم الأداة دالة مكتبة libcutils (fs_config_generate()) لإدارة متطلبات DAC في ملف تخزين مؤقت وحدِّد قواعد لملف تضمين لتطبيق قواعد DAC.

لاستخدامها، أنشئ ملفًا يتضمّن ملفًا آخر في device/vendor/device/android_filesystem_config.h يعمل كملف بديل. يجب أن يستخدم الملف تنسيق structure fs_path_config المحدد في system/core/include/private/android_filesystem_config.h مع بدء البنية التالية لرمزَي الدليل والملف:

• بالنسبة إلى الأدلة، استخدِم android_device_dirs[].
• بالنسبة إلى الملفات، استخدِم android_device_files[].

عند عدم استخدام android_device_dirs[] و android_device_files[]، يمكنك تحديد NO_ANDROID_FILESYSTEM_CONFIG_DEVICE_DIRS و NO_ANDROID_FILESYSTEM_CONFIG_DEVICE_FILES (اطّلِع على المثال أدناه). يمكنك أيضًا تحديد ملف التبديل باستخدام TARGET_ANDROID_FILESYSTEM_CONFIG_H في إعدادات اللوحة، مع استخدام اسم أساسي مفروَض هو android_filesystem_config.h.

تضمين ملفات إلغاء

لتضمين الملفات، تأكَّد من أنّ PRODUCT_PACKAGES يتضمّن fs_config_dirs و/أو fs_config_files حتى تتمكّن من تثبيتها في /system/etc/fs_config_dirs و /system/etc/fs_config_files، على التوالي. يبحث نظام الإنشاء عن android_filesystem_config.h المخصّصة في $(TARGET_DEVICE_DIR)، حيث تتوفّر BoardConfig.mk. إذا كان هذا الملف متوفّرًا في مكان آخر، اضبط متغيّر إعدادات اللوحة TARGET_ANDROID_FILESYSTEM_CONFIG_H للإشارة إلى هذا الموقع.

ضبط نظام الملفات

لضبط نظام الملفات في الإصدار 6.0 من نظام التشغيل Android والإصدارات الأحدث:

1. أنشئ ملف $(TARGET_DEVICE_DIR)/android_filesystem_config.h.
2. أضِف fs_config_dirs و/أو fs_config_files إلى PRODUCT_PACKAGES في ملف إعدادات اللوحة (على سبيل المثال، $(TARGET_DEVICE_DIR)/device.mk).

مثال على إلغاء الإعدادات

يعرض هذا المثال تصحيحًا لإلغاء الخدمة الخفية system/bin/glgps لإضافة إمكانية استخدام ميزة "قفل التنشيط" في الدليل device/vendor/device. يُرجى مراعاة ما يلي:

• كل إدخال في البنية هو الوضع وuid وgid والإمكانات والاسم. يتم تضمين system/core/include/private/android_filesystem_config.h تلقائيًا لتوفير التعريفات #defines في البيان (AID_ROOT وAID_SHELL CAP_BLOCK_SUSPEND).
• يتضمّن القسم android_device_files[] إجراءً لمنع الوصول إلى system/etc/fs_config_dirs عندما لا يكون محدّدًا، ويشكّل ذلك حماية إضافية لإمكانية الوصول إلى البيانات (DAC) بسبب عدم توفّر محتوى لعمليات التبديل في الدليل. ومع ذلك، هذه الحماية ضعيفة، فإذا كان أحد المستخدمين يتحكّم في /system، يمكنه عادةً تنفيذ أي إجراء يريده.

diff --git a/android_filesystem_config.h b/android_filesystem_config.h
new file mode 100644
index 0000000..874195f
--- /dev/null
+++ b/android_filesystem_config.h
@@ -0,0 +1,36 @@
+/*
+ * Copyright (C) 2015 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 file is used to define the properties of the file system
+** images generated by build tools (eg: mkbootfs) and
+** by the device side of adb.
+*/
+
+#define NO_ANDROID_FILESYSTEM_CONFIG_DEVICE_DIRS
+/* static const struct fs_path_config android_device_dirs[] = { }; */
+
+/* Rules for files.
+** These rules are applied based on "first match", so they
+** should start with the most specific path and work their
+** way up to the root. Prefixes ending in * denotes wildcard
+** and will allow partial matches.
+*/
+static const struct fs_path_config android_device_files[] = {
+  { 00755, AID_ROOT, AID_SHELL, (1ULL << CAP_BLOCK_SUSPEND),
"system/bin/glgps" },
+#ifdef NO_ANDROID_FILESYSTEM_CONFIG_DEVICE_DIRS
+  { 00000, AID_ROOT, AID_ROOT, 0, "system/etc/fs_config_dirs" },
+#endif
+};


diff --git a/device.mk b/device.mk
index 0c71d21..235c1a7 100644
--- a/device.mk
+++ b/device.mk
@@ -18,7 +18,8 @@ PRODUCT_PACKAGES := \
     libwpa_client \
     hostapd \
     wpa_supplicant \
-    wpa_supplicant.conf
+    wpa_supplicant.conf \
+    fs_config_files

 ifeq ($(TARGET_PREBUILT_KERNEL),)
 ifeq ($(USE_SVELTE_KERNEL), true)

نقل أنظمة الملفات من الإصدارات السابقة

عند نقل أنظمة الملفات من Android 5.x والإصدارات الأقدم، يُرجى مراعاة ما يلي: Android 6.x

• تزيل بعض عمليات التضمين والهياكل والتعريفات المضمّنة.
• تتطلّب الإشارة إلى libcutils بدلاً من التشغيل مباشرةً من system/core/include/private/android_filesystem_config.h. يجب أن تضيف ملفات التشغيل الخاصة للشركة المصنّعة للجهاز التي تعتمد على system/code/include/private_filesystem_config.h لبنية الملف أو الدليل أو fs_config تبعيات مكتبة libcutils.
• تتطلّب هذه الميزة من الشركة المصنّعة للجهاز إنشاء نُسخ من الإصدار العلني من الإصدار system/core/include/private/android_filesystem_config.h في الفرع الخاص بها، مع تضمين محتوى إضافي على الاستهدافات الحالية، وذلك لنقل الإصدار إلى الإصدار device/vendor/device/android_filesystem_config.h.
• تحتفظ الشركة بالحق في تطبيق عناصر التحكّم الإلزامي في الوصول (MAC) في نظام التشغيل SELinux علىملفّات الضبط في النظام المستهدَف، ويجب أن تضمن عمليات التنفيذ التي تتضمّن ملفات تنفيذ مخصّصة مستهدَفة باستخدام fs_config() إمكانية الوصول.