Det är möjligt att vissa artiklar visar innehåll inkonsekvent. Ursäkta besväret medan vi uppdaterar webbplatsen.
cross icon
I den här artikeln
dropdown icon
Översikt över Webex för Cisco BroadWorks
    Introduktion till Webex för Cisco BroadWorks
    Så här går det till:
    Funktioner och begränsningar
    dropdown icon
    Begränsningar
      Gränser för meddelanden
    Säkerhet, data och roller
    Arkitekturen
    dropdown icon
    Beställning och etablering
      Nödvändiga programfixar med Flow-through Provisioning
    Migrering och framtida bevis på
    Rekommenderade dokumentprenumerationer
    Ytterligare dokument
dropdown icon
Förbered din miljö
    dropdown icon
    Beslutspunkter
      Arkitektur och infrastruktur
      Tillhandahållande av kunder och användare
      Språk som stöds
      Märkning
      Introduktionsmallar
      Flera partner är inte uppsypnade
      Provisioneringsadapter och mallar
    dropdown icon
    Minimikrav
      Konton
      Servrar som uppfyller dina nätverks- och programvarukrav
      Plattformar för Webex-app
      Fysiska telefoner och tillbehör
      Enhetsprofiler
      Hämta OAuth-autentiseringsuppgifter för din Webex för Cisco BroadWorks
    dropdown icon
    Beställningscertifikat
      Certifikatkrav för TLS-autentisering
      Ytterligare certifikatkrav för ömsesidig TLS-autentisering över CTI Interface
    dropdown icon
    Förbered ditt nätverk
      Nätverkskrav för Webex-tjänster
      Stöd för BroadWorks-redundans
dropdown icon
Distribuera Webex för BroadWorks
    Distributionsöversikt
    Partner onboarding för Webex för Cisco BroadWorks
    dropdown icon
    Konfigurera tjänster på din Webex för Cisco BroadWorks XSP|ADP:er
      Xsi-gränssnitt
      Konfigurera autentiseringstjänsten (med CI-tokenvalidering)
      Konfigurera TLS och chiffer på HTTP-gränssnitten (för XSI- och autentiseringstjänsten)
      Konfigurera enhetshantering på XSP|ADP, programserver och profilserver
    CTI-gränssnitt och relaterad konfiguration
    Webbvisning för samtalsinställningar
    Distribuera CSWV på BroadWorks
    Konfigurera Webex-appen så att den använder webbvyn för samtalsinställningar
    dropdown icon
    Konfigurera samtals push-meddelanden i Webex för Cisco BroadWorks
      Överväganden vid APNS
      Förbered NPS för Webex för Cisco BroadWorks
      Konfigurera NPS för att använda autentiseringsproxy
      Migrera NPS till FCMv1
    Konfigurera din partnerorganisation i partnerhubben
    Konfigurera programserver med URL för tillhandahållande tjänst
    Kontroll API för partner före etablering
    SSO-partner – SAML
    SSO för partner – OpenID Connect (OIDC)
    Aktivera identifierare för samtalskorrelation
    Directory Sync
    dropdown icon
    Enhetlig samtalshistorik
      Indikation på visuell skräppost
    dropdown icon
    Statussynkronisering för personlig assistent
      Förutsättningar
      Aktivera statussynkronisering för personlig assistent (nytt kluster)
      Aktivera statussynkronisering för personlig assistent (befintligt kluster)
      Inaktivera statussynkronisering för personlig assistent
    Nummerpresentation och omdirigering av samtal
    dropdown icon
    Välj inringar-ID
      Ytterligare funktioner
      Förutsättningar
      BroadWorks-korrigeringar
      Konfiguration av Webex-appen
    Utseende på delad linje
    dropdown icon
    Synkronisera stör ej (Do Not Disturb, DND)
      Förutsättningar
      Tysta timmar
    Samtalsinspelning
    dropdown icon
    Aktivera röstbrevlåda för Microsoft Teams-integrering
      Krav
    Grupp-samtalsparkering och hämta
    Ingripande
    Lokalt mobilsamtal eskalera till möte
    E911-nödsamtal
    Anpassa och tillhandahålla klienter
    Konfigurera din testorganisation för Webex för Cisco BroadWorks
    Användartest
dropdown icon
Hantera Webex för BroadWorks
    Tillhandahållande kundorganisationer
    Provisione-användare
    dropdown icon
    Flytta Webex-användare till Webex för Cisco BroadWorks
      Flytta användare (med samtycke) till Webex för Cisco BroadWorks
      Bifoga Webex för BroadWorks till befintlig organisation
      Ta bort Webex för BroadWorks från befintlig organisation
    dropdown icon
    Hantera användare och organisationer
      Verifiera användarreservering med e-postmeddelanden som inte är betrodda
      Ändra användar-ID eller e-postadress
      Ändra användarpaket i partnerhubben
      Ta bort användare
      Ta bort organisation
    Avbryta en prenumeration från Control Hub
    Versionshantering
    dropdown icon
    Konfigurera om systemet
      Redigera eller ta bort ett BroadWorks-kluster i partnerhubben
      Redigera eller ta bort en registreringsmall i partnerhubben
    Webex Assistant
    Inaktivera Webex-samtal
    Inaktivera video- eller skärmdelning i samtal
    Meddelande om fältet för upptagetlampa/samtalshämtning
    Slido Integrationsstöd
    Webex-tillgänglighet: I ett kalendermöte
    Automatiskt svar med ton
    Öka kapaciteten
    Hantera HTTP-servercertifikat
    dropdown icon
    Begränsat av partner-läge
      Åtkomst till kundadministratör
      Begränsningar
      Aktivera Begränsat av partner-läge
    Partneranalys
    API:er för faktureringsrapport
    dropdown icon
    Felsöka Webex för Cisco BroadWorks
      Support
dropdown icon
Referens för Webex för BroadWorks
    Jämförelse av UC-One SaaS med Webex för Cisco BroadWorks
    Installera Webex och logga in (prenumerantens perspektiv)
    dropdown icon
    Data exchange och lagring
      tjänsteleverantör registrering
      tjänsteleverantör tillhandahållande av användare
      Användarborttagning
      Användarinloggning och konfigurationshämtning
      Delstatsanvändning
    Använda API:n för tillhandahållande
    BroadWorks-programvarukrav
    BroadWorks-taggar krävs för Webex
    Användareablerings- och aktiveringsflöden
    SSO inloggningsflöde
    Användarinteraktioner
    Klientinteraktioner
    Riktlinjer för test och labb
    Uppspelning av röstbrevlåda
    Terminologi
dropdown icon
Tillägg
    Konfigurera tjänster (med mTLS för autentiseringstjänsten)
    dropdown icon
    Ytterligare certifikatkrav för ömsesidig TLS-autentisering mot AuthService
      Certifikatkrav för ömsesidig TLS-certifiering för TLS-bryggproxy
      Gemensamma TLS-certifikatkrav för TLS-passoxy eller XSP i DMZ
      Revisionshistorik för dokument

Webex för Cisco BroadWorks lösningsguide

list-menuI den här artikeln
list-menuHar du feedback?

Syftet med Webex för Cisco BroadWorks solution Guide är att göra det till administratörer på partnernivå. I guiden beskrivs hur du installerar och distribuerar Webex för Cisco BroadWorks. Webex för Cisco BroadWorks tillhandahåller BroadWorks-samtalskunder med Webex-samarbetsfunktioner. Prenumeranter använder ett enda program (Webex-appen) för att dra nytta av funktionerna från båda plattformarna.

Distribuera Webex för BroadWorks

Distributionsöversikt

Följande diagram visar den typiska ordningen för dina distributionsuppgifter för de olika lägena för användaretablering. Många av uppgifterna är gemensamma för alla etableringslägen.

Shows the order of tasks required for deploying Webex for BroadWorks with flow-through provisioning and trusted emails
Uppgifter som krävs för distribution av genomflödesetablering
Shows the order of tasks required for deploying Webex for BroadWorks with flow-through provisioning without emails
Uppgifter som krävs för distribution av genomflödesetablering utan betrodda e-postmeddelanden
Shows the order of tasks required for deploying Webex for BroadWorks with self-activation
Uppgifter som krävs för att distribuera användarens självetablering

Partnerregistrering för Webex för Cisco BroadWorks

Varje Webex för Cisco BroadWorks-tjänsteleverantör eller -återförsäljare måste konfigureras som en partnerorganisation för Webex för Cisco BroadWorks. Om du har en befintlig Webex-partnerorganisation kan detta användas.

För att slutföra nödvändig registrering måste du utföra ditt Webex Cisco BroadWorks-pappersarbete och nya partner måste godkänna det indirekta kanalpartneravtalet (ICPA) online. När dessa steg har slutförts skapar Cisco-efterlevnad en ny partnerorganisation i partnerhubben (vid behov) och skickar ett e-postmeddelande med autentiseringsuppgifter till administratören för posten i ditt pappersarbete. Samtidigt kommer din partneraktivering och/eller Customer Success Program Manager att kontakta dig för att påbörja registreringen.

Webex-partner i en region kan skapa kundorganisationer i alla regioner som vi erbjuder tjänsterna. Om du behöver hjälp, se: Datahemvist i Webex.

Konfigurera tjänster på din Webex för Cisco BroadWorks XSP|ADP:er

Vi kräver att NPS-programmet körs på en annan XSP|ADP. Kraven för XSP|ADP beskrivs i Konfigurera samtalsaviseringar från ditt nätverk.

Du behöver följande program/tjänster på dina XSP|ADP:er.

Tjänst/ansökan

Autentisering krävs

Tjänste-/användningsändamål

Xsi-händelser

TLS (servern autentiserar sig för klienter)

Samtalskontroll, tjänsteaviseringar

Xsi-åtgärder

TLS (servern autentiserar sig för klienter)

Samtalskontroll, åtgärder

Enhetshantering

TLS (servern autentiserar sig för klienter)

Hämta samtalskonfiguration

Verifieringstjänst

TLS (servern autentiserar sig för klienter)

Användarautentisering

Integrering av datortelefoni

mTLS (klient och server autentiserar varandra)

Telefoninärvaro

Webbvyprogram för samtalsinställningar

TLS (servern autentiserar sig för klienter)

Visar användarens samtalsinställningar i självhjälpsportalen i Webex-appen

Det här avsnittet beskriver hur du tillämpar de nödvändiga konfigurationerna för TLS och mTLS på dessa gränssnitt, men du bör hänvisa till befintlig dokumentation för att få programmen installerade på dina XSP|ADP:er.

Krav för samhemvist

  • Autentiseringstjänsten måste vara sambaserad med Xsi-program eftersom dessa gränssnitt måste acceptera långvariga token för tjänsteauktorisering. Autentiseringstjänsten krävs för att validera 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 (till exempel dedikerad enhetshantering XSP|ADP-gård).

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

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

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

Xsi-gränssnitt

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

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

Alla Xsi-händelser som används för att integrera BroadWorks med Webex måste ha samma callControlApplicationName som definieras under Program/Xsi-Events/GeneralSettings. Till exempel:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> hämta

callControlApplicationName = com.broadsoft.xsi-events

När en användare registreras i Webex skapar Webex en prenumeration för användaren på AS för att ta emot telefonihändelser för närvaro och samtalshistorik. Prenumerationen är kopplad till callControlApplicationName och AS använder den för att veta vilka Xsi-Events som ska skicka telefonihändelserna.

Om du ändrar callControlApplicationName eller inte har samma namn i alla Xsi-Events-webbappar påverkas prenumerationer och telefonihändelsefunktioner.

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

Använd den här proceduren för att konfigurera autentiseringstjänsten att använda CI-tokenvalidering 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örs på samma XSP|ADP-server måste du använda mTLS-autentisering eftersom CI-tokenvalidering inte stöder flera anslutningar till samma XSP|ADP-autentiseringstjänst.

För att konfigurera mTLS-autentisering för autentiseringstjänsten i stället för validering av CI-token, se bilagan för Konfigurera tjänster (med mTLS för autentiseringstjänsten).

Om 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. Hämta OAuth-autentiseringsuppgifter för din Webex för Cisco BroadWorks.

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

    Alla referenser till XSP inkluderar antingen XSP eller ADP.

  3. Installera programmet AuthenticationService på varje XSP|ADP-tjänst.

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

      XSP|ADP_CLI/Maintenance/ManagedObjects> aktivera programautentiseringstjänst 22.0_1.1123/authService
    2. Kör det här kommandot för att distribuera autentiseringstjänsten på XSP|ADP:

      XSP|ADP_CLI/Maintenance/ManagedObjects> distribuera program /authServiceBroadWorks SW Manager distribuerar /authService...
  4. Från och med BroadWorks version 2022.10 inkluderas inte certifikatutfärdare som kommer med Java automatiskt i BroadWorks förtroendearkiv vid byte 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 IDBroker- och Webex-URL:en:

    • IdenTrust kommersiell rot CA 1

    • Go Daddy Root Certification Authority - G2

    Kontrollera att dessa certifikat finns under följande CLI

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> hämta

    Om det inte finns kan du köra följande kommando för att importera Java-standardförtroenden:

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importeraJavaCATrust

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

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

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

    Programmet AuthenticationService är undantagen från validatePeerIdentity-inställningen under ADP_CLI/System/SSLCommonSettings/GeneralSettings och validerar alltid peer-identiteten. Se Cisco Broadworks X509 Certificate Validation FD för mer information om den här inställningen.

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

    XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> hämta

    • ställ in klientId klient-ID-från-steg1

    • ställ in aktiverad sant

    • ställ in clientSecret client-Secret-From-Step1

    • ställ in ciResponseBodyMaxSizeInBytes 65536

    • ställ in issuerName <URL> – För URL anger du URL:en för utfärdarnamnet som gäller för ditt CI-kluster. Se följande tabell.

    • ställ in issuerUrl <URL> – För URL anger du den utfärdareUrl som gäller för ditt CI-kluster. Se följande tabell.

    • ställ in tokenInfoUrl <IdPProxy URL> – Ange IdP-proxyadressen som gäller för ditt Teams-kluster. Se den andra tabellen som följer.

    Tabell 1. Ange utfärdarnamn och utfärdarURL
    Om CI-kluster är...Ställ in issuerName och issuerURL på ...

    amerikansk-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. Ställ in tokeninfoURL
    Om Teams-kluster är ...Ställ in tokenInfoURL till... (IdP-proxy-URL)

    akm

    https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate

    Afra (olika betydelser)

    https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate

    Aore (olika betydelser)

    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 kontrollera att tokenInfoURL:en är giltig genom att ersätta ”idp/autentisera”-delen av URL:en med ”ping”.

  6. Ange det Webex-berättigande som måste finnas i användarprofilen i Webex genom att köra följande kommando:

    XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> inställt område broadworks-anslutning:användare

  7. Konfigurera identitetsleverantörer för Cisco Federation med hjälp av följande kommandon på varje XSP|ADP-server:

    XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> hämta

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

    • ställ in uppdateringPeriodInMinutes 60

    • ställ in uppdateringstoken uppdatera-token-från-steg1

  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> Hämta

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

    • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

    • ställ in tokenUtfärdare BroadWorks

    • ställ in tokenDurationInHours 720

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

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

    • Nyckelparet genereras av autentiseringstjänsten när det först krävs för att utfärda en token.

    Om du cyklar nycklar eller ändrar nyckellängden måste du upprepa följande konfiguration och starta om alla XSP|ADP:er.

    1. Välj en XSP|ADP 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|ADP genom att begära följande URL från klientens webbläsare:

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

      (Detta genererar ett privat/offentligt nyckelpar på XSP|ADP, om det inte redan fanns en)

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

      XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exporteraNycklar

    4. Kopiera den exporterade filen /var/broadworks/tmp/authService.keys till samma plats på de andra XSP|ADPs och skriv vid behov över en äldre .keys-fil.

    5. Importera nycklarna till var och en av de andra XSP|ADP:

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

  11. Ange autentiseringstjänstens URL till webbbehållaren. XSP|ADP:s webbbehållare behöver autentiserings-URL:en så att den kan validera token. På var och en av XSP|ADP:

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

      XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> ställ in url http://127.0.0.1:80/authService

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

      XSP|ADP_CLI/Maintenance/ContainerOptions> lägg till tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService

      Detta gör att Webex kan använda autentiseringstjänsten för att validera token som visas som autentiseringsuppgifter.

    3. Kontrollera parametern med get.

    4. Starta om XSP|ADP.

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

Om du har autentiseringstjänsten konfigurerad med CI-tokenvalidering 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> ställ in <interfaceIp> <port> AuthenticationService clientAuthReq false

Konfigurera TLS och chiffer på HTTP-gränssnitten (för XSI- och autentiseringstjänsten)

Autentiseringstjänsten, Xsi-Actions- och Xsi-Events-programmen använder HTTP-servergränssnitt. Nivåerna för TLS-konfigurationen 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:

Särdrag CLI-sammanhang
System (globalt)

XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers>

XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols>

Transportprotokoll för det här systemet

XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers>

XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols>

HTTP på det här systemet

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/Ciphers>

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/Protocols>

Specifika HTTP-servergränssnitt på det här systemet

XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

Läser in HTTP-serverns TLS-gränssnittskonfiguration på XSP|ADP

  1. Logga in på XSP|ADP och navigera till XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Ange kommandot get 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|ADP_CLI/Interface/Http/HttpServer> hämta

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

HTTP-gränssnittet som interagerar med Webex-molnet 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|ADP och navigera till XSP|ADP_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 lägg till <interfaceIp> 443 TLSv1.2 för att säkerställa att gränssnittet kan använda TLS 1.2 vid kommunikation med molnet.

Redigera konfigurationen av TLS-chiffer i HTTP-servergränssnittet

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

  1. Logga in på XSP|ADP och navigera till XSP|ADP_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 av Ciscos rekommenderade paket (se XSP|ADP-krav för identitet och säkerhet i avsnittet Översikt).

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

    XSP|ADP CLI kräver standardnamnet för IANA-krypteringssviten, inte namnet på openSSL-krypteringssviten. Om du till exempel vill lägga till openSSL-chiffren ECDHE-ECDSA-CHACHA20-POLY1305 i HTTP-servergränssnittet använder du: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>lägg till 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Se https://ciphersuite.info/ för att hitta sviten efter båda namnen.

Konfigurera enhetshantering på XSP|ADP, programserver och profilserver

Profilserver och XSP|ADP är obligatoriska för enhetshantering. De måste konfigureras enligt anvisningarna i Konfigurationsguide för BroadWorks Device Management.

CTI-gränssnitt och tillhörande konfiguration

Konfigurationsordningen för ”närmaste till närmaste” visas nedan. Det är inte obligatoriskt att följa denna beställning.

  1. Konfigurera programserver för CTI-prenumerationer

  2. Konfigurera XSP|ADP:er för mTLS-autentiserade CTI-prenumerationer

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

  4. Prenumerera på din Webex-organisation på BroadWorks CTI Events

Konfigurera programserver för CTI-prenumerationer

Uppdatera ClientIdentity på programservern med det vanliga 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 certifikatets identitet i ClientIdentity enligt följande:

AS_CLI/System/ClientIdentity> lägg till bwcticlient.webex.com

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

Konfigurera TLS och chiffer i CTI-gränssnittet

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

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

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

Särdrag

CLI-sammanhang

System (globalt)

(R22 och senare)

XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers>

XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols>

Transportprotokoll för det här systemet

(R22 och senare)

XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers>

XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols>

Alla CTI-gränssnitt på det här systemet

(R22 och senare)

XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers>

XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols>

Ett specifikt CTI-gränssnitt för det här systemet

(R22 och senare)

XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Chiffer>

XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols>

Vid en ny installation installeras följande chiffer som standard på systemnivå. Om ingenting är konfigurerat på gränssnittsnivå (till exempel i CTI-gränssnittet eller HTTP-gränssnittet) gäller den här krypteringslistan. Observera att listan kan ändras över tid:

  • 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

Läser in CTI TLS-gränssnittskonfiguration på XSP|ADP

  1. Logga in på XSP|ADP och navigera till XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Ange kommandot get 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 i CTI-gränssnittet

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

  1. Logga in på XSP|ADP och navigera till XSP|ADP_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 lägg till <interfaceIp> TLSv1.2 för att säkerställa att gränssnittet kan använda TLS 1.2 vid kommunikation med molnet.

Redigera konfigurationen av TLS-chiffer i CTI-gränssnittet

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

  1. Logga in på XSP|ADP och navigera till XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Chiphers>

  2. Ange kommandot get för att se vilka chiffer som redan används i det här gränssnittet. Det måste finnas minst en av Ciscos rekommenderade paket (se XSP|ADP-krav för identitet och säkerhet i avsnittet Översikt).

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

    XSP|ADP CLI kräver standardnamnet för IANA-krypteringssviten, inte namnet på openSSL-krypteringssviten. Om du till exempel vill lägga till openSSL-chiffren ECDHE-ECDSA-CHACHA20-POLY1305 i CTI-gränssnittet använder du: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Chiphers> lägg till 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Se https://ciphersuite.info/ för att hitta sviten efter båda namnen.

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

Denna procedur förutsätter att XSP|ADPs antingen är internetvänd eller möter internet via en passthrough-proxy. Certifikatkonfigurationen är annorlunda för en bryggande proxy (se TLS-certifikatkrav för TLS-bryggproxy).

Gör följande för varje XSP|ADP i din infrastruktur som publicerar CTI-händelser till Webex:

  1. Logga in på partnerhubben.

  2. Gå till Inställningar > BroadWorks Calling 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 upp filerna innan du överför dem till XSP|ADP:erna. Alla filer är obligatoriska.

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

    1. Öppna combinedcertchain2023.txt i en textredigerare.

    2. Välj och klipp ut det första textblocket, inklusive raderna ------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 ska nu bara ha ett textblock omgivet av raderna -----BEGIN CERTIFICATE----- och ------END CERTIFICATE-----.

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

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

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

  7. Överför certifikatfilerna till nya förtroendeankare – 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

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

  8. Bekräfta att förankringarna har uppdaterats:

    XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

     Alias Ägare Utfärdare ============================================================================= webexclientissuing2023 Intern privat TLS SubCA Intern privat rot webexclientroot2023 Intern privat rot Intern privat rot[självsignerad]
  9. Tillåt att klienter autentiserar med certifikat:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> ställ in allowClientApp true

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

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

    CLI-sammanhanget 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|ADP_CLI/Interface/CTI/CTIServer> lägg till <Interface IP> 8012 true true true

  2. Ersätt servercertifikatet och -nyckeln på CTI-gränssnitten för XSP|ADP. Du behöver CTI-gränssnittets IP-adress för detta. Du kan läsa den från följande kontext:

    • På BroadWorks R22 och R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> hämta

      Kör sedan följande kommandon för att ersätta gränssnittets självsignerade 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. Starta om XSP|ADP.

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 partnerhubben. Detaljerade anvisningar finns i Konfigurera din partnerorganisation i Partner Hub.

Du måste lägga till och validera CTI-gränssnittet när du konfigurerar dina kluster i partnerhubben. Detaljerade anvisningar finns i Konfigurera din partnerorganisation i Partner Hub.

  • Ange den CTI-adress som Webex kan prenumerera på BroadWorks CTI-händelser.

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

Webbvy för samtalsinställningar

Webbvy för samtalsinställningar (CSWV) är ett program som finns på XSP|ADP så att användare kan ändra sina BroadWorks-samtalsinställningar via en webbvy som de ser i klienten. Se Cisco BroadWorks Samtalsinställningar Webview Solution Guide.

Webex använder den här funktionen för att ge användare åtkomst till vanliga BroadWorks-samtalsinställningar som inte är inbyggda i Webex-appen.

Om du vill att dina Webex för Cisco BroadWorks-prenumeranter ska få åtkomst till samtalsinställningar utöver standardinställningarna som är tillgängliga i Webex-appen måste du distribuera webbvisningsfunktionen för samtalsinställningar.

Webbvyn för samtalsinställningar har två komponenter:

  • Webbvyprogram för samtalsinställningar som finns på en Cisco BroadWorks XSP|ADP.

  • Webex-appen, som visar samtalsinställningarna i en webbvy.

Användarupplevelse

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

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

Distribuera CSWV på BroadWorks

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

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

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

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

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

  3. Installera, aktivera och distribuera webbarkivet enligt Cisco BroadWorks Xtended Service Platform Configuration Guide för din 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. Kopiera .war-filen till en tillfällig plats på XSP|ADP, t.ex. /tmp/.

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

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

      BroadWorks programhanterare 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|ADP_CLI/Maintenance/ManagedObjects> aktivera program 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 ohanterat program. Du kan använda valfritt värde 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> distribuera program/samtalsinställningar

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

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

    Anteckningar:

    • Du måste ange efterföljande snedstreck på denna URL när du anger den i klientkonfigurationsfilen.

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

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

Webbvyprogrammet Samtalsinställningar är nu aktivt på XSP|ADP:er.

Konfigurera Webex-appen så att den använder webbvyn för samtalsinställningar

Mer information om klientkonfiguration finns i Webex för Cisco BroadWorks konfigurationsguide.

Det finns en anpassad tagg i konfigurationsfilen för Webex-appen som du kan använda för att ställa in CSWV-URL:en. Denna URL visar samtalsinställningarna för användarna via programgränssnittet.

<config> <services> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>

I konfigurationsmallen för Webex-appen på BroadWorks konfigurerar du CSWV-URL i taggen %WEB_CALL_SETTINGS_URL_WXT%.

Om du inte uttryckligen anger URL:en är standardinställningen tom och sidan för samtalsinställningar är inte synlig för användarna.

  1. Se till att du har de senaste konfigurationsmallarna för Webex-appen (se Enhetsprofiler).

  2. Ställ in webbsamtalsinställningarna på csw:

    %WEB_CALL_SETTINGS_TARGET_WXT% csw

  3. Ställ in webbsamtalsinställningarna för din miljö, till exempel:

    %WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/

    Du härledde detta värde när du distribuerade CSWV-programmet.

  4. Den resulterande klientkonfigurationsfilen ska ha en post som följer:

    <web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>

    Alla referenser till XSP inkluderar antingen XSP eller ADP.

Konfigurera samtalspush-aviseringar i Webex för Cisco BroadWorks

I det här dokumentet använder vi termen Call Notifications Push Server (CNPS) för att beskriva ett XSP-värdbaserat eller ADP-värdbaserat program som körs i din miljö. Din CNPS fungerar med ditt BroadWorks-system för att vara medveten om inkommande samtal till dina användare och skickar aviseringar till aviseringstjänsterna i Google Firebase Cloud Messaging (FCM) eller Apple Push Notification Service (APN).

Dessa tjänster meddelar Webex mobila enheter för Cisco BroadWorks-prenumeranter att de har inkommande samtal på Webex.

Mer information om NPS finns i funktionsbeskrivning för aviseringspush-server.

En liknande mekanism i Webex fungerar med Webex meddelande- och närvarotjänster för att skicka aviseringar till aviseringstjänsterna Google (FCM) eller Apple (APNS). Dessa tjänster meddelar i sin tur de mobila Webex-användarna om inkommande meddelanden eller närvaroändringar.

I det här avsnittet beskrivs hur du konfigurerar NPS för autentiseringsproxy när NPS inte redan har stöd för andra appar. Om du behöver migrera en delad NPS för att använda NPS-proxy, se Uppdatera Cisco BroadWorks NPS för att använda NPS-proxy https://help.webex.com/nl5rir2/.

Översikt över NPS-proxy

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

Funktionen implementerar en ny design i aviseringspush-servern för att lösa säkerhetsrisken med att dela privata nycklar för push-aviseringscertifikat med tjänstleverantörer för mobila klienter. I stället för att dela push-aviseringscertifikat och nycklar med tjänsteleverantören använder NPS ett nytt API för att hämta en kortvarig 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 aviseringspush-servern att skicka aviseringar till Android-enheter via det nya Google Firebase Cloud Messaging (FCM) HTTPv1 API.

APNS-överväganden

Apple kommer inte längre att stödja det HTTP/1-baserade binära protokollet på Apple Push Notification-tjänsten efter den 31 mars 2021. Vi rekommenderar att du konfigurerar din XSP|ADP för att använda det HTTP/2-baserade gränssnittet för APN. Den här uppdateringen kräver att din XSP|ADP som är värd för NPS kör R22 eller senare.

Förbered din NPS för Webex för Cisco BroadWorks

1

Installera och konfigurera en dedikerad XSP (lägsta version R22) eller Application Delivery Platform (ADP).

2

Installera NPS-autentiseringsproxy-patchar:

3

Aktivera programmet för aviseringspush-server.

4

(För Android-aviseringar) Aktivera FCM V1 API på NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> ställ in V1Enabled true

5

(För Apple iOS-aviseringar) Aktivera HTTP/2 på NPS.

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> ställ in HTTP2Enabled true

Detta gäller endast version 22 och tidigare versioner. Det är inte tillgängligt i version 23 och senare versioner, som endast har stöd för HTTP/2.

6

Bifoga en techsupport från NPS XSP/ADP.

7

På varje AS-server måste namedefs-filen i /usr/local/broadworks/bw_base/conf konfigureras med SRV och A-poster för sökning efter aviseringspush-server (XSP/ADP). Om flera XSP/ADP lägger du sedan till en post för var och en efter behov.

Exempel: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa208.vle.broadsoft.com qa208.vle.broadsoft.com I A 10.193.78.149

När inställningen är klar krävs ett av följande för att ändringarna ska kunna hämtas:

  1. En omstartbw förbereds i ett underhållsfönster.

  2. Via Cisco BroadWorks CLI:

    R24 och äldre

    AS_CLI/ASDiagnostisk/DNS> läs in igen

    r25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> läs in igen

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> läs in igen

Nästa steg

För nya installationer av en NPS går du till Konfigurera NPS för att använda autentiseringsproxy

Om du vill migrera en befintlig Android-distribution till FCMv1 går du till Migrera NPS till FCMv1

Konfigurera NPS att använda autentiseringsproxy

Den här uppgiften gäller för en ny installation av NPS dedikerad till Webex för Cisco BroadWorks.

Om du vill konfigurera autentiseringsproxy på en NPS som delas med andra mobilappar, se Uppdatera Cisco BroadWorks NPS till att använda NPS-proxy (https://help.webex.com/nl5rir2).

1

Hämta OAuth-autentiseringsuppgifter för din Webex för Cisco BroadWorks.

2

Skapa klientkontot på NPS:

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> ställ in clientId klient-Id-Från-Steg1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> ställ in clientSecret Nytt lösenord: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> ställ in RefreshToken Nytt lösenord: Refresh-Token-From-Step1

Om du vill kontrollera att värdena som du har angett stämmer överens med vad du har fått kör du XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

CiscoCI-utfärdarurl ska ALLTID vara US CI-kluster oavsett plats och standardinställningen ska vara:

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

3

Ange NPS-proxy-URL och ange uppdateringsintervall för token (30 minuter rekommenderas):

XSP|ADP_CLI/Applications/NotificationPushServer/CloudNPSService> ställ in url https://nps.uc-one.broadsoft.com/nps/

XSP|ADP_CLI/Applications/NotificationPushServer/CloudNPSService> ställ in VOIPTokenRefreshInterval 1800

4

(För Android-aviseringar) Lägg till Android-program-ID i FCM-programkontext på NPS.

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

5

(För Apple iOS-aviseringar) Lägg till program-ID i APNS programkontext och se till att utelämna autentiseringsnyckeln – ställ in den som tom.

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

6

Konfigurera följande NPS-URL:er:

XSP|ADP CLI-sammanhang

Parameter

Värde

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

autentiserings-URL

https://www.googleapis.com/oauth2/v4/token

pushURL

https://fcm.googleapis.com/v1/projects/PROJECT-ID/messages:send

omfattning

https://www.googleapis.com/auth/firebase.messaging

  • XSP|ADP_CLI/Applications/NotificationPushServer

    /APNS/Produktion>

url

https://api.push.apple.com/3/device

7

Konfigurera följande NPS-anslutningsparametrar till de rekommenderade värdena som visas:

XSP|ADP CLI-sammanhang

Parameter

Värde

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTidToLiveInSeconds

3600

anslutningPoolStorlek

10

anslutningTimeoutInMillisekunder

3600

anslutningPassivTimeoutInSekunder

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Produktion>

tidsgräns för anslutning

3 000

anslutningPoolStorlek

2

anslutningPassivTimeoutInSekunder

600

8

Kontrollera om programservern kontrollerar program-ID:n eftersom du kan behöva lägga till Webex-apparna i listan över tillåtna:

  1. Kör AS_CLI/System/PushNotification> get och kontrollera värdet på enforceAllowedApplicationList. Om det är sant måste du slutföra den här underuppgiften. Annars hoppar du över resten av underuppgiften.

  2. AS_CLI/System/PushNotification/AllowedApplications> lägg till com.cisco.wx2.android ”Webex Android”

  3. AS_CLI/System/PushNotification/AllowedApplications> lägg till com.cisco.squared ”Webex iOS”

9

Starta om XSP|ADP: bwrestart

10

Testa samtalsaviseringar genom att ringa samtal från en BroadWorks-abonnent till två Webex-mobilanvändare. Kontrollera att samtalsaviseringen visas på iOS- och Android-enheter.

Migrera NPS till FCMv1

Det här ämnet innehåller valfria procedurer som du kan använda i Google FCM-konsolen när du har en befintlig NPS-distribution som du behöver migrera till FCMv1. Det finns tre procedurer:

Migrera UC-One-klienter till FCMv1

Använd stegen nedan i Google FCM-konsolen för att migrera UC-One-klienter till Google FCM HTTPv1.

  1. Logga in på FCM Admin SDK på http://console.firebase.google.com.

  2. Välj lämpligt Android-program.

  3. På fliken Allmänt registrerar du projekt-ID:t

  4. Navigera till fliken tjänstkonton för att konfigurera ett tjänstkonto. Du kan skapa ett nytt tjänstkonto eller konfigurera ett befintligt.

    Så här skapar du ett nytt tjänstkonto:

    1. Klicka på den blå knappen för att skapa ett nytt tjänstkonto

    2. Klicka på den blå knappen för att generera en ny privat nyckel

    3. Hämta nyckel till en säker plats

    Så här återanvänder du ett befintligt tjänstkonto:

    1. Klicka på den blå texten för att visa befintliga tjänstkonton.

    2. Identifiera tjänstkontot som ska användas. Tjänstkontot kräver behörighet firebaseadmin-sdk.

    3. Till höger klickar du på hamburgarmenyn och skapar en ny privat nyckel.

    4. Hämta json-filen som innehåller nyckeln och spara den på en säker plats.

  5. Kopiera json-filen till XSP|ADP.

  6. Konfigurera projekt-ID och:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> lägg till <projektid> <path/to/json-key-file> ...Klar XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> hämta kontonyckel för projekt-ID ======================== mitt_projekt ********
  7. Konfigurera programmet:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> lägg till <app-id> projektId <projekt id> ...Klar XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> hämta program-ID Projekt-ID ============================== mitt_app mitt_projekt
  8. Aktivera FCMv1:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> ställ in V1Enabled true ...Klar
  9. Kör kommandot bwrestart för att starta om XSP|ADP.

Migrera SaaS-klienter till FCMv1

Använd stegen nedan på Google FCM-konsolen om du vill migrera SaaS-klienter till FCMv1.

Se till att du redan har slutfört proceduren ”Konfigurera NPS för att använda autentiseringsproxy”.

  1. Inaktivera FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> ställ in V1Enabled false ...Klar
  2. Kör kommandot bwrestart för att starta om XSP|ADP.

  3. Aktivera FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> ställ in V1Enabled true ...Klar
  4. Kör kommandot bwrestart för att starta om XSP|ADP.

Uppdatera ADP-server

Använd nedanstående steg i Google FCM-konsolen om du migrerar NPS för att använda en ADP-server.

  1. Hämta JSON-filen från Google Cloud Console:

    1. Gå till sidan Tjänstkonton i Google Cloud Console.

    2. Klicka på Välj ett projekt, välj ditt projekt och klicka på Öppna.

    3. Hitta raden för det tjänstkonto som du vill skapa en nyckel för, klicka på den vertikala knappen Mer och klicka sedan på Skapa nyckel.

    4. Välj en nyckeltyp och klicka på Skapa

      Filen hämtas.

  2. Lägg till FCM till ADP-servern:

    1. Importera JSON-filen till ADP-servern med kommandot /bw/install.

    2. Logga in på ADP CLI och lägg till projekt- och API-nyckeln:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> lägg till anslutning /bw/install/google JSON :

    3. Lägg sedan till programmet och nyckeln:

      ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Klar

    4. Verifiera konfigurationen:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Projekt-ID Kontonyckel ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Program-ID Projekt-ID ==================================== com.broadsoft.ucaas.connect connect-ucaas

Konfigurera din partnerorganisation i Partner Hub

Konfigurera dina BroadWorks-kluster

[en gång per kluster]

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

  • Gör det möjligt för Webex-molnet att autentisera dina användare mot BroadWorks (via autentiseringstjänsten XSP|ADP-värd).

  • Gör det möjligt för Webex-appar att använda Xsi-gränssnitt för samtalskontroll.

  • För att göra det möjligt för Webex att lyssna efter CTI-händelser som publiceras av BroadWorks (telefoninärvaro och samtalshistorik).

Klusterguiden validerar automatiskt gränssnitten när du lägger till dem. Du kan fortsätta 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 partneradministratörsuppgifter.

  2. Öppna sidan Inställningar i sidomenyn och hitta inställningar för BroadWorks Calling.

    Om administratörsanvändaren inte har synlighet för BroadWorks Calling-inställningarna rekommenderar vi att du måste öppna ett ärende med Cisco TAC.

  3. Klicka på Lägg till kluster.

    Detta öppnar en guide där du tillhandahåller dina XSP|ADP-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, vanligtvis placerade på en XSP|ADP-server eller på en gård, som gör det möjligt för Webex att läsa information från din programserver (AS). Du kan ha ett XSP|ADP per AS-kluster eller flera XSP|ADP per kluster eller flera AS-kluster per XSP|ADP. Skalkrav för ditt BroadWorks-system är inte tillämpliga här.

  5. (Valfritt) Ange ett kontonamn och lösenord för BroadWorks-användare som du vet finns i det BroadWorks-system som du ansluter till Webex och klickar 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 URL:er för XSI-åtgärder och XSI-händelser.

  7. Valfritt. Uppdatera DAS-URL med URL:en till enhetsaktiveringstjänsten.

  8. Valfritt. Markera kryssrutan Aktivera direkt BroadWorks-autentisering om du vill att inloggningar till BroadWorks ska vara direkt till BroadWorks. Annars proxyeras autentisering till BroadWorks via den Webex-värdbaserade IdP-proxytjänsten.

    Den här kryssrutan påverkar följande inloggningssituationer:

    • Inloggning i användaraktiveringsportal – användare måste ange sina BroadWorks-autentiseringsuppgifter när de loggar in på portalen. Inställningen ovan avgör om inloggningen är direkt till BroadWorks eller går via IdP-proxyn.

    • Klientinloggning – om BroadWorks-autentisering har konfigurerats i registreringsmallen avgör ovanstående inställning om klientinloggningen till Webex-appen är direkt till BroadWorks eller proxyeras via IdP-proxyn.

  9. Klicka på Nästa.

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

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

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

    3. Valfritt. Aktivera Stör ej synkronisering och ange sedan ditt användar-ID för BroadWorks. Det här alternativet synkroniserar DND-händelser mellan Webex och BroadWorks, så att funktionen fungerar likadant på båda plattformarna.

    4. Klicka på Nästa.

  11. Lägg till URL:en till autentiseringstjänsten.

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

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

  13. Granska dina poster på den sista skärmen och klicka sedan på Skapa. Du bör se ett meddelande om framgång.

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

  14. Klicka på Visa kluster för att se ditt nya kluster och om valideringen lyckades.

  15. Knappen Skapa kan vara inaktiverad på guidens sista skärm (förhandsgranskning). Om du inte kan spara mallen indikerar det ett problem med någon av de integreringar som du just har konfigurerat.

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

Kontrollera anslutningarna till dina BroadWorks-gränssnitt

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

  2. Öppna sidan Inställningar i sidomenyn och hitta inställningar för BroadWorks Calling.

  3. Klicka på Visa kluster.

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

    När testerna har slutförts visar sidan för klusterlista ett statusmeddelande bredvid varje kluster.

    Du bör se gröna framgångsmeddelanden. Om du ser ett rött felmeddelande klickar du på det påverkade 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, till exempel XSI-Actions, XSI-Events, DAS URL och CTI-gränssnittsinställningar.

Konfigurera dina mallar för introduktion

Registreringsmallar är det sätt på vilket du tillämpar delad konfiguration för 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 bara en mall kan kopplas till en kund.

  1. Logga in på partnerhubben och välj Kunder.

  2. Klicka på knappen Registreringsmallar för att visa de befintliga mallarna.

  3. Klicka på Skapa mall.

  4. I fönstret Mallinformation lägger du till mallnamnet, landet eller regionen och standardspråk för e-post.

  5. Klicka på listrutan för CCW-prenumerations-ID, hitta de listade prenumerationerna för partnern och välj tillämplig prenumeration.

    Det här fältet visas endast för partner som har migrerats från Webex för BroadWorks till Webex.

  6. I fönstret Tjänsteinställning använder du listrutan Kluster för att välja det kluster som du vill använda med den här mallen.

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

  8. Konfigurera etableringsläget med följande rekommenderade inställningar:

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

    Inställningsnamn

    Genomflödesetablering med betrodda e-postmeddelanden

    Genomflödesetablering utan e-post

    Användares självetablering

    Aktivera BroadWorks-flöde genom etablering (inkludera inloggningsuppgifter för etableringskonto om detta är Aktiverat**)

    Ange kontonamn och lösenord för tillhandahållande enligt BroadWorks-konfigurationen.

    Ange kontonamn och lösenord för tillhandahållande 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 några 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 beviljas delegerad administratörsåtkomst till alla nya kundorganisationer som skapas med registreringsmallen.

    Land

    Välj vilket land du använder för den här mallen.

    Landet du väljer matchar kundorganisationer som skapas med den här mallen med en viss region. För närvarande kan regionen vara (EMEAR) eller (Nordamerika och resten av världen). Se mappningar av land till region i det här kalkylbladet.

    Organisationslandet fastställer de globala standardnumren för inringning för Cisco PSTN på Webex Meetings-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 växeln avstängd.

    Om du har en blandning av företag och grupper i dina 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 prenumerants e-postdomän inte matchar en befintlig Webex-organisation.

      Detta bör alltid vara aktiverat, såvida du inte använder en manuell beställnings- och uppfyllandeprocess (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 för ”Hybrid-etablering”-modellen och omfattas inte av detta dokument.

    • ** ”Reserveringskonto” avser BroadWorks administratörskonto på systemnivå. På BroadWorks behöver du ett administratörskonto med följande attribut: Administratörstyp=Etablering, Skrivskyddad=Av.

  9. Välj standardtjänstpaketet 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 partnerhubben.

  10. Valfritt. Markera Inaktivera Cisco Webex Free Calling om du vill inaktivera Webex-samtal.

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

    • Cisco inringningsnummer (PSTN)

    • Partnertillhandahållna inringningsnummer (BYoPSTN) – om du väljer detta alternativ, se Ta med din egen PSTN-lösningsguide för Webex för Cisco BroadWorks för detaljerad information om hur du konfigurerar detta alternativ.

  12. Klicka på Nästa.

  13. Det finns två metoder för att etablera prenumeranter när det gäller hur deras identiteter verifieras – med hjälp av betrodda e-postmeddelanden eller ej betrodda e-postmeddelanden.

    I arbetsflödet för betrodd e-post anger användare e-postadresser till partnern som lägger till dem i BroadWorks. Du som partner ansvarar för att tillhandahålla e-postadressen som en del av antingen flödes- eller API-metoden.

    Vi rekommenderar starkt att du använder den betrodda etableringsmetoden eftersom den säkerställer att alla prenumeranter tillhandahålls fullt ut av dig som partner och att inga åtgärder krävs från slutanvändarna.

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

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

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

    Inställningsnamn

    Genomflödesetablering utan e-post

    Användares självetablering

    Etablera administratör först

    Rekommenderad*

    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 som du tilldelar integrerad IM&P i BroadWorks tar kundadministratörsrollen om en ny kundorganisation skapas i Webex. Som tjänsteleverantör kanske du vill ha kontroll över vem som får rollen. Om du markerar den här inställningen blockeras användare från att slutföra aktiveringen tills den första användaren som du etablerade har aktiverats. Om du avmarkerar den här inställningen blir kundadministratören den första användaren som blir aktiv i den nya organisationen.

  14. Klicka på Nästa.

  15. 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ändarinloggningen 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 registreringsmallen är konfigurerad.

    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 åtkomsten. Om du vill ändra autentiseringsläget för befintliga kundorganisationer måste du öppna ett ärende hos Cisco TAC.

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

  16. Klicka på Nästa.

  17. Konfigurera följande för Inställningar:

    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 BroadWorks-autentisering och även har angett användarnas e-postadresser i attributet för alternativt ID i BroadWorks. Annars måste de använda sitt BroadWorks-användarnamn. Inloggningssidan ger 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 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 automatiserade e-postmeddelandet från Webex som uppmanar användare att validera sina e-postadresser.

    4. Se till att växlingsknappen Tillåt e-postinbjudningar från administratör när bifogan till befintliga organisationer är På (standardinställningen är På).

    5. Klicka på Nästa.

  18. Granska dina poster på den sista skärmen. Du kan klicka på navigeringskontrollerna överst i guiden för att gå tillbaka och ändra eventuella detaljer. Klicka på Skapa.

    Du bör se ett meddelande om framgång.

  19. Klicka på Visa mallar så visas din nya mall med alla andra mallar.

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

    Du behöver inte ange informationen om reserveringskontot på nytt. De tomma fälten för lösenordsbekräftelse/lösenordsbekräftelse finns där för att ändra autentiseringsuppgifterna om du behöver, men lämna dem tomma för att behålla de värden du gav guiden.

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

Konfigurera programserver med URL för etableringstjänst

Den här uppgiften krävs endast för flöde genom etablering.

Programserver för programfixar (endast R22, R23 och R24)

  1. Om du inte redan har gjort det ska du tillämpa följande programfix som gäller för din version:.

    En fullständig lista över BroadWorks-programfixar som utgör kraven för att distribuera Webex för Cisco BroadWorks finns i BroadWorks programvarukrav i referensavsnittet.

  2. Ändra till kontexten Maintenance/ContainerOptions.

  3. Aktivera parametern för etablerings-URL:

    /AS_CLI/Maintenance/ContainerOptions> lägg till etablering bw.imp.useProvisioningUrl true

Hämta etablerings-URL(er) från partnerhubben

Se Administrationsguide för kommandoradsgränssnitt för Cisco BroadWorks Application Server för mer information (Gränssnitt > Meddelanden och tjänster > Integrerad IM&P) för AS-kommandon.

  1. Logga in på partnerhubben och gå till Inställningar > BroadWorks Calling.

  2. Klicka på Visa mallar.

  3. Välj den mall som du använder för att etablera det här företagets/gruppens prenumeranter i Webex.

    Informationen om mallen visas i en flygplanspanel till höger. Om du ännu inte har skapat en mall måste du göra det innan du kan få etablerings-URL:en.

  4. Kopiera URL till etableringsadaptern.

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

(Alternativ) Konfigurera parametrar för systemomfattande etablering på programservern

Du kanske inte vill ställa in en systemomfattande reserverings- 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> ställ in provisioningUrl provisioningURL

    2. AS_CLI/Interface/Messaging> ställ in provisioningUserId provisioning_account_name

    3. AS_CLI/Interface/Messaging> ställ in provisioningPassword provisioning_account_password

    4. AS_CLI/Interface/Messaging> ställ in enableSynchronization true

  2. Aktivera det integrerade IMP-gränssnittet:

    1. /AS_CLI/Service/IntegratedIMP> ställ in serviceDomain example.com

    2. /AS_CLI/Service/IntegratedIMP/DefaultAttribute> ställ in userAttrIsActive true

Du måste ange det fullständigt kvalificerade namnet för parametern provisioningURL, som det har angetts i Control Hub. Om programservern inte kan komma åt DNS för att lösa värdnamnet måste du skapa mappningen i /etc/hosts-filen på AS.

(Alternativ) Konfigurera parametrar för företagsetablering på programservern

  1. Öppna företaget som du vill konfigurera i BroadWorks-gränssnittet och gå till Tjänster > Integrerad IM&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 fältet URL klistrar du in etablerings-URL:en som du kopierade från mallen i partnerhubben.

    Du måste ange det fullständigt kvalificerade namnet för parametern provisioningURL, som det har angetts i partnerhubben. Om programservern inte kan komma åt DNS för att lösa värdnamnet måste du skapa mappningen i /etc/hosts-filen på AS.

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

  6. Ange ett lösenord för etableringsadministratören. Detta måste matcha värdet i 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.

Data om användaretablering

Mer information om användardata som utbyts mellan BroadWorks och Webex under användaretablering finns i Användaretablering via tjänsteleverantör.

Kontroll API för partner före etablering

API:et för kontroll före etablering hjälper administratörer och säljteam genom att kontrollera om det finns fel innan du reserverar en kund eller prenumerant för ett paket. Användare eller integreringar som godkänts av en användare med rollen fullständig partneradministratör kan använda detta API för att säkerställa att det inte förekommer några konflikter eller fel med paketetableringen för en viss kund eller prenumerant.

API kontrollerar om det finns konflikter mellan den här kunden/prenumeranten och befintliga kunder/prenumeranter på Webex. API kan till exempel felsöka om prenumeranten redan har etablerats för en annan kund eller partner, om e-postadressen redan finns för en annan prenumerant eller om det finns konflikter mellan etableringsparametrarna och det som redan finns i Webex. Detta ger dig möjlighet att åtgärda dessa fel innan du etablerar, vilket ökar sannolikheten för framgångsrik etablering.

Mer information om API finns i: Webex för grossistutvecklarguide

Om du vill använda API går du till: Förhandskontrollera etablering av grossistprenumerant

För att komma åt förhandsgranskningen av ett dokument för tillhandahållande av grossistprenumeranter måste du logga in på https://developer.webex.com/ portal.

SSO-partner – SAML

Gör det möjligt för partneradministratörer att konfigurera SAML SSO för nyskapade kundorganisationer. Partner kan konfigurera en enda fördefinierad SSO-relation och tillämpa den konfigurationen på de kundorganisationer som de hanterar samt på sina egna anställda.

Nedanstående steg för partner-SSO gäller endast för nyskapade kundorganisationer. Om partneradministratörer försöker lägga till partner-SSO i en befintlig kundorganisation behålls den befintliga autentiseringsmetoden för att förhindra att befintliga användare förlorar åtkomst.

  1. Kontrollera att tredjepartsidentitetsleverantören uppfyller de krav som anges i avsnittet Krav för identitetsleverantörer i Integrering med enkel inloggning i Control Hub.

  2. Ladda upp CI-metadatafil som har identitetsleverantör.

  3. Konfigurera en registreringsmall. För inställningen Autentiseringsläge väljer du Partnerautentisering. För IDP-enhets-ID anger du enhets-ID från tredjepartsidentitetsleverantörens SAML-metadata-XML.

  4. Skapa en ny användare i en ny kundorganisation som använder mallen.

  5. Mycket att användaren kan logga in.

SSO för partner – OpenID Connect (OIDC)

Gör det möjligt för partneradministratörer att konfigurera OIDC SSO för nyskapade kundorganisationer. Partner kan konfigurera en enda fördefinierad SSO-relation och tillämpa den konfigurationen på de kundorganisationer som de hanterar samt på sina egna anställda.

Nedanstående steg för att konfigurera partner-SSO OIDC gäller endast för nyskapade kundorganisationer. Om partneradministratörer försöker ändra standardautentiseringstypen till partner-SSO OIDC i ett befintligt tempel kommer ändringarna inte att gälla för de kundorganisationer som redan är registrerade med hjälp av mallen.

  1. Öppna en tjänstebegäran med Cisco TAC med informationen om OpenID Connect IDP. Följande är obligatoriska och valfria IDP-attribut. TAC måste konfigurera IDP på CI och tillhandahålla omdirigerings-URI som ska konfigureras på IDP.

    Attributet

    Obligatorisk

    Beskrivning

    IDP-namn

    Ja

    Unikt men skiftlägesokänslig namn för OIDC IdP-konfiguration kan bestå av bokstäver, siffror, bindestreck, understreck, lutningar och punkter och maxlängden är 128 tecken.

    Klient-ID för OAuth

    Ja

    Används för att begära OIDC IdP-autentisering.

    Klienthemlighet för OAuth

    Ja

    Används för att begära OIDC IdP-autentisering.

    Lista över avsnitt av Skottland

    Ja

    Lista över områden som kommer att användas för att begära OIDC IdP-autentisering, uppdelad efter utrymme, t.ex. ”openid e-postprofil” Måste innehålla openid och e-post.

    Auktoriseringsslutpunkt

    Ja om discoveryEndpoint inte tillhandahålls

    URL till IdP:s OAuth 2.0-auktoriseringsslutpunkt.

    tokenEndpoint

    Ja om discoveryEndpoint inte tillhandahålls

    URL till IdP:s OAuth 2.0-tokenslutpunkt.

    Identifieringsslutpunkt

    Nej

    URL till IdP:s identifieringsslutpunkt för identifiering av OpenID-slutpunkter.

    användarinformationEndpoint

    Nej

    URL till IdP:s användarinformationsslutpunkt.

    Nyckeluppsättning slutpunkt

    Nej

    URL till IdP:s JSON Web Key Set Endpoint.

    Utöver ovanstående IDP-attribut måste partnerorganisations-ID anges i TAC-begäran.

  2. Konfigurera omdirigerings-URI på OpenID Connect-IDP.

  3. Konfigurera en registreringsmall. För inställningen för autentiseringsläge väljer du Partnerautentisering med OpenID Connect och anger det IDP-namn som anges under IDP-konfigurationen som IDP-enhets-ID för OpenID Connect.

  4. Skapa en ny användare i en ny kundorganisation som använder mallen.

  5. Mycket att användaren kan logga in med SSO-autentiseringsflödet.

Aktivera samtalskopplingsidentifierare

För att köra Webex för Cisco BroadWorks krävs att du aktiverar samtalskorrelationsidentifieraren. Den här inställningen krävs för många samtalsfunktioner, inklusive samtalsinspelning, besvara gruppsamtal, chef och chef/assistent.

Använd CLI för att aktivera funktionen på alla AS- och XSP|ADP-gränssnitt.

  • Kör följande kommandon på AS-gränssnitt. Detta gör det möjligt för AS att skicka SIP-sidhuvudet X-BroadWorks-Correlation-Info:

    AS_CLI/Interface/SIP> ställ in sendCallCorrelationIDNetwork true

    AS_CLI/Interface/SIP> ställ in sendCallCorrelationIDAccess true

  • Parametern enableCallCorrelationID som är kopplad till programmet Xsi-Actions används för att styra inkluderingen av information om samtalskorrelation i Xsi-Actions-loggar. Vi rekommenderar att du aktiverar enableCallCorrelationID med följande kommando på XSP|ADP-gränssnitt:

    XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>ställ in enableCallCorrelationID true

Mer information om samtalskorrelationsidentifieraren finns i Funktionsbeskrivning för samtalskorrelationsidentifierare i Cisco BroadWorks.

Directory Sync

Katalogsynkronisering säkerställer att Webex för Cisco BroadWorks-användare kan använda Webex-katalogen för att ringa alla samtalsenheter från BroadWorks-servern. När den här funktionen är aktiverad synkroniseras den fullständiga samtalskatalogen från BroadWorks-servern med Webex-katalogen. Användare kan komma åt katalogen från Webex-appen och ringa ett samtal till valfri samtalsenhet från BroadWorks-servern.

Om du vill aktivera katalogsynkronisering går du till Katalogsynkronisering i Webex för Cisco BroadWorks.

Genom etablering av Webex för Cisco BroadWorks läggs meddelandeanvändare och tillhörande samtalsinformation från BroadWorks-servern till Webex-plattformen. Telefonlistor, användare som inte skickar meddelanden och enheter som inte är användare ingår dock inte (till exempel en konferenstelefon, faxmaskin eller svarsgruppsnummer). Om du aktiverar katalogsynkronisering ser du till att alla samtalsenheter läggs till på Webex-plattformen.

Enhetlig samtalshistorik

När Unified Call History är aktiverat synkroniseras BroadWorks-samtalshändelser med Webex-molnet och blir en del av Webex Unified Call- och Meetings-historiken som visas i Webex-appen. Användare kan visa sin egen detaljerade samtalshistorik och möteshistorik från Webex-appen.

Enhetlig samtalshistorik kan aktiveras av administratörer på partnernivå i partnerhubben på kluster-för-kluster. När den här funktionen är aktiverad synkroniserar BroadWorks-distributionen följande samtalshändelser till Webex-molnet:

  • Händelser i samtalshistorik – dessa händelser används för att skapa en detaljerad enhetlig samtalshistorik

  • Hook-statushändelser – I den enhetliga samtalshistoriken ingår hook-statusoptimering som minskar mängden nätverksbandbredd för uppdateringar av telefoninärvaro

Krav på enhetlig samtalshistorik

Se till att du har uppdaterat systemet innan du kan konfigurera Unified Call History. Den här funktionen är beroende av att följande BroadWorks-programfixar installeras:

För R22:

För R23:

För R24:

En fullständig lista över BroadWorks-programfixar som du måste installera som en förutsättning för att köra Webex för Cisco BroadWorks finns i BroadWorks-programvarukrav i referensavsnittet.

Förutom att programfixera systemet måste klientkonfigurationsfilen (config-wxt.xml) ha följande tagguppsättning: <call-history enable-unified-history="%ENABLE_UNIFIED_CALL_HISTORY_WXT%"/>

För att sökgrupp, callcenter och annan omdirigeringsinformation ska finnas i Unified Call History måste följande BroadWorks-programfixar vara installerade och aktiva:

För R23:

  • AP.as.23.0.1075.ap383346

  • AP.as.23.0.1075.ap383994

För R24:

  • AP.as.24.0.944.ap383346

  • AP.as.24.0.944.ap383994

Om du vill ha information om chef/assistent i Unified Call History måste följande BroadWorks-programfixar vara installerade och aktiva:

För R24:

  • AP.as.24.0.944.ap380052

  • AP.as.24.0.944.ap384239

  • ADP som kör Xsi-Events-24_2022.06 eller senare

Förutom BroadWorks-korrigeringarna måste katalogsynkronisering också aktiveras för Executive-Assistant Unified Call History.

När du aktiverar samtalshistorik eller synkronisering av stör ej skickar Webex begäranden om uppdatering av CTI-prenumerationen för alla användare under klustret. Beroende på antalet användare kan detta ta upp till några timmar. Vi rekommenderar att du inte utför någon BroadWorks-underhållsaktivitet under samma underhållsfönster.

Aktivera samtalshistorik (nytt kluster)

För att aktivera samtalshistorik på ett nytt kluster, se stegen för att lägga till ett kluster i Konfigurera din partnerorganisation i partnerhubben.

Aktivera samtalshistorik (befintligt kluster)

Följ nedanstående steg för att aktivera samtalshistorik på ett befintligt kluster:

  1. Logga in på partnerhubben på admin.webex.com.

  2. Gå till Inställningar och välj ett befintligt kluster.

  3. Kontrollera att klusteranslutningen är bra. Den högra panelen ska visa en grön bockmarkering med Connection upprättad.

    Om detta inte visas anger du BroadWorks användar-ID och BroadWorks-lösenord under Kontrollera kopplingar och klickar på Kontrollera för att bekräfta att anslutningen är bra.

  4. Markera kryssrutan Aktivera samtalshistorik.

  5. Klicka på Spara.

Funktionsinteraktioner

Följande funktionsinteraktioner finns för Unified Call History:

  • Enhetlig samtalshistorik stöds inte för användare som har konfigurerats i BroadWorks med dirigeringslistor eller direktvägar. När den här situationen finns skickas inte händelser med samtalshistorik och status för telefonluren till Webex-appen.

  • Enhetlig samtalshistorik stöds inte med anknytningsuppringning. Samtal som rings med anknytningsuppringning kanske inte visas korrekt i samtalshistoriken.

Visa samtalshistorik i Webex-appen

Slutanvändare kan komma åt och visa sin Unified Call History från Webex-appen. Mer information finns här: Webex | Visa samtals- och möteshistorik.

Inaktivera enhetlig samtalshistorik

När du har aktiverat Unified Call History på ett kluster kan du inte inaktivera funktionen på egen hand. Kontakta Ciscos tekniska hjälpcenter (TAC) om du behöver inaktivera funktionen.

Indikation på visuell skräppost

Webex-appen har stöd för en visuell indikation av skräppostsamtal i samtalsposten när samtalet presenteras för den uppringande och i posterna i Unified Call History när BroadWorks uppdateras för att utföra validering av inringar-ID via STIR/SHAKEN-ramverket. För att ha den här funktionen:

  1. Aktivera Unified Call History enligt beskrivningen i föregående avsnitt.
  2. Följande programfixar måste vara installerade och aktiva:
    • AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
    • eller minst AS-25_Rel_2022.12
  3. Funktionen måste aktiveras via AS CLI:
    • AS_CLI/System/ActivatableFeature> aktivera 104112
    • AS_CLI/System/StirShaken> ställ in enableVerification true
  4. BroadWorks måste konfigureras för att utföra STIR-SHAKEN-signering, -taggning och -verifiering enligt beskrivningen i Cisco BroadWorks STIR-SHAKEN Signing-taggning och -verifiering

När BroadWorks har konfigurerats korrekt kommer ett nytt sidhuvud, X-Cisco-CallerId-Disposition, att läggas till i INVITE-begäranden som skickas till Cisco-klienter och ett nytt fält, att läggas till i de befintliga samtalshistorikhändelserna som skickas till Webex Cloud via CTI-gränssnittet. Webex-enheter kommer att använda den här informationen för att tillhandahålla en visuell indikation om skräppost i samtalspresentationen och samtalsmottagarens enhetliga samtalshistorik.

Statussynkronisering för personlig assistent

Funktionen för statussynkronisering för den personliga assistenten (PA) synkroniserar närvarostatusen för den personliga assistenten mellan BroadWorks Calling-enheter och Webex-appen.

PA-tjänsten ger användaren ett alternativ för att informera de som ringer om orsaken till att den uppringda parten inte är tillgänglig, vilket även ger information om när den uppringda parten återvänder och om det finns en assistent som hanterar samtalet. Med PA-funktionen kan användare i Webex-apparna se användarens närvaro Borta tillsammans med konfigurerad PA-status och varaktighet.

Förutsättningar

Se till att följande programkorrigeringar tillämpas på AS och XSP|ADP. Använd endast korrigeringarna för din BroadWorks-version.

Programfix för RI och version 24:

  • AP.as.24.0.944.ap385558

XSI-händelsepaket för statussynkronisering för personlig assistent introducerar ett nytt händelsepaket för PersonalAssistant för att tillåta att XSI-klienter synkroniseras med närvaroändringar i Cisco BroadWorks personlig assistent. Mer information finns i XSI-händelsepaket för funktionen för synkronisering av status för personlig assistent.

Förutom att programfixera systemet måste klientkonfigurationsfilen ({0}config-wxt.xml{1}) ha följande tagguppsättning: <personal-assistant enabled="%PERSONAL_ASSISTANT_ENABLED_WXT%"/>

Aktivera statussynkronisering för personlig assistent (nytt kluster)

För att aktivera statussynkronisering för personlig assistent på ett nytt kluster, se stegen för att lägga till ett kluster i Konfigurera din partnerorganisation i partnerhubben.

Om det finns fler än 50 kunder i ett BroadWorks-kluster stöds inte åtgärder som uppdatering av XSI-åtgärder, XSI-händelser, DAS URL, XSP|ADP URL, personlig assistent eller DND-synkronisering. I sådana fall rekommenderar vi att du kontaktar en Cisco TAC-supporttekniker för att få hjälp med att få detta Aktiverat.

Aktivera statussynkronisering för personlig assistent (befintligt kluster)

  1. Logga in på partnerhubben med dina inloggningsuppgifter för partneradministratören på https://admin.webex.com.

  2. Klicka på Organisationsinställningar.

  3. Klicka på Visa kluster och välj lämpligt BroadWorks-kluster.

  4. Under avsnittet CTI-gränssnitt aktiverar du växlingsknappen för statussynkronisering för personlig assistent.
  5. Ange ditt användar-ID för BroadWorks och klicka på Aktivera.

    Systemet validerar att BroadWorks-klustret har lämpliga programfixar för att stödja PA-synkronisering. Om valideringen misslyckas inaktiveras knappen Spara.

  6. Om valideringen lyckas klickar du på Spara.

    Aktivering av PA-statussynkronisering är en enkelriktad växling. När funktionen är aktiverad kan du inte inaktivera den på egen hand.

Inaktivera statussynkronisering för personlig assistent

När du har aktiverat PA-synkroniseringsstatus på något av BroadWorks-klustren kan du inte inaktivera funktionen på egen hand. Kontakta Ciscos tekniska hjälpcenter (TAC) om du behöver inaktivera funktionen.

Nummerpresentation och omdirigering av samtal

Identifiering av uppringare

När Webex-appen tar emot ett samtal försöker den identifiera vem som är uppringaren och visa denna information i aviseringen om inkommande samtal, i samtalsfönstret och när samtalet har avslutats i samtalshistoriken och röstbrevlådan.

Webex-appen försöker hitta inringar-ID genom att matcha det inkommande telefonnumret med telefonnumren för kontakter som finns i olika källor. Webex-appen kommer att använda följande källor i den här ordningen. När den hittar den i en källa kommer den inte att försöka söka någon annanstans.

Om den hittar flera instanser av ett nummer i en källa kommer den inte att försöka välja en av dem. I det här fallet visas inget inringar-ID.

  • Webex Common Identity (CI) som innehåller dina organisationsanvändare.

  • Personliga och organisationskontakter. Personliga kontakter visas på fliken Kontakter.

  • Lokal adressbok. I Windows – Outlook-program, i Mac – Mac-kontakter, i iOS – iPhone-kontakter, i Android – Android-kontakter.

Om det inte finns någon matchning med det inkommande telefonnumret använder appen visningsnamnet i SIP FRÅN sidhuvudet om det är tillgängligt. Annars kommer den att använda användarnamndelen av SIP-URI från SIP Från-sidhuvudet som en sista utväg.

För fjärrsamtalskontroll (d.v.s. kontrollläge för skrivbordstelefon) används XSI-information, där BWKS-ID eller anknytning används, extraheras från remote party-info i XSI-händelsen. Om fjärrpartsinformation inte är tillgänglig kommer P-Asserted Identity (PAI) (om den har konfigurerats) att användas.

Samtalsomdirigering

Om ett samtal har omdirigerats eller vidarekopplats försöker appen visa vem som är och hur det har vidarekopplats i samtalsaviseringen och samtalshistoriken.

  • Vidarebefordrat samtal: Visar numret som vidarebefordrade samtalet.

  • Sökgrupp: Visar namnet på den sökgrupp som vidarebefordrade samtalet.

  • Callcenter-kö: Visar namnet på kön som vidarebefordrade samtalet.

  • Chef/assistent: Visar namnet på den chef som samtalet kommer in för.

Undantag:

  • För interna samtalskösamtal där en agent ringer tillbaka till en intern part, kommer den fjärranslutna parten inte att se namnet på samtalskön utan se namnet på agenten som ringer upp dem.

Besvarat samtal någon annanstans:

För sökgrupper eller samtalsköer som har konfigurerats med samtidig routning kommer agenter att se ett samtal som besvaras någon annanstans i samtalshistoriken om en annan agent svarar på samtalet. För svarsgrupper eller samtalsköer med sekventiell dirigering eller i ett överspill visas samtal som missat samtal i samtalshistoriken om de besvaras av en annan agent.

Välj inringar-ID

Översikt

Med funktionen ”Välj inringar-ID” kan användare växla mellan olika samtalslinje-ID:n för externa samtal. Om administratören har aktiverat det kan användare välja bland följande alternativ för sin samtalslinjeidentitet:

  • Användarnummer (”Använd användarens telefonnummer för samtalslinjeidentitet”)

  • Konfigurerbar CLID (”Använd konfigurerbar CLID för samtalslinjeidentitet”)

  • Grupp-CLID (”Använd grupp-/avdelningstelefonnummer för samtalslinjeidentitet”)

Egenskaper

Användare har två sätt att ändra sitt inringar-ID så som det tillhandahålls av administratören:

  1. Funktionsåtkomstkoder (FAC): Specifika koder för vart och ett av de tre alternativen för inringar-ID.
  2. Gränssnitt för Webex-appen: En användarvänlig vy i Webex-skrivbords- och mobilappar som visar tillgängliga alternativ för inringar-ID som aktiverats av administratören, så att användare kan välja önskat ID.
Select Caller ID

Ytterligare funktioner

  • Webex-apparna kommer även att innehålla alternativ för DNIS för callcenter-köer.
  • Användare av mobilappen kommer att ha Dual Persona-alternativ tillgängliga för Mobility-användare.

Förutsättningar

Följande villkor måste uppfyllas på BroadWorks-servern för att användaren ska kunna styra valet av extern CLID-policy:

  • Systemflaggan ”EnableUserSelectionOfExternalCLIDPolicy” är aktiverad.
  • Samtalslinje-ID:t för policyns samtalslinje-ID på användarnivå är inställt på ”Använd policy för användar-samtalslinje-ID” för den här användaren.
  • Flaggan ”Tillåt användarval av extern CLID-policy” för samtalsbehandling på användarnivå är aktiverad för användaren.
  • Om inget nummer har definierats för alternativen ”Använd konfigurerbar CLID för samtalslinjeidentitet” eller ”Använd grupp-/avdelningstelefonnummer för samtalslinjeidentitet”, kommer visning av fac:er eller appen inte att ha någon effekt. Den här inställningen måste konfigureras av administratören innan användaren kan välja.

BroadWorks-korrigeringar

Den här funktionen kräver två specifika BroadWorks-programfixar för att fungera korrekt:

Se avsnittet 8 – Information om oberoende version och servicekort.

Konfiguration av Webex-appen

Denna tagg måste aktiveras i skrivbords-, surfplattors- och mobilkonfigurationer:

<config> <tjänster> <samtal> <caller-id> <outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%"> 

Utseende på delad linje

Delad linje som visas är möjligheten att etablera andra användares linjer som delade linjer på slutanvändarens enhet. Konfigurationen av delad linje för Webex-appen liknar konfigurationen av delad linje för skrivbordstelefoner. Med den här specifika funktionen kan du tilldela delade linjeutseenden till slutanvändarens Webex-app.

Den här funktionen gör det lättare för användare att hantera samtal på en annan användares anknytning direkt från Webex-appen.

  • Du kan endast konfigurera den delade linjen som visas i skrivbordsversionen av en Webex-app.

  • Du kan lägga till högst tio linjer, inklusive den primära linjen, till Webex-appen.

  • Du kan inte tilldela en arbetsytelinje som delad linje.

  • En användare kan inte reserveras med tjänsten för chef/assistent samtidigt som de har delade linjer.

  • En användares primära linjeport ska inte ändras till en delad linje.

Krav

För att distribuera den här funktionen i Webex för Cisco BroadWorks måste du distribuera följande BroadWorks-programfixar:

Programfix 1: Ägarflagga i enhetslistan för att stödja delade linjer för Webex-klienten

R23 utan ADP:

  • AP.as.23.0.1075.ap384179

  • AP.xsp.23.0.1075.ap384179

R23 med ADP:

  • AP.as.23.0.1075.ap384179

  • Xsi-Actions-23_2022.10

r24:

  • som: AP.as.24.0.944.ap384179

  • Xsi-åtgärder-24_2022.10

r25:

  • som: RI-version Rel_2022.10_1.310

  • Xsi-Actions-25_2022.10

Patch 2: Programfixar för att öka portantalet på enhetsprofiltyper. Exempel: För skrivbordsklienten: System>Ändra typ av identitet/enhetsprofil> Business Communicator – PC: Profil , standardalternativ, antal portar:

  • OM ”obegränsat” är aktiverat krävs ingen ändring
  • OM ”Begränsat till” är <10 ändrar du värdet = 10 och sparar för att använda alla tillgängliga linjer
  • RI-version Rel_2022.10_1.310

Mer information om klientkonfiguration finns i avsnitt 6.1.44 ”Primär profil” i Webex för Cisco BroadWorks konfigurationsguide.

Stör ej (DND) synkronisering

Stör ej (DND) synkroniserar DND-inställningarna mellan Webex och BroadWorks genom att synkronisera DND-status mellan de två plattformarna. Om en användare till exempel aktiverar Stör ej från Webex-appen synkroniseras statusen med BroadWorks-samtalsenheter. Till följd av detta ringer inte användarens BroadWorks-registrerade skrivbordstelefon när någon försöker ringa den. På samma sätt, om en användare ställer in Stör ej från en skrivbordstelefon synkroniseras statusen med Webex-appen. Utan den här funktionen känns inte DND-uppdateringar från en plattform igen av den andra plattformen.

DND-synkronisering tillämpas på BroadWorks-klusternivå och kan aktiveras i partnerhubben av en partneradministratör.

Om det finns många kunder (>50) i BroadWorks-klustret stöds inte DND-synkronisering. I sådana fall rekommenderar vi att du kontaktar en Cisco TAC-supporttekniker för att få hjälp.

Förutsättningar

Se till att följande programkorrigeringar tillämpas på AS och XSP|ADP. Använd endast korrigeringarna för din BroadWorks-version.

För version 23:

<klippt>

  • ADP-appar: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar

För version 24:

<klippt>

  • ADP-appar: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar

När du har applicerat korrigeringarna aktiverar du funktionen 25433 på AS:

AS_CLI/System/ActivatableFeature> aktivera 25433

Om det finns många kunder (>50) i BroadWorks-klustret stöds inte åtgärder som uppdatering av XSI-åtgärder, XSI-händelser, DAS URL, XSP|ADP URL eller DND-synkronisering. I sådana fall rekommenderar vi att du kontaktar en Cisco TAC-supporttekniker för att få hjälp.

Konfigurera synkronisering av enhetens funktionsknappar på BroadWorks. Se till att telefonen har stöd för SIP-PRENUMERATION/NOTIFY för händelsepaketet ”som-funktion-händelse”. Mer information finns i Synkronisering av funktionsknappar för Cisco BroadWorks-enheter.

Aktivera DND-synkronisering (befintligt kluster)

  1. Logga in på partnerhubben

  2. Klicka på Inställningar.

  3. Klicka på Visa kluster och välj lämpligt BroadWorks-kluster.

  4. Aktivera växlingsknappen Stör ej synkronisering.

  5. Ange ditt användar-ID för BroadWorks och klicka på Aktivera.

    Systemet validerar att BroadWorks-klustret har lämpliga programfixar för att stödja Stör ej-synkronisering. Om valideringen misslyckas inaktiveras knappen Spara.

  6. Om valideringen lyckas klickar du på Spara.

  • När DND-synkronisering har aktiverats uppdaterar Webex alla användarprenumerationer så att de inkluderar paketet Stör ej. Beroende på antalet användare kan det ta några timmar att slutföra processen.

  • Aktivering av DND-synkronisering är en enkelriktad växling. När funktionen är aktiverad kan du inte inaktivera den på egen hand.

Aktivera DND-synkronisering (nytt kluster)

Du kan även aktivera funktionen när kluster skapas. Mer information finns i ”Konfigurera dina BroadWorks-kluster” i Konfigurera din partnerorganisation i partnerhubben.

Tysta timmar

I Webex för BroadWorks-distributioner använder funktionen ”Stör ej (DND)-synkronisering” för att säkerställa att inställningarna för tysta timmar synkroniseras på alla enheter. Om du vill synkronisera tysta timmar på rätt sätt mellan stationära och mobila enheter måste du se till att ”Synkronisering av stör ej” är aktiverat på användarens konto.

Inaktivera Stör ej-synkronisering

Du kan inte inaktivera DND-synkronisering på egen hand. Om du vill inaktivera funktionen skapar du ett tekniskt BEMS-ärende med följande information:

  • Familj: Spark-tjänst

  • Produkt: Samtal i Webex (Webex för BroadWorks)

  • Komponent: WxBW-etablering

  • BEMS-fallet måste ange att Stör ej synkronisering ska inaktiveras för en partner. Ärendet måste innehålla partnerId och BroadWorks clusterId.

Användningsfall

Ställa in och rensa stör ej i förhållande till arbetsstatus

Samtalsinspelning

Webex för Cisco BroadWorks har stöd för fyra lägen för samtalsinspelning.

Tabell 6. Inspelningslägen

Inspelningslägen

Beskrivning

Kontroller/indikatorer som visas i Webex-appen

Alltid

Inspelningen initieras automatiskt när samtalet upprättas. Användaren kan inte starta eller stoppa inspelningen.

  • Visuell indikator på att inspelning pågår

Alltid med paus/återuppta

Inspelningen initieras automatiskt när samtalet upprättas. Användare kan pausa och återuppta inspelning.

  • Visuell indikator på att inspelning pågår

  • Knappen Pausa inspelning

  • Knappen Återuppta inspelning

På begäran

Inspelning initieras automatiskt när samtalet upprättas, men inspelningen tas bort såvida inte användaren trycker på Starta inspelning.

Om användare startar en inspelning, bibehålls den fullständiga inspelningen från samtalskonfigurationen. När inspelningen har startat kan användaren även pausa och återuppta inspelningen

  • Knappen Starta inspelning

  • Knappen Pausa inspelning

  • Knappen Återuppta inspelning

OnDemand med användarinitierad start

Inspelningen initieras inte om inte användaren väljer alternativet Starta inspelning i Webex-appen. Användaren har möjlighet att starta och stoppa inspelningen flera gånger under ett samtal.

  • Knappen Starta inspelning

  • Knappen Stoppa inspelning

  • Knappen Pausa inspelning

Krav

För att distribuera den här funktionen i Webex för Cisco BroadWorks måste du distribuera följande BroadWorks-programfixar:

Samtalskorrelationsidentifieraren måste vara påslagen. Mer information finns i Aktivera samtalskorrelationsidentifierare.

Följande konfigurationstagg måste vara aktiverad för att den här funktionen ska kunna användas: %ENABLE_CALL_RECORDING_WXT%.

Den här funktionen kräver integrering med en plattform för samtalsinspelning från tredje part.

Om du vill konfigurera samtalsinspelning på BroadWorks går du till Gränssnittsguide för Cisco BroadWorks samtalsinspelning.

Ytterligare information

Information om hur du använder inspelningsfunktionen finns i artikeln help.webex.comWebex | Spela in dina samtal.

För att spela upp en inspelning igen måste användare eller administratörer gå till sin plattform för samtalsinspelning från tredje part.

Aktivera röstbrevlåda för Microsoft Teams-integrering

Du kan aktivera röstbrevlåda för Microsoft Teams-användare i Webex för BroadWorks-lösningen. Med den här integreringen kan användare hämta sina röstmeddelanden direkt via Microsoft Teams, vilket förbättrar den övergripande användarupplevelsen.

Steg för att aktivera röstbrevlåda

Om du vill aktivera röstbrevlåda för BroadWorks måste du aktivera växlingsknappen broadworks-röstbrevlåda-enabled-spark-541886: sant på organisationsnivå.

Om du vill aktivera den här funktionen kontaktar du Ciscos tekniska hjälpcenter (TAC).

Användarupplevelse

När integreringen har konfigurerats kan användare:

  • Hämta röstmeddelanden direkt i Microsoft Teams-programmet.
  • Få aviseringar om nya röstmeddelanden.
  • Hantera röstbrevlådeinställningar från Webex-gränssnittet.

Krav

För att stödja hämtning av röstbrevlåda i Microsoft Teams-integreringen med Webex för BroadWorks-erbjudandet krävs ytterligare nätverksändringar. BroadWorks-partner bör aktivera Cross-Origin Resource Sharing (CORS) för följande URL:er på sin BroadWorks-plattform:

Mer information om konfigurationsstegen finns i avsnitt 8.5.1.2 i Konfigurationsguide för BW Application Delivery Platform, som kräver version 2024.05 på ADP.

Grupp-samtalsparkering och hämta

Webex för Cisco BroadWorks har stöd för gruppsamtalsparkering och hämtning. Den här funktionen ger användare i en grupp ett sätt att parkera samtal, vilket sedan kan hämtas av andra användare i gruppen. Till exempel kan återförsäljare i en butiksinställning använda funktionen för att parkera ett samtal som sedan kan plockas upp av någon på en annan avdelning.

Funktionsåtgärd

När funktionen har konfigurerats

  • Under ett samtal klickar en användare på alternativet Parkera i sin Webex-app för att parkera samtalet på en anknytning som systemet väljer automatiskt. Systemet visar anknytningen för användaren under en period på 10 sekunder.

  • En annan användare i gruppen klickar på alternativet Hämta samtal i sin Webex-app. Användaren anger sedan anknytningen till det parkerade samtalet för att fortsätta samtalet.

Krav

För att den här funktionen ska fungera måste du se till följande:

  • Klientkonfigurationsfilen måste ha följande taggar inställda:

    <call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
  • Samtalskorrelationsidentifieraren måste aktiveras på AS och XSP|ADP. Mer information finns i Aktivera samtalskorrelationsidentifierare.

  • Din SBC måste konfigureras för att överföra SIP-attributet ”x-broadworks-correlation-in” till och från programservern.

Konfiguration

Mer information om hur du konfigurerar gruppsamtalsparkering i BroadWorks finns i ”Lägg till samtalsparkeringsgrupp” i Administrationsguide för webbgränssnitt för Cisco BroadWorks programservergrupp – Del 2. Du måste skapa en grupp och lägga till användare i gruppen.

Mer information om hur du konfigurerar samtalskorrelationsidentifieraren i BroadWorks finns i Funktionsbeskrivning för Cisco BroadWorks samtalskorrelationsidentifierare.

Ytterligare information

Information om hur du använder gruppsamtalsparkering finns i Webex | Parkera och hämta samtal.

Parkering av samtal/parkering av dirigerat samtal

Regelbunden eller riktad samtalsparkering stöds inte i Webex-appens användargränssnitt, men etablerade användare kan distribuera funktionen med hjälp av funktionsåtkomstkoder:

  • Ange *68 för att parkera ett samtal

  • Ange *88 för att hämta ett samtal

Ingripande

Inbrytningstjänst används ofta i callcenter-miljöer eller i andra situationer där omedelbar hjälp eller ingripande kan krävas.

När en inbrytningstjänst är aktiverad kan en utsedd användare eller arbetsledare ringa ett aktivt samtal genom att initiera ett specifikt kommando eller använda en särskild knapp eller knappkombination på sin telefon eller kommunikationsenhet. När förfrågan om inbrytning har gjorts upprättar systemet en anslutning till det pågående samtalet, så att den behöriga personen kan lyssna på konversationen eller delta i samtalet som aktiv deltagare.

Inbrytningstjänsten kan vara användbar i olika scenarier. I en call center-inställning kan arbetsledare eller utbildare övervaka och utbilda kundtjänstrepresentanter genom att lyssna på sina samtal i realtid. Vid behov kan de ingripa för att ge vägledning eller ta över samtalet om företrädaren har svårt. I nödsituationer eller kritiska samtal kan behörig personal snabbt delta i pågående samtal för att ge hjälp eller fatta viktiga beslut.

I Webex-appen för inbrytning får vi ett meddelande om att samtalet omvandlas till en konferens. Det finns ingen ytterligare information i NOTIFY (call-info eller conference-info) vad som är typ av konferens, så vi kan behandla den på ett annat sätt.

När en inbrytning sker upprättas ett trevägssamtal mellan parterna. Följande termer införs:

  • Arbetsledare: En arbetsledare är en person som övervakar och hanterar ett team av kundtjänstagenter eller representanter för callcenter. I samband med inbrytning av samtal har en arbetsledare vanligtvis möjlighet att övervaka och ingripa i pågående kundsamtal. De kan använda verktyg för samtalsövervakning eller programvara för att lyssna på samtal, ge vägledning till agenter och säkerställa kvalitetskontroll. Arbetsledarens roll kan involvera utbildningsagenter, hantera kundfrågor och optimera teamets prestanda.

  • Kund: En kund avser en person eller enhet som samarbetar med ett företag eller en organisation för att erhålla produkter, tjänster eller support. I samband med inbrytning av samtal är en kund någon som ringer eller tar emot ett telefonsamtal med en kundtjänstagent. Kunder kan söka hjälp, information eller lösa sina frågor eller problem under samtalet. Med funktionen för inbrytning av samtal kan arbetsledare eller behörig personal delta i det pågående samtalet mellan kunden och agenten.

  • Agent: En agent, även kallad kundtjänstrepresentant eller callcenter-agent, är en person som ansvarar för att hantera kundinteraktioner och ge support eller hjälp via telefon eller andra kommunikationskanaler. Agenter utbildas för att hantera kundfrågor, lösa problem, bearbeta transaktioner och leverera en positiv kundupplevelse. I samband med inbrytning av samtal är en agent den person som talar direkt med kunden under telefonsamtalet. Agenten kan vid behov få vägledning eller feedback från arbetsledaren genom inbrytning av samtal.

För alla klientinitierade begäranden, t.ex. CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest osv., om <Webex Client> (välj rätt namn istället för Webex-klient, om detta inte är lämpligt) tillhandahålls som en enhet för visning av delat samtal, ska konfigurationen ”Meddela alla utseenden för klicka-för-att-ringa-samtal” aktiveras på inställningen för visning av delat samtal för att kunden ska ta emot ett samtal, såvida inte platsen uttryckligen anges av klienten som initierar begäran.

Lokalt mobilsamtal eskalera till möte

Det inbyggda mobilsamtalet eskaleras till möte har två unika funktioner:

  • Nytt push-meddelande

    Mobilanvändare i ett lokalt samtal kan nu växla till Webex-appen genom att trycka på den Nya push-aviseringen. När du startar en inbyggd samtalsskärm visas ett Nytt push-meddelande på skärmen och du trycker på aviseringen dirigeras direkt till Webex-appens samtalsskärm.

    Du ser Webex-aviseringen under ett mobilsamtal om du använder Webex Go eller om din mobiloperatör (MNO) har samtalssignalering med Ciscos samtalskontroll för dina mobilsamtal.

  • Flytta mobilsamtal till möte

    När du befinner dig mitt i ett samtal med någon kanske du vill flytta samtalet till ett möte för att använda avancerade mötesfunktioner som video, delning eller whiteboardtavlor. Eller bjud in andra personer till diskussionen och flytta till ett möte.

BroadWorks-krav

  • Aktiveringsbar funktion 25239

  • R23 med XSP|ADP:

    • AS Patch AP.as.23.0.1075.ap383064

    • XSP|ADP-korrigeringsfil AP.xsp.23.0.1075.ap383064

    • Patch AP.platform.23.0.1075.ap383064

  • R23 med ADP:

    • AS Patch AP.as.23.0.1075.ap383064

    • ADP med Xsi-Actions-23, CommPilot-23 version > 2022.05_1.303 och NPS version > 2022.08_1.350

  • r24:

    • AS-programfix: AP.as.24.0.944.ap383064

    • ADP med Xsi-Actions-24, CommPilot-24 version > 2022.05_1.303 och NPS version > 2022.08_1.350

  • r25:

    • AS RI-version Rel_2022.08_1.354

    • ADP med Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 och NPS-version > 2022.08_1.350

Konfiguration av URI-uppringning för att stödja flytta samtal till möte

NS UrlDialing-policy

Definiera regel för (.*)webex.com att dirigera genom I-SBC

NS_CLI/Policy/UrlDialing> hämta policy för WebexMeetings: UrlDialing-instans: Webex unknownSipURIandling = reject disableSubscriberLookups = true Enable = true CallTypes: Selection = {ALL} Från = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> hämta WebexMeetings-policy: UrlDialing-instans: WebexCalling-tabell: Regler-ID mönsterroutningNE kostnadsvikt dtg =================================================================== 1 *@*.webex.com WebexMeetings 1 50 WebexMeetings

NS-routnings-NE för I-SBC

Exempelkonfiguration

NS_CLI/System/Device/RoutingNE> hämta ne WebexMeetings-nätverkselement WebexMeetings-plats = 1281465 Datacenter = statisk kostnad = 1 statisk vikt = 99 Omröstning = falskt OpState = aktiverad Status = OnLine-profil = NIL_PROFILE Remote Lookup Aktiverad = falskt signalattribut = NS_CLI/System/Device/RoutingNE/Address> hämta ne WebexMeetings routning NE adress kostnad vikt porttransportväg ===================================================================== WebexMeetings sbc-adress 1 99 - ospecificerad

NS-dirigeringsprofil

Policyinstans för UrlDialing har lagts till i lämplig(a) dirigeringsprofil(er)

NS_CLI/Policy/Profile> hämta profil MyInst-profil: Webex policyinstans ========================================== UrlDialing WebexMeetings

AS-användning av NS-route för NetworkURL-samtal

Aktivera AS för att hedra NS-routning i Hybrid AS-läge

AS_CLI/Interface/IMS> ställ in frågaNSForNetworkURL true

E911-nödsamtal

Webex för Cisco BroadWorks har stöd för E911-nödsamtal. Med den här funktionen dirigeras nödsamtal till en larmcentral (PSAP) som sedan kan dirigera räddningstjänsten till inringarens plats. Om du vill använda den här funktionen måste du integrera Webex för Cisco BroadWorks med en E911-nödsamtalsleverantör.

Använd följande Webex-artiklar för att konfigurera stöd för E911-nödsamtalstjänster:

Anpassa och etablera klienter

Användare hämtar och installerar sina allmänna Webex-appar, på stationära eller mobila enheter (för hämtningslänkar, se Webex-appplattformar). När användaren har autentiserat registreras klienten mot Webex Cloud för meddelanden och möten, hämtar sin varumärkesinformation, upptäcker sin BroadWorks-tjänstinformation och hämtar sin samtalskonfiguration från BroadWorks programserver (via DMS på XSP|ADP).

Du konfigurerar samtalsparametrarna för Webex-appar i BroadWorks (som vanligt). Du konfigurerar varumärkning, meddelanden och mötesparametrar för klienterna i Control Hub. Du ändrar inte en konfigurationsfil direkt.

Dessa två uppsättningar konfigurationer kan överlappa varandra, i vilket fall Webex-konfigurationen ersätter BroadWorks-konfigurationen.

Lägg till konfigurationsmallar för Webex-appar på BroadWorks-programservern

Webex-appar är konfigurerade med DTAF-filer. Klienterna hämtar en konfigurationsfil från programservern via tjänsten Enhetshantering på XSP|ADP.

  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 > Enhetshanteringstagguppsättningar.

  3. För varje klient som du etablerar:

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

    2. Importera DTAF-filer till BroadWorks på System > Resurser > Identitet/enhetsprofiltyper

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

      • Ange XSP|ADP-gårdens FQDN och enhetsåtkomstprotokoll.

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

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

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

    5. Spara profilen.

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

Namn

Beskrivning

Kodekprioritet

Konfigurera prioritetsordning för ljud- och videokodekar för VoIP-samtal

TCP, UDP och TLS

Konfigurera de protokoll som används för SIP-signalering och media

RTP ljud- och videoportar

Konfigurera portintervall för RTP-ljud och video

SIP-alternativ

Konfigurera olika alternativ relaterade till SIP (SIP INFO, använd rport, SIP-proxyidentifiering, uppdateringsintervall för registrering och prenumeration osv.)

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 kunder att tillämpa sina egna varumärkesanpassningar kan kundadministratörer följa procedurerna i Lägg till ditt företags varumärkesanpassning 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 URL:er till hjälpwebbplats”, som finns i båda ovan nämnda varumärkesartiklar.

Konfigurera testorganisationen för Webex för Cisco BroadWorks

Innan du börjar

Med genomflödesetablering

Du måste konfigurera alla XSP|ADP-tjänster och partnerorganisationen i Control Hub innan du kan utföra den här uppgiften.

1

Tilldela tjänst i BroadWorks:

  1. Skapa ett testföretag under din tjänsteleverantörs företag i BroadWorks eller skapa en testgrupp under din tjänsteleverantör (beror på din BroadWorks-konfiguration).

  2. Konfigurera IM&P-tjänsten för företaget för att peka på mallen du testar (hämta etableringsadapterns URL och autentiseringsuppgifter från registreringsmallen för Control Hub).

  3. Skapa testprenumeranter i företaget/gruppen.

  4. Ge användarna unika e-postadresser i e-postfältet i BroadWorks. Kopiera dem till attributet Alternativt ID.

  5. Tilldela den integrerade IM&P-tjänsten till dessa prenumeranter.

    Detta utlöser skapandet av kundorganisationen och de första användarna, vilket tar flera minuter. Vänta en stund innan du försöker logga in med dina nya användare.

2

Verifiera kundorganisationen och användare i Control Hub:

  1. Logga in på Control Hub med ditt partneradministratörskonto.

  2. Gå till Kunder och kontrollera att din nya kundorganisation finns i listan (namnet följer gruppnamnet eller företagsnamnet från BroadWorks).

  3. Öppna kundorganisationen och kontrollera att prenumeranter är användare i den organisationen.

  4. Kontrollera att den första prenumeranten som du tilldelade den integrerade IM&P-tjänsten till har blivit kundadministratör för den organisationen.

Användartestning

1

Hämta Webex-appen på två olika datorer.

2

Logga in som testanvändare på de två datorerna.

3

Ring testsamtal.

Översikt över Webex för Cisco BroadWorks

Introduktion till Webex för Cisco BroadWorks

Revisionshistorik för dokument

Det här avsnittet adresserar systemadministratörer hos Cisco-partnerorganisationer (tjänsteleverantör) som implementerar Webex för sina kundorganisationer eller tillhandahåller den här lösningen direkt till sina egna prenumeranter.

Lösnings?tt?nde

  • För att tillhandahålla Webex-molnsamarbetesfunktioner till små och mellanstora kunder som redan har samtalstjänster från BroadWorks-tjänsteleverantörer.

  • För att tillhandahålla BroadWorks-baserad samtalstjänst till små och mellanstora Webex-kunder.

Context

Vi håller på att utveckla alla våra samarbetsklienter till ett gemensamt program. Denna sökväg minskar implementeringsproblem, förbättrar kompatibiliteten och migreringen och levererar förutsägbara användarupplevelser i hela vår samarbetsportfölj. En del av den här insatsen är att flytta BroadWorks-samtalsfunktioner till Webex-appen, och till slut minska investeringen i UC-One-klienter.

Fördelar

  • Framtida bevis: mot slutet av livscykeln för UC-One-samarbete, förflyttning av alla klienter till Unified Client Framework (UCF)

  • Det bästa av båda: Aktivera Webex-meddelanden och mötesfunktioner men samtidigt behålla BroadWorks-samtal i telefoninätverket

Lösningsomfång

  • Befintliga/nya små till mellanstora kunder (färre än 250 prenumeranter) som vill ha en programsvit med samarbetsfunktioner kan redan ha BroadWorks-samtal.

  • Befintliga små till mellanstora Webex-kunder som vill lägga till BroadWorks-samtal.

  • Inte större företag (se vår företagsportfölj för Webex).

  • Inte enskilda användare (utvärdera Webex Online-erbjudanden).

Funktionsuppsättningar i Webex för Cisco BroadWorks mål för små till medium företagsanvändningsfall. Webex för Cisco BroadWorks-paket är utformade för att reducera komplexiteten för smekningar, och vi utvärderar kontinuerligt deras sekretess för detta segment. Vi kan välja att dölja eller ta bort funktioner som annars skulle finnas tillgängliga i företagspaketen.

Förutsättningar för att lyckas med Webex för Cisco BroadWorks

#

Krav

Anteckningar

1

Patch Current BroadWorks R22 or above

2

XSP|ADP for XSI, CTI, DMS, and authService

Dedicated XSP|ADP for Webex for Cisco BroadWorks

3

Separate XSP|ADP for NPS, can be shared with other solutions that use NPS.

If you have an existing collaborate deployment, then review recommendations on XSP|ADP and NPS configurations.

4

Validering av CI-token (med TLS) konfigurerad för Webex-anslutningar till autentiseringstjänsten.

5

mTLS konfigurerad för Webex-anslutningar till CTI-gränssnittet.

Andra program kräver inte mTLS.

6

Användare måste finnas i BroadWorks och behöver följande attribut, beroende på ditt etableringsbeslut:

  • Flowflöde med betrodda e-postmeddelanden: E-postattributet för BroadWorks-användaren måste innehålla en giltig e-postadress som är unik för användaren. User must also have a primary number or extension.

  • Flow automatisk med ej betrodda e-postmeddelanden eller självaktivering eller API-etablering: User does not need email address but must have a primary number or extension.

För betrodda e-postmeddelanden: Vi rekommenderar att du även har lagt in samma e-postadress i attributet Alternativt ID för att göra det möjligt för användare att logga in med e-postadressen mot BroadWorks.

För ej betrodda e-postmeddelanden: Beroende på användarens e-postinställningar kan användningen av ej betrodda e-postmeddelanden resultera i att e-postmeddelandet skickas till användarens skräppost- eller SKRÄPPOSTmapp. Administratören kan behöva ändra användarens e-postinställningar för att tillåta domäner

7

Webex för Cisco BroadWorks DTAF-fil för Webex-appen

8

BW Business Lic eller Std Enterprise- eller Prem Enterprise-användare Lic + Webex för Cisco BroadWorks-prenumeration

Om du har en befintlig samarbetsdistribution behöver du inte längre UC-One Add-On Bundle, Collab Lic och Meet-me konferensportar.

Om du har en befintlig UC-One SaaS-distribution behöver du inte göra ytterligare ändringar än att acceptera premiumpaketsvillkoren.

9

IP/portar måste vara tillgängliga via Webex backend-tjänster och Webex-apparna över internet.

Se avsnittet "Förbered ditt nätverk".

10

TLS v1.2 Configuration on XSP|ADPs

11

För Flow fjärrskrivbordsetablering måste programservern ansluta till BroadWorks-etableringsadaptern.


 

Vi testar eller stöder inte konfiguration av utgående proxy. Om du använder en utgående proxy accepterar du ansvaret för att stödja den med Webex för Cisco BroadWorks.

Se ämnet "Förbered ditt nätverk".

Om detta dokument

Syftet med det här dokumentet är att hjälpa dig att förstå, förbereda dig för, distribuera och hantera din Webex för Cisco BroadWorks-lösning. Huvudavsnitten i dokumentet reflekterar detta syfte.

Den här handledningen inkluderar referensmaterial och referensmaterial. Vi avser att täcka alla aspekter av lösningen i detta dokument.

Den lägsta uppsättning uppgifter som krävs för att distribuera lösningen är:

  1. Kontakta ditt kontoteam för att bli en Cisco-partner. Det är mycket viktigt att du utforskar Cisco touch points för att bekanta dig med (och få det vida). När du blir en Cisco-partner använder vi växeln Webex för Cisco BroadWorks för din Webex-partnerorganisation. (Se Distribuera Webex för Cisco BroadWorks > för partnerbaserad registrering i det här dokumentet.)

  2. Konfigurera BroadWorks-system för integrering med Webex. (See Deploy Webex for Cisco BroadWorks > Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs in this document.)

  3. Använd Partner Hub för att ansluta Webex till BroadWorks. (Se Distribuera Webex för Cisco BroadWorks > konfigurera din partnerorganisation i Partner Hub i det här dokumentet.)

  4. Använd Partner Hub för att förbereda mallar för användareetablering. (See Deploy Webex for Cisco BroadWorks > Configure your Onboarding templates in this document.)

  5. Test and onboard a customer by provisioning at least one user. (See Deploy Webex for Cisco BroadWorks > Configure Your Test Organization.)


 
  • Det här är steg på hög nivå i vanlig ordning. Det finns flera uppgifter som bidrar med något som du inte kan ignorera.

  • Om du vill skapa dina egna program för att hantera dina Webex-prenumeranter för Cisco BroadWorks-prenumeranter ska du läsa Using the Provisioning API (Tillhandahållande API) i referensavsnittet i denna guide.

Terminologi

We try to limit the jargon and acronyms used in this document, and to explain each term when it’s first used. (See Webex for Cisco BroadWorks Reference > Terminology if a term isn’t explained in context.)

Så här går det till:

Webex för Cisco BroadWorks är ett erbjudande som integrerar BroadWorks-samtal i Webex. Prenumeranter använder ett enda program (Webex-appen) för att dra nytta av funktionerna från båda plattformarna:

  • Användare ringer PSTN nummer med din BroadWorks-infrastruktur.

  • Användare ringer andra BroadWorks-nummer med din BroadWorks-infrastruktur (ljud-/videosamtal genom att välja de nummer som är kopplade till användarna eller knappsatsen för att introducera numren).

  • Alternativt kan användare ringa ett Webex-voIP-samtal via Webex-infrastrukturen genom att välja alternativet "Webex Call" i Webex-appen. (Dessa samtal är Webex-appen till Webex-appen, inte Webex-appen för PSTN).

  • Användare kan vara värd för och delta Webex Meetings.

  • Användare kan skicka meddelanden till varandra eller i utrymmen (beständig gruppchatt) och dra nytta av funktioner som sökning och fildelning (i Webex-infrastruktur).

  • Användare kan dela närvaro (status). De kan välja anpassad närvaro eller beräknad närvaro.

  • När vi har registrera dig som en partnerorganisation i Control Hub med de rätta berättigandena kan du konfigurera relationen mellan din BroadWorks-instans och Webex.

  • Du skapar kundorganisationer i Control Hub och etablerar användare i dessa organisationer.

  • Alla prenumeranter i BroadWorks får en Webex-identitet baserad på sin e-postadress (e-post-ID-attributet i BroadWorks).

  • Användare verifieras mot BroadWorks eller mot Webex.

  • Klienter har utfärdats med token som sedan länge är godkända för att auktorisera dem för tjänster i BroadWorks och Webex.

Webex-appen i mitten av den här lösningen: det är ett varumärkesprogram som finns tillgängligt på Mac/Windows-datorer och Android/iOS-mobiler och surfplattor.

Det finns också en webbversion av Webex-appen som för närvarande inte inkluderar samtalsfunktioner.

Klienten ansluter till Webex-molnet för att leverera meddelanden, närvaro och mötesfunktioner.

Klienten registrerar sig på dina BroadWorks-system för samtalsfunktioner.

Webex-molnet fungerar med dina BroadWorks-system för att säkerställa en sömlös användaretableringsupplevelse.

Funktioner och begränsningar

Vi erbjuder flera paket med olika funktioner.

Paket för "softphone"

Den här pakettypen använder Webex-appen som en klient för endast datortelefon med samtalskapacitet, men inga meddelandefunktioner. Användare med den här pakettypen kan delta i Webex-möten, men kan inte starta möten på egen hand. När andra användare (softphone eller icke-softphone) söker i katalogen efter en softphone-användare ger sökresultaten inget alternativ att skicka ett meddelande.

Softphone-användare kan dela sin skärm under ett samtal.

"Grundläggande" paket

The basic package includes Calling, Messaging, and Meeting features. It includes 100 participants in “unified space” meetings and Personal Meeting Room (PMR) meetings. (** see the below Note for exception). In this package the meetings can have a maximum duration of 40 minutes.

"Standard"-paket

This package also includes everything in the Basic package such as up to 100 participants in “unified space” meetings and Personal Meeting Room (PMR) meetings.

Skärmdelning under ett PMR-möte är en roll som initialt endast hålls av mötesvärden, men värden kan överföra "presentatörsrollen" till valfri mötesdeltagare som de väljer och endast värden kan ta tillbaka presentatörsrollen utan att den nuvarande värden har ge den till dem.

"Premium"-paket

This package includes everything in the Standard package plus up to 300 participants in “unified space” meeting and up to 1000 participants in a Personal Meeting Room (PMR).

Skärmdelning inom PMR möte stöds för alla mötes deltagare.

Jämför paket

Paket

Samtal

Meddelanden

Unified Space Meetings

PMR Möten

Programvarutelefon

Inkluderas

Inkluderas inte

Inget

Inget

Grundläggande

Inkluderas

Inkluderas

100 deltagare

100 deltagare

Standard

Inkluderas

Inkluderas

100 deltagare

100 deltagare

Premium

Inkluderas

Inkluderas

300 deltagare

1 000 deltagare


 
The Unified Space Meeting limit for Basic users is 100 participants per Unified Space Meeting unless the space also includes users assigned the “Standard” or “Premium” packages, in which case the limit increases based on host user package.

 

"Unified Space Meetings" refers to a Webex meeting (scheduled or unscheduled) that takes place in a Webex space. For example, a user initiates a meeting from the space via the "Meet" or "Schedule" buttons.

"PMR Meetings" refers to a Webex Meeting (scheduled or unscheduled) that takes place in a user's Personal Meeting Room (PMR). These meetings use a dedicated URL (for example: cisco.webex.com/meet/roomOwnerUserID).

Meddelande- och mötesfunktioner

Refer to the following table for PMR meeting feature support differences for Basic, Standard and Premium packages.

Tabell 1. Skillnader mellan funktioner i PMR möten

Mötesfunktionen

Supported with Basic Package

Porterad med standardpaket

Stöds med preminum-paket

Kommentar

Mötets varaktighet

40 Minutes or less

Obegränsad

Obegränsad

Skrivbordsdelning

Ja

Ja

Ja

Basic—Desktop sharing by any PMR meeting participant.

Standard —Desktop sharing by PMR meeting host only.

Premium—Desktop sharing by any PMR meeting participant.

Programdelning

Ja

Ja

Ja

Basic—Application sharing by any PMR meeting participant.

Standard —Application sharing by PMR meeting host only.

Premium—Application sharing by any PMR meeting participant.

Chatt med flera parter

Ja

Ja

Ja

Whiteboardtavlor

Ja

Ja

Ja

Lösenordsskydd

Ja

Ja

Ja

Webbapp – ingen hämtning eller plugin-program (gästupplevelse)

Ja

Ja

Ja

Stöd för sammankoppling med Webex-enheter

Ja

Ja

Ja

Golvkontroll (Stäng av ett ljud / Avvisa alla)

Ja

Ja

Ja

Länk till ständiga möten

Ja

Ja

Ja

Möteswebbplats - acces

Ja

Ja

Ja

Delta i mötet via VoIP

Ja

Ja

Ja

Låsa

Ja

Ja

Ja

Presentatörskontroller

Nej

Nej

Ja

Fjärrkontroll av skrivbord

Nej

Nej

Ja

Antal deltagare

100

100

1000

Inspelning sparad lokalt i systemet

Ja

Ja

Ja

Inspelning i molnet

Nej

Nej

Ja

Inspelning – Molnlagring

Nej

Nej

10GB per site

Transkriptioner av inspelningar

Nej

Nej

Ja

Mötesschemaläggning

Ja

Ja

Ja

Aktivera innehållsdelning med externa integrationer

Nej

Nej

Ja

Basic— Content sharing by any PMR meeting participant.

Standard—Content sharing by PMR meeting host only.

Premium—Content sharing by any PMR meeting participant.

Tillåt PMR URL-ändring

Nej

Nej

Ja

Basic— Users can modify the PMR URL from the Webex site. Partner and org admins can modify the URL from Control Hub.

Standard—The PMR URL can be changed only from Partner Hub by Partner and org admins.

Premium—Users can modify the PMR URL from the Webex site. Partner- och organisationsadministratörer kan ändra URL:en från partnerhubben.

Direktströmning av möten (t.ex. på Facebook, Youtube)

Nej

Nej

Ja

Låta andra användare schemalägga möten åt sig

Nej

Nej

Ja

Lägg till alternativ värd

Ja

Nej

Ja

Appintegrering (t.ex. Zendesk, Slack)

Beror på integreringen

Beror på integreringen

Ja

Se avsnittet Appintegreringar nedan för mer information om support.

Integrering med Microsoft Office 365-kalender

Ja

Ja

Ja

Integrering med Google Calendaring för G Suite

Ja

Ja

Ja

Webex hjälpcenter publicerar funktionerna och den dokumentation som användarna står inför för Webex på help.webex.com. Läs följande artiklar om du vill veta mer om funktionerna:

Samtalsfunktioner

Samtalsupplevelsen liknar tidigare lösningar som använder BroadWorks samtalskontrollmotor. Skillnaden med UC-One Collaborate och UC-One SaaS är att Webex-appen är den primära soft-klienten.

Appintegreringar

Du kan integrera Webex för Cisco BroadWorks med följande program:

Stöd för virtuell skrivbordsinfrastruktur (VDI)

Webex för Cisco BroadWorks har nu stöd för VDI-miljöer (Virtual Desktop Infrastructure). For details on how to deploy VDI infrastructure, refer to Deployment Guide for Webex for Virtual Desktop Infrastructure (VDI).

IPv6 Support

Webex for Cisco BroadWorks supports IPv6 addressing for the Webex App.

Pro Pack för Control Hub

Pro Pack för Kontrollhubb-tilläggstjänst tillhandahåller dina administratörer, informationssäkerhet och kontroll tjänstemän med avancerade funktioner i säkerhet, regelefterlevnad och analyser som kan integreras med din programvara.

These add-on services will be only available for Standard and Premium packages.

For more information, see the Help Page of Pro Pack for Control Hub.

Framtida handlingsplan

För en inblick i vårt omk?nde för framtida versioner av Webex för Cisco BroadWorks, besök https://salesconnect.cisco.com/#/program/PAGE-16649. Objekten i översikten är inte bindning i någon kapacitet. Cisco förbehåller sig rätten att medge eller granska något eller alla dessa objekt från framtida versioner.

Begränsningar

Begränsningar vid tillhandahållande

Meetings-webbplatsens tidszon

Tidszonen för den första prenumerant för varje paket blir tidszonen för det Webex Meetings webbplats som skapats för det paketet.

Om ingen tidszon har angetts i etableringsbegäran för den första användaren av varje paket, ställs Webex Meetings-webbplatsens tidszon för det paketet in till det lokala standardvärdet för prenumerantorganisationen.

Om kunden behöver en specifik Webex Meetings webbplatstidszonen anger du tidszonparametern i etableringsbegäran för:

  • den första prenumeranten som tillhandahålls för standardpaket i organisationen.

  • den första prenumeranten som tillhandahålls för Premium-paketet i organisationen.

  • the first subscriber provisioned for Basic package in the organization.

Allmänna begränsningar

  • Inga samtal i webbversionen av Webex-klienten (Detta är en klientbegränsning, inte en lösningsbegränsning.)

  • Webex kanske ännu inte har alla UI-kontroller som stöd för vissa funktioner för samtalskontroll som är tillgängliga från BroadWorks.

  • Webex-klienten kan för närvarande inte vara "Vitetikettad".

  • När du skapar kundorganisationer med din valda etableringsmetod skapas de automatiskt i samma region som din partnerorganisation. Detta beteende är avsiktligt. Vi förväntar oss att multinationella partner skapar en partnerorganisation i alla regioner där de hanterar kundorganisationer.

  • Mötes- och meddelandeanvändningsrapportering är tillgänglig via kundorganisationen i Control Hub.

Kända problem och begränsningar

For an up to date list of known issues and limitations with the Webex for Cisco BroadWorks offer, see Known Issues and Limitations.

Begränsningar av meddelanden

Följande gränser för datalagring (meddelanden och filer kombinerat) gäller för organisationer som har köpt Webex för Cisco BroadWorks-tjänster via en tjänsteleverantör. Dessa gränser representerar den maximala lagringen för meddelanden och filer i kombination.

  • Grundläggande: 2 GB per användare i 3 år

  • Standard 5 GB per användare i 3 år

  • Premium: 10 GB per användare i 5 år

För varje kundorganisation poolas dessa användarsummor för att tillhandahålla ett sammanlagt totalt för kunden, baserat på antalet användare. Till exempel har ett företag med fem premiumanvändare en sammanlagd gräns för meddelande och fillagring på 50 GB. En enskild användare kan överskrida gränsen per användare (10 GB), förutsatt att företaget fortfarande ligger under den aggregerade maxgränsen (50 GB).

För teamutrymmen som skapas gäller meddelandegränserna mot det sammanlagda totala antalet för kundorganisationen som äger teamutrymmet. Du hittar information om ägaren av enskilda teamutrymmen i Utrymmespolicyn. Information om hur du visar utrymmespolicyn för ett enskilt teamutrymme finns i https://help.webex.com/en-us/baztm6/Webex-Space-Policy.

Ytterligare information

Ytterligare information om allmänna meddelandegränser som gäller för Webex meddelandeteamutrymmen finns i https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.

Säkerhet, data och roller

Webex-säkerhet

Webex-klienten är ett säkert program som gör säkra anslutningar till Webex och BroadWorks. Data som lagras i Webex-molnet och som exponeras för användaren via Webex-appens gränssnitt krypteras både under transport och resten.

Det finns mer information om datautbyte under referensavsnittet i detta dokument.

Ytterligare läsning

Organisationens datas arighet

Vi sparar dina Webex-data i det datacenter som ligger närmast din region. Se Data punkt i Webex i hjälpcentret.

Roller

Tjänsteleverantörsadministratör (du): För dag till dag-underhåll hanterar du lokala (samtal) delar av lösningen med hjälp av dina egna system. Du hanterar Webex-delen av lösningen via Partner Hub.

For information on the roles that are available to partners, the access privileges that accompany those roles, and how to assign roles, see Partner Administrator Roles for Webex for BroadWorks and Wholesale RTM.


 
The first user provisioned to a new partner organizaiton is assigned automatically to the Full Administrator and Full Partner Administrator roles. That administrator can use the above article to assign additional roles.

Ciscos molndriftsteam: Skapar din "partnerorganisation" i Partner Hub, om den inte finns, under din registrering.

När du har ditt Partner Hub-konto kan du konfigurera Webex-gränssnitten till dina egna system. You next create “Onboarding templates” to represent the suites or packages served through those systems. Därefter kan du tillhandahålla dina kunder eller prenumeranter.

#

Typisk uppgift

Sp

Cisco

1

Partner onboarding – Skapa en partnerorganisation om en sådan inte finns och aktivera nödvändiga funktionsreglage

2

BroadWorks-konfiguration i partnerorganisationen via partnerhubben (kluster)

3

Konfigurera integreringsinställningar i partnerorganisationen via partnerhubben (erbjudandemallar, varumärke)

4

Preparing BroadWorks environment for Integration (AS, XSP|ADP Patching, firewalls, XSP|ADP configuration, XSI, AuthService, CTI, NPS, DMS applications on XSP|ADP)

5

Utveckla integrering eller process för etablering

6

Förbered GTM-material

7

Migrera eller tillhandahålla nya användare

Arkitekturen

Vad finns i diagrammet?

Klienter

  • Webex-appklienten fungerar som det primära programmet i Webex för Cisco BroadWorks-erbjudanden. Klienten finns tillgänglig på stationära, mobila och webbplattformar.

    Klienten har lokala meddelanden, närvaro och ljud-/videomöten med flera delar som tillhandahålls av Webex-molnet. Webex-klienten använder din BroadWorks-infrastruktur för SIP och PSTN samtal.

  • Ip-telefoner och tillbehör som är relaterade till Cisco använder också din BroadWorks-infrastruktur för SIP PSTN samtal. Vi förväntar oss att kunna ge support till tredjepartstelefoner.

  • Användaraktiveringsportal för att användare ska logga in på Webex med sina BroadWorks-inloggningsuppgifter.

  • Partner Hub är ett webbgränssnitt för att administrera din Webex-organisation och dina kunders organisationer. Partner Hub är platsen där du konfigurerar integreringen mellan din BroadWorks-infrastruktur och Webex. Du använder också Partner Hub för att hantera klientkonfiguration och fakturering.

tjänsteleverantör?tverk

Det gröna blocket till vänster om diagrammet representerar ditt nätverk. Komponenter som finns i ditt nätverk tillhandahåller följande tjänster och gränssnitt till andra delar av lösningen:

  • Public-facing XSP|ADP, for Webex for Cisco BroadWorks: (The box represents one or multiple XSP|ADP farms, possibly fronted by load balancers.)

    • Är värd för Xtended Services Interface (XSI-Actions &XSI-Events), Device Hanteringstjänst (DMS), CTI-gränssnitt och autentiseringstjänst. Tillsammans ger dessa program telefoner och Webex-klienter möjlighet att autentisera sig själva, hämta sina konfigurationsfiler för samtal, ringa och ta emot samtal samt se varandras status för "koppla" (telefoninärvaro) och samtalshistorik.

    • Publicerar katalogen till Webex-klienter.

  • Public-facing XSP|ADP, running NPS:

    • push-server för värdsamtalsaviseringar: A Notification Push Server on an XSP|ADP in your environment. Den samverkar mellan din programserver och vår NPS-proxy. Proxyn tillhandahåller token som är kort tidsförutgåva till ditt NPS för att tillåta aviseringar till molntjänsterna. Dessa tjänster (APNS och FCM) skickar samtalsaviseringar till Webex-klienter på Apple iOS- och Google Android-enheter.

  • Programserver:

    • Tillhandahåller samtalskontroll och gränssnitt till andra BroadWorks-system (i allmänhet)

    • För flowupplös etablering används AS:en av partneradministratören för att etablera användare i Webex

    • Flytta användarprofil till BroadWorks

  • OSS/BSS: Ditt driftsupportsystem/Business SIP-tjänster för att administrera dina BroadWorks-företag.

Webex-moln

Det blå blocket i diagrammet visar Webex-molnet. Webex-mikrotjänster stöder full funktionalitet för Webex-samarbete:

  • Cisco Common Identity (CI) är det identitetstjänst inom Webex.

  • Webex för Cisco BroadWorks representerar den uppsättning mikrotjänster som stöder integreringen mellan Webex och tjänsteleverantör Hosted BroadWorks:

    • API:er för användareablering

    • tjänsteleverantör konfigurering

    • Användarinloggning med BroadWorks-inloggningsuppgifter

  • Rutan Webex-meddelanden för meddelanderelaterade mikrotjänster.

  • Webex Meetings ruta som representerar mediebearbetningsservrar och SBI:er för videomöten med flera deltagare (SIP och SRTP)

Webbtjänster från tredje part

Följande tredjepartskomponenter visas i diagrammet:

  • APNS (Apple Push Notifications Service) pushar samtals- och meddelandemeddelanden till Webex-program på Apple-enheter.

  • FCM (FireBase Cloud Messaging) skickar samtals- och meddelandemeddelanden till Webex-program på Android-enheter.

XSP|ADP Architecture Considerations

The Role of Public-Facing XSP|ADP Servers in Webex for Cisco BroadWorks

The public-facing XSP|ADP in your environment provides the following interfaces/services to Webex and clients:

  • Autentiseringstjänst (AuthService), som skyddas av TLS och som svarar på Webex-förfrågningar för BroadWorks JWT (JSON Web Token) för användarens räkning

  • CTI-gränssnitt, säkrat av mTLS, som Webex prenumererar på samtalshistorik händelser och status för telefoninärvaro från BroadWorks (status för anslutning).

  • Xsi-åtgärder och events-gränssnitt (eXtended Services Interface) för prenumeranters samtalskontroll, kontakt- och samtalslista samt konfiguration av telefonitjänst för slutanvändare

  • DM-tjänst (Device Management) för klienter att hämta sina konfigurationsfiler för samtal

Ange URL:er till dessa gränssnitt när du konfigurerar Webex för Cisco BroadWorks. (See Configure your BroadWorks Clusters in Partner Hub in this document.) For each cluster, you can only provide one URL for each interface. Om du har flera gränssnitt i din BroadWorks-infrastruktur kan du skapa flera kluster.

XSP|ADP Architecture

XSP|ADP Architecture: Alternativ 1
XSP|ADP Architecture: Alternativ 2

We require that you use a separate, dedicated XSP|ADP instance or farm to host your NPS (Notification Push Server) application. Du kan använda samma NPS med UC-One SaaS eller UC-One Collaborate. However, you may not host the other applications required for Webex for Cisco BroadWorks on the same XSP|ADP that hosts the NPS application.

We recommend that you use a dedicated XSP|ADP instance/farm to host the required applications for Webex integration for the following reasons

  • For example, if you’re offering UC-One SaaS, we recommend creating a new XSP|ADP farm for Webex for Cisco BroadWorks. På så sätt kan de båda tjänsterna fungera oberoende medan du migrerar prenumeranter.

  • If you collocate the Webex for Cisco BroadWorks applications on an XSP|ADP farm that is used for other purposes, it's your responsibility to monitor usage, manage the resulting complexity, and plan for the increased scale.

  • The Cisco BroadWorks System Capacity Planner assumes a dedicated XSP|ADP farm and may not be accurate if you use it for collocation calculations.

Unless noted otherwise, the dedicated Webex for Cisco BroadWorks XSP|ADPs must host the following applications:

  • AuthService (TLS med CI-tokenvalidering eller mTLS)

  • CTI (mTLS)

  • XSI-åtgärder (TLS)

  • XSI-Events (TLS)

  • DMS (TLS)—Optional. It's not mandatory that you deploy a separate DMS instance or farm specifically for Webex for Cisco BroadWorks. You can use the same DMS instance that you use for UC-One SaaS or UC-One Collaborate.

  • Call Settings Webview (TLS)—Optional. Call Settings Webview (CSW) is required only if you want Webex for Cisco BroadWorks users to be able to configure calling features on the Webex App.

Webex kräver åtkomst till CTI via ett gränssnitt som skyddas av ömsesidig TLS autentisering. För att stödja detta krav rekommenderar vi ett av följande alternativ:

  • (Diagram labelled Option 1) One XSP|ADP instance or farm for all applications, with two interfaces configured on each server: ett mTLS-gränssnitt för CTI och ett TLS-gränssnitt för andra appar, t.ex. AuthService.

  • (Diagram labelled Option 2) Two XSP|ADP instances or farms, one with an mTLS interface for CTI, and the other with a TLS interface for other apps, such as the AuthService.


 

XSP|ADP Reuse

If you have an existing XSP|ADP farm that conforms to one of the suggested architectures above (Option 1 or 2) and it is lightly loaded, then it is possible to reuse your existing XSP|ADPs. You will need to verify that there are no conflicting configuration requirements between existing applications and the new application requirements for Webex. De två huvudsakliga övervägandena är:

  • If you need to support multiple webex partner organizations on the XSP|ADP, then that means you must use mTLS on the Auth Service (CI Token Validation is only supported for a single partner organization on an XSP|ADP). Om du använder mTLS på autentiseringstjänsten innebär det att du inte kan ha klienter som använder grundläggande autentisering på autentiseringstjänsten samtidigt. This situation would prevent reuse of the XSP|ADP.

  • If the existing CTI Service configured to be used by clients with the secure port (typically 8012) but without mTLS (i.e., client authentication) then that will conflict with the webex requirement to have mTLS.

Because the XSP|ADP’s have many applications and the number of permutations of these applications is large, there may be other unidentified conflicts. For this reason, any potential reuse of XSP|ADP’s should be verified in a lab with the intended configuration prior to committing to the reuse.

Configure NTP Synchronization on XSP|ADP

The deployment requires time synchronization for all XSP|ADPs that you use with Webex.

Installera ntp-paketet efter att du har installerat operativsystemet och innan du har installerat BroadWorks-programvaran. Then you can configure NTP during the XSP|ADP software installation. Se BroadWorks Software Management-guiden för mer information.

During the interactive installation of the XSP|ADP software, you’re given the option to configure NTP. Fortsätt enligt följande:

  1. När installationsprogrammet frågar vill du konfigurera NTP?, ange y.

  2. När installationsprogrammet frågar: Kommer den här servern att vara en NTP-server? , ange n.

  3. När installationsprogrammet frågar, Vad är NTP-adressen, värdnamnet eller FQDN? anger du adressen till din NTP-server eller en offentlig NTP-tjänst, till exempel pool.ntp.org.

If your XSP|ADPs use silent (noninteractive) installation, the installer configuration file must include the following Key=Value pairs:

NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>

XSP|ADP Identity and Security Requirements

Bakgrund

Protokollen och chiffer för Cisco BroadWorks TLS-anslutningar kan konfigureras vid olika specificitetsnivåer. Dessa nivåer sträcker sig från den mest allmänna (SSL-leverantören) till den mest specifika (individuellt gränssnitt). En mer specifik inställning åsidosätter alltid en mer allmän inställning. Om de inte anges ärvs SSL-inställningar på lägre nivå från högre nivåer.

Om inga inställningar ändras från standardinställningarna ärver alla nivåer SSL-leverantörens standardinställningar (JSSE Java Secure Sockets Extension).

Kravlista

  • The XSP|ADP must authenticate itself to clients using a CA-signed certificate in which the Common Name or Subject Alternate Name matches the domain portion of the XSI interface.

  • Xsi-gränssnittet måste stödja TLSv1.2-protokollet.

  • XSI-gränssnittet måste använda en chiffersvit som uppfyller följande krav.

    • Diffie-Hellman Ephemeral (DHE) eller Elliptic Curves Diffie-Hellman Ephemeral (ECDHE) nyckelutbyte

    • AES (Advanced Encryption Standard) chiffer med en minsta blockeringsstorlek på 128 bitar (t.ex. AES-128 eller AES-256)

    • GCM (kontrer-/diskläge) eller chifferläge för CBC (chifferblockskedjor)

      • Om en CBC-chiffer används tillåts endast hashfunktionerna i SHA2-serien (SHA256, SHA384, SHA512).

Till exempel följande chiffer uppfyller kraven:

  • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384

  • TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384

  • TLS_DHE_RSA_WITH_AES_256_GCM_SHA384

  • TLS_DHE_PSK_WITH_AES_256_CBC_SHA384


 

The XSP|ADP CLI requires the IANA naming convention for cipher suites, as shown above, not the openSSL convention.

TLS-chiffer som stöds för AuthService- och XSI-gränssnitt


 

Listan kan komma att ändras i takt med att våra molnsäkerhetskrav förändras. Följ nuvarande cisco-molnsäkerhetsrekommendation för chifferval enligt beskrivningen i kravlistan i detta dokument.

  • TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384

  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

  • TLS_DHE_RSA_WITH_AES_256_GCM_SHA384

  • TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256

  • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256

  • TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256

  • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

  • TLS_DHE_RSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384

  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA256

  • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256

  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA256

  • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA

  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA

  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA

  • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA

  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA

  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA

  • TLS_RSA_PSK_WITH_AES_256_GCM_SHA384

  • TLS_DHE_PSK_WITH_AES_256_GCM_SHA384

  • TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256

  • TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256

  • TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256

  • TLS_RSA_WITH_AES_256_GCM_SHA384

  • TLS_PSK_WITH_AES_256_GCM_SHA384

  • TLS_PSK_WITH_CHACHA20_POLY1305_SHA256

  • TLS_RSA_PSK_WITH_AES_128_GCM_SHA256

  • TLS_DHE_PSK_WITH_AES_128_GCM_SHA256

  • TLS_RSA_WITH_AES_128_GCM_SHA256

  • TLS_PSK_WITH_AES_128_GCM_SHA256

  • TLS_RSA_WITH_AES_256_CBC_SHA256

  • TLS_RSA_WITH_AES_128_CBC_SHA256

  • TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384

  • TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA

  • TLS_RSA_PSK_WITH_AES_256_CBC_SHA384

  • TLS_DHE_PSK_WITH_AES_256_CBC_SHA384

  • TLS_RSA_PSK_WITH_AES_256_CBC_SHA

  • TLS_DHE_PSK_WITH_AES_256_CBC_SHA

  • TLS_RSA_WITH_AES_256_CBC_SHA

  • TLS_PSK_WITH_AES_256_CBC_SHA384

  • TLS_PSK_WITH_AES_256_CBC_SHA

  • TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256

  • TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA

  • TLS_RSA_PSK_WITH_AES_128_CBC_SHA256

  • TLS_DHE_PSK_WITH_AES_128_CBC_SHA256

  • TLS_RSA_PSK_WITH_AES_128_CBC_SHA

  • TLS_DHE_PSK_WITH_AES_128_CBC_SHA

  • TLS_RSA_WITH_AES_128_CBC_SHA

  • TLS_PSK_WITH_AES_128_CBC_SHA256

  • TLS_PSK_WITH_AES_128_CBC_SHA

Xsi-händelser skala parametrar

Du kan behöva öka köstorleken och antalet Xsi-Events-trådar för att hantera volymen av händelser som krävs av Webex för Cisco BroadWorks-lösningen. Du kan öka parametrarna till de minimumvärden som visas enligt följande (minska inte dem om de är över dessa minimumvärden):

XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration> eventQueueSize = 2000

XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration> eventHandlerThreadCount = 50

Multiple XSP|ADPs

Edge-element för laddningsbalans

If you have a load balancing element on your network edge, it must transparently handle the distribution of traffic between your multiple XSP|ADP servers and the Webex for Cisco BroadWorks cloud and clients. I detta fall anger du URL:en för laddningsbalanseringen till Webex för Cisco BroadWorks-konfigurationen.

Information om denna arkitektur:

  • Konfigurera DNS så att klienterna kan hitta laddningsbalanser vid anslutning till Xsi-gränssnittet (se DNS-konfiguration).

  • Vi rekommenderar att du konfigurerar Edge-elementet i omvänd SSL-proxyläge för att säkerställa punkt till punktdatakryptering.

  • Certificates from XSP|ADP01 and XSP|ADP02 should both have the XSP|ADP domain, for example your-XSP|ADP.example.com, in the Subject Alternate Name. They should have their own FQDNs, for example XSP|ADP01.example.com, in the Common Name. Du kan använda jokerteckencertifikat, men vi rekommenderar dem inte.

Internet-Facing XSP|ADP Servers

If you expose the Xsi interfaces directly, use DNS to distribute the traffic to the multiple XSP|ADP servers.

Information om denna arkitektur:

  • Two records are required to connect to the XSP|ADP servers:

    • For Webex microservices: Round-robin A/AAAA records are required to target the multiple XSP|ADP IP addresses. This is because the Webex microservices can’t do SRV lookups. For examples, see Webex Cloud Services.

    • For Webex App: An SRV record that resolves to A records where each A record resolves to a single XSP|ADP. For examples, see Webex App.

      Use prioritized SRV records to target the XSI service for the multiple XSP|ADP addresses. Prioritize your SRV records so that the microservices will always go to the same A record (and subsequent IP address) and will only move to the next A record (and IP address) if the first IP address is down. DO NOT use a round-robin approach for the Webex App.

  • Certificates from XSP|ADP01 and XSP|ADP02 should both have the XSP|ADP domain, for example your-XSP|ADP.example.com, in the Subject Alternate Name. They should have their own FQDNs, for example XSP|ADP01.example.com, in the Common Name.

  • Du kan använda jokerteckencertifikat, men vi rekommenderar dem inte.

Undvik HTTP-omdirigeringar

Sometimes, DNS is configured to resolve the XSP|ADP URL to an HTTP load balancer, and the load balancer is configured to redirect through a reverse proxy to the XSP|ADP servers.

Webex does not follow a redirect when connecting to the URLs you supply, so this configuration does not work.

Beställning och etablering

Beställning och etablering gäller på dessa nivåer:

  • Partner/Service Provider provisioning:

    Alla Webex för Cisco BroadWorks tjänsteleverantör (eller återförsäljare) som är onboarded måste konfigureras som en partnerorganisation i Webex och beviljas de nödvändiga berättigandena. Cisco-åtgärder ger partnerorganisationens administratör åtkomst till att hantera Webex för Cisco BroadWorks på Webex Partner Hub. Partneradministratören måste göra alla nödvändiga etableringssteg innan han eller hon kan etablera en kund-/företagsorganisation.

  • Customer/Enterprise ordering and provisioning:

    Varje BroadWorks-företag som är aktiverat för Webex för Cisco BroadWorks utlöser skapandet av en associerad Webex-kundorganisation. Denna process sker automatiskt som en del av etableringen av användare/prenumeranter. Alla användare/prenumeranter inom ett BroadWorks-företag etableras i samma Webex-kundorganisation.

    Samma beteende gäller om ditt BroadWorks-system är konfigurerat som ett tjänsteleverantör med grupper. När du etablerar en prenumerant i en BroadWorks-grupp, skapas automatiskt en kundorganisation som motsvarar gruppen i Webex.

  • User/Subscriber ordering and provisioning:

    Webex för Cisco BroadWorks har för närvarande stöd för följande användaretableringsmodeller:

    • Flowflödesetablering av betrodda e-postmeddelanden

    • Flowflödesetablering utan betrodda e-postmeddelanden

    • Självetablering av användare

    • API-etablering

Flowthrough Provisioning with Trusted Emails

Du konfigurerar den integrerade IM&P-tjänsten för att använda en URL för Webex-tillhandahållande och tilldelar sedan tjänsten till användarna. Programservern använder API:n för Webex-etablering för att begära motsvarande Webex-användarkonton.

Om du är nöjd med att BroadWorks har prenumeranters e-postadresser som är giltiga och unika för Webex, kommer detta etableringsalternativ automatiskt att skapa och aktivera Webex-konton med dessa e-postadresser som användar-ID.

Du kan ändra prenumerantpaketet via Partner Hub eller så kan du skriva ditt eget program för att använda det tillhandahållande API:et för att ändra prenumerantens paket.

Flowthrough Provisioning with Trusted Emails

Flowflödesetablering utan betrodda e-postmeddelanden

Du konfigurerar den integrerade IM&P-tjänsten för att använda en URL för Webex-tillhandahållande och tilldelar sedan tjänsten till användarna. Programservern använder API:n för Webex-etablering för att begära motsvarande Webex-användarkonton.

Om du inte kan förlita dig på prenumerantens e-postadresser som finns i BroadWorks skapar detta etableringsalternativ Webex-konton, men de kan inte aktiveras förrän prenumeranter har tillgång till och validerat sina e-postadresser. Då kan Webex aktivera kontona med dessa e-postadresser som användar-ID.

Flowflödesetablering utan betrodda e-postmeddelanden

Du kan ändra prenumerantpaketet via Partner Hub eller så kan du skriva ditt eget program för att använda det tillhandahållande API:et för att ändra prenumerantens paket.

Självetablering av användare

Med det här alternativet finns inget flowuppräckning för etablering från BroadWorks till Webex. När du har konfigurerat integreringen mellan Webex och ditt BroadWorks-system får du en eller flera länkar som är specifika för etablering av användare inom din Webex för Cisco BroadWorks-partnerorganisation.

Sedan utformar du dina egna meddelanden (eller delegater till dina kunder) så att länken fördelas till prenumeranter. Prenumeranterna följer länken och tillhandahåller sedan sina e-postadresser för att skapa och aktivera sina egna Webex-konton.

Självetablering av användare

Eftersom kontona etableras inom din partnerorganisations omfattning kan du manuellt justera användarpaket via Partner Hub eller använda API:et för att göra det.


 

Användare måste finnas i BroadWorks-systemet som du integrerar med Webex, eller så är de förbjudna att skapa konton med den länken.

tjänsteleverantör genom API:er

Webex visar en uppsättning offentliga API:er som gör det möjligt att bygga Webex för tillhandahållande av användare/prenumeranter i ditt befintliga arbetsflöde/verktyg för användarhantering.

Service Provider Provisioning by APIs - Trusted Emails
Service Provider Provisioning by APIs - Untrusted Emails

Nödvändiga programfixar med Flow-through Provisioning

Om du använder flow-through-provisionering måste du installera en systemkorrigering och tillämpa en CLI-egenskap. Se listan nedan för anvisningar som gäller för din BroadWorks-version:

För R22:

  1. Install AP.as.22.0.1123.ap376508.

  2. After installation, set the property bw.msg.includeIsEnterpriseInOSSschema to true from the CLI in Maintenance/ContainerOptions.

    Se korrigeringsanteckningarna för mer https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtinformation.

För R23:

  1. Install AP.as.23.0.1075.ap376509

  2. After installation, set the property bw.msg.includeIsEnterpriseInOSSschema to true from the CLI in Maintenance/ContainerOptions.

    Se korrigeringsanteckningarna för mer https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtinformation.

För R24:

  1. Install AP.as.24.0.944.ap375100

  2. After installation, set the property bw.msg.includeIsEnterpriseInOSSschema to true from the CLI in Maintenance/ContainerOptions.

    Se korrigeringsanteckningarna för mer https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtinformation.


 
När du har slutfört dessa steg kommer du inte att kunna tillhandahålla nya användare med UC-One-samarbetstjänster. Nyligen använda användare måste vara Webex för Cisco BroadWorks-användare.

Extension Dialing

Extension Dialing feature support allows Webex for Cisco Broadworks users to dial other users with an extension similar to the primary phone number within the same enterprise. This is especially useful for users who do not have DID numbers.

During provisioning, the extension of the users gets stored in the Webex directory as the user’s extension. For BroadWorks calling, the extension appears on the Webex App in the extension field of all the call initiation method areas and the user’s profile. Webex for Cisco BroadWorks supports extension-only calls between users within the same group and different groups of the same enterprise with the combination of location dialing code and extension. However, calling between two enterprises using only extensions is not supported.

An extension can be provisioned for the Cisco BroadWorks users through the following methods:

  • Cisco BroadWorks users

    • Public API provisioning as ‘extension

      • The extension parameter should be explicitly passed as part of the API call. For enterprises/groups that have Location Dialing Code (LDC) configured, the extension parameter should be the combination of LDC and 'extension number.

    • Flowthrough or Self-Activation provisioning

      • Extension and LDC (where applicable) will be automatically retrieved from BroadWorks.

  • BroadWorks-only Calling users or entities

    • Synced automatically from BroadWorks by Directory Sync using the combination of Location Dialing Code (LDC) and extension number.

Tabell 2. Managing of Extension numbers based on provisioning method

BroadWorks samtalsregister

Beskrivning

Provisioning method

Managing Extension

Webex för Cisco BroadWorks-användare

Användare är aktiverade för Webex för Cisco BroadWorks

Public API

Extension needs to be passed as parameter

Flowthrough

Extension retrieved from BroadWorks automatically

BroadWorks-only calling användare

Calling users who are not onboarded to Webex

Directory Sync

Extension synced by Directory sync

Enheter som inte använder samtal

T.ex. en telefon konferensrum, fax, huntgruppsnummer

Directory Sync

Extension synced by Directory sync

BroadWorks telefonlistor

Enterprise, Group or Personal Phone Lists

Directory Sync

Ej tillämpligt

Förutsättningar

  1. Client version required for supporting this feature is 42.11 or later.

  2. Patch where extension and location dialing codes are added to XSI and Provisioning Adapter February 2022 for version 23 or above as part of :

    • AP.platform.23.0.1075.ap380045

    • AP.as.23.0.1075.ap380045

    • AP.xsp.23.0.1075.ap380045

    • AP.as.24.0.944.ap380045

  3. Enable the header X-BroadWorks-Remote-Party-Info on the AS using the below CLI command for this SIP call flow which is required for extension dialing feature support.

    AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

App Call Options Priority

As part of the Extension Dialing feature support, The app call options priority setting is also provided at the partner level for all the Webex for Cisco Broadworks partners. Using this setting, the partner can control the call priority settings of all its managed customers from Partner Hub. The app call options priority setting for a customer can also be modified at a customer level from Control Hub.

The app call options priority setting contains extension as second option in both Partner Hub and Control Hub when a Webex for Cisco Broadworks user is newly provisioned with extension through any of the above-mentioned provisioning methods.

For all the existing provisioned Orgs, the extension option will be in the hidden state (by default) in the app call options priority setting. This will not show an extension in the audio/video call option of the user in the Webex App.

Following are the options to make the extension call option visible for the existing customers:

  1. If a partner wants all its managed customer orgs to be provided with an extension as one of the call options, it is recommended for the Partner Admin to move the Extension from hidden to available in Partner Hub. This will let the managed customer orgs inherit the setting from their partner.

  2. If a Partner wants to provide an extension in call options for a specific customer org, it is recommended for the Partner Admin to move the extension from hidden to available in Control Hub.

Group Contacts Support

This feature enhances the Webex for BroadWorks DirSync service by removing the limitation for syncing up to 1500 contacts from the Group phone lists on BroadWorks and allowing partners to sync up to 30K contacts from a single Group phone list and bring it on par with the 30K contacts increase for Enterprise phone list, which was released separately.

There is an overall limit of 200K for all external contacts per Organization, which would apply to the sum of Enterprise and Group phone lists in a single BroadWorks enterprise. For example, a BroadWorks enterprise that has Enterprise phone list with 30K and also 5 Group phone lists each with 30K will be supported (180K total per Org). However, if there are 6 group phone lists each with 30K, this will not be supported (210K total).


 

This feature is available on request. Please contact your account team to have it enabled.

  • Before enabling the feature, a prerequisite migration is to be run to provision and associate groups for all the existing provisioned users.

  • Cisco team will run an internal API to migrate any existing provisioned users to associate them with the correct group. OBSERVERA: This can take up to one week to process.

  • Once the migration is completed for the partner and the feature is enabled, any newly provisioned users will be 'grouped' appropriately.

After the feature is enabled, the DirSync service starts syncing BroadWorks Group phone list contacts into dedicated per group contact storage in the Webex Contact Service.

During provisioning, the enterprise group of the user needs to be stored in the Webex directory to indicate the group this user belongs to. The association of the user with a BroadWorks group in the Webex Directory allows the Webex app to do contact search in the Contact Service group storage for the specific group of the user.

The feature requires the Webex for BroadWorks subscribers to be provisioned in Webex with the BroadWorks enterprise Group Id.

The BroadWorks enterprise Group Id can be provisioned for the Cisco BroadWorks users through the following methods:

  • Webex för Cisco BroadWorks-användare

    • Public API provisioning as ‘spEnterpriseGroupId’

      • The BroadWorks enterprise Group Id should be explicitly passed in spEnterpriseGroupId parameter of the API call.

    • Flowthrough or Self-Activation provisioning

      • BroadWorks enterprise Group Id will be automatically retrieved from BroadWorks.

    • BroadWorks-only Calling users or entities

      • Not applicable. It’s not required to sync BroadWorks enterprise Group Id for these users.

Tabell 3. Managing of Enterprise Group ID based on provisioning method

BroadWorks samtalsregister

Beskrivning

Provisioning method

Managing Enterprise Group ID

Webex för Cisco BroadWorks-användare

Användare är aktiverade för Webex för Cisco BroadWorks

Public API

BroadWorks enterprise Group Id needs to be passed as parameter spEnterpriseGroupId

Flowthrough

BroadWorks enterprise Group Id is retrieved from BroadWorks automatically

BroadWorks-only calling användare

Calling users who are not onboarded to Webex

Directory Sync

Ej tillämpligt

Enheter som inte använder samtal

T.ex. en telefon konferensrum, fax, huntgruppsnummer

Directory Sync

Ej tillämpligt

BroadWorks telefonlistor

Contacts in the BroadWorks Group Phone Lists

Directory Sync

Group contacts are stored in Webex Contact Service associated with the specific group

BroadWorks Enterpsie or Persional phone lists

Contacts in the Enterprise or Personal Phone Lists

Directory Sync

Ej tillämpligt


 

Public API must be updated PRIOR to the MIGRATION. Migration cannot be completed until THIS API is completed The BroadWorks enterprise Group Id should be explicitly passed in spEnterpriseGroupId parameter of the API call https://developer.webex.com/docs/api/changelog#2023-march

After the feature is enabled and as a result of the next directory sync the enterprise user groups will also be displayed in Control Hub. Visualizing the groups in Control Hub for Webex for BroadWorks is purely informational at this stage. Partner and customer admins should not make any modifications to groups or group membership in Control Hub as these changes will not be reflected back to BroadWorks. Group Management in Control Hub is intended for use by partners who will be adopting the upcoming Contact Management APIs.

Migrering och framtida bevis på

Ciscos hemsida för BroadSoft Unified Communications-klienten är att flytta över från UC-One till Webex. Motsvarande nätverk för supporttjänster finns inte på tjänsteleverantör nätet – med undantag för samtal – mot Webex molnplattform.

Whether you’re running UC-One SaaS, or BroadWorks Collaborate, the preferred migration strategy is to deploy new, dedicated XSP|ADPs for integration with Webex for Cisco BroadWorks. Du kan köra de två tjänsterna samtidigt som du migrerar kunder till Webex, och så småningom ta tillbaka den infrastruktur som användes för den tidigare lösningen.

Recommended Document Subscriptions

Webex Help Center articles (on help.webex.com) have a Subscribe option that lets you receive an email notification whenever that article gets updated.

We recommend that you subscribe to each of the following articles to ensure that you don't miss out on critical updates that affect network connectivity. To subscribe, go to each of the below links and in the article that launches, click the Subscribe button.

At a minimum, we recommend that you subscribe to the above list. However, most of the Webex articles and documents listed under Additional Documents have a Subscribe option. For this option to appear, the article must appear on help.webex.com.


 
There is no subscription option for documentation landing pages.

Additional Documents

Refer to the following related documentation for more information about Webex for Cisco BroadWorks:

Webex for Cisco BroadWorks Documents

Partner administrators can use the following documents and sites to obtain information on Webex for Cisco BroadWorks.

Webex for Cisco BroadWorks Articles

Partner administrators can use the following optional sites to learn more about Webex for Cisco BroadWorks:

Cisco BroadWorks Documents

Partner administrators can refer to the Cisco BroadWorks site on cisco.com for technical documents that describe how to deploy the Cisco BroadWorks part of the solution:

Webex Help Articles

The following Webex Help sites can be used to find Webex articles that help customer administrators and end users to use Webex features.

  • Webex from Service Providers—This landing page contains links with getting started info and commonly used articles for Webex App users who purchased Webex services from a Service Provider.

  • Webex Help Center—Use the search feature at help.webex.com to search for additional Webex articles that describe Webex App and Webex Meetings functionality. You can search for either user or administrator articles.

Developer Documentation

Förbered din miljö

Beslutspunkter

Övervägande Frågor att besvara Resurser

Arkitektur och infrastruktur

How many XSP|ADPs?

Hur använder de mTLS?

Cisco BroadWorks systemkapacitetsplanerare

Teknikerguide för Cisco BroadWorks system

XSP|ADP CLI Reference

Det här dokumentet

Tillhandahållande av kunder och användare

Kan du litar på att du litar på e-postmeddelanden i BroadWorks?

Vill du att användare ska ange e-postadresser för att aktivera sina egna konton?

Kan du bygga verktyg för att använda vårt API?

Offentliga API-dokument på https://developer.webex.com

Det här dokumentet

Märkning Vilken färg och logotyp vill du använda? Varumärkesartikel om Webex-app
Mallar Vilka är dina olika kundanvändningsfall? Det här dokumentet
Prenumeranters funktioner per kund/företag/grupp Välj paket för att definiera servicenivå per mall. Basic, Standard, Premium eller Softphone.

Det här dokumentet

Funktions-/paketmatris

Användarautentisering BroadWorks eller Webex Det här dokumentet
Provisioneringsadapter (för flow flera etableringsalternativ)

Använder du redan integrerat IM&P, t.ex. för UC-One SaaS?

Vill du använda flera mallar?

Finns det ett vanligare användningsfall som förväntas?

Det här dokumentet

CLI-referens för programserver

Arkitektur och infrastruktur

  • Vilken typ av skala avser du att starta med? Det går att skala upp i framtiden, men din nuvarande användningsuppskattning bör driva infrastrukturplaneringen.

  • Work with your Cisco account manager / sales representative to size your XSP|ADP infrastructure, according to the Cisco BroadWorks System Capacity Planner and the Cisco BroadWorks System Engineering Guide.

  • How will Webex make Mutual TLS connections to your XSP|ADPs? Directly to the XSP|ADP in a DMZ, or via TLS proxy? This affects your certificate management, and the URLs you use for the interfaces. (We do not support unencrypted TCP connections to the edge of your network).

Tillhandahållande av kunder och användare

Vilken användares etableringsmetod passar dig bäst?

  • Flowthrough Provisioning With Trusted Emails: Genom att tilldela "integrerad IM&P"-tjänsten på BroadWorks etableras prenumeranterna automatiskt i Webex.

    Om du dessutom är säker på att prenumerantens e-postadresser i BroadWorks är giltiga och unika för Webex, kan du använda den "betrodda e-post"-varianten av flow vid etablering. Prenumeranters Webex-konton skapas och aktiveras utan åtgärder. de hämtar bara klienten och loggar in.

    E-postadress är ett nyckelanvändarattribut på Webex. Därför tjänsteleverantör ange en giltig e-postadress för användaren för att kunna tillhandahålla dem för Webex-tjänster. Detta måste finnas i användarens e-post-ID-attribut i BroadWorks. Vi rekommenderar att du även kopierar det till attributet Alternativt ID.

  • Flowthrough Provisioning Without Trusted Emails: Om du inte kan lita på prenumerantens e-postadresser kan du ändå tilldela den integrerade IM&P-tjänsten i BroadWorks för att tillhandahålla användare i Webex.

    Med det här alternativet skapas kontona när du tilldelar tjänsten, men prenumeranter måste tillhandahålla och validera sina e-postadresser för att aktivera Webex-kontona.

  • User Self-Provisioning: Det här alternativet kräver inte tilldelning av IM&P-tjänster i BroadWorks. Du (eller dina kunder) distribuerar en etableringslänk istället och länkarna för att hämta de olika klienterna, med din varuvisning och dina instruktioner.

    Prenumeranter följer länken och tillhandahåller sedan och validerar sina e-postadresser för att skapa och aktivera sina Webex-konton. Sedan hämtar de klienten och loggar in, och Webex hämtar viss ytterligare konfiguration om dem från BroadWorks (inklusive deras primära nummer).

  • SP Controlled Provisioning via APIs: Webex visar en uppsättning allmänna API:er som gör det möjligt för tjänsteleverantörer att bygga användare/prenumeranters etablering i sina befintliga arbetsflöden.

Provisioning Requirements

The following table summarizes the requirements for each provisioning method. In addition to these requirements, your deployment must meet the general system requirements that are described in this guide.

Provisioning Method

Krav

Flowflödesetablering

(Trusted or Untrusted emails)

The Webex provisioning API adds existing BroadWorks users to Webex automatically once the user meets requirements and you toggle the Integrated IM+P service to on.

There are two flows (trusted emails or untrusted emails) which you assign via the Onboarding template on Webex.

BroadWorks requirements:

  • User exists on BroadWorks with a primary number or extension.

  • User is assigned the Integrated IM+P service, which points to the Webex provisioning service URL.

  • Trusted emails only. The user has an email address configured on BroadWorks. We recommend that you also add the email to the Alternate ID field as this allows the user to log in using BroadWorks credentials.

  • BroadWorks has mandatory patches installed for flowthrough provisioning. See Required Patches with Flowthrough Provisioning (below) for patch requirements.

  • The BroadWorks AS is connected to the Webex cloud directly or the Provisioning Adapter Proxy is configured with connection to Webex provisioning service URL.

    See Configure Application Server with Provisioning Service URL to get the Webex provisioning service URL.

    See Cisco BroadWorks Implement Provisioning Adapter Proxy FD to configure the Provisioning Adapter Proxy.

Webex requirements:

The Onboarding template includes the following settings:

  • Enable BroadWorks Flow Through Provisioning toggle is on.

  • Provisioning account name and password is assigned using the BroadWorks system level admin credentials

  • User Verification is set to Trust BroadWorks emails or Untrusted Emails.

Självetablering av användare

Admin provides an existing BroadWorks user with a link to the User Activation Portal. The user must log in to the portal using BroadWorks credentials and provide a valid email address. After the email is validated, Webex fetches additional user information to complete provisioning.

BroadWorks requirements:

  • User must exist on BroadWorks with a primary number or extension

Webex requirements:

The Onboarding template includes the following settings:

  • Enable Flow Through Provisioning toggle is off.

  • User Verification is set to Untrusted Emails.

  • Allow users to self activate is checked.

SP controlled provisioning via API

(Trusted or Untrusted emails)

Webex exposes a set of public APIs that enable you to build user provisioning into your existing workflows and tools. There are two flows:

  • Trusted Emails—The API provisions the user, applying the BroadWorks email as the Webex email.

  • Untrusted Emails—The API provisions the user, but the user must log in to the User Activation Portal and provide a valid email address.

BroadWorks Requirements:

  • User must exist on BroadWorks with a primary number or extension.

Webex Requirements:

  • In the Onboarding template, the User Verification is set to either Trust BroadWorks emails or Untrusted Emails.

  • You must register your application, requesting permission.

  • You must request on OAuth token with the scopes that are highlighted in the “Authentication” section of the Webex for BroadWorks Developer Guide.

  • Must dedicate an admin or provisioning admin in your partner org.

To use the APIs, go to BroadWorks Subscribers.

Nödvändiga programfixar med Flow-through Provisioning

Om du använder flow-through-provisionering måste du installera en systemkorrigering och tillämpa en CLI-egenskap. Se listan nedan för anvisningar som gäller för din BroadWorks-version:

För R22:

  1. Install AP.as.22.0.1123.ap376508.

  2. After installation, set the property bw.msg.includeIsEnterpriseInOSSschema to true from the CLI in Maintenance/ContainerOptions.

    Se korrigeringsanteckningarna för mer https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtinformation.

För R23:

  1. Install AP.as.23.0.1075.ap376509

  2. After installation, set the property bw.msg.includeIsEnterpriseInOSSschema to true from the CLI in Maintenance/ContainerOptions.

    Se korrigeringsanteckningarna för mer https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtinformation.

För R24:

  1. Install AP.as.24.0.944.ap375100

  2. After installation, set the property bw.msg.includeIsEnterpriseInOSSschema to true from the CLI in Maintenance/ContainerOptions.

    Se korrigeringsanteckningarna för mer https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtinformation.


 
När du har slutfört dessa steg kommer du inte att kunna tillhandahålla nya användare med UC-One-samarbetstjänster. Nyligen använda användare måste vara Webex för Cisco BroadWorks-användare.

Supported Language Locales

Vid etableringen tilldelas automatiskt det språk som tilldelades i BroadWorks till den första provisionerade administrationsanvändaren som standardspråk för kundorganisationen. Den här inställningen avgör vilket standardspråk som används för e-postaktiveringar, möten och mötesinbjudningar inom denna kundorganisation.

Five character language locales in (ISO-639-1)_(ISO-3166) format are supported. For example, en_US corresponds to English_UnitedStates. If only a two letter language is requested (using ISO-639-1 format), the service will generate a five character language locale by combining the requested language with a country code from the template i.e. "requestedLanguage_CountryCode", if unable to get a valid locale, then the default sensible locale used based on the required language code.

The following table lists the supported locales, and the mapping that converts a two-letter language code to a five-character locale for situations where a five-character locale is not available.

Tabell 1. Supported Language Locale Codes

Supported Language Locales

(ISO-639-1)_(ISO-3166)

If only a two-letter language code is available...

Language code (ISO-639-1) **

Use Default Sensible Locale instead (ISO-639-1)_(ISO-3166)

en_US

en_AU

en_GB

en_Ca

en

en_US

fr_Fr

fr_Ca

fr

fr_Fr

cs_CZ

cs

cs_CZ

da_Dk

da

da_Dk

de_DE

de

de_DE

hu_Hu

hu

hu_Hu

id_ID

ID

id_ID

it_IT

it

it_IT

ja_Jp

ja

ja_Jp

ko_Kr

ko

ko_Kr

es_Es

es_CO

es_MX

es

es_Es

nl_Nl

nl

nl_Nl

nb_NO

nb

nb_NO

pl_PL

pl

pl_PL

pt_PT

pt_Br

pt

pt_PT

ru_Ru

ru

ru_Ru

ro_RO

ro

ro_RO

zh_Cn

zh_TW

zh

zh_Cn

sv_SE

sv

sv_SE

ar_Sa

ar

ar_Sa

tr_Tr

tr

tr_Tr


 

The locales es_CO, id_ID, nb_NO and pt_PT are not supported by Webex Meeting Sites. For these locales, The Webex Meetings sites will be in English only. English is the default locale for sites if no/invalid/unsupported locale is required for the site. This language field is applicable while creating an Organization and Webex Meetings site. If no language is mentioned in a post or in the subscriber's API then language from the template will be used as a default language.

Märkning

Partneradministratörer kan använda Avancerade anpassningar för att anpassa hur Webex-appen ser ut för kundorganisationer som partnern hanterar. Partneradministratörer kan anpassa följande inställningar för att säkerställa att Webex-appen återspeglar deras företagsvarumärke och identitet:

  • Företagslogotyp

  • Unika färgscheman för ljusläge eller mörkt läge

  • Anpassade support-URL:er

For details on how to customize branding, refer to Configure Advanced Branding Customizations.


 
  • Basic Branding customizations are in the process of being deprecated. We recommend that you deploy Advanced Branding, which offers a wider range of customizations.

  • For details on how branding is applied when attaching to a pre-existing Customer Organization, refer to Conditions of Org Attachment under the Attach Webex for BroadWorks to Existing Organization section.

Onboarding templates

Onboarding templates allow you to define the parameters by which customers and associated subscribers are automatically provisioned on Webex for Cisco BroadWorks. You may configure multiple Onboarding templates as required, but when you onboard a customer it is associated with only one template (you cannot apply multiple templates to one customer).

Några av de primära mallparametrarna listas nedan.

Paket

  • Du måste välja ett standardpaket när du skapar en mall (Se Paket i avsnittet Översikt för information). Alla användare som etableras med den här mallen, oavsett om de använder flowuppringning eller självetablering, får standardpaketet.

  • Du har kontroll över paketvalet för olika kunder genom att skapa flera mallar och välja olika standardpaket i varje. Du kan sedan distribuera olika etableringslänkar, eller olika provisioneringsadaptrar per företag, beroende på vilken användaretableringsmetod som du har valt för mallarna.

  • You can change the package of specific subscribers from this default, using the provisioning API (see Webex for Cisco BroadWorks API documentation or through Partner Hub (see Change User Package in Partner Hub).

  • Du kan inte ändra en prenumerantens paket från BroadWorks. Tilldelningen av den integrerade IM&P-tjänsten är på eller av. Om prenumeranten tilldelas denna tjänst i BroadWorks definierar den partnerhubben som är associerad med prenumerantens företags etablerings-URL paketet.

Återförsäljare och företag eller tjänsteleverantör och grupper?

  • Det sätt på vilket ditt BroadWorks-system konfigureras påverkar flödet via etableringen. Om du är en återförsäljare med företag måste du aktivera företagsläget när du skapar en mall.

  • Om BroadWorks-systemet är konfigurerat i tjänsteleverantör-läge kan du lämna enterprise-läget inaktiverat i dina mallar.

  • Om du planerar att etablera kundorganisationer med båda BroadWorks-lägena måste du använda olika mallar för grupper och företag.


 
Se till att du har tillämpat BroadWorks-korrigeringar som krävs för flöde genom etablering. Mer information finns i Obligatoriska korrigeringar med Flow-through Provisioning.

Autentiseringsläge

Decide how you want subscribers to authenticate when they log in to Webex. You can assign the mode using the Authentication Mode setting in the Onboarding template. The following table outlines some of the options.


 
This setting has no effect on login to the User Activation Portal. Users who sign in to the portal must enter their BroadWorks user ID and password, as configured on BroadWorks, irrespective of how you configure Authentication Mode on the Onboarding template.
Autentiseringsläge BroadWorks Webex
Primär användaridentitet BroadWorks användar-id E-postadress
Identitetsleverantör

BroadWorks.

  • If you configure a direct connection to BroadWorks, the Webex App authenticates to the BroadWorks server directly.

    To configure a direct connection, the Enable direct BroadWorks authentication check box must be checked within the BroadWorks cluster configuration on Partner Hub (by default, the setting is unchecked).

  • Annars underlättas autentisering till BroadWorks genom en kundtjänst som Webex är värd för.

Cisco Common Identity
Multi-faktorautentisering? Nej Kräver kund-IdP som har stöd för autentisering med flera faktorer.

Valideringssökväg för autentiseringsuppgifter

  1. Webbläsaren startas där användare levererar e-post till det första inloggningsflödet och upptäcker sitt autentiseringsläge.

  2. Webbläsaren omdirigeras sedan till en BroadWorks-inloggningssida som är värd för Webex (denna sida är märkbar)

  3. Användaren levererar BroadWorks-användar-ID och lösenord på inloggningssidan.

  4. Användaruppgifterna är validerade mot BroadWorks.

  5. När det har lyckats hämtas en behörighetskod från Webex. Detta används för att erhålla nödvändiga åtkomsttoken för Webex-tjänster.

  1. Webbläsaren startas där användare levererar e-post till det första inloggningsflödet och upptäcker sitt autentiseringsläge.

  2. Webbläsaren omdirigeras till IdP (antingen Cisco Common Identity eller Customer IdP) där de kommer att se en inloggningsportal.

  3. Användare tillhandahåller lämpliga inloggningsuppgifter på inloggningssidan

  4. Flerfunktionsautentisering kan äga rum om kund-IdP:en stöder detta.

  5. När det har lyckats hämtas en behörighetskod från Webex. Detta används för att erhålla nödvändiga åtkomsttoken för Webex-tjänster.


 
Mer detaljerad analys av inloggningsflödet SSO med direktautentisering i BroadWorks finns i SSO Login Flow.

UTF-8 Encoding with BroadWorks Authentication

With BroadWorks authentication, we recommend that you configure UTF-8 encoding for the authentication header. UTF-8 resolves an issue that can occur with passwords that use special characters whereby the web browser does not encode the characters properly. Using a UTF-8 encoded, base 64-encoded header resolves this issue.

You can configure UTF-8 encoding by running one of the following CLI commands on the XSP or ADP:

  • XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

  • ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

Land

You must select a country when you create a template. This country will be automatically assigned as the organisation country for all the customers that are provisioned with the template in Common Identity. Additionally, the organization country will determine the default global call-in numbers for Cisco PSTN in Webex Meeting Sites.

The site's default global call-in numbers will be set to the first available dial-in number defined in the telephony domain based on the organization's country. If the organization's country is not found in the dial-in number defined in the telephony domain, the default number of that location will be used.

Tabell 2. The following table lists the default call-in country code based on each location:

S No.

Plats

Landskod

Namn på land

1

AMER

+1

US, CA

2

APAC

+65

Singapore

3

Anz

+61

Australien

4

Europa, Mellanöstern och Afrika

+44

STORBRITANNIEN

5

EURO

+49

Tyskland

Flera partner är inte uppsypnade

Kommer du att använda underlicensiera Webex för Cisco BroadWorks till en annan tjänsteleverantör? I detta fall behöver varje tjänsteleverantör en tydlig partnerorganisation i Webex Control Hub att ge dem lösningen för sin kundbas.

Provisioneringsadapter och mallar

När du använder flowspelar provisionering hämtas den url för tillhandahållande som du anger i BroadWorks från mallen i Control Hub. Du kan ha flera mallar och därmed flera url:er för tillhandahållande. Detta gör det möjligt för dig att, på företag-basis, välja vilket paket som ska tillämpas på prenumeranter när de tilldelas den integrerade IM&P-tjänsten.

Du måste fundera över om du vill ställa in en URL för tillhandahållande på systemnivå som en standardsökväg till etablering och vilken mall du vill använda för det. På det här sättet behöver du endast explicit ange etablerings-URL:en för företag som behöver en annan mall.

Kom också ihåg att du kanske redan använder en URL för tillhandahållande av systemnivå, till exempel UC-One SaaS. If that is the case, you may opt to preserve the system level URL for provisioning users on UC-One SaaS, and override for those enterprises moving to Webex for Cisco BroadWorks. Alternativt kan du gå den andra vägen och ställa in systemnivå-URL:en för Webex för BroadWorks och konfigurera om de företag som du vill behålla på UC-One SaaS.

The configuration choices related to this decision are detailed in Configure Application Server with Provisioning Service URL.

Provisioning Adapter Proxy

For added security, the Provisioning Adapter Proxy lets you use an HTTP(S) proxy on the Application Delivery Platform for flowthrough provisioning between the AS and Webex. The proxy connection creates an end-to-end TCP tunnel that relays traffic between the AS and Webex, thereby negating the need for the AS to connect to the public internet directly. For secure connections, TLS can be used.

This feature requires that you set up the proxy on BroadWorks. For details, see Cisco BroadWorks Provisioning Adapter Proxy Feature Description.

Minimikrav

Konton

Alla prenumeranter som du etablerar för Webex måste finnas i BroadWorks-systemet som du integrerar med Webex. Du kan integrera flera BroadWorks-system om det behövs.

All subscribers must have BroadWorks licenses and a primary number or extension.

Webex använder e-postadresser som primära identifierare för alla användare. Om du använder flow attributet provisionering med betrodda e-postmeddelanden måste dina användare ha giltiga adresser i e-postattributet i BroadWorks.

Om din mall använder BroadWorks-autentisering kan du kopiera prenumerantens e-postadresser till attributet Alternativt ID i BroadWorks. Detta gör det möjligt för användare att logga in på Webex med sina e-postadresser och sina BroadWorks-lösenord.

Dina administratörer måste använda sina Webex-konton för att logga in på Partner Hub.


 
It is not supported to onboard a BroadWorks administrator to Webex for Cisco BroadWorks. You can only onboard BroadWorks calling users who have a primary number and/or extension. If you are using flowthrough provisioning, users must also be assigned the Integrated IM&P service.

Servrar som uppfyller dina nätverks- och programvarukrav

  • BroadWorks-instanser ska innehålla minst följande servrar:

    • Programserver (AS) med BroadWorks-version enligt ovan

    • Nätverksserver (NS)

    • Profilserver (PS)

  • Public-facing XSP|ADP Server(s) or Application Delivery Platform (ADP) meeting the following requirements:

    • Verifieringstjänst (BWAuth)

    • Gränssnitt för XSI-åtgärder och -händelser

    • DMS (webbprogram för enhetshantering)

    • CTI-gränssnitt (datortelefoniintergration)

    • TLS 1.2 med ett giltigt certifikat (inte själv signerade) och alla mellanliggande krävs. Kräver administratör på systemnivå för att underlätta företags sökning.

    • Autentisering via ömsesidig TLS (mTLS) för autentiseringstjänsten (kräver att den offentliga Webex-klientcertifikatkedjan är installerad som betrodda ankare)

    • Ömsesidig TLS-autentisering (mTLS) för CTI-gränssnitt (kräver att den offentliga Webex-klientcertifikatkedjan är installerad som betrodda ankare)

  • En separat XSP/ADP-server som fungerar som en "push-server för samtalsaviseringar" (ett NPS-program i din miljö som används för att skicka samtalsaviseringar till Apple/Google. Vi kallar det "CNPS" här för att skilja det från tjänsten i Webex som levererar push-aviseringar för meddelanden och närvaro).

    Servern måste vara på R22 eller senare.

  • Vi beg?r ett separat XSP/ADP-server f?r CNPS eftersom opåg?rlighet f?r laddningen från Webex f?r BWKS-molnanslutningar kan ha en negativ inverkan p? NPS-serverns prestanda p? grund av den allt fler meddelandelatensen. See the Cisco BroadWorks System Engineering Guide for more on XSP|ADP scale.

Plattformar för Webex-app

Fysiska telefoner och tillbehör

Device Integration

For details on how to onboard and service Room OS and MPP devices for Webex for Cisco BroadWorks, see Device Integration Guide for Webex for Cisco BroadWorks.

Enhetsprofiler

Following are the DTAF files you need to load onto your Application Servers to support the Webex App as a calling client. They are the same DTAF files as used for UC-One SaaS, however there is a new config-wxt.xml.template file that is used for the Webex App.

To download the latest device profiles, go to the Application Delivery Platform Software Downloads site to get the latest DTAF files. These downloads work for both ADP and XSP.

Klientnamn

Enhetsprofiltyp och paketnamn

Webex mobilmall

Identitets-/enhetsprofiltyp: Anslut – mobil

DTAF: ucone-mobile-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Konfigurationsfil: config-wxt.xml

Webex-surfplattamall

Identitets-/enhetsprofiltyp: Anslut – surfplatta

DTAF: ucone-tablet-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Konfigurationsfil: config-wxt.xml

Webex skrivbordsmall

Identitets-/enhetsprofiltyp: Business Communicator – PC

DTAF: ucone-desktop-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Konfigurationsfil: config-wxt.xml

Identify/Device Profile

All Webex for Cisco BroadWorks users must have an Identity/Device Profile assigned in BroadWorks that uses one of the above device profiles in order to make calls using the Webex App. The profile provides the configuration that allows the user to place calls.

Obtaining OAuth credentials for your Webex for Cisco BroadWorks

Raise a service request with your onboarding agent or with Cisco TAC to provision Cisco OAuth for your Cisco Identity Provider Federation account.

Use the following request title for respective features:

  1. XSP|ADP AuthService Configuration' to configure service on XSP|ADP.

  2. 'NPS Configuration for Auth Proxy Setup' to configure NPS to use authentication proxy.

  3. CI User UUID Sync' for CI user UUID sync. For more details on this feature, see: Cisco BroadWorks support for CI UUID.

  4. Configure BroadWorks to enable Cisco Billing for BroadWorks and Webex For BroadWorks Subscriptions.

Cisco ger dig ett OAuth-klient-ID, en klienthemlighet och en uppdateringstoken som är giltig i 60 dagar. If the token expires before you use it, you can raise another request.


 

If you already obtained Cisco OAuth Identity Provider credentials, complete a new service request to update your credentials.

Beställningscertifikat

Certifikatkrav för TLS-autentisering

You will need Security Certificates, signed by a well-known Certificate Authority and deployed on your Public facing XSP|ADPs, for all required applications. These will be used to support TLS certificate verification for all inbound connectivity to your XSP|ADP servers.

These certificates should include your XSP|ADP public fully qualified domain name as Subject Common Name or Subject Alternate Name.

The exact requirements for deploying these server certificates depends on how your public facing XSP|ADPs are deployed:

  • Via en TLS-bryggsproxy

  • Via en TLS-passer-through proxy

  • Directly to the XSP|ADP

Följande diagram sammanfattar där det CA-signerade offentliga servercertifikatet måste läsas in i dessa tre fall:

De offentligt stödda ca:erna som Webex-appen stöder för autentisering listas i Certifikatutfärdare som stöds för Webex Hybrid-tjänster.

TLS-certifikatkrav för TLS-bridge-proxy

  • Det offentligt signerade servercertifikatet har lästs in i proxyn.

  • Proxyn visar detta offentligt signerade servercertifikat för Webex.

  • Webex litar på den allmänna CA:en som signerade proxyns servercertifikat.

  • An internal CA signed certificate can be loaded onto the XSP|ADP.

  • The XSP|ADP presents this internally signed server certificate to the proxy.

  • The proxy trusts the internal CA that signed the XSP|ADP server certificate.

TLS Certificate Requirements for TLS-passthrough Proxy or XSP|ADP in DMZ

  • The publicly signed server certificate is loaded into the XSP|ADPs.

  • The XSP|ADPs present publicly signed server certificates to Webex.

  • Webex trusts the public CA that signed the XSP|ADPs’ server certificates.

Ytterligare certifikatkrav för ömsesidig TLS-autentisering över CTI Interface

Vid anslutning till CTI-gränssnittet visar Webex ett klientcertifikat som en del av den ömsesidiga TLS-autentiseringen. Webex klientcertifikat CA/kedjecertifikat finns att hämta via Control Hub.

Hämta certifikatet:

Logga in på Partner Hub, gå till Inställningar > BroadWorks-samtal och klicka på länken hämta certifikat.

The exact requirements for deploying this Webex CA certificate chain depends on how your public facing XSP|ADPs are deployed:

  • Via en TLS-bryggsproxy

  • Via en TLS-passer-through proxy

  • Directly to the XSP|ADP

Följande diagram sammanfattar certifikatkraven i följande tre fall:

mTLS Certificate Exchange for CTI via Different Edge Configurations

(Alternativ) Certifikatkrav för TLS-bridge-proxy

  • Webex visar ett offentligt signerat klientcertifikat för proxyn.

  • Proxyn litar på Ciscos interna CA som signerade klientcertifikatet. Du kan hämta denna CA/-kedja från Control Hub och lägga till den i proxyns betrodda lagring. The publicly signed XSP|ADP server certificate is also loaded into the proxy.

  • Proxyn visar det offentligt signerade servercertifikatet för Webex.

  • Webex litar på den allmänna CA:en som signerade proxyns servercertifikat.

  • The proxy presents an internally signed client certificate to the XSP|ADPs.

    Det här certifikatet måste ha tilläggsfältet x509.v3 för utökad nyckel ifylld med BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 och TLS-klientenAuth- syfte. E.g.:

    X509v3-anknytningar:     X509v3 Utökad nyckelanvändning:  1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS webbklientverifiering

    CN för det interna certifikatet måste vara bwcticlient.webex.com.


     
    • När du genererar interna klientcertifikat för proxyn ska du observera att SAN-certifikat inte stöds. Internal server certificates for the XSP|ADP can be SAN.

    • Offentliga certifikatutfärdare kanske inte är villiga att signera certifikat med det egna BroadWorks OID som krävs. In the case of a bridging proxy, you may be forced to use an internal CA to sign the client certificate that the proxy presents to the XSP|ADP.

  • The XSP|ADPs trust the internal CA.

  • The XSP|ADPs present an internally signed server certificate.

  • Proxyn litar på den interna CA:en.

  • The Application Server’s ClientIdentity contains the CN of the internally signed client certificate presented to the XSP|ADP by the proxy.

(Option) Certificate Requirements for TLS-passthrough Proxy or XSP|ADP in DMZ

  • Webex presents a Cisco internal CA-signed client certificate to the XSP|ADPs.

  • The XSP|ADPs trust the Cisco internal CA that signed the client certificate. Du kan hämta denna CA/-kedja från Control Hub och lägga till den i proxyns betrodda lagring. The publicly signed XSP|ADP server certificate is also loaded into the XSP|ADPs.

  • The XSP|ADPs present the publicly signed server certificates to Webex.

  • Webex trusts the public CA that signed the XSP|ADPs’ server certificates.

  • The Application Server ClientIdentity contains the CN of the Cisco-signed client certificate presented to the XSP|ADP by Webex.

Förbered ditt nätverk

For more information on connections that are used by Webex for Cisco BroadWorks, see: Network Requirements for Webex for Cisco BroadWorks. This article has the list of IP addresses, ports and protocols required to configure your firewall Ingress and Egress rules.

Nätverkskrav för Webex-tjänster

Tabellerna som föregår tabellerna Ingress och Utgångsregler brandväggar dokumenterar endast de anslutningar som är specifika för Webex för Cisco BroadWorks. För allmän information om anslutningar mellan Webex-appen och Webex-molnet, se Nätverkskrav för Webex-tjänster. Den här artikeln är allmän för Webex, men följande tabell identifierar de olika avsnitten i artikeln och hur relevanta varje avsnitt är för Webex för Cisco BroadWorks.

Tabell 3. Nätverkskrav för Webex-appanslutningar (allmänna)

Avsnitt i artikel om nätverkskrav

Anknytning av information

Sammanfattning av enhetstyper och protokoll som stöds av Webex

Information

Transportprotokoll och kryptering chiffer för molnregistrerade Webex-appar och -enheter

Information

Webex-tjänster – portnummer och -protokoll

Måste läsa

IP-undernät för Webex-medietjänster

Måste läsa

Domäner och URL:er som behöver nås för Webex-tjänster

Måste läsa

Ytterligare URL:er till Webex Hybrid-tjänster

Valfritt

Proxyfunktioner

Valfritt

802.1X – Portbaserad nätverksåtkomstkontroll

Valfritt

Nätverkskrav för SIP-baserade Webex-tjänster

Valfritt

Nätverkskrav för Webex Edge-ljud

Valfritt

En sammanfattning av andra Webex Hybrid-tjänster och dokumentation

Valfritt

Webex-tjänster för FedRAMP-kunder

Ej tillämpligt

Ytterligare information

För ytterligare information, se Webex App Firewall Whitepaper (PDF).

Stöd för BroadWorks-redundans

The Webex Cloud Services and the Webex Client Apps that need to access the partner’s network fully support the Broadworks XSP|ADP redundancy provided by the partner. When an XSP|ADP or site is unavailable for planned maintenance or unplanned reason, the Webex services & apps are able to advance to another XSP|ADP or site provided by the partner in order to complete a request.

Nätverkstopologin

The Broadworks XSP|ADPs can be deployed directly on the Internet, or can reside in a DMZ fronted by a load balancing element such as the F5 BIG-IP. To provide geo-redundancy, the XSP|ADPs can be deployed in two (or more) datacenters, each can be fronted by a load balancer, each having a public IP address. If the XSP|ADPs are behind a load balancer, the Webex microservices and App see only the IP address of the load balancer and Broadworks appears to have just one XSP|ADP, even if there are multiple XSP|ADPs behind.

In the example below, the XSP|ADPs are deployed at two sites, Site A and Site B. There are two XSP|ADPs fronted by a Load Balancer at each site. Site A has XSP|ADP1 and XSP|ADP2 fronted by LB1, and Site B has XSP|ADP3 and XSP|ADP4 fronted by LB2. Only the Load Balancers are exposed on the public network, and the XSP|ADPs are in the DMZ private networks.

Webex-molntjänster

DNS-konfiguration

The Webex Cloud microservices must be able to find the Broadworks XSP|ADP server(s) for connecting to the Xsi interfaces, authentication service and CTI.

Webex Cloud microservices will perform DNS A/AAAA lookup of the configured XSP|ADP hostname and connect to the returned IP Address. This could be a load balancing edge element, or it could be the XSP|ADP server itself. Om flera IP-adresser returneras markeras den första IP-adressen i listan. SRV sökning stöds för närvarande inte.

Exempel: The partner’s DNS A Record for discovery of Round-Robin balanced internet-facing XSP|ADP server/Load Balancers.

Inspelningstyp

Namn

Target

Syfte

Svar

webex-cloud-xsp.example.com

198.51.100.48

Pekar på HAR ATT GÖRA MED 1 (webbplats A)

Svar

webex-cloud-xsp.example.com

198.51.100.49

Pekar på HARS2 (webbplats B)


 

Any reference to XSP includes either XSP or ADP.

Failover

When the Webex microservices send a request to the XSP|ADP/Load Balancer and the request fails, several things can happen:

  • Om felet beror på ett nätverksfel (t.ex. TCP, SSL), Webex-mikrotjänster markerar IP som blockerad och utför omedelbart en vidarelinje till nästa IP.

  • If an error code (HTTP 5xx) is returned, the Webex microservices mark the IP as blocked and immediately perform a route advance to the next IP.

  • Om inget HTTP-svar tas emot inom två sekunder ger begäran slut och Webex-mikrotjänster markerar IP som blockerade och utför en vidaresändning till nästa IP.

Varje förfrågan prövas tre gånger innan ett fel rapporteras tillbaka till mikrotjänsten.

When an IP is in the blocked list, it will not be included in the list of addresses to try when sending a request to a XSP|ADP. Efter en fördefinierad tidsperiod löper en blockerad IP ut och går tillbaka i listan för att försöka när en annan förfrågan görs.

Om alla IP-adresser är blockerade försöker mikrotjänsten fortfarande skicka begäran genom att slumpmässigt välja en IP-adress från listan över blockerade. Om det lyckas tas IP-adressen bort från listan över blockerade.

Status

The status of the connectivity of the Webex Cloud services to the XSP|ADPs or Load Balancers can be seen in Control Hub. Under ett BroadWorks-samtalskluster visas en anslutningsstatus för vart och ett av dessa gränssnitt:

  • XSI Actions

  • XSI Events

  • Verifieringstjänst

Anslutningsstatusen uppdateras när sidan laddas eller under inmatningsuppdateringar. Anslutningsstatusen kan vara:

  • Grön: När gränssnittet kan nås via en av IP-adresser i en inspelningsuppslag.

  • Röda: När alla IP-adresser i en inspelningsuppslag inte kan nås och gränssnittet inte är tillgängligt.

The following services use the microservices to connect to the XSP|ADPs and are impacted by the XSP|ADP interface availability:

  • Inloggning för Webex-app

  • Uppdatering av Token för Webex-app

  • Opålitisk e-post/självaktivering

  • Broadworks-tjänstens hälsokontroll

Webex-appen

DNS-konfiguration

The Webex App accesses the Xtended Services Interface (XSI-Actions & XSI-Events) and Device Management Service (DMS) services on the XSP|ADP.

To find the XSI service, the Webex App performs DNS SRV lookup for _xsi-client._tcp.<webex app xsi domain>. The SRV points to the configured URL for the XSP|ADP hosts or load balancers for the XSI service. If SRV lookup is not available, the Webex App falls back to A/AAAA lookup.

The SRV can resolve to multiple A/AAAA targets. However, each A/AAAA record must map to a single IP address only. If there are multiple XSP|ADPs in a DMZ behind the load balancer/edge device, it is required that the load balancer be configured to maintain session persistence to route all requests of the same session to the same XSP|ADP. We mandate this configuration because the client's XSI-event heartbeats must go to the same XSP|ADP that is used to establish the event channel.


 

In Example 1, the A/AAAA record for webex-app-XSP|ADP.example.com does not exist, and does not need to. If your DNS requires that one A/AAAA record must be defined, then only 1 IP address should be returned. Regardless, the SRV must still be defined for the Webex App.

If the Webex App uses the A/AAAA name that resolves to more than one IP address, or if the load balancer/edge element does not maintain session persistence, the client eventually sends heartbeats to an XSP|ADP where it did not establish an event channel. This results in the channel being torn down, and also in significantly more internal traffic which impairs your XSP|ADP cluster performance.

Because the Webex Cloud and Webex App have different requirements in A/AAAA record lookup, you must use a separate FQDN for the Webex Cloud and Webex App to access your XSP|ADPs. As shown in the examples, Webex Cloud uses A record webex-cloud-xsp.example.com, and Webex App uses SRV _xsi-client._tcp.webex-app-xsp.example.com.

Example 1—Multiple XSP|ADPs, each behind separate load balancers

In this example, the SRV points to mutiple A records with each A record pointing to a different load balancer at a different site. The Webex App will always use the first IP address in the list and will only move to the next record if the first is down.

Nedan är ett exempel på SRV poster.

Inspelningstyp

Spela in

Target

Syfte

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc1.example.com

Klientupptäckt av Xsi-gränssnitt

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc2.example.com

Klientupptäckt av Xsi-gränssnitt

Svar

xsp-dc1.example.com

198.51.100.48

Pekar på HAR ATT GÖRA MED 1 (webbplats A)

Svar

xsp-dc2.example.com

198.51.100.49

Pekar på HARS2 (webbplats B)

Example 2—Multiple XSP|ADPs behind a single load balancer (with TLS Bridge)

For the initial request, the load balancer selects a random XSP|ADP. That XSP|ADP returns a cookie that the Webex App includes in future requests. For future requests, the load balancer uses the cookie to route the connection to the correct XSP|ADP, ensuring that the event channel doesn't break.

Inspelningstyp

Spela in

Target

Syfte

SRV

_xsi-client._tcp.webex-app-xsp.example.com

LB.example.com

Load balancer

Svar

LB.example.com

198.51.100.83

IP address of load balancer (XSP|ADPs are behind load balancer)

DMS URL

Under inloggningsprocessen kommer Webex-appen också att hämta DMS-URL:en för att hämta konfigurationsfilen. The host in the URL will parsed and the Webex App will perform DNS A/AAAA lookup of the host to connect to the XSP|ADP that hosts the DMS service.

Exempel: DNS A Record for discovery of Round-Robin balanced internet-facing XSP|ADP server/Load Balancers by Webex App to download config files through DMS:

Inspelningstyp

Namn

Target

Syfte

Svar

xsp-dms.example.com

198.51.100.48

Pekar på HAR ATT GÖRA MED 1 (webbplats A)

Svar

xsp-dms.example.com

198.51.100.49

Pekar på HARS2 (webbplats B)


 
Any reference to XSP includes either XSP or ADP.
How Webex App Finds XSP|ADP Addresses

The client attempts to locate the XSP|ADP nodes using the following DNS flow:

  1. Klienten hämtar inledningsvis Xsi-Actions/Xsi-Events-URL:er från Webex Cloud (du angav dem när du skapade associerat BroadWorks-samtalskluster). Xsi-värdnamn/-domän analyseras från URL:en och klienten utför SRV sökning enligt följande:

    1. Client performs an SRV lookup for _xsi-client._tcp.<xsi domain>

    2. If the SRV lookup returns one or more A/AAAA targets:

      1. Klienten gör en A/AAAA-sökning efter dessa mål och cachelagrar de returnerade IP-adresserna.

      2. Klienten ansluter till ett av målen (och därmed sin A/AAAA-registrering med en enda IP-adress) baserat på SRV prioritet och sedan vikten (eller slumpmässigt om alla är lika).

    3. Om den SRV inte returnerar några mål:

      Klienten gör en A/AAAA-sökning av Xsi-rotparametern och försöker sedan ansluta till den returnerade IP-adressen. This could be a load balancing edge element, or it could be the XSP|ADP server itself.

      Som nämnts ovan måste A/AAAA-posten åtgärdas till en IP-adress av samma anledning.

  2. (Valfritt) Därefter kan du tillhandahålla anpassade XSI-Actions/XSI-Events-uppgifter i enhetskonfigurationen för Webex-appen med följande taggar:

    <protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>

    1. Dessa konfigurationsparametrar har företräde framför en konfiguration i ditt BroadWorks-kluster i Control Hub.

    2. Om de finns jämförs klienten med den ursprungliga XSI-adressen den tog emot via BroadWorks-klusterkonfigurationen.

    3. Om någon skillnad upptäcks kommer klienten att initiera om anslutningen till XSI Actions/XSI Events. The first step in this is to perform the same DNS lookup process listed under step 1 – this time requesting a lookup for the value in the %XSI_ROOT_WXT% parameter from its configuration file.


       
      Se till att skapa motsvarande poster SRV du använder den här taggen för att ändra Xsi-gränssnitten.
Failover

During login, the Webex App performs a DNS SRV lookup for _xsi-client._tcp.<xsi domain>, builds a list of hosts, and connects to one of the hosts based on the SRV priority, then weight. Denna anslutna värd blir vald för alla framtida förfrågningar. En händelsekanal öppnas sedan för den valda värden och ett hjärtslag skickas regelbundet för att verifiera kanalen. All requests sent after the first one include a cookie that is returned in the HTTP response, therefore, it’s important that the load balancer keeps session persistence (affinity) and always sends requests to the same backend XSP|ADP server.

Om en begäran eller en pulsslagsförfrågan till en värd misslyckas kan flera saker hända:

  • Om felet beror på ett nätverksfel (t.ex. TCP, SSL) går Webex-appen vidare direkt till nästa värd i listan.

  • If an error code (HTTP 5xx) is returned, the Webex App marks that IP address as blocked and route advances to the next host on the list.

  • Om ett svar inte tas emot inom en viss tidsperiod, anses begäran misslyckas på grund av timeout och nästa förfrågan skickas till nästa värd. Begäran om timed out betraktas som misslyckad. Vissa förfrågningar försöker igen efter fel (med ökande tid för försök igen). Förfrågningarna som antas vara icke-viktiga kommer inte att efterfrågas igen.

När en ny värd har försökt bli den nya valda värden om värden finns med i listan. Efter att den sista värden i listan har försökts kommer Webex-appen att rullas över till det första.

Om det finns två på varandra följande förfrågningar initierar Webex-appen händelsekanalen igen om det finns två på varandra följande förfrågningar.

Observera att Webex-appen inte utför återställning till fel och ATT DNS-tjänstupptäckt endast utförs en gång vid inloggningen.

During sign-in, the Webex App tries to download the config file through the XSP|ADP/Dms interface. Den utför en sökning i A/AAAA-register över värden i den hämtade DMS-URL:en och ansluter till den första IP-adressen. Den kommer först att försöka skicka begäran om att hämta konfigurationsfilen med en SSO token. Om detta av någon anledning misslyckas kommer det att försöka igen, men med enhetens användarnamn och lösenord.

Distribuera Webex för BroadWorks

Distributionsöversikt

Följande diagram representerar den normala ordningen för dina distribueringsuppgifter för de olika lägena för användareetablering. Många av uppgifterna är gemensamma för alla etableringslägen.

Visar ordningen på de uppgifter som krävs för att distribuera Webex för BroadWorks med flödet genom tillhandahållande och betrodda e-postmeddelanden
Uppgifter som krävs för att distribuera flödet genom etablering
Visar ordningen på de uppgifter som krävs för att distribuera Webex för BroadWorks med flödet genom tillhandahållande utan e-postmeddelanden
Uppgifter som krävs för att distribuera flow flera etableringar utan betrodda e-postmeddelanden
Visar ordningen på de uppgifter som krävs för att distribuera Webex för BroadWorks med självaktivering
Uppgifter som krävs för att distribuera självetablering av användare

Partner onboarding för Webex för Cisco BroadWorks

Varje Webex för Cisco BroadWorks tjänsteleverantör eller en återförsäljare måste konfigureras som en partnerorganisation för Webex för Cisco BroadWorks. Om du har en befintlig Webex Partner-organisation kan den användas.

För att slutföra den nödvändiga introduktionen måste du genomföra dina Webex Cisco BroadWorks-dokument och nya partner måste godkänna ICPA-avtalet (online) för indirekt kanalpartner. När dessa steg har slutförts skapar Cisco Compliance en ny partnerorganisation i partnerhubben (om det behövs) och skickar ett e-postmeddelande med autentiseringsinformation till administratören av din registrering i ditt samarbete. Samtidigt kontaktar din partneraktivering och/eller kundframgångschef (Customer Success Program Manager) dig för att påbörja din registrering.


 

Webex Partners in one region can create customer organizations in any region that we offer the services. Mer information finns i: Data residency in Webex.

Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs

We require that the NPS application be run on a different XSP|ADP. Requirements for that XSP|ADP are described in Configure Call Notifications from your Network.

You need the following applications / services on your XSP|ADPs.

Tjänst/program

Autentisering krävs

Syfte med tjänst/applikation

Xsi-Händelser

TLS (servern autentiserar sig till klienter)

Samtalskontroll, serviceaviseringar

Xsi-åtgärder

TLS (servern autentiserar sig till klienter)

Samtalskontroll, åtgärder

Enhetshantering

TLS (servern autentiserar sig till klienter)

Samtalskonfiguration nedladdning

Verifieringstjänst

TLS (servern autentiserar sig till klienter)

Användarautentisering

Integrering av datortelefoni

mTLS (klient- och serverautent).

Telefoninärvaro

Webbvisningsprogram för samtalsinställningar

TLS (servern autentiserar sig till klienter)

Visar användarens samtalsinställningar i självhjälpsportalen i Webex-appen

This section describes how to apply the required configurations for TLS and mTLS on these interfaces, but you should reference existing documentation to get the applications installed on your XSP|ADPs.

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:


     
    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:

Specificitet CLI-kontext
System (globalt)

XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers>

XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols>

Transportprotokoll för detta system

XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers>

XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols>

HTTP på detta system

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/Ciphers>

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/Protocols>

Specifika HTTP-servergränssnitt på detta system

XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

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.

CTI-gränssnitt och relaterad konfiguration

Konfigurationsordningen "längst ut" visas nedan. Det är inte obligatoriskt att följa den här beställningen.

  1. Konfigurera programserver för CTI-prenumerationer

  2. Configure XSP|ADPs for mTLS Authenticated CTI Subscriptions

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

  4. Prenumerera på din Webex-organisation till BroadWorks CTI Events

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:

Specificitet

CLI-kontext

System (globalt)

(R22 och senare)

Xsp|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers>

Xsp|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols>

Transportprotokoll för detta system

(R22 och senare)

Xsp|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers>

Xsp|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols>

Systemets alla CTI-gränssnitt

(R22 och senare)

Xsp|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers>

Xsp|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols>

Ett specifikt CTI-gränssnitt för detta system

(R22 och senare)

Xsp|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

Xsp|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols>


 

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.

Webbvisning för samtalsinställningar

Call Settings Webview (CSWV) is an application hosted on XSP|ADP to enable users to modify their BroadWorks call settings through a webview that they see in the soft client. See the Cisco BroadWorks Call Settings Webview Solution Guide.

Webex makes use of this feature to provide users with access to common BroadWorks call settings that are not native to the Webex App.

Om du vill att webex-prenumeranter för Cisco BroadWorks ska ha tillgång till samtalsinställningar utöver standardinställningarna som är tillgängliga i Webex-appen, måste du distribuera webview-funktionen för samtalsinställningar.

Samtalsinställningar Webview har två komponenter:

  • Call Settings Webview application, hosted on a Cisco BroadWorks XSP|ADP.

  • The Webex App, which renders the call settings in a Webview.

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.

Distribuera CSWV på BroadWorks

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.

Configure the Webex App to use Call Settings Webview

For more detail on client configuration, see Webex for Cisco BroadWorks Configuration Guide.

Det finns en anpassad tagg i Webex-appens konfigurationsfil som du kan använda för att ställa in CSWV-URL:en. This URL shows the call settings to the users through the application interface.

<config> <services> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>

In the Webex app configuration template on BroadWorks, configure the CSWV URL in the %WEB_CALL_SETTINGS_URL_WXT% tag.

If you don't explicitly specify the URL, the default is empty and the call settings page isn't visible to the users.

  1. Se till att du har de senaste konfigurationsmallarna för Webex-appen (se Enhetsprofiler).

  2. Ställ in målet för webbsamtalsinställningar csw:

    %WEB_CALL_SETTINGS_TARGET_WXT% csw

  3. Ställ in URL:en för webbsamtalsinställningar för din miljö, till exempel:

    %WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/

    You derived this value when deploying the CSWV application.

  4. The resulting client configuration file should have an entry as follows:

    <web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>

     
    Any reference to XSP includes either XSP or ADP.

Konfigurera samtals push-meddelanden i Webex för Cisco BroadWorks

I detta dokument använder vi termen Call Notifications Push Server (CNPS) för att beskriva ett XSP-värdat eller ADP-värdprogram som körs i din miljö. Ditt CNPS-system samarbetar med BroadWorks-systemet för att vara medveten om inkommande samtal till dina användare och skickar meddelanden om sådana till aviseringstjänsterna Google Firebase Cloud Messaging (FCM) eller Apple Push Notification Service (APN).

Dessa tjänster meddelar mobilenheterna för Webex-prenumeranter på Cisco BroadWorks att de har inkommande samtal på Webex.

Mer information om NPS finns i beskrivningen av aviseringspush-server.

Ett liknande sätt i Webex fungerar med Webex-meddelande- och närvarotjänster för att skicka meddelanden till aviseringstjänsterna Google (FCM) eller Apple (APNS). Dessa tjänster meddelar i sin tur de mobila Webex-användarna om inkommande meddelanden eller närvaroändringar.


 

I avsnittet beskrivs hur NPS ska konfigureras för verifieringsproxy när NPS inte redan har stöd för andra appar. Om du behöver migrera ett delat NPS för att använda NPS-proxy, se Uppdatera Cisco BroadWorks NPS för att använda NPS-proxy https://help.webex.com/nl5rir2/.

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.

Överväganden vid APNS

Apple kommer inte längre att ha stöd för HTTP/1-baserat binär protokoll på Apple Push Notification-tjänsten efter den 31 mars 2021. We recommend that you configure your XSP|ADP to use the HTTP/2-based interface for APNs. This update requires that your XSP|ADP hosting the NPS be running R22 or later.

Förbered NPS för Webex för Cisco BroadWorks

1

Installera och konfigurera en dedikerad XSP (lägsta version R22) eller en programleveransplattform (ADP).

2

Installera programfixar för NPS-autentiseringsproxy:

3

Aktivera programmet för aviserings push-server.

4

(För Android-aviseringar) Aktivera FCM v1 API på NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(För Apple iOS-aviseringar) Aktivera HTTP/2 på NPS.

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true


 
This is exclusive to Release 22 and earlier versions; it is not available in Release 23 and above versions, which only support HTTP/2.
6

Bifoga ett tekniskt stöd från NPS XSP/ADP.

7

On each AS server, the namedefs file in /usr/local/broadworks/bw_base/conf must be configured with SRV and A records for Notification Push Server (XSP/ADP) lookup, if multiple XSP/ADP then add an entry for each as required.

Exempel: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149


 

Once set, one of the following is required to pickup the changes:

  1. A restartbw be preformed in a maintenance window.

  2. Via the Cisco BroadWorks CLI:

    R24 and older

    AS_CLI/ASDiagnostic/DNS> Reload

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> Reload

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> Reload

Nästa steg

For fresh installs of an NPS, go to Configure NPS to Use Authentication Proxy

To migrate an existing Android deployment to FCMv1, go to Migrate NPS to FCMv1

Konfigurera NPS för att använda autentiseringsproxy

Den här uppgiften gäller för en ny installation av NPS som är dedikerad för Webex för Cisco BroadWorks.

If you want to configure the authentication proxy on an NPS that is shared with other mobile apps, see Updating Cisco BroadWorks NPS to Use NPS Proxy ( https://help.webex.com/nl5rir2).

1

Obtaining OAuth credentials for your Webex for Cisco BroadWorks.

2

Skapa klientkontot på NPS:

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

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret New Password: klient-hemlighet-från-steg 1

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

To verify the values you entered match with what you were given, run XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get


 

The CiscoCI issuerUrl should ALWAYS be US CI cluster irrespective of your location and the default should be:

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

3

Ange NPS-proxy-URL och ställ in uppdateringsintervallet för token (30 minuter rekommenderas):

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

XSP|ADP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

4

(För Android-aviseringar) Lägg till app-ID för Android i FCM-programsammanhanget på NPS.

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

5

(För Apple iOS-aviseringar) Lägg till program-ID i APNS-programsammanhanget och se till att utelämna autentiseringsnyckeln – ställ in den på tom.

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

6

Konfigurera följande NPS-URL:er:

XSP|ADP CLI Context

Parameter

Värde

  • XSP|ADP_CLI/Applications/

    AviseringServer/FCM>

authURL

https://www.googleapis.com/oauth2/v4/token

pushURL

https://fcm.googleapis.com/v1/projects/PROJECT-ID/messages:send

Omfattning

https://www.googleapis.com/auth/firebase.messaging

  • XSP|ADP_CLI/Applications/NotificationPushServer

    /APNS/Produktion>

url

https://api.push.apple.com/3/device

7

Konfigurera följande NPS-anslutningsparametrar till de rekommenderade värden som visas:

XSP|ADP CLI Context

Parameter

Värde

  • XSP|ADP_CLI/Applications/

    AviseringServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMillisekunder

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/produktion>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Kontrollera om programservern är ett program-ID eftersom du kan behöva lägga till Webex-apparna i listan över tillåtna program:

  1. Run AS_CLI/System/PushNotification> get and check the value of enforceAllowedApplicationList. Om det är sant måste du slutföra dennadeluppgift. Annars kan du hoppa över resten av deluppgiften.

  2. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”

  3. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

9

Restart the XSP|ADP: bwrestart

10

Testa samtalsaviseringar genom att ringa från en BroadWorks-prenumerant till två Webex-mobilanvändare. Bekräfta att samtalsaviseringar visas på iOS- och Android-enheter.

Migrera NPS till FCMv1

Detta ämne innehåller valfria procedurer som du kan använda i Google FCM-konsolen när du har en befintlig NPS-distribution som du behöver migrera till FCMv1. Det finns tre metoder:

Migrate UC-One Clients to FCMv1

Use the below steps in Google FCM Console to migrate UC-One clients to Google FCM HTTPv1.


 

Om varumärke tillämpas på klienten måste klienten ha avsändar-ID. I FCM-konsolen, se Projektinställningar > Cloud Messaging. Inställningen visas i tabellen för Projektuppgifter.

For details, see the Connect Mobile Branding Guide at https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Refer to the gcm_defaultSenderId parameter, which is located in the Branding Kit, Resource folder, branding.xml file with the below syntax:

<string name="gcm_defaultSenderId">xxxxxxxxxxxxx</string>

  1. Logga in på FCM Admin SDK på http://console.firebase.google.com.

  2. Välj lämpligt Android-program.

  3. På fliken Allmänt spelar du in projekt-ID:t

  4. Gå till fliken tjänstekonton för att konfigurera ett tjänstekonto. Du kan skapa ett nytt tjänstekonto eller konfigurera ett befintligt.

    Så här skapar du ett nytt tjänstekonto:

    1. Klicka på den blå knappen för att skapa ett nytt tjänstkonto

    2. Klicka på den blå knappen om du vill skapa en ny privat nyckel

    3. Hämta nyckel till en säker plats

    Så här återanvänder du ett befintligt tjänstekonto:

    1. Klicka på den blå texten för att visa befintliga tjänstekonton.

    2. Identifiera vilket tjänstekonto som ska användas. Tjänstekontot behöver behörighet firebaseadmin-sdk.

    3. Klicka på hamburgermenyn till höger och skapa en ny privat nyckel.

    4. Hämta json-filen som innehåller nyckeln och spara den på en säker plats.

  5. Copy the json file onto the XSP|ADP.

  6. Konfigurera projekt-ID och :

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
  7. Konfigurera programmet:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
  8. Aktivera FCMv1:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
  9. Run the bwrestart command to restart the XSP|ADP.

Migrera SaaS-klienter till FCMv1

Använd stegen nedan på Google FCM-konsol om du vill migrera SaaS-klienter till FCMv1.


 
Se till att du redan har slutfört proceduren "Konfigurera NPS för att använda autentiseringsproxy".
  1. Inaktivera FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
  2. Run the bwrestart command to restart the XSP|ADP.

  3. Aktivera FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
  4. Run the bwrestart command to restart the XSP|ADP.

Uppdatera ADP-server

Använd stegen nedan på Google FCM-konsolen om du migrerar NPS för att använda en ADP-server.

  1. Hämta JSON-filen från Google Cloud Console:

    1. På Google Cloud Console går du till sidan Tjänstekonton.

    2. Klicka på Välj ett projekt , välj ditt projekt och klicka på Öppna .

    3. Find the row of the service account that you want to create a key for, click the More vertical button, then click Create key.

    4. Select a Key type and click Create

      Filen hämtas.

  2. Lägg till FCM till ADP-servern:

    1. Importera JSON-filen till ADP-servern med hjälp av kommandot /bw/install.

    2. Logga in på ADP CLI och lägg till projekt- och API-nyckel:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON :

    3. Lägg sedan till programmet och nyckeln:

      ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done

    4. Verifiera konfigurationen:

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

Konfigurera din partnerorganisation i partnerhubben

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. 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**)

    Ange namn och lösenord för det tillhandahållande kontot enligt BroadWorks-konfigurationen.

    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.

Konfigurera programserver med URL för tillhandahållande tjänst


 

Denna uppgift krävs endast för flödet genom etablering.

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


     
    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.

Partner Pre-Provisioning Check API

The Pre-Provisioning Check API helps administrators and sales teams by checking for errors before you provision a customer or subscriber for a package. Users or Integrations authorised by a User with the Partner Full Administrator role can use this API to ensure that there are no conflicts or errors with package provisioning for a given customer or subscriber.

The API checks to see if there are conflicts between this customer/subscriber and existing customers/subscribers on Webex. For example, the API may throw errors if the subscriber is already provisioned to a different customer or partner, if the email address exists already for another subscriber, or if there are conflicts between the provisioning parameters and what exists already on Webex. This gives you the opportunity to fix those errors before you provision, increasing the likelihood of successful provisioning.

For more information on the API, see: Webex for Wholesale Developer Guide

To use the API, go to : Precheck a Wholesale Subscriber Provisioning


 

To access Precheck a Wholesale Subscriber Provisioning document you need to log in to https://developer.webex.com/ portal.

Partner SSO - SAML

Allows partner administrators to configure SAML SSO for newly created customer organizations. Partner kan konfigurera en fördefinierad SSO och tillämpa den konfigurationen på de kundorganisationer som de hanterar, samt för sina egna anställda.


 
Stegen nedan SSO gäller endast nyskapade kundorganisationer. Om partneradministratörer försöker lägga till SSO en befintlig kundorganisation, bibehålls den befintliga autentiseringsmetoden för att förhindra att befintliga användare förlorar åtkomst.
  1. Verifiera att tredjepartsleverantören identitetsleverantör uppfyller kraven i avsnittet Krav för identitetsleverantörer i Single Sign-On Integration i ControlHub.

  2. Upload the CI metadata file that has Identity Provider.

  3. Configure a Onboarding Template. För inställningen autentiseringsläge väljer du Partnerautentisering. För IDP-enhets-ID anger du Enhets-ID från SAML-metadata-XML från identitetsleverantörens tredje part.

  4. Skapa en ny användare i en ny kundorganisation som använder mallen.

  5. Mycket att användaren kan logga in.

Partner SSO - OpenID Connect (OIDC)

Allows partner administrators to configure OIDC SSO for newly created customer organizations. Partner kan konfigurera en fördefinierad SSO och tillämpa den konfigurationen på de kundorganisationer som de hanterar, samt för sina egna anställda.


 

The below steps to set up Partner SSO OIDC apply to newly created customer organizations only. If partner administrators try to modify the default authentication type to Partner SSO OIDC in an existing temple, the changes will not apply to the customer organizations already onboarded using the template.

  1. Open a Service Request with Cisco TAC with the details of the OpenID Connect IDP. The following are mandatory and optional IDP attributes. TAC must set up the IDP on the CI and provide the redirect URI to be configured on the IDP.

    Attribut

    Obligatoriskt

    Beskrivning

    IDP Name

    Ja

    Unique but case-insensitive name for OIDC IdP config, could consist of letters, numbers, hyphens, underlines, tildes, and dots and max length is 128 characters.

    OAuth client Id

    Ja

    Used to request OIDC IdP Authentication.

    OAuth client Secret

    Ja

    Used to request OIDC IdP Authentication.

    List of scopes

    Ja

    List of scopes which will be used to request OIDC IdP authentication, split by space, e.g. 'openid email profile' Must including openid and email.

    Authorization Endpoint

    Yes if discoveryEndpoint not provided

    URL of the IdP's OAuth 2.0 Authorization Endpoint.

    tokenEndpoint

    Yes if discoveryEndpoint not provided

    URL of the IdP's OAuth 2.0 Token Endpoint.

    Discovery Endpoint

    Nej

    URL of the IdP's Discovery Endpoint for OpenID endpoints discovery.

    userInfoEndpoint

    Nej

    URL of the IdP's UserInfo Endpoint.

    Key Set Endpoint

    Nej

    URL of the IdP's JSON Web Key Set Endpoint.


     

    In addition to the above IDP attributes, the partner organization ID needs to be specified in the TAC request.

  2. Configure the redirect URI on the OpenID connect IDP.

  3. Configure a Onboarding template. For the Authentication Mode setting, select Partner Authentication With OpenID Connect and enter the IDP Name provided during the IDP setup as the OpenID Connect IDP Entity ID.

  4. Skapa en ny användare i en ny kundorganisation som använder mallen.

  5. Very that the user can log in using the SSO authentication flow.

Aktivera identifierare för samtalskorrelation

För att köra Webex för Cisco BroadWorks måste du aktivera identifieraren för samtalskorrelation. Den här inställningen krävs för många samtalsfunktioner, inklusive samtalsinspelning, gruppsamtalsuppringning, verkställande och verkställande assistent.

Use the CLI to enable the feature on all AS and XSP|ADP interfaces.

  • Run the following commands on AS interfaces. This will enable the AS to send the X-BroadWorks-Correlation-Info SIP header:

    AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true

    AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true

  • The enableCallCorrelationID parameter associated with the Xsi-Actions application is used to control the inclusion of call correlation information in Xsi-Actions logs. It is recommended to have enableCallCorrelationID enabled using the following command on XSP|ADP interfaces:

    XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true

För ytterligare information om funktionsbeskrivningen för samtalskorrelationsidentifierare, se Funktionsbeskrivning för Cisco BroadWorks-samtalskorrelationsidentifierare.

Directory Sync

Katalogsynkronisering säkerställer att Webex för Cisco BroadWorks-användare kan använda Webex-katalogen för att ringa upp alla samtalsenhet från BroadWorks-servern. När den här funktionen är aktiverad synkroniseras den fullständiga samtalskatalogen från BroadWorks-servern med Webex-katalogen. Användare kan komma åt katalogen från Webex-appen och ringa ett samtal till alla samtalsenhet från BroadWorks-servern.

Om du vill aktivera Katalogsynkronisering går du till Katalogsynkronisering i Webex för Cisco BroadWorks.


 
Webex for Cisco BroadWorks flowthrough provisioning adds messaging users and associated calling information from the BroadWorks server to the Webex platform. However, phone lists, non-messaging users, and non-user entities are not included (for example, a conference room phone, fax machine or hunt group number). Genom att aktivera katalogsynkronisering säkerställer du att alla uppringningsenheter läggs till på Webex-plattformen.

Enhetlig samtalshistorik

När Unified Call History har aktiverats synkroniseras BroadWorks-samtalshändelser med Webex-molnet och blir en del av Webex Unified-samtals- och möteshistorik som visas i Webex-appen. Användare kan visa sin egen detaljerade samtalshistorik och möteshistorik via Webex-appen.

Enhetlig samtalshistorik kan aktiveras av administratörer på partnernivå i partnerhubben på klusternivå. När denna funktion är aktiverad synkroniserar BroadWorks-distributionen följande samtalshändelser med Webex-molnet:

  • Händelser i samtalshistorik – dessa händelser används för att bygga en detaljerad enhetlig samtalshistorik

  • Hook Status-händelser – Unified-samtalshistorik inkluderar ett optimerat läge som minskar nätverksbandbredden för uppdateringar av telefoninärvaro

Krav för enhetlig samtalshistorik

Innan du kan konfigurera Unified-samtalshistorik måste du se till att du har korrigerat systemet. Den här funktionen är beroende av följande BroadWorks-korrigeringar som installeras:

För R22:

För R23:

För R24:


 
For the full list of BroadWorks patches that you must install as a prerequisite to running Webex for Cisco BroadWorks, See BroadWorks Software Requirements in the Reference section.

In addition to patching your system, the client config file (config-wxt.xml) must have the following tag set: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>

To have Hunt Group, Call Center and other redirection info in Unified Call History, the following Broadworks patches must be installed and active:

För R23:

  • AP.as.23.0.1075.ap383346

  • AP.as.23.0.1075.ap383994

För R24:

  • AP.as.24.0.944.ap383346

  • AP.as.24.0.944.ap383994

To have Executive-Assistant info in Unified Call History, the following Broadworks patches must be installed and active:

För R24:

  • AP.as.24.0.944.ap380052

  • AP.as.24.0.944.ap384239

  • ADP running Xsi-Events-24_2022.06 or later

In addition to the Broadworks patches, Directory Sync must also be enabled for the Executive-Assistant Unified Call History.


 

When you enable Call History or DND Sync, Webex will send CTI subscription refresh requests for all users under the cluster. Depending on the number of users, this may last up to a few hours. It is recommended to not perform any Broadworks maintenance activity during the same maintenance window.

Aktivera samtalshistorik (nytt kluster)

To enable Call History on a new cluster, see the steps for adding a cluster in Configure Your Partner Organization in Partner Hub.

Aktivera samtalshistorik (befintligt kluster)

För att aktivera samtalshistorik på ett befintligt kluster följer du stegen nedan:

  1. Sign in to Partner Hub at admin.webex.com.

  2. Gå till Inställningar och välj ett befintligt kluster.

  3. Kontrollera att klusteranslutningen är bra. Den högra panelen ska visa en grön kryssmarkering med Anslutning etablerat.

    Om detta inte visas anger du BroadWorks användar-ID och BroadWorks-lösenord under Kontrollera anslutningar (valfritt) och klickar på Kontrollera för att bekräfta att anslutningen är bra.

  4. Markera kryssrutan Samtalshistorik inställningar.

  5. Klicka på Spara.

Funktionsinteraktioner

Följande funktionsinteraktioner finns för Unified Call History:

  • Enhetlig samtalshistorik stöds inte för användare som är konfigurerade i BroadWorks med routelistor eller direktvägar. När denna situation existerar skickas inte statushändelser för samtalshistorik och koppla till Webex-appen.

  • Enhetlig samtalshistorik stöds inte vid anknytningsuppringning. Samtal som rings upp via anknytningsuppringning kommer kanske inte att visas korrekt i samtalshistoriken.

Visa samtalshistorik i Webex-appen

Slutanvändare kan få åtkomst till och se sin unifierade samtalshistorik via Webex-appen. Mer information finns här: Webex | View Call and Meeting History.

Inaktivera historik för Unified-samtal

När du har aktivera Unified-samtalshistorik på ett kluster kan du inte inaktivera funktionen på egen hand. If you need to disable the feature, contact Cisco Technical Assistance Center (TAC).

Visual Spam Indication

The Webex App supports a visual indication of spam calls in the call toast when the call is presented to the callee and in the Unified Call History records when BroadWorks is updated to perform Caller ID validation via the STIR/SHAKEN framework. To have this feature:

  1. Enable Unified Call History as described in the previous section.
  2. The following patches must be installed and active:
    • AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
    • or AS-25_Rel_2022.12 at a minimum
  3. The feature must be activated via the AS CLI:
    • AS_CLI/System/ActivatableFeature> activate 104112
    • AS_CLI/System/StirShaken> set enableVerification true
  4. Broadworks must be configured to perform STIR-SHAKEN signing, tagging, and verification as described in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification

When BroadWorks is properly configured, a new header X-Cisco-CallerId-Disposition will be added in INVITE requests sent to Cisco clients and a new field callerIdDisposition will be added to the existing Call History Events that are sent to Webex Cloud via the CTI interface. Webex devices will use this information to provide a visual spam indication in the call presentation and the Unified Call History of the callee.

Caller Identification and Call Redirection

Caller Identification

When the Webex App receives a call, it will attempt to identify who the caller is and display this information in the incoming call notification, the in-call window, and after the call is complete, in the call history and voicemail.

The Webex App will attempt to find the caller ID by matching the incoming phone number with the phone numbers of contacts found in various sources. The Webex App will use the following sources in this order. Once it finds it in one source it will not attempt to search anywhere else.


 

If it finds multiple instances of a number in one source, it will not try to choose one of them, in this case, it will not display any caller ID.

  • Webex Common Identity (CI) which contains your organization users.

  • Personal and Organization Contacts. Personal Contacts are visible under the Contacts tab.

  • Local Address Book. In Windows - Outlook application, in Mac - Mac Contacts, in iOS - iPhone contacts, in Android - Android contacts.

If there is no match found with the incoming phone number, then the app will use the display name in the SIP FROM header if available. Otherwise, it will use the username part of the SIP URI from the SIP From header as a last resort.

For remote call control (i.e., Deskphone Control Mode) XSI info is used, where BWKS ID or extension is used, extracted from remote-party-info in the XSI event. If remote-party-info is not available, then P-Asserted Identity (PAI) (if configured) will be used.

Call Redirection

In the case where a call has been redirected or forwarded, then the app will attempt to show who the caller is and how it was forwarded in the call notification and call history.

  • Call Forwarded: Shows number that forwarded the call.

  • Hunt Group: Shows name of the hunt group that forwarded the call.

  • Call Center Queue: Shows name of the queue that forwarded the call.

  • Executive-Assistant: Shows name of Executive the call is coming in for.

Undantag:

  • For internal call queue calls, where an agent calls back an internal party, the remote party will not see the name of the call queue but will see the name of the agent calling them.

Call Answered Elsewhere:

For Hunt Groups or Call Queues that are set up with simultaneous routing, agents will see a call answered elsewhere in call history if another agent picks up the call. For Hunt Groups or Call Queues with sequential routing, or in an overflow, calls will show as missed call in call history if answered by another agent.

Select Caller ID

Översikt

The "Select Caller ID" feature enables users to switch between different Calling Line IDs for external calls. If enabled by the admin, users can choose from the following options for their Calling Line Identity:

  • User number ("Use user phone number for Calling Line Identity")

  • Configurable CLID ("Use configurable CLID for Calling Line Identity")

  • Group CLID ("Use group/department phone number for Calling Line Identity")

Funktionalitet

Users have two methods to change their Caller ID as provisioned by the administrator:

  1. Feature Access Codes (FAC): Specific codes for each of the three Caller ID options.
  2. Webex App Interface: A user-friendly view within the Webex desktop and mobile apps that display the available Caller ID options enabled by the administrator, allowing users to select their preferred ID.
Select Caller ID

Ytterligare funktioner

  • The Webex apps will also include options for Call Center queues DNIS.
  • Mobile app users will have Dual Persona options available for Mobility users.

Preconditions

The following conditions must be met on the BroadWorks server for the user to be able to control their choice of external CLID policy:

  • The system flag 'EnableUserSelectionOfExternalCLIDPolicy' is enabled.
  • User level Call Processing Policy Calling Line ID scope is set to "Use User Calling Line Id Policy" for this user.
  • The User level Call Processing Policies flag 'Allow User Selection of External CLID Policy' is enabled for the user.
  • If no number is defined for the "Use configurable CLID for Calling Line Identity" or "Use group/department phone number for Calling Line Identity" options, the FACs or app display will have no effect. This setting must be configured by the administrator prior to user selection.

BroadWorks Patches

This feature requires two specific BroadWorks patches to function correctly:


 
Refer to Section 8 Release Independent and Service Patch Information.

Webex App Configuration

These tag needs to be enabled in the desktop, tablet, and mobile configurations:

<config> <services> <calls> <caller-id> <outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%"> 

Shared line appearance

Delad linje som visas är möjligheten att etablera andra användares linjer som delade linjer på slutanvändarens enhet. The shared line configuration for the Webex App is similar to the shared line configuration for desk phones. This specific feature allows you to assign shared line appearances to the end user's Webex App.

This feature benefits the users to handle calls on other user's extension directly from the Webex App.

  • Du kan endast konfigurera den delade linjen som visas i skrivbordsversionen av en Webex-app.

  • Du kan lägga till högst tio linjer, inklusive den primära linjen, till Webex-appen.

  • Du kan inte tilldela en arbetsytelinje som delad linje.

  • A user cannot be provisioned with Executive-Assistant service at the same time as having Shared Lines.

  • A user's primary line port should not be changed to a Shared Line.

Krav

För att distribuera den här funktionen på Webex för Cisco BroadWorks måste du distribuera följande BroadWorks-programfixar:

Patch 1: Owner Flag in Device List to Support Webex Client Shared Lines

R23 without ADP:

  • AP.as.23.0.1075.ap384179

  • AP.xsp.23.0.1075.ap384179

R23 with ADP:

  • AP.as.23.0.1075.ap384179

  • Xsi-Actions-23_2022.10

R24:

  • AS: AP.as.24.0.944.ap384179

  • Xsi-Actions-24_2022.10

R25:

  • AS: RI release Rel_2022.10_1.310

  • Xsi-Actions-25_2022.10

Patch 2: Patches for increasing port count on device profile types. Exempel: For the desktop client: System>Identity/Device Profile Type Modify> Business Communicator - PC: Profile , Standard Options, Number of Ports:

  • IF 'Unlimited' is enabled, no change is required
  • IF 'Limited To' is <10, change the value = 10 and save to utilize all available lines
  • RI release Rel_2022.10_1.310

Synkronisera stör ej (Do Not Disturb, DND)

Do Not Disturb (DND) Sync aligns DND settings between Webex and BroadWorks by synchronizing DND status between the two platforms. For example, if a user turns on DND from the Webex App, that status syncs to BroadWorks calling devices. As a result, the user’s BroadWorks-registered desk phone does not ring when someone attempts to call it. Similarly, if a user sets DND from a desk phone, the status syncs to the Webex App. Without this feature, DND updates from one platform don't get recognized by the other platform.

DND Sync gets applied at the BroadWorks cluster level and can be enabled in Partner Hub by a partner administrator.


 

If there are many customers (>50) in the BroadWorks cluster, DND sync is not supported. In such instances, it is recommended to contact a Cisco TAC support engineer for assistance.

Förutsättningar

Make sure that the following patches are applied to the AS and XSP|ADP. Apply only the patches for your BroadWorks version.

For Release 23:

<snipped>

  • ADP apps: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar

For Release 24:

<snipped>

  • ADP apps: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar

After you apply the patches, activate feature 25433 on the AS:

AS_CLI/System/ActivatableFeature> activate 25433

If there are many customers (>50) in the BroadWorks cluster, operations such as updating XSI Actions, XSI Events, DAS URL, XSP|ADP URL, or DND sync are not supported. In such instances, it is recommended to contact a Cisco TAC support engineer for assistance.

Configure Device Feature Key Synchronization on BroadWorks. Make sure that the phone supports SIP SUBSCRIBE/NOTIFY for the “as-feature-event” event package. For details, see Cisco BroadWorks Device Feature Key Synchronization.

Enable DND Sync (Existing cluster)

  1. Sign in to Partner Hub

  2. Klicka på Inställningar.

  3. Click View Cluster and select the appropriate BroadWorks cluster.

  4. Enable the Do not disturb (DND) sync toggle.

  5. Enter your BroadWorks user ID and click Enable.

    The system validates that the BroadWorks cluster has the appropriate patches to support DND Sync. If validation fails, the Save button gets disabled.

  6. If validation succeeds, click Save.


 
  • Once DND Sync gets enabled, Webex refreshes all user subscriptions to include the Do not disturb event package. Depending on the number of users, this process may take a few hours to complete.

  • Enabling DND Sync is a one-way toggle. Once the feature is enabled, you can’t disable it on your own.

Enable DND Sync (New cluster)

You can also enable the feature during cluster creation. For details, see “Configure Your BroadWorks Clusters” in Configure Your Partner Organization in Partner Hub.

Disable DND Sync

You can’t disable DND Sync on your own. To disable the feature, create an engineering BEMS case with the following information:

  • Familj: Spark-tjänst

  • Produkt: Samtal i Webex (Webex för BroadWorks)

  • Komponent: WxBW- Provisioning

  • The BEMS case must state that Do Not Disturb Sync is to be disabled for a partner. The case must contain partnerId and BroadWorks clusterId.

Användningsfall

Setting and Clearing DND in Relation to Work Status

Samtalsinspelning

Webex för Cisco BroadWorks har stöd för fyra lägen för samtalsinspelning.

Tabell 6. Inspelningslägen

Inspelningslägen

Beskrivning

Kontroller/indikatorer som visas i Webex-appen

Alltid

Inspelning initieras automatiskt när samtalet upprättas. Användaren kan inte starta eller stoppa inspelningen.

  • Visuell indikator på att inspelning pågår

Alltid med paus/återuppta

Inspelning initieras automatiskt när samtalet upprättas. Användare kan pausa och återuppta inspelning.

  • Visuell indikator på att inspelning pågår

  • Pause Recording button

  • Resume Recording button

Ondemand

Inspelning initieras automatiskt när ett samtal upprättas, men inspelningen tas bort såvida inte användaren trycker på Starta inspelning.

Om användare startar en inspelning, bibehålls den fullständiga inspelningen från samtalskonfigurationen. När inspelningen har börjat kan användaren också pausa och återuppta inspelningen

  • Start Recording button

  • Pause Recording button

  • Resume Recording button

OnDemand med användarinitierad start

Inspelning initieras inte om inte användaren väljer alternativet Starta inspelning i Webex-appen. Användaren kan välja att starta och stoppa inspelningen flera gånger under ett samtal.

  • Start Recording button

  • Stop Recording button

  • Pause Recording button

Krav

För att distribuera den här funktionen på Webex för Cisco BroadWorks måste du distribuera följande BroadWorks-programfixar:

The Call Correlation Identifier must be turned on. For details, see Enable Call Correlation Identifier.

The following configuration tag must be enabled in order to use this feature: %ENABLE_CALL_RECORDING_WXT%.

Den här funktionen kräver en integrering med en samtalsinspelningsplattform från tredje part.

Om du vill konfigurera samtalsinspelning på BroadWorks går du till Cisco BroadWorks samtalsinspelningsgränssnittsguide.

Ytterligare information

Om användarinformation vill veta hur du använder inspelningsfunktionen går du till artikeln help.webex.com Webex Spela in dina samtal | .

För att spela upp en inspelning igen måste användare eller administratörer gå till samtalsinspelningsplattformen från tredje part.

Enabling Voicemail for Microsoft Teams Integration

You can enable voicemail for Microsoft Teams users in the Webex for BroadWorks solution. This integration allows users to retrieve their voicemails directly through Microsoft Teams, enhancing the overall user experience.

Steps to Enable Voicemail

  1. Configure Voicemail Settings: Follow the steps provided in the Webex Calling documentation to configure and manage voicemail settings. This includes setting up voicemail for users, enabling notifications, and configuring voicemail to email.

    For detailed instructions, see: Configure and manage voicemail settings for a Webex Calling user.

  2. Integrate with Microsoft Teams: Ensure that the integration between Webex for BroadWorks and Microsoft Teams is properly configured. This will enable users to access their voicemails through the Microsoft Teams interface.

    For integration details, see: Configure Microsoft Teams for Webex Calling.

Användarupplevelse

Once the integration is set up, users can:

  • Retrieve voicemails directly within the Microsoft Teams application.
  • Receive notifications for new voicemails.
  • Manage voicemail settings from the Webex interface.

Krav

To support voicemail retrieval in the Microsoft Teams integration with the Webex for BroadWorks offer, additional network changes are required. BroadWorks partners should enable Cross-Origin Resource Sharing (CORS) for the following URLs on their BroadWorks platform:

For more details on the configuration steps, please refer to section 8.5.1.2 of the BW Application Delivery Platform Configuration Guide, which requires version 2024.05 on the ADP.

Grupp-samtalsparkering och hämta

Webex för Cisco BroadWorks har stöd för samtalsparkering och hämtning. Denna funktion ger ett sätt för användare inom en grupp att parkera samtal, som sedan kan hämtas av andra användare i gruppen. Till exempel kan butiksanställda i en lagringsinställning använda funktionen för att parkera ett samtal som sedan kan fångas upp av någon på en annan avdelning.

Funktionsåtgärd

När funktionen är konfigurerad

  • Under samtalet klickar användaren på alternativet Parkera i sin Webex-app för att parkera samtalet på en anknytning som systemet väljer automatiskt. Systemet visar användarens anknytning under en period på 10 sekunder.

  • En annan användare i gruppen klickar på alternativet Hämta samtal i sin Webex-app. Användaren anger sedan anknytningen till det parkerade samtalet för att fortsätta samtalet.

Krav

Försäkra dig om att följande fungerar för att den här funktionen ska fungera:

  • Klientens konfigurationsfil måste ha följande taggar inställda:

    <call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
  • The Call Correlation Identifier must be enabled on the AS and XSP|ADP. For details, see Enable Call Correlation Identifier.

  • Your SBC must be configured to pass the ‘x-broadworks-correlation-in' SIP attribute to and from the Application Server.

Konfiguration

Information om hur du konfigurerar gruppadministration samtalsparkering BroadWorks finns i "Lägg till samtalsparkering-grupp" i Cisco BroadWorks Application Server Web Interface Administrationsguide – del 2. Du måste skapa en grupp och lägga till användare till gruppen.

För information om hur du konfigurerar en samtalskorrelationsidentifierare på BroadWorks, se Funktionsbeskrivning för Cisco BroadWorks samtalskorrelationsidentifierare.

Ytterligare information

Information användarinformation hur du använder gruppsamtal samtalsparkering finns i Webex | Park och Hämtasamtal.

samtalsparkering/anvisningarna samtalsparkering

Vanlig eller dirigerad samtalsparkering stöds inte i användargränssnittet för Webex-appen, men användare som är etablerade kan distribuera funktionen med funktionsåtkomstkoder:

  • Ange *68 för att parkera ett samtal

  • Ange *88 för att hämta ett samtal

Ingripande

Barge-in service is commonly used in call center environments or other situations where immediate assistance or intervention may be required.

When a barge-in service is enabled, a designated user or supervisor can enter an active call by initiating a specific command or by using a dedicated button or key combination on their phone or communication device. Once the barge-in request is made, the system establishes a connection with the ongoing call, allowing the authorized person to listen to the conversation or join the call as an active participant.

Barge-in service can be useful in various scenarios. In a call center setting, supervisors or trainers can monitor and coach customer service representatives by listening to their calls in real-time. If necessary, they can intervene to provide guidance or take over the call if the representative is struggling. In emergency situations or critical discussions, authorized personnel can quickly join ongoing conversations to provide assistance or make important decisions.

In the Webex app for Barge in, we get a notification that the call is transformed into a conference. There is no additional information in the NOTIFY (call-info or conference-info) what is the type of conference, so we can treat it in a different way.

When a barge-in occurs, a three-way call is established between the parties. The following terms are introduced:

  • Supervisor: A supervisor is a person who oversees and manages a team of customer service agents or call center representatives. In the context of call barge-in, a supervisor typically has the ability to monitor and intervene in ongoing customer calls. They may use call monitoring tools or software to listen in on calls, provide guidance to agents, and ensure quality control. The supervisor's role may involve training agents, addressing customer concerns, and optimizing the performance of the team.

  • Customer: A customer refers to an individual or entity that engages with a company or organization to obtain products, services, or support. In the context of call barge-in, a customer is someone who is making or receiving a phone call with a customer service agent. Customers may seek assistance, information, or resolution to their queries or issues during the call. The call barge-in feature allows supervisors or authorized personnel to join the ongoing call between the customer and the agent.

  • Agent: An agent, also known as a customer service representative or call center agent, is a person responsible for handling customer interactions and providing support or assistance over the phone or other communication channels. Agents are trained to address customer inquiries, resolve problems, process transactions, and deliver a positive customer experience. In the context of call barge-in, an agent is the individual speaking directly to the customer during the phone call. The agent may receive guidance or feedback from the supervisor through call barge-in if necessary.

For any client initiated requests such as CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, etc, if <Webex Client> (please choose the right name instead of Webex client, if it is not appropriate) is provisioned as a Shared Call Appearance device, 'Alert all appearances for Click-to-Dial calls' configuration should be enabled on Shared Call Appearance setting for the client to receive a call, unless the location is explicitly provided by the client initiating the request.

Mobile Native Call Escalate to Meeting

The Mobile Native Call Escalate to Meeting comes with two unique features:

  • New Push Notification

    Mobile users on a native call can now switch to the Webex App by tapping on the New push notification. When you start a native call screen a New push notification appears on the screen and tapping the notification takes you straight to the Webex App in-call screen.

    You see the Webex notification during a mobile phone call if you use Webex Go or your mobile network operator (MNO) has call signaling using Cisco call control for your mobile phone calls.

  • Move Mobile Call to Meeting

    When you're in the middle of a call with someone, you may want to move that call into a meeting to make use of some advanced meetings features like video, share, or whiteboarding. Or invite other people into the discussion and move to a meeting.

BroadWorks Requirements

  • Activatable feature 25239

  • R23 with XSP|ADP:

    • AS Patch AP.as.23.0.1075.ap383064

    • XSP|ADP Patch AP.xsp.23.0.1075.ap383064

    • Patch AP.platform.23.0.1075.ap383064

  • R23 with ADP:

    • AS Patch AP.as.23.0.1075.ap383064

    • ADP with Xsi-Actions-23, CommPilot-23 version > 2022.05_1.303 and NPS version > 2022.08_1.350

  • R24:

    • AS patch: AP.as.24.0.944.ap383064

    • ADP with Xsi-Actions-24, CommPilot-24 version > 2022.05_1.303 and NPS version > 2022.08_1.350

  • R25:

    • AS RI release Rel_2022.08_1.354

    • ADP with Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 and NPS version > 2022.08_1.350

URI Dialing Configuration to support Move Call to Meeting

NS UrlDialing Policy

Define rule for (.*)webex.com to route through I-SBC

NS_CLI/Policy/UrlDialing> get WebexMeetings Policy: UrlDialing Instance: Webex unknownSipURIHandling = reject disableSubscriberLookups = true Enable = true CallTypes:      Selection = {ALL} From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings Policy: UrlDialing Instance: WebexCalling Table: Rules id pattern routingNE cost weight dtg ===================================================================     1 *@*.webex.com WebexMeetings     1 50 WebexMeetings

NS Routing NE for I-SBC

Example configuration

NS_CLI/System/Device/RoutingNE> get ne WebexMeetings Network Element WebexMeetings Location = 1281465 Data Center = Static Cost =  1 Static Weight = 99 Poll = false OpState = enabled State = OnLine Profile = NIL_PROFILE Remote Lookup Enabled = false Signaling Attributes = NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings Routing NE Address Cost Weight Port Transport Route ===================================================================== WebexMeetings sbc-address     1 99 - unspecified

NS Routing Profile

UrlDialing policy instance added to appropriate routing profile(s)

NS_CLI/Policy/Profile> get profile MyInst Profile:  Webex Policy Instance ========================================== … UrlDialing WebexMeetings

AS Use NS Route for NetworkURL call

Enable the AS to honor the NS route in Hybrid AS mode

AS_CLI/Interface/IMS> set queryNSForNetworkURL true

E911 Emergency Calling

Webex for Cisco BroadWorks supports E911 emergency services calling. With this feature, emergency calls get routed to a Public Safety Answering Point (PSAP) who can then direct emergency services to the caller’s location. To use this feature, you must integrate Webex for Cisco BroadWorks with an E911 emergency call provider.

Use the following Webex articles to configure support for E911 emergency calling services:

  • E911 Emergency Calling in Webex for BroadWorks—Use this article to configure E911 emergency calling in Webex for Cisco BroadWorks using one of the following supported E911 providers:

    • Bandwidth

    • Gör flera

    • RedSky

  • Emergency Call Disclaimer—If you have a location service, you can configure the Emergency Services Disclaimer window on the Webex App to include an option for users to update their location when logging in.

Anpassa och tillhandahålla klienter

Users download and install their generic Webex apps, for desktop or mobile (for download links, see Webex App Platforms). Once the user authenticates, the client registers against theWebex Cloud for messaging and meetings, retrieves its branding info, discovers its BroadWorks service info and downloads its calling configuration from BroadWorks Application Server (via DMS on XSP|ADP).

Du kan konfigurera samtalsparametrar för Webex-appar i BroadWorks (som vanligt). Du konfigurerar varumärkes-, meddelande- och mötesparametrar för klienterna i Control Hub. Du ändrar inte en konfigurationsfil direkt.

Dessa två konfigurationer kan överlappa varandra, vilket innebär att Webex-konfigurationen ersätter BroadWorks-konfigurationen.

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.

Namn

Beskrivning

Codec-prioritet

Konfigurera prioritetsordning för ljud- och videokodekar för VoIP samtal

TCP, UDP och TLS

Konfigurera protokollen som används för SIP-signalering och -media

RTP-ljud- och videoportar

Konfigurera portintervall för RTP-ljud och -video

SIP-alternativ

Konfigurera olika alternativ relaterade till SIP (SIP INFO, använd rport, SIP-proxyupptäckt, uppdatera intervaller för registrering och prenumeration osv.)

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.

Konfigurera din testorganisation för Webex för Cisco BroadWorks

Innan du börjar

Med Flowflödesetablering

You must configure all the XSP|ADP services, and the partner organization in Control Hub, before you can perform this task.

1

Tilldela tjänst i BroadWorks:

  1. Skapa ett testföretag hos ditt tjänsteleverantörsföretag i BroadWorks eller skapa en testgrupp under din tjänsteleverantör (beror på din BroadWorks-installation).

  2. Configure the IM&P service for that enterprise, to point to the template you are testing (retrieve the provisioning adapter URL and credentials from Control Hub Onboarding template).

  3. Skapa testprenumeranter i det företaget/gruppen.

  4. Ge användarna unika e-postadresser i e-postfältet i BroadWorks. Kopiera även dessa till attributet Alternativt ID.

  5. Tilldela den integrerade IM&P-tjänsten till dessa prenumeranter.


     

    Detta utlöser skapandet av kundorganisationen och de första användarna, vilket tar flera minuter. Vänta en liten stund innan du försöker logga in med dina nya användare.

2

Verifiera kundorganisation och användare i Control Hub:

  1. Logga in i Control Hub med ditt partneradministratörskonto.

  2. Gå till Kunder och bekräfta att din nya kundorganisation finns i listan (namnet följer gruppnamnet eller företagsnamnet, från BroadWorks).

  3. Öppna kundorganisationen och kontrollera att prenumeranterna är användare i organisationen.

  4. Verifiera att den första prenumeranten som du har tilldelat den integrerade IM&P-tjänsten har blivit kundadministratör för denna organisation.

Användartest

1

Hämta Webex-appen på två olika datorer.

2

Logga in som dina testanvändare på de två maskinerna.

3

Gör testsamtal.

Hantera Webex för BroadWorks

Tillhandahållande kundorganisationer

I den nuvarande modellen etablerar vi automatiskt kundorganisationen när du registrera den första användaren genom någon av metoderna som beskrivs i det här dokumentet. Etableringen sker bara en gång för varje kund.

Provisione-användare

Du kan etablera användare på följande sätt:

  • Använd API:er för att skapa Webex-konton

  • Tilldela integrerad IM&P (flowuppta etablering) med betrodda e-postmeddelanden för att skapa Webex-konton

  • Tilldela integrerad IM&P (flowspeling provisioning) utan betrodda e-postmeddelanden. Användare anger och validerar e-postadresser för att skapa Webex-konton

  • Tillåt användare att självaktivera (du skickar dem en länk, de skapar Webex-konton)

Offentliga API:er för tillhandahållande

Webex visar offentliga API:er för att tjänsteleverantörer ska kunna integrera Webex för Tillhandahållande av Cisco BroadWorks-prenumeranter i sina befintliga arbetsflöden för etablering. Specifikationen för dessa API:er finns tillgänglig developer.webex.com . Om du vill utveckla med dessa API:er ska du kontakta din Cisco-representant för att få Webex för Cisco BroadWorks.


 

Wholesale customers will be rejected by these APIs.

Flowflödesetablering

I BroadWorks kan du tillhandahålla användare med alternativet Aktivera integrerat SNABBMEDDELANDE&P. Den här åtgärden innebär att BroadWorks-tillhandahållande-adaptern gör en API-samtal att etablera användaren på Webex. Vår etablerings-API är bakåtkompatibel med UC-One SaaS API. BroadWorks AS kräver ingen kodändring, bara en konfigurationsändring till API-slutpunkten för provisioneringsadaptern.


 

Prenumeranters etablering på Webex kan ta lång tid (flera minuter för den ursprungliga användaren i ett företag). Webex utför etableringen som en bakgrundsuppgift. Så om flödet startas indikerar den här provisionering att den har startat. Den visar inte att den är klar.

För att bekräfta att användare och kundorganisationen är fullständigt provisionerade på Webex, måste du logga in på Partner Hub och titta i din kundlista.

BroadWorks trunking users can have Webex for BroadWorks via a shared call appearance (SCA). The trunking user will need to have the Authentication service assigned. As described in the BroadWorks Trunking Solution Guide Section 8, this allows the authentication of the SCA Webex appearance to be separate from the common trunk authentication. Webex for BroadWorks cannot be provisioned for trunking users with the Route List or Direct Route features assigned.


 
The location of templates has been moved from BroadWorks Calling in Org Settings to the Customer List section and it is now called the Onboarding template.

Användarens självaktivering

Så här etablerar du BroadWorks-användare i Webex utan att tilldela den integrerade IM&P-tjänsten:

  1. Sign in to Partner Hub, and find the Customer List page.

  2. Klicka på Visa mallar.

  3. Select the provisioning Onboarding template you want to apply to this user.

    Kom ihåg att varje mall är associerad med ett kluster och din partnerorganisation. Om användaren inte är i BroadWorks-systemet som är associerat med den här mallen kan användaren inte självaktivera med länken.

  4. Kopiera provisioneringslänken och skicka den till användaren.

    Du kanske även vill inkludera länken för hämtning av programvara och påminna användaren om att de måste tillhandahålla och bekräfta sin e-postadress för att aktivera Webex-kontot.

  5. Du kan övervaka användarens aktiveringsstatus för den valda mallen.

Se Användareetablering och aktiveringsflöden för merinformation.

Tillhandahållande av opålitliga e-postmeddelanden

Partner Hub tillhandahåller en uppsättning kontroller i vyn Användarstatus som gör det möjligt för Webex för Cisco BroadWorks tjänsteleverantör-administratörer att granska användarstatus och lösa fel när de etablerar opålitliga e-postmeddelanden. Mer information finns i Verifiera användareetablering av ej betroddae-postmeddelanden.

Flytta Webex-användare till Webex för Cisco BroadWorks

To move existing Webex users to Webex for Cisco BroadWorks, refer to the below table to determine which procedure to follow.

Existing Webex user belongs to a…

Follow these processes to move the user

Consumer organization or self-signup (e.g., free account, trial account)

  1. Provision Users—If the Webex for BroadWorks organization does not exist (with no users provisioned), follow normal provisioning to provision the first user as an admin user and create the organization. This moves the Webex user account automatically for the first user. For subsequent users, use the below procedure.

  2. Move User (with Consent) to Webex for Cisco BroadWorks—If the Webex for BroadWorks organization exists (first user is provisioned), obtain user consent and move subsequent users.

Kundorganisation

Attach Webex for BroadWorks to Existing Organization—The organization attachment (for the first user) also adds Webex for BroadWorks to subsequent users, so long as they are assigned to the correct organization.

Existing Webex user belongs to a…

Follow these processes to move the user

Consumer organization or self-signup (e.g., free account, trial account)

If Webex for BroadWorks organization does not exist (no users are provisioned):

  • Provision Users—Follow normal provisioning to add the first user as an admin user. This moves the account for the first user automatically and creates the Webex for BroadWorks organization. User consent is required to move susbsequent users (use the below procedure).

If Webex for BroadWorks organization exists (at least one user is provisioned):

Kundorganisation

Flytta användare (med samtycke) till Webex för Cisco BroadWorks

Use this procedure to move an existing Webex user who is in a consumer organization or has a self-signup account (free account or trial account) to Webex for Cisco BroadWorks. Note that the Webex for Cisco BroadWorks organization must exist (with the first user provisioned). In this case, you can use one of these options to move users:

  • Move User (with Trusted Email)—Uses provisioning with trusted emails

  • Move User (with Untrusted Email)—Uses provisioning with untrusted emails

  • Självaktivering


 
If the Webex for Cisco BroadWorks organization is not yet created (no users are provisioned), follow normal provisioning processes ( Provision Users) to create the organization and add the first user as an administration user. After the first user is provisioned into the organization, follow the consent-based methods in this procedure to move subsequent users.

Flytta användare (med betrodd e-post)

If the Onboarding template uses Trusted Emails, the partner administrator can move subsequent users with this process:

  1. Administratören lägger till användaren.

    • Användaren skickas vidare till BroadWorks etableringsbrygga.

    • CI-sökning avgör att den här användaren har ett annat Webex-konto med denna e-postadress.

    • Ett automatiskt e-postmeddelande skickas till användaren.

  2. Användaren öppnar e-postmeddelandet och klickar på Aktivera konto. Användaren omdirigeras till Webex-konsumentportalen.

  3. Användare loggar in på Webex.

  4. Användaren klickar på Ta bort för att ta bort det gamla Webex-kontot.

    • Det gamla Webex-kontot har raderats.

    • Användaren tillhandahålls av Webex för Cisco BroadWorks med samma e-postadress.

    • Användaren dirigeras till hämtningssidan.

Flytta användare (med ej betrodd e-post)

If the Onboarding template uses Untrusted Emails, the user’s email address must first be validated. Administratören kan följa den här processen för att flytta efterföljande användare:

  1. Administratören lägger till användaren.

    • Användaren förs automatiskt vidare till BroadWorks-etableringsbryggan.

    • En text med en aktiveringslänk skickas till användaren.

  2. Användaren klickar på aktiveringslänken och anger sin e-postadress.

    • CI-sökning avgör att den här användaren har ett annat Webex-konto med denna e-postadress.

    • Ett automatiskt e-postmeddelande skickas till användaren.

  3. Användaren öppnar e-postmeddelandet och klickar på Delta nu.

    • E-postadressen har validerats.

    • Användare omdirigeras för att logga in på Webex-konsumentportalen.

  4. Användare loggar in på Webex.

  5. Användaren måste klicka på Ta bort för att ta bort det gamla Webex-kontot.

    • Det gamla Webex-kontot har raderats.

    • Användaren tillhandahålls av Webex för Cisco BroadWorks med samma e-postadress.

    • Användaren dirigeras till hämtningssidan.

Självaktiveringsflöde

Om användaren har ett befintligt BroadWorks-konto kan de använda självaktiveringsprocessen för att flytta sitt konto.

  1. Användaren loggar in på URL:en för användaråtkomstportalen med BroadWorks-inloggningsuppgifter.

  2. Användaren anger sin e-postadress.

    • Användaren skickas vidare till BroadWorks etableringsbrygga.

    • Ett automatiskt e-postmeddelande skickas till användarens e-postadress.

  3. Användaren öppnar e-postmeddelandet och klickar på länken Delta nu, som validerar e-postadressen.

    • CI hittar användaren har ett befintligt Webex-konto. Användare måste radera det gamla kontot innan de kan fortsätta.

    • Användare omdirigeras för att logga in på Webex.

  4. Användaren loggar in på konsumentportalen.

  5. Användaren klickar på Ta bort konto.

    • Det gamla Webex-kontot tas bort.

    • Användaren etablerar ett nytt Webex-konto för Cisco BroadWorks med samma e-postadress.

Attach Webex for BroadWorks to Existing Organization

If you are a partner administrator adding Webex for BroadWorks services to an existing Webex customer organization, which is not yet associated with a partner managed BroadWorks enterprise, the customer organization administrator MUST approve administrator access for the provisioning request to succeed.

Organization administrator approval is needed if any of the following are true:

  • The existing customer organization has 100 users or more

  • The organization has a verified email domain

  • The organization domain is claimed

If none of the criteria above are true, then an Automatic Attach may occur.


 
In an Automatic Attachment scenario, a Webex for BroadWorks subscription is added to an existing customer organization without any notification to the existing org administrator or end user. In most cases your Partner Org will be given Provisioning Admin rights. However, if the customer org has no licenses or only suspended/canceled licenses, then you will be made a Full Admin.

With Provisioning Admin access, you will have limited visibility in Control Hub to the users in the existing org. It is recommended that you contact the customer admin and request Full Admin access to the org.

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


 
Make sure the Allow admin-invite emails when attaching to existing orgs (the toggle is on by default).
1

Partneradministratören anger Webex för Cisco BroadWorks för kunden. For help, see Provision Customer Organizations. Följande sker:

  • Organization attachment fails with a 2017 error (Unable to provision Subscriber into an Existing Webex Organization). (An error will not be received during an Automatic Attachment.)

  • Ett e-postmeddelande skapas och skickas till kundens organisationsadministratörer (upp till fem administratörer). The email notification highlights the partner administrator's email (as configured in the Onboarding template within Partner Hub) and asks the org administrator to approve the partner administrator as an external administrator. The customer org administrator must approve the request and provide the partner administrator with full administrator access to the customer org.


 

Suppose the customer administrator does not receive an email. In that case, the customer administrator can manually add the partner administrator (specified in the template) as the external administrator of the customer org from the Control Hub. Then retry provisioning the user, which will trigger the Webex for Cisco BroadWorks customer provision.

2

With full administrator access, the partner administrator can complete the process of provisioning the customer. You will need to re-attempt the Provisioning of the customer starting from Step 1 above. However, now as an external Full Admin, you should not observe the error 2017.

Once the provisioning of calling services is completed, the existing customer org will be visible as a customer underneath the Webex for BroadWorks Partner Org.


 
The attached org’s name will not change to the BroadWorks enterprise name. The name of the attached org will be remain as it was prior to the attach process.

Conditions of Org Attachment

  • The email address of the first BroadWorks subscriber provisioned must match the email address of an existing user in the targeted customer org. Otherwise, a new customer org will be created.

  • The first user from the existing org who is provisioned for Webex for BroadWorks is not provisioned as an admin user. Settings and entitlements from the existing org are retained.

  • The organization’s existing authentication settings take precedence over what is configured on the Webex for BroadWorks provisioning template. As a result, there is no change to how existing users log in.

    • However, if the existing customer organization has basic branding enabled, after the attach occurs the Partner's Advanced branding settings will take precedence. If the customer wants the basic branding to remain intact, then the partner must configure the customer organization to override branding in the Advanced Branding settings.

  • The name of the existing organization will not change.

  • There is no change to the email suppression flag setting in the existing org’s settings. This may affect newly provisioned users. Depending on how the flag is set, new users may or may not receive an email with a code that must be entered in order to complete activation.

  • Restricted Admin Mode (set by the Restricted by Partner Mode toggle) is turned off for the attached org.

  • Make sure to complete the organization attachment process (moving existing users and updating the organization ID), before you provision new users into the Webex for Cisco BroadWorks organization.

  • A BroadWorks enterprise can be associated with one Webex organziation only. You cannot provision subscribers from a single BroadWorks enterprise into separate Webex organizations.

Lägg till extern administratör

Mer information om de steg som kundorganisationsadministratörerna kan följa för att lägga till partneradministratören som en extern administrat