تكوين هاتفك لإعادة مزامنة ملف التعريف

أعد مزامنة ملف تعريف الهاتف عبر TFTP

يدعم الهاتف بروتوكولات شبكة متعددة لاسترداد ملفات تعريف التكوين. أبسط بروتوكول نقل ملفات تعريف هو TFTP ‏(RFC1350). يستخدم TFTP على نطاق واسع لتوفير أجهزة الشبكة داخل شبكات LAN الخاصة. على الرغم من أنه لا يوصى به لنشر نقاط النهاية البعيدة عبر الإنترنت، ألا أنه يمكن أن يكون TFTP مناسبًا للنشر داخل المؤسسات الصغيرة وللتوفير المسبق الداخلي وللتطوير والاختبار. في الإجراء التالي، يتم تعديل ملف التعريف بعد تنزيل ملف من خادم TFTP.

1

داخل بيئة LAN، قم بتوصيل جهاز الكمبيوتر والهاتف بلوحة وصل أو مفتاح أو موجه صغير.

2

على الكمبيوتر، قم بتثبيت وتنشيط خادم TFTP.

3

استخدم محرر نص لإنشاء ملف تعريف التكوين.

للتحقق مما إذا كان ملف التعريف قد تم توفيره لهاتفك لاحقًا، يمكنك تعيين بعض القيم كعلامات. على سبيل المثال، قم بتعيين قيمة GPP_A إلى 12345678 كما هو موضح في المثال التالي:
<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
4

احفظ ملف تكوين XML في الدليل الجذر لخادم TFTP.

يمكنك التحقق من تكوين خادم TFTP بشكل صحيح: اطلب ملف تعريف التكوين باستخدام عميل TFTP غير الهاتف. على نحو مفضل، استخدم عميل TFTP الذي يتم تشغيله على مضيف منفصل عن خادم التوفير.

5

في مستعرض ويب على جهاز الكمبيوتر الخاص بك، افتح صفحة ويب الإدارة. على سبيل المثال، لنفترض أن عنوان IP الخاص بالهاتف هو 192.168.1.100، افتح عنوان URL التالي في مستعرض الويب الخاص بك:

http://192.168.1.100/admin/advanced
6

حدد علامة التبويب صوت > توفير، وافحص قيم معلمات الغرض العام GPP_A إلى GPP_P. يجب أن تكون فارغة.

7

أعد مزامنة هاتف الاختبار إلى ملف تعريف التكوين الذي قمت بإنشائه عن طريق فتح عنوان URL الخاص بإعادة المزامنة في مستعرض ويب.

المثال:

إذا كان عنوان IP لخادم TFTP هو 192.168.1.200، فيجب أن يكون الأمر مشابهًا للمثال التالي:

http://192.168.1.100/admin/resync?tftp://192.168.1.200/basic.txt

عندما يتلقى الهاتف هذا الأمر، يطلب الجهاز الموجود على العنوان 192.168.1.100 ملف تعريف التكوين basic.txt من خادم TFTP على عنوان IP 192.168.1.200. يقوم الهاتف بعد ذلك بتحليل الملف الذي تم تنزيله وتحديث المعلمة GPP_A بالقيمة 12345678.

8

تحقق من أنه تم تحديث المعلمة بشكل صحيح. قم بتحديث صفحة ويب الإدارة وانتقل إلى الصوت > التزويد.

يجب أن تحتوي المعلمة GPP_A الآن على القيمة 12345678.

توفير ملف تعريف هاتف خاص على خادم TFTP
1

احصل على عنوان MAC الخاص بالهاتف من ملصق المنتج الخاص به. (عنوان MAC هو الرقم، باستخدام الأرقام والأرقام السداسية العشرية الصغيرة، على سبيل المثال 000e08aabbcc.

2

أعد تسمية ملف التكوين إلى CP-xxxx macaddress.cfg (باستبدال xxxx برقم الطراز واستبدال macaddress بعنوان MAC الخاص بالهاتف).

المثال:

CP-8875 000e08aabbcc.cfg

3

انقل الملف الجديد إلى دليل الجذر الظاهري لخادم TFTP.

4

يمكنك الوصول إلى صفحة ويب إدارة الهاتف.

5

حدد صوت  > توفير.

6

أدخل مسار ملف التعريف في الحقل قاعدة ملف التعريف.

على سبيل المثال: افترض أن عنوان IP لخادم TFTP هو 192.168.1.200 وأن اسم ملف التعريف هو 

<Profile_Rule>
tftp://192.168.1.200/CP-8875$MA.cfg
</Profile_Rule>
7

انقر فوق إرسال جميع التغييرات. يؤدي هذا إلى إعادة التشغيل الفوري وإعادة المزامنة.

عند حدوث إعادة المزامنة التالية، يسترد الهاتف الملف الجديد عن طريق توسيع تعبير الماكرو $MA إلى عنوان MAC الخاص به.

إعادة مزامنة ملف تعريف الهاتف باستخدام HTTP GET
1

قم بتثبيت خادم HTTP على جهاز الكمبيوتر المحلي أو مضيف آخر يمكن الوصول إليه.

يمكن تنزيل خادم Apache مفتوح المصدر من الإنترنت.

2

قم بتحميل ملف تعريف التكوين على الدليل الجذر الظاهري للخادم المثبت.

3

للتحقق من التثبيت الصحيح للخادم والوصول إلى ملف التعريف، قم بالوصول إلى ملف التعريف باستخدام مستعرض ويب.

4

قم بتعديل Profile_Rule الخاص بهاتف الاختبار للإشارة إلى خادم HTTP بدلاً من خادم TFTP، وذلك لتنزيل ملف التعريف الخاص به بشكل دوري.

على سبيل المثال، بافتراض أن خادم HTTP هو 192.168.1.300 واسم ملف التعريف هو basic.txt، أدخل القيمة التالية:

<Profile_Rule>http://192.168.1.200/basic.txt</Profile_Rule>
5

انقر فوق إرسال جميع التغييرات. يؤدي هذا إلى إعادة التشغيل الفوري وإعادة المزامنة.

6

راقب رسائل سجل النظام التي يرسلها الهاتف. يجب أن تحصل عمليات إعادة المزامنة الدورية الآن على ملف التعريف من خادم HTTP.

7

في سجلات خادم HTTP، لاحظ كيفية ظهور المعلومات التي تحدد هاتف الاختبار في سجل وكلاء المستخدم.

يجب أن تتضمن هذه المعلومات الشركة المصنعة واسم المنتج وإصدار البرنامج الثابت الحالي والرقم التسلسلي.

إعادة مزامنة ملف تعريف الهاتف تلقائيًا

يمكن للجهاز إعادة المزامنة بشكل دوري مع خادم التوفير للتأكد من أن أي تغييرات في ملف التعريف يتم إجراؤها على الخادم يتم نشرها إلى جهاز نقطة النهاية (على عكس إرسال طلب صريح لإعادة المزامنة إلى نقطة النهاية).

لجعل الهاتف يقوم بشكل دوري بإعادة المزامنة مع الخادم، يتم تحديد عنوان URL لملف تعريف التكوين باستخدام المعلمة Profile_Rule، ويتم تحديد فترة إعادة المزامنة باستخدام المعلمة Resync_Periodic.

1

يمكنك الوصول إلى صفحة ويب إدارة الهاتف.

2

حدد صوت  > توفير.

3

حدد المعلمة Profile_Rule. يفترض هذا المثال عنوان IP لخادم TFTP هو 192.168.1.200.

4

في حقل إعادة المزامنة الدورية، أدخل قيمة صغيرة للاختبار، مثل 30 ثانية.

5

انقر فوق إرسال جميع التغييرات.

باستخدام إعدادات المعلمات الجديدة، يقوم الهاتف بإعادة المزامنة مرتين في الدقيقة إلى ملف التكوين الذي يحدده عنوان URL.

6

لاحظ الرسائل الناتجة في تتبع سجل النظام.

7

تأكد من تعيين حقل إعادة المزامنة عند إعادة التعيين إلى نعم.

<Resync_On_Reset>نعم</Resync_On_Reset>
8

قم بتشغيل دورة الهاتف لإجباره على إعادة المزامنة مع خادم التوفير.

إذا فشلت عملية إعادة المزامنة لأي سبب، مثل عدم استجابة الخادم، تنتظر الوحدة (لعدد الثواني التي تم تكوينها في تأخير إعادة محاولة خطأ إعادة المزامنة) قبل أن تحاول إعادة المزامنة مرة أخرى. إذا كان تأخير إعادة محاولة خطأ إعادة المزامنة صفرًا، لا يحاول الهاتف إعادة المزامنة بعد محاولة إعادة المزامنة الفاشلة.

9

(اختياري) قم بتعيين قيمة حقل تأخير إعادة محاولة خطأ إعادة المزامنة إلى رقم صغير، مثل 30.

<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>
10

قم بتعطيل خادم TFTP، ولاحظ النتائج في إخراج سجل النظام.

معلمات إعادة مزامنة ملف التعريف

يحدد الجدول التالي وظيفة واستخدام معلمات إعادة مزامنة ملف التعريف في قسم ملف تعريف التكوين ضمن علامة التبويب صوت > توفير في صفحة ويب الهاتف. كما أنه يحدد بنية السلسلة التي تمت إضافتها في ملف تكوين الهاتف (cfg.xml) باستخدام رمز XML لتكوين معلمة.

جدول 1. معلمات إعادة مزامنة ملف التعريف

المعلمة

الوصف

تمكين التوفير

السماح بإجراءات إعادة مزامنة ملف تعريف التكوين أو رفضها.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Provision_Enable ua="na">نعم</Provision_Enable>

  • في صفحة ويب الهاتف، قم بتعيين هذا الحقل إلى نعم للسماح بإجراءات إعادة المزامنة أو لا لحظر إجراءات إعادة المزامنة.

القيمة الافتراضية: نعم

إعادة المزامنة عند إعادة التعيين

تحديد ما إذا كان الهاتف يعيد مزامنة التكوينات مع خادم التوفير بعد التشغيل وبعد كل محاولة ترقية.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Resync_On_Reset ua="na">نعم</Resync_On_Reset>

  • في صفحة ويب الهاتف، قم بتعيين هذا الحقل إلى نعم للسماح بإعادة المزامنة أثناء التشغيل أو إعادة التعيين أو لا لحظر إعادة المزامنة أثناء التشغيل أو إعادة التعيين.

القيمة الافتراضية: نعم

التأخير العشوائي لإعادة المزامنة

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

المعلمة هي أقصى فترة زمنية ينتظرها الجهاز قبل إجراء اتصال بخادم التوفير. التأخير الفعلي هو رقم شبه عشوائي بين 0 وهذه القيمة.

هذه المعلمة بوحدات من 20 ثانية.

تتراوح القيمة الصالحة بين 0 و65535.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Resync_Random_Delay ua="na">2</Resync_Random_Delay>

  • في صفحة ويب الهاتف، حدد عدد الوحدات (20 ثانية) للهاتف لتأخير إعادة المزامنة بعد التشغيل أو إعادة التعيين.

القيمة الافتراضية هي 2 (40 ثانية).

إعادة المزامنة عند (HHmm)

الوقت (HHmm) الذي تتم فيه مزامنة الهاتف مع خادم التوفير.

يجب أن تكون قيمة هذا الحقل عبارة عن رقم مكون من أربعة أرقام يتراوح من 0000 إلى 2400 للإشارة إلى الوقت بتنسيق HHmm. على سبيل المثال، يشير الرقم 0959 إلى 09:59.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>

  • في صفحة ويب الهاتف، حدد الوقت بتنسيق HHMM للهاتف لبدء إعادة المزامنة.

القيمة الافتراضية هي فارغ. إذا كانت القيمة غير صالحة، فسيتم تجاهل المعلمة. إذا تم تعيين هذه المعلمة بقيمة صالحة، يتم تجاهل إعادة المزامنة الدورية.

إعادة المزامنة عند التأخير العشوائي

يمنع التحميل الزائد لخادم التوفير عند تشغيل عدد كبير من الأجهزة في نفس الوقت.

لتجنب إغراق طلبات إعادة المزامنة إلى الخادم من هواتف متعددة، يقوم الهاتف بإعادة المزامنة في النطاق بين الساعات والدقائق والساعات والدقائق بالإضافة إلى التأخير العشوائي (hhmm, hhmm+random_delay). على سبيل المثال، إذا كان التأخير العشوائي = (إعادة المزامنة عند تأخير عشوائي + 30)/60 دقيقة، يتم تحويل قيمة الإدخال بالثواني إلى دقائق، مع التقريب إلى الدقيقة التالية لحساب الفاصل الزمني للتأخير العشوائي النهائي.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>

  • في صفحة ويب الهاتف، حدد الفترة الزمنية بالثواني.

تتراوح القيمة الصالحة بين 600 و65535.

إذا كانت القيمة أقل من 600، يكون التأخير العشوائي الداخلي بين 0 و600.

القيمة الافتراضية هي 600 ثانية (10 دقائق).

إعادة المزامنة الدورية

الفترة الزمنية بين إعادة المزامنة الدورية مع خادم التوفير. يكون مؤقت إعادة المزامنة المرتبط نشطًا فقط بعد أول مزامنة ناجحة مع الخادم.

التنسيقات الصالحة هي كما يلي:

  • عدد صحيح

    مثال، إدخال 3000 يشير إلى أن إعادة المزامنة التالية تحدث في 3000 ثانية.

  • أعداد صحيحة متعددة

    مثال: إدخال 600,1200,300 يشير إلى أن إعادة المزامنة الأولى تحدث في 600 ثانية، وتحدث إعادة المزامنة الثانية في 1200 ثانية بعد الأولى، وتحدث إعادة المزامنة الثالثة في 300 ثانية بعد الثانية.

  • نطاق زمني

    مثال: إدخال 2400+30 يشير إلى أن إعادة المزامنة التالية تحدث بين 2400 و2430 ثانية بعد نجاح عملية إعادة المزامنة.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Resync_Periodic ua="na">3600</Resync_Periodic>

  • في صفحة ويب الهاتف، حدد الفترة الزمنية بالثواني.

قم بتعيين هذه المعلمة إلى صفر لتعطيل إعادة المزامنة الدورية.

القيمة الافتراضية هي 3600 ثانية.

تأخير إعادة محاولة إعادة المزامنة عند ظهور خطأ

إذا فشلت عملية إعادة المزامنة لأن الهاتف لم يتمكن من استرداد ملف تعريف من الخادم، أو كان الملف الذي تم تنزيله تالفًا، أو حدث خطأ داخلي، فسيحاول الهاتف إعادة المزامنة مرة أخرى بعد وقت محدد بالثواني.

التنسيقات الصالحة هي كما يلي:

  • عدد صحيح

    مثال: إدخال 300 يشير إلى أن إعادة المحاولة التالية لإعادة المزامنة تحدث في غضون 300 ثانية.

  • أعداد صحيحة متعددة

    مثال: إدخال 600,1200,300 يشير إلى أن إعادة المحاولة الأولى تحدث في 600 ثانية بعد الفشل، وتحدث إعادة المحاولة الثانية في 1200 ثانية بعد فشل إعادة المحاولة الأولى، وتحدث إعادة المحاولة الثالثة في 300 ثانية بعد فشل إعادة المحاولة الثانية.

  • نطاق زمني

    مثال، إدخال 2400+30 يشير إلى أن إعادة المحاولة التالية تحدث بين 2400 و2430 ثانية بعد فشل إعادة المزامنة.

إذا تم تعيين التأخير على 0، فلن يحاول الجهاز إعادة المزامنة مرة أخرى بعد محاولة إعادة المزامنة الفاشلة.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400</Resync_Error_Retry_Delay>

  • في صفحة ويب الهاتف، حدد الفترة الزمنية بالثواني.

القيمة الافتراضية: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400

تأخير إعادة المزامنة القسري

أقصى تأخير (بالثواني) ينتظره الهاتف قبل إجراء إعادة المزامنة.

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

يحتوي الجهاز على مؤقت يبدأ في العد التنازلي عندما تصبح جميع خطوطه خاملة. هذه المعلمة هي القيمة الأولية للعداد. يتم تأخير أحداث إعادة المزامنة حتى يتناقص هذا العداد إلى الصفر.

تتراوح القيمة الصالحة بين 0 و65535.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>

  • في صفحة ويب الهاتف، حدد الفترة الزمنية بالثواني.

القيمة الافتراضية هي 14,400 ثانية.

إعادة المزامنة من SIP

التحكم في طلبات عمليات إعادة المزامنة عبر حدث SIP NOTIFY المرسل من الخادم الوكيل لموفر الخدمة إلى الهاتف. في حالة التمكين، يمكن للوكيل طلب إعادة المزامنة عن طريق إرسال رسالة SIP NOTIFY تحتوي على عنوان الحدث: إعادة المزامنة إلى الجهاز.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Resync_From_SIP ua="na">نعم</Resync_From_SIP>

  • في صفحة ويب الهاتف، حدد نعم لتمكين هذه الميزة أو لا لتعطيلها.

القيمة الافتراضية: نعم

إعادة المزامنة بعد محاولة الترقية

تمكين أو تعطيل عملية إعادة المزامنة بعد حدوث أي ترقية. إذا تم تحديد نعم، يتم تشغيل المزامنة بعد ترقية البرنامج الثابت.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Resync_After_Upgrade_Attempt ua="na">نعم</Resync_After_Upgrade_Attempt>

  • في صفحة ويب الهاتف، حدد نعم لتشغيل إعادة المزامنة بعد ترقية برنامج ثابت أو لا لعدم إعادة المزامنة.

القيمة الافتراضية: نعم

مشغل إعادة المزامنة 1

مشغل إعادة المزامنة 2

إذا تم تقييم المعادلة المنطقية الموجودة في هذه المعلمات إلى FALSE، لا يتم تشغيل أعاده المزامنة حتى عند تعيين إعادة المزامنة أثناء إعادة التعيين إلى TRUE. فقط إعادة المزامنة عبر عنوان URL للإجراء المباشر وإخطار SIP يتجاهل مشغلات إعادة المزامنة هذه.

يمكن برمجة المعلمات بتعبير شرطي يخضع لتوسيع ماكرو. لمعرفة توسعات الماكرو الصالحة، راجع متغيرات توسيع الماكرو ضمن معلمات التوفير.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Resync_Trigger_1 ua="na">$UPGTMR gt 300 and $PRVTMR ge 600</Resync_Trigger_1>

    <Resync_Trigger_2 ua="na"/>

  • في صفحة ويب الهاتف، حدد المشغلات.

القيمة الافتراضية: فارغ

إعادة المزامنة القابلة للتكوين بواسطة المستخدم

السماح للمستخدم بإعادة مزامنة الهاتف من قائمة شاشة الهاتف. عند التعيين إلى نعم، يمكن للمستخدم إعادة مزامنة تكوين الهاتف عن طريق إدخال قاعدة ملف التعريف من الهاتف. عند التعيين إلى لا، لا يتم عرض معلمة قاعدة ملف التعريف على قائمة شاشة الهاتف.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <User_Configurable_Resync ua="na">نعم</User_Configurable_Resync>

  • في صفحة ويب الهاتف، حدد نعم لإظهار معلمة قاعدة ملف التعريف في قائمة الهاتف أو حدد لا لإخفاء هذه المعلمة.

القيمة الافتراضية: نعم

فشل إعادة المزامنة في FNF

عادةً ما تعتبر إعادة المزامنة غير ناجحة إذا لم يتم استلام ملف التعريف المطلوب من الخادم. تتجاوز هذه المعلمة هذا السلوك. عند التعيين إلى لا، يقبل الجهاز استجابة لم يتم العثور على الملف من الخادم كإعادة مزامنة ناجحة.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Resync_Fails_On_FNF ua="na">نعم</Resync_Fails_On_FNF>

  • في صفحة ويب الهاتف، حدد نعم لأخذ استجابة لم يتم العثور على الملف كإعادة مزامنة غير ناجحة، أو حدد لا لأخذ استجابة لم يتم العثور على الملف كإعادة مزامنة ناجحة.

القيمة الافتراضية: نعم

نوع مصادقة ملف التعريف

تحديد بيانات الاعتماد التي سيتم استخدامها لمصادقة حساب ملف التعريف. الخيارات المتاحة هي:

  • معطل: تعطيل ميزة حساب ملف التعريف. عند تعطيل هذه الميزة، لا يظهر إعداد حساب ملف التعريف على شاشة الهاتف.

  • مصادقة HTTP الأساسي: تُستخدم بيانات اعتماد تسجيل الدخول إلى HTTP لمصادقة حساب ملف التعريف.

  • مصادقة XSI: تُستخدم بيانات اعتماد تسجيل الدخول إلى XSI أو بيانات اعتماد SIP لـ XSI لمصادقة حساب ملف التعريف. تعتمد بيانات اعتماد المصادقة على نوع مصادقة XSI للهاتف:

    • عند تعيين نوع مزامنة XSI للهاتف إلى بيانات اعتماد تسجيل الدخول، يتم استخدام بيانات اعتماد تسجيل الدخول إلى XSI.

    • عند تعيين نوع مصادقة XSI للهاتف إلى بيانات اعتماد SIP، يتم استخدام بيانات اعتماد SIP لـ XSI.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Profile_Authentication_Type ua="na">مصادقة Http الأساسي</Profile_Authentication_Type>

  • في صفحة ويب الهاتف، حدد خيارًا من القائمة للهاتف لمصادقة إعادة مزامنة ملف التعريف.

القيمة الافتراضية: مصادقة HTTP الأساسي

لمزيد من المعلومات، راجع تحديد نوع مصادقة ملف التعريف ضمن تحديد الهاتف لإعادة مزامنة ملف التعريف.

قاعدة ملف التعريف

قاعدة ملف التعريف B

قاعدة ملف التعريف C

قاعدة ملف التعريف د

تقوم كل قاعدة ملف تعريف بإعلام الهاتف بالمصدر الذي يمكن من خلاله الحصول على ملف تعريف (ملف التكوين). أثناء كل عملية إعادة مزامنة، يطبق الهاتف جميع ملفات التعريف بالتسلسل.

إذا كنت تقوم بتطبيق تشفير AES-256-CBC على ملفات التكوين، فحدد مفتاح التشفير باستخدام الكلمة الأساسية --key كما يلي:

‏[--key <encryption key>]

يمكنك تضمين مفتاح التشفير بين علامتي اقتباس (") اختياريًا.

  • في ملف تكوين الهاتف (cfg.xml) باستخدام XML، أدخل سلسلة بهذا التنسيق:

    <Profile_Rule ua="na">/$PSN.xml</Profile_Rule>

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • في صفحة ويب الهاتف، حدد قاعدة ملف التعريف.

القيمة الافتراضية: /$PSN.xml

خيار DHCP للاستخدام

تُستخدم خيارات DHCP، المحددة بفواصل، لاسترداد البرامج الثابتة وملفات التعريف.

القيمة الافتراضية: 66,160,159,150,60,43,125

خيار DHCPv6 للاستخدام

تُستخدم خيارات DHCP، المحددة بفواصل، لاسترداد البرامج الثابتة وملفات التعريف.

القيمة الافتراضية: 17,160,159

التوفير من خلال Cisco XML

يمكنك توفير الهواتف من خلال وظائف Cisco XML.

يمكنك إرسال كائن XML إلى الهاتف عن طريق حزمة SIP Notify أو HTTP Post إلى واجهة CGI للهاتف: http://PhoneIPAddress/CGI/Execute.

يوسع CP-xxxx-3PCC ميزة Cisco XML لدعم التوفير عبر كائن XML:

<CP-xxxx-3PCCExecute> <ExecuteItem URL=Resync:[profile-rule]/></CP-xxxx-3PCCExecute>

بعد أن يتلقى الهاتف كائن XML، يقوم بتنزيل ملف التوفير من [قاعدة ملف التعريف]. تستخدم هذه القاعدة وحدات الماكرو لتبسيط عملية تطوير تطبيق خدمات XML.

دقة عنوان URL مع توسيع الماكرو

توفر الدلائل الفرعية التي تحتوي على ملفات تعريف متعددة على الخادم طريقة ملائمة لإدارة عدد كبير من الأجهزة التي تم نشرها. يمكن أن يحتوي عنوان URL لملف التعريف على:

  • اسم خادم توفير أو عنوان IP صريح. إذا كان ملف التعريف يحدد خادم التوفير بالاسم، فسيقوم الهاتف بإجراء بحث DNS لتحليل الاسم.

  • منفذ خادم غير قياسي محدد في عنوان URL باستخدام البنية القياسي:port بعد اسم الخادم.

  • الدليل الفرعي للدليل الجذر الظاهري للخادم حيث يتم تخزين ملف التعريف، المحدد باستخدام تدوين URL القياسي وتتم إدارته عن طريق توسيع الماكرو.

على سبيل المثال، تطلب Profile_Rule التالية ملف التعريف ($ PN.cfg)، في دليل الخادم الفرعي /cisco/config، من خادم TFTP الذي يعمل على مضيف prov.telco.com يستمع للاتصال على المنفذ 6900: 

<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>

يمكن تحديد ملف تعريف لكل هاتف في معلمة للأغراض العامة، مع الإشارة إلى قيمتها ضمن قاعدة ملف تعريف مشترك باستخدام توسيع الماكرو.

على سبيل المثال، افترض أنه تم تعريف GPP_B على أنه Dj6Lmp23Q.

تحتوي Profile_Rule على القيمة:

tftp://prov.telco.com/cisco/$B/$MA.cfg

عند إعادة مزامنة الجهاز وتوسيع وحدات الماكرو، يطلب الهاتف الذي يحمل عنوان MAC 000e08012345 ملف التعريف بالاسم الذي يحتوي على عنوان MAC للجهاز على عنوان URL التالي:

tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
تحديد نوع مصادقة ملف التعريف

تسمح مصادقة ملف التعريف لمستخدمي الهاتف بإعادة مزامنة ملف التوفير على الهاتف. معلومات المصادقة مطلوبة بينما يحاول الهاتف إعادة مزامنة وتنزيل ملف التكوين لأول مرة ويحصل على خطأ مصادقة HTTP أو HTTPS 401. عند تمكين هذه الميزة، يتم عرض شاشة إعداد حساب ملف التعريف على الهاتف للمواقف التالية:

  • عند حدوث خطأ مصادقة HTTP أو HTTPs 401 أثناء التوفير لأول مرة بعد إعادة تشغيل الهاتف

  • عندما يكون اسم المستخدم وكلمة المرور لحساب ملف التعريف فارغين

  • عندما لا يكون هناك اسم مستخدم وكلمة مرور في قاعدة ملف التعريف

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

عند تعطيل الميزة، لا تظهر شاشة إعداد حساب ملف التعريف على الهاتف.

لاسم المستخدم وكلمة المرور في حقل قاعدة ملف التعريف أولوية أعلى على حساب ملف التعريف.

  • عند توفير عنوان URL صحيح في حقل قاعدة ملف التعريف بدون اسم مستخدم وكلمة مرور، يتطلب الهاتف المصادقة أو الملخص لإعادة مزامنة ملف التعريف. باستخدام حساب ملف التعريف الصحيح، تمر المصادقة. مع حساب ملف تعريف غير صحيح، تفشل المصادقة.

  • عند توفير عنوان URL صحيح في حقل قاعدة ملف التعريف باستخدام اسم مستخدم وكلمة مرور صحيحين، يتطلب الهاتف المصادقة أو الملخص لإعادة مزامنة ملف التعريف. لا يتم استخدام حساب ملف التعريف لإعادة مزامنة الهاتف. تم تسجيل الدخول بنجاح.

  • عندما تقوم بتوفير عنوان URL صحيح في حقل قاعدة ملف التعريف باسم مستخدم وكلمة مرور غير صحيحين، سيتطلب الهاتف المصادقة أو التشفير لإعادة مزامنة ملف التعريف. لا يتم استخدام حساب ملف التعريف لإعادة مزامنة الهاتف. يفشل تسجيل الدخول دائمًا.

  • عند توفير عنوان URL غير صحيح في حقل قاعدة ملف التعريف، يفشل تسجيل الدخول دائمًا.

يمكنك أيضًا تكوين المعلمات في ملف تكوين الهاتف باستخدام رمز XML‏(cfg.xml).

يمكنك تحديد نوع مصادقة ملف التعريف من صفحة ويب إدارة الهاتف.

1

يمكنك الوصول إلى صفحة ويب إدارة الهاتف.

2

حدد صوت > توفير.

3

في قسم ملف تعريف التكوين، قم بتعيين معلمة نوع مصادقة ملف التعريف لتحديد بيانات الاعتماد المراد استخدامها لمصادقة حساب ملف التعريف.

يمكنك تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق:

<Profile_Authentication_Type ua="na">معطل</Profile_Authentication_Type>

الخيارات:

  • معطل: تعطيل ميزة حساب ملف التعريف. عندما يتم تعطيل هذه الميزة، لا تعرض قائمة إعداد حساب ملف التعريف على شاشة الهاتف.

  • مصادقة HTTP الأساسي: تُستخدم بيانات اعتماد تسجيل الدخول إلى HTTP لمصادقة حساب ملف التعريف.

  • مصادقة XSI: تُستخدم بيانات اعتماد تسجيل الدخول إلى XSI أو بيانات اعتماد SIP لـ XSI لمصادقة حساب ملف التعريف. تعتمد بيانات اعتماد المصادقة على نوع مصادقة XSI للهاتف:

    عند تعيين نوع مصادقة XSI للهاتف على بيانات اعتماد تسجيل الدخول، يتم استخدام بيانات اعتماد تسجيل الدخول إلى XSI.

    عند تعيين نوع مصادقة XSI للهاتف على بيانات اعتماد SIP، يتم استخدام بيانات اعتماد SIP لـ XSI.

القيمة الافتراضية: مصادقة HTTP الأساسي

4

انقر فوق إرسال جميع التغييرات.

تطبيق ملف تعريف يدويًا على هاتفك

تنزيل ملف التكوين على الهاتف من خادم TFTP

أكمل هذه الخطوات لتنزيل ملف التكوين على تطبيق خادم TFTP على جهاز الكمبيوتر الخاص بك.

1

قم بتوصيل جهاز الكمبيوتر بمنفذ LAN الخاص بالهاتف.

2

قم بتشغيل تطبيق خادم TFTP على جهاز الكمبيوتر وتأكد من توفر ملف التكوين في الدليل الجذر لبروتوكول TFTP.

3

في مستعرض الويب، أدخل عنوان IP لشبكة LAN للهاتف وعنوان IP الخاص بجهاز الكمبيوتر واسم الملف وبيانات اعتماد تسجيل الدخول. استخدم هذا التنسيق:

http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=<password>

المثال: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
تنزيل ملف التكوين على الهاتف باستخدام cURL

أكمل هذه الخطوات لتنزيل التكوين على الهاتف باستخدام cURL. تُستخدم أداة سطر الأوامر هذه لنقل البيانات باستخدام بنية URL. لتنزيل cURL، تفضل بزيارة:

https://curl.haxx.se/download.html

نوصي بعدم استخدام عنوان cURL لنشر التكوين على الهاتف لأنه قد يتم التقاط اسم المستخدم وكلمة المرور أثناء استخدام cURL.

1

قم بتوصيل جهاز الكمبيوتر بمنفذ LAN الخاص بالهاتف.

2

قم بتنزيل ملف التكوين على الهاتف عن طريق إدخال أمر cURL التالي:

curl –d @my_config.xml“http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”

ملفات تعريف التكوين

يقبل الهاتف التكوينات بتنسيق XML.

تستخدم الأمثلة في هذا القسم ملفات تعريف التكوين مع بنية XML.

تنسيقات ملف تعريف التكوين

يحدد ملف تعريف التكوين قيم المعلمات للهاتف.

يستخدم تنسيق XML لملف تعريف التكوين أدوات تأليف XML القياسية لتجميع المعلمات والقيم.

يتم دعم مجموعة أحرف UTF-8 فقط. إذا قمت بتعديل ملف التعريف في محرر، فلا تقم بتغيير تنسيق الترميز؛ خلاف ذلك، لا يمكن للهاتف التعرف على الملف.

يحتوي كل هاتف على مجموعة ميزات مختلفة، وبالتالي، مجموعة مختلفة من المعلمات.

افتح تنسيق ملف التعريف

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

يمكن للهاتف قبول تنسيقات التكوين التي تنشئها الأدوات القياسية. تعمل هذه الميزة على تسهيل تطوير برنامج خادم التوفير الخلفي الذي يقوم بإنشاء ملفات تعريف التكوين من قواعد البيانات الحالية.

لحماية المعلومات السرية في ملف تعريف التكوين، يسلم خادم التوفير ملف تكوين XML إلى الهاتف عبر قناة مؤمنة بواسطة TLS. بشكل اختياري، يمكن ضغط الملف باستخدام خوارزمية انكماش gzip ‏(RFC1951).

يمكن تشفير الملف بإحدى طرق التشفير التالية:

  • تشفير AES-256-CBC

  • تشفير محتوى HTTP المستند إلى RFC-8188 مع تشفير AES-128-GCM

يمكن أن يتضمن ملف التكوين هذه المكونات:

  • علامات العنصر

  • السمات

  • معلمات

  • ميزات التنسيق

  • تعليقات XML

مثال: فتح تنسيق الملف الشخصي

<flat-profile><Resync_On_Reset> Yes </Resync_On_Reset><Resync_Periodic> 7200 </Resync_Periodic><Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule></flat-profile>

تتضمن علامة العنصر <flat-profile> جميع عناصر المعلمات التي يتعرف عليها الهاتف.

خصائص علامة العنصر

ضع القواعد التالية في الاعتبار عند إنشاء ملف التكوين أو تحديثه.

  • يسمح تنسيق توفير XML وواجهة مستخدم الويب بتكوين نفس الإعدادات. أسماء علامة XML وأسماء الحقول في واجهة مستخدم الويب متشابهة ولكنها تختلف بسبب قيود اسم عنصر XML. على سبيل المثال، التسطير السفلي (_) في ملف تكوين XML بدلًا من المسافات على واجهة مستخدم الويب.

  • يتعرف الهاتف على العناصر ذات أسماء المعلمات المناسبة المغلفة في عنصر <flat-profile> الخاص.

  • أسماء العناصر محاطة بأقواس زاوية.

  • تتشابه معظم أسماء العناصر مع أسماء الحقول على واجهة مستخدم الويب للهاتف، مع التعديلات التالية:

    • لا يجوز أن تتضمن أسماء العناصر مسافات أو أحرفًا خاصة. لاشتقاق اسم العنصر من اسم حقل الويب، استبدل شرطة سفلية لكل مسافة أو الأحرف الخاصة [ أو ] أو ( أو )، أو /.

      مثال: يمثل عنصر <Resync_On_Reset> حقل إعادة المزامنة عند إعادة التعيين.

    • يجب أن يكون كل اسم عنصر فريدًا. في واجهة الويب الخاصة بالهاتف، يمكن أن تظهر الحقول نفسها على صفحات ويب متعددة، مثل صفحات الخط والمستخدم والامتداد. ألحق [‏n] باسم العنصر للإشارة إلى الرقم الذي يظهر في علامة تبويب الصفحة.

      مثال: يمثل العنصر <Dial_Plan_1_> خطة الطلب للخط 1.

  • يجب أن تحتوي كل علامة عنصر افتتاحي على علامة عنصر إغلاق مطابقة. على سبيل المثال:

    <flat-profile><Resync_On_Reset> Yes  </Resync_On_Reset><Resync_Periodic> 7200  </Resync_Periodic><Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg  </Profile_Rule></flat-profile>

  • علامات العناصر حساسة لحالة الأحرف.

  • يُسمح بعلامات العناصر الفارغة وسيتم تفسيرها على أنها تكوين القيمة لتكون فارغة. أدخل علامة عنصر الفتح بدون علامة عنصر مقابلة، وأدخل مسافة وشرطة مائلة للأمام قبل قوس زاوية الإغلاق (>). في هذا المثال، قاعدة ملف التعريف B فارغة:

    <Profile_Rule_B />

  • يمكن استخدام علامة عنصر فارغة لمنع الكتابة فوق أي قيم يوفرها المستخدم أثناء عملية إعادة المزامنة. في المثال التالي، لم تتغير إعدادات الطلب السريع للمستخدم:

    <flat-profile><Speed_Dial_2_Name ua="rw"/><Speed_Dial_2_Number ua="rw"/><Speed_Dial_3_Name ua="rw"/><Speed_Dial_3_Number ua="rw"/><Speed_Dial_4_Name ua="rw"/><Speed_Dial_4_Number ua="rw"/><Speed_Dial_5_Name ua="rw"/><Speed_Dial_5_Number ua="rw"/><Speed_Dial_6_Name ua="rw"/><Speed_Dial_6_Number ua="rw"/><Speed_Dial_7_Name ua="rw"/><Speed_Dial_7_Number ua="rw"/><Speed_Dial_8_Name ua="rw"/><Speed_Dial_8_Number ua="rw"/><Speed_Dial_9_Name ua="rw"/><Speed_Dial_9_Number ua="rw"/></flat-profile>

  • استخدم قيمة فارغة لتعيين المعلمة المقابلة على سلسلة فارغة. أدخل عنصر فتح وإغلاق بدون أي قيمة بينهما. في المثال التالي، تم تعيين المعلمة GPP_A على سلسلة فارغة.

    <flat-profile><GPP_A>  </GPP_A></flat-profile>

  • يتم تجاهل أسماء العناصر غير المعروفة.

خصائص المعلمة

تنطبق هذه الخصائص على المعلمات:

  • أي معلمات لم يتم تحديدها بواسطة ملف تعريف يتم تركها بدون تغيير في الهاتف.

  • يتم تجاهل المعلمات غير المعروفة.

  • إذا كان ملف تخصيص التنسيق المفتوح يحتوي على تكرارات متعددة لنفس علامة المعلمة، فإن التكرار الأخير من هذا القبيل يتجاوز أي تكرارات سابقة. لتجنب التجاوز غير المقصود لقيم التكوين للمعلمة، نوصي بأن يحدد كل ملف تعريف مثيلاً واحدًا على الأكثر من المعلمة.

  • ملف التعريف الأخير الذي تمت معالجته له الأسبقية. إذا حددت ملفات تعريف متعددة نفس معلمة التكوين، فإن قيمة ملف التعريف الأخير لها الأسبقية.

تنسيقات السلاسل

تنطبق هذه الخصائص على تنسيق السلاسل:

  • يُسمح بالتعليقات من خلال بنية XML القياسية.

    <!-- My comment is typed here -->

  • يُسمح بالمسافة البيضاء البادئة والزائدة لسهولة القراءة ولكن تتم إزالتها من قيمة المعلمة.

  • يتم تحويل الخطوط الجديدة داخل القيمة إلى مسافات.

  • عنوان XML للنموذج <؟ ?>مسموح بها، لكن الهاتف يتجاهلها.

  • لإدخال أحرف خاصة، استخدم عمليات تخطي أحرف XML الأساسية، كما هو موضح في الجدول التالي.

    الحرف الخاص

    تسلسل هروب XML

    & (علامة العطف)

    &amp;

    < (أقل من)

    &lt;

    > (أكبر من)

    &gt;

    ’ (الفاصلة العليا)

    &apos;

    " (اقتباس مزدوج)

    &quot;

    في المثال التالي، يتم إدخال حالات هروب الأحرف لتمثيل أكبر من وأقل الرموز المطلوبة في قاعدة مخطط الطلب. يحدد هذا المثال خطة الاتصال بالخط الساخن للمعلومات التي تحدد المعلمة <Dial_Plan_1_> (تسجيل دخول المسؤول > خيارات متقدمة > صوت > Ext (n)) يساوي (S0 <:18005551212>).

    <flat-profile> <Dial_Plan_1_> (S0 &lt;:18005551212&gt;) </Dial_Plan_1_></flat-profile>

  • ‏‫وتمت ترجمة أحرف رقمية للهروب باستخدام القيم العشرية والسداسية العشرية (s.a. &#40; و&#x2e;).

  • يدعم البرنامج الثابت للهاتف أحرف ASCII فقط.

فتح ضغط وتشفير (XML) ملف التعريف

يمكن ضغط ملف تعريف التكوين المفتوح لتقليل حمل الشبكة على خادم التوفير. يمكن أيضًا تشفير ملف التعريف لحماية المعلومات السرية. الضغط غير مطلوب، لكن يجب أن يسبق التشفير.

فتح ضغط ملف التعريف

طريقة الضغط المدعومة هي خوارزمية انكماش gzip ‏(RFC1951). تتوفر الأداة المساعدة gzip ومكتبة الضغط التي تنفذ نفس الخوارزمية (zlib) من مواقع الإنترنت.

لتحديد الضغط، يتوقع الهاتف أن يحتوي الملف المضغوط على هاتف متوافق مع gzip. يؤدي استدعاء أداة gzip في ملف تعريف المفتوح الأصلي إلى إنشاء الهاتف. يفحص الهاتف عنوان الملف الذي تم تنزيله لتحديد تنسيق الملف.

على سبيل المثال، إذا كان profile.xml ملف تعريف صالحًا، فإن ملف profile.xml.gz مقبول أيضًا. يمكن لأي من الأمرين التاليين إنشاء نوع ملف التعريف هذا:

  • >gzip profile.xml

    استبدال الملف الأصلي بالملف المضغوط.

  • >cat profile.xml | gzip > profile.xml.gz

    يترك الملف الأصلي في مكانه وينتج ملفًا مضغوطًا جديدًا.

فتح تشفير ملف التعريف

يمكن استخدام تشفير المفتاح المتماثل لتشفير ملف تعريف تكوين مفتوح، سواء كان الملف مضغوطًا أو لا. يجب تطبيق الضغط، إذا تم تطبيقه، قبل التشفير.

يستخدم خادم التوفير HTTPS للتعامل مع التوفير الأولي للهاتف بعد النشر. يسمح التشفير المسبق لملفات تعريف التكوين في وضع عدم الاتصال باستخدام HTTP لإعادة مزامنة ملفات التعريف في وقت لاحق. يقلل هذا من الحمل على خادم HTTPS في عمليات النشر واسعة النطاق.

يدعم الهاتف طريقتين لتشفير ملفات التكوين:

  • تشفير AES-256-CBC

  • تشفير محتوى HTTP المستند إلى RFC 8188 مع تشفير AES-128-GCM

يجب توفير المفتاح أو مادة إدخال الإدخال (IKM) مسبقًا في الوحدة في وقت سابق. يمكن تنفيذ Bootstrap للمفتاح السري بأمان باستخدام HTTPS.

لا يتطلب اسم ملف التكوين تنسيقًا محددًا، ولكن يتطلب اسم ملف ينتهي بامتداد .cfg عادةً ما يشير إلى ملف تعريف التكوين.

تشفير AES-256-CBC

يدعم الهاتف تشفير AES-256-CBC لملفات التكوين.

يمكن لأداة تشفير OpenSSL، المتوفرة للتنزيل من مواقع الإنترنت المختلفة، إجراء التشفير. قد يتطلب دعم تشفير ‏AES ‏256 بت إعادة تجميع الأداة لتمكين رمز AES. تم اختبار البرنامج الثابت مقابل الإصدار openssl-1.1.1d.

بالنسبة لملف مشفر، يتوقع ملف التعريف أن يكون للملف نفس التنسيق الذي تم إنشاؤه بواسطة الأمر التالي:

 # مثال مفتاح التشفير = SecretPhrase1234 openssl enc –e –AES-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # استدعاء مماثل لملف xml مضغوط openssl enc –e –AES-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

يسبق الحرف الصغير -k المفتاح السري، والذي يمكن أن يكون أي عبارة نص عادي، والذي يستخدم لإنشاء salt عشوائي 64 بت. باستخدام السر المحدد بواسطة الوسيطة -k، تشتق أداة التشفير متجهًا أوليًا عشوائيًا 128 بت ومفتاح تشفير 256 بت الفعلي.

عند استخدام هذا النوع من التشفير في ملف تعريف التكوين، يجب إبلاغ الهاتف بقيمة المفتاح السري لفك تشفير الملف. يتم تحديد هذه القيمة كمؤهل في عنوان URL لملف التعريف. يكون البنية كما يلي، باستخدام عنوان URL صريح:

[--key “SecretPhrase1234”] http://prov.telco.com/path/profile.cfg

تمت برمجة هذه القيمة باستخدام إحدى معلمات Profile_Rule.

توسيع الماكرو

تخضع العديد من معلمات التوفير للتوسع الكلي داخليًا قبل أن يتم تقييمها. توفر خطوة التقييم المسبق هذه قدرًا أكبر من المرونة في التحكم في إعادة مزامنة الهاتف وأنشطة الترقية.

تخضع مجموعات المعلمات هذه لتوسيع ماكرو قبل التقييم:

  • Resync_Trigger_*

  • Profile_Rule*

  • Log_xxx_Msg

  • Upgrade_Rule

في ظل ظروف معينة، تخضع بعض معلمات الأغراض العامة (GPP_*) أيضا لتوسيع الماكرو، كما هو موضح صراحة في قسم وسيطات إعادة المزامنة الاختيارية أدناه.

أثناء توسيع الماكرو، تحل محتويات المتغيرات المسماة محل تعبيرات النموذج $NAME و$(NAME) تتضمن هذه المتغيرات معلمات الأغراض العامة والعديد من معرفات المنتجات وأجهزة ضبط وقت أحداث معينة وقيم حالة التوفير. للحصول على قائمة كاملة، راجع متغيرات توسيع الماكرو ضمن معلمات التوفير.

في المثال التالي، يتم استخدام التعبير $(MAU) لإدراج عنوان MAC رقم 000E08012345.

يقوم المسؤول بإدخال: $(MAU)config.cfg

توسيع الماكرو الناتج لجهاز بعنوان MAC رقم 000E08012345 هو: 000E08012345config.cfg

إذا لم يتم التعرف على اسم الماكرو، فإنه يظل غير موسع. على سبيل المثال، لم يتم التعرف على الاسم STRANGE كاسم ماكرو صالح، بينما يتم التعرف على MAU كاسم ماكرو صالح.

يقوم المسؤول بإدخال: $STRANGE$MAU.cfg

توسيع الماكرو الناتج لجهاز بعنوان MAC رقم 000E08012345 هو: $STRANGE000E08012345.cfg

لا يتم تطبيق توسيع الماكرو بشكل متكرر. على سبيل المثال، يتوسع $$MAU” إلى $MAU” (يتم توسيع $$)، ولا ينتج عنه عنوان MAC.

يتم تعيين محتويات معلمات الأغراض الخاصة، GPP_SA حتى GPP_SD، لتعبيرات الماكرو $SA حتى $SD. يتم توسيع هذه المعلمات الماكرو فقط كوسيطة لخيارات --key ، و--uid، و--pwd في عنوان URL لإعادة المزامنة.

التعبيرات الشرطية

يمكن أن تؤدي التعبيرات الشرطية إلى تشغيل أحداث إعادة المزامنة والتحديد من عناوين URL البديلة لعمليات إعادة المزامنة والترقية.

تتكون التعبيرات الشرطية من قائمة مقارنات مفصولة بـ وعامل. يجب استيفاء جميع المقارنات حتى يكون الشرط صحيحًا.

يمكن أن تتعلق كل مقارنة بأحد الأنواع الثلاثة التالية من المعطيات الحرفية:

  • قيم العدد الصحيح

  • أرقام إصدارات البرامج أو الأجهزة

  • سلاسل مزدوجة بين علامات الاقتباس

أرقام الإصدارات

تستخدم نسخة البرنامج الخاصة بهاتف فيديو من Cisco طراز 8875 هذا التنسيق (حيث يكون BN هو رقم الإصدار):

PHONEOSyyyy.1-0-1-0001-BN

حيث يشير yyyy إلى طراز الهاتف أو سلسلة الهاتف؛ ويشير 1 إلى النسخة الرئيسية؛ ويشير 0 إلى النسخة الثانوية؛ ويشير 1-0001 إلى النسخة المصغرة؛ ويشير BN إلى رقم الإصدار.

يجب أن تستخدم سلسلة المقارنة نفس التنسيق. وبخلاف ذلك، ينتج خطأ في تحليل التنسيق.

عند مقارنة إصدار البرنامج، تتم مقارنة الإصدار الرئيسي، والإصدار الثانوي، والإصدار المصغر بالتسلسل، وتأخذ الأرقام الموجودة في أقصى اليسار الأسبقية على تلك الأخيرة. عندما تكون أرقام الإصدارات متطابقة، تتم مقارنة رقم الإصدار.

أمثلة على رقم الإصدار الصحيح

PHONEOS-8875.1-0-1-0001-19

المقارنة

يمكن مقارنة السلاسل المقتبسة من أجل المساواة أو عدم المساواة. يمكن أيضًا مقارنة الأعداد الصحيحة وأرقام الإصدارات حسابيًا. يمكن التعبير عن عوامل المقارنة كرموز أو كمختصرات. تعتبر الاختصارات ملائمة للتعبير عن الشرط في ملف تعريف تنسيق مفتوح.

المشغِّل

البنية البديل

الوصف

ينطبق على عدد صحيح ومعاملات الإصدار

ينطبق على معاملات السلاسل المقتبسة

=

eq

يساوي

نعم

نعم

!=

ne

لا يساوي

نعم

نعم

&lt

lt

أقل من

نعم

لا

<=

le

أقل من أو يساوي

نعم

لا

&gt

gt

أكبر من

نعم

لا

>=

ge

أكبر من أو يساوي

نعم

لا

AND

و

نعم

نعم

من المهم إحاطة متغيرات الماكرو بعلامات اقتباس مزدوجة حيث يُتوقع وجود سلسلة حرفية. لا تفعل ذلك في حالة توقع رقم أو رقم إصدار.

عند استخدامها في سياق معلمات Profile_Rule * وUpgrade_Rule، يجب تضمين التعبيرات الشرطية في البنية "(expr)؟" كما في هذا المثال على قاعدة الترقية. لا تنس استبدال BN برقم إصدار تحميل البرنامج الثابت للترقية إليه.

($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads

لا تستخدم الصيغة السابقة ذات الأقواس لتكوين معلمات Resync_Trigger_ *.

بناء جملة عنوان URL

استخدم بنية URL القياسية لتحديد كيفية استرداد ملفات التكوين وتحميلات البرامج الثابتة في Profile_Rule * ومعلمات Upgrade_Rule، على التوالي. تكون البنية على النحو التالي:

[ scheme:// ] [ server [:port]] filepath

حيث المخطط هو أحد هذه القيم:

  • tftp

  • http

  • https

إذا تم حذف المخطط، يتم افتراض tftp. يمكن أن يكون الخادم اسم مضيف معترف به من خلال DNS أو عنوان IP رقمي. المنفذ هو رقم منفذ UDP أو TCP الخاص بالوجهة. يجب أن يبدأ مسار الملف بالدليل الجذر (/)؛ يجب أن يكون مسارًا مطلقًا.

إذا كان الخادم مفقودًا، فسيتم استخدام خادم tftp المحدد من خلال DHCP (الخيار 66).

بالنسبة لقواعد الترقية، يجب تحديد الخادم.

إذا كان المنفذ مفقودًا، يتم استخدام المنفذ القياسي للنظام المحدد. يستخدم Tftp منفذ UDP رقم 69، ويستخدم http منفذ TCP رقم 80، ويستخدم https منفذ TCP رقم 443.

يجب أن يكون مسار الملف موجودًا. لا يحتاج بالضرورة إلى الإشارة إلى ملف ثابت، ولكن يمكن أن يشير إلى المحتوى الديناميكي الذي تم الحصول عليه من خلال CGI.

يتم تطبيق توسيع الماكرو داخل عناوين URL. فيما يلي أمثلة على عناوين URL الصالحة:

 /$MA.cfg /cisco/cfg.xml 192.168.1.130/profiles/init.cfg tftp://prov.call.com/cpe/cisco$MA.cfg http://neptune.speak.net:8080/prov/$D/$E.cfg https://secure.me.com/profile?Linksys

عند استخدام خيار DHCP رقم 66، لا تدعم قواعد الترقية البنية الفارغة. إنه قابل للتطبيق فقط لقاعدة ملف التعريف*.

تشفير محتوى HTTP المستند إلى RFC 8188

يدعم الهاتف تشفير محتوى HTTP المستند إلى RFC 8188 مع تشفير AES-128-GCM لملفات التكوين. باستخدام طريقة التشفير هذه، يمكن لأي كيان قراءة عناوين رسائل HTTP. ومع ذلك، يمكن فقط للكيانات التي تعرف مادة إدخال المفاتيح (IKM) قراءة الحمولة. عندما يتم توفير الهاتف بـ IKM، يمكن للهاتف وخادم التوفير تبادل ملفات التكوين بأمان، مع السماح لعناصر شبكة الطرف الثالث باستخدام عناوين الرسائل لأغراض التحليل والمراقبة.

تحتوي معلمة تكوين XML IKM_HTTP_Encrypt_Content على IKM على الهاتف. لأسباب تتعلق بالأمان، لا يمكن الوصول إلى هذه المعلمة على صفحة ويب إدارة الهاتف. كما أنه غير مرئي في ملف تكوين الهاتف، والذي يمكنك الوصول إليه من عنوان IP الخاص بالهاتف أو من تقارير تكوين الهاتف المرسلة إلى خادم التوفير.

إذا كنت تريد استخدام التشفير المستند إلى RFC 8188، فتأكد مما يلي:

  • قم بتوفير الهاتف بـ IKM عن طريق تحديد IKM بمعملة XML IKM_HTTP_Encrypt_Content في ملف التكوين الذي تم إرساله من خادم التوفير إلى الهاتف.

  • إذا تم تطبيق هذا التشفير على ملفات التكوين المرسلة من خادم التوفير إلى الهاتف، فتأكد من أن رأس HTTP لترميز المحتوى في ملف التكوين يحتوي على AES128GCM.

    في حالة عدم وجود هذا العنوان، يتم إعطاء الأسبقية لطريقة AES-256-CBC. يطبق الهاتف فك تشفير AES-256-CBC إذا كان مفتاح AES-256-CBC موجودًا في قاعدة ملف تعريف، بغض النظر عن IKM.

  • إذا كنت تريد أن يقوم الهاتف بتطبيق هذا التشفير على تقارير التكوين التي يرسلها إلى خادم التوفير، فتأكد من عدم وجود مفتاح AES-256-CBC محدد في قاعدة التقرير.

وسيطات إعادة المزامنة الاختيارية

يمكن أن تسبق الوسيطات الاختيارية، مفتاح، وuid، و pwd، عناوين URL التي تم إدخالها في معلمات Profile_Rule*، المحاطة معًا بأقواس مربعة.

مفتاح

يخبر خيار المفتاح الهاتف أن ملف التكوين الذي يتلقاه من خادم التوفير مشفر باستخدام تشفير AES-256-CBC، ما لم يشير رأس ترميز المحتوى في الملف إلى AES128GCM التشفير. يتم تحديد المفتاح نفسه كسلسلة تتبع المصطلح --key. يمكن وضع المفتاح بين علامتي اقتباس (") اختياريًا. يستخدم الهاتف المفتاح لفك تشفير ملف التكوين.

أمثلة الاستخدام
[--key VerySecretValue][--key “my secret phrase”][--key a37d2fb9055c1d04883a0745eb0917a4]

يتم توسيع الوسيطات الاختيارية الموضوعة بين قوسين بشكل ماكرو. معلمات الأغراض الخاصة، GPP_SA إلى GPP_SD، يتم توسيعها بشكل ماكرو إلى متغيرات الماكرو، $SA من خلال $SD، فقط عندما يتم استخدامها كوسيطات خيار رئيسي. انظر هذه الأمثلة:

[--key $SC][--key “$SD”]

في ملفات تعريف التنسيق المفتوحة، يجب أن تكون وسيطة --key نفس الشيء مثل وسيطة خيار -k التي تم منحه لـ openssl.

uid وpwd

يمكن استخدام خياري uid وpwd لتحديد معرف المستخدم وكلمة المرور التي سيتم إرسالها استجابة لتحديات مصادقة HTTP Basic وDigest عند طلب عنوان URL المحدد. يتم توسيع الوسيطات الاختيارية الموضوعة بين قوسين بشكل ماكرو. معلمات الأغراض الخاصة، GPP_SA إلى GPP_SD، يتم توسيعها بشكل ماكرو إلى متغيرات الماكرو، $SA من خلال $SD، فقط عندما يتم استخدامها كوسيطات خيار رئيسي. انظر هذه الأمثلة:

GPP_SA = معرف المستخدم الخاص بي GPP_SB = MySecretPassword

[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml

ثم قم بالتوسيع إلى:

[--uid MyUserID --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml

أنواع البيانات

تُستخدم أنواع البيانات هذه مع معلمات ملف تعريف التكوين:

  • {أ، ب، ج،...} - اختيار من بين أ، ب، ج، ...

  • Bool - قيمة منطقية لـ "نعم" أو "لا".

  • CadScript - نص صغير يحدد معلمات إيقاع الإشارة. ما يصل إلى 127 حرفًا.

    البنية: S1‏[;S2]، حيث:

    • Si=Di(تشغيلi,1/إيقافi,1[,تشغيلi,2/إيقافi,2[,تشغيلi,3/إيقافi,3[,تشغيلi,4/إيقافi,4[,تشغيلi,5/إيقافi,5[,تشغيلi,6/إيقافi,6]]]]]) ومعرف كقسم.

    • تشغيلi,j وإيقافi,j هي مدى التشغيل/الإيقاف بالثواني للمقطع. i = 1 أو 2، وj = 1 إلى 6.

    • Di هي المدة الإجمالية للقسم بالثواني.

    يمكن أن تحتوي جميع الفترات على ما يصل إلى ثلاث منازل عشرية لتوفير دقة تبلغ 1 مللي ثانية. يرمز حرف البدل "*" إلى مدة لانهائية. يتم تشغيل المقاطع الموجودة داخل القسم بالترتيب وتتكرر حتى يتم تشغيل المدة الإجمالية.

    مثال 1:

     60 (2/4) عدد أقسام الإيقاع = 1 قسم الإيقاع 1: طول القسم = 60 ثانية عدد المقاطع = مقطع واحد 1: تشغيل = 2 ثانية ، إيقاف = 4 ثوان إجمالي طول الحلقة = 60 ثانية

    مثال 2 - رنين مميز (قصيرة، قصيرة، قصيرة، طويلة):

     60(.2/.2,.2/.2,.2/.2,1/4) عدد أقسام الإيقاع = 1 الإيقاع القسم 1: طول القسم = 60 ثانية عدد الأجزاء = 4 الجزء 1: تشغيل = 0.2 ثانية ، إيقاف = 0.2 ثانية الجزء 2: تشغيل = 0.2 ثانية ، إيقاف = 0.2 ثانية الجزء 3: تشغيل = 0.2 ثانية ، إيقاف = 0.2 ثانية الجزء 4: تشغيل = 1.0 ثانية ، إيقاف = 4.0 ثانية إجمالي طول الحلقة = 60 ثانية

  • DialPlanScript — بنية البرمجة النصية المستخدمة لتحديد خطط طلب الخط 1 والخط 2.

  • عائمة <n> - قيمة فاصلة عائمة تصل إلى n من المنازل العشرية.

  • FQDN — اسم مجال مؤهل بالكامل. يمكن أن تحتوي على ما يصل إلى 63 حرفًا. الأمثلة هي كما يلي:

    • sip.Cisco.com:5060 أو 109.12.14.12:12345

    • sip.Cisco.com أو 109.12.14.12

  • FreqScript - نص صغير يحدد معلمات التردد والمستوى للنغمة. يحتوي على ما يصل إلى 127 حرفًا.

    البنية: F1@L1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]]، حيث:

    • F1–F6 هي التردد بالهرتز (الأعداد الصحيحة دون إشارة فقط).

    • L1–L6 هي مستويات متطابقة بالديسيبل (مع ما يصل إلى منزلة عشرية واحدة).

    يُسمح بالمسافات البيضاء قبل الفاصلة وبعدها ولكن لا يُنصح بها.

    المثال 1 - نغمة انتظار المكالمة:

     440@-10 عدد الترددات = 1 التردد 1 = 440 هرتز عند -10 ديسيبل ميلي واط

    المثال 2 - نغمة الطلب:

     350@-19,440@-19 عدد الترددات = 2 التردد 1 = 350 هرتز عند -19 ديسيبل ميلي واط التردد 2 = 440 هرتز عند -19 ديسيبل ميلي واط

  • IP— عنوان IPv4 صالح على شكل x.x.x.x، حيث يقع x بين 0 و255. مثال: 10.1.2.100.

  • معرف المستخدم — معرف المستخدم كما يظهر في عنوان URL؛ حتى 63 حرفًا.

  • الهاتف — سلسلة رقم هاتف، مثل 14081234567، * 69، * 72، 345678؛ أو عنوان URL عام، مثل 1234@10.10.10.100: 5068 أو jsmith@Cisco.com. يمكن أن تحتوي السلسلة على ما يصل إلى 39 حرفًا.

  • PhTmplt — قالب رقم هاتف. قد يحتوي كل قالب على نمط واحد أو أكثر مفصولة بفاصلة (،). يتم تجاهل المسافة البيضاء في بداية كل نمط. "؟" و"*" يمثلان أحرف البدل. للتمثيل حرفيًا، استخدم %xx. على سبيل المثال، %2a يمثل *. يمكن أن يحتوي النموذج على ما يصل إلى 39 حرفًا. أمثلة: "1408*، 1510*"، "1408123؟؟؟؟، 555؟1.".

  • المنفذ — رقم منفذ TCP/UDP ‏(0-65535). يمكن تحديده بالتنسيق العشري أو السداسي.

  • ProvisioningRuleSyntax — بنية البرمجة النصية المستخدمة لتحديد قواعد إعادة مزامنة التكوين وترقية البرنامج الثابت.

  • PwrLevel - يتم التعبير عن مستوى الطاقة بالديسيبل مع منزلة عشرية واحدة، مثل -13.5 أو 1.5 (ديسيبل ميلي واط).

  • RscTmplt—قالب لرمز حالة استجابة SIP، مثل "404، 5 *"، "61؟"، "407، 408، 487، 481". يمكن أن يحتوي على ما يصل إلى 39 حرفًا.

  • Sig<n>—قيمة n بت الموقعة. يمكن تحديده بالتنسيق العشري أو السداسي. يجب أن تسبق علامة "-" القيم السالبة. علامة + قبل القيم الموجبة اختيارية.

  • رموز النجوم — رمز التنشيط لخدمة تكميلية، مثل *69. يمكن أن يحتوي الرمز على ما يصل إلى 7 أحرف.

  • Str‏<n> - سلسلة عامة تحتوي على ما يصل إلى n من الأحرف غير المحجوزة.

  • الوقت <n> — مدة الوقت بالثواني، مع ما يصل إلى n من المنازل العشرية. يتم تجاهل المنازل العشرية المحددة الإضافية.

  • ToneScript - برنامج نصي صغير يحدد معلمات التردد والمستوى والإيقاع لنغمة تقدم المكالمة. قد يحتوي البرنامج النصي على ما يصل إلى 127 حرفًا.

    البنية: FreqScript;Z1‏[;Z2].

    يشبه قسم Z1 قسم S1 في CadScript، باستثناء أن كل مقطع تشغيل/إيقاف يتبعه معلمة مكونات التردد: Z1 = D1(تشغيلi,1/إيقافi,1/fi,1[,تشغيلi,2/إيقافi,2/fi,2 [,تشغيلi,3/إيقافi,3/fi,3 [,تشغيلi,4/إيقافi,4/fi,4 [,تشغيلi,5/إيقافi,5/fi,5 [,تشغيلi,6/إيقافi,6/fi,6]]]]]) حيث:

    • fi,j = n1[+n2]+n3[+n4[+n5[+n6]]]]].

    • 1 < nk < 6 يحدد مكونات التردد في FreqScript المستخدمة في هذا المقطع.

    إذا تم استخدام أكثر من مكون تردد في مقطع ما، يتم جمع المكونات معًا.

    المثال رقم 1 — نغمة الطلب:

     350@-19,440@-19; 10(*/0/1+2) عدد الترددات = 2 التردد 1 = 350 هرتز عند -19 ديسيبل ميلي واط التردد 2 = 440 هرتز عند -19 ديسيبل ميلي واط عدد أقسام الإيقاع = 1 الإيقاع القسم 1: طول القسم = 10 ثوان عدد المقاطع = 1 المقطع 1: تشغيل = إلى الأبد ، مع الترددات 1 و 2 إجمالي طول النغمة = 10 ثوان

    المثال 2 — نغمة التقطع:

     350@-19,440@-19; 2(.1/.1/1+2); 10(*/0/1+2) عدد الترددات = 2 التردد 1 = 350 هرتز عند -19 ديسيبل ميلي واط التردد 2 = 440 هرتز عند -19 ديسيبل ميلي واط عدد أقسام الإيقاع = 2 الإيقاع القسم 1: طول القسم = 2 ثانية عدد المقاطع = 1 الجزء 1: تشغيل = 0.1 ثانية ، إيقاف = 0.1 ثانية مع الترددات 1 و 2 الإيقاع القسم 2: طول القسم = 10 ثوان عدد المقاطع = مقطع واحد 1: تشغيل = إلى الأبد ، مع الترددات 1 و 2 إجمالي طول النغمة = 12 ثانية

  • Uns<n>—قيمة n بت غير موقعة، حيث n = 8 أو 16 أو 32. يمكن تحديدها بتنسيق عشري أو سداسي عشري، مثل 12 أو 0x18 ، طالما أن القيمة يمكن أن تتناسب مع n بت.

راعي الأمور التالية:

  • يمثل <Par Name> اسم معلمة التكوين. في ملف التعريف، يتم تشكيل العلامة المقابلة عن طريق استبدال المسافة بتسطير سفلي "_"، مثل Par_Name.
  • يشير حقل القيمة الافتراضية الفارغ إلى سلسلة فارغة <"">.
  • يستمر الهاتف في استخدام آخر قيم تم تكوينها للعلامات غير الموجودة في ملف تعريف معين.
  • تتم مقارنة القوالب بالترتيب المحدد. تم تحديد المقاربة الأولى وليس الأقرب. يجب أن يتطابق اسم المعلمة تمامًا.
  • إذا تم تقديم أكثر من تعريف واحد لمعلمة في ملف تعريف، فإن آخر تعريف في الملف هو الذي يسري مفعوله في الهاتف.
  • تحدد مواصفات المعلمة بقيمة معلمة فارغة تجبر المعلمة على العودة إلى قيمتها الافتراضية. لتحديد سلسلة فارغة بدلاً من ذلك، استخدم السلسلة الفارغة "" كقيمة معلمة.