لوحة Telescope مفتوحة على موقع Laravel: أغلقها قبل كشف البيانات
باختصار: إذا كان موقعك أو نظام الحجز عندك مبنياً بـ Laravel وجرّبت فتح الرابط /telescope على النطاق الحقيقي فظهرت لك لوحة فيها طلبات الزوار واستعلامات قاعدة البيانات والرسائل المرسلة، فهذه لوحة تشخيص مكشوفة للعامة. السبب الأشهر أن متغير APP_ENV على الخادم ما زال local، أو أن بوابة الصلاحية viewTelescope لم تُضبط. الحل: اجعل APP_ENV=production وAPP_DEBUG=false، وحدّد في البوابة من يحق له الدخول بالضبط، أو لا تحمّل Telescope على خادم الإنتاج أصلاً.
ما هي لوحة Telescope ولماذا هي حساسة؟
Telescope أداة رسمية من Laravel تساعد المطور أثناء البناء. حسب توثيق Laravel، تعرض اللوحة الطلبات القادمة إلى التطبيق، والأخطاء، وسجلات اللوغ، واستعلامات قاعدة البيانات، والمهام في الطابور، والرسائل البريدية، والإشعارات، وعمليات الكاش، والمهام المجدولة، وغيرها. والمراقب الخاص بالطلبات يسجل الطلب نفسه، والترويسات (headers)، وبيانات الجلسة، وبيانات الاستجابة.
هذا رائع على جهاز المطور. لكن على الموقع الحقيقي، معنى ذلك أن أي شخص يصل إلى اللوحة قد يرى أسماء الزبائن وأرقام هواتفهم وعناوينهم كما وصلت في نماذج الحجز أو الطلب، ونصوص الرسائل التي أرسلها النظام، واستعلامات قاعدة البيانات التي تكشف أسماء الجداول والحقول. أي أن اللوحة نافذة مفتوحة على داخل النظام.
مثال توضيحي: نظام حجز عيادة في إربد
عيادة أسنان في إربد طلبت من مطور مستقل نظام حجز مواعيد بـ Laravel. أثناء التطوير ثبّت المطور Telescope ليتابع الأخطاء، ثم رفع المشروع إلى الخادم ونسخ ملف .env من جهازه كما هو. بعد أسابيع، لاحظ موظف في العيادة أن كتابة النطاق متبوعاً بـ /telescope تفتح لوحة سوداء فيها كل طلبات الحجز: اسم المراجع، ورقم هاتفه، والموعد، ونص رسالة التأكيد.
لم يكن هناك اختراق بالمعنى المعروف. كل ما حدث أن الخادم كان يعتقد أنه بيئة تطوير محلية، فسمح للجميع بالدخول. هذا المثال توضيحي، لكنه نمط يتكرر عند تسليم المشاريع على عجل.
لماذا تُفتح اللوحة للجميع؟
يوضح توثيق Laravel أن لوحة Telescope متاحة عبر المسار /telescope، وأنها بشكل افتراضي لا تُفتح إلا في البيئة المحلية (local). في أي بيئة أخرى، تتحكم في الدخول بوابة صلاحية (gate) اسمها viewTelescope موجودة في ملف app/Providers/TelescopeServiceProvider.php.
ثم يضيف التوثيق تحذيراً صريحاً: يجب أن تغيّر متغير APP_ENV إلى production في بيئة الإنتاج، وإلا ستكون لوحة Telescope متاحة للعامة. إذن المشكلة غالباً واحدة من ثلاث:
- ملف .env على الخادم فيه APP_ENV=local لأنه نُسخ من جهاز المطور.
- البوابة viewTelescope معدّلة لتسمح لأي مستخدم مسجّل دخوله، والموقع يسمح لأي زائر بإنشاء حساب.
- البيئة صحيحة، لكن أحدهم عدّل الكود ليتجاوز البوابة أثناء تجربة ونسي إعادته.
الخطوة الأولى: صحّح متغيرات البيئة
افتح ملف .env على خادم الإنتاج (لا على جهازك) وتأكد من سطرين:
- APP_ENV=production
- APP_DEBUG=false
السطر الثاني مهم بنفس القدر. توثيق إعدادات Laravel يقول إن قيمة APP_DEBUG في الإنتاج يجب أن تكون false دائماً، لأن تركها true يعرّضك لكشف قيم إعدادات حساسة للمستخدمين عند ظهور أي خطأ.
بعد التعديل، إذا كنت تستخدم كاش الإعدادات، أعد بناءه حتى يقرأ التطبيق القيم الجديدة. ثم افتح /telescope من متصفح خاص لست مسجلاً فيه، يجب أن تحصل على رفض الدخول.
الخطوة الثانية: اضبط بوابة viewTelescope بدقة
إذا كنت تحتاج Telescope على الخادم الحقيقي فعلاً لتتبع مشكلة، فالبوابة هي خط الدفاع. في ملف TelescopeServiceProvider ستجد دالة gate تعرّف viewTelescope. المثال في التوثيق يسمح بالدخول فقط لمستخدمين بريدهم ضمن قائمة محددة.
النصيحة العملية:
- ضع في القائمة بريد المطور المسؤول فقط، لا كل الموظفين.
- لا تجعل الشرط «أي مستخدم مسجل». في موقع متجر أو عيادة، تسجيل الزبائن مفتوح غالباً، فيصبح أي زبون قادراً على رؤية بيانات غيره.
- إذا كان عندك نظام أدوار، اربط البوابة بدور واضح مثل مدير تقني، وراجع من يملك هذا الدور.
الخطوة الثالثة: فكّر في عدم تثبيته على الإنتاج أصلاً
يذكر التوثيق خياراً اسمه التثبيت المحلي فقط: تثبيت الحزمة باستخدام composer require laravel/telescope --dev. بعد ذلك يطلب التوثيق إزالة تسجيل TelescopeServiceProvider من ملف bootstrap/providers.php، وتسجيل مزودات Telescope يدوياً داخل AppServiceProvider بشرط أن تكون البيئة local. كما يطلب منع الاكتشاف التلقائي للحزمة بإضافة laravel/telescope إلى قائمة dont-discover في قسم extra داخل composer.json.
بهذا الشكل، عندما يثبّت الخادم الحزم بدون حزم التطوير، لا تكون Telescope موجودة على الخادم من الأساس، ولا يوجد ما يُكشف. هذا الخيار هو الأنسب لمعظم مواقع الشركات الصغيرة، لأن المطور يتتبع الأخطاء على جهازه أو في بيئة تجريبية منفصلة.
إذا كانت اللوحة مكشوفة فترة: ماذا تفعل بعد الإغلاق؟
إغلاق اللوحة يوقف التسريب من الآن فصاعداً، لكن البيانات التي سجلتها ما زالت محفوظة في جدول telescope_entries بقاعدة البيانات. خطوات معقولة بعد الإغلاق:
- احذف السجلات القديمة. التوثيق يذكر أمر telescope:prune لحذف السجلات، ويمكن تحديد عمرها، مثل حذف ما هو أقدم من 48 ساعة باستخدام الخيار --hours=48.
- جدول الأمر ليعمل يومياً كما يقترح التوثيق، لأن الجدول بدون تنظيف يتضخم بسرعة.
- غيّر أي كلمات مرور أو مفاتيح ربما ظهرت في الطلبات المسجلة، مثل مفاتيح خدمات الرسائل أو بوابات الربط.
- راجع سجلات الخادم لترى إن كان أحد من خارج فريقك زار المسار /telescope، حتى تعرف حجم المشكلة.
- إذا كانت بيانات زبائن قد ظهرت، تحقق من القواعد المطبقة عليك بخصوص إبلاغهم.
قلّل ما تسجله Telescope حتى لو كانت محمية
حتى لو كانت البوابة مضبوطة، من الأفضل ألا تسجل اللوحة أكثر من اللازم:
- يعرض التوثيق مثالاً يستدعي hideSensitiveRequestDetails داخل مزود الخدمة، لإخفاء تفاصيل الطلب الحساسة في غير البيئة المحلية.
- يمكن استخدام Telescope::filter لتسجيل ما يهمك فقط خارج البيئة المحلية، كالأخطاء القابلة للإبلاغ والمهام الفاشلة، بدل كل طلب.
- مراقب الطلبات يقبل خيار size_limit بالكيلوبايت لتحديد حجم بيانات الاستجابة المسجلة.
- يمكنك إيقاف جمع البيانات كلياً عبر الإعداد enabled المرتبط بالمتغير TELESCOPE_ENABLED.
قائمة فحص سريعة قبل تسليم أي مشروع Laravel
- هل APP_ENV على الخادم production؟
- هل APP_DEBUG على الخادم false؟
- هل /telescope يرفض زائراً غير مسجل؟
- هل يرفض زبوناً عادياً مسجلاً؟
- هل Telescope مثبتة كحزمة تطوير فقط إن لم يكن لها حاجة على الخادم؟
- هل يوجد أمر telescope:prune مجدول إن كانت مثبتة؟
اطلب من المطور تنفيذ هذه القائمة أمامك عند التسليم، فهي لا تأخذ أكثر من دقائق.
أسئلة شائعة
ليش رابط /telescope بيفتح لأي حدا على موقعي؟
غالباً لأن APP_ENV على الخادم ما زال local، وفي البيئة المحلية تسمح Telescope بالدخول دون بوابة. غيّره إلى production.
هل يكفي أن أخفي الرابط ولا أنشره؟
لا. المسار /telescope معروف لكل من يعرف Laravel، وإخفاؤه لا يحميه. الحماية تأتي من البيئة والبوابة.
هل APP_DEBUG له علاقة؟
هو إعداد منفصل، لكن تركه true في الإنتاج قد يكشف إعدادات حساسة في صفحات الأخطاء، حسب توثيق Laravel. اجعله false.
هل أحذف Telescope نهائياً؟
إذا لم تكن تحتاجها على الخادم، فالتثبيت كحزمة تطوير فقط هو الأسلم. وإن احتجتها، اضبط البوابة وقلّل ما تسجله ونظّف السجلات دورياً.
إذا لم تكن متأكداً مما يظهر للعامة في نظامك المبني بـ Laravel، راسلنا ونفحص معك لوحات التشخيص والإعدادات قبل أن يراها غيرك.