Distribuera Webex för Cisco Broad Works

Krav på sambosättning

• Autentiseringstjänsten måste vara sambosatt med Xsi-program, eftersom dessa gränssnitt måste acceptera långlivade tokens för tjänsteauktorisering. Autentiseringstjänsten krävs för att validera dessa tokens.

• Autentiseringstjänst och Xsi kan köras på samma port vid behov.

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

• Du kan samlokalisera Xsi-, CTI-, autentiseringstjänsten och DMS-programmen.

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

• Samlokalisera inte NPS-programmet med andra program.

Xsi-gränssnitt

Installera och konfigurera Xsi-Actions- och Xsi-Events-programmen enligt beskrivningen i Konfigurationsguiden för Cisco Broad Works Xtended Services Interface.

Endast en instans av Xsi-Events-programmen ska distribueras på XSP/ADP som används för CTI-gränssnittet.

Alla Xsi-Events som används för att integrera Broadworks med Webex måste ha samma namn för samtalskontroll som definieras under Program/Xsi-Events/Allmännainställningar. Till exempel:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

När en användare är inloggad på Webex skapar Webex en prenumeration för användaren på webben för att ta emot telefonhändelser för närvaro och samtalshistorik. Prenumerationen är associerad med namnet på samtalskontrollprogrammetoch AS använder det för att veta till vilken Xsi-Events för att skicka telefonhändelserna.

Om du ändrar namnet på programmet för samtalskontroll eller inte har samma namn på alla Xsi-Events-webbappar påverkar prenumerationer och telefonihändelser.

Konfigurera autentiseringstjänst (med validering av CI-token)

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

Ömsesidig TLS (mTLS) stöds också som en alternativ autentiseringsmetod för autentiseringstjänsten. Om du har flera Webex-organisationer som kör samma XSP-server måste du använda mTLS-autentisering eftersom validering av CI-token inte stöder flera anslutningar till samma XSP-autentiseringstjänst. För att konfigurera mTLS-autentisering för autentiseringstjänsten i stället för validering av CI-token, se Bilaga för Konfigurera tjänster (med mTLS för autentiseringstjänsten).

Om du för närvarande använder mTLS för auth-tjänsten är det inte obligatoriskt att du konfigurerar om för att använda validering av CI-token med TLS.

1. Hämta OAuth-inloggningsuppgifter för ditt Webex för Cisco Broad.

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

   • För 22 kr:

     AP.platform.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap368601

   • För 23 kr:

     AP.xsp.23.0.1075.ap376509

     AP.platform.23.0.1075.ap376509

   • För R24 – ingen patch krävs

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

   1. Kör följande kommando för att aktivera autentiseringstjänsteprogrammet på XSP till /auth-tjänstens kontextsökväg.

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

   2. Kör det här kommandot för att distribueraautentiseringstjänsten på XSP:

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

4. Från och med Broadworks-bygget 2022.10 ingår inte längre de certifikatmyndigheter som kommer med Java automatiskt i BroadWorks förtroendebutik när de byter till en ny version av java. Autentiseringstjänsten öppnar en TLS-anslutning till Webex för att hämta åtkomsttoken och måste ha följande i sin truststore för att validera IDB-rökaren och Webex-URL:

   • IdenTrusts kommersiella rot-CA 1

   • Go Daddy Root Certification Authority - G2

   Kontrollera att dessa certifikat finns under följande CLI

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

   Om det inte finns, kör du följande kommando för att importera standardbetrodda Java-betrodda:

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

   Alternativt kan du lägga till dessa certifikat manuellt som förtroendeankare med följande kommando:

   ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>

   Om ADP uppgraderas från en tidigare version importeras certifikatmyndigheterna från den gamla versionen automatiskt till den nya versionen och fortsätter att importeras tills de tas bort manuellt.

   Programmet för autentiseringService är undantaget från den validerade inställningen PeerIdentity under ADP_CLI/System/SSLC ommon-inställningar/allmännainställningar och validerar alltid peer-identiteten. Mer information om den här inställningen finns i Cisco Broadworks X509-certifikatvalidering FD.

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

   XSP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get

   • set clientId client-Id-From-Step1

   • set enabled true

   • set clientSecret client-Secret-From-Step1

   • set ciResponseBodyMaxSizeInBytes 65536

   • set issuerName <URL> – För URL, ange URL:en för utfärdarens namn som gäller för ditt CI-kluster. Se följande tabell.

   • set issuerUrl <URL> – För URL, ange URL:en för utfärdare som gäller för ditt CI-kluster. Se följande tabell.

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

   Tabell 1. Ange utgivarens namn och utgivarens URL

   Om CI-kluster är ...	Ange emittentens namn och emittentens URL till ...
   US-A	https://idbroker.webex.com/idb
   EU	https://idbroker-eu.webex.com/idb
   US-B	https://idbroker-b-us.webex.com/idb
   Om du inte känner till ditt CI-kluster kan du hämta informationen från kundinformationen i Help Desk-vyn i Control Hub.

   Tabell 2. Ange URL:en för token

   Om teamkluster är ...	Ange URL för token Info till ...(IDP-proxy-URL)
   AKM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AFRÅN	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   FÖRSTOPPNING	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   Om du inte känner till ditt Teams-kluster kan du hämta informationen från kundinformationen i Help Desk-vyn i Control Hub. För testning kan du verifiera att URL:en för token Info är giltig genom att ersätta ” idp/authenticate" del av URL:en med " ping".

6. Ange den Webex-behörighet som måste finnas i användarprofilen i Webex genom att köra följande kommando:

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

7. 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 refresh-Token-From-Step1

8. Kör följande kommando för att validera att din FLS-konfiguration fungerar. Detta kommando returnerar listan över identitetsleverantörer:

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

9. Konfigurera tokenhantering med följande kommandon på varje XSP-server:

   • XSP_CLI/Applications/AuthenticationService/TokenManagement>

   • set tokenIssuer BroadWorks

   • set tokenDurationInHours 720

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

    • Du måste använda samma offentliga/privata nyckelpar för token-kryptering/dekryptering i alla instanser av autentiseringstjänsten.

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

    Om du använder knappar eller ändrar nyckellängden måste du upprepa följande konfiguration och starta om alla XSP:er.

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

    2. Använd en klient för att begära en krypterad token från 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 fanns ett)

    3. Platsen för nyckellagring kan inte konfigureras. Exportera nycklarna:

       XSP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. Kopiera exporterad fil /var/broadworks/tmp/authService.keys till samma plats på de andra XSP:erna, skriva över en äldre .keys vid behov.

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

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

11. Ange autentiseringstjänstens URL till webbbehållaren. XSP:s webbbehållare behöver autentiseringstjänstens URL:en så att den kan validera tokens. På var och en av XSP:erna:

    1. Lägg till autentiseringstjänstens URL som en extern autentiseringstjänst för BroadWorks Communications Utility:

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

    2. Lägg till autentiseringstjänstens URL till behållaren:

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

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

    3. Kontrollera parametern med get.

    4. Starta om XSP.

Ta bort klientautentiseringskrav för autentiseringstjänst (endast R24)

Om du har autentiseringstjänsten konfigurerad med validering av CI-token på R24 måste du också ta bort klientautentiseringskravet för autentiseringstjänsten. Kör följande CLI-kommando:

ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false

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

Autentiseringstjänsten, Xsi-åtgärder och Xsi-Events-program använder HTTP-servergränssnitt. TLS-konfigurationsnivåer för dessa program är följande:

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

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

Läsa konfiguration av HTTP-serverns TLS-gränssnitt på XSP

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

2. Ange get kommando och läs 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.

Apache tomcat skickar ett certifikat för varje säkert gränssnitt. Systemet genererar ett självsignerat certifikat om det behöver ett.

XSP_CLI/Interface/Http/HttpServer> get

Lägga till TLS 1.2-protokoll i HTTP-servergränssnittet

HTTP-gränssnittet som interagerar med Webex Cloud 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 det här gränssnittet.

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

Redigera konfiguration av TLS-kryptering i HTTP-servergränssnittet

Så här konfigurerar du nödvändiga krypteringskoefficienter:

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 kryptrar som redan används i det här gränssnittet. Det måste finnas minst en från Ciscos rekommenderade sviter (se XSP-identitets- och säkerhetskrav i avsnittet Översikt).

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

   XSP CLI kräver IANA-standardnamnet på krypteringssviten, inte namnet på den öppnaSSL-krypteringssviten. Till exempel för att lägga till den öppnaSSL-krypteringen ECDHE-ECDSA-CHACHA20-POLY1305 i 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 båda namnen.

Konfigurera enhetshantering på XSP, programserver och profilserver

Profilserver och XSP är obligatoriska för enhetshantering. De måste konfigureras enligt anvisningarna i Broad konfigurationshandbok för enhetshantering.

Konfigurera programserver för CTI-prenumerationer

Uppdatera klientidentiteten på programservern med det gemensamma namnet (CN) för Webex för Cisco BroadWorks CTI-klientcertifikatet.

För varje programserver som du använder med Webex lägger du till certifikatidentiteten i klientidentiteten enligt följande:

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

Det vanliga namnet på Webex för Cisco BroadWorks-klientcertifikatet är bwcticlient.webex.com.

Konfigurera TLS och kryptering i CTI-gränssnittet

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

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

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

Vid en ny installation installeras följande kryptrar som standard på systemnivå. Om inget har konfigurerats på gränssnittsnivå (till exempel i CTI-gränssnittet eller HTTP-gränssnittet) gäller den här krypteringslistan. Observera att den här listan kan ändras över tid: TLS_ECDHE_RSA_MED_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_MED_AES_128_GCM_SHA256 TLS_ECDHE_RSA_MED_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_MED_AES_128_CBC_SHA256 TLS_DHE_DSS_MED_AES_128_GCM_SHA256 TLS_DHE_RSA_MED_AES_128_GCM_SHA256 TLS_DHE_RSA_MED_AES_128_CBC_SHA256 TLS_DHE_DSS_MED_AES_128_CBC_SHA256 TLS_ECDH_RSA_MED_AES_128_GCM_SHA256 TLS_ECDH_ECDSA_MED_AES_128_GCM_SHA256 TLS_ECDH_RSA_MED_AES_128_CBC_SHA256 TLS_ECDH_ECDSA_MED_AES_128_CBC_SHA256

Läsa konfiguration av CTI TLS-gränssnitt på XSP

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

2. Ange get kommando och läs 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.

   XSP_CLI/Interface/CTI/CTIServer> get
     Interface IP  Port  Secure  Server Certificate  Client Auth Req
   =================================================================
     10.155.6.175  8012    true                true             true
   

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

XSP CTI-gränssnittet som interagerar med Webex Cloud 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 i CTI-gränssnittet:

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

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

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

Redigera konfiguration av TLS-kryptering i CTI-gränssnittet

Så här konfigurerar du nödvändiga krypteringskoefficienter i CTI-gränssnittet:

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

2. Ange get kommando för att se vilka kryptrar som redan används i det här gränssnittet. Det måste finnas minst en från Ciscos rekommenderade sviter (se XSP-identitets- och säkerhetskrav i avsnittet Översikt).

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

   XSP CLI kräver IANA-standardnamnet på krypteringssviten, inte namnet på den öppnaSSL-krypteringssviten. Till exempel för att lägga till den öppnaSSL-krypteringen ECDHE-ECDSA-CHACHA20-POLY1305 i CTI-gränssnittet använder du: XSP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 Se https://ciphersuite.info/ för att hitta sviten med båda namnen.

Förtroendeankare för CTI-gränssnitt (R22 och senare)

Denna procedur förutsätter att XSP:erna antingen är internet-riktade eller riktade mot internet via passerproxy. Certifikatkonfigurationen är annorlunda för en bromsproxy (se TLS-certifikatkrav för TLS-broproxy).

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

1. Logga in på Partner Hub.

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

   Dessa filer innehåller två uppsättningar med två certifikat. Du måste dela filerna innan du överför dem till XSP:erna. Alla filer krävs.

3. Dela upp certifikatkedjan i två certifikat – combinedcertchain2023.txt

   1. Öppna combinedcertchain2023.txt i en textredigerare.

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

   3. Spara den nya filen som root2023.txt.

   4. Spara originalfilen som issuing2023.txt. Den ursprungliga filen bör nu endast ha ett textblock, omgiven av linjerna -----BEGIN CERTIFICATE----- och -----END CERTIFICATE-----.

4. Kopiera båda textfilerna till en tillfällig plats på den XSP som du säkrar, t.ex. /var/broadworks/tmp/root2023.txt och /var/broadworks/tmp/issuing2023.txt

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

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

7. Ladda upp certifikatfilerna till nya förtroendeankare – 2023

   XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt

   XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt

   Alla alias måste ha ett annat namn. webexclientroot2023 och webexclientissuing2023 är exempel alias för förtroendeankare; du kan använda dina egna så länge alla poster är unika.

8. Bekräfta att förankringarna uppdateras:

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

     Alias   Owner                                   Issuer
   =============================================================================
   webexclientissuing2023       Internal Private TLS SubCA      Internal Private Root
   webexclientroot2023       Internal Private Root      Internal Private Root[self-signed]

9. Tillåt att klienter autentiserar 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älvsignerat servercertifikat i gränssnittet och tvingar gränssnittet att kräva ett klientcertifikat.

   • På BroadWorks R22 och R23:

     XSP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true

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

   • På BroadWorks R22 och R23:

     XSP_CLI/Interface/CTI/CTIServer> get

     Kör sedan följande kommandon för att ersätta gränssnittets självsignerade certifikat med ditt eget certifikat och en privat nyckel:

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

3. Starta om XSP.

Aktivera åtkomst till BroadWorks CTI-händelser på 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 Partner Hub för detaljerade instruktioner.

• Ange den CTI-adress som Webex kan prenumerera på BroadWorks CTI Events.

• CTI-prenumerationer är per prenumerant och upprättas och underhålls endast medan prenumeranten tillhandahålls för Webex för Cisco BroadWorks.

Användarupplevelse

• Windows-användare: Klicka på Samtalsinställningar och klicka sedan Öppna samtalsinställningar > Avancerade samtalsinställningar.

• Mac-användare: Klicka på profilbild och sedan Inställningar > Avancerade samtalsinställningar.

Installera webbvy för samtalsinställningar på XSP:er

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 ohanterat program på XSP, så du måste installera och distribuera en webbarkivfil.

1. Logga in på cisco.com och sök efter ”BWCallainställningarwebben” i avsnittet för programvaruhämtning.

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

   Till exempel BWCeb_1.8.2_1.war (https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) var den senaste vid skrivtiden.

3. Installera, aktivera och distribuera webbarkivet enligt konfigurationsguiden för Cisco BroadWorks Xtended Service Platform för din XSP-version. (R24-versionen är https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).

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

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

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

      BroadWorks programvaruhanterare validerar och installerar filen.

   3. [Valfritt] Ta bort /tmp/BWCallSettingsWeb_1.7.5_1.war(den här filen krävs inte längre).

   4. Aktivera programmet:

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

      Namn och version är obligatoriska för alla program, men för CSWV måste du också tillhandahålla en kontextsökväg eftersom det är ett ohanterat program. Du kan använda något värde som inte används av ett annat program, till exempel /callsettings.

   5. Distribuera samtalsinställningsprogrammet på den valda kontextsökvägen:

      XSP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

4. Du kan nu förutsäga URL:en för samtalsinställningar som du kommer att ange för klienter på följande sätt:

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

   Anteckningar:

   • Du måste ange spårningslänken på den här URL:en när du anger den i klientkonfigurationsfilen.

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

5. Upprepa denna procedur för andra XSP:er i din Webex för Cisco Broad miljö (vid behov).

Webview-programmet för samtalsinställningar är nu aktivt på XSP:erna.

NPS-proxy-översikt

För kompatibilitet med Webex för Cisco BroadWorks måste din CNPS korrigeras för att stödja NPS-proxyfunktionen, Push Server för VoIP i UCaa.

Funktionen implementerar en ny design i meddelandepush-servern för att lösa säkerhetssårbarheten hos att dela privata nycklar med tjänsteleverantörer för mobila klienter. I stället för att dela certifikat och nycklar med tjänsteleverantören använder NPS ett nytt API för att erhålla en kortlivad push-aviseringstoken från Webex för Cisco 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 aviserings-push-servern att trycka på aviseringar till Android-enheter via den nya Google Firebase Cloud Messaging (FCM) HTTPv1 API.

• Mer information finns i Push-servern för VoIP i UC aaS-funktionsbeskrivning.

• BroadWorks-korrigeringar för funktionen är tillgängliga på: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.

  För NPS-programvara och korrigeringar, se avsnittet Förbered din NPS för Webex för Cisco Broad.

  Sök och hämta programvaruhämtningssidan.

• Mer information om ADP-servern finns på https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.

Konfigurera dina storakluster

[en gång per kluster]

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

• Aktivera Webex-molnet för att autentisera dina användare mot BroadWorks (via XSP-värdautentiseringstjänst).

• Så här aktiverar du Webex-appar för att använda Xsi-gränssnitt för samtalskontroll.

• Gör det möjligt för Webex att lyssna på CTI-händelser som publiceras av Broad Works (telefonnärvaro och samtalshistorik).

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 konfigurerat kluster kan orsaka problem som är svåra att lösa.

Vad du behöver göra:

1. Logga in på partnerhubben (admin.webex.com) med dina inloggningsuppgifter för partneradministratör.

2. Öppna sidan Inställningar från sidmenyn och hitta Allmänna 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 det här klustret och klicka på Nästa.

   Klusterkonceptet här är helt enkelt en samling gränssnitt, vanligtvis placerade på en XSP-server eller gård, som gör det möjligt för Webex att läsa information från din programserver (AS). Du kan ha en XSP per AS-kluster eller flera XSP per kluster eller flera AS-kluster per XSP. Skalkrav för ditt BroadWorks-system är utanför räckvidd här.

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

   Valideringstesterna kan använda det här kontot för att validera anslutningarna till gränssnitten i klustret.

6. Lägg till dina XSI-åtgärder och XSI-händelser URL:er.

7. Valfritt. Uppdatera DAS-URL med URL:en för enhetens aktiveringstjänst.

8. Valfritt. Markera kryssrutan Aktivera direkt Broad Works-autentisering om du vill att inloggningar till BroadWorks ska vara direkt till BroadWorks. Annars proxiseras autentisering till BroadWorks via proxytjänsten IDP som är värd för Webex.

   Den här kryssrutan påverkar dessa inloggningssituationer:

   • Inloggning i användaraktiveringsportalen – Användare måste ange sina inloggningsuppgifter för BroadWorks när de loggar in på portalen. Ovanstående inställning avgör om inloggningen är direkt till Broadfungerar eller via IDP-proxy.

   • Klientinloggning – Om Broad Works-autentisering har konfigurerats i kundmallen avgör ovanstående inställning om klientinloggning till Webex-appen är direkt till BroadWorks eller proxiseras via IDP-proxyn.

9. Klicka på Nästa.

10. Gör följande på CTI-gränssnittssidan:

    1. Lägg till CTI-URL och port för det CTI-gränssnitt som du vill ansluta till.

    2. Valfritt. Aktivera växlingen Samtalshistorik och ange sedan ditt användar-ID för BroadWorks. När det här alternativet är markerat synkroniseras händelser i samtalshistorik med Webex-molnet. Användare kan visa sin samtalshistorik i Webex-appen.

    3. Valfritt. Aktivera växlingsknappen Stör ej (Stör ej) och ange sedan ditt användar-ID för Broad Works. Det här alternativet synkroniserar Stör ej-händelser mellan Webex och BroadWorks, vilket säkerställer att funktionen fungerar på båda plattformarna.

    4. Klicka på Nästa.

11. Lägg till din autentiseringstjänst-URL.

12. Välj autentiseringstjänst med validering av CI-token.

    Det här alternativet kräver inte mTLS för att skydda anslutningen från Webex, eftersom autentiseringstjänsten korrekt validerar användartoken mot Webex identitetstjänsten innan den utfärdar den långlivade token till användaren.

13. Granska dina poster på den slutliga skärmen och klicka sedan på Skapa. Du bör se ett framgångsmeddelande.

    Partner Hub överför URL:erna till olika Webex-mikrotjänster som testar anslutningarna till de levererade gränssnitten.

14. Klicka på Visa kluster så ska du se ditt nya kluster och om valideringen lyckades.

15. Knappen Skapa kan inaktiveras på guiden:s sista skärm (förhandsgranskning). Om du inte kan spara mallen indikerar det ett problem med en av de integreringar som du just har konfigurerat.

    Vi har implementerat den här kontrollen för att förhindra fel i efterföljande uppgifter. Du kan gå tillbaka genom guiden när du konfigurerar distributionen, vilket kan kräva ändringar i din infrastruktur (t.ex. XSP, belastningsutjämning eller brandvägg) enligt dokumentationen i den här guiden, innan du kan spara mallen.

Kontrollera anslutningarna till dina bredaarbetsgränssnitt

1. Logga in på partnerhubben (admin.webex.com) med dina inloggningsuppgifter för partneradministratör.

2. Öppna sidan Inställningar från sidmenyn och hitta Allmänna samtalsinställningar.

3. Klicka på Visa kluster.

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

   När testerna är slutförda visas statusmeddelandet bredvid varje kluster på sidan med klusterlistan.

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

5. Valfritt. Välj ett kluster om du vill se befintliga inställningar för det klustret, t.ex. XSI-åtgärder, XSI-Events, DAS-URL och CTI-gränssnittsinställningar.

Konfigurera dina kundmallar

Kundmallar är det sätt som du kommer att tillämpa delad konfiguration på en eller flera kunder när du registrerar 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 som du behöver, men endast en mall kan kopplas till en kund.

1. Logga in på partnerhubben (admin.webex.com) med dina inloggningsuppgifter för partneradministratör.

2. Öppna sidan Inställningar från sidmenyn och hitta Allmänna samtalsinställningar.

3. Klicka på Lägg till mall.

   Detta startar en guide där du kan tillhandahålla konfiguration för kunder som använder den här mallen.

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

5. Ange ett mallnamn och klicka sedan på Nästa.

6. Konfigurera ditt etableringsläge med hjälp av följande rekommenderade inställningar:

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

   Inställningsnamn	Flöde genom etablering med betrodda e-postmeddelanden	Genomströmning av etablering utan e-post	Användarsjälvetablering
   Aktivera Broad Works Flow Through Provisioning (inkludera inloggningsuppgifter för etableringskonto om On**)	På Ange etablerings kontonamn och lösenord enligt BroadWorks-konfigurationen.	På Ange etablerings kontonamn och lösenord enligt BroadWorks-konfigurationen.	Av
   Skapa nya organisationer automatiskt i Control Hub	Den	Den	Den
   Tjänsteleverantörens e-postadress	Välj en e-postadress i listrutan (du kan skriva in vissa tecken för att hitta adressen om det är en lång lista). Den här e-postadressen identifierar administratören inom din partnerorganisation som kommer att ges delegerad administratörsåtkomst till alla nya kundorganisationer som skapats med kundmallen.
   Land	Välj vilket land du använder för den här mallen. Det land du väljer matchar kundorganisationer som skapas med den här mallen för en viss region. För närvarande kan regionen vara (EMEAR) eller (Nordamerika och resten av världen). Se kartläggningen av land till region i det här kalkylbladet. Organisationens land bestämmer de globala standardnumren för inringning för Cisco PSTN på Webex Meeting-webbplatser. Se avsnittet Land på hjälpsidan för mer information.
   BroadWorks företagsläge är aktivt	Aktivera detta om de kunder som du tillhandahåller med den här mallen är företag i BroadWorks. Om de är grupper lämnar du den här avstängningen. Om du har en blandning av företag och grupper i dina BroadWorks bör du skapa olika mallar för dessa olika fall.

   Anteckningar från tabellen:

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

     Detta bör alltid vara på, såvida du inte använder en manuell beställnings- och uppfyllningsprocess (via Cisco Commerce Workspace) för att skapa kundorganisationer i Webex (innan du börjar etablera användare i dessa organisationer). Detta alternativ kallas ofta "hybridetableringsmodellen" och omfattas inte av detta dokument.

   • ** ”Etableringskonto” avser administrationskonto på systemnivå för BroadWorks. I BroadWorks behöver du ett administratörskonto med följande attribut: Administratörstyp=Etablering, skrivskyddad=Av.

7. Välj standardtjänstepaketet för kunder som använder den här mallen (se Paket i avsnittet Översikt); antingen Basic, Standard, Premium eller Softphone.

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

8. Valfritt. Markera Inaktivera Cisco Webex-kostnadsfria samtal om du vill inaktivera Webex-samtal.

9. För Konfiguration av mötesdeltagande väljer du ett av följande alternativ:

   • Cisco-inringningsnummer (PSTN)

   • Inringningsnummer som tillhandahålls av partner (BY eller PSTN) – Om du väljer det här alternativet, se Ta med din egen PSTN-lösningsguide för Webex för Cisco Broad för detaljerad information om hur du konfigurerar det här alternativet.

10. Klicka på Nästa.

11. Det finns två tillvägagångssätt för att etablera prenumeranter när det gäller hur deras identiteter verifieras – med hjälp av betrodda e-postmeddelanden eller obetrodda e-postmeddelanden.

    I arbetsflödet Betrodd e-post ger användare e-postadresser till den partner som lägger till dem i Broadverk. Du som partner ansvarar för att etablera e-postadressen som en del av antingen flöde- eller API-metoden.

    Det rekommenderas starkt att använda den betrodda etableringsmetoden eftersom den säkerställer att alla prenumeranter är fullt etablerade av dig som partner och att inga åtgärder krävs från slutanvändarna.

    I fallet Obetrodda e-postmeddelanden måste användare verifiera sina e-postmeddelanden innan etablering, eller så kan användarna själva aktivera sig själva.

    I fallet Opålitlig finns det flera etableringslägen baserat på verifieringsinställningarna i tabellen nedan:

    Tabell 4. Rekommenderade inställningar för användarverifiering för obetrodda etableringslägen

    Inställningsnamn	Genomströmning av etablering utan e-post	Användarsjälvetablering
    Etablera administratör först	Rekommenderas*	Ej tillämpligt
    Tillåt att användare aktiverar sig själva	Ej tillämpligt	Obligatorisk

    • Anteckningar från tabellen:

    • * Varje kundorganisation i Webex måste ha minst en användare med administratörsroll. Den första användaren till vilken du tilldelar integrerat IM&P i BroadWorks tar rollen som kundadministratör om en ny kundorganisation skapas i Webex. Som tjänsteleverantör kanske du vill ha kontroll över vem som får rollen. Om du kontrollerar den här inställningen blockeras användare från att slutföra aktiveringen tills den första användaren som du har tillhandahållit är aktiverad. Om du avmarkerar den här inställningen blir den första användaren som blir aktiv i den nya organisationen kundadministratör.

12. Klicka på Nästa.

13. Välj standardautentiseringsläget (antingen BroadWorks-autentisering eller Webex-autentisering) för användarinloggning till Webex.

    Den här inställningen påverkar inte användarinloggning till användaraktiveringsportalen. Användare måste använda sitt användar-ID och lösenord för BroadWorks när de loggar in på portalen, oavsett hur kundmallen har konfigurerats.

    Den här inställningen kommer endast att tillämpas på nyskapade kundorganisationer. Om partneradministratörer försöker tillämpa en ny autentiseringsinställning på befintliga kundorganisationer tillämpas de befintliga inställningarna så att befintliga användare inte förlorar åtkomst. Om du vill ändra autentiseringsläget för befintliga kundorganisationer måste du öppna ett ärende med Cisco TAC.

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

14. Klicka på Nästa.

15. För Inställningar konfigurerar du följande:

    1. Välj om du vill fylla i användarnas e-postadresser på inloggningssidan.

       Du bör endast använda det här alternativet om du har valt Broad Works-autentisering och även har placerat användarens e-postadresser i Alternativt ID-attribut i BroadWorks. I annat fall måste de använda sitt användarnamn förBroad Works. Inloggningssidan ger ett alternativ för att ändra användare om det behövs, men detta kan leda till inloggningsproblem.

    2. Om du vill aktivera katalogsynkronisering ställer du in Aktivera telefonkatalogsynkronisering för alla nya kundorganisationer till På.

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

    3. Ange en partneradministratör.

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

    4. Kontrollera att växeln för etablering av befintliga organisationer är på (standardinställningen är på).

    5. Klicka på Nästa.

16. Granska dina poster på den slutliga skärmen. Du kan klicka på navigeringskontrollerna högst upp i guiden för att gå tillbaka och ändra alla detaljer. Klicka på Skapa.

    Du bör se ett framgångsmeddelande.

17. Klicka på Visa mallar så ska du se din nya mall listad med andra mallar.

18. Klicka på mallnamnet för att ändra eller ta bort mallen, om det behövs.

    Du behöver inte ange uppgifterna om etableringskontot igen. De tomma fälten för lösenordsbekräftelse finns där för att ändra inloggningsuppgifterna om du behöver det, men lämna dem tomma för att behålla de värden du gav guiden.

19. Lägg till fler mallar om du har olika delade konfigurationer som du vill tillhandahålla kunder.

    Håll sidan Visa mallar öppen, eftersom du kan behöva mallinformation för följande uppgift.

Programserver för programkorrigering (endast R22 och R23)

1. Om du ännu inte har gjort det ska du använda följande programfix som gäller för din version:

   • För 22 kr: AP.as.22.0.1123.ap373197

   • För 23 kr: AP.as.23.0.1075.ap373197

   • För 24 kr: AP.as.24.0.944.ap384177

   En fullständig lista över BroadWorks-korrigeringar som utgör kravet för att distribuera Webex för Cisco BroadWorks finns i Broad Works-programvarukrav i avsnittet Referens.

2. Ändra till Maintenance/ContainerOptions sammanhanget.

3. Aktivera parametern för etablerings-URL:

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

Hämta etablerings-URL:erna från partnerhubben

Se administrationsguiden för Cisco Broad Works Application Server Command Line Interface för mer information (Gränssnitt > Meddelanden och tjänst > Integrerat IM&P) om AS-kommandon.

1. Logga in på partnerhubben och gå till Inställningar > Allmänna samtal.

2. Klicka på Visa mallar.

3. Välj mallen som du använder för att tillhandahålla företagets/gruppens prenumeranter i Webex.

   Mallinformationen visas i en utflyktsruta till höger. Om du ännu inte har skapat en mall måste du göra det innan du kan hämta etableringens URL.

4. Kopiera URL:en till etableringsadaptern.

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

(Alternativ) Konfigurera systemövergripande etableringsparametrar på programservern

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

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

   1. AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL

   2. AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name

   3. AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password

   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 det fullständigt kvalificerade namnet för provisioningURL parametern, som den gavs 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 i AS.

(Alternativ) Konfigurera etableringsparametrar per företag på programservern

1. I användargränssnittet BroadWorks öppnar du det företag som du vill konfigurera och går till Tjänster > Integrerat IM&P.

2. Välj Använd tjänstedomän och ange ett dummy värde (Webex ignorerar den här parametern. Du kan använda example.com).

3. Välj Använd meddelandeserver.

4. I fältet URL klistrar du in etablerings-URL som du kopierade från din mall i Partner Hub.

   Du måste ange det fullständigt kvalificerade namnet för provisioningURL parametern, som den gavs 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 i AS.

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

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

7. För standardanvändaridentitet för IM&P-ID väljer du Primär.

8. Klicka på Verkställ.

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

Användaretableringsdata

Information om användardata som utbyts mellan BroadWorks och Webex under användaretablering finns i tjänsteleverantörens användaretablering.

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

Webex-appar konfigureras med DTAF-filer. Klienterna hämtar en XML-konfigurationsfil från programservern via enhetshanteringstjänsten på XSP.

1. Hämta 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 > Resurser > Enhetshanteringstaggar.

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 BroadSystem > Resurser > Identitets-/enhetsprofiltyper

   3. Öppna den nyligen tillagda enhetsprofilen för redigering och:

      • Ange XSP farm FQDN och protokoll för enhetsåtkomst.

      • Markera kryssrutan Support Remote Party Information. Detta stöd krävs för att skrivbordsdelning ska fungera.

        Du kan även aktivera Remote Party-support genom att köra följande CLI-kommando på programservern: AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

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

   5. Spara filen.

4. Klicka på Filer och Autentisering och välj sedan alternativet för att återskapa alla systemfiler.

Anpassa märkning för Webex-appen

• Partneranpassningar – Partneradministratörer kan tillämpa avancerade varumärkesanpassningar som gäller för partnerorganisationen och/eller kunder som partnern hanterar. Se Konfigurera avancerade varumärkesanpassningar.

• Kundanpassningar – Om partnern tillåter att kunder tillämpar sina egna varumärkesanpassningar kan kundadministratörer följa förfarandena på Lägg till ditt företags varumärkning i Webex.

Användaraktiveringsportalen använder samma logotyp som du lägger till för klientmärkning.

Anpassa URL:er för problemrapportering och hjälp

För att anpassa dessa alternativ kan administratörer följa proceduren ”Lägg till feedback och hjälp webbplats-URL:er”, som finns i båda ovanstående varumärkesartiklar.