Krav för samrekitet

• Verifieringstjänsten måste ha samma hemvist för Xsi-program, eftersom gränssnitten måste godkänna tokens som används länge för tjänsteauktorisering. Verifieringstjänsten krävs för att verifiera dessa token.

• Autentiseringstjänsten och Xsi kan köras på samma port om det behövs.

• Du kan separera de andra tjänsterna/programmen efter behov för din skala (dedikerad enhetshantering XSP till exempel).

• Du kan sam leta upp Xsi-, CTI-, autentiseringstjänsten och DMS-programmen.

• Installera inte andra program eller tjänster på XSP:erna som används för att integrera BroadWorks med Webex.

• Lokalisera inte NPS-programmet med några andra program.

Xsi-gränssnitt

Installera och konfigurera Xsi-Actions- och Xsi-Events-applikationerna enligt beskrivningen i Konfigurationsguide för Cisco BroadWorks Xtended Services Interface.

Konfigurera autentiseringstjänsten (med CI-tokenvalidering)

Använd den här proceduren för att konfigurera autentiseringstjänsten för att använda CI-tokenvalidering med TLS. Denna verifieringsmetod rekommenderas om du kör R22 eller senare och ditt system stöder den.

Ömsesidig TLS (mTLS) stöds som en alternativ autentiseringsmetod för autentiseringstjänsten. Om följande villkor gäller för ditt system ska du konfigurera mTLS-autentisering istället för CI-tokenvalidering: Du kör R21SP1. Du har flera Webex-organisationer som kör på samma XSP-server. I detta fall måste du använda mTLS-autentisering som CI-tokenvalidering inte har stöd för flera anslutningar till samma XSP-autentiseringstjänst. För att konfigurera mTLS-autentisering för verifieringstjänsten, se bilaga . Observera även att om du kör R22 eller senare och du för närvarande använder mTLS för autentiseringstjänsten är det inte obligatoriskt att konfigurera om för att använda CI-tokenvalidering med TLS.

1. Skapa en tjänsteförfrågan med din introduktionskontakt eller med TAC för att tillhandahålla ditt (Webex Common Identity) OAuth-klientkonto. Ge din servicebegäran "XSP AuthService-konfiguration". Cisco ger dig ett OAuth-klient-ID, en klienthemlighet och en uppdateringstoken som är giltig i 60 dagar. Om denna token upphör innan du använder den med din XSP kan du förfrågningen upp ytterligare en gång.

2. Installera följande programfixar på varje XSP-server. Installera de programfixar som är lämpliga för din version:

   • För R22:

     AP.platform.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap376508

   • För R23:

     AP.xsp.23.0.1075.ap376509

     AP.platform.23.0.1075.ap376509

   • För R24 – ingen korrigering krävs

3. Installera AuthenticationService program på varje XSP-tjänst.

   1. Kör följande kommando för att aktivera programmet AuthenticationService på XSP till kontextsökvägen för /authService.

      XSP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService

   2. Kör det här kommandot för att distribuera AuthenticationService på XSP:

      XSP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...

4. Konfigurera identitetsleverantörer genom att köra följande kommandon på varje XSP-server:

   XSP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get

   • set enabled true

   • set clientId <client id>

   • set clientSecret <secret from TAC service request>

   • set ciResponseBodyMaxSizeInBytes 65536

   • set issuerName <URL> – För URL, ange IssuerName URL som gäller för ditt CI-kluster. Se tabellen som följer.

   • set issuerUrl <URL> – För URL, ange Det IssuerUrl som gäller för ditt CI-kluster. Se tabellen som följer.

   • set tokenInfoUrl <IdPProxy URL> – Ange IdP-proxy-URL:en som gäller för ditt Teams-kluster. Se tabellen som följer.

   Tabell 1. identitetsleverantör URL:er

   Utl?rdareURL och Utl?rdnamn-URL		IdP proxy-URL
   Om CI-kluster är...	Ställ in IssuerURL och IssuerName på...	Om Teams-klustret är...	Ställ in IdP-proxy-URL på...
   USA – EN	https://idbroker.webex.com/idb	ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   Eu	https://idbroker-eu.webex.com/idb	AFRA	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   USA–B	https://idbroker-b-us.webex.com/idb	AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   * Om du inte känner till ditt CI-kluster eller Teams-kluster kan du hämta informationen Help Desk -vyn i Control Hub. Under Kundinformation, se värdet på fälten CI-kluster och Teams-kluster.   Under testning kan du verifiera att URL:en är giltig genom att ersätta länken " idp/authenticate" del av URL:en med " ping".

5. Ange vilka Webex-berättiganden som måste finnas i användarprofil i Webex genom att köra följande kommando:

   XSP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user

6. Konfigurera identitetsleverantörer för Cisco Federation med följande kommandon på varje XSP-server:

   XSP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get

   • set flsUrl https://cifls.webex.com/federation

   • set refreshPeriodInMinutes 60

   • set refreshToken <token from service request>

7. Kör följande kommando för att validera att din FLS-konfiguration fungerar. Det här kommandot returnerar listan över identitetsleverantörer:

   XSP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get

8. Konfigurera TokenHantering med följande kommandon på varje XSP-server:

   • XSP_CLI/Applications/AuthenticationService/TokenManagement>

   • set tokenIssuer BroadWorks

   • set tokenDurationInHours 720

9. Generera och dela RSA-nycklar. Du måste skapa nycklar på en XSP och sedan kopiera dem till alla övriga XSP:er. Detta beror på följande faktorer:

   • Du måste använda samma offentliga/privata nyckelpar för tokenkryptering/dekryptering mellan alla instanser av autentiseringstjänsten.

   • Nyckelparet skapas av autentiseringstjänsten när det först måste utfärda en token.

   Om du växlar mellan nycklarna eller ändrar nyckellängden måste du upprepa följande konfiguration och starta om alla XSP:er.

   1. Välj ett XSP som ska användas för att skapa ett nyckelpar.

   2. Använd en klient för att begära en krypterad token från det XSP genom att begära följande URL från klientens webbläsare:

      https://<XSP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)

      (Detta genererar ett privat/offentligt nyckelpar på XSP om det inte redan finns en sådan)

   3. Lagringsplatsen för nyckeln kan inte konfigureras. Exportera nycklarna:

      XSP_CLI/Applications/authenticationService/KeyManagement> exportKeys

   4. Kopiera den exporterade filen /var/broadworks/tmp/authService.keys på samma plats på de andra XSP:erna, vilket skriver över en äldre .keys fil vid behov.

   5. Importera tangenterna på var och en av de andra XSP:erna:

      XSP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys

10. Ange authService-URL:en till webbbehållaren. XSP-webbbehållaren behöver AUTHService-URL så att den kan validera tokens. På var och en av XSPs:

    1. Lägg till URL för verifieringstjänsten som en extern verifieringstjänst för BroadWorks Communications-verktyget:

       XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

    2. Lägg till URL för verifieringstjänsten till behållaren:

       XSP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

       Detta gör det Cisco Webex att använda autentiseringstjänsten för att validera tokens som presenteras som inloggningsuppgifter.

    3. Kontrollera parametern med get.

    4. Starta om XSP:

Konfigurera TLS och chiffer i HTTP-gränssnitt (för XSI- och autentiseringstjänst)

Autentiseringstjänsten, Xsi-Actions- och Xsi-Events-programmen använder HTTP-servergränssnitt. Dessa program kan konfigureras på olika nivåer av TLS enligt följande:

Mest allmänt = System > Transport > HTTP > HTTP-servergränssnittet = Mest specifikt

De CLI-sammanhang du använder för att visa eller ändra de olika SSL-inställningarna är:

Läser in HTTP-serverns TLS-gränssnittskonfiguration i XSP

1. Logga in på XSP och navigera till XSP_CLI/Interface/Http/HttpServer>

2. Ange get och läsa resultaten. Du bör se gränssnitten (IP-adresser) och för var och en om de är säkra och om de kräver klientautentisering.

En tomcat utk?perrer ett certifikat för varje säkert användargränssnitt. systemet skapar ett själv signerat certifikat om det behövs ett.

XSP_CLI/Interface/Http/HttpServer> get

Lägga till TLS 1.2-protokoll till HTTP Server Interface

Denna procedur gäller R22 och senare. För att konfigurera TLS-version på R21(SP1), måste du använda alternativet XSP-plattformsbehållare bw.apache.sslenabledprotocols.

HTTP-gränssnittet som interagerar med Cisco Webex måste konfigureras för TLSv1.2. Molnet förhandlar inte om tidigare versioner av TLS-protokollet.

Så här konfigurerar du TLSv1.2-protokollet i HTTP-servergränssnittet:

1. Logga in på XSP och navigera till XSP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

2. Ange kommandot get <interfaceIp> 443 för att se vilka protokoll som redan används i detta gränssnitt.

3. Ange kommandot add <interfaceIp> 443 TLSv1.2 för att säkerställa att gränssnittet kan använda TLS 1.2 vid kommunikation med -molnet.

Redigera TLS-chifferkonfiguration i HTTP Server Interface

Denna procedur gäller R22 och senare. För att konfigurera TLS-chiffer på R21(SP1) måste du använda alternativet för XSP-plattformsbehållare bw.apache.sslciphersuite.

Så här konfigurerar du de chiffer som krävs:

1. Logga in på XSP och navigera till XSP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

2. Ange kommandot get <interfaceIp> 443 för att se vilka chiffer som redan används i det här gränssnittet. Det måste finnas minst en från Ciscos rekommenderade paket (se XSP-identitets- och säkerhetskraven i översiktsavsnittet).

3. Ange kommandot add <interfaceIp> 443 <cipherName> för att lägga till en chiffer i HTTP-servergränssnittet.

   XSP CLI kräver IANA-standardnamnet för chiffersviten, inte chiffersvitens openSSL-namn. Till exempel för att lägga till openSSL-chiffer ECDHE-ECDSA-CHACHA20-POLY1305 till HTTP-servergränssnittet använder du: XSP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 Se https://ciphersuite.info/ för att hitta sviten med ett av filnamnen.

Konfigurera enhetshantering på XSP, programserver och profilserver

Profilserver och XSP är obligatoriska för enhetshantering. De måste konfigureras enligt anvisningarna i BroadWorks Device Management Konfigurationsguide (https://xchange.broadsoft.com/node/1031995).

Konfigurera programserver för CTI-prenumerationer

Uppdatera klientidentifiering på programservern med behörigheten vanligt namn (CN) för Webex för BroadWorks CTI-klientcertifikat.

Lägg till certifikatidentiteten till Klientidentifiering på följande sätt för varje programserver du använder med Webex:

AS_CLI/System/ClientIdentity> add bwcticlient.webex.com

Certifikatet vanligt namn Webex för BroadWorks-klientcertifikatet är bwcticlient.webex.com.

Konfigurera TLS och chiffer i CTI-gränssnittet

Konfigureringsnivåerna för XSP CTI-gränssnittet är följande:

Mest allmänt = System > Transport > CTI-gränssnitt > CTI-gränssnitt = Mest specifika

De CLI-sammanhang du använder för att visa eller ändra de olika SSL-inställningarna är:

Läser in CTI TLS-gränssnittets konfiguration på XSP

1. Logga in på XSP och navigera till XSP_CLI/Interface/CTI/SSLSettings>

   På BroadWorks R21: navigera till XSP_CLI/Interface/CTI/SSLConfiguration>

2. Ange get och läsa resultaten. Du bör se gränssnitten (IP-adresser) och för var och en om de kräver ett servercertifikat och om de kräver klientautentisering.

   

Lägga till TLS 1.2-protokoll till CTI-gränssnittet

Denna procedur gäller R22 och senare. För att konfigurera TLS-versionen på CTI-gränssnittet för R21(SP1) måste du använda alternativet tomcat container bw.cti.sslenabledprotocols.

XSP CTI-gränssnittet som interagerar med Cisco Webex-molnet måste konfigureras för TLS v1.2. Molnet förhandlar inte om tidigare versioner av TLS-protokollet.

Så här konfigurerar du TLSv1.2-protokollet på CTI-gränssnittet:

1. Logga in på XSP och navigera till XSP_CLI/Interface/CTI/SSLSettings/Protocols>

2. Ange kommandot get <interfaceIp> för att se vilka protokoll som redan används i detta gränssnitt.

3. Ange kommandot add <interfaceIp> TLSv1.2 för att säkerställa att gränssnittet kan använda TLS 1.2 vid kommunikation med -molnet.

Redigera TLS-chifferkonfiguration i CTI Interface

Denna procedur gäller R22 och senare. Om du vill konfigurera chiffer på CTI-gränssnittet för R21(SP1) måste du använda alternativet tomcat-container bw.cti.enabledciphers.

Så här konfigurerar du de nödvändiga chiffer på CTI-gränssnittet:

1. Logga in på XSP och navigera till XSP_CLI/Interface/CTI/SSLSettings/Ciphers>

2. Ange get för att se vilka chiffer som redan används i det här gränssnittet. Det måste finnas minst en från Ciscos rekommenderade paket (se XSP-identitets- och säkerhetskraven i översiktsavsnittet).

3. Ange kommandot add <interfaceIp> <cipherName> för att lägga till chiffer till CTI-gränssnittet.

   XSP CLI kräver IANA-standardnamnet för chiffersviten, inte chiffersvitens openSSL-namn. Till exempel för att lägga till openSSL-chiffer ECDHE-ECDSA-CHACHA20-POLY1305 till CTI-gränssnittet använder du: XSP_CLI/Interface/CTI/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 Se https://ciphersuite.info/ för att hitta sviten med ett av filnamnen.

Uppdatera betrodda ankare för CTI Interface (R22 och senare)

Denna procedur förutsätter att XSP:erna antingen är internetriktade eller ansikte mot internet via en pass-through-proxy. Certifikatkonfigurationen är annorlunda för en bryggproxyn (se TLS-certifikatkrav för TLS-bridge-proxy).

För varje XSP i din infrastruktur som publicerar CTI-händelser till Webex ska du göra följande:

1. Logga in på Partner Hub.

2. Gå till Inställningar > BroadWorks-samtal och klicka på Hämta Webex CA-certifikat för att få CombinedCertChain.txt på din lokala dator.

   Den här filen innehåller två certifikat. Du måste dela filen innan du överför den till XSPs.

3. Dela certifikatkedjan i två certifikat:

   1. Öppna combinedcertchain.txt i en textredigerare.

   2. Välj och klipp ut det första textblocket, inklusive linjerna -----BEGIN CERTIFICATE----- och -----END CERTIFICATE----- och klistra in textblockering i en ny fil.

   3. Spara den nya filen som broadcloudroot.txt.

   4. Spara originalfilen som broadcloudissuing.txt.

      Originalfilen får nu endast ha ett textblock, som omges av linjerna -----BEGIN CERTIFICATE----- och -----END CERTIFICATE-----.

4. Kopiera båda textfilerna till en tillfällig plats på det XSP-system som du säkrar, t.ex. /tmp/broadcloudroot.txt och /tmp/broadcloudissuing.txt.

5. Logga in på XSP och navigera till /XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

6. (Valfritt) Köra help updateTrust för att se parametrarna och kommandoformatet.

7. Överför certifikatfilerna till nya betrodda ankare:

   XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexroot /tmp/broadcloudroot.txt

   XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexissuing /tmp/broadcloudissuing.txt

   webexroot och webexissuing är exempelalias för betrodda ankare. kan du använda dina egna.

8. Bekräfta att ankarna är uppdaterade:

   XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get

     Alias   Owner                                   Issuer
   =============================================================================
   webexissuing    BroadCloud Commercial Issuing CA – DA3     BroadCloud Commercial Trusted Root CA
   webexroot       BroadCloud Commercial Trusted Root CA      BroadCloud Commercial Trusted Root CA[self-signed]

9. Tillåt klienter att autentisera med certifikat:

   XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

Uppdatera betrodda ankare för CTI Interface (R21)

Denna procedur förutsätter att XSP:erna antingen är internetriktade eller ansikte mot internet via en pass-through-proxy. Certifikatkonfigurationen är annorlunda för en bryggproxyn (se TLS-certifikatkrav för TLS-bridge-proxy).

För varje XSP i din infrastruktur som publicerar CTI-händelser till Webex ska du göra följande:

1. Logga in på Partner Hub.

2. Gå till Inställningar > BroadWorks-samtal och klicka på Hämta Webex CA-certifikat för att få CombinedCertChain.txt på din lokala dator.

   Den här filen innehåller två certifikat. Du måste dela filen innan du överför den till XSPs.

3. Dela certifikatkedjan i två certifikat:

   1. Öppna combinedcertchain.txt i en textredigerare.

   2. Välj och klipp ut det första textblocket, inklusive linjerna -----BEGIN CERTIFICATE----- och -----END CERTIFICATE----- och klistra in textblockering i en ny fil.

   3. Spara den nya filen som broadcloudroot.txt.

   4. Spara originalfilen som broadcloudissuing.txt.

      Originalfilen får nu endast ha ett textblock, som omges av linjerna -----BEGIN CERTIFICATE----- och -----END CERTIFICATE-----.

4. Kopiera båda textfilerna till en tillfällig plats på det XSP-system som du säkrar, t.ex. /tmp/broadcloudroot.txt och /tmp/broadcloudissuing.txt.

5. Logga in på XSP och navigera till /XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts>

6. (Valfritt) Köra help updateTrust för att se parametrarna och kommandoformatet.

7. Uppdatera nya betrodda ankare med certifikaten:

   /XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts> updateTrust webexroot /tmp/broadcloudroot.txt

   /XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts> updateTrust webexissuing /tmp/broadcloudissuing.txt

   (där "webexroot" och "webexissuing" är exempelalias för betrodda ankare, du kan välja din egen)

8. Bekräfta att båda certifikaten har överförts:

   /XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts> get

   XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts> get
                Alias                                   Owner                                           Issuer
   ===========================================================================================================
        webexissuing   BroadCloud Commercial Issuing CA - DA3 BroadCloud Commercial Trusted Root CA
           webexroot   BroadCloud Commercial Trusted Root CA  BroadCloud Commercial Trusted Root CA[self-signed]

9. Tillåt klienter att autentisera med certifikat:

   XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

Lägg till CTI-gränssnitt och aktivera mTLS

1. Lägg till CTI SSL-gränssnittet.

   CLI-kontexten beror på din BroadWorks-version. Kommandot skapar ett själv signerat servercertifikat på gränssnittet och tvingar gränssnittet att kräva ett klientcertifikat.

   • På BroadWorks 22 och 23.0:

     XSP_CLI/Interface/CTI/SSLSettings> add <Interface IP> true true

   • På BroadWorks 21.sp1:

     XSP_CLI/Interface/CTI/SSLConfiguration> add <Interface IP> true true

2. Aktivera och definiera den säkra CTI-porten på XSPs:

   XSP_CLI/Interface/CTI> set securePortEnabled true

   XSP_CLI/Interface/CTI> set securePort 8012

3. Ersätt servercertifikatet och nyckeln i XSP:s CTI-gränssnitt. Du behöver IP-adressen för CTI-gränssnittet för detta; kan du läsa den från följande sammanhang:

   • På BroadWorks 22 och 23.0:

     XSP_CLI/Interface/CTI/SSLSettings> get

   • På BroadWorks 21.sp1:

     XSP_CLI/Interface/CTI/SSLConfiguration> get

     Kör sedan följande kommandon för att ersätta gränssnittets själv signerade certifikat med ditt eget certifikat och din privata nyckel:

     På BroadWorks 22.0 och 23.0:

     XSP_CLI/Interface/CTI/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>

     På BroadWorks 21.sp1:

     XSP_CLI/Interface/CTI/SSLConfiguration> sslUpdate <interface IP> keyFile </path/to/certificate key file> certificateFile </path/to/server certificate> chainFile </path/to/chain file>

4. Starta om XSP:

Öppna inkommande portar för säkert CTI-gränssnitt

Öppna den säkra porten för CTI på din brandvägg (TCP 8012 som standard) för en ingående TLS-anslutning till ditt XSP CTI-gränssnitt.

Så här kontrollerar du att den säkra porten är aktiverad och dess portnummer:

1. Logga in på XSP CLI och navigera till XSP_CLI/Interface/CTI> Sammanhang.

2. Delta get.

Bland annan information ska du se följande:

securePort = 8012

Detta säkerställer att Webex kan initiera en krypterad anslutning.

Webex använder endast den säkra porten, så vi rekommenderar att du ställer in portEnabled = false för att inaktivera den osäkra porten.

Aktivera åtkomst till BroadWorks CTI Events på Cisco Webex

Du måste lägga till och validera CTI-gränssnittet när du konfigurerar dina kluster i Partner Hub. Se Konfigurera din partnerorganisation i Control Hub för detaljerade anvisningar.

• Ange med vilken CTI-adress Cisco Webex prenumerera på BroadWorks CTI Events.

• CTI-prenumerationer fastställs per prenumerant och upprättas och upprätthålls endast när prenumeranten är etablerad för Webex för BroadWorks.

Användarupplevelse

• Windows-användare: Klicka profilbild och sedan på Inställningar > Ringa > Självhjälp.

• Mac-användare: Klicka profilbild och sedan på Inställningar > samtal >Självhjälp

Installera webbvisning för samtalsinställningar på XSPs

CSWV-programmet måste vara på samma XSP(er) som är värd för Xsi-Actions-gränssnittet i din miljö. Det är ett omanagerat program på XSP, så du måste installera och distribuera en webbarkivfil.

1. Logga in på Xchange och sök efter "BWCallSettingsWeb" i avsnittet för hämtning av programvara.

2. Hitta och hämta den senaste versionen av filen.

   Till exempel var BWCallSettingsWeb_1.8.2_1.war ( ) den senaste tiden ihttps://xchange.broadsoft.com/node/1057167textskrivningen.

3. Installera, aktivera och distribuera webbarkivet enligt Konfigurationsguide för Xtended-tjänsteplattform för din XSP-version. (R23-versionen är https://xchange.broadsoft.com/node/1033484).

   1. Kopiera .war-filen till en tillfällig plats på XSP:en, t.ex. /tmp/.

   2. Navigera till följande CLI-kontext och kör installationskommandot:

      XSP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war

      BroadWorks-programvaruhanteraren validerar och installerar filen.

   3. [Valfritt] Ta bort /tmp/BWCallSettingsWeb_1.7.5_1.war(denna fil behövs inte längre).

   4. Aktivera programmet:

      XSP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      Namnet och versionen är obligatoriska för alla program, men för CSWV måste du också ange en contextPath eftersom det är ett oläst program. Du kan använda alla värden som inte används av ett annat program, till exempel /callsettings.

   5. Distribuera programmet för samtalsinställningar på den valda kontextsökvägen:

      XSP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

4. Du kan nu förutsäga den URL för samtalsinställningar som du anger för klienter enligt följande:

   https://<XSP-FQDN>/callsettings/

   Anteckningar:

   • Du måste ange spår snedstrecket på denna URL när du anger det i klientens konfigurationsfil.

   • XSP-FQDN måste matcha Xsi-actions-FQDN, eftersom CSWV behöver använda Xsi-åtgärder och CORS stöds inte.

5. Upprepa detta förfarande för andra XSPs i din Webex för BroadWorks-miljö (om det behövs)

Webview-programmet för samtalsinställningar är nu aktivt på XSPs.

Ytterligare konfiguration för XSP R21

Om du distribuerar CSWV-programmet på en R21 XSP:

1. Navigera till kontexten för samtalsinställningar och kör hämta för att läsa dess konfiguration: XSP_CLI/Applications/BWCallSettingsWeb_1.7.5/General> get

   Du bör se följande parametrar och värden:

   xsiActionsContextOrURL=/com.broadsoft.xsi-actions
   displayCriteriaOrScheduleName=criteria
   applicationMode=prod
   

2. Användare set(vid behov) för att ändra parametrarna till de värden som visas ovan.

3. Upprepa för andra R21 XSPs vid behov.

NPS-proxy, översikt

För att vara kompatibel med Webex för BroadWorks måste DIN CNPS korrigeras för att stödja NPS-proxyfunktionen, push-server för VoIP i UCaaS.

Funktionen implementerar en ny design i Aviserings push-servern för att lösa säkerhetsrisken för delning av certifikat för push-meddelande med privata nycklar med tjänsteleverantörer för mobilklienter. I stället för att dela push-aviseringscertifikat och -nycklar med tjänsteleverantören använder NPS en ny API för att få en token med kort fördröjning av push-avisering från Webex för BroadWorks-backend, och använder denna token för autentisering med Apple APN:er och Google FCM-tjänster.

Funktionen förbättrar också möjligheten för push-servern för meddelanden att skicka meddelanden till Android-enheter via google Firebase Cloud Messaging (FCM) HTTPv1 API.

• För mer information, se Push-servern för VoIP i UCaaS-beskrivning på Xchange: https://xchange.broadsoft.com/node/1045458.

• BroadWorks-programfixar för funktionen är tillgängliga på Xchange: https://xchange.broadsoft.com/node/1046235.

• Mer information om ADP-servern finns på https://xchange.broadsoft.com/node/1051580.

Konfigurera dina BroadWorks-kluster

[en gång per kluster]

Detta görs av följande skäl:

• För att aktivera Webex-molnet för att autentisera dina användare mot BroadWorks (via XSP-värdbaserad autentiseringstjänst).

• För att aktivera Att Webex-appar använder Xsi-gränssnitt för samtalskontroll.

• För att aktivera Webex för att lyssna efter CTI-händelser som publicerats av BroadWorks (telefoninärvaro).

Klusterguiden validerar automatiskt gränssnitten när du lägger till dem. Du kan fortsätta att redigera klustret om något av gränssnitten inte valideras, men du kan inte spara ett kluster om det finns ogiltiga poster. Vi förhindrar detta eftersom ett felaktigt kluster kan orsaka problem som är svåra att lösa.

Vad du behöver göra:

1. Logga in på Partner Hub (admin.webex.com) med dina inloggningsuppgifter som partneradministratör.

2. Öppna sidan Inställningar i sidomenyn och hitta BroadWorks-samtalsinställningar.

3. Klicka på Lägg till kluster.

   Detta startar en guide där du tillhandahåller dina XSP-gränssnitt (URL:er). Du kan lägga till en port i gränssnittets URL om du använder en port som inte är standard.

4. Namnge detta kluster och klicka på Nästa.

   Klusterkonceptet här är helt enkelt en samling gränssnitt, vanligen samplacerade på en XSP-server eller en gammal server, som gör det möjligt för Webex att läsa information från din programserver (AS). Du kan ha ett XSP per AS-kluster, eller flera XSPs per kluster eller flera AS-kluster per XSP. Skalkraven för ditt BroadWorks-system finns inte här.

5. (Valfritt) Ange ett BroadWorks-användarnamn och lösenord som du vet finns i BroadWorks-systemet som du ansluter till Webex och klicka sedan på Nästa.

   Valideringstesterna kan använda detta konto för att validera anslutningar till gränssnitten i klustret.

6. Lägg till dina URL:er förXSI-åtgärder och XSI Events.

7. Klicka på Nästa.

8. Lägg till din CTI-gränssnitts-URL och klicka på Nästa.

9. Lägg till URL för autentiseringstjänsten.

10. Välj Autentiseringstjänst med CI-tokenvalidering.

    Det här alternativet kräver inte mTLS för att skydda anslutningen från Webex eftersom autentiseringstjänsten verifierar användar-token mot Webex identitetstjänst innan den utfärdar den sedan länge aktuella token för användaren.

11. Granska dina uppgifter på den sista skärmen och klicka sedan på Skapa. Du bör se ett meddelande om att det lyckades.

    Partner Hub skickar URL:er till olika Webex-mikrotjänster som testar anslutningarna till de tillhandahållna gränssnitten.

12. Klicka på Visa kluster så bör du se ditt nya kluster och om valideringen lyckades.

13. Knappen Skapa kan inaktiveras på guidens slutliga (förhandsgranskningsskärm). Om du inte kan spara mallen anger det ett problem med en av de integreringar som du just konfigurerat.

    Vi har implementerat den här kontrollen för att förhindra fel i efterföljande uppgifter. Du kan gå tillbaka via guiden när du konfigurerar din distribution, vilket kan kräva modifieringar i din infrastruktur (t.ex. XSP, laddningsbalanser eller brandvägg) som beskrivs i denna guide innan du kan spara mallen.

Kontrollera anslutningarna till dina BroadWorks-gränssnitt

1. Logga in på Partner Hub (admin.webex.com) med dina inloggningsuppgifter som partneradministratör.

2. Öppna sidan Inställningar i sidomenyn och hitta BroadWorks-samtalsinställningar.

3. Klicka på Visa kluster.

4. Partner Hub initierar anslutningstester från de olika mikrotjänster till gränssnitten i klustren.

   När testerna är klara visar klusterlistsidan statusmeddelandet bredvid varje kluster.

   Du bör se gröna framgångsmeddelanden. Om du ser ett rött felmeddelande, klicka på det påverkade klusternamnet för att se vilken inställning som orsakar problemet.

Konfigurera dina kundmallar

Kundmallar är det sätt på vilket du använder delad konfiguration för en eller flera kunder när du registrera dem via etableringsmetoderna. Du måste associera varje mall med ett kluster (som du skapade i föregående avsnitt).

Du kan skapa så många mallar du behöver, men endast en mall kan associeras med en kund.

1. Logga in på Partner Hub (admin.webex.com) med dina inloggningsuppgifter som partneradministratör.

2. Öppna sidan Inställningar i sidomenyn och hitta BroadWorks-samtalsinställningar.

3. Klicka på Lägg till mall.

   Då startas en guide där du kan tillhandahålla konfiguration för kunder som ska använda den här mallen.

4. Använd den nedrullningsbara listrutan Kluster för att välja det kluster som du vill använda med denna mall.

5. Ange ett mallnamnoch klicka sedan på Nästa.

6. Konfigurera ditt etableringsläge genom att använda dessa rekommenderade inställningar:

   Tabell 2. Rekommenderade etableringsinställningar för olika etableringslägen

   Inställningsnamn	Flowflödesetablering av betrodda e-postmeddelanden	Flowflödesetablering utan e-postmeddelanden	Självetablering av användare
   Aktivera BroadWorks-flödet via etablering (inkludera inloggningsuppgifter för provisioneringskontot om det är på)	På Ange namn och lösenord för det tillhandahållande kontot enligt BroadWorks-konfigurationen.	På Ange namn och lösenord för det tillhandahållande kontot enligt BroadWorks-konfigurationen.	Av
   Skapa nya organisationer automatiskt i Control Hub	I†	I†	I†
   tjänsteleverantör e-postadress	Välj en e-postadress från den nedrullningsbara listan (du kan skriva in vissa tecken för att hitta adressen om det är en lång lista). Denna e-postadress identifierar administratören inom din partnerorganisation som kommer att tilldelas delegerad administratörsåtkomst till alla nya kundorganisationer som har skapats med kundmallen.
   Land	Välj vilket land du använder för den här mallen. Landet du väljer matchar kundorganisationer som har skapats med den här mallen till en viss region. För närvarande kan regionen vara (EMEAR) eller (Nordamerika och resten av världen). Se mappningarna för land till region i det härkalkylbladet.
   BroadWorks Enterprise-läge aktivt	Aktivera detta om kunderna du etablerar med den här mallen är företag i BroadWorks. Om de är grupper lämnar du den här reglaget av. Om du har en blandning av företag och grupper i BroadWorks bör du skapa olika mallar för de olika fallen.

   • Anteckningar från tabellen:

   • † Den här växeln säkerställer att en ny kundorganisation skapas om en prenumerantens e-postdomän inte matchar en befintlig Webex-organisation.

     Detta ska alltid vara på, såvida du inte använder en manuell process för beställning och uppfyllande (via Cisco Commerce Workspace) för att skapa kundorganisationer i Webex (innan du startar etableringen av användare i dessa organisationer). Det alternativet kallas ofta för "Hybrid-etablering"-modellen, och det går inte att komma åt omfattningen av detta dokument.

7. Välj standardtjänstpaket för kunder som använder denna mall (se Paket i avsnittet Översikt); antingen Basic , Standard , Premium ellerSoftphone.

   Du kan åsidosätta den här inställningen för enskilda användare via partnerhubben.

8. Välj standardverifieringsläge (antingen BroadWorks-autentisering eller Webex-autentisering) för kunder som använder den här mallen.

   (Se Autentiseringsläge i avsnittet Förbered miljön.

9. Konfigurera hur användare verifierar sina identiteter på Webex. Inställningarna på den här sidan överensstämmer med ditt valda användaretableringsläge enligt tabellen:

   Tabell 3. Rekommenderade användarverifieringsinställningar för olika etableringslägen

   Inställningsnamn	Flowflödesetablering av betrodda e-postmeddelanden	Flowflödesetablering utan e-postmeddelanden	Självetablering av användare
   Användarverifiering	Betrodda BroadWorks-e-postmeddelanden	Ej betrodda e-postmeddelanden	Ej betrodda e-postmeddelanden
   Den första användaren som etableras är admin	Rekommenderas*	Rekommenderas*	Ej tillämpligt
   Tillåt användare att självaktivera	Ej tillämpligt	Ej tillämpligt	Krävs

   • Anteckningar från tabellen:

   • * Den första användaren som du tilldelar Integrerat SNABBMEDDELANDE&P i BroadWorks tar över rollen som kundadministratör om en ny kundorganisation skapas i Webex. Välj den här inställningen för att ge dig kontroll över vem som övertar rollen. Om du avmarkerar den här inställningen blir den första användaren som blir aktiv i den nya organisationen att bli kundadministratör.

     Du kan ändra kund användarroller i Partner Hub efter etableringen, om det behövs.

10. Välj om du vill förifylla användarnas e-postadresser påinloggningssidan.

    Du ska endast använda detta alternativ om du har valt BroadWorks-autentisering och dessutom har lagt användarnas e-postadresser i attributet Alternativt ID i BroadWorks. Annars måste de använda sina BroadWorks-användarnamn. Inloggningssidan ger vid behov ett alternativ att ändra användare, men detta kan leda till inloggningsproblem.

11. Välj om du vill aktivera katalogsynkronisering.

    Med det här alternativet kan Webex läsa BroadWorks-kontakter i kundorganisationen så att användare kan hitta och ringa upp dem från Webex-appen.

12. Ange en partneradministratör.

    Det här namnet används i den automatiska e-postmeddelande från Webex, som bjuder in användare att validera sina e-postadresser.

13. Kontrollera att växlingen för befintliga organisationer är på (standardinställningen är på).

14. Granska dina uppgifter på den sista skärmen. Du kan klicka på navigeringskontrollerna längst upp i guiden för att gå tillbaka och ändra all information. Klicka på Skapa.

    Du bör se ett meddelande om att det lyckades.

15. Klicka på View Templates (Visa mallar) så bör du se den nya mallen med alla andra mallar.

16. Klicka på mallnamnet om du vill ändra eller ta bort mallen vid behov.

    Du behöver inte ange provisioneringskontots uppgifter igen. Fälten för att bekräfta lösenord/lösenord är tomma för att ändra inloggningsuppgifterna om du behöver, men lämna dem tomma för att behålla värdena som du har gett guiden.

17. Lägg till fler mallar om du har olika delade konfigurationer som du vill ge till kunderna.

    Ha sidan Visa mallar öppen precis som du kanske behöver mallinformation för följande uppgifter.

Lägga till Webex för BroadWorks i en befintlig organisation

Om du är en partneradministratör som lägger till Webex för BroadWorks-tjänster till en kundorganisation som finns i Control Hub men som ännu inte är kopplad till en organisation i CI, måste kundens organisationsadministratör godkänna administratörsåtkomst för att begäran ska lyckas.

Organisationsadministratörens godkännande krävs om något av följande är sant:

• Det finns ingen som hanteras-via-relationen mellan tjänsteleverantör och kundorganisationen och e-postadressen för en av organisationens användare matchar e-postadressen för en CI-användare i en organisation med minst 100 användare

• Organisationen har en verifierad e-postdomän

• Organisationsdomänen är ejclaimed

Partneradministratörer kan utföra följande procedur för att lägga till BroadWorks-samtalstjänster i en befintlig Webex-organisation:

I partnerhubben måste växlingen för befintliga organisationer aktiveras i organisationens inställningar för kundmallen (växling är på som standard).

1. I BroadWorks ska du tillhandahålla dig själv som en användare för den organisationen.

2. Tillhandahålla Webex för BroadWorks för kunden. Du kommer att få ett e-postmeddelande med titeln Din samtalstjänst har precis en uppgradering.

3. Klicka på knappen Delta nu i e-postaviseringen. När du har klickat på knappen sker följande:

   • Org-bilaga misslyckas med en 2017 fel (Prenumeranter kan inte tillhandahållas i en befintlig Webex-organisation).

   • Ett e-postmeddelande med en godkännandebegäran skapas och skickas till kundens organisationsadministratörer (upp till fem administratörer). I meddelandet markeras e-postadressen för partneradministratör (som konfigurerad i kundmallen i partnerhubben) och uppmanar organisationsadministratören att godkänna begäran. För att slutföra provisioneringsprocessen måste organisationsadministratören godkänna begäran och ge partneradministratören fullständiga administratörsbehörigheter till kundorganisationen.

4. Med fullständig administratörsåtkomst kan du nu tillhandahålla samtalstjänster utan problem.

Lägg till extern administratör

För en procedur som kundorganisationsadministratörer kan följa för att lägga till partneradministratören som en extern administratör, se Godkänn extern administratörsförfrågan.

Programserver för korrigering

1. Tillämpa programfixen ap373197 (se BroadWorks-programvarukrav i avsnittet Referens).

2. Ändra till Maintenance/ContainerOptions Sammanhang.

3. Aktivera parametern url för tillhandahållande:

   /AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true

Hämta URL för tillhandahållande från partnerhubben

Se Cisco BroadWorks Application Server administrationsguide för kommandoradsgränssnitt för detaljer (Interface > Messaging and Service > Integrated IM&P) för AS-kommandona.

1. Logga in på Partner Hub och gå till Inställningar > BroadWorks-samtal.

2. Klicka på Visa mallar.

3. Välj den mall du använder för att tillhandahålla prenumeranter för detta företag/den här gruppens prenumeranter i Webex.

   Mallinformationen visas i ett utfällningsfönster till höger. Om du inte har skapat någon mall ännu måste du göra det innan du kan få ut provisionerings-URL:en.

4. Kopiera URL:en till provisioneringsadaptern.

Upprepa detta för andra mallar om du har fler än en.

(Alternativ) Konfigurera systemomfattande etableringsparametrar på programservern

Du kanske inte vill ställa in en systemomfattande etablerings- och tjänstedomän om du använder UC-One SaaS. Se Beslutspunkter i avsnittet Förbered miljön.

1. Logga in på programservern och konfigurera meddelandegränssnittet.

   1. AS_CLI/Interface/Messaging> set provisioningUrl EnterValueFromPartnerHubTemplate

   2. AS_CLI/Interface/Messaging> set provisioningUserId EnterValueFromPartnerHubTemplate

   3. AS_CLI/Interface/Messaging> set provisioningPassword EnterValueFromPartnerHubTemplate

   4. AS_CLI/Interface/Messaging> set enableSynchronization true

2. Aktivera det integrerade IMP-gränssnittet:

   1. /AS_CLI/Service/IntegratedIMP> set serviceDomain example.com

   2. /AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true

Du måste ange ett helt kvalificerat namn för provisioningURL parametern, så som den angavs i Control Hub. Om din programserver inte kan komma åt DNS för att lösa värdnamnet, måste du skapa mappningen i /etc/hosts fil på AS.

(Alternativ) Konfigurera parametrar för tillhandahållande per företag på programservern

1. Öppna företaget du vill konfigurera i BroadWorks-användargränssnittet och gå till Tjänster > integrerat snabbmeddelande&P.

2. Välj Använd tjänstedomän och ange ett dummy-värde (Webex ignorerar denna parameter. Du kan använda example.com).

3. Välj Använd meddelandeserver.

4. I URL-fältet klistrar du in provisionerings-URL:en som du kopierade från mallen i partnerhubben.

   Du måste ange ett helt kvalificerat namn för provisioningURL parametern, som den angavs i Partner Hub. Om din programserver inte kan komma åt DNS för att lösa värdnamnet, måste du skapa mappningen i /etc/hosts fil på AS.

5. I fältet Användarnamn anger du ett namn för administratören för tillhandahållande. Detta måste matcha värdet på mallen i partnerhubben.

6. Ange ett lösenord för provisioneringsadministratören. Detta måste matcha värdet på mallen i partnerhubben.

7. För Standardanvändaridentitet för IM&P IDväljer du Primär .

8. Klicka på Verkställ.

9. Upprepa för andra företag som du vill konfigurera för flödet genom etablering.

Lägg till konfigurationsmallar för Webex-appar i BroadWorks-programserver

Webex-appar är konfigurerade med DTAF-filer. Klienterna hämtar en konfigurations-XML-fil från programservern via tjänsten Device Management på XSP.

1. Skaffa de DTAF-filer som krävs (se Enhetsprofiler i avsnittet Förbered din miljö).

2. Kontrollera att du har rätt tagguppsättningar i BroadWorks System > Resources > tagguppsättningar för enhetshantering.

3. För varje klient som du etablerar:

   1. Hämta och extrahera DTAF-zip-filen för den specifika klienten.

   2. Importera DTAF-filer till BroadWorks vid > Resources > identitets-/enhetsprofiltyper

   3. Öppna enhetsprofilen som nyligen lagts till för att redigera och ange XSP-FQDN och Device Access Protocol.

   4. Ändra mallarna enligt din miljö (se tabellen nedan).

   5. Spara profilen.

4. Klicka på Filer och autentisering och välj sedan alternativet att autentisera alla systemfiler.

Anpassa klienter i Control Hub

Det finns separata varumärkeskonfigurationer för stationära och mobila klienter, så du måste upprepa denna varumärkesprocess om du använder båda:

1. Logga in på Control Hub och gå till Konfiguration > klienter.

2. Leta upp området Branding på klientens konfigurationssida.

3. Uppdatera logotyp och primär navigeringsrad färg. Mer information finns i Lägg till ditt företags varumärke i Webex.

Användaraktiveringsportalen använder samma logotyp som du har lagt till för Klientaktivering.

Anpassa problemrapportering och hjälp-URL:er

Se https://help.webex.com/n0cswhcb "Anpassa varumärkes- och problemrapportering för kunder".