הגדרת התראות דחיפה של שיחות עבור Webex BroadWorks

במסמך זה אנו משתמשים במונח Call Notifications Push Server (CNPS) כדי לתאר יישום המתארח XSP, או יישום המתארח על-ידי ADP הפועל בסביבה שלך. ה-CNPS שלך עובד עם מערכת BroadWorks שלך כדי להיות מודע לשיחות נכנסות למשתמשים שלך, ודוחף התראות של אלה לשירותי ההודעות בענן של Google Firebase (FCM) או לשירות התראות הדחיפה של Apple (APNs).

שירותים אלה מודיעים למכשירים הניידים של Webex עבור מנויי Cisco BroadWorks שיש להם שיחות נכנסות ב- Webex.

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

מנגנון דומה ב- Webex עובד עם שירותי העברת הודעות ונוכחות של Webex כדי לדחוף הודעות לשירותי ההודעות של גוגל (FCM) או אפל (APNS). שירותים אלה בתורם מודיעים למשתמשי Webex הניידים על הודעות נכנסות או על שינויים בנוכחות.

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

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

לצורך תאימות עם Webex עבור Cisco BroadWorks, יש לתקן את ה-CNPS שלך כדי לתמוך בתכונה 'פרוקסי של NPS', Push Server for VoIP ב-UCaaS.

התכונה מיישמת עיצוב חדש ב-Notification Push Server כדי לפתור את פגיעות האבטחה של שיתוף מפתחות פרטיים של אישורי הודעת דחיפה עם ספקי שירות עבור לקוחות ניידים. במקום לשתף אישורי הודעות דחיפה ומפתחות עם ספק השירות, ה-NPS משתמש ב-API חדש כדי להשיג אסימון התראת דחיפה קצר מועד מ-Webex עבור הקצה האחורי של Cisco BroadWorks, ומשתמש באסימון זה לאימות עם 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.

עבור תוכנות ותיקונים של NPS, עיין בסעיף הכן את ה-NPS שלך עבור Webex עבור Cisco BroadWorks.

חפש והורד את התיקון מדף הורדת התוכנה.
מידע נוסף על שרת ADP ניתן למצוא בכתובת Cisco BroadWorks Application Delivery Platform.

שיקולי APNS

Apple לא תתמוך עוד בפרוטוקול הבינארי מבוסס HTTP/1 בשירות התראות הדחיפה של Apple לאחר 31 במרץ 2021. אנו ממליצים שתגדיר את XSP|ADP שלך לשימוש ב- HTTP/2-based ממשק עבור APNs. עדכון זה דורש ש-XSP|ADP המארח את ה-NPS יפעל בגרסה R22 או בגרסה מתקדמת יותר.

הכן את ה- NPS שלך עבור Webex עבור Cisco BroadWorks

1	התקן וקבע תצורה של XSP ייעודי (גרסה מינימלית R22), או פלטפורמת אספקת יישומים (ADP).
2	התקן את תיקוני ה- Proxy של אימות NPS: תיקוני XSP R22: AP.xsp.22.0.1123.ap369607 AP.platform.22.0.1123.ap369607 AP.xsp.22.0.1123.ap374677 AP.xsp.22.0.1123.ap375206 AP.xsp.22.0.1123.ap354313 AP.platform.22.0.1123.ap354313 תיקוני XSP R23: AP.xsp.23.0.1075.ap369607 AP.platform.23.0.1075.ap369607 AP.xsp.23.0.1075.ap374677 AP.xsp.23.0.1075.ap375206
3	הפעל את היישום 'שרת דחיפת ההודעות'.
4	(להודעות אנדרואיד) הפעל את ה- API של FCM v1 ב- NPS. `XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true`
5	(להתראות Apple iOS) הפעל HTTP/2 ב- NPS. `XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true` זה בלעדי לגרסה 22 וגירסאות קודמות; זה לא זמין בגרסה 23 ומעלה, שתומכות רק ב- HTTP/2.
6	צרף תמיכה טכנית מה-NPS XSP/ADP.
7	בכל שרת AS, קובץ namedefs ב- `/usr/local/broadworks/bw_base/conf` חייב להיות מוגדר עם רשומות SRV ו-A עבור שרת דחיפת ההודעות. (XSP/ADP) חיפוש, אם מרובים XSP/ADP לאחר מכן הוסף ערך עבור כל אחד לפי הצורך. דוגמה: _pushnotification-לקוח._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149 לאחר ההגדרה, נדרש אחד מהבאים כדי לאמץ את השינויים: יש לבצע הפעלה מחדש בחלון תחזוקה. דרך ממשק שורת הפקודה (CLI) של סיסקו BroadWorks: R24 ומעלה AS_CLI/ASDiagnostic/DNS> טען מחדש R25 + AS_CLI/ASDiagnostic/DNS/ExecutionServer> טען מחדש AS_CLI/ASDiagnostic/DNS/ProvisioningServer> טען מחדש

מה הלאה?

עבור התקנות חדשות של NPS, עבור אל הגדרת NPS לשימוש בפרוקסי אימות

כדי להעביר פריסת אנדרואיד קיימת ל-FCMv1, עבור אל העברת NPS ל-FCMv1

הגדרת NPS לשימוש בפרוקסי אימות

משימה זו חלה על התקנה חדשה של NPS, המוקדשת ל- Webex עבור Cisco BroadWorks.

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

קבלת אישורי OAuth עבור Webex עבור Cisco BroadWorks שלך.

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

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientId client-Id-From-Step1

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

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

כדי לוודא שהערכים שהזנת תואמים למה שניתן לך, הפעל XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

כתובת האתר של issuerCiscoCI צריכה תמיד להיות US CI cluster ללא קשר למיקומך וברירת המחדל צריכה להיות:

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI> get issuerUrl = https://idbroker.webex.com/idb

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

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://nps.uc-one.broadsoft.com/nps/

כדי לשפר את מהירות פתרון ה-DNS, במקום ה-FQDN הנוכחי nps.uc-one.broadsoft.com אנו ממליצים להשתמש ב-FQDN המתאים לאזור שלך.

כתובות FQDN מבוססות אזור:

מזרח ארה"ב:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-a.wbx2.com/nps/

מערב ארה"ב:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-r.wbx2.com/nps/

אירופה:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

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

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

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.cisco.wx2.android

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

XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

קביעת התצורה של כתובות ה-URL הבאות של NPS:

הקשר של ממשק שורת פקודה (ADP) של XSP\|	פרמטר	ערך
`XSP\|ADP_CLI/Applications/NotificationPushServer/FCM>`	`authURL`	`https://www.googleapis.com/oauth2/v4/token`
	`pushURL`	`https://fcm.googleapis.com/v1/projects/PROJECT-ID/messages:send`
	`scope`	`https://www.googleapis.com/auth/firebase.messaging`
`XSP\|ADP_CLI/Applications/NotificationPushServer/APNS/Production>`	`url`	`https://api.push.apple.com/3/device`

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

הקשר של ממשק שורת פקודה (ADP) של XSP\|	פרמטר	ערך
`XSP\|ADP_CLI/Applications/` `NotificationPushServer/FCM>`	`tokenTimeToLiveInSeconds`	3600
	`connectionPoolSize`	10
	`connectionTimeoutInMilliseconds`	3600
	`connectionIdleTimeoutInSeconds`	600
`XSP\|ADP_CLI/Applications/NotificationPushServer/` `APNS/Production>`	`connectionTimeout`	3000
	`connectionPoolSize`	2
	`connectionIdleTimeoutInSeconds`	600

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

הפעל את AS_CLI/System/PushNotification> get ובדוק את הערך של enforceAllowedApplicationList. אם זה true, עליך להשלים את משימת המשנה הזו. אחרת, דלג על שאר משימת המשנה.
AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”
AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

הפעל מחדש את ה-XSP|ADP: bwrestart

בדוק הודעות על שיחות על-ידי ביצוע שיחות ממנוי BroadWorks לשני משתמשי Webex למכשירים ניידים. ודא שהודעת השיחה מופיעה במכשירי iOS ואנדרואיד.

העברת NPS ל- FCMv1

נושא זה מכיל הליכים אופציונליים שבהם באפשרותך להשתמש במסוף Google FCM כאשר יש לך פריסת NPS קיימת שעליך להעביר ל- FCMv1. ישנם שלושה נהלים:

העברת לקוחות UC-One ל-FCMv1—כאשר יש לך לקוחות UCaaS קיימים ואתה צריך להעביר אותם לשימוש ב-FCMv1.
העברת לקוחות SaaS ל-FCMv1—כאשר יש לך לקוחות SaaS קיימים ואתה צריך להעביר אותם לשימוש ב-FCMv1.
עדכון שרת ADP—כאשר אתה מעביר את ה-NPS לשרת ADP.

העברת לקוחות UC-One ל- FCMv1

השתמש בשלבים הבאים במסוף Google FCM כדי להעביר לקוחות UC-One ל- Google FCM HTTPv1.

אם המיתוג מוחל על הלקוח, הלקוח חייב להיות בעל מזהה השולח. במסוף FCM, ראה הגדרות פרוייקט > העברת הודעותבענן. ההגדרה מופיעה בטבלת האישורים של Project.

לפרטים, עיינו במדריך Connect Mobile Branding Guide בכתובת https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. עיין בפרמטר gcm_defaultSenderId, הנמצא בקובץ branding.xml של ערכת המיתוג, בתיקיית משאבים, עם התחביר הבא:

xxxxxxxxxxxxx

היכנס ל- FCM Admin SDK ב- http://console.firebase.google.com.
בחר את יישום האנדרואיד המתאים.
בכרטיסיה כללי , תעד את מזהה הפרוייקט
נווט אל הכרטיסיה חשבונות שירות כדי לקבוע את התצורה של חשבון שירות. באפשרותך ליצור חשבון שירות חדש או לקבוע תצורה של חשבון קיים.

כדי ליצור חשבון שירות חדש:
1. לחץ על הלחצן הכחול ליצירת חשבון שירות חדש
2. לחץ על הכפתור הכחול כדי ליצור מפתח פרטי חדש
3. הורדת מפתח למיקום מאובטח
כדי לעשות שימוש חוזר בחשבון שירות קיים:
1. לחץ על הטקסט הכחול כדי להציג חשבונות שירות קיימים.
2. זהה את חשבון השירות שבו הוא משתמש. חשבון שירות זקוק להרשאה firebaseadmin-sdk.
3. בצד ימין, לחץ על תפריט ההמבורגר וצור מפתח פרטי חדש.
4. הורד את קובץ json המכיל את המפתח ושמור במיקום מאובטח.
העתק את קובץ ה-json אל XSP|ADP.

קביעת התצורה של מזהה הפרוייקט ו:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add

קביעת התצורה של היישום:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add  projectId 
...Done

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
  Application ID    Project ID
==============================
          my_app    my_project

הפעל את FCMv1:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

הפעל את הפקודה bwrestart כדי להפעיל מחדש את XSP|ADP.

העברת לקוחות SaaS ל- FCMv1

השתמש בשלבים הבאים במסוף Google FCM אם ברצונך להעביר לקוחות SaaS ל- FCMv1.

ודא שכבר השלמת את ההליך "קביעת תצורה של NPS לשימוש ב- Proxy אימות".

השבת את FCM:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
...Done

הפעל את הפקודה bwrestart כדי להפעיל מחדש את XSP|ADP.

הפעל FCM:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

הפעל את הפקודה bwrestart כדי להפעיל מחדש את XSP|ADP.

עדכון שרת ADP

השתמש בשלבים הבאים ב- Google FCM Console אם אתה מעביר את ה- NPS לשימוש בשרת ADP.

קבלו את קובץ JSON ממסוף הענן של גוגל:
1. במסוף הענן של Google, עבור אל הדף חשבונות שירות.
2. לחץ על בחר פרוייקט, בחר את הפרוייקט שלך ולחץ על פתח.
3. מצא את השורה של חשבון השירות שעבורו ברצונך ליצור מפתח, לחץ על הכפתור האנכי עוד ולאחר מכן לחץ על צור מפתח.
4. בחר סוג מפתח ולחץ על צור
  
  הקובץ מוריד.
הוסף FCM לשרת ADP:
1. ייבא את קובץ ה-JSON לשרת ה-ADP באמצעות הפקודה /bw/install.
2. התחבר ל- ADP CLI והוסף מפתח פרוייקט ו- API:
  
  ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON :
3. לאחר מכן, הוסף את היישום והמפתח:
  
  ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
4. אמת את התצורה:
```
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g
Project ID Accountkey
========================
connect-ucaas ********

ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas
```

Cisco AI Assistant

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

הגדרת התראות דחיפה של שיחות עבור Webex BroadWorks

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

שיקולי APNS

הכן את ה- NPS שלך עבור Webex עבור Cisco BroadWorks

הגדרת NPS לשימוש בפרוקסי אימות

העברת NPS ל- FCMv1

העברת לקוחות UC-One ל- FCMv1

העברת לקוחות SaaS ל- FCMv1

עדכון שרת ADP

עסק קטן

ארגון

מכשירים

פתרונות עבור

משאבים

חברה