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

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

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

1

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

2

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

3

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

للتحقق مما إذا كان قد تم توفير ملف التعريف لهاتفك لاحقًا، يمكنك تعيين بعض القيم كعلامات. على سبيل المثال، قم بتعيين قيمة GPP_A إلى 12345678 كما هو موضح في المثال التالي:
    <GPP_A> 12345678   A>
_
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 Rule>
rofile_
7

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

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

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

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

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

2

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

3

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

4

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

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

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

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

6

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

7

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

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

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

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

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

1

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

2

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

3

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

4

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

5

انقر على إرسال كل التغييرات.

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

6

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

7

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

 <Resync_On_Reset>نعمOn_Reset>
esync_
8

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

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

9

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

 <Resync_Error_Retry_تأخير>30Error_Retry_تأخير>
esync_
10

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

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

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

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

المعلمة

الوصف

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

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

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

    <Provision_تمكين ua="na">نعمEnable>rovision_

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

الإعداد الافتراضي: نعم

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

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

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

    <Resync_On_Reset ua="na">نعمOn_Reset>esync_

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

الإعداد الافتراضي: نعم

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

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

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

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

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

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

    <Resync_Random_تأخير ua="na">2Random_تأخير>esync_

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

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

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

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

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

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

    <Resync_At__HHmm_ ua="na">0959At__HHmm_>esync_

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

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

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

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

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

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

    <Resync_At_Random_تأخير ua="na">600At_Random_تأخير>esync_

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

تتراوح القيمة الصالحة بين 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">3600Periodic>esync_

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

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

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

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

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

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

  • عدد صحيح

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

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

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

  • نطاق زمني

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

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

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

    <Resync_Error_Retry_تأخير ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400Error_Retry_تأخير>esync_

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

الإعداد الافتراضي: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400

تأخير إعادة المزامنة المفروض

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

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

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

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

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

    <Forced_Resync_تأخير ua="na">14400Resync_تأخير>orced_

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

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

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

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

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

    <Resync_From_SIP ua="na">نعمFrom_SIP>esync_

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

الإعداد الافتراضي: نعم

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

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

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

    <resync_أfter_upgrade_محاولة ua="na">نعمأfter_upgrade_محاولة>esync_

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

الإعداد الافتراضي: نعم

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

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

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

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

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

    <Resync_Trigger_1 ua="na">$UPGTMR gt 300 و$PRVTMR GE 600Trigger_1>esync_

    <Resync_Trigger_2 ua="na"/>

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

الإعداد الافتراضي: فارغ

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

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

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

    <User_Configurable_Resync ua="na">نعمConfigurable_Resync>ser_

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

الإعداد الافتراضي: نعم

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

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

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

    <Resync_Fails_On_FNF ua="na">نعمFails_On_FNF>esync_

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

الإعداد الافتراضي: نعم

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[--key ]

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

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

    <Profile_Rule ua="na">/$PSN.xmlRule>rofile_

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_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 باستخدام البنية القياسية :المنفذ متبوعًا باسم الخادم.

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

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

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

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

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

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

 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">تم التعطيلAuthentication_Type>
rofile_

من الخيارات

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

  • مصادقة 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=

مثال: 

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 التالي:

لفة -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> نعم On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfgRule> </flat-profile>
esync_esync_rofile_

تضم علامة العنصر جميع عناصر المعلمات التي يتعرف عليها الهاتف.

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

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

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

  • يتعرف الهاتف على العناصر بأسماء المعلمات المناسبة المغلفة في العنصر الخاص.

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

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

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

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

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

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

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

      <Resync_On_Reset> نعم On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Rule>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg Rule>
    rofile_

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

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

     <Profile_Rule_B />

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

     <Speed_دial_2_الاسم ua="rw"/> <Speed_دial_2_الرقم ua="rw"/> <Speed_دial_3_الاسم ua="rw"/> <Speed_دial_3_الرقم ua="rw"/> <Speed_دial_4_الاسم ua="rw"/> <Speed_دial_4_الرقم ua="rw"/> <Speed_دial_5_الاسم ua="rw"/> <Speed_دial_5_الرقم ua="rw"/> <Speed_دial_6_الاسم ua="rw"/> <Speed_دial_6_الرقم ua="rw"/> <Speed_دial_7_الاسم ua="rw"/> <Speed_دial_7_الرقم ua="rw"/> <Speed_دial_8_الاسم ua="rw"/> <Speed_دial_8_الرقم ua="rw"/> <Speed_دial_9_الاسم ua="rw"/> <Speed_دial_9_الرقم ua="rw"/>

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

     <flat-profile> <GPP_A>   A> </flat-profile>
    _

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

خصائص المعلمات

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

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

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

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

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

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

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

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

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

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

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

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

    حرف خاص

    تسلسل هروب XML

    & (عطف)

    &

    < (أقل من)

    <

    > (أكبر من)

    >

    (نهاية العالم)

    '

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

    "

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

     <flat-profile> <Dial_Plan_1_> (S0 ) Plan_1_> </flat-profile>
    ial_

  • يتم هروب الأحرف الرقمية، باستخدام القيم العشرية والسداسية العشرية (s.a. تتم ترجمة ( و.).

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

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

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

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

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

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

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

  • >gzip profile.xml

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

  • >ملف تعريف.xml الخاص بالقط | gzip > profile.xml.gz

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

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

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

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

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

  • تشفير AES-256-CBC

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

يجب توفير المفتاح أو مادة إدخال الإدخال (IKM) مسبقًا في الوحدة في وقت سابق. يمكن تنفيذ تمهيد المفتاح السري بأمان باستخدام 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_ .

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

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

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

  • Resync_Trigger_*

  • Profile_القاعدة*

  • إلog_xxx_مسج

  • Upgrade_قاعدة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يستخدم إصدار البرنامج الخاص بهاتف Cisco Video Phone 8875 هذا التنسيق (حيث يشير BN إلى رقم الإصدار):

الهاتفyyyy.1-0-1-0001-BN

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

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

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

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

هاتف ‎8875.1-0-1-0001-19

المقارنة

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

المشغّل

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

الوصف

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

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

=

معادلة

يساوي

نعم

نعم

!=

لا

لا يساوي

نعم

نعم

<

lt

أقل من

نعم

لا

<=

في

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

نعم

لا

>

gt

أكبر من

نعم

لا

>=

جي

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

نعم

لا

MEME IT

و

نعم

نعم

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

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

($SWVER لا الهاتف 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]] مسار الملف

حيث يكون المخطط إحدى هذه القيم:

  • 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/ملفات/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 على الهاتف. لأسباب أمنية، لا يمكن الوصول إلى هذه المعلمة على صفحة ويب إدارة الهاتف. كما أنه غير مرئي في ملف تكوين الهاتف، والذي يمكنك الوصول إليه من عنوان IP الخاص بالهاتف أو من تقارير تكوين الهاتف المرسلة إلى خادم التوفير.

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

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

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

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

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

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

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

مفتاح

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

أمثلة الاستخدام
 [--key VerySecretValue] [--key "عبارتي السرية"] [--key a ｟_ph_21｠ d2fb9055c1d04883a0745eb0917a4]

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

[--key $SC] [--KEY "$SD"]

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

معرف المستخدم وpwd

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

GPP_SA = MyUserID 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]، حيث:

    • sأنا‎=dأنا(فيi، 1/إيقافi، 1[، فيط، 2/إيقافط، 2[، فيط، 3/إيقافط، 3[، فيط، 4/إيقافط، 4[، فيط، 5/إيقافط، 5[، فيط، 6/إيقافط، 6[[]]] والمعروف باسم قسم.

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

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

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

    المثال 1:

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

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

     60(.2/.2,.2/.2,.2/.2,1/4) عدد أقسام الإيقاع = 1 قسم الإيقاع 1: طول القسم = 60 ثانية عدد الأجزاء = 4 الجزء 1: تشغيل=0.2s، إيقاف=0.2s المقطع 2: تشغيل=0.2s، إيقاف=0.2s المقطع 3: تشغيل=0.2s، إيقاف=0.2s المقطع 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 dBm

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

     350@-19,440@-19 عدد التكرارات = 2 التردد 1 = 350 هرتز عند -19 dBm التردد 2 = 440 هرتز عند -19 dBm

  • 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. For example, %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 بت موقَّعة. يمكن تحديده بتنسيق عشري أو سداسي عشري. يجب أن تسبق علامة "-" القيم السالبة. علامة + قبل القيم الموجبة اختيارية.

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

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

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

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

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

    يشبه قسم Z1 قسم S1 في CadScript، باستثناء أن كل مقطع تشغيل/إيقاف يتبعه معلمة مكونات التردد: ز1 = د1(فيi، 1/إيقافi، 1/fi، 1[، فيط، 2/إيقافط، 2/fط، 2 [، فيط، 3/إيقافط، 3/fط، 3 [، فيط، 4/إيقافط، 4/fط، 4 [، فيط، 5/إيقافط، 5/fط، 5 [، فيط، 6/إيقافط، 6/fط، 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 s عدد الأجزاء = 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: طول القسم = 2s عدد الأجزاء = 1 الجزء 1: تشغيل=0.1s، إيقاف=0.1s مع الترددات 1 و2 قسم الإيقاع 2: طول القسم = 10 s عدد الأجزاء = 1 الجزء 1: تشغيل=إلى الأبد، مع الترددات 1 و2 طول النغمة الإجمالي = 12 ثانية

  • uns — قيمة n بت غير موقعة، حيث n = 8 أو 16 أو 32. يمكن تحديده بتنسيق عشري أو سداسي عشري، مثل 12 أو ⁦0x⁩18، طالما يمكن أن تتناسب القيمة مع n بت.

يرجى مراعاة ما يلي:

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