Installer Webex til BroadWorks

Installationsoversigt

Følgende diagrammer repræsenterer den typiske rækkefølge af dine installationsopgaver for de forskellige bruger-klargøringstilstande. Mange af opgaverne er fælles for alle klargøringstilstande.

Figur 1. Opgaver påkrævet for implementering af flow-through klargøring
Viser rækkefølgen af opgaver, der kræves for installation af Webex til BroadWorks med flow-through klargøring og betroede e-mails
Figur 2. Opgaver påkrævet for implementering af flowthr deployering uden betroede e-mails
Viser rækkefølgen af opgaver, der er nødvendig for implementering af Webex til BroadWorks med flow-through klargøring uden e-mails
Figur 3. Opgaver, der er påkrævet for installation af brugers selvbetjening
Viser rækkefølgen af opgaver, der kræves for implementering af Webex til BroadWorks med selvaktivering

Partner onboarding til Webex til BroadWorks

Hver Webex til BroadWorks Tjenesteudbyder eller forhandler skal konfigureres som en partnerorganisation for Webex til BroadWorks. Hvis du har en eksisterende Webex-partnerorganisation, kan dette bruges.

For at gennemføre den nødvendige onboarding skal du udføre din Webex til BroadWorks, og nye partnere skal acceptere den online Indirekte kanalpartneraftale (ICPA). Når disse trin er udført, opretter Cisco Compliance en ny partnerorganisation i Partner Hub (hvis det er nødvendigt), og du sender en e-mail med godkendelsesoplysninger til administratoren af optegnelse i klar overensstemmelse. Samtidig vil din Partner Activation and/eller Customer Success Program Manager kontakte dig for at starte din onboarding.

Konfigurer tjenester på dit Webex for BroadWorks XSPs

Vi kræver, at NPS-applikationen køres på en anden XSP. Krav for denne XSP er beskrevet i Konfigurer opkaldsmeddelelser fra dit netværk.

Du har brug for følgende applikationer/tjenester på dine XSP'er.

Tjeneste/applikation

Godkendelse er påkrævet

Tjenesteydelses-/applikationsformål

Xsi-begivenheder

TLS (serveren godkender sig selv til klienter)

Opkaldskontrol, servicemeddelelser

Xsi-handlinger

TLS (serveren godkender sig selv til klienter)

Opkaldskontrol, handlinger

Enhedsadministration

TLS (serveren godkender sig selv til klienter)

Download af konfiguration af opkald

Godkendelsestjeneste

TLS (serveren godkender sig selv til klienter)

Brugerbekræftelse

Integration af computertelefoni

mTLS (klient og server godkend hinanden)

Telefoni tilstedeværelse

Opkaldsindstillinger Webview-applikation

TLS (serveren godkender sig selv til klienter)

Viser brugeropkaldsindstillinger i selvbetjeningsportalen i Webex-appen

Dette afsnit beskriver, hvordan du anvender de påkrævede konfigurationer for TLS og mTLS på disse grænseflader, men du skal referere til eksisterende dokumentation for at få applikationerne installeret på dine XSP'er.

Krav til fællesopbevaring

  • Bekræftelsestjenesten skal være co-resident med Xsi-applikationer, da disse grænseflader skal acceptere tokens, der har været gennem længere tid, for at kunne godkende tjenesten. Bekræftelsestjenesten er påkrævet for at validere disse tokens.

  • Godkendelsestjenesten og Xsi kan om nødvendigt køre på den samme port.

  • Du kan adskille de andre tjenesteydelser/applikationer som påkrævet for din skala (dedikeret enhedsstyring XSP pv, for eksempel).

  • Du kan finde Xsi-, CTI-, godkendelsesservice- og DMS-applikationer sammen med andre.

  • Installer ikke andre applikationer eller tjenester på de XSP'er, der bruges til at integrere BroadWorks med Webex.

  • Undlad at finde NPS-applikationen sammen med andre applikationer.

Xsi-grænseflader

Installer og konfigurer Xsi-actions- og Xsi-Events-applikationerne som beskrevet i konfigurationsvejledningen til Cisco BroadWorks Xtended Services Interface.

Konfigurer godkendelsestjeneste (med CI-tokenbekræftelse)

Brug denne procedure til at konfigurere godkendelsestjenesten til at bruge CI-tokenvalidering med TLS. Denne bekræftelsesmetode anbefales, hvis du kører R22 eller nyere, og dit system understøtter den.


Fælles TLS (mTLS) understøttes som en alternativ bekræftelsesmetode for Auth-tjenesten. Hvis følgende forhold gælder for dit system, skal du konfigurere mTLS-godkendelse i stedet for CI-tokenbekræftelse:

  • Du kører R21SP1.

  • Du har flere Webex-organisationer, der kører på den samme XSP-server. I dette tilfælde skal du bruge mTLS-godkendelse, da CI-tokenbekræftelse ikke understøtter flere forbindelser til den samme XSP Auth-tjeneste.

Bemærk, at hvis du kører R22 eller derover, og du i øjeblikket bruger mTLS til Auth-tjenesten, er det ikke obligatorisk, at du konfigurerer igen for at bruge CI-tokenvalidering med TLS.

For at konfigurere mTLS-godkendelse for Auth-tjenesten henvises der til Konfigurer XSP-godkendelsestjeneste (med mTLS) i tillægget.

  1. Opret en serviceanmodning med din kontaktperson for onboarding eller med TAC for at klargøre din OAuth-klientkonto (Webex Common Identity-konto). Titel din serviceanmodning "XSP AuthService Configuration". Cisco giver dig et OAuth-klient-id, en klient hemmelighed og en opdateringstoken, der er gyldig i 60 dage. Hvis tokenet udløber, før du bruger det med din XSP, kan du rindhæv en anden anmodning.

  2. Installer følgende programrettelser på hver XSP-server. Installer de programrettelser, der passer til din udgivelse:

    • For R22:

      AP.platform.22.0.1123.ap376508

      AP.xsp.22.0.1123.ap376508

      AP.xsp.22.0.1123.ap368601

    • For R23:

      AP.xsp.23.0.1075.ap376509

      AP.platform.23.0.1075.ap376509

    • Til R24 – ingen programrettelse påkrævet

  3. Installer AuthenticationService applikation på hver XSP-tjeneste.

    1. Kør følgende kommando for at aktivere applikationen AuthenticationService på XSP til kontekststien /authService.

      XSP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
    2. Kør denne kommando for at installere AuthenticationService på XSP:

      XSP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
  4. Konfigurer Identitetsudbydere ved at køre følgende kommandoer på hver XSP-server:

    XSP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get

    • set enabled true

    • set clientId <client id>

    • set clientSecret <secret from TAC service request>

    • set ciResponseBodyMaxSizeInBytes 65536

    • set issuerName <URL> –For den URL, indtast URL-adressen til issuerName, der gælder for din CI-klynge. Se nedenstående tabel.

    • set issuerUrl <URL> –For den URL, indtast den Udsteder-URL, der gælder for din CI-klynge. Se nedenstående tabel.

    • set tokenInfoUrl <IdPProxy URL> – Indtast IDP-proxy-URL-adressen, der gælder for din Teams-klynge. Se nedenstående tabel.

    Tabel 1. Identitetsudbyder URL-adresser

    Udsteders URL-adresse og udstedernavn

    IdP-proxy URL-adresse

    Hvis CI-klyngen er ...

    Indstil udstedersURL og udstedernavn til...

    Hvis Teams-klynge er ...

    Indstil IdP-proxy URL-adresse til ...

    USA – A

    https://idbroker.webex.com/idb

    ACHM

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

    Eu

    https://idbroker-eu.webex.com/idb

    AFRA

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

    USA– B

    https://idbroker-b-us.webex.com/idb

    AORE

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

    * Hvis du ikke kender din CI-klynge eller Teams-klynge , kan du få oplysningerne fra visningen Help Desk i ControlHub. Under Kundeoplysninger kan du se værdien af felterne CI-klynge og Teams-klynge.


     
    Til test kan du bekræfte, at URL-adressen er gyldig ved at erstatte linket " idp/authenticate" del af URL-adressen med " ping".
  5. Angiv den Webex-berettigelse, der skal være til stede i brugerprofil i Webex, ved at køre følgende kommando:

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

  6. Konfigurer identitetsudbydere for Cisco Federation ved hjælp af følgende kommandoer på hver XSP-server:

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

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

    • set refreshPeriodInMinutes 60

    • set refreshToken <token from service request>

  7. Kør følgende kommando for at bekræfte, at din FLS-konfiguration fungerer. Denne kommando returnerer listen over identitetsudbydere:

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

  8. Konfigurer Tokenadministration ved hjælp af følgende kommandoer på hver XSP-server:

    • XSP_CLI/Applications/AuthenticationService/TokenManagement>

    • set tokenIssuer BroadWorks

    • set tokenDurationInHours 720

  9. Generer og del RSA-nøgler. Du skal generere nøgler på en XSP og derefter kopiere dem til alle andre XSPs. Dette skyldes følgende faktorer:

    • Du skal bruge de samme offentlige/private nøglepar til tokenkryptering/dekryptering på tværs af alle forekomster af bekræftelsestjenesten.

    • Nøgleparret genereres af bekræftelsestjenesten, når den først skal udstede en token.


    Hvis du skifter taster eller ændrer nøglens længde, skal du gentage følgende konfiguration og genstarte alle XSP'er.
    1. Vælg en XSP til brug for generering af et nøglepar.

    2. Brug en klient til at anmode om et krypteret token fra den XSP ved at anmode om følgende URL-adresse fra klientens browser:

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

      (Dette genererer et privat/offentligt nøglepar på XSP, hvis der ikke allerede var én)

    3. Nøglelagerplaceringen kan ikke konfigureres. Eksportér nøglerne:

      XSP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. Kopier den eksporterede fil /var/broadworks/tmp/authService.keys på den samme placering på de andre XSP'er, og overskrive en ældre .keys fil, om nødvendigt.

    5. Importer nøgler på hver af de andre XSP'er:

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

  10. Angiv AUthService URL-adressen til web-beholderen. XSP'ens web-beholder skal bruge URL-adressen til godk.-tjeneste, så den kan validere tokens. På hver af de XSP'er:

    1. Tilføj BEKRÆFTELSEstjenestens URL-adresse som en ekstern godkendelsestjeneste for hjælpeprogrammet BroadWorks Communications:

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

    2. Tilføj URL-adressen til bekræftelsestjenesten i beholderen:

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

      Dette gør Webex i stand til at bruge godkendelsestjenesten til at validere tokens, der vises som legitimationsoplysninger.

    3. Kontrollér parameteren med get.

    4. Genstart XSP.

Konfigurering af TLS og kode på HTTP-grænseflader (til XSI og godkendelsestjeneste)

Godkendelsestjenesten, Xsi-handlinger og Xsi-Events-applikationer bruger HTTP-servergrænseflader. Niveauerne for TLS-konfigurering for disse applikationer er som følger:

Mest generelle = System > Transport > HTTP > HTTP Server-grænseflade = Mest specifik

De CLI-kontekster, du bruger til at se eller modificere de forskellige SSL-indstillinger, er:

Specificitet CLI-kontekst
System (globalt)

XSP_CLI/System/SSLCommonSettings/JSSE/Ciphers>

XSP_CLI/System/SSLCommonSettings/JSSE/Protocols>

Transportprotokoller til dette system

XSP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers>

XSP_CLI/System/SSLCommonSettings/OpenSSL/Protocols>

HTTP på dette system

XSP_CLI/Interface/Http/SSLCommonSettings/Ciphers>

XSP_CLI/Interface/Http/SSLCommonSettings/Protocols>

Specifikke HTTP-servergrænseflader på dette system

XSP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

XSP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

Læsning af HTTP-serverens TLS-grænsefladekonfiguration på XSP

  1. Log ind på XSP, og naviger til XSP_CLI/Interface/Http/HttpServer>

  2. Indtast get og læse resultaterne. Du bør se grænsefladerne (IP-adresser) og for hver, om de er sikre, og om de kræver klientbekræftelse.

Slørings tomcat kræver et certifikat for hver sikker grænseflade; systemet opretter et selv underskrevet certifikat, hvis det har brug for et.

XSP_CLI/Interface/Http/HttpServer> get

Tilføjelse af TLS 1.2-protokol til HTTP-servergrænsefladen


Denne procedure gælder for R22 og senere. For at konfigurere TLS-version på R21(SP1) skal du bruge valgmuligheden XSP-platformbeholder bw.apache.sslenabledprotocols.

HTTP-grænsefladen, som interagerer med Webex Cloud, skal konfigureres til TLSv1.2. Skyen forhandler ikke tidligere versioner af TLS-protokollen.

Sådan konfigureres TLSv1.2-protokollen på HTTP-servergrænsefladen:

  1. Log ind på XSP, og naviger til XSP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Indtast kommandoen get <interfaceIp> 443 for at se hvilke protokoller, der allerede bruges på denne grænseflade.

  3. Indtast kommandoen add <interfaceIp> 443 TLSv1.2 for at sikre, at grænsefladen kan bruge TLS 1.2 ved kommunikation med cloud.

Redigering af TLS Ciphers-konfiguration på HTTP-servergrænsefladen


Denne procedure gælder for R22 og senere. For at konfigurere TLS-koder på R21(SP1) skal du bruge valgmuligheden XSP-platformbeholder bw.apache.sslciphersuite.

Sådan konfigurerer du de påkrævede koder:

  1. Log ind på XSP, og naviger til XSP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Indtast kommandoen get <interfaceIp> 443 for at se, hvilke koder der allerede bruges på denne grænseflade. Der skal være mindst én fra de Cisco-anbefalede pakker (se XSP-identitets- og sikkerhedskrav i afsnittet Oversigt).

  3. Indtast kommandoen add <interfaceIp> 443 <cipherName> for at tilføje en kode til HTTP-servergrænsefladen.


    XSP CLI kræver IANA standard kodepakkenavn, ikke det åbneSL kodepakkenavn. For eksempel, for at tilføje den åbneSSL-kode ECDHE-ECDSA-CHACHA20-POLY1305 til HTTP-servergrænsefladen skal du bruge: XSP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Se https://ciphersuite.info/ for at finde suite ved enten navn.

Konfigurer enhedsadministration på XSP, applikationsserver og profilserver

Profilserver og XSP er obligatoriske for Enhedsadministration. De skal konfigureres i overensstemmelse med vejledningerne i BroadWorks Device Management Configuration Guide (https://xchange.broadsoft.com/node/1031995).

CTI-grænseflade og relateret konfiguration

Konfigurationsrækkefølgen "længst til længst" er vist herunder. Det er ikke obligatorisk at følge denne ordre.

  1. Konfigurer applikationsserver til CTI-abonnementer

  2. Konfigurer XSP'er til mTLS-godkendte CTI-abonnementer

  3. Åbn indgående porte for sikker CTI-grænseflade

  4. Abonner på BroadWorks CTI-begivenheder i din Webex-organisation

Konfigurer applikationsserver til CTI-abonnementer

Opdater ClientIdentity på applikationsserveren med fællesnavnet (CN) for Webex for BroadWorks CTI-klientcertifikat.

For hver applikationsserver, du bruger med Webex, skal du tilføje certifikatidentiteten til ClientIdentity som følger:

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


Det fælles navn på Webex for BroadWorks-klientcertifikatet er bwcticlient.webex.com.

Konfigurer TLS og Ciphers på CTI-grænsefladen

Niveauerne for konfigurering for XSP CTI-grænsefladen er som følger:

Mest generelle = System > Transport > CTI Interfaces > CTI interface = De fleste specifikke

De CLI-kontekster, du bruger til at se eller modificere de forskellige SSL-indstillinger, er:

Specificitet

CLI-kontekst

System (globalt)

(R22 og senere)

XSP_CLI/System/SSLAlmon-indstillinger/JSSE/Ciphers>

XSP_CLI/System/SSLCommonSettings/JSSE/Protocols>

Transportprotokoller til dette system

(R22 og senere)

XSP_CLI/System/SSLAlmonSettings/OpenSSL/Ciphers>

XSP_CLI/System/SSLAlmonSettings/OpenSSL/Protocols>

Alle CTI-grænseflader på dette system

(R22 og senere)

XSP_CLI/Interface/CTI/SSLCommonSettings/Ciphers>

XSP_CLI/Interface/CTI/SSLAlmaniske Indstillinger/protokoller>

En specifik CTI-grænseflade på dette system

(R22 og senere)

XSP_CLI/Interface/CTI/SSLSettings/Ciphers>

XSP_CLI/Interface/CTI/SSLSettings/Protocols>

Læse CTI TLS-grænsefladekonfiguration på XSP

  1. Log ind på XSP, og naviger til XSP_CLI/Interface/CTI/SSLSettings>

    På BroadWorks R21: naviger til XSP_CLI/Interface/CTI/SSLConfiguration>

  2. Indtast get og læse resultaterne. Du bør se grænsefladerne (IP-adresser) og for hver, om de kræver et servercertifikat, og om de kræver klientbekræftelse.

Tilføjelse af TLS 1.2-protokol til CTI-grænsefladen


Denne procedure gælder for R22 og senere. For at konfigurere TLS-versionen på CTI-grænsefladen for R21(SP1) skal du bruge valgmuligheden tomcat container bw.cti.sslenabledprotocols.

XSP CTI-grænsefladen, som interagerer med Webex Cloud, skal konfigureres til TLS v1.2. Skyen forhandler ikke tidligere versioner af TLS-protokollen.

Sådan konfigureres TLSv1.2-protokollen på CTI-grænsefladen:

  1. Log ind på XSP, og naviger til XSP_CLI/Interface/CTI/SSLSettings/Protocols>

  2. Indtast kommandoen get <interfaceIp> for at se hvilke protokoller, der allerede bruges på denne grænseflade.

  3. Indtast kommandoen add <interfaceIp> TLSv1.2 for at sikre, at grænsefladen kan bruge TLS 1.2 ved kommunikation med cloud.

Redigering af TLS-kodekonfiguration på CTI-grænsefladen


Denne procedure gælder for R22 og senere. For at konfigurere koderne på CTI-grænsefladen for R21(SP1) skal du bruge valgmuligheden tomcat container bw.cti.enabledciphers.

Sådan konfigureres de påkrævede koder på CTI-grænsefladen:

  1. Log ind på XSP, og naviger til XSP_CLI/Interface/CTI/SSLSettings/Ciphers>

  2. Indtast get for at se, hvilke koder der allerede bruges på denne grænseflade. Der skal være mindst én fra de Cisco-anbefalede pakker (se XSP-identitets- og sikkerhedskrav i afsnittet Oversigt).

  3. Indtast kommandoen add <interfaceIp> <cipherName> for at tilføje en kode til CTI-grænsefladen.


    XSP CLI kræver IANA standard kodepakkenavn, ikke det åbneSL kodepakkenavn. For eksempel, for at tilføje den åbneSSL-kode ECDHE-ECDSA-CHACHA20-POLY1305 til CTI-grænsefladen, ville du bruge: XSP_CLI/Interface/CTI/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Se https://ciphersuite.info/ for at finde suite ved enten navn.

Opdater tillidsankre til CTI-grænseflade (R22 og nyere)

Denne procedure går ud fra, at XSP'erne enten er internetbaserede eller ansigt til ansigt med internettet via en proxy. Certifikatkonfigurationen er forskellig for en brobroproxy (se TLS-certifikatkrav for TLS-bridge Proxy).

For hver XSP i din infrastruktur, der udgiver CTI-begivenheder til Webex, skal du gøre følgende:

  1. Log ind på Partner Hub.

  2. Gå til Indstillinger > BroadWorks Calling, og klik på Download Webex CA-certifikat for at fåCombinedCertChain.txt på din lokale computer.


    Denne fil indeholder to certifikater. Du skal opdele filen, før du overfører den til XSP'erne.

  3. Opdel certifikatkæden i to certifikater:

    1. Åbn combinedcertchain.txt i et tekstredigeringsprogram.

    2. Vælg og beskære den første blok af tekst, herunder linjerne -----BEGIN CERTIFICATE----- og -----END CERTIFICATE-----, og indsæt tekstblokering i en ny fil.

    3. Gem den nye fil som broadcloudroot.txt.

    4. Gem den originale fil som broadcloudissuing.txt.

      Den oprindelige fil må nu kun have én tekstblok, omgivet af linjerne -----BEGIN CERTIFICATE----- og -----END CERTIFICATE-----.

  4. Kopier begge tekstfiler til en midlertidig placering på den XSP, du er ved at sikre, f.eks. /tmp/broadcloudroot.txt og /tmp/broadcloudissuing.txt.

  5. Log ind på XSP, og naviger til /XSP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Valgfri) Køre help updateTrust for at se parametrene og kommandoformatet.

  7. Overfør certifikatfilerne til nye tillidsankre:

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

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


    webexroot og webexissuing er eksempelaliaser for tillidankre; kan du bruge din egen.

  8. Bekræft, at ankre er opdateret:

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

      Alias   Owner                                   Issuer
    =============================================================================
    webexissuing    BroadCloud Commercial Issuing CA – DA3     BroadCloud Commercial Trusted Root CA
    webexroot       BroadCloud Commercial Trusted Root CA      BroadCloud Commercial Trusted Root CA[self-signed]
  9. Tillad klienter at godkende med certifikater:

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

Opdater tillidsankre til CTI-grænseflade (R21)

Denne procedure går ud fra, at XSP'erne enten er internetbaserede eller ansigt til ansigt med internettet via en proxy. Certifikatkonfigurationen er forskellig for en brobroproxy (se TLS-certifikatkrav for TLS-bridge Proxy).

For hver XSP i din infrastruktur, der udgiver CTI-begivenheder til Webex, skal du gøre følgende:

  1. Log ind på Partner Hub.

  2. Gå til Indstillinger > BroadWorks Calling, og klik på Download Webex CA-certifikat for at fåCombinedCertChain.txt på din lokale computer.


    Denne fil indeholder to certifikater. Du skal opdele filen, før du overfører den til XSP'erne.

  3. Opdel certifikatkæden i to certifikater:

    1. Åbn combinedcertchain.txt i et tekstredigeringsprogram.

    2. Vælg og beskære den første blok af tekst, herunder linjerne -----BEGIN CERTIFICATE----- og -----END CERTIFICATE-----, og indsæt tekstblokering i en ny fil.

    3. Gem den nye fil som broadcloudroot.txt.

    4. Gem den originale fil som broadcloudissuing.txt.

      Den oprindelige fil må nu kun have én tekstblok, omgivet af linjerne -----BEGIN CERTIFICATE----- og -----END CERTIFICATE-----.

  4. Kopier begge tekstfiler til en midlertidig placering på den XSP, du er ved at sikre, f.eks. /tmp/broadcloudroot.txt og /tmp/broadcloudissuing.txt.

  5. Log ind på XSP, og naviger til /XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts>

  6. (Valgfri) Køre help updateTrust for at se parametrene og kommandoformatet.

  7. Opdater nye tillidsankre med certifikaterne:

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

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

    (hvor "webexroot" og "webexissuing" er eksempelaliaser for tillidankre, kan du vælge din egen)

  8. Bekræft, at begge certifikater er overført:

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

    XSP_CLI/Interface/CTI/SSLConfiguration/ClientAuthentication/Trusts> get
                 Alias                                   Owner                                           Issuer
    ===========================================================================================================
         webexissuing   BroadCloud Commercial Issuing CA - DA3 BroadCloud Commercial Trusted Root CA
            webexroot   BroadCloud Commercial Trusted Root CA  BroadCloud Commercial Trusted Root CA[self-signed]
  9. Tillad klienter at godkende med certifikater:

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

Tilføj CTI-grænseflade og aktiver mTLS

  1. Tilføj CTI SSL-grænsefladen.

    CLI-konteksten afhænger af din BroadWorks-version. Kommandoen opretter et selv underskrevet servercertifikat på grænsefladen og tvinger -grænsefladen til at kræve et klientcertifikat.

    • På BroadWorks 22 og 23.0:

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

    • På BroadWorks 21.sp1:

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

  2. Aktiver og definer den sikre CTI-port på XSP'er:

    XSP_CLI/Interface/CTI> set securePortEnabled true

    XSP_CLI/Interface/CTI> set securePort 8012

  3. Udskift servercertifikatet og -nøglen på XSP's CTI-grænseflader. Du skal bruge IP-adressen til CTI-grænsefladen til dette; kan du læse den fra følgende kontekst:

    • På BroadWorks 22 og 23.0:

      XSP_CLI/Interface/CTI/SSLSettings> get

    • På BroadWorks 21.sp1:

      XSP_CLI/Interface/CTI/SSLConfiguration> get

      Kør derefter følgende kommandoer for at erstatte brugergrænsefladens selv underskrevne certifikat med dit eget certifikat og din private nøgle:

      På BroadWorks 22.0 og 23.0:

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

      På BroadWorks 21.sp1:

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

  4. Genstart XSP.

Åbn indgående porte for sikker CTI-grænseflade

Åbn den sikre port for CTI på din firewall (TCP 8012 som standard) for en indgående TLS-forbindelse til din XSP CTI-grænseflade.

Sådan kontrollerer du, at den sikre port er aktiveret og dens portnummer:

  1. Log ind på XSP CLI, og naviger til XSP_CLI/Interface/CTI> Forbindelse.

  2. Enter get.

Du kan blandt andet se følgende oplysninger:

securePortEnabled = true

securePort = 8012

Dette sikrer, at Webex kan starte en krypteret forbindelse.

Webex bruger kun den sikre port, så vi anbefaler, at du indstiller portEnabled = false for at deaktivere den usikrede port.

Aktiver adgang til BroadWorks CTI-begivenheder på Webex

Du skal tilføje og validere CTI-grænsefladen, når du konfigurerer dine klynger i Partner Hub. Se Konfigurer din partnerorganisation i Control Hub for at få yderligere oplysninger.

  • Angiv CTI-adressen, hvormed Webex kan abonnere på BroadWorks CTI-begivenheder.

  • CTI-abonnementer er pr. abonnent og oprettes og opretholdes kun, mens abonnenten er klargjort til Webex til BroadWorks.

Webvisning af opkaldsindstillinger

Opkaldsindstillinger Webview (CSWV) er en applikation hostet på XSP (eller ADP) for at gøre det muligt for brugere at ændre deres BroadWorks-opkaldsindstillinger via en webview, som de ser i den bløde klient. Der er en detaljeret CSWV-løsningsvejledning på https://xchange.broadsoft.com/node/1050149.

Webex gør brug af denne funktion til at give brugere adgang til almindelige BroadWorks-opkaldsindstillinger, der ikke er indbyggede i Webex-appen.

Hvis du ønsker, at dine Webex til BroadWorks-abonnenter skal have adgang til opkaldsindstillinger ud over de standardindstillinger, der er tilgængelige i Webex-appen, skal du installere funktionen Opkaldsindstillinger Webview.

Opkaldsindstillinger Webview har to komponenter:

  • Opkaldsindstillinger Webview-applikation, hostet på en Cisco BroadWorks XSP (eller ADP).

  • Webex-appen, som gør opkaldsindstillingerne i en Webview.

Brugeroplevelse

  • Windows-brugere: Klik profilbillede og derefter >, så >selvhjælp.

  • Mac-brugere: Klik profilbillede og derefter på Præferencer > for >selvhjælp

Implementer CSWV på BroadWorks

Installer opkaldsindstillinger Webview på XSPs

CSWV-applikationen skal være på den samme XSP(er), som er vært for Xsi-Actions-grænsefladen i dit miljø. Det er en ikke-administreret applikation på XSP, så du skal installere og installere en webarkivfil.

  1. Log ind på Xchange, og søg efter "BWCallSettingsWeb" i afsnittet software-download.

  2. Find og download den seneste version af filen.

    For eksempel BWCallSettingsWeb_1.8.2_1.war ( ) var den seneste ihttps://xchange.broadsoft.com/node/1057167skrivende periode.

  3. Installer, aktivér og implementer webarkivet i overensstemmelse med Xtended Service Platform-konfigurationsvejledningen til din XSP-version. (R23-versionen er https://xchange.broadsoft.com/node/1033484).

    1. Kopier .war-filen til en midlertidig placering på XSP, såsom /tmp/.

    2. Naviger til følgende CLI-kontekst, og kør installationskommandoen:

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

      BroadWorks-softwareadministratoren validerer og installerer filen.

    3. [Valgfri] Slette /tmp/BWCallSettingsWeb_1.7.5_1.war(denne fil er ikke længere nødvendig).

    4. Aktiver applikationen:

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

      Navnet og versionen er obligatorisk for enhver applikation, men for CSWV skal du også oplyse en contextPath, da det er en ikke-administreret applikation. Du kan bruge enhver værdi, der ikke bruges af et andet program, for eksempel,/callsettings.

    5. Installer applikationen Opkaldsindstillinger på den valgte kontekststi:

      XSP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

  4. Du kan nu forudsige URL-adressen til opkaldsindstillinger, som du vil angive for klienter, som følger:

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

    Noter:

    • Du skal levere efterstillet skråstreg på denne URL-adresse, når du indtaster den i klientkonfigurationsfilen.

    • XSP-FQDN skal passe med Xsi-handlings-FQDN, fordi CSWV skal bruge Xsi-handlinger, og CORS understøttes ikke.

  5. Gentag denne procedure for andre XSPs i dit Webex for BroadWorks-miljø (hvis nødvendigt)

Webview-applikationen Opkaldsindstillinger er nu aktiv på XSPs.

Yderligere konfiguration for XSP R21

Hvis du installerer CSWV-applikationen på en R21 XSP:

  1. Naviger til den opkaldsindstillinger applikation kontekst og kør få at læse dens konfiguration: XSP_CLI/Applications/BWCallSettingsWeb_1.7.5/General> get

    Du bør se følgende parametre og værdier:

    xsiActionsContextOrURL=/com.broadsoft.xsi-actions
    displayCriteriaOrScheduleName=criteria
    applicationMode=prod
    
  2. Brug set(hvis nødvendigt) for at ændre parametrene til værdierne vist ovenfor.

  3. Gentag for andre R21 XSP'er, hvis nødvendigt.

Konfigurer Webex-appen til at bruge opkaldsindstillinger Webview

Yderligere oplysninger om klientkonfiguration er at finde i Webex-appen til BroadWorks-klientkonfigurationsvejledningen til Xchange for din Webex-appversion. For eksempel er versionen af denne fil fra september 2020 på https://xchange.broadsoft.com/node/1054075

Der er et brugertilpasset tag i Webex-appens konfigurationsfil, som du kan bruge til at indstille CSWV URL-adressen. Denne URL-adresse viser opkaldsindstillingerne for brugerne via applikationens grænseflade.

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

I Webex-appens konfigurationsskabelon på BroadWorks skal du konfigurere CSWV-URL-adressen i tagget %WEB_CALL_SETTINGS_URL_WXT%.

Hvis du ikke eksplicit angiver URL-adressen, er standarden tom, og siden med opkaldsindstillinger er ikke synlig for brugerne.

  1. Sørg for, at du har de seneste konfigurationsskabeloner til Webex-appen (se Enhedsprofiler).

  2. Indstil målet for indstillinger for webopkald til csw:

    %WEB_CALL_SETTINGS_TARGET_WXT% csw

  3. Indstil URL-adressen til indstillinger for webopkald for dit miljø, for eksempel:

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

    (Du afledte denne værdi, da du installerede CSWV-applikationen)

  4. Den resulterende klientkonfigurationsfil skal have en post som følger:
    <web-call-settings target="csw">
        <url>https://yourxsp.example.com/callsettings/</url>
    </web-call-settings>

Konfigurer push-beskeder om opkald i Webex til BroadWorks

I dette dokument bruger vi termen Call Notifications Push Server (CNPS) til at beskrive en XSP-hostet eller ADP-hostet applikation, der kører i dit miljø. Din CNPS fungerer sammen med dit BroadWorks-system for at være opmærksom på indgående opkald til dine brugere og sender underretninger til brugere til Google Firebase Cloud Messaging (FCM) eller Apple Push Notification Service (APN'er) underretningstjenester.

Disse tjenester underretter Webex's mobile enheder for BroadWorks-abonnenter om, at de har indgående opkald på Webex.

For yderligere oplysninger om NPS, se beskrivelse af funktionen Meddelelse push-server på https://xchange.broadsoft.com/node/485737.

En lignende mekanisme i Webex fungerer med Webex meddelelses- og tilstedeværelsestjenester til push-underretninger til Google (FCM) eller Apple (APNS) meddelelsestjenester. Disse tjenester underretter til gengæld de mobile Webex-brugere om ændringer i indgående meddelelser eller tilstedeværelse.


Dette afsnit beskriver, hvordan man konfigurerer NPS for godkendelsesproxy, når NPS ikke allerede understøtter andre apps. Hvis du har brug at migrere en delt NPS for at bruge NPS proxy, se Opdatering af Cisco BroadWorks NPS til at bruge NPS Proxyhttps://help.webex.com/nl5rir2/.

OVERSIGT OVER NPS-proxy

For kompatibilitet med Webex til BroadWorks skal din CNPS programrettelse programrettelse for at understøtte funktionen NPS Proxy, Push-server til VoIP i UCaaS.

Funktionen implementerer et nyt design i Meddelelses-pushserveren for at løse sikkerhedsrisikoen ved deling af push-meddelelsescertifikat private nøgler med tjenesteudbydere til mobilklienter. I stedet for at dele push-meddelelsescertifikater og -nøgler med serviceudbyderen bruger NPS en ny API til at opnå et push-meddelelsestoken med kort varsel fra Webex til BroadWorks-backend og bruger denne token til godkendelse med Apple API'er og Google FCM-tjenester.

Funktionen forbedrer også muligheden for push-beskeder fra meddelelsesserveren til at sende meddelelser til Android-enheder via den nye Google Firebase Cloud Messaging (FCM) HTTPv1 API.

OVERVEJELSER I FORBINDELSE med APNS

Apple vil ikke længere understøtte den HTTP/1-baserede binære protokol på Apple Push-meddelelsestjenesten efter den 31. marts 2021. Vi anbefaler, at du konfigurerer din XSP til at bruge den HTTP/2-baserede grænseflade til API'er. Denne opdatering kræver, at din XSP er vært for NPS kører R22 eller senere.

Forbered dine NPS til Webex til BroadWorks

1

Installer og konfigurer en dedikeret XSP (mindste version R22) eller applikationsleveringsplatform (ADP).

2

Installer programrettelser til NPS-bekræftelsesproxy:

XSP R22-programrettelser:

XSP R23-programrettelser:

3

Aktivér meddelelse push-server-applikationen.

4

(Til Android-underretninger) Aktiver FCM v1 API på NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(For Apple iOS-underretninger) Aktiver HTTP/2 på NPS.

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true

6

Vedhæft en teknisksupport fra NPS XSP/ADP.

Hvad er næste trin?

For nye installationer af en NPS skal du gå til Konfigurer NPS for at bruge godkendelsesproxy

For at migrere en eksisterende Android-udrulning til FCMv1 skal du gå til Migrer NPS til FCMv1

Konfigurer NPS til at bruge godkendelsesproxy

Denne opgave gælder for en ny installation af NPS, der er dedikeret til Webex til BroadWorks.

Hvis du vil konfigurere bekræftelsesproxyen på en NPS, der deles med andre mobilapps, kan du se Opdatering af Cisco BroadWorks NPS til at bruge NPS Proxyhttps://help.webex.com/nl5rir2().

1

Opret en serviceanmodning med din kontaktperson for onboarding eller med TAC for at klargøre din OAuth-klientkonto (Webex Common Identity-konto). Titel din serviceanmodning NPS-konfiguration for auth proxy-opsætning.

Cisco giver dig et OAuth-klient-id, en klient hemmelighed og en opdateringstoken, der er gyldig i 60 dage. Hvis tokenet udløber, før du bruger det med dine NPS, kan du rindhæv en anden anmodning.
2

Opret klientkontoen på NPS:

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientId client-Id-From-Step1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1
XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

For at bekræfte de værdier, du indtastede, svarer til de værdier, du har fået, skal du køre XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

3

Indtast URL-adressen for NPS-proxy, og indstil token-opdateringsintervallet (30 minutter anbefales):

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

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

4

(Til Android-underretninger) Tilføj Android applikations-id til FCM-applikationer kontekst på NPS.

XSP_CLI/Applications/NotificationPushServer/FCM/Applications> add applicationId com.cisco.wx2.android

5

(For Apple iOS-underretninger) Føj applikations-id'et til APNS-applikationerne, og sørg for at udelade auth-tasten – sæt den til tom.

XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

6

Konfigurer følgende NPS-URL-adresser:

XSP CLI-kontekst

Parameter

Værdi

  • XSP_CLI/Applications/

    NotificationPushServer/FCM>

authURL

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

pushURL

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

scope

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

  • XSP_CLI/Applications/NotificationPushServer

    /APNS/Production>

url

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

7

Konfigurer følgende NPS-forbindelsesparametre til de anbefalede værdier vist:

XSP CLI-kontekst

Parameter

Værdi

  • XSP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

300

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Kontroller, om applikationsserveren er program-jeg-websteder, da du muligvis skal tilføje Webex-apps til listen over tilladte programmer:

  1. Kør AS_CLI/System/PushNotification> get og tjekke værdien af enforceAllowedApplicationList. Hvis det er true, du skal fuldføre denne underopgave. Ellers kan du springe resten af underopgaven over.

  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

Genstart XSP: bwrestart

10

Test opkaldsmeddelelser ved at foretage opkald fra en BroadWorks-abonnent til to Webex-mobilbrugere. Bekræft, at opkaldsmeddelelse vises på iOS- og Android-enheder.

Migrer NPS til FCMv1

Dette emne indeholder valgfrie procedurer, som du kan bruge i Google FCM-konsol, når du har en eksisterende NPS-udrulning, som du skal migrere til FCMv1. Der findes tre procedurer:

Migrer UCaaS-klienter til FCMv1

Brug nedenstående trin i Google FCM-konsol til at migrere UCaaS-klienter til Google FCM HTTPv1.


Hvis branding anvendes på klienten, skal klienten have afsender-id. Se Projektindstillinger i FCM-konsollen >Cloud-meddelelser. Indstillingen vises i tabellen Projektlegitimationsoplysninger.

Se Connect Branding Guide på for https://xchange.broadsoft.com/node/1053211detaljer. Segcm_defaultSenderId parameter, som findes i den Branding Kit, Ressource mappe, branding.xml fil med den nedenfor syntaks:

<string name="gcm_defaultSenderId">xxxxxxxxxxxxx</string>

  1. Log ind på FCM Admin SDK på http://console.firebase.google.com.

  2. Vælg den relevante Android-applikation.

  3. I fanen Generelt skal du optage projekt-id'et

  4. Naviger til fanen Tjenestekonti for at konfigurere en tjenestekonto. Du kan oprette en ny servicekonto eller konfigurere en eksisterende.

    Sådan opretter du en ny tjenestekonto:

    1. Klik på den blå knap for at oprette ny servicekonto

    2. Klik på den blå knap for at generere en ny privat nøgle

    3. Download-nøgle til en sikker placering

    Sådan genbruges en eksisterende tjenestekonto:

    1. Klik på den blå tekst for at se eksisterende tjenestekonti.

    2. Identificer den tjenestekonto, der skal bruges. Servicekonto skal have tilladelse firebaseadmin-sdk.

    3. Klik på hamburgermenuen yderst til højre, og opret en ny privat nøgle.

    4. Download-nøgle til en sikker placering.

  5. Kopier nøglen ind på XSP.

  6. Konfigurer projekt-id og :

    XSP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/key/file>
    ...Done
    
    XSP_CLI/Applications/NotificationPushServer/FCM/Projects> get
      Project ID  Accountkey
    ========================
      my_project    ********
  7. Konfigurer applikationen:

    XSP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id>
    ...Done
    
    XSP_CLI/Applications/NotificationPushServer/FCM/Applications> get
      Application ID    Project ID
    ==============================
              my_app    my_project
  8. Aktiver FCMv1:

    XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Kør bwrestart til at genstarte XSP'en.

Migrer SaaS-klienter til FCMv1

Brug nedenstående trin på Google FCM-konsol, hvis du vil migrere SaaS-klienter til FCMv1.


Sørg for, at du allerede har fuldført proceduren "Konfigurer NPS til at bruge godkendelsesproxy".
  1. Deaktiver FCM:

    XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Kør bwrestart til at genstarte XSP'en.

  3. Aktiver FCM:

    XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Kør bwrestart til at genstarte XSP'en.

Opdater ADP-server

Brug nedenstående trin i Google FCM-konsol, hvis du migrerer NPS for at bruge en ADP-server.

  1. Få JSON-filen fra Google Cloud Console:

    1. Gå til siden Tjenestekonti på Google Cloud-konsollen.

    2. Klik på Vælg etprojekt, vælg dit projekt, og klik på Åbn.

    3. Find rækken for den servicekonto, som du vil oprette en nøgle til, klik på den mere lodrette knap, og klik derefter på Opret nøgle.

    4. Vælg en nøgletype, og klik på Opret

      Filen downloades.

  2. Tilføj FCM til ADP-serveren:

    1. Importer JSON-filen til ADP-serveren ved hjælp af /bw/install Kommando.

    2. Log ind på ADP CLI, og tilføj projekt- og API-nøgle:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON:

    3. Tilføj derefter applikationen og nøglen:

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

    4. Bekræft 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

Konfigurer din partnerorganisation i Partner Hub

Konfigurer dine BroadWorks-klynger

[en gang pr. klynge]

Dette gøres af følgende årsager:

  • For at sætte Webex-skyen i stand til at godkende dine brugere mod BroadWorks (via XSP-hostet godkendelsestjeneste).

  • For at aktivere Webex apps til at bruge Xsi grænseflade for opkaldskontrol.

  • For at aktivere Webex til at lytte efter CTI-begivenheder, der er udgivet af BroadWorks (telefoni tilstedeværelse).


Klyngeguiden validerer automatisk grænsefladerne, når du tilføjer dem. Du kan fortsætte redigeringen af klyngen, hvis nogle af grænsefladerne ikke valideres, men du kan ikke gemme en klynge, hvis der er ugyldige poster.

Vi kan forhindre dette, fordi en forkert konfigureret klynge kan forårsage problemer, der er svære at løse.

Hvad skal du gøre?

  1. Log ind på Partner Hub (admin.webex.com) med dine partneradministratorlegitimationsoplysninger.

  2. Åbn siden Indstillinger i sidemenuen, og find Indstillinger for BroadWorks-opkald.

  3. Klik på Tilføj klynge.

    Dette starter en guide, hvor du leverer dine XSP-grænseflader (URL-adresser). Du kan tilføje en port til brugergrænsefladens URL-adresse, hvis du bruger en ikke-standard port.

  4. Navngive denne klynge, og klik på Næste.

    Klyngekonceptet her er blot en samling af grænseflader, der typisk er fælles på en XSP-server eller gruppe, der gør det muligt for Webex at læse oplysninger fra din applikationsserver (AS). Du kan have én XSP pr. AS-klynge eller flere XSPs pr. klynge eller flere AS-klynger pr. XSP. Skaler krav til dit BroadWorks-system er ikke omfattet her.

  5. (Valgfri) Indtast et BroadWorks-brugerkontonavn og -adgangskode, som du ved, findes i det BroadWorks-system, du opretter forbindelse til Webex, og klik derefter på Næste .

    Valideringstests kan bruge denne konto til at validere tilslutningerne til grænsefladerne i klyngen.

  6. Tilføj dine XSI-handlinger og XSI Events-URL-adresser.

  7. Klik på Næste.

  8. Tilføj URL-adressen til din CTI-grænseflade, og klik på Næste.

  9. Tilføj URL-adressen til din godkendelsestjeneste.

  10. Vælg Be godk. tjeneste med CI-tokenvalidering.

    Denne valgmulighed kræver ikke mTLS for at beskytte forbindelsen fra Webex, da godkendelsestjenesten korrekt validerer brugertokenet mod Webex-identitetstjeneste, før den giver brugeren den token, der skal anvendes længe.

  11. Gennemgå dine indtastninger på den endelige skærm, og klik derefter på Opret. Du bør se en succesmeddelelse.

    Partner Hub videregiver URL-adresserne til forskellige Webex-mikrotjenester, der tester forbindelserne til de leverede grænseflader.

  12. Klik på Vis klynger, og du vil se din nye klynge, og om valideringen lykkedes.

  13. Knappen Opret kan deaktiveres på guidens endelige (forvisning) skærm. Hvis du ikke kan gemme skabelonen, skyldes det et problem med en af de integrationer, du lige har konfigureret.

    Vi implementerede denne kontrol for at forhindre fejl i efterfølgende opgaver. Du kan gå tilbage gennem guiden, når du konfigurerer din installation, hvilket kan kræve ændringer af din infrastruktur (f.eks. XSP, indlæs balancer eller firewall) som dokumenteret i denne vejledning, før du kan gemme skabelonen.

Kontrollerer tilslutningerne til dine BroadWorks-grænseflader

  1. Log ind på Partner Hub (admin.webex.com) med dine partneradministratorlegitimationsoplysninger.

  2. Åbn siden Indstillinger i sidemenuen, og find Indstillinger for BroadWorks-opkald.

  3. Klik på Vis klynger.

  4. Partner Hub starter forbindelsestests fra de forskellige mikrotjenester mod grænsefladerne i klyngerne.

    Når tests er udført, viser klyngelistesiden statusmeddelelse ved siden af hver klynge.

    Du bør se grønne succesmeddelelser. Hvis du ser en rød fejlmeddelelse, skal du klikke på det påvirkede klyngenavn for at se, hvilken indstilling der forårsager problemet.

Konfigurer dine kundeskabeloner

Kundeskabeloner er den måde, hvorpå du vil anvende delt konfiguration til en eller flere kunder, når du onboarder dem via klargøringsmetoderne. Du skal knytte hver skabelon til en klynge (som du oprettede i forrige afsnit).

Du kan oprette så mange skabeloner, som du har brug for, men kun én skabelon kan tilknyttes en kunde.

  1. Log ind på Partner Hub (admin.webex.com) med dine partneradministratorlegitimationsoplysninger.

  2. Åbn siden Indstillinger i sidemenuen, og find Indstillinger for BroadWorks-opkald.

  3. Klik på Tilføj skabelon.

    Dette starter en guide, hvor du kan levere konfiguration til kunder, som bruger denne skabelon.

  4. Brug rullemenuen Klynge til at vælge den klynge, du vil bruge med denne skabelon.

  5. Indtast et skabelonnavn, og klik derefter på Næste .

  6. Konfigurer din klargøringstilstand ved hjælp af disse anbefalede indstillinger:

    Tabel 2. Anbefalede klargøringsindstillinger for forskellige klargøringstilstande

    Navn på indstilling

    Flowthr provisionering med betroede e-mails

    Flowthrvirke-klargøring uden e-mails

    Brugers selvbetjening

    Aktiver BroadWorks Flow via klargøring (inkluder legitimationsoplysninger til klargøringskontoen, hvis aktiveret)

    Tænd

    Forsyning af klargøringskontoens navn og adgangskode i henhold til BroadWorks-konfiguration.

    Tænd

    Forsyning af klargøringskontoens navn og adgangskode i henhold til BroadWorks-konfiguration.

    Sluk

    Opret automatisk nye organisationer i Control Hub

    Tjenesteudbyder-mailadresse

    Vælg en e-mailadresse i rullemenuen (du kan indtaste visse tegn for at finde adressen, hvis den er en lang liste).

    Denne e-mailadresse identificerer administratoren i din partnerorganisation, som vil få delegeret administratoradgang til alle nye kundeorganisationer, der er oprettet med kundeskabelonen.

    Land

    Vælg hvilket land, du bruger til denne skabelon.

    Det land, du vælger, matcher kundeorganisationer, der er oprettet med denne skabelon, med en bestemt region. På nuværende tidspunkt kan regionen være (EMEAR) eller (Nordamerika og resten af verden). Se lande-til-områdetilknytninger i dette regneark.

    BroadWorks virksomhedstilstand er aktiv

    Aktivér dette, hvis de kunder, du klargør med denne skabelon, er virksomheder i BroadWorks.

    Hvis de er grupper, skal du lade denne være slukket.

    Hvis du har en blanding af virksomheder og grupper i dine BroadWorks, bør du oprette forskellige skabeloner for disse forskellige sager.

    • Bemærkninger fra tabellen:

    • † Denne switch sikrer, at en ny kundeorganisation oprettes, hvis abonnentens e-maildomæne ikke passer til en eksisterende Webex-organisation.

      Dette bør altid være tændt, medmindre du bruger en manuel ordre- og proces til understering (via Cisco Commerce Workspace) til at oprette kundeorganisationer i Webex (før du starter klargøring af brugere i disse organisationer). Denne valgmulighed kaldes ofte for "Hybrid-klargøring"-modellen og er uden for rækkevidden af dette dokument.

  7. Vælg standardtjenestepakken til kunder, der bruger denne skabelon (se pakker i afsnittet Oversigt); enten Grundlæggende, Standard, Premium ellerSoftphone.

    Du kan tilsidesætte denne indstilling for individuelle brugere via Partner Hub.

  8. Vælg standardbekræftelsestilstand (enten BroadWorks-godkendelse ellerWebex-godkendelse) for kunder, der bruger denne skabelon.

    (Se Bekræftelsestilstand i afsnittet Forbered dit miljø).

  9. Konfigurer den måde, brugere bekræfter deres identies på Webex på. Indstillingerne på denne side svarer til din valgte bruger provisioneringstilstand som vist i tabellen:

    Tabel 3. Anbefalede brugerbekræftelsesindstillinger for forskellige klargøringstilstande

    Navn på indstilling

    Flowthr provisionering med betroede e-mails

    Flowthrvirke-klargøring uden e-mails

    Brugers selvbetjening

    Brugerbekræftelse

    Hav tillid til BroadWorks-e-mails

    Ikke-betroede e-mails

    Ikke-betroede e-mails

    Den første bruger, der klargøres, er administrator

    Anbefalet*

    Anbefalet*

    Ikke anvendelig

    Giv brugere tilladelse til at aktivere sig selv

    Ikke anvendelig

    Ikke anvendelig

    Krævet

    • Bemærkninger fra tabellen:

    • * Den første bruger, som du tildeler integreret IM&P i BroadWorks, får kundeadministratorrollen, hvis der oprettes en ny kundeorganisation i Webex. Vælg denne indstilling for at give dig lidt kontrol over, hvem der tager rollen. Hvis du fjerner markeringen af denne indstilling, bliver den første bruger, der bliver aktiv i den nye organisation, kundeadministrator.

      Du kan ændre kundebrugerrollerne i Partner Hub efter provisionering, hvis det er nødvendigt.

  10. Vælg, om du ønsker at udfylde bruger-e-mailadresser på loginsiden påforhånd.

    Du bør kun bruge denne valgmulighed, hvis du har valgt BroadWorks-godkendelse og også har sat brugernes e-mailadresser i attributten Alternativt ID i BroadWorks. Ellers skal de bruge deres BroadWorks-brugernavn. Login-siden giver mulighed for at ændre bruger, hvis det er nødvendigt, men dette kan føre til loginproblemer.

  11. Vælg, om du vil aktivere mappesynkronisering.

    Denne valgmulighed gør Webex i stand til at læse BroadWorks-kontakter i kundeorganisationen, så brugerne kan finde og ringe til dem fra Webex-appen.

  12. Indtast en Partner Admin.

    Dette navn bruges i den automatiserede e-mailmeddelelse Webex, der inviterer brugere til at validere deres e-mailadresser.

  13. Sørg for, at til/fra-knappen for eksisterende organisationer er On (standardindstillingen er On).

  14. Gennemgå dine indtastninger på den endelige skærm. Du kan klikke på navigationskontrollerne øverst i guiden for at gå tilbage og ændre alle detaljer. Klik på Opret.

    Du bør se en succesmeddelelse.

  15. Klik på Vis skabeloner, og du vil se din nye skabelon angivet med alle andre skabeloner.

  16. Klik på skabelonnavnet for at modificere eller slette skabelonen, hvis det er nødvendigt.

    Du behøver ikke at indtaste klargøringskontoen igen. De tomme felter til bekræftelse af adgangskode er der for at ændre legitimationsoplysningerne, hvis du har brug for det, men efterlad dem tomme for at beholde de værdier, du gav guiden.

  17. Tilføj flere skabeloner, hvis du har forskellige delte konfigurationer, som du vil give kunderne.


    Hold siden Vis skabeloner åben, da du muligvis har brug for skabelondetaljer for en følgende opgave.

Tilføjelse af Webex til BroadWorks til en eksisterende organisation

Hvis du er en partneradministrator, der tilføjer Webex for BroadWorks-tjenester til en kundeorganisation, der findes i Control Hub, men som endnu ikke er knyttet til en organisation i CI, skal kundens organisationsadministrator godkende administratoradgang, for at anmodningen kan blive gennemført.

Organisationsadministratorgodkendelse er nødvendig, hvis et af følgende er sandt:

  • Der er ingen administreret-by-forhold mellem Tjenesteudbyder og kundeorganisationen og e-mailadressen for en af organisationens brugere matcher e-mailadressen på en CI-bruger i en organisation med mindst 100 brugere

  • Organisationen har et bekræftet e-maildomæne

  • Der er gjort krav på organisationsdomænet

Partneradministratorer kan gennemføre følgende procedure for at føje BroadWorks-opkaldstjenester til en eksisterende Webex-organisation:


I Partner Hub skal skift af eksisterende organisationers klargøring være aktiveret inden for organisationens indstillinger for kundeskabelon (til/fra er aktiveret som standard).
  1. Partneradministratoren klar gør Webex til BroadWorks for kunden. Følgende sker:

    • Vedhæftning af org mislykkedes med en 2017 fejl (Kan ikke klargøre abonnenten til en eksisterende Webex-organisation).

    • Der genereres en e-mailmeddelelse, som sendes til kundens organisationsadministratorer (op til fem administratorer). E-mailmeddelelsen fremhæver partneradministrators e-mail (som konfigureret i kundeskabelonen i Partner Hub) og beder organisationsadministratoren om at godkende partneradministratoren som en ekstern administrator. Administratoren af kundens organisation skal godkende anmodningen og give partneradministratoren fuld administratoradgang til kundeorganisationen.

  2. Med fuld administratoradgang kan partneradministratoren fuldføre klargøring af opkaldstjenester.

Tilføj ekstern administrator

For de trin, som kunders organisationsadministratorer kan følge for at tilføje partneradministratoren som en ekstern administrator, se artiklen Godkend ekstern administratoranmodning help.webex.com .


Den e-mailadresse, som organisationsadministratoren tilføjer som en ekstern administrator, skal svare til partneradministratorens e-mailadresse, som konfigureret i kundeskabelonen i Partner Hub.

Konfigurer applikationsserver med URL-adresse til klargøringstjeneste


Denne opgave er kun nødvendig for flow gennem klargøring.

Programrettelsesapplikationsserver

  1. Anvend programrettelses ap373197 (se BroadWorks softwarekrav i afsnittet Reference).

  2. Skift til Maintenance/ContainerOptions Forbindelse.

  3. Aktiver parameteren for klargørings URL-adressen:

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

Få klargørings-URL(er) fra Partner Hub

Se administrationsvejledningen til Cisco BroadWorks-applikationsserverens kommandolinjegrænseflade for yderligere oplysninger (Interface > Messaging og Service > Integrated IM&P) om AS-kommandoerne.

  1. Log ind på Partner Hub, og gå til Indstillinger > BroadWorks-opkald.

  2. Klik på Se skabeloner.

  3. Vælg skabelonen, du bruger, for at klargøre denne virksomheds/gruppes abonnenter i Webex.

    Skabelondetaljer vises i et pop op-vindue til højre. Hvis du endnu ikke har oprettet en skabelon, skal du gøre det, før du kan få klargørings-URL-adressen.

  4. Kopier URL-adressen på klargøringsadapter.

Gentag dette for andre skabeloner, hvis du har mere end én.

(Valgmulighed) Konfigurer klargøringsparametre for hele systemet på applikationsserveren


Du vil muligvis ikke indstille et provisionerings- og tjenestedomæne i hele systemet, hvis du bruger UC-One SaaS. Se Beslutningspunkter i afsnittet Forbered dit miljø.

  1. Log ind på applikationsserveren, og konfigurer meddelelsesgrænsefladen.

    1. AS_CLI/Interface/Messaging> set provisioningUrl EnterValueFromPartnerHubTemplate

    2. AS_CLI/Interface/Messaging> set provisioningUserId EnterValueFromPartnerHubTemplate

    3. AS_CLI/Interface/Messaging> set provisioningPassword EnterValueFromPartnerHubTemplate

    4. AS_CLI/Interface/Messaging> set enableSynchronization true

  2. Aktiver den integrerede IMP-grænseflade:

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

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


Du skal indtaste det fuldt kvalificerede navn til provisioningURL parameter, som den blev givet i Control Hub. Hvis din applikationsserver ikke kan tilgå DNS for at løse værtsnavnet, skal du oprette tilknytningen i /etc/hosts fil på as.

(Valgmulighed) Konfigurer parametre for klargøring pr. virksomhed på applikationsserver

  1. I BroadWorks-brugergrænseflade skal du åbne den virksomhed, du vil konfigurere, og gå til Tjenester > integreret IM&P.

  2. Vælg Brug tjenestedomæne, og indtast en dummy-værdi (Webex ignorerer denne parameter. Du kan brugeexample.com).

  3. Vælg Brug Meddelelsesserver.

  4. I feltet URL-adresse skal du indsætte den klargørings-URL-adresse, du kopierede fra din skabelon i Partner Hub.


    Du skal indtaste det fuldt kvalificerede navn til provisioningURL parameter, som den blev givet i Partner Hub. Hvis din applikationsserver ikke kan tilgå DNS for at løse værtsnavnet, skal du oprette tilknytningen i /etc/hosts fil på as.

  5. I feltet Brugernavn skal du indtaste et navn på klargøringsadministratoren. Dette skal passe med værdien på skabelonen i Partner Hub.

  6. Indtast en adgangskode for klargøringsadministratoren. Dette skal passe med værdien på skabelonen i Partner Hub.

  7. For Standardbrugeridentitet for IM&P-ID, vælg Primær .

  8. Klik på Anvend.

  9. Gentag for andre virksomheder, du ønsker at konfigurere for flow gennem klargøring.

Adressebogssynkronisering

Adressebogssynkronisering sikrer, at Webex for BroadWorks-brugere kan bruge Webex-adresselisten til at ringe til en enhed, der ringer op, fra BroadWorks-serveren. Når denne funktion er aktiveret, bliver den fulde opkaldsmappe fra BroadWorks-serveren synkroniseret til Webex-adresselisten. Brugere kan tilgå adresselisten fra Webex-appen og ringe op til en enhed, der ringer op, fra BroadWorks-serveren.


Webex til BroadWorks-klargøring omfatter en standardsynkronisering af meddelelsesbrugere og deres tilknyttede opkaldsoplysninger fra BroadWorks-serveren til Webex-mappen. Standardsynkroniseringssynkronisering omfatter dog ikke ikke-meddelelsesbrugere eller ikke-brugerenheder (for eksempel en Konferencerum telefon, faxmaskine eller viderestillingsgruppe nummer). Adressebogssynkronisering sikrer, at alle opkaldsenheder på BroadWorks-serveren tilføjes til Webex-adresselisten.

Betingelser for adressebogssynkronisering

  • Partneradministratorer skal konfigurere funktionen på kundeorganisationsniveau. Partneradministratorer kan aktivere eller deaktivere funktionen for flere kundeorganisationer i en enkelt handling.

  • Som standard sker den indledende synkronisering en uge efter aktivering af synkroniseringen (tidspunktet, der vælges til at starte synkroniseringen, er tilfældig). Dog kan kundeorganisationer bruge valgmuligheden Synkroniser nu til at omgå ventetiden pr. uge og fuldføre en øjeblikkelig synkronisering for en bestemt kundeorganisation.

  • Som standard kører adressebogssynkronisering ugentligt for hver kunde. Hver synkronisering finder sted én uge efter den sidste synkronisering, uanset om denne synkronisering blev planlagt eller udløst manuelt med Synkroniser nu.

  • Hvis der opstår en synkroniseringsfejl, ændres synkroniseringen automatisk hver 24. time indtil den næste planlagte synkronisering.

  • Synkroniseringen ignorerer brugere, som ikke har et telefonnummer.

  • I Partner Hub kan du se oplysninger om synkroniseringsstatus for en bestemt kunde. Derudover kan du eksportere detaljerede oplysninger om den sidste synkronisering til en CSV-post. CSV-posten er mere detaljeret end visningen i Control Hub og kan hjælpe med fejlfinding, analyser og auditering.

  • Hver Webex-app har en lokal cache, som kan tage op til 72 timer at rydde, før opdateringerne efter synkronisering vises i Webex-appen. Denne forsinkelse holder, hvad enten du aktiverer eller deaktiverer funktionen.

Før du begynder

Vi anbefaler, at du bruger følgende indstillinger:


Nedenstående eksempler antager, at du bruger en XSP-server. For ADP-servere skal du udskifte (XSP_CLI) med (ADP_CLI).
  • Hastighedsbegrænsningsværdier– Indstil følgende OverloadControl-systemegenskaber (XSP_CLI/Applikationer/Xsi-Actions/OverloadControl):

    • userDirectoryTransactionLimit– Indstil til en nulværdi.

    • globalDirectoryTransactionLimit– Indstil til en nulværdi.


    Det anbefales, at du indstiller userDirectoryTransactionLimit og globalDirectoryTransactionLimit til en nulværdi. Men hvis du beslutter at tildele værdier, skal hver indstilles til mindst fem gange værdien af transaktionenLimitPeriodSeconds (som bør være 1).
  • Transaktionsgrænser – Indstil følgende værdier (XSP_CLI/System/CommunicationUtilitet/Standardindstillinger):

    • userTransactionLimit– Indstil til mindst 100.

    • transactionLimitPeriodSecs– Indstil til 1.

  • Paging-værdier – Indstil paging-systemegenskaber (XSP_CLI/Applikationer/Xsi-handlinger/Paging):

    • defaultPageSize– Indstil til 50

    • availableUserMaxLimit – Indstil til 100

  • CTI-grænseflade – Sørg for at overføre webex CA-certifikater til CTI-grænsefladetillidslageret og for at aktivere klientgodkendelse på CTI-grænsefladen.

Afhængigt af din BroadWorks-udgivelse anbefaler vi desuden, at du anvender følgende systemrettelser på BroadWorks-udrulningen, før du aktiverer denne funktion (se BroadWorks-softwarekrav i afsnittet Reference):

  • For R21: AP.as.21.sp1.551.ap368517

  • For R22: AP.as.22.0.1123.ap368517

  • For R23: AP.as.23.0.1075.ap368517

  • For R24: ingen programrettelse er påkrævet

Aktivér mappesynkronisering

Fuldfør følgende trin for at aktivere Adressebogssynkronisering for de kundeorganisationer, du administrerer:

  1. Log ind på Partner Hub (http://admin.webex.com), og vælg Indstillinger.

  2. Rul ned til BroadWorks-opkald, og klik på Vis skabeloner .

  3. Vælg den relevante kundeskabelon, og rul til BroadWorks-adressebogssynkronisering.

  4. For at aktivere adressebogssynkronisering som standard for nye kundeorganiseringer, der bruger denne skabelon:

    1. Indstil Aktivér telefonbogssynkronisering for alle nye kundeorganisationer til Til.

    2. Klik på Gem.

  5. Sådan aktiveres adressebogssynkronisering for eksisterende kundeorganisationer, der bruger denne skabelon:

    1. Klik på Vis liste over kunders synkroniseringsstatus.

    2. Marker de nærliggende afkrydsningsfelter for hver organisation, som du vil aktivere funktionen for.

    3. Klik på Aktiver synkronisering.


      Hvis du ønsker at deaktivere adressebogssynkronisering, skal du følge ovenstående procedure og:

      • I trin 4a skal du indstille Aktiver telefonbogssynkronisering for alle nye kundeorganisationer og skifte til Fra for at deaktivere adressebogssynkronisering som standard for nye kundeorganisationer, der bruger denne skabelon.

      • I trin 5c skal du klikke Deaktiver synkronisering for at deaktivere funktionen for eksisterende organisationer.

Fuldfør øjeblikkelig synkronisering

Valgmuligheden Synkroniser nu giver dig mulighed for at udføre en on-demand synkronisering for en bestemt kundeorganisation. Denne valgmulighed kan kun vælges for individuelle kundeorganisationer – der er ingen valgmulighed for massesynkronisering nu.

  1. Log ind på Partner Hub (http://admin.webex.com), og vælg Indstillinger.

  2. Rul ned til BroadWorks-opkald, og klik på Vis skabeloner .

  3. Vælg den relevante kundeskabelon, og rul til BroadWorks-adressebogssynkronisering.

  4. Klik på Vis liste over kunders synkroniseringsstatus.

  5. For den kundeorganisation, du vil synkronisere, skal du klikke på de tre prik helt til højre og vælge Synkroniser nu.

  6. Klik på Genind opdater for at se synkroniseringsresultaterne.

Eksporter synkroniseringsposter til CSV

Partneradministratorer kan eksportere detaljerede oplysninger om den seneste synkronisering til en CSV-fil. CSV indeholder en mere detaljeret visning af synkroniseringsposten end Control Hub GUI og kan hjælpe med fejlfinding og analyser.

  1. Log ind på Partner Hub (http://admin.webex.com), og vælg Indstillinger.

  2. Rul ned til BroadWorks-opkald, og klik på Vis skabeloner .

  3. Vælg den relevante kundeskabelon, og rul til BroadWorks-adressebogssynkronisering.

  4. Klik på Vis liste over kunders synkroniseringsstatus.

  5. Marker de nærliggende afkrydsningsfelter for hver organisation, som du vil inkludere i eksporten.

  6. Klik på Eksportresultater.

Offentlige API'er til adressebogssynkronisering

Offentlige API'er er tilgængelige på denne måde, så partneradministratorer kan opdatere indstillinger for adressebogssynkronisering for de kundeorganisationer, de administrerer, udløse øjeblikkelig synkronisering eller opnå http://developer.webex.com synkroniseringsstatusoplysninger. Adressebogssynkroniseringsmetoder grupperes under BroadWorks-virksomheder med adressebogssynkronisering. Der findes fire API'er:

  • Anfør BroadWorks-virksomheder – Brug denne API-metode til at få en liste over virksomhederunder Tjenesteudbyder virksomhedsoversigt og hver virksomhedsid. Du skal indtaste spEnterpriseId som tildelt i klargøring.

  • Opdater adressebogssynkronisering for enBroadWorks-virksomhed – indtast virksomhedenid for at opdatere adressebogs-syc-status for den pågældende virksomhed, aktivere eller deaktivere adressebogssynkronisering.

  • Udløs adressebogssynkroniseringfor en virksomhed - Brug denne API-metode, hvis du vil udløse en øjeblikkelig synkronisering for en bestemt virksomhedid. For den syncStatus, indtast SYNC_NOW Kommando.

  • Få adressebogssynkroniseringsstatusfor en virksomhed – indtast virksomhedensid og køre for at få en status og trackingId seneste synkronisering. Du kan bruge trackingID at køre yderligere analyser via værktøjer såsom Kibana og Grafana.

For detaljeret API-dokumentation, se https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Du skal logge ind for at læse API-specifikationen på https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Optagelse af opkald

Webex til BroadWorks understøtter fire tilstande for opkaldsoptagelse.

Tabel 4. Optagelsestilstande

Optagelsestilstande

Beskrivelse

Kontrolknapper/indikatorer, der vises på Webex-appen

Altid

Optagelsen startes automatisk, når opkaldet er oprettet. Brugeren er ikke i stand til at starte eller stoppe optagelse.

  • Visuel indikator for, at optagelse er i gang

Altid med pause/genoptag

Optagelsen startes automatisk, når opkaldet er oprettet. Bruger kan pause og genoptage optagelse.

  • Visuel indikator for, at optagelse er i gang

  • Knappen Afbryd optagelse midlertidigt

  • Knappen Genoptag optagelse

Ondemand

Optagelse startes automatisk, når opkaldet er oprettet, men optagelsen slettes, medmindre brugeren trykker på Start optagelse.

Hvis brugeren starter optagelse, bevares den fulde optagelse fra opkaldsopsætningen. Efter start af optagelsen kan brugeren også sætte optagelsen på pause og genoptage den

  • Knappen Start optagelse

  • Knappen Afbryd optagelse midlertidigt

  • Knappen Genoptag optagelse

OnDemand med bruger påbegyndt start

Optagelsen starter ikke, medmindre brugeren vælger valgmuligheden Start optagelse i Webex-appen. Brugeren har mulighed for at starte og stoppe optagelse flere gange under et opkald.

  • Knappen Start optagelse

  • Knappen Stop optagelse

  • Knappen Afbryd optagelse midlertidigt

Krav

For at installere denne funktion på Webex til BroadWorks skal du installere følgende BroadWorks-programrettelser:

  • AP.as.22.0.1123.ap377718

  • AP.as.23.0.1075.ap377718

  • AP.as.24.0.944.ap377718

AS'en skal konfigureres til at sende X-BroadWorks-Correlation-Info SIP-header:

  • AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true

  • AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true

Følgende konfigurationstag skal være aktiveret for at bruge denne funktion: %ENABLE_CALL_RECORDING_WXT%.

Denne funktion kræver en integration med en tredjepartsplatform for opkaldsoptagelser.

For at konfigurere optagelse af opkald på BroadWorks skal du gå til Cisco BroadWorks-opkaldsoptagelsesgrænsefladevejledningenhttps://xchange.broadsoft.com/node/1033722.

Yderligere oplysninger

For brugeroplysninger oplysninger om, hvordan du bruger funktionen Optagelse, skal du gå til help.webex.com artikelWebex | Optag dine opkald.

For at afspille en optagelse igen skal brugere eller administratorer gå til deres tredjeparts-opkaldsoptagelsesplatform.

Gruppe parkering af opkald og hent

Webex til BroadWorks understøtter gruppe-parkering af opkald og hent. Denne funktion giver brugere inden for en gruppe mulighed for at parkere opkald, som derefter kan hentes af andre brugere i gruppen. For eksempel kan detailmedarbejdere i en butiksindstilling bruge funktionen til at parkere et opkald, der derefter kan blive opfanget af en person i en anden afdeling.

For at installere funktionen skal en administrator oprette en opkaldsparkergruppe og tilføje brugere til gruppen. Når funktionen er konfigureret:

  • Under et opkald klikker en bruger på parkeringsindstillingen på deres Webex-app for at parkere opkaldet i et lokalnummer, som systemet vælger automatisk. Systemet viser forlængelsen til brugeren i en periode på 10 sekunder.

  • En anden bruger i gruppen klikker på valgmuligheden Hent opkald på deres Webex-app. Brugeren indtaster derefter lokalnummer for det parkerede opkald for at fortsætte opkaldet.

For administrationsdetaljer om, hvordan du konfigurerer denne funktion på BroadWorks, se afsnittet parkering af opkald i BroadWorks Application Server Group Web Interface Administrationsvejledning - Del 2https://xchange.broadsoft.com/node/1051947.

Yderligere oplysninger

Du brugeroplysninger, hvordan du bruger Group parkering af opkald, i Webex | Park og Hent opkald.

parkering af opkald/dirigeret parkering af opkald

Almindelig eller direkte parkering af opkald understøttes ikke i Webex-appens brugergrænseflade, men klargjorte brugere kan installere funktionen ved hjælp af funktionsadgangskoder:

  • Indtast *68 for at parkere et opkald

  • Indtast *88 for at hente et opkald

Brugertilpasse og klargøre klienter

Brugere downloader og installerer deres generiske Webex-apps til desktop eller mobil (se Webex-appplatforme i afsnittet Forbered dit miljø). Når brugeren godkender, tilmelder klienten sig via Webex Cloud til meddelelser og møder, henter sine branding-oplysninger, finder sine BroadWorks-tjenesteoplysninger og downloader sin opkaldskonfiguration fra BroadWorks-applikationsserveren (via DMS på XSP).

Du kan konfigurere opkaldsparametrene for Webex-apps i BroadWorks (som normalt). Du kan konfigurere branding, meddelelser og mødeparametre for klienterne i Control Hub. Du ændrer ikke direkte en konfigurationsfil.

Disse to sæt konfigurationer kan overlappe, hvilket betyder, at Webex-konfigurationen afløser BroadWorks-konfigurationen.

Tilføj konfigurationsskabeloner for Webex-apps til BroadWorks-applikationsserveren

Webex-apps er konfigureret med DTAF-filer. Klienterne downloader en konfigurations XML-fil fra applikationsserveren via Enhedsadministrationsservice på XSP.

  1. Få de nødvendige DTAF-filer (se Enhedsprofiler i afsnittet Forbered dit miljø).

  2. Kontroller, at du har de rigtige tagsæt i BroadWorks System > Resources > Device Management Tag Sæt.

  3. Du klargør for hver klient:

    1. Download og udtræk DTAF zip-filen for den pågældende klient.

    2. Importer DTAF-filer til BroadWorks på System > ressourcer > identitet/enhedsprofiltyper

    3. Åbn den nyligt tilføjede enhedsprofil for redigering og:

      • Indtast XSP FQDN- og Enhedsadgangsprotokollen.

      • Marker afkrydsningsfeltet Support oplysninger om ekstern part. Denne support er nødvendig, for desktop-deling kan fungere.


        Du kan også aktivere support fra eksterne part ved at køre følgende CLI-kommando på applikationsserveren: AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
    4. Modificer skabelonerne i henhold til dit miljø (se tabellen nedenfor).

    5. Gem profilen.

  4. Klik på Filer og godkendelse, og vælg derefter valgmuligheden for at gøre alle systemfiler lige så vigtige.

Navn

Beskrivelse

Codec-prioritet

Konfigurer prioritetsrækkefølge for lyd- og video-codecs til VoIP opkald

TCP, UDP og TLS

Konfigurer protokollerne, der bruges til SIP-signalering og medier

RTP-lyd- og videoporte

Konfigurer portintervaller for RTP-lyd og video

SIP-valgmuligheder

Konfigurer forskellige valgmuligheder i forbindelse med SIP (SIP INFO, brug rport, SIP proxy-registrering, opdateringsintervaller for tilmelding og abonnement osv.)

Brugertilpasse klienter i Control Hub

Der er separate branding-konfigurationer for desktop- og mobilklienter, så du skal gentage denne branding-proces, hvis du bruger begge:

  1. Log ind på Control Hub, og gå til Konfiguration > Klienter.

  2. Find brandingområdet for siden klientkonfiguration.

  3. Opdater logo og primær navigationsbjælke farve. Få yderligere oplysninger i Tilføj din virksomheds branding til Webex.


Brugeraktiveringsportalen bruger det samme logo, som du tilføjer for Klientbranding.

Brugertilpasse URL-adresser til problemrapportering og hjælp

Se https://help.webex.com/n0cswhcb "Brugertilpasse branding og problemrapportering for kunder".

Konfigurer din testorganisation for Webex til BroadWorks

Før du begynder

Med flowthrvirke-klargøring

Du skal konfigurere alle XSP-tjenester og partnerorganisationen i Control Hub, før du kan udføre denne opgave.

1

Tildel tjeneste i BroadWorks:

  1. Opret en test virksomhed under din tjenesteudbyders virksomhed i BroadWorks, eller opret en testgruppe under din Tjenesteudbyder (afhænger af din BroadWorks-opsætning).

  2. Konfigurer IM&P-tjenesten for den pågældende virksomhed, for at pege på den skabelon, du tester (hent klargøringsadapterENS URL-adresse og legitimationsoplysninger fra Control Hub-kundeskabelonen).

  3. Opret testabonner i den pågældende virksomhed/gruppe.

  4. Giv brugerne unikke e-mailadresser i e-mailfeltet i BroadWorks. Kopier dem også ind i attributten Alternativt ID.

  5. Tildel den integrerede IM&P-tjeneste til disse abonnenter.


     

    Dette udløser oprettelsen af kundeorganisationen og de første brugere, hvilket tager flere minutter. Vent venligst lidt, mens du forsøger at logge ind med dine nye brugere.

2

Bekræft kundeorganisation og brugere i Control Hub:

  1. Log ind på Control Hub med din partneradministratorkonto.

  2. Gå til Kunder, og bekræft, at din nye kundeorganisation er på listen (navnet følger gruppenavnet eller virksomhedsnavnet fra BroadWorks).

  3. Åbn kundeorganisationen, og bekræft, at abonnenterne er brugere i den pågældende organisation.

  4. Verifidér, at den første abonnent, som du tildelte den integrerede IM&P-tjeneste, er blevet kundeadministrator for den pågældende organisation.

Brugertest

1

Download Webex-appen på to forskellige maskiner.

2

Log ind som dine testbrugere på de to maskiner.

3

Foretag testopkald.