สิทธิ์เข้าถึงเครือข่ายภายใน

แอปใดก็ตามที่มีสิทธิ์ 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 API android_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 ให้ทำดังนี้

  1. แฟลชอุปกรณ์เป็นบิลด์ที่มี Android 16 เบต้า 3 ขึ้นไป
  2. ติดตั้งแอปที่จะทดสอบ
  3. สลับการกำหนดค่า Appcompat โดยใช้ adb

    adb shell am compat enable RESTRICT_LOCAL_NETWORK <package_name>
    
  4. รีบูตอุปกรณ์

ตอนนี้สิทธิ์เข้าถึงเครือข่ายภายในของแอปถูกจำกัด และการพยายามเข้าถึงเครือข่ายภายในจะทำให้เกิดข้อผิดพลาดเกี่ยวกับซ็อกเก็ต หากคุณใช้ 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 ถูกบล็อกทั้งที่ไม่ควรบล็อก

รายการต่อไปนี้ไม่ควรได้รับผลกระทบจากการเปลี่ยนแปลงนี้

  • การเข้าถึงอินเทอร์เน็ต
  • เครือข่ายมือถือ