التطبيق لا يجلب البيانات: خادم http يحجبه أندرويد وآيفون
باختصار: إذا كان تطبيق متجرك أو عيادتك يعمل على المحاكي أو على هاتف قديم ثم يفشل في جلب البيانات على الهواتف الحديثة، أو يعمل على أندرويد ولا يعمل على آيفون، فالسبب الشائع أن عنوان الواجهة البرمجية يبدأ بـ http لا https. أندرويد يمنع الاتصال غير المشفر افتراضياً في التطبيقات التي تستهدف Android 9 أو أحدث، وآيفون يفرض HTTPS عبر App Transport Security. الحل الصحيح تفعيل HTTPS على الخادم وتغيير العنوان، لا فتح الاستثناءات للتطبيق كله.
كيف تظهر المشكلة
شركة توصيل صغيرة في عمّان طلبت تطبيقاً لطلب الخدمة، والخادم الذي يقدم البيانات أُعد على عجل بعنوان مثل http://api.example.jo. أثناء التطوير عمل كل شيء. بعد رفع نسخة تجريبية للفريق، بدأت الشكاوى: قائمة الخدمات فارغة، وزر الطلب لا يستجيب، ورسالة عامة مثل «تعذر الاتصال». الغريب أن الموقع نفسه يفتح في متصفح الهاتف دون مشكلة.
الفرق أن المتصفح يعرض الصفحة مع تحذير «غير آمن»، أما التطبيق فيرفض الاتصال بصمت، لأن النظام نفسه يمنعه. وغالباً لا يظهر هذا للمستخدم كخطأ واضح، بل كشاشة فارغة.
ماذا يفعل أندرويد
يشرح توثيق أندرويد أن المطورين يستطيعون اختيار السماح بالاتصال غير المشفر أو منعه، ويقصد به استخدام HTTP بدل HTTPS. ويحدد التوثيق السلوك الافتراضي حسب مستوى الواجهة المستهدف:
- حتى Android 8.1، أي المستوى 27، يكون الاتصال غير المشفر مسموحاً افتراضياً.
- بدءاً من Android 9، أي المستوى 28، يكون معطلاً افتراضياً، والتطبيقات التي تحتاجه يجب أن تختار السماح به صراحة.
وفي توثيق عنصر application، يذكر أندرويد أنه عندما يكون الاتصال غير المشفر ممنوعاً، ترفض مكونات النظام، مثل مكدسات HTTP وFTP ومدير التنزيلات ومشغل الوسائط، طلبات التطبيق غير المشفرة، ويُشجَّع مطورو المكتبات الخارجية بقوة على احترام هذا الإعداد. ولهذا قد يفشل تحميل صورة أو ملف صوتي من رابط http حتى لو كان باقي التطبيق يعمل.
ماذا يفعل آيفون
بحسب توثيق Apple، تفرض ميزة App Transport Security أن تستخدم اتصالات HTTP التي يجريها التطبيق عبر نظام الاتصالات القياسي بروتوكول HTTPS، وتضيف فحوصاً أمنية فوق التحقق المعتاد من الخادم، وتحجب الاتصالات التي لا تلبي الحد الأدنى من المواصفات. ويذكر التوثيق أن الميزة تعمل افتراضياً للتطبيقات المبنية بأدوات iOS 9.0 أو أحدث.
لذلك قد يعمل التطبيق على أندرويد في مرحلة ما، لأن أحدهم أضاف استثناء هناك، ويفشل على آيفون، أو العكس.
لماذا كان يعمل أثناء التطوير
أسباب شائعة:
- المطور فعّل السماح بالاتصال غير المشفر في نسخة التطوير فقط، وبقيت نسخة الإصدار بالإعداد الافتراضي.
- الاختبار تم على هاتف أو محاكٍ بنسخة قديمة.
- الاتصال أثناء التطوير كان إلى خادم محلي على الشبكة نفسها، ثم تغير العنوان عند النشر.
- أدوات التطوير لبعض الأطر تضيف استثناءات تلقائياً لنسخة التطوير.
كيف تتأكد أن هذا هو السبب
قبل تغيير أي شيء، تأكد من التشخيص حتى لا تضيع وقتاً على سبب آخر:
- افتح عنوان الواجهة الذي يستخدمه التطبيق، وانظر هل يبدأ بـ http أم https.
- في أندرويد، شغّل التطبيق موصولاً بأدوات المطور وراقب السجل أثناء فتح الشاشة الفارغة. رسالة تذكر أن الاتصال غير المشفر إلى النطاق غير مسموح بها تحسم الأمر.
- في آيفون، يظهر في سجل Xcode خطأ يشير إلى App Transport Security عند محاولة الاتصال.
- جرّب الهاتف نفسه على شبكة أخرى. إذا بقيت المشكلة، فالأرجح أنها في الإعداد لا في الشبكة.
إذا كان العنوان https أصلاً ولا تظهر هذه الرسائل، فابحث في مكان آخر، مثل شهادة منتهية أو خادم لا يرد.
الحل الصحيح: HTTPS على الخادم
أي استثناء في التطبيق هو التفاف على المشكلة، لا حل لها. توثيق أندرويد يوضح السبب الرئيسي لتجنب الاتصال غير المشفر: غياب السرية والأصالة والحماية من التلاعب، إذ يستطيع مهاجم على الشبكة التنصت على البيانات وتعديلها دون أن يُكتشف. وتطبيق طلب خدمة ينقل أسماء الزبائن وأرقام هواتفهم وعناوين بيوتهم.
ويقول توثيق Apple صراحة إن عليك دائماً البحث عن طرق لتحسين أمان الخادم قبل إضافة استثناءات، وإن تخفيف قيود ATS يقلل أمان التطبيق.
الخطوات العملية:
- فعّل شهادة TLS على النطاق الذي يقدم الواجهة البرمجية.
- تأكد أن الخادم يعمل على https ويرد بشكل سليم من المتصفح دون تحذيرات.
- غيّر عنوان الواجهة في إعدادات التطبيق إلى https.
- ابحث في الكود والبيانات عن أي روابط http ثابتة، خصوصاً روابط الصور والملفات القادمة من الخادم.
- أصدر نسخة جديدة من التطبيق.
النقطة الرابعة يغفلها كثيرون: قد تكون الواجهة نفسها على https، لكنها تعيد روابط صور بـ http محفوظة في قاعدة البيانات منذ سنوات، فتظهر القائمة بلا صور.
إذا كنت مضطراً إلى استثناء مؤقت
أحياناً يتصل التطبيق بخادم لا تملكه، مثل جهاز قديم أو خدمة خارجية لم تنتقل إلى HTTPS بعد. هنا اجعل الاستثناء لنطاق واحد فقط، لا للتطبيق كله.
في أندرويد، يعرض التوثيق ملف إعدادات أمان الشبكة الذي يسمح بالاتصال غير المشفر لنطاق محدد:
<network-security-config>
<domain-config cleartextTrafficPermitted="true">
<domain includeSubdomains="true">legacy.example.jo</domain>
</domain-config>
</network-security-config>
النطاق هنا مثال توضيحي. ويذكر التوثيق أن السماح لكل النطاقات عبر base-config إعداد غير آمن يجب تجنبه قدر الإمكان. ويذكر توثيق عنصر application أن الخاصية usesCleartextTraffic في طريقها إلى الإهمال، وأن ملف إعدادات أمان الشبكة هو الطريقة الموصى بها للتحكم في هذا الأمر.
وفي آيفون، يذكر توثيق Apple أن مفتاح NSAppTransportSecurity في ملف Info.plist يقبل قاموس إعدادات، وأن قسم استثناءات النطاقات يسمح بإدارة الإعدادات لكل نطاق على حدة. استخدمه للنطاق المحدد فقط، ولا تستخدم الاستثناء الشامل.
مثال توضيحي: تطبيق شركة توصيل
هذا مثال توضيحي لطريقة المعالجة، وليس حالة حقيقية. شركة التوصيل تكتشف أن عنوان الواجهة يبدأ بـ http. يفعّل المطور شهادة على النطاق، ويغير العنوان في التطبيق، ثم يجد أن روابط صور الخدمات في قاعدة البيانات ما زالت http، فيحدثها. بعدها يزيل استثناء الاتصال غير المشفر الذي كان قد أضافه لنسخة التطوير، ويرفع نسخة جديدة تعمل على أندرويد وآيفون بالإعداد الافتراضي.
أسئلة شائعة
ليش التطبيق ما بجيب بيانات على الموبايلات الجديدة؟
غالباً لأن عنوان الخادم يبدأ بـ http، وأندرويد 9 وما بعده يمنع ذلك افتراضياً. انقل الخادم إلى https وغير العنوان.
بشتغل على أندرويد وما بشتغل على آيفون، شو السبب؟
قد يكون هناك استثناء في نسخة أندرويد، بينما يفرض آيفون HTTPS عبر App Transport Security. الحل نفسه: HTTPS على الخادم.
هل بفتح الاتصال العادي لكل التطبيق وبخلص؟
لا. التوثيق يحذر من ذلك. إذا اضطررت فاجعل الاستثناء لنطاق واحد مؤقتاً، وانقل الخادم إلى HTTPS في أقرب وقت.
إذا كان تطبيقك يعرض شاشات فارغة على بعض الهواتف ولا تعرف السبب، تواصل معنا ونفحص الاتصال بين التطبيق والخادم ونصلحه من الجهة الصحيحة.