- בית
- /
- מאמר
הגדר הגדרות פרופיל עבור טלפונים
מאמר עזרה זה מיועד לטלפונים של Cisco הרשומים ב-Cisco BroadWorks. המידע בדף זה כולל סנכרון מחדש של פרופיל, החלת פרופיל באופן ידני ותחביר תצורה.
קבע את תצורת הטלפון לסנכרון מחדש של פרופיל
הטלפון תומך בפרוטוקולי רשת מרובים לאחזור פרופילי תצורה. פרוטוקול העברת הפרופיל הבסיסי ביותר הוא TFTP (RFC1350). TFTP נמצא בשימוש נרחב להקצאת מכשירי רשת בתוך רשתות LAN פרטיות. למרות שלא מומלץ לפריסה של נקודות קצה מרוחקות ברחבי האינטרנט, TFTP יכול להיות נוח לפריסה בתוך ארגונים קטנים, להקצאה מראש בתוך הבית ולפיתוח ובדיקה. בהליך הבא, פרופיל משתנה לאחר הורדת קובץ משרת TFTP.
1 |
בסביבת LAN, חבר את המחשב והטלפון לרכזת, מתג או נתב קטן. |
2 |
במחשב, התקן והפעל שרת TFTP. |
3 |
השתמש בעורך טקסט כדי ליצור פרופיל תצורה. כדי לאמת אם הפרופיל הוקצה לטלפון שלך מאוחר יותר, באפשרותך להגדיר כמה מהערכים כסימנים. לדוגמה, הגדר את הערך עבור GPP_A ל-12345678 כמוצג בדוגמה הבאה:
_ |
4 |
שמור את קובץ התצורה של XML בספריית הבסיס של שרת TFTP. באפשרותך לוודא ששרת TFTP מוגדר כראוי: בקש את קובץ פרופיל התצורה באמצעות לקוח TFTP שאינו הטלפון. רצוי להשתמש בלקוח TFTP הפועל על מארח נפרד משרת ההקצאה. |
5 |
בדפדפן האינטרנט במחשב שלך, פתח את דף האינטרנט של ניהול המערכת. לדוגמה, נניח שכתובת ה-IP של הטלפון היא 192.168.1.100, פתח את כתובת ה-URL הבאה בדפדפן האינטרנט שלך:
|
6 |
בחר בלשונית ובדוק את הערכים של פרמטרי המטרה הכללית GPP_A עד GPP_P. אלה צריכים להיות ריקים. |
7 |
סנכרן מחדש את טלפון הבדיקה לפרופיל התצורה שיצרת על-ידי פתיחת כתובת ה-URL לסנכרון מחדש בדפדפן אינטרנט. דוגמה: אם כתובת ה-IP של שרת TFTP היא 192.168.1.200, הפקודה צריכה להיות דומה לדוגמה הבאה:
כאשר הטלפון מקבל פקודה זו, המכשיר בכתובת 192.168.1.100 מבקש את קובץ פרופיל התצורה |
8 |
ודא שהפרמטר עודכן כראוי. רענן את דף האינטרנט של הניהול ועבור אל .הפרמטר GPP_צריך להכיל כעת את הערך 12345678. |
1 |
השג את כתובת ה-MAC של הטלפון מתווית המוצר שלו. (כתובת ה-MAC היא המספר, באמצעות מספרים וספרות הקסדצימאליות באותיות קטנות, לדוגמה, 000e08aabbcc. |
2 |
שנה את שם קובץ התצורה ל- דוגמה: |
3 |
העבר את הקובץ החדש לספריית הבסיס הווירטואלי של שרת TFTP. |
4 |
קבל גישה לדף האינטרנט של ניהול הטלפון. |
5 |
בחר . |
6 |
הזן את הנתיב של קובץ הפרופיל בשדה כלל פרופיל . דוגמה: נניח שכתובת ה-IP של שרת TFTP היא 192.168.1.200 ושם קובץ הפרופיל הוא rofile_ |
7 |
לחץ על שלח את כל השינויים. הדבר גורם לאתחול מיידי ולסנכרון מחדש. כאשר מתרחש הסנכרון מחדש הבא, הטלפון מאחזר את הקובץ החדש על-ידי הרחבת ביטוי המאקרו $MA לכתובת ה-MAC שלו. |
1 |
התקן שרת HTTP במחשב המקומי או מארח נגיש אחר. ניתן להוריד את שרת Apache בקוד פתוח מהאינטרנט. |
2 |
העלה את קובץ פרופיל התצורה אל ספריית הבסיס הווירטואלי של השרת המותקן. |
3 |
כדי לאמת התקנת שרת תקינה וגישה לקובץ הפרופיל, פתח את הפרופיל באמצעות דפדפן אינטרנט. |
4 |
שנה את כלל Profile_של טלפון הבדיקה כדי להצביע על שרת ה-HTTP במקום שרת ה-TFTP, כדי להוריד את הפרופיל שלו מעת לעת. לדוגמה, בהנחה ששרת ה-HTTP הוא 192.168.1.300 ושם קובץ הפרופיל הוא 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 |
ודא ששדה סנכרון מחדש באיפוס מוגדר ככן. esync_ |
8 |
כבה את הטלפון כדי לאלץ אותו לבצע סנכרון מחדש לשרת ההקצאה. אם פעולת הסנכרון מחדש נכשלת מסיבה כלשהי, כגון אם השרת אינו מגיב, היחידה ממתינה (עבור מספר השניות שהוגדרו בהשהיית ניסיון חוזר של סנכרון מחדש) לפני שהיא מנסה לבצע סנכרון מחדש. אם השהיית ניסיון חוזר של שגיאה בסנכרון מחדש היא אפס, הטלפון אינו מנסה לבצע סנכרון מחדש לאחר ניסיון סנכרון כושל. |
9 |
(אופציונלי) הגדר את הערך של שדה השהיית ניסיון חוזר של שגיאה למספר קטן, כגון 30. esync_ |
10 |
השבת את שרת TFTP, ובחן את התוצאות בפלט syslog. |
הטבלה הבאה מגדירה את הפונקציה והשימוש של פרמטרי סנכרון מחדש של הפרופיל בקטע פרופיל תצורה תחת הלשונית בדף האינטרנט של הטלפון. הוא גם מגדיר את התחביר של המחרוזת שנוספה בקובץ התצורה של הטלפון (cfg.xml) עם קוד XML כדי להגדיר פרמטר.
פרמטר |
תיאור |
---|---|
הפעלת הקצאה |
מאפשר או דוחה פעולות סנכרון מחדש של פרופיל תצורה.
ברירת מחדל: כן |
סנכרון מחדש בעת איפוס |
מציין אם הטלפון מסנכרן מחדש תצורות עם שרת ההקצאה לאחר ההפעלה ולאחר כל ניסיון שדרוג.
ברירת מחדל: כן |
השהיה אקראית של סנכרון מחדש |
מונע עומס יתר של שרת ההקצאה כאשר מספר רב של מכשירים מופעלים בו-זמנית ומנסים להגדיר תצורה ראשונית. השהיה זו יעילה רק בניסיון התצורה הראשוני, לאחר הפעלה או איפוס של המכשיר. הפרמטר הוא מרווח הזמן המרבי שהמכשיר ממתין לפני יצירת קשר עם שרת ההקצאה. ההשהיה בפועל היא מספר פסידו-אקראי בין 0 לערך זה. פרמטר זה הוא ביחידות של 20 שניות. טווחי הערך החוקיים בין 0 ל-65535.
ערך ברירת המחדל הוא 2 (40 שניות). |
סנכרון מחדש ב- (HHmm) |
השעה (HHmm) שהטלפון מסתנכרן מחדש עם שרת ההקצאה. הערך עבור שדה זה חייב להיות מספר בן ארבע ספרות הנע בין 0000 ל-2400 כדי לציין את השעה בתבנית HHmm. לדוגמה, 0959 מציין 09:59.
ערך ברירת המחדל ריק. אם הערך אינו חוקי, המערכת מתעלמת מהפרמטר. אם פרמטר זה מוגדר עם ערך חוקי, המערכת מתעלמת מפרמטר סנכרון מחדש תקופתי. |
סנכרון מחדש בהשהיה אקראית |
מונע עומס יתר של שרת ההקצאה כאשר מספר רב של מכשירים מופעלים בו-זמנית. כדי למנוע הצפה של בקשות סנכרון מחדש לשרת מטלפונים מרובים, הטלפון מסתנכרן מחדש בטווח בין השעות לדקות, והשעות והדקות בתוספת ההשהיה האקראית (hhmm, hhmm+random_delay). לדוגמה, אם ההשהיה האקראית = (סנכרון מחדש בהשהיה אקראית + 30)/60 דקות, ערך הקלט בשניות מומר לדקות, ומעגל עד לדקה הבאה כדי לחשב את random_delay מרווח הזמן הסופי.
טווח הערך החוקי הוא בין 600 ל-65535. אם הערך קטן מ-600, ההשהיה האקראית הפנימית היא בין 0 ל-600. ערך ברירת המחדל הוא 600 שניות (10 דקות). |
סנכרון מחדש תקופתי |
מרווח הזמן בין סנכרון מחדש תקופתי עם שרת ההקצאה. טיימר הסנכרון מחדש המשויך פעיל רק לאחר הסנכרון המוצלח הראשון עם השרת. התבניות החוקיות הן כדלקמן:
הגדר פרמטר זה לאפס כדי להשבית סנכרון מחדש תקופתי. ערך ברירת המחדל הוא 3600 שניות. |
השהיית ניסיון חוזר לשגיאת סנכרון מחדש |
אם פעולת סנכרון מחדש נכשלת משום שהטלפון לא הצליח לאחזר פרופיל מהשרת, או שהקובץ שהורד פגום או אירעה שגיאה פנימית, הטלפון מנסה לבצע סנכרון מחדש שוב לאחר פרק זמן שצוין בשניות. התבניות החוקיות הן כדלקמן:
אם ההשהיה מוגדרת ל-0, המכשיר אינו מנסה לבצע סנכרון מחדש שוב לאחר ניסיון סנכרון כושל.
ברירת מחדל: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400 |
השהיית סנכרון מחדש מאולץ |
השהיה מקסימלית (בשניות) הטלפון ממתין לפני ביצוע סנכרון מחדש. המכשיר אינו מסתנכרן מחדש כאשר אחד מקווי הטלפון שלו פעיל. מכיוון שסנכרון מחדש יכול להימשך כמה שניות, רצוי להמתין עד שהמכשיר יהיה לא פעיל במשך תקופה ממושכת לפני הסנכרון מחדש. זה מאפשר למשתמש לבצע שיחות ברצף ללא הפרעה. למכשיר יש טיימר שמתחיל לספור לאחור כאשר כל הקווים שלו נהיים לא פעילים. פרמטר זה הוא הערך ההתחלתי של המונה. אירועי סנכרון מחדש מתעכבים עד שמונה זה יורד לאפס. טווחי הערך החוקיים בין 0 ל-65535.
ערך ברירת המחדל הוא 14,400 שניות. |
סנכרון מחדש מ-SIP |
שולט בבקשות לפעולות סנכרון מחדש באמצעות אירוע הודעת SIP שנשלח משרת ה-proxy של ספק השירות לטלפון. אם האפשרות מופעלת, ה-proxy יכול לבקש סנכרון מחדש על-ידי שליחת הודעת SIP NOTIFY המכילה את האירוע: סנכרן מחדש כותרת למכשיר.
ברירת מחדל: כן |
סנכרון מחדש לאחר ניסיון שדרוג |
מפעיל או משבית את פעולת הסנכרון מחדש לאחר שדרוג כלשהו מתרחש. אם האפשרות כן נבחרת, הסנכרון מופעל לאחר שדרוג קושחה.
ברירת מחדל: כן |
מפעיל סנכרון מחדש 1 גורם מפעיל סנכרון מחדש 2 |
אם המשוואה הלוגית בפרמטרים אלה מוערכת ל-FALSE, סנכרון מחדש אינו מופעל גם כאשר Resync On Reset מוגדר לTRUE. רק הסנכרון מחדש באמצעות כתובת URL של פעולה ישירה והודעת SIP מתעלם מפעילי סנכרון מחדש אלה. ניתן לתכנת את הפרמטרים עם ביטוי מותנה שעובר הרחבת מאקרו. עבור הרחבות המאקרו החוקיות, ראה משתני הרחבת מאקרו תחת פרמטרי הקצאה.
ברירת מחדל: ריק |
סנכרון מחדש הניתנים להגדרה על ידי המשתמש |
מאפשר למשתמש לסנכרן מחדש את הטלפון מתפריט מסך הטלפון. כאשר מוגדר ככן, משתמש יכול לסנכרן מחדש את תצורת הטלפון על-ידי הזנת כלל הפרופיל מהטלפון. כאשר מוגדר כלא, הפרמטר כלל פרופיל אינו מוצג בתפריט מסך הטלפון.
ברירת מחדל: כן |
כשל סנכרון מחדש ב-FNF |
סנכרון מחדש נחשב בדרך כלל לא מוצלח אם פרופיל מבוקש לא מתקבל מהשרת. פרמטר זה עוקף את ההתנהגות הזו. כאשר מוגדר כלא, המכשיר מקבל תגובת
ברירת מחדל: כן |
סוג אימות פרופיל |
מציין את האישורים שיש להשתמש בהם לאימות חשבון פרופיל. האפשרויות הזמינות הן:
ברירת מחדל: אימות HTTP בסיסי למידע נוסף, ראה ציין את סוג אימות הפרופיל תחת ציין את הטלפון לסנכרון מחדש של פרופיל. |
כלל פרופיל כלל פרופיל B כלל פרופיל C כלל פרופיל D |
כל כלל פרופיל מיידע את הטלפון של מקור שממנו ניתן להשיג פרופיל (קובץ תצורה). במהלך כל פעולת סנכרון מחדש, הטלפון מחיל את כל הפרופילים ברצף. אם אתה מחיל הצפנת AES-256-CBC על קובצי התצורה, ציין את מפתח ההצפנה עם מילת המפתח באפשרותך להקיף את מפתח ההצפנה במרכאות כפולות (") באופן אופציונלי.
ברירת מחדל: |
אפשרות 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) על-ידי הזנת מחרוזת בתבנית הבאה: rofile_ אפשרויות
ברירת מחדל: אימות HTTP בסיסי |
4 |
לחץ על שלח את כל השינויים. |
החל ידנית פרופיל על הטלפון שלך
השלם את השלבים הבאים כדי להוריד את קובץ התצורה ליישום שרת TFTP במחשב שלך.
1 |
חבר את המחשב ליציאת ה-LAN של הטלפון. |
2 |
הפעל יישום שרת TFTP במחשב וודא שקובץ התצורה זמין בספריית הבסיס של TFTP. |
3 |
בדפדפן אינטרנט, הזן את כתובת ה-IP של הטלפון LAN, את כתובת ה-IP של המחשב, את שם הקובץ ואת אישורי הכניסה. השתמש בתבנית זו: דוגמה:
|
השלם את השלבים הבאים כדי להוריד את התצורה לטלפון באמצעות cURL. כלי שורת פקודה זה משמש להעברת נתונים עם תחביר של כתובת URL. כדי להוריד cURL, בקר בכתובת:
https://curl.haxx.se/download.html
מומלץ לא להשתמש ב-cURL כדי לפרסם את התצורה לטלפון מכיוון ששם המשתמש והסיסמה עשויים להילכד בעת שימוש ב-cURL.
1 |
חבר את המחשב ליציאת ה-LAN של הטלפון. |
2 |
הורד את קובץ התצורה לטלפון על-ידי הזנת פקודת cURL הבאה: |
פרופילי תצורה
הטלפון מקבל תצורות בתבנית XML.
הדוגמאות בקטע זה משתמשות בפרופילי תצורה עם תחביר XML.
פרופיל התצורה מגדיר את ערכי הפרמטר עבור הטלפון.
תבנית ה-XML של פרופיל התצורה משתמשת בכלי כתיבה סטנדרטיים של XML כדי להדר את הפרמטרים והערכים.
לכל טלפון יש ערכת תכונות שונה ולכן, ערכה שונה של פרמטרים.
פתח תבנית פרופיל
פרופיל התבנית הפתוחה הוא קובץ טקסט עם תחביר דמוי 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.
-
-
כל תג אלמנט פותח חייב לכלול תג אלמנט סגירה תואם. לדוגמה:
rofile_<Resync_איפוסn_> כן איפוסn_> <Resync_תקופתי> 7200 תקופתי> <Profile_Rule>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg כלל>
-
תגי הרכיב הם תלויי רישיות.
-
תגי אלמנט ריקים מותרים ויפורשו כהגדרת הערך להיות ריק. הזן את תג אלמנט הפתיחה ללא תג אלמנט תואם, והוסף רווח וקו החזית לפני מסגרת הזווית הסגירה (>). בדוגמה זו, כלל פרופיל 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_> (
) שווה ל-(S0 ).
ial_<פרופיל שטוח> <Dial_Plan_1_> (S0 ) Plan_1_> </פרופיל שטוח>
תו מספרי בורח, תוך שימוש בערכים עשרוניים והקסדצימליים (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 או 0x18, כל עוד הערך יכול להתאים ל-n סיביות.
שים לב לדברים הבאים:
- מייצג שם פרמטר תצורה. בפרופיל, התג המתאים נוצר על-ידי החלפת המרחב בקו תחתון "_", כגון Par_Name.
- שדה ערך ברירת מחדל ריק מרמז על מחרוזת ריקה < "" >.
- הטלפון ממשיך להשתמש בערכים האחרונים שהוגדרו עבור תגים שאינם קיימים בפרופיל נתון.
- התבניות מושוות בסדר הנתון. ההתאמה הראשונה, לא הקרובה ביותר, נבחרה. שם הפרמטר חייב להתאים במדויק.
- אם ניתנת יותר מהגדרה אחת לפרמטר בפרופיל, ההגדרה האחרונה בקובץ היא זו שנכנסת לתוקף בטלפון.
- מפרט פרמטר עם ערך פרמטר ריק מאלץ את הפרמטר בחזרה לערך ברירת המחדל שלו. כדי לציין מחרוזת ריקה במקום זאת, השתמש במחרוזת הריקה "" כערך הפרמטר.