تنقيح Apple TV

من بين المنصّات الأربع، Apple TV أصعبها تنقيحاً، لأسباب لا علاقة لها بـ Chute: فـ tvOS بلا متصفح، وبلا ورقة مشاركة، وبلا متصفح ملفات، وبلا طريقة لتثبيت شهادة من الجهاز نفسه، وفي يدك جهاز تحكم عن بعد بدل لوحة مفاتيح. ويجيب Chute tvOS عن كل نقطة من هذه بنقل الواجهة إلى مكان آخر — إلى متصفح على هاتفك أو جهاز Mac، أو إلى رمز QR، أو إلى نافذة Dashboard.

ولهذا يختلف شكل هذا الدليل عن الدليلين الآخرين: كل شيء تقريباً يحدث خارج التلفاز.

1. إيصال ملف إعدادات إلى التلفاز

لا أحد يريد تحرير الإعدادات بجهاز التحكم مرتين، فاكتبها في مكان آخر وأرسلها. على Apple TV يقدّم Add Configuration From... ثلاثة مسارات:

• Upload File Via Wi-Fi or Chute iOS — يفتح التلفاز مستمع HTTP محلياً ويعرض رابطاً ورمز QR. افتح ذلك الرابط في أي متصفح وارفع الملف، أو امسح الرمز بـ Chute iOS. ويفتح مخطط الرابط chute://tv شاشة الاستيراد نفسها مباشرة في تطبيق الهاتف.
• Download From URL — يجلب التلفاز الإعدادات بنفسه. وهو أقل المسارات الثلاثة كتابةً، إن كان الملف في مكان يستطيع الوصول إليه.
• Blank Configuration — ملف فارغ تحرّره على الجهاز.

في مسار الرفع يجب أن يكون التلفاز والجهاز الآخر على شبكة Wi-Fi نفسها، ولا يوجد المستمع إلا ما دامت تلك الشاشة مفتوحة — ومغادرتها أو قفل الجهاز يلغي النقل.

2. شغّل المستمعَين اللذين ستستخدمهما فعلاً

كلاهما مطفأ افتراضياً، وبلا واحد منهما على الأقل لا سبيل إلى تنقيح Apple TV. وكلاهما مجاني — فالترخيص في لوحة التحكم على هذه المنصّة يغطي صفوف خادم البروكسي المحلي ومسجّل الحركة، لا هذين.

HTTP Control API + Web Console — أي وحدة تحكم الويب، حيث تقيم المحتويات وتصدير HAR والتشخيص:

[General]
external-http-controller = 0.0.0.0:9090
external-http-secret = your-own-token
external-http-ui = true

اربطها بـ 0.0.0.0 لا بـ 127.0.0.1: فوحدة التحكم المربوطة بالعنوان الاسترجاعي لا يمكن فتحها من جهاز آخر، ولا يوجد على التلفاز متصفح يفتحها محلياً. والربط بغير العنوان الاسترجاعي يستلزم external-http-secret صريحاً، وإلا رفض المتحكم أن يبدأ.

External Controller Access — القناة الثنائية التي تتكلمها Chute Dashboard. في محرر الإعدادات افتح External Controller:

1. شغّل External Controller Access.
2. اضبط Port (الافتراضي هنا 6171) وPassword من عندك؛ ولا يجوز أن تكون فارغة.
3. شغّل Allow Access From Wi-Fi. على Apple TV ليس هذا اختيارياً كما في الهاتف — إذ لا يوجد مسار كابل بديل، فمع إطفائه لا يستطيع شيء خارج التلفاز الاتصال.

ما ينبغي أن تراه في لوحة التحكم: HTTP API Port وWeb Console بحالة On، وExternal Access Port يعرض منفذك. وغياب ذلك يعني أن النفق يعمل بنسخة قديمة من الإعدادات — أعد تشغيله.

3. فتح وحدة التحكم من جهاز آخر

في لوحة التحكم صف Web Console Address، على بُعد بضعة صفوف تحت مفتاح Web Console. اختره:

• إن كان المستمع قابلاً للوصول من أجهزة أخرى عرض التلفاز رمز QR. امسحه بهاتف على الشبكة نفسها، أو اكتب العنوان في أي متصفح. ورمز تسجيل الدخول يسافر داخل الرمز بدل أن يُعرض على الشاشة، فلا يحتاج أحد إلى نسخ 32 محرفاً ست عشرياً من شاشة تلفاز.
• وإن كان المتحكم مربوطاً بالعنوان الاسترجاعي عرض التلفاز شرحاً بدل الرمز — انظر الخطوة 2.

ومن هناك تكون وحدة التحكم واحدة على كل المنصّات: الاتصالات بفحص كل اتصال على حدة مع المحتويات، والقواعد بقائمة إعادات الكتابة التي عملت، والتشخيص بفحوص ping و DNS والمخرج واختبار الروابط، والسجلات.

4. وصل Chute Dashboard

على جهاز Mac افتح Chute Dashboard واختر Connect to Remote Machine: Host هو عنوان Apple TV — وتعرضه لوحة التحكم تحت LOCAL IP — مع المنفذ وكلمة المرور من الخطوة 2. وConnect via USB مخصص لأجهزة iPhone وأجهزة Android؛ أما Apple TV فيُوصل عبر الشبكة.

وكل ما تفعله Dashboard لهاتف تفعله هنا — قائمتا Active و Recent، وعرضا DNS و UDP، ولوحات أدوات MitM، وتصدير HAR و curl بنقرة يمنى.

5. فك تشفير HTTPS

يختلف أمران على هذه المنصّة، وكلاهما يفاجئ الناس.

لا يمكن تثبيت شهادة CA من التطبيق. ليس في tvOS متصفح Safari ولا مثبّت ملفات تعريف، فلا بد أن تصل الشهادة بالطريقة الوحيدة التي يقبل بها tvOS الشهادات أصلاً: MDM أو Apple Configurator. والتطبيق يقول ذلك في الموضع الذي تُحرَّر فيه قائمة المضيفين، ولا يستطيع كذلك إنشاء شهادة CA ولا استيرادها ولا تصديرها: أنشئ الشهادة في Chute Mac، وضع ca-p12 و ca-passphrase أنفسهما في إعدادات التلفاز، ثم أوصل الشهادة — يكتبها Export the Certificate في Chute Mac بصيغة .pem — إلى الجهاز بأحد هذين المسارين.

لا يوجد مفتاح MitM في لوحة التحكم. في iOS و macOS مفتاح، وفي tvOS لا. ويُشغَّل فك التشفير بواحد مما يلي:

• الإعدادات — enable = true في [MITM]، وهو الجواب الباقي.
• وحدة التحكم، أو مفتاح شريط أدوات Chute Dashboard.
• ‏PUT /api/features/mitm مع {"enabled": true}.

والثلاثة الأخيرة تعمل على المحرك العامل وحده وتُنسى عند إعادة التشغيل التالية. وتُقرأ قائمة hostname من ملف الإعدادات، ويمكن تحريرها مباشرة من وحدة التحكم أو من Dashboard. وأياً كانت طريقة تفعيله، يحتاج فك التشفير على Apple TV إلى ترخيص كما على iPhone: فبدونه لا يفك المحرك تشفير شيء.

[MITM]
enable = true
hostname = api.example.com, *.example.net

6. التسجيل، وإخراج النتيجة من الجهاز

‏Traffic Capture في لوحة التحكم هو مسجّل الحركة — الإعداد replica — وأحد الصفوف الثلاثة التي تحتاج ترخيصاً في لوحة تحكم tvOS، والصفّان الآخران هما خادما البروكسي المحلي. وبدونه تظهر الاتصالات ومعها قاعدتها وسياستها وتوقيتاتها؛ الناقص هو الحمولات فحسب.

ثم يأتي الجزء الخاص بهذه المنصّة وحدها: لا مكان في Apple TV لوضع ملف. لا ورقة مشاركة ولا تطبيق ملفات، فكل تصدير يخرج عبر HTTP:

• HAR — صفحة الاتصالات في وحدة التحكم، تصدير HAR. وينزل الملف على الجهاز الذي يشغّل المتصفح.
• حزمة تشخيص وقت التشغيل (Runtime Diagnostic Bundle) — صفحة التشخيص في وحدة التحكم، تنزيل حزمة التشخيص.
• حزمة التشخيص دون اتصال — الإعدادات ← Offline Diagnostic Bundle، حين لا يكون النفق يعمل. يبني التلفاز الأرشيف ويعرض رمز QR؛ ويعمل الرابط ما دامت تلك الشاشة مفتوحة فقط.

7. ما يستطيع التلفاز نفسه أن يخبرك به

بعض الأسئلة لا تحتاج جهازاً آخر إطلاقاً. تحت الإعدادات ← DIAGNOSIS:

• Dashboard — الجلسة الجارية: Tunnels و DNS و Statistics الخاصة بها. واختيار اتصال يفتح لوحة تفاصيل فيها BASIC (التاريخ والحالة وسبب الإغلاق والمدة)، و POLICY (القاعدة المطابِقة والسياسة التي اختارتها)، و NODES (المحلي والخادم والبعيد والمضيف)، و TRAFFIC، و TIMING (جهوزية البروكسي وحلّ DNS والقاعدة وجهوزية الطرف البعيد وإجمالي وقت النشاط)، وإعادات الكتابة التي عملت. ولا توجد محتويات طلبات أو استجابات — فتلك تحتاج وحدة التحكم أو Chute Dashboard.
• Sessions — مرات التشغيل السابقة، لكلٍّ منها Tunnels ولوحة التفاصيل نفسها و Log. وفوق شاشة السجل مرشّح خطورة (All / Notify+ / Warning+ / Fatal)، فيكفي جهاز التحكم عن بعد لتضييق تشغيل كامل إلى تحذيراته. ولا تُفتح الجلسة الجارية هنا — فذلك عمل Dashboard — وسجلها يُقرأ في وحدة التحكم.
• Network Diagnosis وProxy Diagnosis وRoute Table — قابلية الوصول والمستمعون والتوجيه كما يراها الجهاز.

وفي لوحة التحكم أيضاً Purge DNS Cache، وهو أسرع طريقة لإعادة اختبار تعيين [Host] دون إعادة تشغيل النفق.