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.

• You may separate the other services/applications as required for your scale (dedicated device management XSP|ADP farm, for example).

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

• Do not install other applications or services on the XSP|ADPs that are used for integrating BroadWorks with 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.

Only one instance of the Xsi-Events applications should be deployed on the XSP|ADP used for the CTI interface.

All Xsi-Events used for integrating Broadworks with Webex must have the same callControlApplicationName defined under Applications/Xsi-Events/GeneralSettings. Till exempel:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

When a user is onboarded to Webex, Webex creates a subscription for the user on the AS in order to receive telephony events for presence and call history. The subscription is associated with the callControlApplicationName and the AS uses it to know to which Xsi-Events to send the telephony events.

Changing the callControlApplicationName, or not having the same name on all Xsi-Events webapps will impact subscriptions and telephony events functionality.

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 också som en alternativ autentiseringsmetod för autentiseringstjänsten. If you have multiple Webex organizations running off the same XSP|ADP server, you must use mTLS authentication because CI Token Validation does not support multiple connections to the same XSP|ADP Auth Service. 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örautentiseringstjänsten) .

Om du för närvarande använder mTLS för autentiseringstjänsten är det inte obligatoriskt att du konfigurerar om för att använda CI-tokenvalidering med TLS.

1. Obtaining OAuth credentials for your Webex for Cisco BroadWorks.

2. Install the following patches on each XSP|ADP 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

     AP.xsp.22.0.1123.ap368601

   • För R23:

     AP.xsp.23.0.1075.ap376509

     AP.platform.23.0.1075.ap376509

   • För R24 – ingen programfix krävs

   Any reference to XSP includes either XSP or ADP.

3. Install the AuthenticationService application on each XSP|ADP service.

   1. Run the following command to activate the AuthenticationService application on the XSP|ADP to the /authService context path.

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService

   2. Run this command to deploy the AuthenticationService on the XSP|ADP:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...

4. Starting with Broadworks build 2022.10, the certificates authorities that are coming with Java are no longer automatically included to the BroadWorks trust store when switching to a new version of java. The AuthenticationService opens a TLS connection to Webex to fetch the access token, and needs to have the following in its truststore to validate the IDBroker and Webex URL:

   • IdenTrusts kommersiella rot-CA 1

   • Go Daddy Root Certification Authority - G2

   Verify that these certificates are present under the following CLI

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

   If not present, run the following command to import the default Java trusts:

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

   Alternatively, you can manually add these certificates as trust anchors with the following command:

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

   If the ADP is upgraded from a previous release, then the certificate authorities from the old release are automatically imported to the new release and will continue to be imported until they are manually removed.

   The AuthenticationService application is exempt from the validatePeerIdentity setting under ADP_CLI/System/SSLCommonSettings/GeneralSettings, and always validates the peer Identity. See the Cisco Broadworks X509 Certificate Validation FD for more info on this setting.

5. Configure the Identity Providers by running the following commands on each XSP|ADP server:

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get

   • set clientId client-Id-From-Step1

   • ange aktiverat sant

   • set clientSecret client-Secret-From-Step1

   • ställ in ciResponseBodyMaxSizeInBytes 65536

   • set issuerName <URL>—For the URL, enter the IssuerName URL that applies to your CI Cluster. See following table.

   • set issuerUrl <URL>—For the URL, enter the IssuerUrl that applies to your CI Cluster. See the following table.

   • set tokenInfoUrl <IdPProxy URL>—Enter the IdP Proxy URL that applies to your Teams Cluster. See the second table that follows.

   Tabell 1. Set issuerName and issuerURL

   Om CI-kluster är...	Set issuerName and issuerURL to...
   USA – EN	https://idbroker.webex.com/idb
   EU	https://idbroker-eu.webex.com/idb
   USA–B	https://idbroker-b-us.webex.com/idb
   If you don't know your CI Cluster, you can obtain the information from the Customer details in Help Desk view of Control Hub.

   Tabell 2. Set tokenInfoURL

   Om Teams-klustret är...	Set tokenInfoURL to...(IdP Proxy URL)
   ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AFRA	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   If you don't know your Teams Cluster, you can obtain the information from the Customer details in the Help Desk view of Control Hub. For testing, you can verify that the tokenInfoURL is valid by replacing the "idp/authenticate" portion of the URL with "ping".

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

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user

7. Configure Identity Providers for Cisco Federation using the following commands on each XSP|ADP server:

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get

   • ställ in flsUrl https://cifls.webex.com/federation

   • ställ in uppdateringPeriodInMinutes 60

   • set refreshToken refresh-Token-From-Step1

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

   XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get

9. Configure Token Management using the following commands on each XSP|ADP server:

   • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

   • ange tokenIssuer BroadWorks

   • ställ in tokenDurationInHours 720

10. Generera och dela RSA-nycklar. You must generate keys on one XSP|ADP then copy them to all other XSP|ADPs. 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.

    If you cycle keys or change the key length, you need to repeat the following configuration and restart all the XSP|ADPs.

    1. Select one XSP|ADP to use for generating a key pair.

    2. Use a client to request an encrypted token from that XSP|ADP, by requesting the following URL from the client’s browser:

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

       (This generates a private / public key pair on the XSP|ADP, if there wasn’t one already)

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

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. Copy the exported file /var/broadworks/tmp/authService.keys to the same location on the other XSP|ADPs, overwriting an older .keys file if necessary.

    5. Import the keys on each of the other XSP|ADPs:

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys

11. Ange authService-URL:en till webbbehållaren. The XSP|ADP’s web container needs the authService URL so it can validate tokens. On each of the XSP|ADPs:

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

       XSP|ADP_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|ADP_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 presenterats som inloggningsuppgifter.

    3. Kontrollera parametern med hämta.

    4. Restart the XSP|ADP.

Ta bort autentiseringskravet för verifieringstjänsten (endast R24)

Om du har autentiseringstjänsten konfigurerad med CI-tokenvalidering på R24 måste du också ta bort kravet på klientautentisering 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 chiffer på 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 Server-gränssnitt = Mest specifikt

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

Reading HTTP Server TLS Interface Configuration on the XSP|ADP

1. Sign in to the XSP|ADP and navigate to XSP|ADP_CLI/Interface/Http/HttpServer>

2. Ange kommandot hämta 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.

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|ADP_CLI/Interface/Http/HttpServer> get

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

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. Sign in to the XSP|ADP and navigate to XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

2. Enter the command get <interfaceIp> 443 to see which protocols are already used on this interface.

3. Enter the command add <interfaceIp> 443 TLSv1.2 to ensure that interface can use TLS 1.2 when communicating with the cloud.

Redigera TLS-chifferkonfiguration i HTTP Server Interface

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

1. Sign in to the XSP|ADP and navigate to XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

2. Enter the command get <interfaceIp> 443 to see which ciphers are already used on this interface. There must be at least one from the Cisco recommended suites (see XSP|ADP Identity and Security Requirements in the Overview section).

3. Enter the command add <interfaceIp> 443 <cipherName> to add a cipher to the HTTP Server interface.

   The XSP|ADP CLI requires the IANA standard cipher suite name, not the openSSL cipher suite name. Om du exempelvis vill lägga till openSSL-chiffer ECDHE-ECDSA-CHACHA20-POLY1305 i HTTP-servergränssnittet använder du: XSP|ADP_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.

Configure Device Management on XSP|ADP, Application Server, and Profile Server

Profile Server and XSP|ADP are mandatory for Device Management. De måste konfigureras enligt anvisningarna i BroadWorks Device Management Konfigurationsguide.

Konfigurera programserver för CTI-prenumerationer

Uppdatera klientidentifiering på programservern med behörigheten vanligt namn (CN) för Webex för Cisco 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

The common name of the Webex for Cisco BroadWorks client certificate is bwcticlient.webex.com.

Konfigurera TLS och chiffer i CTI-gränssnittet

The levels of configurability for the XSP|ADP CTI interface are as follows:

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:

On a fresh install, the following ciphers are installed by default at the system level. If nothing is configured at the interface level (for example, at the CTI interface or HTTP interface), this cipher list applies. Note that this list may change over time: TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_DHE_DSS_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_DSS_WITH_AES_128_CBC_SHA256 TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256

Reading CTI TLS Interface Configuration on the XSP|ADP

1. Sign in to the XSP|ADP and navigate to XSP|ADP_CLI/Interface/CTI/CTIServer>

2. Ange kommandot hämta 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|ADP_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 till CTI-gränssnittet

The XSP|ADP CTI interface that is interacting with the Webex Cloud must be configured for 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. Sign in to the XSP|ADP and navigate to XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

2. Enter the command get <interfaceIp> to see which protocols are already used on this interface.

3. Enter the command add <interfaceIp> TLSv1.2 to ensure that interface can use TLS 1.2 when communicating with the cloud.

Redigera TLS-chifferkonfiguration i CTI Interface

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

1. Sign in to the XSP|ADP and navigate to XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

2. Ange kommandot hämta för att se vilka chiffer som redan används i det här gränssnittet. There must be at least one from the Cisco recommended suites (see XSP|ADP Identity and Security Requirements in the Overview section).

3. Enter the command add <interfaceIp> <cipherName> to add a cipher to the CTI interface.

   The XSP|ADP CLI requires the IANA standard cipher suite name, not the openSSL cipher suite name. Om du exempelvis vill lägga till openSSL-chiffer ECDHE-ECDSA-CHACHA20-POLY1305 i CTI-gränssnittet använder du: XSP|ADP_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 ett av filnamnen.

Trust Anchors for CTI Interface (R22 and later)

This procedure assumes the XSP|ADPs are either internet-facing or face the internet via pass-through proxy. Certifikatkonfigurationen är annorlunda för en bryggproxyn (se TLS-certifikatkrav för TLS-bridge-proxy).

For each XSP|ADP in your infrastructure that is publishing CTI events to Webex, do the following:

1. Logga in på Partner Hub.

2. Go to Settings > BroadWorks Calling and click Download Webex CA Certificate to get CombinedCertChain2023.txt on your local computer.

   These files contain two sets of two certificates. You need to split the files before you upload them to the XSP|ADPs. All files are required.

3. Split the certificate chain into two certificates - combinedcertchain2023.txt

   1. Open combinedcertchain2023.txt in a text editor.

   2. Välj och klipp ut det första textblocken, inklusive raderna -----BEGIN CERTIFICATE----- och -----END CERTIFICATE----- och klistra in textblocken ien ny fil.

   3. Save the new file as root2023.txt.

   4. Save the original file as issuing2023.txt. Originalfilen får nu endast ha ett textblock, som omges av raderna -----BEGIN CERTIFICATE----- och -----END CERTIFICATE-----.

4. Copy both text files to a temporary location on the XSP|ADP you are securing, e.g. /var/broadworks/tmp/root2023.txt and /var/broadworks/tmp/issuing2023.txt

5. Sign in to the XSP|ADP and navigate to /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

6. (Valfritt) Kör hjälpuppdateringTrust för att se parametrarna och kommandoformatet.

7. Upload the certificate files to new trust anchors - 2023

   XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt

   XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt

   All aliases must have a different name. webexclientroot2023, and webexclientissuing2023 are example aliases for the trust anchors; you can use your own as long as all entries are unique.

8. Bekräfta att ankarna är uppdaterade:

   XSP|ADP_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 klienter att autentisera med certifikat:

   XSP|ADP_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 R22 och R23:

     XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true

2. Replace the server certificate and key on the XSP|ADP's CTI interfaces. 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 R22 och R23:

     XSP|ADP_CLI/Interface/CTI/CTIServer> 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:

     XSP|ADP_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. Restart the XSP|ADP.

Aktivera åtkomst till BroadWorks CTI Events 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 partnerhubben för detaljerade anvisningar.

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

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

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

Användarupplevelse

• Windows-användare: Click Call Settings and then click Open Call Preferences > Advanced Call Settings.

• Mac-användare: Click profile picture, then Preferences > Advanced Call Settings.

Install Call Settings Webview on XSP|ADPs

CSWV application must be on the same XSP|ADP(s) that host the Xsi-Actions interface in your environment. It is an unmanaged application on XSP|ADP, so you need to install and deploy a web archive file.

1. Sign in to cisco.com and search for "BWCallSettingsWeb" in the software download section.

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

   For example, BWCallSettingsWeb_1.8.2_1.war ( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) was the most recent at the time of writing.

3. Install, activate, and deploy the web archive according to the Cisco BroadWorks Xtended Service Platform Configuration Guide for your XSP|ADP version. (R24-versionen är https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).

   1. Copy the .war file to a temporary location on the XSP|ADP, such as /tmp/.

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

      XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war

      BroadWorks-programvaruhanteraren validerar och installerar filen.

   3. [Optional] Delete /tmp/BWCallSettingsWeb_1.7.5_1.war (this file is no longer required).

   4. Aktivera programmet:

      XSP|ADP_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 vilket värde som helst som inte används av ett annat program, till exempel /samtalsinställningar.

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

      XSP|ADP_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|ADP-FQDN>/callsettings/

   Anteckningar:

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

   • The XSP|ADP-FQDN must match the Xsi-Actions FQDN, because CSWV needs to use Xsi-Actions, and CORS is not supported.

5. Repeat this procedure for other XSP|ADPs in your Webex for Cisco BroadWorks environment (if necessary).

The Call Settings Webview application is now active on the XSP|ADPs.

NPS-proxy, översikt

För att vara kompatibel med Webex för Cisco BroadWorks måste 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 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 push-servern för meddelanden att skicka meddelanden till Android-enheter via google Firebase Cloud Messaging (FCM) HTTPv1 API.

• Mer information finns i Push-servern för VoIP i UCaaS-beskrivning.

• The BroadWorks patches for the feature are available on: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.

  For NPS software and patches, see the section Prepare Your NPS for Webex for Cisco BroadWorks.

  Search and download the patch from the software download page.

• 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 BroadWorks-kluster

[en gång per kluster]

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

• To enable Webex cloud to authenticate your users against BroadWorks (via XSP|ADP-hosted authentication service).

• 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 (närvaro vid telefoni 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 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.

   If the admin user does not have visibility of the BroadWorks Calling settings, it is recommended that you must open a case with Cisco TAC.

3. Klicka på Lägg till kluster.

   This launches a wizard where you supply your XSP|ADP interfaces (URLs). 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.

   The cluster concept here is simply a collection of interfaces, typically collocated on an XSP|ADP server or farm, that enable Webex to read information from your Application Server (AS). You may have one XSP|ADP per AS cluster, or multiple XSP|ADPs per cluster, or multiple AS clusters per XSP|ADP. 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ör XSI-åtgärder och XSI Events.

7. Valfritt. Update the DAS URL with the URL of the Device Activation Service.

8. Valfritt. Check the Enable direct BroadWorks authentication check box if you want logins to BroadWorks to be direct to BroadWorks. Otherwise, authentication to BroadWorks is proxied through the Webex-hosted IdP proxy service.

   This check box affects these login situations:

   • User Activation Portal login—Users must enter their BroadWorks credentials when logging in to the portal. The above setting determines if the login is direct to BroadWorks or is through the IdP Proxy.

   • Client Login—If BroadWorks Authentication is configured in the Onboarding template, the above setting determines if client login to the Webex App is direct to BroadWorks or is proxied through the IdP Proxy.

9. Klicka på Nästa.

10. På CTI Interface-sidan gör du följande:

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

    2. Valfritt. Enable the Call History toggle and then enter your BroadWorks user ID. When this option is selected, BroadWorks call history events get synced to the Webex cloud. Användare kan visa sina samtalshistorik i Webex-appen.

    3. Valfritt. Enable the Do not disturb (DND) sync toggle and then enter your BroadWorks user ID. This option syncs DND events between Webex and BroadWorks, ensuring that the feature works the same on both platforms.

    4. Klicka på Nästa.

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

12. 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.

13. 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.

14. Klicka på Visa kluster så bör du se ditt nya kluster och om valideringen är framgångsrik.

15. 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. You can go back through the wizard as you configure your deployment, which may require modifications to your infrastructure (e.g. XSP|ADP, load balancer, or firewall) as documented in this guide, before you can save the template.

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.

5. Valfritt. Select a cluster if you want to see existing settings for that cluster, such as XSI-Actions, XSI-Events, DAS URL and the CTI interface settings.

Configure your Onboarding templates

Onboarding templates are the way that you will apply shared configuration to one or more customers as you onboard them via the provisioning methods. 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. Sign in to the Partner Hub and select Customers.

2. Click the Onboarding templates button to view the existing templates.

3. Click Create Template.

4. In the Template Details window, add the Template name, Country or Region and Default email Language.

5. Click the drop-down for the CCW Subscription ID, find the listed subscriptions for the partner, and select the applicable subscription.

   This field is shown only for partners migrated from Webex for BroadWorks to Webex.

6. In the Service Setting window, use the Cluster dropdown to choose the cluster you want to use with this template.

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

8. Konfigurera ditt etableringsläge med hjälp av de här rekommenderade inställningarna:

   Tabell 3. 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
   Enable BroadWorks Flow Through Provisioning (include provisioning account credentials if On**)	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	On†	On†	On†
   Tjänsteleverantörens 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). This email address identifies the administrator within your Partner organization who will be granted delegated admin access to any new customer organizations created with the Onboarding template.
   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. The organization country will determine the default global call-in numbers for Cisco PSTN in Webex Meeting Sites. Refer to the Country section of help page for more information.
   BroadWorks företagsläge är 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.

   • ** "Provisioning account" refers to the BroadWorks system-level admin account. On BroadWorks, you need an admin account with these attributes: Administrator Type=Provisioning, Read-only=Off.

9. Välj standardtjänstpaket för kunder som använder denna mall (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 partnerhubben.

10. Valfritt. Check Disable Cisco Webex Free Calling if you want to disable Webex Calls,.

11. Välj något av följande alternativ för Konfiguration av mötesdelta:

    • Cisco inringningsnummer (PSTN)

    • Partner-provided Call-in Numbers (BYoPSTN)—If you select this option, refer the Bring Your Own PSTN Solution Guide for Webex for Cisco BroadWorks for detailed information on how to configure this option.

12. Klicka på Nästa.

13. There are two approaches for provisioning subscribers with regards to how their identities are verified – using Trusted Emails or Untrusted Emails.

    In the Trusted Email workflow users provide email addresses to the partner who adds them in BroadWorks. You as a partner are responsible for provisioning the email address as part of either the flow-through or API method.

    It is highly recommended to use the Trusted provisioning method because it ensures that all subscribers are fully provisioned by you as a partner and there is no action required from the end users.

    In the Untrusted email case users need to verify their emails before provisioning, or users can self-activate themselves.

    In the Untrusted case there are several provisioning modes based on the verification settings in the table below:

    Tabell 4. Recommended User Verification Settings for Untrusted Provisioning Modes

    Inställningsnamn	Flowflödesetablering utan e-postmeddelanden	Självetablering av användare
    Provision Admin First	Rekommenderas*	Ej tillämpligt
    Tillåt att användare aktiverar sig själva	Ej tillämpligt	Obligatorisk

    • Anteckningar från tabellen:

    • * Each customer organization in Webex is required to have at least one user with administrator role. The first user to whom you assign Integrated IM&P in BroadWorks takes the customer administrator role if a new customer organization is created in Webex. As a Service Provider you may want to have control over who gets the role. Checking this setting blocks users from completing activation until the first user you provisioned is activated. 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.

14. Klicka på Nästa.

15. Select the default authentication mode (either BroadWorks Authentication or Webex Authentication) for user login to Webex.

    This setting has no effect on user login to the User Activation Portal. Users must use their BroadWorks user ID and password when logging in to the portal, irrespective of how the Onboarding template is configured.

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

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

16. Klicka på Nästa.

17. Under Inställningarkonfigurerar du följande:

    1. 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 dig möjlighet att vid behov ändra användare, men detta kan leda till inloggningsproblem.

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

       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.

    3. 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.

    4. Make sure the Allow admin-invite emails when attaching to existing orgs toggle is On (the default setting is On).

    5. Klicka på Nästa.

18. 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 alla uppgifter. Klicka på Skapa.

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

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

20. 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.

21. 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.

Patch Application Server (R22, R23, and R24 only)

1. If you haven't yet done so, apply the following patch that applies to your release:.

   • För R22: AP.as.22.0.1123.ap373197

   • För R23: AP.as.23.0.1075.ap373197

   • För R24: AP.as.24.0.944.ap384177

   For a complete list of BroadWorks patches that form the requirement for deploying Webex for Cisco BroadWorks, See BroadWorks Software Requirements in the Reference section.

2. Ändra till Underhåll/ContainerAlternativkontext.

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/denna grupps 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 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 ett helt kvalificerat namn för parametern provisioningURL som det 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 filen /etc/hosts 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 parametern provisioningURL som det 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 filen /etc/hosts 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.

User Provisioning Data

For information on the user data that gets exchanged between BroadWorks and Webex during user provisioning, see Service Provider User Provisioning.

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

Webex-appar är konfigurerade med DTAF-filer. The clients download a configuration XML file from the Application Server, via the Device Management service on the XSP|ADP.

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. Import DTAF files to BroadWorks at System > Resources > Identity/Device Profile Types

   3. Öppna enhetsprofilen som nyligen lagts till för redigering och:

      • Enter the XSP|ADP farm FQDN and Device Access Protocol.

      • Markera kryssrutan Support Remote Party Info. Denna support krävs för skrivbordsdelning ska fungera.

        Du kan också 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 profilen.

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

Customize Branding for Webex App

• Partner customizations—Partner administrators can apply advanced branding customizations that apply to the partner organization and/or customers that the partner manages. See Configure Advanced Branding Customizations.

• Customer customizations—If the partner allows customers to apply their own Branding customizations, customer administrators can follow the procedures at Add Your Company Branding to Webex.

The User Activation Portal uses the same logo that you add for client Branding.

Anpassa problemrapportering och hjälp-URL:er

To customize these options, administators can follow the procedure "Add Feedback and Help Site URLs", which can be found in both of the above Branding articles.