แอปใดก็ตามที่มีสิทธิ์ INTERNET จะเข้าถึงอุปกรณ์ในเครือข่ายเฉพาะที่ (LAN) ได้
ซึ่งช่วยให้แอปเชื่อมต่อกับอุปกรณ์ในเครื่องได้ง่าย แต่ก็มีผลกระทบด้านความเป็นส่วนตัวด้วย เช่น การสร้างลายนิ้วมือของผู้ใช้ และการเป็นพร็อกซีสำหรับตำแหน่ง
โปรเจ็กต์การปกป้องเครือข่ายภายในมีจุดประสงค์เพื่อปกป้องความเป็นส่วนตัวของผู้ใช้โดยจำกัดการเข้าถึงเครือข่ายภายในด้วยสิทธิ์รันไทม์ใหม่
ผลกระทบ
ตั้งแต่ Android 17 (ระดับ API 37) เป็นต้นไป ระบบจะบังคับใช้การปกป้องเครือข่ายภายในสำหรับแอปที่กำหนดเป้าหมายเป็น Android 17 ขึ้นไป การกำหนดค่าการเลือกใช้ Android 16 ก่อนหน้านี้เลิกใช้งานแล้ว โปรดดูข้อกำหนดการใช้งานปัจจุบันที่หัวข้อการบังคับใช้ Android 17
แอปจะได้รับผลกระทบหากเข้าถึงเครือข่ายภายในของผู้ใช้โดยใช้สิ่งต่อไปนี้
- การใช้ซ็อกเก็ตข้อมูลดิบโดยตรงหรือการใช้ไลบรารีในที่อยู่เครือข่ายภายใน เช่น
Multicast DNS (mDNS)หรือSimple Service Discovery Protocol (SSDP) - การใช้คลาสระดับเฟรมเวิร์กที่เข้าถึงเครือข่ายภายใน เช่น
NsdManager
รายละเอียดผลกระทบ
การรับส่งข้อมูลไปยังและจากที่อยู่เครือข่ายภายในต้องได้รับสิทธิ์เข้าถึงเครือข่ายภายใน ตารางต่อไปนี้แสดงกรณีที่พบบ่อยบางกรณี
| การดำเนินการเครือข่ายระดับต่ำของแอป | ต้องมีสิทธิ์สำหรับเครือข่ายภายใน |
|---|---|
| การเชื่อมต่อ TCP ขาออก | ใช่ |
| การยอมรับการเชื่อมต่อ TCP ขาเข้า | ใช่ |
| การส่ง UDP แบบ Unicast, Multicast, Broadcast | ใช่ |
| การรับ UDP แบบ Unicast, Multicast, Broadcast ขาเข้า | ใช่ |
ข้อจำกัดเหล่านี้จะใช้ในสแต็กเครือข่ายระดับลึก จึงมีผลกับ API ของเครือข่ายทั้งหมด ซึ่งรวมถึงซ็อกเก็ตที่สร้างในแพลตฟอร์มหรือโค้ดที่มีการจัดการ ไลบรารีเครือข่าย เช่น Cronet และ OkHttp และ API ที่ติดตั้งใช้งานบนไลบรารีเหล่านั้น การพยายามแก้ไขบริการในเครือข่ายภายในที่มีคำต่อท้าย .local ต้องใช้สิทธิ์เข้าถึงเครือข่ายภายใน
ข้อยกเว้นสำหรับกฎก่อนหน้ามีดังนี้
- หากเซิร์ฟเวอร์ DNS ของอุปกรณ์อยู่ในเครือข่ายภายใน การรับส่งข้อมูลไปยัง/จากเซิร์ฟเวอร์ดังกล่าว (ที่พอร์ต 53) ไม่จำเป็นต้องมีสิทธิ์เข้าถึงเครือข่ายภายใน
- แอปพลิเคชันที่ใช้ตัวสลับเอาต์พุตเป็นเครื่องมือเลือกในแอปจะไม่ต้องใช้สิทธิ์เข้าถึงเครือข่าย LAN (จะมีคำแนะนำเพิ่มเติมในรุ่นต่อๆ ไป)
การบังคับใช้ Android 17
ตั้งแต่ Android 17 เป็นต้นไป การปกป้องเครือข่ายภายในเป็นข้อบังคับและมีผลบังคับใช้กับแอปที่กำหนดเป้าหมายเป็น Android 17 ขึ้นไป
| อัตราส่วน | Android 16 | Android 17 |
|---|---|---|
| SDK เป้าหมาย | 36 | 37 ขึ้นไป |
| สิทธิ์ | ใช้ NEARBY_WIFI_DEVICES ชั่วคราว | ACCESS_LOCAL_NETWORK |
| สิทธิ์เข้าถึงเริ่มต้น | การเข้าถึงเครือข่ายภายในเปิดอยู่ | เครือข่ายภายในจะถูกบล็อกโดยค่าเริ่มต้นสำหรับแอปทั้งหมดที่อัปเดต SDK เป้าหมาย |
| กลุ่มสิทธิ์ | เป็นส่วนหนึ่งของกลุ่มสิทธิ์ NEARBY_DEVICES ที่มีอยู่ | |
เพื่อยืนยันว่าฟังก์ชันการทำงานของแอปจะไม่ขัดข้องหลังจากการบังคับใช้ แอปพลิเคชันที่กำหนดเป้าหมายเป็น SDK 37 ขึ้นไปต้องใช้เส้นทางใดเส้นทางหนึ่งต่อไปนี้เพื่อจัดการการเข้าถึงเครือข่าย LAN
เส้นทาง ก: การใช้เครื่องมือเลือกที่รักษาความเป็นส่วนตัว
สำหรับงานการค้นพบและการเชื่อมต่อที่ระบบเป็นสื่อกลาง ให้ใช้เครื่องมือเลือกเพื่อหลีกเลี่ยงการขอสิทธิ์รันไทม์แบบกว้างทั้งหมด ใช้เครื่องมือเลือกต่อไปนี้ตามกรณีการใช้งานของคุณ
- สตรีมมิงสื่อ: แอปพลิเคชันที่รองรับ Google Cast จะใช้ฟีเจอร์ตัวสลับเอาต์พุตได้ ซึ่งช่วยให้นักพัฒนาแอปอนุญาตให้ผู้ใช้เลือกอุปกรณ์สตรีมมิงที่ต้องการได้โดยที่แอปไม่ต้องขอสิทธิ์
ACCESS_LOCAL_NETWORKในวงกว้าง - การเชื่อมต่อทั่วไป:
NsdManagerมีเครื่องมือเลือกบริการที่ระบบเรียกใช้สำหรับการค้นหา mDNS แทนที่แอปจะสแกนทั้งเครือข่าย ระบบจะแสดงกล่องโต้ตอบที่ให้ผู้ใช้เลือกอุปกรณ์เดียวเพื่อให้แอปเข้าถึง
val discoveryRequest = DiscoveryRequest.Builder("_http._tcp")
.setFlags(DiscoveryRequest.FLAG_SHOW_PICKER)
.build()
nsdManager.registerServiceInfoCallback(discoveryRequest, executor, object : NsdManager.ServiceInfoCallback {
override fun onServiceUpdated(serviceInfo: NsdServiceInfo) {
// Handle the user-selected and discovered service
// NsdServiceInfo.getHostAddresses() can now be connected to
// without ACCESS_LOCAL_NETWORK permission
}
})
เส้นทาง ข: การขอสิทธิ์รันไทม์ (สิทธิ์เข้าถึงแบบกว้าง)
เส้นทางนี้จำเป็นสำหรับกรณีการใช้งานที่ซับซ้อน เช่น ระบบอัตโนมัติในบ้านหรือการจัดการอุปกรณ์ IoT ที่ต้องการสิทธิ์เข้าถึงเครือข่ายภายในอย่างกว้างขวางและต่อเนื่อง
ประกาศสิทธิ์ในไฟล์ Manifest: ประกาศ
ACCESS_LOCAL_NETWORKอย่างชัดเจนในAndroidManifest.xmlขอสิทธิ์ที่รันไทม์: ก่อนพยายามเข้าถึงเครือข่ายภายใน แอปพลิเคชันต้องตรวจสอบว่าได้รับสิทธิ์แล้วหรือไม่ หากไม่เป็นเช่นนั้น ผู้ใช้จะต้องโทรหา
Activity.requestPermission()เพื่อเรียกใช้ข้อความแจ้งของระบบมาตรฐานสถานการณ์ที่ได้รับสิทธิ์ล่วงหน้า: สิทธิ์
ACCESS_LOCAL_NETWORKเป็นส่วนหนึ่งของกลุ่มสิทธิ์NEARBY_DEVICESหากผู้ใช้ได้ให้สิทธิ์อื่นในกลุ่มนี้แล้ว (เช่น สิทธิ์บลูทูธ) ระบบจะไม่แจ้งให้ผู้ใช้ให้สิทธิ์เข้าถึงเครือข่าย LAN อีกการจัดการการปฏิเสธและการเพิกถอน: แอปต้องจัดการกรณีที่ผู้ใช้ปฏิเสธคำขอหรือเพิกถอนสิทธิ์ในภายหลังในการตั้งค่าระบบอย่างเหมาะสม ในกรณีดังกล่าว ระบบจะบล็อกการจราจรของข้อมูลในเครือข่ายภายใน
กลยุทธ์ตัวนับการรีเซ็ตคำขอสิทธิ์
แพลตฟอร์มใช้กลยุทธ์การรีเซ็ตตัวนับที่จัดการสถานการณ์ที่การปฏิเสธกลุ่มสิทธิ์ NEARBY_DEVICES ก่อนหน้านี้ของแอป (ซึ่งตอนนี้รวมถึง ACCESS_LOCAL_NETWORK) ทำให้แอปไม่สามารถขอสิทธิ์หลังจากแสดงเหตุผลประกอบอย่างเพียงพอ กลไกนี้จะให้โอกาสเพิ่มเติมแก่แอปในการเรียกใช้ requestPermission() API ซึ่งจะรีเซ็ตจำนวนการปฏิเสธสำหรับสิทธิ์ ACCESS_LOCAL_NETWORK ได้อย่างมีประสิทธิภาพ ซึ่งจะช่วยให้สามารถดึงดูดผู้ใช้ให้กลับมามีส่วนร่วมอีกครั้งได้อย่างละเอียดยิ่งขึ้น โดยเฉพาะอย่างยิ่งเมื่อการปฏิเสธครั้งแรกเกิดขึ้นก่อนที่แอปจะสื่อสารความจำเป็นในการเข้าถึงเครือข่าย LAN สำหรับฟังก์ชันหลักได้
โมเดลสิทธิ์แบบแยก
สิทธิ์เข้าถึงเครือข่ายในเครื่องใช้กลยุทธ์การย้ายข้อมูลสิทธิ์แบบแยกเพื่อจัดการแอปพลิเคชันใหม่และแอปพลิเคชันเดิมแตกต่างกัน โดยอิงตาม SDK เป้าหมาย
| หมวดหมู่ | ระดับ SDK เป้าหมาย | ลักษณะการทำงานของการเข้าถึงเครือข่ายภายใน | การดำเนินการที่จำเป็นของนักพัฒนาแอป |
|---|---|---|---|
| แอปใหม่/แอปที่อัปเดต | >= 37 (Android 17) | บล็อกโดยค่าเริ่มต้น | ประกาศและขอสิทธิ์รันไทม์ ACCESS_LOCAL_NETWORK |
| แอปเดิม | < 37 | แอปที่มีสิทธิ์ INTERNET จะได้รับสิทธิ์โดยนัยสำหรับ ACCESS_LOCAL_NETWORK ซึ่งช่วยให้แอปยังคงเข้าถึงได้ ซึ่งเป็นมาตรการชั่วคราวและจะถูกบล็อกโดยค่าเริ่มต้นเมื่อแอปเพิ่ม SDK เป้าหมายเป็น 37 |
ไม่จำเป็นต้องเปลี่ยนแปลงโค้ดในทันที อย่าขอ ACCESS_LOCAL_NETWORK ขณะรันไทม์ก่อนกำหนดเป้าหมายเป็น SDK 37 |
กลยุทธ์ LNP ตามกรณีการใช้งาน
การแคสต์: สำหรับฟังก์ชันการแคสต์สื่อ กลยุทธ์ที่เหมาะสมที่สุดและรักษาความเป็นส่วนตัวคือการใช้ตัวสลับเอาต์พุต วิธีนี้ช่วยให้ระบบจัดการการค้นหาและการเชื่อมต่อเครือข่ายในเครื่องในนามของผู้ใช้ได้ จึงไม่จำเป็นต้องให้แอปขอสิทธิ์
ACCESS_LOCAL_NETWORKเบราว์เซอร์: การจัดการข้อผิดพลาดต้องใช้วิธีการที่แตกต่างกันตามโปรโตคอล ข้อผิดพลาด UDP จะส่งผลให้เกิดรหัสข้อผิดพลาด
EPERMสำหรับการเชื่อมต่อ TCP เบราว์เซอร์ควรใช้ NDK APIandroid_getnetworkblockedreason(int sockFd)เพื่อตรวจสอบว่า LNP บล็อกแพ็กเก็ตหรือไม่ API นี้จะแสดงผลANDROID_NETWORK_BLOCKED_REASON_LNPกรณีการใช้งานอื่นๆ (เช่น IoT): แอปพลิเคชันที่ค้นหาอุปกรณ์โดยใช้ mDNS ควรใช้
android.net.nsd.DiscoveryRequest#FLAG_SHOW_PICKERซึ่งช่วยให้ค้นหาอุปกรณ์ได้โดยไม่ต้องขอสิทธิ์ และใช้NsdManager#registerServiceInfoCallback/NsdManager#resolveServiceเพื่อรับที่อยู่ IP การเชื่อมต่อกับที่อยู่ IP ที่ได้มาด้วยวิธีนี้ไม่จำเป็นต้องใช้สิทธิ์ACCESS_LOCAL_NETWORK
สำหรับแอปพลิเคชันที่ต้องมีการสื่อสารผ่านเครือข่ายภายในโดยตรงและไม่สามารถใช้เครื่องมือเลือกที่ระบบเป็นสื่อกลางได้ แนวทางที่แนะนำคือการใช้กลยุทธ์ตัวนับการรีเซ็ตสิทธิ์เมื่อกำหนดเป้าหมายเป็น Android 17 (SDK 37) ขึ้นไป หากผู้ใช้เพิกถอนสิทธิ์ ACCESS_LOCAL_NETWORK กลไกนี้จะให้โอกาสเพิ่มเติมแก่แอปในการขอสิทธิ์อีกครั้ง ซึ่งช่วยให้นักพัฒนาแอปแสดงเหตุผลที่ชัดเจนยิ่งขึ้นแก่ผู้ใช้ได้
คำแนะนำสำหรับ Android 16 (เลิกใช้งานแล้ว)
หากต้องการเลือกใช้ข้อจำกัดของเครือข่ายภายในใน Android 16 ให้ทำดังนี้
- แฟลชอุปกรณ์เป็นบิลด์ที่มี Android 16 เบต้า 3 ขึ้นไป
- ติดตั้งแอปที่จะทดสอบ
สลับการกำหนดค่า Appcompat โดยใช้ adb
adb shell am compat enable RESTRICT_LOCAL_NETWORK <package_name>รีบูตอุปกรณ์
ตอนนี้สิทธิ์เข้าถึงเครือข่ายภายในของแอปถูกจำกัด และการพยายามเข้าถึงเครือข่ายภายในจะทำให้เกิดข้อผิดพลาดเกี่ยวกับซ็อกเก็ต
หากคุณใช้ API ที่ดำเนินการกับเครือข่ายภายในนอกกระบวนการของแอป (เช่น NsdManager) API ดังกล่าวจะไม่ได้รับผลกระทบในระหว่างการเลือกใช้
หากต้องการคืนค่าสิทธิ์เข้าถึง คุณต้องให้สิทธิ์ของแอปเข้าถึง NEARBY_WIFI_DEVICES
- ตรวจสอบว่าแอปประกาศสิทธิ์
NEARBY_WIFI_DEVICESในmanifest - ไปที่การตั้งค่า > แอป > [ชื่อแอป] > สิทธิ์ > อุปกรณ์ที่อยู่ใกล้เคียง > อนุญาต
ตอนนี้สิทธิ์เข้าถึงเครือข่าย LAN ของแอปควรได้รับการกู้คืนแล้ว และสถานการณ์ทั้งหมดควรทำงานเหมือนก่อนที่จะเลือกใช้แอป ผลกระทบต่อการจราจรของข้อมูลในเครือข่ายของแอปมีดังนี้
| สิทธิ์ | คำขอ LAN ขาออก | คำขออินเทอร์เน็ตขาออก/ขาเข้า | คำขอ LAN ขาเข้า |
|---|---|---|---|
| ให้สิทธิ์ | Works | Works | Works |
| ไม่ได้รับสิทธิ์ | เรื่องหน้าแตก | Works | เรื่องหน้าแตก |
ใช้คำสั่งต่อไปนี้เพื่อปิดการกำหนดค่า Appcompat
adb shell am compat disable RESTRICT_LOCAL_NETWORK <package_name>
ข้อผิดพลาด
หากคำขอเข้าถึงเครือข่าย LAN ไม่สำเร็จเนื่องจากไม่มีสิทธิ์ ให้ทำดังนี้
การเชื่อมต่อ TCP มักจะส่งผลให้เกิดข้อผิดพลาดการหมดเวลา
ข้อผิดพลาด UDP และการปฏิเสธสิทธิ์ทั่วไปมักจะส่งผลให้เกิดรหัสข้อผิดพลาด EPERM
ข้อบกพร่อง
ส่งข้อบกพร่องและความคิดเห็นสำหรับรายการต่อไปนี้
- ความคลาดเคลื่อนในการเข้าถึง LAN (คุณไม่คิดว่าการเข้าถึงบางอย่างควรได้รับการพิจารณาว่าเป็นการเข้าถึง "เครือข่ายในพื้นที่")
- ข้อบกพร่องที่ควรบล็อกการเข้าถึง LAN แต่ไม่บล็อก
- ข้อบกพร่องที่การเข้าถึง LAN ถูกบล็อกทั้งที่ไม่ควรบล็อก
รายการต่อไปนี้ไม่ควรได้รับผลกระทบจากการเปลี่ยนแปลงนี้
- การเข้าถึงอินเทอร์เน็ต
- เครือข่ายมือถือ