تكوين إعدادات ملف التعريف لهواتف سلسلة 9800 و8875 (BroadWorks)

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

أعد مزامنة ملف تعريف الهاتف عبر 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` برقم الطراز `وعنوان macبعنوان` 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	في حقل Resync Periodic، أدخل قيمة صغيرة للاختبار، مثل 30 ثانية.
5	انقر فوق إرسال جميع التغييرات. باستخدام إعدادات المعلمات الجديدة، يقوم الهاتف بإعادة المزامنة مرتين في الدقيقة مع ملف التكوين الذي يحدده عنوان URL.
6	لاحظ الرسائل الناتجة في تتبع سجل النظام.
7	تأكد من تعيين حقل إعادة المزامنة عند إعادة الضبط إلى نعم. `<Resync_On_Reset>Yes</Resync_On_Reset>`
8	قم بتدوير طاقة الهاتف لإجباره على إعادة المزامنة مع خادم التزويد. في حالة فشل عملية إعادة المزامنة لأي سبب، مثل عدم استجابة الخادم، تنتظر الوحدة (عدد الثواني التي تم تكوينها في إعادة المزامنة Error Retry Delay) قبل أن تحاول إعادة المزامنة مرة أخرى. إذا كان تأخير إعادة المحاولة في إعادة المزامنة يساوي صفر، فلن يحاول الهاتف إعادة المزامنة بعد محاولة إعادة المزامنة الفاشلة.
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 حتى يبدأ الهاتف في إعادة المزامنة. القيمة الافتراضية فارغة. إذا كانت القيمة غير صالحة، يتم تجاهل المعلمة. في حالة تعيين هذه المعلمة بقيمة صالحة، يتم تجاهل المعلمة Resync Periodic.
إعادة المزامنة عند التأخير العشوائي	يمنع التحميل الزائد لخادم التزويد عند تشغيل عدد كبير من الأجهزة في وقت واحد. لتجنب تدفق طلبات إعادة المزامنة إلى الخادم من هواتف متعددة، يقوم الهاتف بإعادة المزامنة في النطاق بين الساعات والدقائق والساعات والدقائق بالإضافة إلى التأخير العشوائي (hhmm، hhmm+random_delay). على سبيل المثال، إذا كان التأخير العشوائي = (Resync At Random Delay + 30) /60 دقيقة، يتم تحويل قيمة الإدخال بالثواني إلى دقائق، مع تقريبها إلى الدقيقة التالية لحساب الفاصل الزمني random_delay النهائي. في ملف تكوين الهاتف (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 تحتوي على رأس Event: resync إلى الجهاز. في ملف تكوين الهاتف (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، فلن يتم تشغيل إعادة المزامنة حتى عند تعيين Resync On Reset إلى TRUE. فقط إعادة المزامنة عبر عنوان URL للإجراء المباشر وإشعار SIP تتجاهل مشغلات إعادة المزامنة هذه. يمكن برمجة المعلمات باستخدام تعبير شرطي يخضع للتوسع الكلي. للحصول على توسعات الماكرو الصالحة، راجع متغيرات توسيع الماكرو ضمن معاملات التوفير. في ملف تكوين الهاتف (cfg.xml) مع XML، أدخل سلسلة بهذا التنسيق: `<Resync_Trigger_1 ua="na">احصل على 300 دولار أمريكي وPRVTMR بسعر 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 أو بيانات اعتماد XSI SIP لمصادقة حساب ملف التعريف. تعتمد بيانات اعتماد المصادقة على نوع مصادقة XSI للهاتف: عند تعيين نوع مصادقة XSI للهاتف إلى بيانات اعتماد تسجيل الدخول، يتم استخدام بيانات اعتماد تسجيل الدخول إلى XSI. عند تعيين نوع مصادقة XSI للهاتف إلى بيانات اعتماد SIP، يتم استخدام بيانات اعتماد XSI SIP. في ملف تكوين الهاتف (cfg.xml) مع XML، أدخل سلسلة بهذا التنسيق: `<Profile_Authentication_Type ua="na">مصادقة Http الأساسية</Profile_Authentication_Type>` في صفحة الويب الخاصة بالهاتف، حدد خيارًا من قائمة الهاتف لمصادقة إعادة مزامنة ملف التعريف. الإعداد الافتراضي: مصادقة HTTP الأساسية لمزيد من المعلومات، راجع تحديد نوع مصادقة ملف التعريف ضمن تحديد الهاتف لإعادة مزامنة ملف التعريف.
قاعدة الملف الشخصي قاعدة الملف الشخصي B قاعدة الملف الشخصي C قاعدة الملف الشخصي D	تُعلم كل قاعدة ملف تعريف الهاتف بمصدر يمكن من خلاله الحصول على ملف تعريف (ملف التكوين). أثناء كل عملية إعادة المزامنة، يقوم الهاتف بتطبيق جميع ملفات التعريف بالتسلسل. إذا كنت تقوم بتطبيق تشفير AES-256-CBC على ملفات التكوين، فحدد مفتاح التشفير باستخدام الكلمة الأساسية `--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 إلى واجهة CGI الخاصة بالهاتف: http://PhoneIPAddress/CGI/Execute.

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


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

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

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

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

اسم خادم التوفير أو عنوان IP الصريح. إذا حدد ملف التعريف خادم التوفير بالاسم، فسيقوم الهاتف بإجراء بحث DNS لحل الاسم.
منفذ خادم غير قياسي تم تحديده في عنوان URL باستخدام syntax: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">Disabled</Profile_Authentication_Type>` خيارات: معطل: تعطيل ميزة حساب الملف الشخصي. عند تعطيل هذه الميزة، لا تظهر قائمة إعداد حساب الملف الشخصي على شاشة الهاتف. مصادقة HTTP الأساسية: يتم استخدام بيانات اعتماد تسجيل دخول HTTP لمصادقة حساب ملف التعريف. مصادقة XSI: يتم استخدام بيانات اعتماد تسجيل الدخول إلى XSI أو بيانات اعتماد XSI SIP لمصادقة حساب ملف التعريف. تعتمد بيانات اعتماد المصادقة على نوع مصادقة XSI للهاتف: عند تعيين نوع مصادقة XSI للهاتف إلى بيانات اعتماد تسجيل الدخول، يتم استخدام بيانات اعتماد تسجيل الدخول إلى XSI. عند تعيين نوع مصادقة XSI للهاتف إلى بيانات اعتماد SIP، يتم استخدام بيانات اعتماد XSI SIP. الإعداد الافتراضي: مصادقة 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 deflate (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 القياسية.

يُسمح بالمساحة البيضاء الأمامية والخلفية لسهولة القراءة ولكن تتم إزالتها من قيمة المعلمة.
يتم تحويل الأسطر الجديدة داخل القيمة إلى مسافات.
رأس XML للنموذج <? ؟ > مسموح به، لكن الهاتف يتجاهله.
لإدخال أحرف خاصة، استخدم عمليات الهروب الأساسية من أحرف XML، كما هو موضح في الجدول التالي.
شخصية خاصة
تسلسل الهروب من XML
& (علامة العطف)
&
< (أقل من)
<
> (أكبر من)
>
'(فاصلة عليا)
'
«(اقتباس مزدوج)
«
في المثال التالي، يتم إدخال عمليات هروب الأحرف لتمثيل الرموز الأكبر من والأقل من المطلوبة في قاعدة خطة الطلب. يحدد هذا المثال خطة الاتصال بالخط الساخن للمعلومات التي تحدد <Dial_Plan_1_>المعلمة (تسجيل دخول المسؤول > متقدم > الصوت > Ext (n)) التي تساوي (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>
تتم ترجمة عمليات هروب الأحرف الرقمية باستخدام القيم العشرية والسداسية العشرية (s.a.).
تدعم البرامج الثابتة للهاتف أحرف ASCII فقط.

شخصية خاصة	تسلسل الهروب من XML
& (علامة العطف)	&
< (أقل من)	<
> (أكبر من)	>
'(فاصلة عليا)	'
«(اقتباس مزدوج)	«

افتح ضغط الملف الشخصي

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

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

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

>gzip profile.xml

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

>ملف تعريف الارتباط profile.xml | gzip > الملف الشخصي.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.

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

# example encryption key = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # analogous invocation for a compressed xml file openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

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

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

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

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

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

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

إعادة مزامنة_الزناد _*

قاعدة الملف الشخصي*

لوغ_XXX_MSG

قاعدة_الترقية

في ظل ظروف معينة، تخضع بعض المعلمات ذات الأغراض العامة (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 البديلة لعمليات إعادة المزامنة والترقية.

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

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

قيم عدد صحيح

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

سلاسل ذات اقتباسات مزدوجة

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

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

هاتف YYYY. 1-0-1-0001 - مليار

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

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

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

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

PHONEOS-8875.1-0-1-0001-19

مقارنة

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

المشغل

بناء جملة بديل

وصف

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

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

=

مكافئ

مساو لـ

نعم

نعم

!=

واحد

لا يساوي

نعم

نعم

<

لتر

أقل من

نعم

لا

<=

لي

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

نعم

لا

>

gt

أكبر من

نعم

لا

>=

العمر

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

نعم

لا

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_*.

المشغل	بناء جملة بديل	وصف	ينطبق على معاملات الأعداد الصحيحة والإصدار	ينطبق على معاملات السلسلة المقتبسة
=	مكافئ	مساو لـ	نعم	نعم
!=	واحد	لا يساوي	نعم	نعم
<	لتر	أقل من	نعم	لا
<=	لي	أقل من أو يساوي	نعم	لا
>	gt	أكبر من	نعم	لا
>=	العمر	أكبر من أو يساوي	نعم	لا
AND		و	نعم	نعم

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

[المخطط://] [الخادم [: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/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 المحدد في قاعدة التقرير.

حجج إعادة المزامنة الاختيارية

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

مفتاح
جلد ووسادة

يخبر الخيار --key الهاتف أن ملف التكوين الذي يستقبله من خادم التزويد مشفر بتشفير 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 لتحديد معرف المستخدم وكلمة المرور اللذين سيتم إرسالهما استجابةً لتحديات مصادقة HTTP Basic و Digest عند طلب عنوان URL المحدد. يتم توسيع الحجج الاختيارية الموضوعة بين قوسين بشكل كلي. يتم توسيع المعلمات ذات الأغراض الخاصة، GPP_SA من خلال GPP_SD، بشكل ماكرو إلى متغيرات ماكرو، من $ SA إلى $SD، فقط عندما يتم استخدامها كوسيطات خيار رئيسية. راجع هذه الأمثلة:

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

سيتوسع بعد ذلك إلى:

[--uid معرف المستخدم الخاص بي - PWD كلمة المرور السرية الخاصة بي] https://provisioning_server_url/path_to_your_config/your_config.xml

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

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

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

قيمة منطقية منطقية لـ «نعم» أو «لا».

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

بناء الجملة: S ₁ [؛ S ₂]، حيث:

_{_{_{S _i =D (على _{i,1 /off i,1} [, on _i,2 /off _i,2 [, على _{i,3 /off i,3} [, على _i,4 _{/off _i,4 [, على i,5} /off _{i,5 [, on i,6} _{/off i,6}_]]]]]) ويعرف باسم القسم.}}}

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

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

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

المثال 1:

60(2/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60 s Number of Segments = 1 Segment 1: On=2s, Off=4s Total Ring Length = 60s

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

60(.2/.2,.2/.2,.2/.2,1/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60s Number of Segments = 4 Segment 1: On=0.2s, Off=0.2s Segment 2: On=0.2s, Off=0.2s Segment 3: On=0.2s, Off=0.2s Segment 4: On=1.0s, Off=4.0s Total Ring Length = 60s

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

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

FQDN - اسم نطاق مؤهل بالكامل. يمكن أن تحتوي على ما يصل إلى 63 حرفًا. ومن الأمثلة على ذلك ما يلي:
SIP.cisco.com: 5060 أو 109.12.14. 12:12345
SIP.cisco.com أو 109.12.14.12

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

بناء الجملة: F ₁ @L ₁ [، F _{2 @L ₂} [، F _{3 @L ₃} [، F _{4 @L ₄} [، F ₅ @L @L [، F _₆]]]]]، حيث:

F ₁ —F ₆ هي التردد بالهرتز (الأعداد الصحيحة غير الموقعة فقط).

L ₁ —L ₆ هي المستويات المقابلة في dBm (مع ما يصل إلى رقم عشري واحد).

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

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

440@-10 Number of Frequencies = 1 Frequency 1 = 440 Hz at –10 dBm

مثال 2 - نغمة الاتصال:

350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –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. على سبيل المثال، يمثل %2a *. يمكن أن يحتوي القالب على ما يصل إلى 39 حرفًا. أمثلة: «1408*، 1510*»، «1408123؟؟؟؟ ، 555؟ 1.».

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

ProvisioningRuleSyntax - صيغة برمجة نصية تُستخدم لتعريف قواعد إعادة مزامنة التكوين وترقية البرامج الثابتة.

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

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

التوقيع <n>- قيمة n-bit الموقعة. يمكن تحديده بالتنسيق العشري أو السداسي. يجب أن تسبق علامة «-» القيم السالبة. علامة + قبل القيم الإيجابية اختيارية.

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

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

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

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

بناء الجملة: فريسكريبت؛ Z [₁؛ Z ₂].

_{_{_{_{_{_{_{_{يشبه القسم Z _{1 قسم S ₁} في CADScript، باستثناء أن كل مقطع تشغيل/إيقاف يتبعه معامل مكونات التردد: Z 1 = D 1 (على _{i,1 /off i,1 /f _i,1 [, on i,2 /off i,2} _{[, on _i,3 /off _i,3 [, on i,3} _{/f _{i,3 [, on i,4} /f _i,4 [, on i,5} _{/off _i,5 /f _i5 [، لا يوجد i6 /خارج i،} 6 /f}}}}}}}} _{i، 6}]]]]]) حيث:

f _{i، j} = n ₁ [+n ₂] +n ₃ [+n ₄ [+n ₅ [+n ₆]]]]]].

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

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

المثال 1 - نغمة الاتصال:

350@-19,440@-19;10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 1 Cadence Section 1: Section Length = 10 s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 10s

مثال 2 - نغمة التلعثم:

350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 2 Cadence Section 1: Section Length = 2s Number of Segments = 1 Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2 Cadence Section 2: Section Length = 10s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 12s

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

ضع هذه الأمور في الاعتبار:

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

Cisco AI Assistant

شكرًا على ملاحظاتك.