SELinux की पुष्टि

Android दृढ़ता से ओईएम को उनके SELinux कार्यान्वयन का पूरी तरह से परीक्षण करने के लिए प्रोत्साहित करता है। चूंकि निर्माता SELinux को लागू करते हैं, इसलिए उन्हें नई नीति को पहले उपकरणों के परीक्षण पूल पर लागू करना चाहिए।

एक नई नीति लागू करने के बाद, getenforce कमांड जारी करके सुनिश्चित करें कि SELinux डिवाइस पर सही मोड में चल रहा है।

यह वैश्विक SELinux मोड को प्रिंट करता है: या तो Enforceing या Permissive। प्रत्येक डोमेन के लिए SELinux मोड निर्धारित करने के लिए, आपको संबंधित फाइलों की जांच करनी चाहिए या उचित ( -p ) फ्लैग के साथ sepolicy-analyze का नवीनतम संस्करण चलाना चाहिए, जो कि /platform/system/sepolicy/tools/ में मौजूद है।

पढ़ना इनकार

त्रुटियों की जांच करें, जो ईवेंट लॉग के रूप में dmesg और logcat पर रूट की जाती हैं और डिवाइस पर स्थानीय रूप से देखने योग्य होती हैं। निर्माताओं को इन उपकरणों पर SELinux आउटपुट को dmesg पर जांचना चाहिए और अनुमति मोड में सार्वजनिक रिलीज से पहले सेटिंग्स को परिष्कृत करना चाहिए और अंततः लागू मोड में स्विच करना चाहिए। SELinux लॉग संदेशों में avc: होता है और इसलिए grep के साथ आसानी से पाया जा सकता है। cat /proc/kmsg चलाकर चल रहे इनकार लॉग को कैप्चर करना संभव है या cat /sys/fs/pstore/console-ramoops चलाकर पिछले बूट से इनकार लॉग कैप्चर करना संभव है।

बूट पूर्ण होने के बाद SELinux त्रुटि संदेश रेट-लिमिटेड होते हैं ताकि लॉग को स्वाम्प करने से बचा जा सके। यह सुनिश्चित करने के लिए कि आप सभी प्रासंगिक संदेशों को देखते हैं, आप इसे adb shell auditctl -r 0 चलाकर अक्षम कर सकते हैं।

इस आउटपुट के साथ, निर्माता आसानी से पहचान सकते हैं कि कब सिस्टम उपयोगकर्ता या घटक SELinux नीति का उल्लंघन कर रहे हैं। निर्माता तब इस खराब व्यवहार की मरम्मत कर सकते हैं, या तो सॉफ़्टवेयर, SELinux नीति, या दोनों में परिवर्तन करके।

विशेष रूप से, ये लॉग संदेश इंगित करते हैं कि प्रवर्तन मोड के तहत कौन सी प्रक्रियाएँ विफल होंगी और क्यों। यहाँ एक उदाहरण है:

avc: denied  { connectto } for  pid=2671 comm="ping" path="/dev/socket/dnsproxyd"
scontext=u:r:shell:s0 tcontext=u:r:netd:s0 tclass=unix_stream_socket

इस आउटपुट की व्याख्या इस प्रकार करें:

• उपरोक्त { connectto } की जा रही कार्रवाई का प्रतिनिधित्व करता है। अंत में tclass के साथ ( unix_stream_socket ), यह आपको मोटे तौर पर बताता है कि क्या किया जा रहा था। इस मामले में, कुछ यूनिक्स स्ट्रीम सॉकेट से कनेक्ट करने का प्रयास कर रहा था।
• scontext (u:r:shell:s0) आपको बताता है कि किस संदर्भ ने कार्रवाई शुरू की। इस मामले में यह कुछ खोल के रूप में चल रहा है।
• tcontext (u:r:netd:s0) आपको क्रिया के लक्ष्य का संदर्भ बताता है। इस मामले में, यह netd के स्वामित्व वाली एक netd है।
• शीर्ष पर comm="ping" आपको एक अतिरिक्त संकेत देता है कि इनकार उत्पन्न होने के समय क्या चल रहा था। इस मामले में, यह एक बहुत अच्छा संकेत है।

एक और उदाहरण:

adb shell su root dmesg | grep 'avc: '

आउटपुट:

<5> type=1400 audit: avc:  denied  { read write } for  pid=177
comm="rmt_storage" name="mem" dev="tmpfs" ino=6004 scontext=u:r:rmt:s0
tcontext=u:object_r:kmem_device:s0 tclass=chr_file

यहाँ इस इनकार से प्रमुख तत्व हैं:

• क्रिया - प्रयास की गई क्रिया को कोष्ठक, read write या setenforce में हाइलाइट किया गया है।
• अभिनेता - scontext (स्रोत संदर्भ) प्रविष्टि अभिनेता का प्रतिनिधित्व करती है, इस मामले में rmt_storage डेमन।
• वस्तु - tcontext (लक्ष्य संदर्भ) प्रविष्टि उस वस्तु का प्रतिनिधित्व करती है जिस पर कार्य किया जा रहा है, इस मामले में kmem।
• परिणाम - tclass (लक्षित वर्ग) प्रविष्टि उस वस्तु के प्रकार को इंगित करती है जिस पर कार्रवाई की जा रही है, इस मामले में एक chr_file (चरित्र उपकरण)।

डंपिंग उपयोगकर्ता और कर्नेल ढेर

कुछ मामलों में, इवेंट लॉग में निहित जानकारी इनकार की उत्पत्ति को इंगित करने के लिए पर्याप्त नहीं है। इनकार क्यों हुआ, इसे बेहतर ढंग से समझने के लिए कर्नेल और यूजरस्पेस सहित कॉल श्रृंखला को इकट्ठा करना अक्सर उपयोगी होता है।

हाल के कर्नेल avc:selinux_audited नाम के एक ट्रेसपॉइंट को परिभाषित करते हैं। इस ट्रेसपॉइंट को सक्षम करने और कॉलचेन को कैप्चर करने के लिए Android simpleperf का उपयोग करें।

समर्थित कॉन्फ़िगरेशन

• लिनक्स कर्नेल> = 5.10, विशेष रूप से एंड्रॉइड कॉमन कर्नेल शाखाएं मेनलाइन और एंड्रॉइड 12-5.10 समर्थित हैं। android12-5.4 शाखा भी समर्थित है। आप यह निर्धारित करने के लिए simpleperf का उपयोग कर सकते हैं कि क्या ट्रेसपॉइंट आपके डिवाइस पर परिभाषित है: adb root && adb shell simpleperf list | grep avc:selinux_audited । अन्य कर्नेल संस्करणों के लिए, आप dd81662 और 30969bc को चुन सकते हैं।
• आप जिस ईवेंट को डीबग कर रहे हैं उसे पुन: उत्पन्न करना संभव होना चाहिए। सिंपलपरफ का उपयोग करके बूट समय की घटनाओं का समर्थन नहीं किया जाता है; हालाँकि आप अभी भी ईवेंट को ट्रिगर करने के लिए सेवा को पुनः आरंभ करने में सक्षम हो सकते हैं।

कॉल चेन को कैप्चर करना

simpleperf record का उपयोग करके ईवेंट को रिकॉर्ड करने के लिए पहला कदम है:

adb shell -t "cd /data/local/tmp && su root simpleperf record -a -g -e avc:selinux_audited"

फिर, जिस घटना के कारण इनकार हुआ, उसे ट्रिगर किया जाना चाहिए। उसके बाद, रिकॉर्डिंग बंद कर दी जानी चाहिए। इस उदाहरण में, Ctrl-c का उपयोग करके, नमूना कैप्चर किया जाना चाहिए था:

^Csimpleperf I cmd_record.cpp:751] Samples recorded: 1. Samples lost: 0.

अंत में, कैप्चर किए गए स्टैकट्रेस का निरीक्षण करने के लिए simpleperf report का उपयोग किया जा सकता है। उदाहरण के लिए:

adb shell -t "cd /data/local/tmp && su root simpleperf report -g --full-callgraph"
[...]
Children  Self     Command  Pid   Tid   Shared Object                                   Symbol
100.00%   0.00%    dmesg    3318  3318  /apex/com.android.runtime/lib64/bionic/libc.so  __libc_init
       |
       -- __libc_init
          |
           -- main
              toybox_main
              toy_exec_which
              dmesg_main
              klogctl
              entry_SYSCALL_64_after_hwframe
              do_syscall_64
              __x64_sys_syslog
              do_syslog
              selinux_syslog
              slow_avc_audit
              common_lsm_audit
              avc_audit_post_callback
              avc_audit_post_callback

उपरोक्त कॉल चेन एक एकीकृत कर्नेल और यूजरस्पेस कॉल चेन है। यह आपको यूजरस्पेस से ट्रेस शुरू करके कर्नेल तक जहां इनकार होता है, कोड प्रवाह के बेहतर दृश्य के साथ देता है। simpleperf के बारे में अधिक जानकारी के लिए, Simpleperf निष्पादन योग्य आदेश संदर्भ देखें

अनुमति पर स्विच करना

SELinux प्रवर्तन को ADB के माध्यम से userdebug या eng बिल्ड पर अक्षम किया जा सकता है। ऐसा करने के लिए, पहले एडीबी रूट चलाकर adb root को रूट पर स्विच करें। फिर, SELinux प्रवर्तन को अक्षम करने के लिए, चलाएँ:

adb shell setenforce 0

या कर्नेल कमांड लाइन पर (प्रारंभिक डिवाइस लाने के दौरान):

androidboot.selinux=permissive
androidboot.selinux=enforcing

या Android 12 में bootconfig के माध्यम से:

androidboot.selinux=permissive
androidboot.selinux=enforcing

ऑडिट2अनुमति का उपयोग करना

audit2allow 2अनुमति उपकरण dmesg खंडन लेता है और उन्हें संबंधित SELinux नीति विवरण में परिवर्तित करता है। इस प्रकार, यह SELinux के विकास को अत्यधिक गति प्रदान कर सकता है।

इसका इस्तेमाल करने के लिए, दौड़ें:

adb pull /sys/fs/selinux/policy
adb logcat -b events -d | audit2allow -p policy

फिर भी, अनुमतियों को पार करने के लिए प्रत्येक संभावित जोड़ की जांच करने के लिए सावधानी बरतनी चाहिए। उदाहरण के लिए, फीडिंग audit2allow rmt_storage को निम्न सुझाए गए SELinux पॉलिसी स्टेटमेंट में पहले दिखाए गए परिणामों में दिखाया गया है:

#============= shell ==============
allow shell kernel:security setenforce;
#============= rmt ==============
allow rmt kmem_device:chr_file { read write };

यह rmt को कर्नेल मेमोरी, एक चमकदार सुरक्षा छेद लिखने की क्षमता प्रदान करेगा। अक्सर audit2allow कथन केवल एक प्रारंभिक बिंदु होते हैं। इन बयानों को नियोजित करने के बाद, आपको एक अच्छी नीति पर पहुंचने के लिए, स्रोत डोमेन और लक्ष्य के लेबल को बदलने के साथ-साथ उचित मैक्रोज़ को शामिल करने की आवश्यकता हो सकती है। कभी-कभी जांच की जा रही इनकार के परिणामस्वरूप कोई नीति परिवर्तन नहीं होना चाहिए; बल्कि आपत्तिजनक आवेदन को बदला जाना चाहिए।