NetworkExtension في Swift: دليل شامل لإدارة VPN وتوسيعات الشبكة

1. ما هو NetworkExtension ولماذا تحتاجه؟

NetworkExtension هو إطار عمل قوي من Apple يتيح للمطورين الوصول إلى وظائف الشبكة ذات المستوى المنخفض على أجهزة iOS وmacOS وtvOS وwatchOS. على عكس التطبيقات العادية التي تعمل في "صندوق رمل" (sandbox) معزول، يسمح NetworkExtension بإنشاء توسيعات نظام يمكنها اعتراض حركة مرور الشبكة وتصفيتها وإعادة توجيهها وتشفيرها على مستوى نظام التشغيل. إنها ليست مكتبة بالمعنى التقليدي (مثل Alamofire أو Moya)، بل هي مجموعة من واجهات برمجة التطبيقات (API) لإنشاء عمليات شبكة متميزة.

الاستخدام الرئيسي لـ NetworkExtension هو إنشاء عملاء VPN (بما في ذلك بروتوكولات IKEv2 وIPSec وWireGuard والبروتوكولات المخصصة)، ومرشحات المحتوى (الرقابة الأبوية، حظر الإعلانات على مستوى DNS)، وخوادم الوكيل، وأدوات مراقبة حركة المرور. بدون هذا الإطار، من المستحيل تنفيذ VPN كامل على أجهزة Apple دون كسر الحماية (jailbreak). كما يُستخدم في التطبيقات المؤسسية للوصول الآمن إلى الموارد الداخلية.

بالنسبة لموقع PythonLib التعليمي، من المهم أن نفهم أن NetworkExtension هو إطار عمل أصلي بلغة Swift/Objective-C، ولا يتم تثبيته عبر مديري الحزم (pip, npm). إنه جزء من Xcode SDK ويتطلب إعداد أذونات خاصة (entitlements) وتوقيع الكود بالإمكانيات المناسبة. في هذه المقالة، سنستعرض المكونات الرئيسية: NETunnelProviderManager وNEPacketTunnelProvider وNEVPNManager وNEFilterProvider وغيرها.

2. التثبيت والإعداد

نظرًا لأن NetworkExtension جزء من SDK النظام، فإن "تثبيته" يقتصر على التكوين الصحيح لمشروع Xcode. لا حاجة لأوامر pip install أو npm install. إليك التعليمات خطوة بخطوة:

1. أنشئ مشروعًا جديدًا في Xcode (iOS أو macOS).
2. أضف Target جديدًا: File → New → Target. اختر "Network Extension" من القائمة. سيُطلب منك اختيار نوع التوسعة: Packet Tunnel Provider (لـ VPN المخصص)، Filter Data Provider (للتصفية)، DNS Proxy، إلخ.
3. إعداد Entitlements: في المشروع الرئيسي (وليس في التوسعة)، افتح ملف .entitlements وأضف المفتاح com.apple.developer.networking.vpn.api بقيمة allow. لبعض الوظائف (مثل التصفية)، قد تحتاج إلى com.apple.developer.networking.networkextension.
4. App ID وProvisioning Profile: في Apple Developer Console، أنشئ App ID مع تفعيل إمكانية "Network Extensions". حمّل وثبّت Provisioning Profile جديدًا يتضمن هذه الإمكانية.
5. توقيع الكود: تأكد من أن التطبيق الرئيسي والتوسعة موقّعان بنفس الشهادة والملف الشخصي.

بعد ذلك، يمكنك استيراد الوحدة في كود التوسعة:

import NetworkExtension

للتطبيق الرئيسي (الذي يدير التوسعة)، تحتاج أيضًا إلى استيراد هذه الوحدة.

3. البداية السريعة: مثال عملي بسيط (VPN)

لنقم بإنشاء عميل VPN بسيط يتصل بالخادم. هذا الكود يُنفَّذ في Packet Tunnel Provider (التوسعة).

import NetworkExtension

class PacketTunnelProvider: NEPacketTunnelProvider {

    override func startTunnel(options: [String : NSObject]? = nil) async throws {
        // إعداد معلمات النفق
        let tunnelNetworkSettings = NEPacketTunnelNetworkSettings(tunnelRemoteAddress: "192.168.1.1")
        tunnelNetworkSettings.mtu = 1400
        
        // إعداد DNS
        let dnsSettings = NEDNSSe