קבע את תצורת הטלפון לסנכרון מחדש של פרופיל

הטלפון תומך בפרוטוקולי רשת מרובים לאחזור פרופילי תצורה. פרוטוקול העברת הפרופיל הבסיסי ביותר הוא TFTP (RFC1350). TFTP נמצא בשימוש נרחב להקצאת מכשירי רשת בתוך רשתות LAN פרטיות. למרות שלא מומלץ לפריסה של נקודות קצה מרוחקות ברחבי האינטרנט, TFTP יכול להיות נוח לפריסה בתוך ארגונים קטנים, להקצאה מראש בתוך הבית ולפיתוח ובדיקה. בהליך הבא, פרופיל משתנה לאחר הורדת קובץ משרת TFTP.

1

בסביבת LAN, חבר את המחשב והטלפון לרכזת, מתג או נתב קטן.

2

במחשב, התקן והפעל שרת TFTP.

3

השתמש בעורך טקסט כדי ליצור פרופיל תצורה.

כדי לאמת אם הפרופיל הוקצה לטלפון שלך מאוחר יותר, באפשרותך להגדיר כמה מהערכים כסימנים. לדוגמה, הגדר את הערך עבור GPP_A ל-12345678 כמוצג בדוגמה הבאה:
 <flat-profile>   <GPP_A> 12345678   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_צריך להכיל כעת את הערך 12345678.

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_כלל> tftp://192.168.1.200/CP-8875$MA.cfg כלל> 
rofile_
7

לחץ על שלח את כל השינויים. הדבר גורם לאתחול מיידי ולסנכרון מחדש.

כאשר מתרחש הסנכרון מחדש הבא, הטלפון מאחזר את הקובץ החדש על-ידי הרחבת ביטוי המאקרו $MA לכתובת ה-MAC שלו.

1

התקן שרת HTTP במחשב המקומי או מארח נגיש אחר.

ניתן להוריד את שרת Apache בקוד פתוח מהאינטרנט.

2

העלה את קובץ פרופיל התצורה אל ספריית הבסיס הווירטואלי של השרת המותקן.

3

כדי לאמת התקנת שרת תקינה וגישה לקובץ הפרופיל, פתח את הפרופיל באמצעות דפדפן אינטרנט.

4

שנה את כלל Profile_של טלפון הבדיקה כדי להצביע על שרת ה-HTTP במקום שרת ה-TFTP, כדי להוריד את הפרופיל שלו מעת לעת.

לדוגמה, בהנחה ששרת ה-HTTP הוא 192.168.1.300 ושם קובץ הפרופיל הוא basic.txt, הזן את הערך הבא:

<Profile_כלל> ⁦http://192.168.1.200/basic.txt⁩ כלל>
rofile_
5

לחץ על שלח את כל השינויים. הדבר גורם לאתחול מיידי ולסנכרון מחדש.

6

שים לב להודעות syslog שהטלפון שולח. הסנכרון מחדש התקופתי אמור לקבל כעת את הפרופיל משרת ה-HTTP.

7

ביומני הרישום של שרת HTTP, שים לב כיצד מופיע מידע המזהה את טלפון הבדיקה ביומן של סוכני משתמשים.

מידע זה צריך לכלול את היצרן, שם המוצר, גרסת הקושחה הנוכחית ומספר סידורי.

מכשיר יכול לסנכרן מחדש מעת לעת לשרת ההקצאה כדי לוודא שכל שינויי הפרופיל שבוצעו בשרת מופצים למכשיר נקודת הקצה (בניגוד לשליחת בקשה מפורשת לסנכרון מחדש לנקודת הקצה).

כדי לגרום לטלפון לבצע סנכרון מחדש תקופתי לשרת, מוגדר כתובת URL של פרופיל תצורה באמצעות הפרמטר Profile_Rule, ותקופת סנכרון מחדש מוגדרת באמצעות הפרמטר Resync_Periodic.

1

קבל גישה לדף האינטרנט של ניהול הטלפון.

2

בחר קול  > הקצאה.

3

הגדר את הפרמטר Profile_כלל. דוגמה זו מניחה כתובת IP של שרת TFTP של 192.168.1.200.

4

בשדה סנכרון מחדש תקופתי , הזן ערך קטן לבדיקה, כגון 30 שניות.

5

לחץ על שלח את כל השינויים.

עם הגדרות הפרמטר החדשות, הטלפון מסתנכרן מחדש פעמיים בדקה לקובץ התצורה שציינת כתובת ה-URL.

6

שים לב להודעות שהתקבלו במעקב syslog.

7

ודא ששדה סנכרון מחדש באיפוס מוגדר ככן.

 <Resync_On_איפוס>כןOn_איפוס> 
esync_
8

כבה את הטלפון כדי לאלץ אותו לבצע סנכרון מחדש לשרת ההקצאה.

אם פעולת הסנכרון מחדש נכשלת מסיבה כלשהי, כגון אם השרת אינו מגיב, היחידה ממתינה (עבור מספר השניות שהוגדרו בהשהיית ניסיון חוזר של סנכרון מחדש) לפני שהיא מנסה לבצע סנכרון מחדש. אם השהיית ניסיון חוזר של שגיאה בסנכרון מחדש היא אפס, הטלפון אינו מנסה לבצע סנכרון מחדש לאחר ניסיון סנכרון כושל.

9

(אופציונלי) הגדר את הערך של שדה השהיית ניסיון חוזר של שגיאה למספר קטן, כגון 30.

 <Resync_Error_Retry_עיכוב>30Error_Retry_עיכוב> 
esync_
10

השבת את שרת TFTP, ובחן את התוצאות בפלט syslog.

הטבלה הבאה מגדירה את הפונקציה והשימוש של פרמטרי סנכרון מחדש של הפרופיל בקטע פרופיל תצורה תחת הלשונית קול > הקצאה בדף האינטרנט של הטלפון. הוא גם מגדיר את התחביר של המחרוזת שנוספה בקובץ התצורה של הטלפון (cfg.xml) עם קוד XML כדי להגדיר פרמטר.

טבלה 1. פרמטרי סנכרון מחדש של פרופיל

פרמטר

תיאור

הפעלת הקצאה

מאפשר או דוחה פעולות סנכרון מחדש של פרופיל תצורה.

  • בקובץ התצורה של הטלפון (cfg.xml) עם XML, הזן מחרוזת בתבנית הבאה:

    <Provision_הפעל ua="na">כןהפעל>rovision_
  • בדף האינטרנט של הטלפון, הגדר שדה זה במצב כן כדי לאפשר פעולות סנכרון מחדש, או לא כדי לחסום פעולות סנכרון מחדש.

ברירת מחדל: כן

סנכרון מחדש בעת איפוס

מציין אם הטלפון מסנכרן מחדש תצורות עם שרת ההקצאה לאחר ההפעלה ולאחר כל ניסיון שדרוג.

  • בקובץ התצורה של הטלפון (cfg.xml) עם XML, הזן מחרוזת בתבנית הבאה:

    <Resync_On_Reset ua="na">כןOn_איפוס>esync_
  • בדף האינטרנט של הטלפון, הגדר שדה זה למצב כן כדי לאפשר סנכרון מחדש בעת אתחול או איפוס, או לא כדי לחסום סנכרון מחדש בעת אתחול או איפוס.

ברירת מחדל: כן

השהיה אקראית של סנכרון מחדש

מונע עומס יתר של שרת ההקצאה כאשר מספר רב של מכשירים מופעלים בו-זמנית ומנסים להגדיר תצורה ראשונית. השהיה זו יעילה רק בניסיון התצורה הראשוני, לאחר הפעלה או איפוס של המכשיר.

הפרמטר הוא מרווח הזמן המרבי שהמכשיר ממתין לפני יצירת קשר עם שרת ההקצאה. ההשהיה בפועל היא מספר פסידו-אקראי בין 0 לערך זה.

פרמטר זה הוא ביחידות של 20 שניות.

טווחי הערך החוקיים בין 0 ל-65535.

  • בקובץ התצורה של הטלפון (cfg.xml) עם XML, הזן מחרוזת בתבנית הבאה:

    <Resync_Random_Delay ua="na">2Random_Delay>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_Delay ua="na">600At_Random_Delay>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_Delay ua="na">14400Resync_Delay>orced_
  • בדף האינטרנט של הטלפון, ציין את פרק הזמן בשניות.

ערך ברירת המחדל הוא 14,400 שניות.

סנכרון מחדש מ-SIP

שולט בבקשות לפעולות סנכרון מחדש באמצעות אירוע הודעת SIP שנשלח משרת ה-proxy של ספק השירות לטלפון. אם האפשרות מופעלת, ה-proxy יכול לבקש סנכרון מחדש על-ידי שליחת הודעת SIP NOTIFY המכילה את האירוע: סנכרן מחדש כותרת למכשיר.

  • בקובץ התצורה של הטלפון (cfg.xml) עם XML, הזן מחרוזת בתבנית הבאה:

    <Resync_From_SIP ua="na">כןFrom_SIP>esync_
  • בדף האינטרנט של הטלפון, בחר כן כדי להפעיל תכונה זו, או לא כדי להשבית אותה.

ברירת מחדל: כן

סנכרון מחדש לאחר ניסיון שדרוג

מפעיל או משבית את פעולת הסנכרון מחדש לאחר שדרוג כלשהו מתרחש. אם האפשרות כן נבחרת, הסנכרון מופעל לאחר שדרוג קושחה.

  • בקובץ התצורה של הטלפון (cfg.xml) עם XML, הזן מחרוזת בתבנית הבאה:

    <Resync_After_Upgrade_Attempt ua="na">כןAfter_Upgrade_Attempt>esync_
  • בדף האינטרנט של הטלפון, בחר כן כדי להפעיל סנכרון מחדש לאחר שדרוג קושחה, או לא כדי לא לבצע סנכרון מחדש.

ברירת מחדל: כן

מפעיל סנכרון מחדש 1

גורם מפעיל סנכרון מחדש 2

אם המשוואה הלוגית בפרמטרים אלה מוערכת ל-FALSE, סנכרון מחדש אינו מופעל גם כאשר Resync On Reset מוגדר ל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

כלל פרופיל D

כל כלל פרופיל מיידע את הטלפון של מקור שממנו ניתן להשיג פרופיל (קובץ תצורה). במהלך כל פעולת סנכרון מחדש, הטלפון מחיל את כל הפרופילים ברצף.

אם אתה מחיל הצפנת AES-256-CBC על קובצי התצורה, ציין את מפתח ההצפנה עם מילת המפתח --key כדלקמן:

[--מפתח ]

באפשרותך להקיף את מפתח ההצפנה במרכאות כפולות (") באופן אופציונלי.

  • בקובץ התצורה של הטלפון (cfg.xml) עם XML, הזן מחרוזת בתבנית הבאה:

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

    <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

באפשרותך להקצות טלפונים באמצעות פונקציות XML של Cisco.

באפשרותך לשלוח אובייקט XML לטלפון באמצעות מנת הודעת SIP או POST HTTP לממשק CGI של הטלפון: http://PhoneIPAddress/CGI/ביצוע.

CP-xxxx-3PCC מרחיב את תכונת Cisco XML כדי לתמוך בהקצאה דרך אובייקט XML:

 <CP-xxxx-3PCCExecute> <ExecuteItem URL=סנכרון מחדש:[profile-rule]/> </CP-xxxx-3PCCExecute> 

לאחר שהטלפון מקבל את אובייקט ה-XML, הוא מוריד את קובץ ההקצאה מ-[profile-rule]. כלל זה משתמש בפקודות מאקרו כדי לפשט את הפיתוח של יישום שירותי XML.

ספריות משנה עם פרופילים מרובים בשרת מספקות שיטה נוחה לניהול מספר רב של מכשירים שנפרסו. כתובת ה-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 במחשב שלך.

1

חבר את המחשב ליציאת ה-LAN של הטלפון.

2

הפעל יישום שרת TFTP במחשב וודא שקובץ התצורה זמין בספריית הבסיס של TFTP.

3

בדפדפן אינטרנט, הזן את כתובת ה-IP של הטלפון LAN, את כתובת ה-IP של המחשב, את שם הקובץ ואת אישורי הכניסה. השתמש בתבנית זו:

http://<WAN_IP_כתובת>/admin/resync?tftp://<PC_IP_כתובת>/<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. כלי שורת פקודה זה משמש להעברת נתונים עם תחביר של כתובת 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. לחלופין, ניתן לדחוס את הקובץ באמצעות אלגוריתם deflate gzip (RFC1951).

ניתן להצפין את הקובץ באמצעות אחת משיטות ההצפנה הבאות:

  • הצפנת AES-256-CBC

  • הצפנת תוכן RFC-8188 מבוססת HTTP עם הצפנת AES-128-GCM

קובץ תצורה יכול לכלול את הרכיבים הבאים:

  • תגי רכיב

  • תכונות

  • פרמטרים

  • תכונות עיצוב

  • הערות XML

דוגמה: פתח תבנית פרופיל

 <flat-profile> <Resync_On_איפוס> כן On_איפוס> <Resync_תקופתי> 7200 תקופתי> <Profile_כלל> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfgכלל> </flat-profile> 
esync_esync_rofile_

תג הרכיב מקיף את כל רכיבי הפרמטר שהטלפון מזהה.

מאפייני תגית רכיב

זכור את הכללים הבאים בעת יצירה או עדכון של קובץ התצורה.

  • תבנית הקצאת XML וממשק המשתמש באינטרנט מאפשרים תצורה של אותן הגדרות. שמות תג ה-XML ושמות השדות בממשק המשתמש באינטרנט דומים אך משתנים עקב מגבלות שמות רכיב XML. לדוגמה, קווים תחתונים ( _ ) בקובץ התצורה של XML במקום מרחבים בממשק המשתמש של האינטרנט.

  • הטלפון מזהה אלמנטים עם שמות פרמטרים מתאימים שמוקפצים באלמנט המיוחד.

  • שמות הרכיבים מוקפים בסוגריים זוגיים.

  • רוב שמות הרכיבים דומים לשמות השדות בממשק המשתמש באינטרנט של הטלפון, עם השינויים הבאים:

    • שמות רכיבים לא יכולים לכלול רווחים או תווים מיוחדים. כדי לגזור את שם הרכיב בשם שדה האינטרנט, החלף קו תחתון עבור כל רווח או את התווים המיוחדים [, ], (, ), או /.

      דוגמה:הרכיב <Resync_On_Reset> מייצג את השדה סנכרון מחדש באיפוס .

    • כל שם אלמנט חייב להיות ייחודי. בממשק המשתמש של האינטרנט של הטלפון, ניתן לראות את אותם שדות בדפי אינטרנט מרובים, כגון דפי קו, משתמש ושלוחה. הוסף את [n] לשם הרכיב כדי לציין את המספר המוצג בלשונית הדף.

      דוגמה:הרכיב <Dial_Plan_1_> מייצג את תוכנית החיוג עבור קו 1.

  • כל תג אלמנט פותח חייב לכלול תג אלמנט סגירה תואם. לדוגמה:

      <Resync_איפוסn_> כן איפוסn_> <Resync_תקופתי> 7200 תקופתי> <Profile_Rule>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg כלל>  
    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_> (התחברות למנהל מערכת > מתקדם > קול > Ext (n)) שווה ל-(S0 ).

     <פרופיל שטוח> <Dial_Plan_1_> (S0 ) Plan_1_> </פרופיל שטוח>
    ial_
  • תו מספרי בורח, תוך שימוש בערכים עשרוניים והקסדצימליים (s.a. ( ו.), מתורגמים.

  • קושחת הטלפון תומכת רק בתווי ASCII.

ניתן לדחוס את פרופיל התצורה הפתוחה כדי להפחית את עומס הרשת בשרת ההקצאה. ניתן גם להצפין את הפרופיל כדי להגן על מידע סודי. דחיסה אינה נדרשת, אך עליה להקדים את ההצפנה.

פתח דחיסת פרופיל

שיטת הדחיסה הנתמכת היא אלגוריתם gzip deflate (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

יש להקצות מראש את חומר המפתח או קלט Keying Material (IKM) ליחידה במועד מוקדם יותר. ניתן לבצע את Bootstrap של המפתח הסודי בצורה מאובטחת באמצעות HTTPS.

שם קובץ התצורה אינו דורש תבנית ספציפית, אבל שם קובץ שמסתיים בשלוחת .cfg מציין בדרך כלל פרופיל תצורה.

הצפנת AES-256-CBC

הטלפון תומך בהצפנת AES-256-CBC עבור קובצי תצורה.

כלי ההצפנה OpenSSL, הזמין להורדה מאתרי אינטרנט שונים, יכול לבצע את ההצפנה. תמיכה בהצפנת AES 256-BIT עשויה לדרוש קומפילציה מחדש של הכלי כדי להפעיל את קוד AES. הקושחה נבדקה נגד גרסה openssl-1.1.1d.

עבור קובץ מוצפן, הפרופיל מצפה שהקובץ יקבל את אותה תבנית שנוצרה על-ידי הפקודה הבאה:

 # דוגמה encryption key = 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 קטנה לפני המפתח הסודי, שיכול להיות כל ביטוי טקסט רגיל, ואשר משמש ליצירת מלח אקראי של 64 סיביות. עם הסוד שצוין על-ידי ארגומנט ‎- k, כלי ההצפנה מפיק וקטור ראשוני אקראי של 128 סיביות ואת מפתח ההצפנה בפועל של 256 סיביות.

כאשר נעשה שימוש בצורת הצפנה זו בפרופיל תצורה, יש להודיע לטלפון על ערך המפתח הסודי כדי לפענח את הקובץ. ערך זה מצוין כמזהה בכתובת ה-URL של הפרופיל. התחביר הוא כדלקמן, באמצעות כתובת URL מפורשת:

 [--מפתח “SecretPhrase1234”] http://prov.telco.com/path/profile.cfg 

ערך זה מתוכנת באמצעות אחד מפרמטרי Profile_Rule .

הרחבת מאקרו

מספר פרמטרי הקצאה עוברים הרחבת מאקרו פנימית לפני ההערכה. שלב קדם-הערכה זה מספק גמישות רבה יותר בשליטה בפעילויות הסנכרון והשדרוג של הטלפון.

קבוצות פרמטר אלה עוברות הרחבת מאקרו לפני ההערכה:

  • רesync_Trigger_*

  • כלל Profile_*

  • לog_xxx_Msg

  • Upgrade_כלל

בתנאים מסוימים, פרמטרים מסוימים למטרות כלליות (GPP_*) עוברים גם הרחבת מאקרו, כפי שמצוין במפורש בקטע ארגומנטים אופציונליים להלן.

במהלך הרחבת המאקרו, התוכן של המשתנים שהוזכרו מחליף ביטויים של הטופס $NAME ו-$(NAME). משתנים אלה כוללים פרמטרים למטרות כלליות, מספר מזהי מוצר, שעוני אירועים מסוימים וערכי מצב הקצאה. לרשימה מלאה, ראה משתני הרחבת מאקרו תחת פרמטרי הקצאה.

בדוגמה הבאה, הביטוי $(MAU) משמש להוספת כתובת MAC 000E08012345.

מנהל המערכת מזין: $(MAU)config.cfg

הרחבת המאקרו המתקבלת עבור מכשיר עם כתובת MAC 000E08012345 היא: 000E08012345config.cfg

אם שם מאקרו לא מזוהה, הוא נשאר לא מורחב. לדוגמה, השם STRANGE אינו מזוהה כשם מאקרו חוקי, בעוד MAU מזוהה כשם מאקרו חוקי.

מנהל המערכת מזין: $STRANGE$MAU.cfg

הרחבת המאקרו המתקבלת עבור מכשיר עם כתובת MAC 000E08012345 היא: $STRANGE121 E08012345.cfg

הרחבת מאקרו אינה מיושמת באופן רקורסיבי. לדוגמה, $$MAU” מתרחב ל-$MAU” ($ מורחב), ואינו גורם לכתובת ה-MAC.

התוכן של פרמטרי המטרה המיוחדת, GPP_SA עד GPP_SD, ממופים לביטויי המאקרו $SA עד $SD. פרמטרים אלה הם רק מאקרו מורחב כארגומנט של --מפתח , --uid, וכן --pwd אפשרויות בכתובת URL של סנכרון מחדש.

ביטויים מותנים

ביטויים מותנים יכולים להפעיל אירועי סנכרון מחדש ולבחור מתוך כתובות URL חלופיות עבור פעולות סנכרון ושדרוג.

ביטויים מותנים מורכבים מרשימה של השוואות, מופרדות על ידי האופרטור ו . כל ההשוואות חייבות להיות מסופקות כדי שהתנאי יהיה נכון.

כל השוואה יכולה להתייחס לאחד משלושת סוגי הספרות הבאים:

  • ערכים שלמים

  • מספרי גרסת תוכנה או חומרה

  • מחרוזות במרכאות כפולות

מספרי גרסה

גרסת התוכנה עבור טלפון הווידאו של Cisco 8875 משתמשת בתבנית זו (כאשר BN הוא מספר ה-Build):

PHONEOSyyyy.1-0-1-0001-BN

כאשר yyyy מציין את דגם הטלפון או סדרת הטלפון; 1 הוא הגרסה הראשית; 0 הוא הגרסה המשנית; 1-0001 הוא גרסת המיקרופון; ו-BN הוא מספר ה-Build.

המחרוזת השוואתית חייבת להשתמש באותה תבנית. אחרת, שגיאת ניתוח תבנית תוצאות.

בעת השוואת גרסת התוכנה, הגרסה הראשית, הגרסה המשנית וגרסת המיקרו מושוות ברצף, והספרות השמאליות ביותר מקבלות קדימות על פני האחרונות. כאשר מספרי הגרסה זהים, מספר ה-Build מושווה.

דוגמאות למספר גרסה חוקי

phoneos-8875.1-0-1-0001-19

השוואה

ניתן להשוות מחרוזות מצוטטות עבור שוויון או אי שוויון. ניתן גם להשוות מספרים שלמים ומספרי גרסה באופן אריתמטי. ניתן לבטא את אופרטורי ההשוואה כסמלים או כראשי תיבות. ראשי תיבות נוחים לביטוי התנאי בפרופיל בתבנית פתוחה.

אופרטור

תחביר חלופי

תיאור

ישים על אופרנד מספר שלם וגרסה

ישים על אופרנד מחרוזות מצוטטות

=

אייק

שווה ל:

כן

כן

!=

ג'ורג'יה

לא שווה ל-

כן

כן

<

ל"ת

פחות מ-

כן

לא

<=

בית הכנסת הגדול

קטן או שווה

כן

לא

>

ג'יגה-בתים

גדול מ-

כן

לא

>=

ג'ורג'

גדול או שווה ל

כן

לא

וכן

וכן

כן

כן

חשוב להקיף את משתני המאקרו במרכאות כפולות, כאשר יש לצפות לליטרל מחרוזת. אל תעשה זאת כאשר צפוי מספר או מספר גרסה.

בעת שימוש בהקשר של פרמטרי Profile_Rule* ו-Upgrade_Rule, יש להקיף ביטויים מותנים בתחביר "(expr)?", כמו בדוגמה כלל שדרוג זה. זכור להחליף את BN במספר ה-Build של טעינת הקושחה כדי לשדרג.

($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 בהתאמה. התחביר הוא כדלקמן:

[ סכימה:// ] [ שרת [:יציאה]] נתיב קובץ

כאשר הסכימה היא אחד מהערכים הבאים:

  • ה-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. עם זאת, רק הישויות שיודעות את חומר הקלט Keying (IKM) יכולות לקרוא את המטען. כאשר הטלפון מוקצה עם IKM, הטלפון ושרת ההקצאה יכולים להחליף קבצי תצורה באופן מאובטח, תוך מתן אפשרות לרכיבי רשת של צד שלישי להשתמש בכותרות ההודעה למטרות אנליטיות וניטור.

פרמטר תצורת XML IKM_HTTP_Encrypt_Content שומר את ה-IKM בטלפון. מטעמי אבטחה, פרמטר זה אינו נגיש בדף האינטרנט של ניהול הטלפון. הוא גם לא גלוי בקובץ התצורה של הטלפון, שאליו ניתן לגשת מכתובת ה-IP של הטלפון או מדוחות התצורה של הטלפון שנשלחים לשרת ההקצאה.

אם ברצונך להשתמש בהצפנה מבוססת RFC 8188, ודא את הפעולות הבאות:

  • הקצה את הטלפון עם ה-IKM על-ידי ציון ה-IKM עם פרמטר XML IKM_HTTP_Encrypt_Content בקובץ התצורה שנשלח משרת ההקצאה לטלפון.

  • אם הצפנה זו חלה על קובצי התצורה הנשלחים משרת ההקצאה לטלפון, ודא שלכותרת ה-HTTP של קידוד-תוכן בקובץ התצורה יש aes gcm.

    בהעדר כותרת זו, שיטת AES-256-CBC מקבלת קדימות. הטלפון מחיל פענוח AES-256-CBC אם מפתח AES-256-CBC קיים בכלל פרופיל, ללא קשר ל-IKM.

  • אם ברצונך שהטלפון יחיל הצפנה זו על דוחות התצורה שהוא שולח לשרת ההקצאה, ודא שאין מפתח AES-256-CBC שצוין בכלל הדוח.

ארגומנטים סנכרון מחדש אופציונליים

ארגומנטים אופציונליים, מפתח, uid ו-pwd, יכולים להופיע לפני כתובות ה-URL שהוזנו בפרמטרים Profile_Rule* , המוקפות יחד בסוגריים מרובעים.

מפתח

האפשרות --key מספרת לטלפון שקובץ התצורה שהוא מקבל משרת ההקצאה מוצפן בהצפנת AES-256-CBC, אלא אם כן הכותרת קידוד-תוכן בקובץ מציינת הצפנת aes gcm . המפתח עצמו מצוין כמחרוזת בעקבות המונח --key. ניתן להקיף את המפתח במרכאות כפולות (") באופן אופציונלי. הטלפון משתמש במפתח כדי לפענח את קובץ התצורה.

דוגמאות שימוש
 [--מפתח VerySecretValue] [--מפתח "הביטוי הסודי שלי"] [--מפתח a37d2fb9055c1d04883a0745eb0917a4] 

הארגומנטים האופציונליים המסוגגים הם מאקרו מורחב. פרמטרי מטרה מיוחדים, GPP_SA עד GPP_SD, הם מאקרו מורחב למשתני מאקרו, $SA עד $SD, רק כאשר הם משמשים כארגומנטים של אפשרות מפתח. ראה דוגמאות אלו:

[--מפתח $SC] [--מפתח “$SD”] 

בפרופילי תבנית פתוחה, הארגומנט ל---key חייב להיות זהה לאפשרות -k שניתנת ל-openssl.

uid ו-pwd

ניתן להשתמש באפשרויות uid ו-pwd כדי לציין את מזהה המשתמש והסיסמה שיישלחו בתגובה לאתגרי אימות בסיסיים של 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

סוגי נתונים אלה משמשים עם פרמטרי פרופיל תצורה:

  • {a,b,c,…}—בחירה בין a, b, c, …

  • Bool – ערך בוליאני של "כן" או "לא".

  • CadScript—Miniscript המציין את פרמטרי הקצב של אות. עד 127 תווים.

    תחביר: S1[;S2], כאשר:

    • ס"מאני= d=dאני(ב-אני,1/כבויאני,1[, ב-i,2/כבויi,2[, ב-i,3/כבויi,3[, ב-i,4/כבויi,4[, ב-אני,5/כבויאני,5[, ב-I,6/כבויI,6[…]] […]] […]] […]

    • בi,j ומחוץ לi,j הם משך ההפעלה/הכיבוי בשניות של מקטע. i = 1 או 2, ו-j = 1 עד 6.

    • Di הוא משך הזמן הכולל של הקטע בשניות.

    כל המשכים יכולים לכלול עד שלושה מקומות עשרוניים כדי לספק רזולוציה של 1 אלפיות השנייה. תו הכרטיס הכללי "*" מייצג משך זמן אינסופי. המקטעים בתוך מקטע מופעלים לפי הסדר וחוזרים על עצמם עד להפעלת משך הזמן הכולל.

    דוגמה 1:

     60(2/4) מספר מקטעי תדירות = 1 מקטעי תדירות 1: אורך מקטע = 60 s מספר המקטעים = 1 מקטע 1: On=2s, Off=4s אורך צלצול כולל = 60s 

    דוגמה 2—צלצול ייחודי (short,short,short,long):

     60(.2/.2,.2/.2,.2/.2,1/4) מספר מקטעי תדירות = מקטע תדירות 1: אורך מקטע = 60 מספר המקטעים = 4 מקטע 1: מופעל=0.2s, כבוי=0.2s מקטע 2: מופעל=0.2s, כבוי=0.2s מקטע 3: מופעל=0.2s, כבוי=0.2s מקטע 4: On=1.0s, כבוי=4.0s אורך צלצול כולל = 60s 
  • DialPlanScript—תחביר סקריפט המשמש לציון תוכניות חיוג של קו 1 וקו 2.

  • Float<n> – ערך נקודה צפה עם עד n מקומות עשרוניים.

  • FQDN—שם דומיין מלא. הוא יכול להכיל עד 63 תווים. הדוגמאות הבאות הן:

    • sip.Cisco.com:5060 או 109.12.14.12:12345

    • sip.Cisco.com או 109.12.14.12

  • FreqScript - miniscript המציין את פרמטרי התדירות והרמה של צליל. מכיל עד 127 תווים.

    תחביר: ff1@l1[,f2@l2[,f3@l3[,f4@l4[,f5@l5[,f6@l6[…]] […]] […]

    • F1–F6 הם תדירות ב-Hz (מספרים שלמים לא חתומים בלבד).

    • L1–L6 הן רמות תואמות ב-dBm (עם עד מקום עשרוני אחד).

    רווחים לבנים לפני ואחרי הפסיק מותרים, אך לא מומלצים.

    דוגמה 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.

  • UserID—מזהה משתמש כפי שהוא מופיע בכתובת 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?".

  • יציאה—מספר יציאת TCP/UDP (0-65535). ניתן לציין אותו בתבנית עשרונית או הקסדצימאלית.

  • ProvisioningRuleSyntax - תחביר סקריפט המשמש להגדרת כללי סנכרון מחדש של תצורה ושדרוג קושחה.

  • PwrLevel - רמת הספק המבוטאת ב-dBm עם מקום עשרוני אחד, כגון -13.5 או 1.5 (dBm).

  • RscTmplt—תבנית של קוד מצב תגובת SIP, כגון "404, 5*", "61?", "407, 408, 487, 481". הוא יכול להכיל עד 39 תווים.

  • sig—ערך n-סיביות חתום. ניתן לציין אותו בתבנית עשרונית או הקסדצימאלית. סימן "-" חייב להופיע לפני ערכים שליליים. סימן + לפני ערכים חיוביים הוא אופציונלי.

  • קודי כוכב—קוד הפעלה עבור שירות משלים, כגון *69. הקוד יכול להכיל עד 7 תווים.

  • Str—מחרוזת גנרית עם עד n תווים שאינם משוריינים.

  • Time - משך זמן בשניות, עם עד n מקומות עשרוניים. המערכת מתעלמת ממקומות עשרוניים נוספים שצוינו.

  • ToneScript—Miniscript המציין את פרמטרי התדירות, הרמה והקצב של צליל התקדמות שיחה. סקריפט יכול להכיל עד 127 תווים.

    תחביר: FreqScript;Z1[;Z2].

    הקטע Z1 דומה לקטע S1 ב-CadScript, פרט לכך שכל מקטע הפעלה/כיבוי מלווה בפרמטר רכיבי תדר: ז'1 = d1(ב-אני,1/כבויאני,1/fאני,1[, ב-i,2/כבויi,2/fi,2 [, ב-i,3/כבויi,3/fi,3 [, ב-i,4/כבויi,4/fi,4 [, ב-אני,5/כבויאני,5/fאני,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 dBm תדירות 2 = 440 הרץ ב-19 dBm מספר מקטעים תדירות = 1 קטע תדירות 1: אורך מקטע = 10 ס' מספר המקטעים = 1 מקטע 1: On=לנצח, עם תדרים 1 ו-2 אורך צליל כולל = 10s 

    דוגמה 2—Stutter tone:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) מספר התדרים = 2 תדר 1 = 350 הרץ ב-19 dBm תדירות 2 = 440 הרץ ב-19 dBm מספר מקטעים תדירות = 2 קטע תדירות 1: אורך מקטע = 2s מספר המקטעים = 1 מקטע 1: On=0.1s, כבוי=0.1s עם מקטע תדירות 1 ו-2: אורך מקטע = 10 ס' מספר המקטעים = 1 מקטע 1: On=לנצח, עם תדרים 1 ו-2 אורך צליל כולל = 12 שניות 
  • uns—ערך n-סיביות לא חתום, כאשר n = 8, 16 או 32. ניתן לציין אותו בתבנית עשרונית או הקסדצימאלית, כגון 12 או ⁦0x⁩18, כל עוד הערך יכול להתאים ל-n סיביות.

שים לב לדברים הבאים:

  • מייצג שם פרמטר תצורה. בפרופיל, התג המתאים נוצר על-ידי החלפת המרחב בקו תחתון "_", כגון Par_Name.
  • שדה ערך ברירת מחדל ריק מרמז על מחרוזת ריקה < "" >.
  • הטלפון ממשיך להשתמש בערכים האחרונים שהוגדרו עבור תגים שאינם קיימים בפרופיל נתון.
  • התבניות מושוות בסדר הנתון. ההתאמה הראשונה, לא הקרובה ביותר, נבחרה. שם הפרמטר חייב להתאים במדויק.
  • אם ניתנת יותר מהגדרה אחת לפרמטר בפרופיל, ההגדרה האחרונה בקובץ היא זו שנכנסת לתוקף בטלפון.
  • מפרט פרמטר עם ערך פרמטר ריק מאלץ את הפרמטר בחזרה לערך ברירת המחדל שלו. כדי לציין מחרוזת ריקה במקום זאת, השתמש במחרוזת הריקה "" כערך הפרמטר.