كيفية إعداد Kopano Z-Push لمزامنة ActiveSync للأجهزة المحمولة

تتيح خدمة Z-Push للأجهزة المحمولة المتوافقة مزامنة البيانات مع Kopano Core عبر Microsoft Exchange ActiveSync. يعتمد الإعداد الموثوق على مطابقة واجهة Z-Push الخلفية مع خادم Kopano، ونشر نقطة نهاية ActiveSync عبر HTTPS، والحفاظ على حالة Z-Push أثناء التحديثات. كما يعتمد التكوين الأمثل على ما إذا كنت ترغب في أبسط عملية نشر على خادم واحد أو تحتاج إلى خدمات منفصلة وسعة متعددة المضيفين.

اختر الإعداد الذي يناسب بيئتك

Z-Push هو خادم مزامنة ActiveSync مفتوح المصدر. يعمل كطبقة بروتوكول بين جهاز متوافق وخادم إدارة البرامج الجماعية؛ حيث يُضيف الجهاز عادةً حساب Exchange أو ActiveSync بدلاً من الاتصال مباشرةً بـ Kopano. يُمكن لـ Z-Push مزامنة البريد الإلكتروني، وجهات الاتصال، وعناصر التقويم، والمهام عندما يدعم كل من خادم الإدارة وتطبيق الهاتف المحمول هذه الأنواع من البيانات. تُوضح Kopano هذه العلاقة في وثائق إدارة Kopano Core .

بالنسبة لخادم Kopano Core الحالي، تُعدّ واجهة Kopano الخلفية نقطة البداية الطبيعية. اختر IMAP بالإضافة إلى CalDAV/CardDAV فقط عندما تحتوي هذه الأنظمة فعليًا على البيانات المطلوبة، أو عندما ترغب عمدًا في مصادر منفصلة. لا تُعدّ بدائل الواجهة الخلفية محايدة من حيث الميزات: فقد يختلف سلوك المزامنة، ودفاتر العناوين، والمهام، والمجلدات العامة، والتوافق.

قبل تثبيت أو تغيير التكوين

• سجّل إصدارات Kopano Core وZ-Push وPHP وخادم الويب ونظام التشغيل لديك. تحقّق من التوليفات المدعومة للحزم التي تنوي استخدامها؛ فإصدار PHP الذي يقبله Z-Push وحده لا يضمن توفّر امتداد Kopano MAPI له.
• اختر اسم المضيف العام الذي سيستخدمه العملاء، مثل sync.example.com، وقم بإعداد شهادة TLS موثوقة لهذا الاسم.
• حدد ما إذا كان Z-Push سيعمل على مضيف Kopano أو على خادم ويب منفصل. يمكن للمضيف المنفصل عزل الخدمات المتاحة عبر الويب، ولكنه يتطلب اتصالاً فعالاً بالشبكة مع Kopano وعنوان خادم MAPI مُهيأ بشكل صحيح.
• قم بعمل نسخة احتياطية من مجلدات إعدادات وحالة Z-Push قبل الترقية. تتتبع حالة Z-Push مزامنة الأجهزة؛ وتنص إرشادات الترقية الموثقة من Kopano على ضرورة الاحتفاظ بحالة ملفات تعريف الأجهزة المحمولة الحالية.
• اختر أنواع البيانات التي يجب على كل مستخدم مزامنتها وراجع متطلبات سياسة الجهاز قبل تسجيل الهواتف الشخصية أو هواتف الشركة.

قم بتهيئة جانب الخادم

1. قم بتثبيت مجموعة حزم Z-Push المتوافقة

استخدم الحزم المصممة خصيصًا لتوزيعتك وإصدار Kopano الخاص بك عند توفرها. يفصل الإعداد النموذجي القائم على الحزم بين نواة Z-Push، وواجهة Kopano الخلفية، وتكامل خادم الويب. يصف دليل مسؤول Kopano حزمًا مثل z-push-backend-kopanoحزم تهيئة خادم الويب، ولكن أسماء الحزم الدقيقة وتوفرها في المستودعات تختلف باختلاف التوزيعة، كما أن الدليل يغطي إصدارًا قديمًا من وثائق Kopano Core. تأكد من دعم الحزمة الحالية قبل تطبيق أوامرها القديمة.

توفر عمليات التثبيت من المصدر والحاويات تحكمًا أكبر في الإصدارات وتخطيط نظام الملفات. كما أنها تنقل المسؤولية إلى المشغل: إذ يجب عليك توفير ملحقات PHP لنفس بيئة تشغيل PHP التي يستخدمها خادم الويب، والحفاظ على الحالة والسجلات، وإبقاء مسار ActiveSync متاحًا بعد عمليات إعادة النشر.

2. حدد واجهة Kopano الخلفية وعنوان الخادم

في إعدادات Z-Push الرئيسية، عيّن موفر الواجهة الخلفية إلى Kopano باستخدام الإعداد واسم الفئة الموثقين لإصدارك المُثبّت. من الإعدادات الشائعة في عمليات النشر المُجمّعة BackendKopano؛ لذا لا تقم بلصق أي إعداد في ملف تكوين ذي بنية مختلفة دون مراجعة النموذج المرفق مع حزمتك. في إعدادات Kopano، عيّن عنوان خادم MAPI عندما لا تكون خدمة Kopano على نفس المضيف أو لا يمكن الوصول إليها عبر الاتصال المحلي الافتراضي.

// Example only: confirm the setting and file path in your installed package.
define('BACKEND_PROVIDER', 'BackendKopano');

قد تختلف أسماء الملفات والثوابت بين الإصدارات المعبأة. لذا، احرص على عدم تضمين المعلومات السرية في أمثلة التكوين العامة، وقيّد صلاحيات الوصول إلى ملفات التكوين، وتأكد من أن بيئة تشغيل PHP المستخدمة من قِبل Apache أو PHP-FPM قادرة على تحميل امتداد Kopano MAPI المطلوب. ولا يُعدّ وجود بيئة PHP سليمة في سطر الأوامر دليلاً على تفعيل نفس الامتدادات في بيئة تشغيل PHP الخاصة بالويب.

3. انشر نقطة نهاية ActiveSync عبر HTTPS

يحتاج العملاء إلى عنوان URL ثابت لبروتوكول HTTPS لمعالج ActiveSync، وعادةً ما يكون اسم المضيف متبوعًا بـ /Microsoft-Server-ActiveSync. قم بتهيئة Apache أو Nginx أو الخادم الوكيل العكسي المُختار لتوجيه هذا المسار إلى نقطة دخول Z-Push. حافظ على نقطة النهاية الأساسية على نفس اسم المضيف، وتجنب عمليات إعادة التوجيه التي تُغير طريقة الطلب أو تُرسل عميل الهاتف المحمول إلى مسار مختلف. يُحذر دليل Kopano تحديدًا من إعادة تسمية دليل Z-Push لإنشاء نقطة النهاية، لأن إعادة التوجيه قد تُعطل مزامنة الجهاز.

استخدم شهادة صالحة يتطابق اسمها مع اسم مضيف نقطة النهاية. يحمي بروتوكول HTTPS بيانات الاعتماد وبيانات المزامنة أثناء النقل، وترفض العديد من تطبيقات الجوال الحالية الشهادات غير الموثوقة أو غير المتطابقة. لا تتجاوز تحذيرات الشهادة بتعطيل بروتوكول TLS على حسابات الإنتاج. إذا انتهى اتصال TLS عند خادم وكيل عكسي، فتأكد من أن الخادم الوكيل يُعيد توجيه الطلبات وعناوين المصادقة كما هو مُخطط له، وأن الاتصال من الخادم الوكيل إلى Z-Push يتبع سياسة الأمان الداخلية الخاصة بك.

4. تحديد مواقع الحالة والسجلات القابلة للكتابة

يجب أن يكون Z-Push قادرًا على كتابة بيانات حالته وسجلاته. امنح حق الوصول إلى حساب خادم الويب المحدد، كما هو الحال www-dataفي العديد من توزيعات Debian وUbuntu؛ يختلف حساب الخدمة باختلاف التوزيعة. تجنب جعل هذه المجلدات قابلة للكتابة من قِبل جميع المستخدمين. في بيئة متعددة المضيفين، اختر آلية حالة مصممة للوصول المشترك بدلاً من افتراض أن الملفات الموجودة على عقدة ما مرئية لعقدة أخرى. يشرح دليل مسؤول Kopano أذونات مجلدات الحالة، ويشير إلى ضرورة الاحتفاظ بالحالة عند ترقية Z-Push.

قم بإعداد حساب الهاتف المحمول

على الهاتف، أضف حساب عمل أو حساب Exchange، ثم اختر Exchange ActiveSync أو Microsoft Exchange أو الخيار المكافئ الذي يوفره تطبيق البريد الإلكتروني. تختلف المسميات والشاشات باختلاف نظام التشغيل وتطبيق البريد. أدخل عنوان البريد الإلكتروني وبيانات اعتماد المستخدم. إذا لم يعثر الاكتشاف التلقائي على الخادم، فأدخل اسم مضيف Z-Push، ونقطة نهاية ActiveSync إذا طُلب منك ذلك. استخدم تنسيق اسم المستخدم الذي يتوقعه إعداد مصادقة Kopano؛ ولا تفترض أن عنوان البريد الإلكتروني الكامل واسم تسجيل الدخول إلى Kopano متطابقان دائمًا.

أبقِ بروتوكول SSL/TLS مُفعّلاً، ولا تقبل سياسات الجهاز إلا بعد مراجعة ما تسمح به، مثل طلب رمز مرور أو تطبيق ضوابط الجهاز التي تُديرها المؤسسة. حدّد الفئات التي تُريد مزامنتها: البريد، جهات الاتصال، التقويم، والمهام (إن وُجدت). يُوضّح دليل Kopano القديم للأجهزة المحمولة سير عمل حساب Exchange بشكل عام، لكن لقطات الشاشة وتسميات نظام التشغيل قديمة. اتبع تعليمات الهاتف الحالي بدلاً من نسخ مسارات القوائم القديمة حرفياً.

إذا كان تطبيق البريد الإلكتروني يدعم جداول المزامنة، فإنّ خاصية الدفع أو التحديثات المتكررة توفر وصولاً أسرع للرسائل، ولكنها قد تستهلك المزيد من طاقة البطارية ونشاط الشبكة. فترات الاستطلاع الأطول تقلل من عمليات التحقق في الخلفية، ولكنها تؤخر وصول الرسائل الجديدة. بالنسبة لحسابات العمل التي يُعدّ فيها وصول البريد في الوقت المناسب أمرًا بالغ الأهمية، ابدأ بإعدادات الدفع الخاصة بالعميل إن كانت مدعومة، ثم عدّل الإعدادات بناءً على استهلاك البطارية وسياسة المؤسسة.

تحقق من كل طبقة قبل تسجيل المزيد من الأجهزة

1. نقطة النهاية: افتح اسم المضيف العام في متصفح وتأكد من صحة شهادة TLS. يجب إصلاح أي خطأ في المتصفح أو تحذير متعلق بالشهادة قبل إضافة الحسابات.
2. توجيه الويب: تأكد من وصول مسار ActiveSync إلى معالج Z-Push دون حلقات إعادة توجيه أو صفحة خطأ 404 عامة من خادم الويب. نقطة النهاية هي معالج بروتوكول، وليست موقع ويب عادي.
3. التحقق من صحة الواجهة الخلفية: استخدم حساب اختبار وتأكد من أن سجلات Z-Push تُظهر اتصالًا ناجحًا بالواجهة الخلفية دون الكشف عن كلمات المرور أو الرموز المميزة.
4. المزامنة الأولية: أضف هاتفًا تجريبيًا واحدًا وتحقق من مجلدات البريد وجهات الاتصال والتقويم والمهام المحددة. لا يضمن تسجيل الدخول بنجاح مزامنة جميع أنواع البيانات بشكل صحيح.
5. التغييرات ثنائية الاتجاه: قم بإنشاء حدث تجريبي في التقويم على الهاتف وتأكد من ظهوره في Kopano؛ ثم قم بإجراء تغيير تجريبي في Kopano وتأكد من وصوله إلى الهاتف.
6. إعادة التشغيل والاستعادة: أعد تشغيل خدمة الويب خلال فترة اختبار مخططة، وتحقق من استعادة المزامنة، وتأكد من أن دليل الحالة يظل سليمًا.

استكشاف الأخطاء وإصلاحها حسب الأعراض

استخدم سجلات Z-Push وسجلات خادم الويب/PHP معًا، مع مطابقة الطابع الزمني. إذا كنت بحاجة إلى اختبار ملف تعريف جهاز جديد، فتأكد أولًا من أن إعادة ضبط حالة الخادم مناسبة لإصدارك، وتأكد مما إذا كانت ستؤدي إلى إعادة مزامنة كاملة. لا تحذف دليل الحالة بالكامل كخطوة أولى لحل المشكلة.

أي تكوين يجب أن تختار؟

بالنسبة لتثبيت Kopano Core صغير الحجم، عادةً ما تُقلل حزمة Z-Push المدعومة من التوزيعة، وخادم Kopano الخلفي، ونقطة نهاية HTTPS واحدة، وحالة محلية مُدارة بعناية، من عدد العناصر المُتغيرة. استخدم خادمًا منفصلاً عندما تُبرر العزلة أو حدود التشغيل العمل الإضافي على الشبكة وتوافق PHP-MAPI. استخدم تصميمًا متعدد الخوادم فقط بعد اختيار نهج الحالة المشتركة واختباره. إذا كانت بيانات البريد أو التقويمات أو جهات الاتصال موجودة خارج Kopano، فقارن خوادم Z-Push الخلفية ذات الصلة قبل النشر، واختبر كل نوع بيانات على تطبيقات الجوال الفعلية التي يعتمد عليها المستخدمون.

تختلف حزم Z-Push وKopano، ودعم PHP، وسلوك الجهاز بين الإصدارات. يُرجى اعتبار نموذج التكوين الخاص بالحزمة المُثبّتة ووثائق الإصدار المُطابقة له مرجعًا موثوقًا؛ أدلة Kopano القديمة مفيدة لفهم المفاهيم، ولكن لا ينبغي نسخها بشكل أعمى إلى نظام أحدث. يُعدّ مستودع مشروع Z-Push مصدرًا لرمز المشروع الحالي ومعلومات الإصدار.