עדכן את סיסקו BroadWorks NPS לשימוש בפרוקסי NPS: מדריך תצורה

סקירה כללית של פרוקסי אימות NPS

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

סקירה כללית של פרוקסי NPS

לצורך תאימות עם Webex עבור BroadWorks, יש לתקן את ה- NPS שלך כדי לתמוך בתכונת פרוקסי NPS, שרת Push עבור VoIP ב- UCaa S.

התכונה מיישמת עיצוב חדש ב- Notification Push Server כדי לפתור את פגיעות האבטחה של שיתוף מפתחות פרטיים של אישור הודעות דחיפה עם ספקי שירותים עבור לקוחות ניידים. במקום לשתף אישורי הודעות דחי פה ומפתחות עם ספק השירות, ה- NPS משתמש בממשק API חדש כדי להשיג אסימון הודעת דחיפה קצר מועד מהקצה האחורי של UCaaS, ומשתמש באסימון זה ל אימות עם שירותי APNs של Apple ו- Google FCM.

התכונה גם משפרת את היכולת של שרת דחיפת ההודעות לדחוף התראות למכשירי אנדרואיד באמצעות ממשק ה- API החדש של Google Firebase Cloud Messaging (FCM) HTTPv1.

לקבלת מידע נוסף, עיין בש רת דחיפה עבור VoIP בתיאור התכונות של UCaaS.
תיקוני BroadWorks עבור התכונה זמינים בכתובת: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
מידע נוסף על שרת ה- ADP ניתן למצוא בפלטפורמת מסירת היישומים של Cisco BroadWorks.

דרישות מוקדמות פרוקסי אימות NPS

ה- XSP (או ADP של פלטפורמת מסירת יישומים) המארחת את NPS חייב לעמוד בדרישות הבאות:

גרסאות מינימליות והגבלות תושבות משותפת

NPS חייב להיות מופעל ב- XSP/ADP ייעודי ו- NPS חייב להיות היישום המתארח היחיד בשרת. זאת כדי למנוע הפרעה למסירת הודעות דחיפה.
צריכה להיות רק אפליקציית NPS אחת בפריסה. אם אתה משתמש ב- UC-One Collaborate/Connect ו/או ב- UC-One SaaS, ומיישם את Webex עבור BroadWorks, עליך לשתף את ה- NPS יחיד זה עבור כל היישומים.
NPS חייב להיות בגירסה R22 או מאוחר יותר XSP, או ADP.

R22/R23 XSP תואם לערימת R21 אם ה- XSP מפעיל רק NPS וה- AS הוא R21.SP1. לקבלת מידע נוסף, עיין במטריצת התאימות של BroadWorks.
מידע נוסף על שרת ה- ADP ניתן למצוא בפלטפורמת מסירת היישומים של Cisco BroadWorks.

NPS משותף

קרא את ההערות הבאות לפני שתקבע את התצורה של ה- NPS המשותף שלך לשימוש ב- NPS Proxy:

אם נעשה שימוש ב- NPS שלך עם אפליקציות אחרות (לא רק עם אפליקציית Webex): ראשית הגדר את ה- proxy של NPS, ולאחר מכן שנה את ה- NPS משימוש בממשק ה- API מדור קודם של FCM לשימוש ב- API HTTP v1 של FCM.
לאחר שתאמת שההודעות פועלות כראוי עבור אפליקציות ישנות יותר עם ה- proxy של NPS, הסר את מפתח ה- API של FCM עבור אפליקציית Android ואת מפתח האישור של APNs עבור אפליקציית iOS.

APNs HTTP/2

אם פרסת אפליקציות iOS שאינן מ- Cisco/Broadsoft, הגדר את היישומים הללו כך שישתמשו בפרוטוקול HTTP/2 APNS לפני הגדרת תצורת ה- NPS לשימוש ב- proxy NPS.
יש להעביר XSP/ADPs שכבר תומכים באפליקציית Collaborate או SaaS BroadWorks ל- HTTP/2. לקבלת מידע מפורט על קביעת תצורה של HTTP/2, ראה תמיכה ב- HTTP/2 לשרת דחיפה של הודעות עבור APNS (העברה של NPS לתמיכה ביישומי iOS אלה מסוכמת במאמר זה ).

אנדרואיד FCMv1

אם פרסת אפליקציות Android שאינן מ- Cisco/Broadsoft, הגדר את האפליקציות הללו כך שישתמשו במק שי FCMv1 לפני שתקבע את תצורת ה- NPS לשימוש ב- proxy NPS.
אם XSP/ADP תומך כעת ביישום Connect או UC-One SaaS, הפעל מפתחות FCMv1 לאחר הגדרת תצורת ה- proxy של NPS. אנו ממליצים להעביר את כל היישומים הנוספים למפתחות FCMv1, להפעיל ולבדוק ולאחר מכן להשבית עד שתהיה מוכן להשלים את הוראות ההתקנה (זרימת ההעברה מתועדת במאמר זה).

סיכום העברת פרוקסי NPS

***סיכום חזותי של העברה ל- Proxy אימות NPS***

טבלה 1. סיכום המשימות להעברה ל- NPS Proxy
רצף	כותרת המשימה	מתי ומדוע נדרשת משימה?
1	העבר את NPS ל- HTTP/2 עבור יישומי iOS של UC-One SaaS (או חיבור).	אם ה- NPS תומך ביישומים אלה, והם עדיין לא מוגדרים עבור HTTP/2.
2	העבר את NPS ל- FCMv1 עבור אפליקציות אנדרואיד SaaS (או Connect) של UC-One.	אם ה- NPS תומך ביישומים אלה, והם עדיין לא מוגדרים עבור FCMv1.
3	הפעל מצב FCMv1 ובדוק התראות דחיפה.	אם ה- NPS תומך ב- UC-One Connect ו/או באפליקציות אנדרואיד אחרות (שאינן של סיסקו).
4	הפעל מחדש את מצב FCM מדור קודם.	אם ה- NPS תומך ב- SaaS של UC-One. אם תשאיר את FCMv1 מופעל, לפני שתקבע את תצורת ה- proxy של NPS, התראות דחיפה ל- UC-One SaaS מתחילות להיכשל.
5	התקן תיקוני פרוקסי אימות NPS.	אם NPS נמצא ב- XSP R22 או XSP R23.
6	הגדר את התצורה של NPS לשימוש בפרוקסי אימות NPS: צרף תמיכה טכנית מ- NPS בקש חשבון CI OAuth צור חשבון CI ב- NPS והגדר פסק זמן של אסימון רענון הוסף מזהי אפליקציות אנדרואיד הוסף מזהי אפליקציות iOS בדקה/הגדר כתובות אתרים וזמן קצוב לחיבור הוסף אפליקציות לרשימת ההרשאות AS (מחדש) הפעל את FCMv1 הפעל מחדש את XSP/ADP בדוק PnS עבור אפליקציות iOS ואנדרואיד	תמיד נדרש.
7	הסר מקשי מצב מדור קודם של FCM.	עבור אפליקציות הנתמכות בהצלחה על ידי NPS ב- FCMv1.

העבר אפליקציות iOS של BroadWorks Collaborate ל- HTTP/2

משימה זו היא חובה עבור הודעות דחיפה ליישומי SaaS ו- Webex של UC-One בפלטפורמות iOS.

לפני שתתחיל

אם ב- XSP שלך פועל R22, עליך להחיל את ap354313 לפני שתוכל להגדיר את יישום ה- NPS לשימוש ב- HTTP/2 עבור APNS.

1	הגדר את כתובת האתר של הייצור ופרמטרי החיבור ב- `X` SP_CLI/יישומים/NotificationPushServer/APNS/ייצור> `הגדר כתובת אתר https://api.push.apple.com/3/device` `סט חיבורסגודל 2` `הגדר חיבור פסק זמן 3000` `הגדר זמן חיבורשזמן פסק זמן בשניות 600` הערה: אל תגדיר את פסק הזמן לחיבור מתחת ל 1000.
2	הוסף את מזהי היישום להקשר יישומי APNS, הקפד להשמיט את מפתח ה- Auth - הגדר אותו לריק. עבור SaaS של UC-One: `X` SP_CLI/יישומים/השרת-הודעות/APNS/הפקה/אסימנים> הוסף com.broadsoft.uc-one עבור אפליקציית Webex: `XSP` _CLI/יישומים/הודעותPushשר/APNS/הפקה/אסימונים> הוסף com.cisco.squared
3	`בדוק את מקשי האישור באמצעות XSP_CLI/יישומים/NotificationPushServer/APNS/הפקה/אסימונים> קבל`
4	`אם מפתח האישור אינו ריק עבור com.broadsoft.uc-one, אתה יכול לנקות אותו באמצעות xsp_CLI/יישומים/NotificationPushServer/APNS/הפקה/אסימנים> נקה את מפתח המסמך`
5	הפעל HTTP/2: `xsp_CLI` `/יישומים/הודעותשרת Push/APNS/הגדרות כללית> הגדר את HTTP2Enabled true`
6	עבור יישומי SaaS של UC-One בלבד: היכנס לפורטל המשווקים ועבור אל תצורה > BroadWorks >.
7	גלול מטה לקטע 'שרת דחיפוש' של הודעות, ובחר את המהדורה שלך (לדוגמה, גרסה 22), ולאחר מכן פעל לפי ההוראות המופיעות בפורטל.

העבר אפליקציות אנדרואיד של ברודוורקס UC-One Connect/SaaS ל- FCMv1

משימה זו חלה על NPS ב- XSP. התעלם מכך אם ה- NPS שלך נמצא ב- ADP.
באפשרותך להשתמש בהליך זה להעברה להתראות FCMv1 עבור אפליקציות UC-One Connect או UC-One SaaS לאנדרואיד.
עליך להשתמש ב- FCMv1 אם ברצונך להשתמש בפרוקסי NPS כדי לאמת הודעות דחיפה ליישומי UC-One או Webex Android.
משימה זו מכינה את ה- NPS עבור FCMv1 כך שתוכל להפעיל אותו כחלק מהתצורה של פרוקסי אימות NPS. אל תאפשר את FCMv1 עד שתהיה מוכן להגדיר פרוקסי אימות NPS, אחרת ההודעות ללקוחות SaaS ייכשלו.

קבל את מזהה הפרויקט ממסוף Firebase:

היכנס לאתר console.firebase.google.com.
בחר בפרויקט האפליקציה UC-One (Connect או SaaS), פתח את הגדרות הפרויקט שלו.
פתח את הכרטיסייה כללי ורשום את מזהה הפרויקט.

קבל את המפתח הפרטי של חשבון השירות שלך מ- Firebase:

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

הערה: חשבון השירות חייב להיות בעל הרשאת firebasead min-sdk.
הורד את המפתח למיקום מאובטח.

העתק את המפתח ל- XSP המארח את ה- NPS שלך.

הוסף את מזהה הפרויקט ואת המפתח הפרטי המשויך להקשר פרויקטים של FCM:

xsp_CLI /יישומים/הודעותPushserver/FCM/פרויקטים > הוסף נתיב מזהה פרוייקט/לקובץ מפתח

הוסף את היישום UC-One (Connect או SaaS) ואת מזהה הפרויקט המשויך להקשר של יישומי FCM:

xsp_CLI/יישומים/הודעותPushשר/FCM/יישומים> הוסף מזהה יישום com.broadsoft.connect ID פרוייקט ID פרוייקט

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

הפעל את XSP _CLI/יישומים/הודעותPushשר/FCM> קבל

פרמטר	ערך מומלץ
`כתובת אתר מאומת/כתובת אתר`	`https://www.googleapis.com/oauth2/v4/token`
`פושארל`	`https://fcm.googleapis.com/v1/projects/ מזהה פרו ייקט /הודעות: שלח`
`היקף`	`https://www.googleapis.com/auth/firebase.messaging`
`אסימוןזמן הזהב בשניות`	3600
`חיבורגודל הבריכה`	10
`זמן קצוב בחיבורבמילישניות`	3000
`זמן פסק זמן חיבורבשניות`	600

העבר אפליקציות אנדרואיד של BroadWorks UC-One Connect/SaaS ל- FCMv1 (ב- ADP)

משימה זו חלה על NPS ב- ADP. התעלם מכך אם ה- NPS שלך נמצא ב- XSP.
באפשרותך להשתמש בהליך זה להעברה להתראות FCMv1 עבור אפליקציות UC-One Connect או UC-One SaaS לאנדרואיד.
עליך להשתמש ב- FCMv1 אם ברצונך להשתמש בפרוקסי NPS כדי לאמת הודעות דחיפה ליישומי UC-One או Webex Android.
משימה זו מכינה את ה- NPS עבור FCMv1 כך שתוכל להפעיל אותו כחלק מהתצורה של פרוקסי אימות NPS. אל תאפשר את FCMv1 עד שתהיה מוכן להגדיר פרוקסי אימות NPS, אחרת ההודעות ללקוחות SaaS ייכשלו.

1	קבל את מזהה הפרויקט ממסוף Firebase: היכנס לאתר console.firebase.google.com. בחר בפרויקט האפליקציה UC-One (Connect או SaaS), פתח את הגדרות הפרויקט שלו. פתח את הכרטיסייה כללי ורשום את מזהה הפרויקט.
2	קבל את המפתח הפרטי של חשבון השירות שלך מ- Firebase: נווט לכרטיסייה חשבונות שירות בהגדרות הפרויקט. או צור חשבון שירות חדש וקבל את המפתח הפרטי שלו. או לפתוח חשבון שירות קיים וליצור עבורו מפתח פרטי חדש. הערה: חשבון השירות חייב להיות בעל הרשאת firebasead min-sdk. הורד את המפתח (קובץ JSON) למיקום מאובטח.
3	`ייבא את קובץ.json לשרת ADP /bw/install.`
4	התחבר ל- ADP CLI והוסף את הפרויקט ואת מפתח ה- API להקשר פרויקטים של FCM: `adp_cli/יישומים/התראות Pushserver/FCM/פרוייקטים> הוסף חיבור ucaas /bw/install/שם קובץ.json`
5	הוסף את מזהה היישום והפרויקט להקשר יישומי FCM: `adp_cli/יישומים/הודעותPushשר/FCM/יישומים> הוסף מזהה יישום com.broadsoft.ucaas.connect מזהה פרויקט ID פרוייקט`
6	בדוק את התצורה שלך: `ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== connect-ucaas ********` `ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas`

הפעל מחדש את מצב מדור קודם של FCM

אתה צריך לעשות זאת רק (כחלק מההעברה) אם:

ה- NPS שלך משמש עבור אפליקציות אנדרואיד של UC-One SaaS או BroadWorks Connect.
כבר בדקת שהודעות דחיפה לשיחות לאפליקציות אחרות עובדות עם ממשק API FCMv1.

אתה משבית באופן זמני את FCMv1 מכיוון שיש להפעיל מפתחות FCMv1 עבור יישומים אלה רק במהלך תהליך תצ ורת ה- proxy לאימות NPS.

1	היכנס ל- XSP המארח את ה- NPS המשותף שלך.
2	נווט להקשר של FCM והשבית את FCM v1: `XSP_CLI/יישומים/NotificationPushServer/fcm> הגדר את V1Enabled false כדי לחזור לשימוש במפתח ה- API מדור קודם של` FCM.

התקן תיקוני פרוקסי אימות NPS

התקן את התיקונים הבאים כדי לתמוך בתכונת ה- proxy לאימות NPS:

תיקוני R22

תיקוני R23

קביעת תצורה של NPS לשימוש בפרוקסי אימות

צור בקשת שירות עם איש הקשר שלך להתקבל, או עם TAC, כדי לספק את חשבון לקוח OAuth שלך (Webex Common Identity). כותרת בקשת השירות שלך תצורת NPS להגדרת פרוקסי אימות.

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

צור את חשבון הלקוח ב- NPS:

XSP_CLI /יישומים/הודעותPushשר/Ciscoci/לקוח> הגדר מזהה לקוח מלקוח משלב 1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

הפעל את הפקודה כדי לוודא שהערכים שהזנת תואמים את אלה שסופקו לך. xsp_CLI/יישומים/הודעותשרת Push/Ciscoci/לקוח> קבל

הזן את כתובת ה- NPS Proxy והגדר את מרווח רענון האסימון (מומלץ 30 דקות):

FQDNS מבוססי אזור:

מזרח ארה"ב:

xsp_CLI /יישומים/הודעותשרת Push/שירות CloudNPS> הגדר כתובת אתר https://broadworks-idp-proxy-a.wbx2.com/nps/

מערב ארה"ב:

xsp_CLI /יישומים/הודעותשרת Push/שירות CloudNPS> הגדר כתובת אתר https://broadworks-idp-proxy-r.wbx2.com/nps/

אירופה:

xsp_CLI /יישומים/הודעותשרת Push/שירות CloudNPS> הגדר כתובת אתר https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI /יישומים/הודעותשרת Push/שירות DNPS ענן> הגדר את VoipTokenRefreshInterval 1800

ערב הסעודית:

xsp_CLI /יישומים/הודעותשרת Push/שירות CloudNPS> הגדר כתובת אתר https://broadworks-idp-proxy-d.wbx2.com/nps/

אוסטרליה:

xsp_CLI /יישומים/הודעותשרת Push/שירות CloudNPS> הגדר כתובת אתר https://broadworks-idp-proxy-m.wbx2.com/nps/

אם פסק זמן של הודעות דחיפה עקב עיכוב ברזולוציית DNS, הגדל את ערך הפסק זמן בקובץ "/etc/resolv.conf" בשרת BroadWorks.

(עבור התראות Android) הוסף את מזהי היישומים של Android להקשר יישומי FCM ב- NPS.

עבור אפליקציית Webex באנדרואיד: XSP _CLI/יישומים/הודעותPushשר/FCM/יישומים> הוסף com.cisco.wx2.android

עבור אפליקציית UC-One באנדרואיד: X SP_CLI/יישומים/הודעות Pushserver/FCM/יישומים> הוסף com.broadsoft.connect

(להוד Apple iOS עות) הוסף את מזהה היישום להקשר יישומי APNS, הקפד להשמיט את מפתח ה- Auth - הגדר אותו לריק.

עבור אפליקציית Webex ב- iOS: xsp _CLI/יישומים/הודעות Pushserver/APNS/הפקה/אסימונים> הוסף com.cisco.squared

עבור אפליקציית UC-One ב- iOS: x sp_CLI/יישומים/הודעות Pushserver/APNS/ייצור/אסימנים> הוסף com.cisco.squared

הגדר את כתובות ה- NPS הבאות:

הקשר של XSP CLI	פרמטר	ערך
`xsp_CLI/יישומים/התראות שרת/FCM>`	`כתובת אתר מאומת/כתובת אתר`	`https://www.googleapis.com/oauth2/v4/token`
	`פושארל`	`https://fcm.googleapis.com/v1/projects//messages:send`
	`היקף`	`https://www.googleapis.com/auth/firebase.messaging`
`xsp_CLI/יישומים/הודעותשרת Push/APNS/הפקה>`	`כתובת אתר`	`https://api.push.apple.com/3/device`

הגדר את פרמטרי חיבור ה- NPS הבאים לערכים המומלצים המוצגים:

הקשר של XSP CLI	פרמטר	ערך
`xsp_CLI/יישומים/התראות שרת/FCM>`	`אסימוןזמן הזהב בשניות`	3600
	`חיבורגודל הבריכה`	10
	`זמן קצוב בחיבורבמילישניות`	3000
	`זמן פסק זמן חיבורבשניות`	600
`xsp_CLI/יישומים/הודעותשרת Push/APNS/הפקה>`	`פסק זמן לחיבור`	3000
	`חיבורגודל הבריכה`	2
	`זמן פסק זמן חיבורבשניות`	600

בדוק אם שרת היישומים בודק מזהי יישומים, מכיוון שייתכן שתצטרך להוסיף את יישומי Webex לרשימת ההרשאות:

הפעל כ _CLI/מערכת/PushNotification> קבל ובדוק את הערך של EnforceAllowedApplicationList. אם זה נכון, עליך להשלים את משימת המשנה הזו. אחרת, דלג על שאר משימת המשנה.
as_CLI/מערכת/הודעות דחיפוש/יישומים מורשים> הוסף com.cisco.wx2.android "Webex אנדרואיד"
כ_CLI/מערכת/הודעות דחיפוש/יישומים מורשים> הוסף com.cisco.squared "Webex iOS"

הפעל מחדש את NPS ובדוק הודעות דחיפה

1	הפעל מחדש את ה- XSP: `רסטארט מחדש`
2	בדוק התראות שיחות ל- Android על ידי ביצוע שיחות ממנוי BroadWorks ללקוח המתקשר ב- Android. ודא שהודעת שיחה מופיעה במכשיר Android. הערה: אם הודעות דחיפה מתחילות להיכשל ביישום האנדרואיד UC-One, ייתכן שיש תצורה שגויה. אם זה המצב שלך, תוכל לחזור ל- FCM מדור קודם באופן הבא: `השבת FCMv1: XSP _CLI/יישומים/הודעותPushשר/FCM> הגדר את V1Enabled שקר` `הפעל מחדש את XSP: bwrestart` בדוק את התצורה שלך. הפעל מחדש את FCMv1 והפעל מחדש את ה- XSP. חזור על הבדיקה.
3	בדוק התראות שיחות ל- iOS על ידי ביצוע שיחות ממנוי BroadWorks ללקוח המתקשר ב- iOS. ודא שהודעת שיחה מופיעה במכשיר iOS. הערה: אם הודעות דחיפה מתחילות להיכשל ביישום ה- iOS של UC-One, ייתכן שיש תצורה שגויה. אם זה המצב שלך, אתה יכול לחזור לממשק הבינארי מדור קודם עם `הגדרת Http2Enabled false`

Cisco AI Assistant

תודה על המשוב.