In dit artikel
dropdown icon
Overzicht van Webex voor Cisco BroadWorks
    Maak kennis met Webex voor Cisco BroadWorks
    Hoe het werkt
    Functies en beperkingen
    dropdown icon
    Beperkingen
      Berichtlimieten
    Beveiliging, gegevens en rollen
    Architectuur
    dropdown icon
    Bestellen en inrichten
      Vereiste patches met flow-through inrichting
    Migratie en toekomstbestendigheid
    Aanbevolen documentabonnementen
    Aanvullende documenten
dropdown icon
Uw omgeving voorbereiden
    dropdown icon
    Beslissingspunten
      Architectuur en infrastructuur
      Inrichting voor klanten en gebruikers
      Ondersteunde landinstellingen voor talen
      Merkdetails
      Onboardingssjablonen
      Meerdere partnerregelingen
      Inrichtingsadapter en sjablonen
    dropdown icon
    Minimumvereisten
      Accounts
      Servers in uw netwerk- en softwarevereisten
      Platformen van de Webex-app
      Fysieke telefoons en accessoires
      Apparaatprofielen
      OAuth-aanmeldgegevens voor uw Webex voor Cisco BroadWorks verkrijgen
    dropdown icon
    Bestelcertificaten
      Certificaatvereisten voor TLS-verificatie
      Aanvullende certificaatvereisten voor gemeenschappelijke TLS-verificatie via CTI-interface
    dropdown icon
    Uw netwerk voorbereiden
      Netwerkvereisten voor Webex-services
      Ondersteuning voor redundantie van BroadWorks
dropdown icon
Webex voor BroadWorks implementeren
    Overzicht implementatie
    Partnerintegratie voor Webex voor Cisco BroadWorks
    dropdown icon
    Services configureren op uw Webex voor Cisco BroadWorks XSP|ADPs
      XSI-interfaces
      Verificatieservice configureren (met CI-tokenvalidatie)
      TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)
      Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver
    CTI-interface en gerelateerde configuratie
    Gespreksinstellingen Webview
    CSWV implementeren op BroadWorks
    Configureer de Webex-app om de Gespreksinstellingen Webview te gebruiken
    dropdown icon
    Pushmeldingen voor gesprekken configureren in Webex voor BroadWorks
      APNS-overwegingen
      Uw NPS voorbereiden op Webex voor Cisco BroadWorks
      NPS configureren voor het gebruik van de verificatieproxy
      NPS migreren naar FCMv1
    Uw partnerorganisatie configureren in Partner Hub
    Toepassingsserver configureren met URL inrichtingsservice
    API voor de inrichtingscontrole
    Partner-SSO configureren met OpenID Connect (OIDC) (aanbevolen)
    dropdown icon
    Partner-SSO met SAML configureren
      BroadWorks IdP activeren in Control Hub
    Gesprekscorrelatie-id inschakelen
    Synchroniseren met Directory
    dropdown icon
    Uniforme gespreksgeschiedenis
      Visuele spamindicatie
    dropdown icon
    Statussynchronisatie van persoonlijke assistent
      Voorwaarden
      Statussynchronisatie van persoonlijke assistent inschakelen (nieuw cluster)
      Statussynchronisatie van persoonlijke assistent inschakelen (bestaand cluster)
      Statussynchronisatie van persoonlijke assistent uitschakelen
    Nummerweergave en gespreksomleiding
    dropdown icon
    Beller-id selecteren
      Aanvullende functies
      Voorwaarden
      BroadWorks-patches
      Configuratie van Webex-app
    Weergave van gedeelde lijn
    dropdown icon
    Niet storen (DND) synchroniseren
      Voorwaarden
      Stille uren
    Gespreksopname
    dropdown icon
    Voicemail voor Microsoft Teams-integratie inschakelen
      Vereisten
    Groepsgesprek parkeren en ophalen
    Inbreken
    dropdown icon
    SIP-gesprek doorverbinden naar Webex Meeting
      URI kiezen configureren
      Optimale werkwijzen, beperkingen en probleemoplossing
    E911 Noodoproepen
    dropdown icon
    Clients aanpassen en inrichten
      Configuratiesjablonen voor de Webex-app toevoegen aan de BroadWorks-toepassingsserver
    Uw testorganisatie configureren voor Webex voor Cisco BroadWorks
    Testen van gebruikers
dropdown icon
Webex voor BroadWorks beheren
    Klantorganisaties inrichten
    Gebruikers inrichten
    dropdown icon
    Webex-gebruikers verplaatsen naar Webex voor Cisco BroadWorks
      Gebruiker verplaatsen (met toestemming) naar Webex voor Cisco BroadWorks
      Webex voor BroadWorks koppelen aan een bestaande organisatie
      Webex for BroadWorks loskoppelen van een bestaande organisatie
    dropdown icon
    Gebruikers en organisaties beheren
      Gebruikersinrichting verifiëren met niet-vertrouwde e-mails
      Gebruikers-id of e-mailadres wijzigen
      Gebruikerspakket wijzigen in Partner Hub
      Gebruikers verwijderen
      Organisatie verwijderen
    Een abonnement via Control Hub annuleren
    Releasebeheer
    dropdown icon
    Het systeem opnieuw configureren
      Een BroadWorks-cluster bewerken of verwijderen in Partnerhub
      Een onboardingssjabloon bewerken of verwijderen in Partner Hub
    Webex-assistent
    Webex-gesprekken uitschakelen
    Video of scherm delen binnen gesprekken uitschakelen
    Melding Busy Lamp Field/gesprek opnemen
    Ondersteuning voor Slido-integratie
    Automatisch beantwoorden met toon
    Capaciteit verhogen
    HTTP-servercertificaten beheren
    dropdown icon
    Algemene groothandelsinstellingen
      Modus Beperken door partner
      Beperkingen
      Beperkt door partnermodus inschakelen
    Partneranalyses
    API's voor factureringsrapport
    dropdown icon
    Problemen oplossen met Webex voor Cisco BroadWorks
      Ondersteuning
dropdown icon
Webex voor BroadWorks-referentie
    Vergelijking van UC-One SaaS met Webex voor Cisco BroadWorks
    Webex installeren en aanmelden (Subscriber Perspective)
    dropdown icon
    Gegevensuitwisseling en -opslag
      Serviceprovider integreren
      Gebruikersinrichting serviceprovider
      Gebruiker verwijderen
      Gebruikersaanmelding en configuratie ophalen
      Gebruik bij steady-state
    De inrichtings-API gebruiken
    Vereisten voor BroadWorks-software
    BroadWorks-tags vereist voor Webex
    Gebruikersvoorzieningen en activeringsstromen
    SSO-aanmeldingsstroom
    Gebruikersinteracties
    Klantinteracties
    Test- en laboratoriumrichtlijnen
    Voicemail afspelen
    Terminologie
dropdown icon
Bijlage
    Services configureren (met mTLS voor de verificatieservice)
    dropdown icon
    Aanvullende certificaatvereisten voor gemeenschappelijke TLS-verificatie met AuthService
      Gemeenschappelijke TLS-certificaatvereisten voor proxy voor TLS-bridge
      Gemeenschappelijke TLS-certificaatvereisten voor TLS-doorgangproxy of XSP in DMZ
    Revisiegeschiedenis van document
Webex voor Cisco BroadWorks-oplossingshandleiding
list-menuIn dit artikel
list-menuFeedback?

De Webex voor Cisco BroadWorks-oplossingshandleiding is gericht op beheerders op partnerniveau. De handleiding beschrijft hoe u Webex voor Cisco BroadWorks kunt instellen en implementeren. Webex voor Cisco BroadWorks biedt uw klanten die bellen met BroadWorks Webex-samenwerkingsfuncties. Abonnees gebruiken één toepassing (de Webex-app) om te profiteren van functies die door beide platforms worden geboden.

Overzicht van Webex voor Cisco BroadWorks

Introductie van Webex voor Cisco BroadWorks

Revisiegeschiedenis van document

Dit gedeelte behandelt systeembeheerders bij Cisco-partnerorganisaties (serviceproviders) die Webex implementeren voor hun klantorganisaties of deze oplossing rechtstreeks aanbieden aan hun eigen abonnees.

Doel van de oplossing

  • Webex-cloudsamenwerkingsfuncties aanbieden aan kleine en middelgrote klanten die al gespreksservice hebben die wordt geleverd door BroadWorks-serviceproviders.

  • BroadWorks-gebaseerde gespreksservice aanbieden aan kleine en middelgrote Webex-klanten.

Context

We evolueren al onze samenwerkingsklanten naar een uniforme toepassing. Dit pad vermindert aannameproblemen, verbetert de interoperabiliteit en migratie en biedt voorspelbare gebruikerservaringen in ons hele samenwerkingsportfolio. Een deel van deze inspanning is het verplaatsen van de BroadWorks-gespreksmogelijkheden naar de Webex-app en uiteindelijk het verminderen van investeringen in de UC-One-clients.

Voordelen

  • Toekomstbestendigheid: tegen beëindiging van UC-One Collaborate, beweging van alle clients naar het Unified Client Framework (UCF)

  • Het beste van beide: Webex-functies voor berichten en vergaderingen inschakelen met behoud van BroadWorks-gesprekken op uw telefonienetwerk

Toepassingsgebied van de oplossing

  • Bestaande/nieuwe kleine tot middelgrote klanten (minder dan 250 abonnees) die een reeks samenwerkingsfuncties willen, hebben mogelijk al BroadWorks-gesprekken.

  • Bestaande kleine tot middelgrote Webex-klanten die BroadWorks Calling willen toevoegen.

  • Niet voor grotere ondernemingen (raadpleeg ons Enterprise-portfolio voor Webex).

  • Niet voor één gebruiker (evalueer Webex Online-aanbiedingen).

De functiesets in Webex voor Cisco BroadWorks zijn gericht op gebruiksscenario's voor kleine tot middelgrote bedrijven. De Webex voor Cisco BroadWorks-pakketten zijn ontworpen om de complexiteit voor kleine en middelgrote ondernemingen te verminderen en we evalueren voortdurend hun geschiktheid voor dit segment. We kunnen ervoor kiezen functies die anders beschikbaar zijn in de bedrijfspakketten te verbergen of te verwijderen.

Vereisten voor succes met Webex voor Cisco BroadWorks

#

Vereiste

Notities

1

Patchstroom BroadWorks R22 of hoger

2

XSP|ADP voor XSI, CTI, DMS en authService

Specifieke XSP|ADP voor Webex voor Cisco BroadWorks

3

Afzonderlijke XSP|ADP voor NPS kunnen worden gedeeld met andere oplossingen die NPS gebruiken.

Als u een bestaande implementatie voor samenwerken hebt, controleert u aanbevelingen voor XSP|ADP- en NPS-configuraties.

4

CI-tokenvalidatie (met TLS) geconfigureerd voor Webex-verbindingen met de verificatieservice.

5

mTLS is geconfigureerd voor Webex-verbindingen met de CTI-interface.

Voor andere toepassingen is geen mTLS vereist.

6

Gebruikers moeten bestaan in BroadWorks en hebben de volgende kenmerken nodig, afhankelijk van uw inrichtingsbeslissing:

  • Doorloop met vertrouwde e-mails: Het e-mailkenmerk van de BroadWorks-gebruiker moet een geldig e-mailadres bevatten dat uniek is voor die gebruiker. De gebruiker moet ook een primair nummer of toestel hebben.

  • Doorloop met niet-vertrouwde e-mails, zelfactivering of API-inrichting: Gebruiker heeft geen e-mailadres nodig, maar moet een primair nummer of toestel hebben.

Voor vertrouwde e-mails: We raden u aan hetzelfde e-mailadres ook in het kenmerk Alternatieve id in te voeren, zodat gebruikers zich met e-mailadres kunnen aanmelden bij BroadWorks.

Voor niet-vertrouwde e-mails: Afhankelijk van de e-mailinstellingen van de gebruiker kan het gebruik van niet-vertrouwde e-mails ertoe leiden dat de e-mail wordt verzonden naar de ongewenste of spammap van de gebruiker. De beheerder moet mogelijk de e-mailinstellingen van de gebruiker wijzigen om domeinen toe te staan

7

Webex voor Cisco BroadWorks DTAF-bestand voor de Webex-app

8

BW Business Lic of Std Enterprise of Prem Enterprise User Lic + Webex voor Cisco BroadWorks-abonnement

Als u een bestaande implementatie voor samenwerken hebt, hebt u geen UC-One Add-On Bundle, Collab Lic en Meet-me Conference Ports meer nodig.

Als u een bestaande UC-One SaaS-implementatie hebt, zijn er geen andere wijzigingen dan het accepteren van de voorwaarden van het Premium-pakket.

9

IP/poorten moeten toegankelijk zijn via de Webex-backend-services en de Webex-apps via openbaar internet.

Zie het gedeelte “Uw netwerk voorbereiden”.

10

TLS v1.2-configuratie op XSP|ADP's

11

Voor Flowthrough-inrichting moet de toepassingsserver verbinding maken met de BroadWorks-inrichtingsadapter.


 

We testen of ondersteunen geen uitgaande proxyconfiguratie. Als u een uitgaande proxy gebruikt, accepteert u de verantwoordelijkheid om deze te ondersteunen met Webex voor Cisco BroadWorks.

Zie het onderwerp “Uw netwerk voorbereiden”.

Over dit document

Het doel van dit document is u te helpen uw Webex for Cisco BroadWorks-oplossing te begrijpen, voor te bereiden, te implementeren en te beheren. De grote delen in het document weerspiegelen dit doel.

Deze gids bevat conceptueel en referentiemateriaal. We zijn van plan alle aspecten van de oplossing in dit ene document te behandelen.

De minimale set taken om de oplossing te implementeren zijn:

  1. Bereik uw accountteam om een Cisco-partner te worden. Het is noodzakelijk dat u de Cisco-aanrakingspunten onderzoekt om uzelf vertrouwd te maken (en getraind te worden). Wanneer u een Cisco-partner wordt, passen we de Webex voor Cisco BroadWorks-schakelaar toe op uw Webex-partnerorganisatie. (Zie Webex implementeren voor Cisco BroadWorks > Onboarding voor partners in dit document.)

  2. Configureer uw BroadWorks-systemen voor integratie met Webex. (Zie Webex implementeren voor Cisco BroadWorks > Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's in dit document.)

  3. Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)

  4. Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)

  5. Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)


 
  • Dit zijn stappen van hoog niveau, in de typische volgorde. Er zijn verschillende bijdragende taken die u niet kunt negeren.

  • Als u uw eigen toepassingen wilt maken om uw Webex voor Cisco BroadWorks-abonnees te beheren, leest u De inrichtings-API gebruiken in het gedeelte Referentie van deze handleiding.

Terminologie

We proberen het jargon en de letterwoorden in dit document te beperken en elke term uit te leggen wanneer deze voor het eerst wordt gebruikt. (Zie Webex voor Cisco BroadWorks-referentie > Terminologie als een term niet in de context wordt uitgelegd.)

Hoe het werkt

Webex voor Cisco BroadWorks is een aanbieding die BroadWorks-gesprekken integreert in Webex. Abonnees gebruiken één toepassing (de Webex-app) om gebruik te maken van functies die door beide platforms worden aangeboden:

  • Gebruikers bellen PSTN-nummers via uw BroadWorks-infrastructuur.

  • Gebruikers bellen met andere BroadWorks-nummers via uw BroadWorks-infrastructuur (audio-/videogesprekken door de nummers te selecteren die zijn gekoppeld aan de gebruikers of het toetsenblok om de nummers te introduceren).

  • Gebruikers kunnen ook een Webex VoIP-gesprek plaatsen via de Webex-infrastructuur door de optie 'Webex Call' te selecteren in de Webex-app. (Deze gesprekken zijn de Webex-app naar de Webex-app, niet de Webex-app naar PSTN).

  • Gebruikers kunnen Webex Meetings hosten en eraan deelnemen.

  • Gebruikers kunnen elkaar een voor een berichten sturen of in ruimten (permanente groepchat) en profiteren van functies als zoeken en bestanden delen (op Webex-infrastructuur).

  • Gebruikers kunnen aanwezigheid (status) delen. Ze kunnen aangepaste aanwezigheid of door de klant berekende aanwezigheid kiezen.

  • Nadat we u als partnerorganisatie hebben geïntegreerd in Control Hub, met de juiste rechten, kunt u de relatie tussen uw BroadWorks-exemplaar en Webex configureren.

  • U maakt klantorganisaties in Control Hub en richt gebruikers in deze organisaties in.

  • Elke abonnee in BroadWorks krijgt een Webex-identiteit op basis van zijn/haar e-mailadres (kenmerk e-mail-id in BroadWorks).

  • Gebruikers worden geverifieerd voor BroadWorks of voor Webex.

  • Clients krijgen langdurige tokens om ze te autoriseren voor services bij BroadWorks en Webex.

De Webex-app in het midden van deze oplossing; het is een brandbare toepassing die beschikbaar is op Mac/Windows-bureaubladen en Android/iOS-telefoons en -tablets.

Er is ook een webversie van de Webex-app die momenteel geen gespreksfuncties bevat.

De client maakt verbinding met de Webex-cloud om functies voor berichten, aanwezigheid en vergaderingen te leveren.

De client registreert zich bij uw BroadWorks-systemen voor gespreksfuncties.

De Webex-cloud werkt met uw BroadWorks-systemen om een naadloze gebruikersinrichting te garanderen.

Functies en beperkingen

Wij bieden verschillende pakketten met verschillende functies.

Softphone-pakket

Dit pakkettype gebruikt de Webex-app als een softphone only-client met belmogelijkheden, maar geen berichtmogelijkheden. Gebruikers met dit pakkettype kunnen deelnemen aan Webex-vergaderingen, maar kunnen geen vergaderingen zelf starten. Wanneer andere gebruikers (softphone of niet-softphone) in de telefoonlijst zoeken naar een softphone-gebruiker, bieden de zoekresultaten geen optie om een bericht te verzenden.

Softphone-gebruikers kunnen hun scherm delen tijdens een gesprek.

Basispakket

Het basispakket bevat functies voor bellen, chatten en vergaderen. Het omvat 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room). (** zie onderstaande Note voor uitzondering). In dit pakket kunnen de vergaderingen een maximale duur van 40 minuten hebben.

Pakket "Standaard"

Dit pakket omvat ook alles in het basispakket, zoals maximaal 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room).

Scherm delen binnen een PMR-vergadering is een rol die in eerste instantie alleen wordt uitgeoefend door de host van de vergadering, maar de host kan de rol van presentator overdragen aan een door hem of haar gekozen deelnemer aan de vergadering. Alleen de host kan de rol van presentator opnieuw opnemen zonder dat de huidige host deze aan hem of haar heeft doorgegeven.

"Premium"-pakket

Dit pakket omvat alles in het standaardpakket plus maximaal 300 deelnemers aan een vergadering in een 'unified space' en maximaal 1000 deelnemers in een persoonlijke vergaderruimte (PMR).

Scherm delen binnen een PMR-vergadering wordt ondersteund voor elke deelnemer aan de vergadering.

Pakketten vergelijken

Pakket

Oproepen

Berichten

Unified Space-vergaderingen

PMR Meetings

Softphone

Opgenomen

Niet inbegrepen

Geen

Geen

Eenvoudig

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Standaard

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Premium

Opgenomen

Opgenomen

300 deelnemers

1000 deelnemers


 
De limiet voor Unified Space-vergaderingen voor basisgebruikers is 100 deelnemers per Unified Space-vergadering, tenzij de ruimte ook gebruikers bevat waaraan de pakketten 'Standaard' of 'Premium' zijn toegewezen. In dat geval wordt de limiet verhoogd op basis van het gebruikerspakket van de host.

 

'Unified Space Meetings' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in een Webex-ruimte. Een gebruiker start bijvoorbeeld een vergadering vanuit de ruimte via de knoppen 'Vergaderen' of 'Plannen'.

'PMR-vergaderingen' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in de persoonlijke vergaderruimte (PMR) van een gebruiker. Deze vergaderingen gebruiken een speciale URL (bijvoorbeeld: cisco.webex.com/meet/roomOwnerUserID).

Berichten en vergaderingsfuncties

Raadpleeg de volgende tabel voor verschillen in ondersteuning van PMR-vergaderingsfuncties voor Basic-, Standard- en Premium-pakketten.

Tabel 1. Verschillen in functieondersteuning voor PMR-vergaderingen

Vergaderingsfunctie

Ondersteund met basispakket

Overgezet met standaardpakket

Ondersteund met Preminum-pakket

Opmerking

Vergaderduur

40 minuten of minder

Onbeperkt

Onbeperkt

Bureaublad delen

Ja

Ja

Ja

Basis: bureaublad delen door een PMR-vergaderingdeelnemer.

Standaard : bureaublad delen alleen door de host van de PMR-vergadering.

Premium: bureaublad delen door een deelnemer aan een PMR-vergadering.

Toepassingen delen

Ja

Ja

Ja

Basis: toepassingen delen door elke deelnemer aan een PMR-vergadering.

Standaard : toepassingen delen alleen door de host van de PMR-vergadering.

Premium: toepassingen delen door deelnemers aan een PMR-vergadering.

Chat met meerdere partijen

Ja

Ja

Ja

Whiteboarden

Ja

Ja

Ja

Wachtwoordbeveiliging

Ja

Ja

Ja

Web-app - geen downloaden of invoegtoepassingen (gastervaring)

Ja

Ja

Ja

Ondersteuning voor koppelen met Webex-apparaten

Ja

Ja

Ja

Vloerbeheer (Eén dempen / Alles verwijderen)

Ja

Ja

Ja

Koppeling voor blijvende vergaderingen

Ja

Ja

Ja

Toegang tot de Meetings-site

Ja

Ja

Ja

Deelnemen aan vergadering via VoIP

Ja

Ja

Ja

Vergrendeling

Ja

Ja

Ja

Bedieningselementen voor presentator

Nee

Nee

Ja

Extern bureaubladbeheer

Nee

Nee

Ja

Aantal deelnemers

100

100

1000

Opname lokaal opgeslagen in het systeem

Ja

Ja

Ja

Opnemen in de cloud

Nee

Nee

Ja

Opname - Cloudopslag

Nee

Nee

10 GB per locatie

Opnametranscripties

Nee

Nee

Ja

Vergaderingen plannen

Ja

Ja

Ja

Inhoud delen met externe integraties inschakelen

Nee

Nee

Ja

Basic— Inhoud delen door een deelnemer aan een PMR-vergadering.

Standaard: inhoud delen met alleen de host van de PMR-vergadering.

Premium: inhoud delen door een deelnemer aan een PMR-vergadering.

PMR-URL wijzigen toestaan

Nee

Nee

Ja

Basic— Gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL wijzigen vanuit Control Hub.

Standaard: de PMR-URL kan alleen worden gewijzigd vanuit Partner Hub door partner- en organisatiebeheerders.

Premium: gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL vanuit Partner Hub wijzigen.

Live streaming van vergaderingen (Bv. op Facebook, Youtube)

Nee

Nee

Ja

Andere gebruikers toestaan vergaderingen namens hen te plannen

Nee

Nee

Ja

Een alternatieve host toevoegen

Ja

Nee

Ja

App-integratie (bijv. Zendesk, Slack)

Afhankelijk van de integratie

Afhankelijk van de integratie

Ja

Zie het gedeelte App-integraties hieronder voor meer informatie over ondersteuning.

Integratie met Microsoft Office 365-agenda

Ja

Ja

Ja

Integratie met Google-agenda voor G Suite

Ja

Ja

Ja

Het Webex-helpcentrum publiceert de functies en documentatie voor gebruikers voor Webex op help.webex.com. Lees de volgende artikelen voor meer informatie over de functies:

Gespreksfuncties

De belervaring is vergelijkbaar met eerdere oplossingen die gebruikmaken van de BroadWorks-gespreksbeheermotor. Het verschil met UC-One Collaborate en UC-One SaaS is dat de Webex-app de primaire softclient is.

App-integraties

U kunt Webex voor Cisco BroadWorks integreren met de volgende toepassingen:

Ondersteuning voor Virtual Desktop Infrastructure (VDI)

Webex voor Cisco BroadWorks ondersteunt nu VDI-omgevingen (Virtual Desktop Infrastructure). Raadpleeg de Implementatiehandleiding voor Webex voor Virtual Desktop Infrastructure (VDI) voor meer informatie over de implementatie van VDI-infrastructuur.

IPv6-ondersteuning

Webex voor Cisco BroadWorks ondersteunt IPv6-adressering voor de Webex-app.

Toekomstige routekaart

Ga naar https://salesconnect.cisco.com/#/program/PAGE-16649 voor meer informatie over onze voornemens voor de toekomstige versies van Webex voor Cisco BroadWorks. De items van het stappenplan zijn in geen enkele hoedanigheid bindend. Cisco behoudt zich het recht voor om een of al deze items uit toekomstige releases te onthouden of te herzien.

Beperkingen

Inrichtingsbeperkingen

Tijdzone van Meetings-site

De tijdzone van de eerste abonnee voor elk pakket wordt de tijdzone voor de Webex Meetings-site die voor dat pakket is gemaakt.

Als er geen tijdzone is opgegeven in het inrichtingsverzoek voor de eerste gebruiker van elk pakket, wordt de tijdzone van de Webex Meetings-site voor dat pakket ingesteld op de regionale standaard van de organisatie van de abonnees.

Als uw klant een specifieke tijdzone van de Webex Meetings-site nodig heeft, geeft u de timezone parameter in de inrichtingsaanvraag voor:

  • de eerste abonnee die is ingericht voor het standaardpakket in de organisatie.

  • de eerste abonnee die is ingericht voor Premium-pakket in de organisatie.

  • de eerste abonnee die is ingericht voor het basispakket in de organisatie.

Algemene beperkingen

  • Geen gesprekken in de webversie van de Webex-client (dit is een clientbeperking, geen oplossingsbeperking.)

  • Webex beschikt mogelijk nog niet over alle besturingselementen voor de gebruikersinterface om bepaalde functies voor gespreksbeheer te ondersteunen die beschikbaar zijn via BroadWorks.

  • De Webex-client kan momenteel geen 'wit label' hebben.

  • Wanneer u klantorganisaties maakt met de door u gekozen inrichtingsmethode, worden deze automatisch gemaakt in dezelfde regio als uw partnerorganisatie. Dit gedrag is zo bepaald. We verwachten van multinationale partners dat ze in elke regio een partnerorganisatie creëren waar ze klantorganisaties beheren.

  • Rapportage over het gebruik van vergaderingen en berichten is beschikbaar via de klantorganisatie in Control Hub.

Bekende problemen en beperkingen

Zie Bekende problemen en beperkingen voor een actuele lijst met bekende problemen en beperkingen met het Webex voor Cisco BroadWorks-aanbod.

Berichtenlimieten

De volgende opslaglimieten voor gegevens (berichten en bestanden gecombineerd) zijn van toepassing op organisaties die Webex voor Cisco BroadWorks-services hebben aangeschaft via een serviceprovider. Deze limieten vertegenwoordigen de maximale opslag voor berichten en bestanden gecombineerd.

  • Basis: 2 GB per gebruiker gedurende 3 jaar

  • Standaard 5 GB per gebruiker gedurende 3 jaar

  • Premie: 10 GB per gebruiker gedurende 5 jaar

Voor elke klantorganisatie worden deze totalen per gebruiker samengevoegd om een geaggregeerd totaal voor die klant op te geven, op basis van het aantal gebruikers. Een bedrijf met vijf premium-gebruikers heeft bijvoorbeeld een totale limiet voor berichten en bestandsopslag van 50 GB. Een individuele gebruiker kan de limiet per gebruiker (10 GB) overschrijden op voorwaarde dat het bedrijf nog onder het geaggregeerde maximum (50 GB) zit.

Voor teamruimten die worden gemaakt, gelden de berichtlimieten voor het geaggregeerde totaal voor de klantorganisatie die eigenaar is van de teamruimte. U vindt informatie over de eigenaar van individuele teamruimten in het ruimtebeleid. Zie https://help.webex.com/en-us/baztm6/Webex-Space-Policy voor meer informatie over het bekijken van het ruimtebeleid voor een individuele teamruimte.

Aanvullende informatie

Raadpleeg https://help.webex.com/en-us/n8vw82eb/Webex-Capacities voor meer informatie over algemene berichtbeperkingen die van toepassing zijn op Webex-ruimten van het berichtenteam.

Beveiliging, gegevens en rollen

Webex-beveiliging

De Webex-client is een veilige toepassing die veilige verbindingen maakt met Webex en BroadWorks. De gegevens die in de Webex-cloud zijn opgeslagen en via de Webex-app aan de gebruiker zijn blootgesteld, worden zowel onderweg als in rust gecodeerd.

Meer informatie over gegevensuitwisseling vindt u in het deel Referentie van dit document.

Bijkomende lectuur

Locatie organisatiegegevens

We slaan uw Webex-gegevens op in het datacenter dat het meest overeenkomt met uw regio. Zie Gegevensresidentie in Webex in het Helpcentrum.

Rollen

Beheerder serviceprovider (u): Voor dagelijkse onderhoudsactiviteiten beheert u de lokale (bel)onderdelen van de oplossing met behulp van uw eigen systemen. U beheert de Webex-onderdelen van de oplossing via Partner Hub.

Zie Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM voor informatie over de rollen die beschikbaar zijn voor partners, de toegangsrechten die bij deze rollen horen en hoe u rollen kunt toewijzen.


 
De eerste gebruiker die is ingericht voor een nieuw partnerorganizaiton, wordt automatisch toegewezen aan de rollen Volledige beheerder en Volledige partnerbeheerder. Die beheerder kan het bovenstaande artikel gebruiken om extra rollen toe te wijzen.

Cisco Cloud Operations-team: Maakt uw 'partnerorganisatie' in Partner Hub, als deze niet bestaat, tijdens uw onboarding.

Zodra u uw Partner Hub-account hebt, configureert u de Webex-interfaces met uw eigen systemen. Vervolgens maakt u 'Onboarding-sjablonen' om de suites of pakketten weer te geven die via deze systemen worden aangeboden. Vervolgens richt u uw klanten of abonnees in.

#

Typische taak

SP

Cisco

1

Onboarding voor partners - De partnerorganisatie maken als deze nog niet bestaat en de benodigde functieschakelaars inschakelen

2

BroadWorks-configuratie in partnerorganisatie via Partner Hub (cluster)

3

Integratie-instellingen configureren in de partnerorganisatie via Partner Hub (aanbiedingssjablonen, branding)

4

BroadWorks-omgeving voorbereiden voor integratie (AS, XSP|ADP Patching, firewalls, XSP|ADP-configuratie, XSI, AuthService, CTI, NPS, DMS-toepassingen op XSP|ADP)

5

Inrichtingsintegratie of -proces ontwikkelen

6

GTM-materialen voorbereiden

7

Nieuwe gebruikers migreren of inrichten

Architectuur

Wat staat er in het diagram?

Clients

  • De Webex-app-client dient als de primaire toepassing in Webex voor Cisco BroadWorks-aanbiedingen. De client is beschikbaar op desktop-, mobiele en webplatforms.

    De client heeft systeemeigen chat-, presence- en meerpartijenaudio-/videovergaderingen die door de Webex-cloud worden geleverd. De Webex-client gebruikt uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken.

  • Cisco IP-telefoons en gerelateerde accessoires gebruiken ook uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken. We verwachten telefoons van derden te kunnen ondersteunen.

  • Activeringsportal voor gebruikers om zich aan te melden bij Webex met hun BroadWorks-aanmeldgegevens.

  • Partner Hub is een webinterface voor het beheren van uw Webex-organisatie en de organisaties van uw klanten. In Partner Hub kunt u de integratie tussen uw BroadWorks-infrastructuur en Webex configureren. U gebruikt ook Partner Hub om de clientconfiguratie en facturering te beheren.

Netwerk van serviceproviders

Het groene blok links op het diagram staat voor uw netwerk. Componenten die in uw netwerk worden gehost, bieden de volgende services en interfaces aan andere delen van de oplossing:

  • Openbare XSP|ADP, voor Webex voor Cisco BroadWorks: (De box staat voor een of meerdere XSP|ADP-boerderijen, mogelijk aan de voorkant door lastbalancers.)

    • Host de Xtended Services-interface (XSI-acties en XSI-gebeurtenissen), de Device Management-service (DMS), CTI-interface en de verificatieservice. Samen stellen deze toepassingen telefoons en Webex-clients in staat om zichzelf te verifiëren, hun gespreksconfiguratiebestanden te downloaden, gesprekken te starten en te ontvangen en elkaars haakstatus (telefonische aanwezigheid) en gespreksgeschiedenis te bekijken.

    • Publiceert directory naar Webex-clients.

  • Openbare XSP|ADP, met NPS:

    • Pushserver voor hostmeldingen: Een pushserver voor meldingen op een XSP|ADP in uw omgeving. Het werkt samen tussen uw toepassingsserver en onze NPS-proxy. De proxy levert korte tokens aan uw NPS om meldingen naar de cloudservices te autoriseren. Deze services (APNS & FCM) verzenden gespreksmeldingen naar Webex-clients op Apple iOS- en Google Android-apparaten.

  • Toepassingsserver:

    • Biedt gespreksbeheer en interfaces met andere BroadWorks-systemen (doorgaans)

    • Voor flowthrough-inrichting wordt het AS gebruikt door de partnerbeheerder om gebruikers in te richten in Webex

    • Hiermee wordt het gebruikersprofiel naar BroadWorks gepusht

  • OSS/BSS: Uw Operations Support System / Business SIP-services voor het beheer van uw BroadWorks-ondernemingen.

Webex Cloud

Het blauwe blok in het diagram staat voor de Webex-cloud. Webex-microservices ondersteunen het volledige spectrum van Webex-samenwerkingsmogelijkheden:

  • Cisco Common Identity (CI) is de identiteitsservice binnen Webex.

  • Webex voor Cisco BroadWorks staat voor de set microservices die de integratie tussen Webex en de gehoste BroadWorks-serviceprovider ondersteunen:

    • API's voor gebruikersinrichting

    • Configuratie van serviceprovider

    • Gebruikersaanmelding met BroadWorks-aanmeldgegevens

  • Webex-berichtenbox voor berichtengerelateerde microservices.

  • Webex Meetings-venster voor mediaverwerkingsservers en SBC's voor videovergaderingen met meerdere deelnemers (SIP & SRTP)

Webservices van derden

De volgende onderdelen van derden zijn weergegeven in het diagram:

  • APNS (Apple Push Notifications Service) pusht oproep- en berichtmeldingen naar Webex-toepassingen op Apple-apparaten.

  • FCM (FireBase Cloud Messaging) pusht meldingen voor gesprekken en berichten naar Webex-toepassingen op Android-apparaten.

XSP|ADP-architectuuroverwegingen

De rol van openbare XSP|ADP-servers in Webex voor Cisco BroadWorks

De openbare XSP|ADP in uw omgeving biedt de volgende interfaces/services aan Webex en clients:

  • Verificatieservice (AuthService), beveiligd door TLS, die reageert op Webex-verzoeken voor BroadWorks JWT (JSON Web Token) namens de gebruiker

  • CTI-interface, beveiligd door mTLS, waarop Webex zich abonneert voor gebeurtenissen uit de gespreksgeschiedenis en aanwezigheidsstatus van telefonie vanuit BroadWorks (haakstatus).

  • Xsi-acties en -gebeurtenissen-interfaces (eXtended Services Interface) voor gespreksbeheer voor abonnees, telefoonlijsten voor contactpersonen en gesprekslijsten en configuratie van de telefoonservice voor eindgebruikers

  • DM-service (Device Management) voor clients om hun configuratiebestanden voor gesprekken op te halen

Geef URL's op voor deze interfaces wanneer u Webex voor Cisco BroadWorks configureert. (Zie Uw BroadWorks-clusters configureren in Partnerhub in dit document.) Voor elk cluster kunt u slechts één URL voor elke interface opgeven. Als u meerdere interfaces hebt in uw BroadWorks-infrastructuur, kunt u meerdere clusters maken.

XSP|ADP-architectuur

XSP|ADP-architectuur: Optie 1
XSP|ADP-architectuur: Optie 2

We vereisen dat u een afzonderlijk, toegewezen XSP|ADP-exemplaar of -farm gebruikt om uw NPS-toepassing (Notification Push Server) te hosten. U kunt dezelfde NPS gebruiken met UC-One SaaS of UC-One Collaborate. Het is echter mogelijk dat u de andere toepassingen die vereist zijn voor Webex voor Cisco BroadWorks niet host op dezelfde XSP|ADP die de NPS-toepassing host.

We raden u aan een speciaal XSP|ADP-exemplaar/farm te gebruiken om de vereiste toepassingen voor Webex-integratie te hosten om de volgende redenen:

  • Als u bijvoorbeeld UC-One SaaS aanbiedt, raden we u aan een nieuwe XSP|ADP-farm te maken voor Webex voor Cisco BroadWorks. Op deze manier kunnen de twee diensten onafhankelijk werken terwijl u abonnees migreert.

  • Als u de Webex voor Cisco BroadWorks-toepassingen op een XSP|ADP-boerderij zoekt die voor andere doeleinden wordt gebruikt, is het uw verantwoordelijkheid om het gebruik te controleren, de daaruit voortvloeiende complexiteit te beheren en de verhoogde schaal te plannen.

  • De Cisco BroadWorks-systeemcapaciteitsplanner gaat uit van een specifieke XSP|ADP-farm en is mogelijk niet juist als u deze gebruikt voor collocatieberekeningen.

Tenzij anders vermeld, moet de speciale Webex voor Cisco BroadWorks XSP|ADP's de volgende toepassingen hosten:

  • Verificatieservice (TLS met CI-tokenvalidatie of mTLS)

  • CTI (mTLS)

  • XSI-acties (TLS)

  • XSI-gebeurtenissen (TLS)

  • DMS (TLS): optioneel. Het is niet verplicht om een afzonderlijk DMS-exemplaar of -bedrijf specifiek voor Webex voor Cisco BroadWorks te implementeren. U kunt hetzelfde DMS-exemplaar gebruiken dat u gebruikt voor UC-One SaaS of UC-One Collaborate.

  • Webview Gespreksinstellingen (TLS): optioneel. Webview voor gespreksinstellingen (CSW) is alleen vereist als u wilt dat Webex voor Cisco BroadWorks-gebruikers gespreksfuncties kunnen configureren in de Webex-app.

Webex vereist toegang tot CTI via een interface die is beveiligd door wederzijdse TLS-verificatie. Om deze vereiste te ondersteunen, raden we een van de volgende opties aan:

  • (Diagram gelabeld met Optie 1) Eén XSP|ADP-exemplaar of -bedrijf voor alle toepassingen, met twee interfaces die op elke server zijn geconfigureerd: een mTLS-interface voor CTI en een TLS-interface voor andere apps zoals de AuthService.

  • (Diagram gelabeld met Optie 2) Twee XSP|ADP-instanties of -farms, een met een mTLS-interface voor CTI, en de andere met een TLS-interface voor andere apps, zoals de AuthService.


 

XSP|ADP-hergebruik

Als u een bestaande XSP|ADP-boerderij hebt die voldoet aan een van de bovenstaande voorgestelde architecturen (optie 1 of 2) en deze lichtjes wordt geladen, is het mogelijk om uw bestaande XSP|ADP's opnieuw te gebruiken. U moet controleren of er geen tegenstrijdige configuratievereisten zijn tussen bestaande toepassingen en de nieuwe toepassingsvereisten voor Webex. De twee belangrijkste overwegingen zijn:

  • Als u meerdere Webex-partnerorganisaties op de XSP|ADP moet ondersteunen, betekent dit dat u mTLS moet gebruiken op de verificatieservice (CI Token Validation wordt alleen ondersteund voor één partnerorganisatie op een XSP|ADP). Als u mTLS gebruikt op de verificatieservice, betekent dit dat u niet tegelijkertijd clients kunt hebben die basisverificatie gebruiken op de verificatieservice. Deze situatie zou hergebruik van de XSP|ADP voorkomen.

  • Als de bestaande CTI-service is geconfigureerd voor gebruik door clients met de veilige poort (doorgaans 8012) maar zonder mTLS (d.w.z. clientverificatie), is dat in strijd met de Webex-vereiste om mTLS te hebben.

Omdat de XSP|ADP’s veel toepassingen hebben en het aantal permutaties van deze toepassingen groot is, kunnen er andere niet-geïdentificeerde conflicten zijn. Om deze reden moet elk mogelijk hergebruik van XSP|ADP's worden geverifieerd in een lab met de beoogde configuratie voordat wordt toegewezen aan het hergebruik.

NTP-synchronisatie configureren op XSP|ADP

De implementatie vereist tijdsynchronisatie voor alle XSP|ADP's die u met Webex gebruikt.

Installeer de ntp pakket nadat u het besturingssysteem hebt geïnstalleerd en voordat u de BroadWorks-software installeert. Vervolgens kunt u NTP configureren tijdens de installatie van de XSP|ADP-software. Zie de BroadWorks-handleiding voor softwarebeheer voor meer informatie.

Tijdens de interactieve installatie van de XSP|ADP-software krijgt u de optie om NTP te configureren. Ga verder als volgt:

  1. Wanneer het installatieprogramma hierom vraagt, Do you want to configure NTP?, voer in y.

  2. Wanneer het installatieprogramma hierom vraagt, Is this server going to be a NTP server?, voer in n.

  3. Wanneer het installatieprogramma hierom vraagt, What is the NTP address, hostname, or FQDN?, voer het adres van uw NTP-server of een openbare NTP-service in, bijvoorbeeld, pool.ntp.org.

Als uw XSP|ADP's een stille (niet-interactieve) installatie gebruiken, moet het installatieconfiguratiebestand de volgende Key=Value-paren bevatten:

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

XSP|ADP-identiteits- en beveiligingsvereisten

Achtergrond

De protocollen en coderingen van Cisco BroadWorks TLS-verbindingen kunnen op verschillende specificiteitsniveaus worden geconfigureerd. Deze niveaus variëren van de meest algemene (SSL-provider) tot de meest specifieke (individuele interface). Een meer specifieke instelling overschrijft altijd een meer algemene instelling. Als deze niet zijn opgegeven, worden SSL-instellingen op een lager niveau overgenomen van hogere niveaus.

Als er geen instellingen worden gewijzigd ten opzichte van de standaardinstellingen, worden de standaardinstellingen van de SSL-provider door alle niveaus overgenomen (JSSE Java Secure Sockets Extension).

Lijst met vereisten

  • De XSP|ADP moet zichzelf verifiëren bij clients met een door een certificeringsinstantie ondertekend certificaat waarin de algemene naam of alternatieve naam voor het onderwerp overeenkomt met het domeingedeelte van de XSI-interface.

  • De Xsi-interface moet het TLSv1.2-protocol ondersteunen.

  • De Xsi-interface moet een cijfersuite gebruiken die aan de volgende vereisten voldoet.

    • Diffie-Hellman Ephemeral (DHE) of Elliptic Curves Diffie-Hellman Ephemeral (ECDHE) sleuteluitwisseling

    • AES-code (Advanced Encryption Standard) met een minimale blokgrootte van 128 bits (bijv. AES-128 of AES-256)

    • GCM (Galois/Counter Mode) of CBC (Cipher Block Chaining) cipher mode

      • Indien een CBC-code gebruikt wordt, is enkel de SHA2-familie van hash-functies toegelaten voor sleutelafleiding (SHA256, SHA384, SHA512).

De volgende cijfers voldoen bijvoorbeeld aan de vereisten:

  • 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


 

De XSP|ADP CLI vereist de IANA-naamgevingsconventie voor versleutelingssuites, zoals hierboven weergegeven, niet de openSSL-conventie.

Ondersteunde TLS-cijfers voor de AuthService- en XSI-interfaces


 

Deze lijst kan worden gewijzigd naarmate onze cloudbeveiligingsvereisten evolueren. Volg de huidige aanbeveling voor Cisco-cloudbeveiliging voor cijferselectie, zoals beschreven in de lijst met vereisten in dit document.

  • 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

Parameters voor Xsi-gebeurtenisschaal

Mogelijk moet u de grootte van de Xsi-Events-wachtrij en het aantal thread verhogen om het volume aan gebeurtenissen af te handelen dat de Webex voor Cisco BroadWorks-oplossing vereist. U kunt de parameters als volgt verhogen tot de weergegeven minimumwaarden (verlaag ze niet als ze boven deze minimumwaarden liggen):

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

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

Meerdere XSP|ADP's

Randelement lastverdeling

Als u een load balancing-element op uw netwerkrand hebt, moet dit transparant omgaan met de verdeling van verkeer tussen uw meerdere XSP|ADP-servers en de Webex voor Cisco BroadWorks-cloud en -clients. In dit geval geeft u de URL van de load balancer op aan de Webex voor Cisco BroadWorks-configuratie.

Opmerkingen over deze architectuur:

  • Configureer DNS zodat de clients de load balancer kunnen vinden wanneer ze verbinding maken met de Xsi-interface (zie DNS-configuratie).

  • We raden u aan het randelement te configureren in de reverse SSL-proxymodus om punt-naar-punt-gegevenscodering te garanderen.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam. U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

Internetgerichte XSP|ADP-servers

Als u de Xsi-interfaces rechtstreeks blootstelt, gebruikt u DNS om het verkeer te distribueren naar de meerdere XSP|ADP-servers.

Opmerkingen over deze architectuur:

  • Er zijn twee records vereist om verbinding te maken met de XSP|ADP-servers:

    • Voor Webex-microservices: Round-robin A/AAAA-records zijn vereist om de meerdere XSP|ADP IP-adressen te bereiken. De reden hiervoor is dat de Webex-microservices geen SRV-zoekopdrachten kunnen uitvoeren. Zie Webex-cloudservices voor voorbeelden.

    • Voor de Webex-app: Een SRV-record dat wordt omgezet in A-records waarbij elk A-record wordt omgezet in één XSP|ADP. Zie de Webex-app voor voorbeelden.

      Gebruik geprioriteerde SRV-records om de XSI-service te richten op de meerdere XSP|ADP-adressen. Geef prioriteit aan uw SRV-records zodat de microservices altijd naar dezelfde A-record gaan (en het volgende IP-adres) en alleen naar de volgende A-record (en IP-adres) gaan als het eerste IP-adres niet beschikbaar is. GEBRUIK GEEN round-robin-benadering voor de Webex-app.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam.

  • U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

HTTP-omleidingen vermijden

Soms is DNS geconfigureerd om de XSP|ADP-URL op te lossen naar een HTTP-laadbalancer en is de laadbalancer geconfigureerd voor omleiding via een reverse proxy naar de XSP|ADP-servers.

Webex volgt geen omleiding wanneer u verbinding maakt met de URL's die u levert, dus deze configuratie werkt niet.

Bestellen en inrichten

Bestellen en inrichten is van toepassing op deze niveaus:

  • Inrichting van partner/serviceprovider:

    Elke geïntegreerde Webex voor Cisco BroadWorks-serviceprovider (of reseller) moet worden geconfigureerd als een partnerorganisatie in Webex en de nodige rechten krijgen. Cisco Operations biedt de beheerder van de partnerorganisatie toegang tot het beheren van Webex voor Cisco BroadWorks op Webex Partner Hub. De partnerbeheerder moet alle vereiste inrichtingsstappen uitvoeren voordat hij/zij een klant/bedrijfsorganisatie kan inrichten.

  • Bestellen en inrichten klant/onderneming:

    Elke BroadWorks Enterprise die is ingeschakeld voor Webex voor Cisco BroadWorks, activeert het maken van een gekoppelde Webex-klantorganisatie. Dit proces vindt automatisch plaats als onderdeel van de inrichting van de gebruiker/abonnee. Alle gebruikers/abonnees binnen een BroadWorks-onderneming zijn ingericht in dezelfde Webex-klantorganisatie.

    Hetzelfde gedrag is van toepassing als uw BroadWorks-systeem is geconfigureerd als serviceprovider met groepen. Wanneer u een abonnee inricht in een BroadWorks-groep, wordt er automatisch een klantorganisatie gemaakt in Webex die overeenkomt met de groep.

  • Bestellen en inrichten van gebruikers/abonnees:

    Webex voor Cisco BroadWorks ondersteunt momenteel de volgende modellen voor gebruikersinrichting:

    • Flowthrough-inrichting met vertrouwde e-mails

    • Flowthrough-inrichting zonder vertrouwde e-mails

    • Zelfinrichting gebruiker

    • API-inrichting

Flowthrough-inrichting met vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u kunt bevestigen dat BroadWorks e-mailadressen van abonnees heeft die geldig en uniek zijn voor Webex, maakt en activeert deze inrichtingsoptie automatisch Webex-accounts met deze e-mailadressen als gebruikers-id's.

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Flowthrough-inrichting met vertrouwde e-mails

Flowthrough-inrichting zonder vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u niet kunt vertrouwen op de e-mailadressen van abonnees die in handen zijn van BroadWorks, maakt deze inrichtingsoptie Webex-accounts, maar kan deze niet worden geactiveerd totdat abonnees hun e-mailadressen leveren en valideren. Op dat moment kan Webex de accounts met deze e-mailadressen activeren als gebruikers-id's.

Flowthrough-inrichting zonder vertrouwde e-mails

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Zelfinrichting gebruiker

Met deze optie is er geen flowthrough-inrichting van BroadWorks naar Webex. Nadat u de integratie tussen Webex en uw BroadWorks-systeem hebt geconfigureerd, krijgt u een of meer koppelingen die specifiek zijn voor het inrichten van gebruikers binnen uw Webex voor Cisco BroadWorks-partnerorganisatie.

Vervolgens ontwerpt u uw eigen communicatie (of delegeert u aan uw klanten) om de link naar abonnees te verspreiden. De abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun eigen Webex-accounts te maken en te activeren.

Zelfinrichting gebruiker

Omdat de accounts zijn ingericht binnen het bereik van uw partnerorganisatie, kunt u gebruikerspakketten handmatig aanpassen via Partner Hub of de API gebruiken om dit te doen.


 

Gebruikers moeten bestaan in het BroadWorks-systeem dat u met Webex integreert, of ze mogen geen accounts maken met die koppeling.

Serviceproviderinrichting door API's

Webex toont een reeks openbare API's waarmee u Webex voor Cisco BroadWorks gebruikers-/abonneevoorzieningen kunt maken in uw bestaande gebruikersbeheerworkflow/-tools.

Serviceproviderinrichting door API's - Vertrouwde e-mails
Serviceproviderinrichting door API's - Niet-vertrouwde e-mails

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Toestelnummer bellen

Met ondersteuning voor de functie voor toestelbellen kunnen Webex-gebruikers van Cisco Broadworks andere gebruikers bellen met een toestel dat vergelijkbaar is met het primaire telefoonnummer binnen dezelfde onderneming. Dit is vooral handig voor gebruikers die geen DID-nummers hebben.

Tijdens het inrichten wordt het toestelnummer van de gebruikers opgeslagen in de Webex-directory als het toestelnummer van de gebruiker. Voor BroadWorks-gesprekken wordt het toestelnummer weergegeven in de Webex-app in het toestelveld van alle gebieden met de gespreksinitiatiemethode en het profiel van de gebruiker. Webex voor Cisco BroadWorks ondersteunt alleen-toestelgesprekken tussen gebruikers binnen dezelfde groep en verschillende groepen van dezelfde onderneming met de combinatie van kiescode voor locatie en toestel. Bellen tussen twee bedrijven die alleen extensies gebruiken, wordt echter niet ondersteund.

Er kan een toestel worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'toestel'

      • De toestelparameter moet expliciet worden doorgegeven als onderdeel van de API-oproep. Voor bedrijven/groepen waarvoor LDC (Location Dialing Code) is geconfigureerd, moet de toestelparameter de combinatie LDC en 'toestelnummer' zijn.

    • Flowthrough- of zelfactiveringsinrichting

      • Toestel en LDC (indien van toepassing) worden automatisch opgehaald uit BroadWorks.

  • Gespreksgebruikers of -entiteiten met alleen BroadWorks

    • Automatisch gesynchroniseerd vanuit BroadWorks via adreslijstsynchronisatie met de combinatie van LDC (Location Dialing Code) en toestelnummer.

Tabel 2. Toestelnummers beheren op basis van de inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Toestelnummer beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

Toestelnummer moet worden doorgegeven als parameter

Doorstroomd

Toestel automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

BroadWorks-telefoonlijsten

Lijsten met bedrijven, groepen of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing

Voorwaarden

  1. De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.

  2. Patch waarbij kiescodes voor toestelnummers en locaties worden toegevoegd aan XSI en inrichtingsadapter februari 2022 voor versie 23 of hoger als onderdeel van:

    • 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. Schakel de koptekst X-BroadWorks-Remote-Party-Info in op het AS met de onderstaande CLI-opdracht voor deze SIP-gespreksstroom die vereist is voor ondersteuning van de functie voor toestelbellen.

    AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Prioriteit oproepopties in de app

Als onderdeel van de ondersteuning voor de functie Toestelbellen wordt De prioriteitsinstelling voor gespreksopties van de app ook op partnerniveau aangeboden voor alle Webex voor Cisco Broadworks-partners. Met deze instelling kan de partner de gespreksprioriteitsinstellingen van al zijn beheerde klanten beheren vanuit Partner Hub. De prioriteitsinstelling voor app-gespreksopties voor een klant kan ook op klantniveau worden gewijzigd vanuit Control Hub.

De prioriteitsinstelling voor app-gespreksopties bevat toestel als tweede optie in zowel Partner Hub als Control Hub wanneer een Webex voor Cisco Broadworks-gebruiker nieuw is ingericht met toestel via een van de bovengenoemde inrichtingsmethoden.

Voor alle bestaande ingerichte organisaties heeft de uitbreidingsoptie de verborgen status (standaard) in de prioriteitsinstelling voor app-gespreksopties. Er wordt geen toestel weergegeven in de optie voor audio-/videogesprekken van de gebruiker in de Webex-app.

Hieronder ziet u de opties om de optie Toestelgesprek zichtbaar te maken voor de bestaande klanten:

  1. Als een partner wil dat al zijn beheerde klantorganisaties een toestel krijgen als een van de gespreksopties, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Partnerhub. Hierdoor kunnen de beheerde klantorganisaties de instelling van hun partner overnemen.

  2. Als een partner een toestel wil aanbieden in gespreksopties voor een specifieke klantorganisatie, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Control Hub.

Ondersteuning voor groepscontactpersonen

Met deze functie wordt de Webex for BroadWorks DirSync-service verbeterd door de beperking voor het synchroniseren van maximaal 1500 contactpersonen uit de telefoonlijsten van de groep in BroadWorks te verwijderen en partners in staat te stellen maximaal 30K contactpersonen uit een enkele telefoonlijst van de groep te synchroniseren en deze gelijk te maken met de verhoging van 30K contactpersonen voor de Enterprise telefoonlijst, die afzonderlijk is vrijgegeven.

Er is een totale limiet van 200K voor alle externe contactpersonen per organisatie, die van toepassing is op de som van Enterprise- en Group-telefoonlijsten in één BroadWorks-onderneming. Een BroadWorks-onderneming met een bedrijfstelefoonlijst met 30K en ook 5 groepstelefoonlijsten met elk 30K worden ondersteund (180K totaal per organisatie). Als er echter 6 groepstelefoonlijsten zijn met elk 30K, wordt dit niet ondersteund (210K totaal).


 

Deze functie is beschikbaar op aanvraag. Neem contact op met uw accountteam om dit in te schakelen.

  • Voordat u de functie inschakelt, moet een vereiste migratie worden uitgevoerd om groepen in te richten en te koppelen voor alle bestaande ingerichte gebruikers.

  • Het Cisco-team voert een interne API uit om bestaande ingerichte gebruikers te migreren om ze aan de juiste groep te koppelen. OPMERKING: Dit kan tot een week duren om te verwerken.

  • Zodra de migratie is voltooid voor de partner en de functie is ingeschakeld, worden alle nieuw ingerichte gebruikers op de juiste manier 'gegroepeerd'.

Nadat de functie is ingeschakeld, begint de DirSync-service met het synchroniseren van contactpersonen uit de telefoonlijst van de BroadWorks-groep in de speciale opslag voor groepscontactpersonen in de Webex-contactservice.

Tijdens het inrichten moet de bedrijfsgroep van de gebruiker worden opgeslagen in de Webex-directory om aan te geven tot welke groep deze gebruiker behoort. Met de koppeling van de gebruiker aan een BroadWorks-groep in de Webex-directory kan de Webex-app contact zoeken in de opslag voor de contactservicegroep voor de specifieke groep van de gebruiker.

Voor deze functie moeten de Webex for BroadWorks-abonnees in Webex worden ingericht met de BroadWorks-bedrijfs-groeps-id.

De BroadWorks Enterprise Group Id kan worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Webex voor Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'spEnterpriseGroupId'

      • De BroadWorks Enterprise Group Id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek.

    • Flowthrough- of zelfactiveringsinrichting

      • BroadWorks-bedrijfs-groeps-id wordt automatisch opgehaald uit BroadWorks.

    • Gespreksgebruikers of -entiteiten met alleen BroadWorks

      • Niet van toepassing. Het is niet vereist om de BroadWorks Enterprise Group-id voor deze gebruikers te synchroniseren.

Tabel 3. Beheer van Enterprise Group ID op basis van inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Bedrijfs-groeps-id beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

BroadWorks-bedrijfs groep-id moet worden doorgegeven als parameter spEnterpriseGroupId

Doorstroomd

BroadWorks-bedrijfs groep-id wordt automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Niet van toepassing

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Niet van toepassing

BroadWorks-telefoonlijsten

Contactpersonen in de telefoonlijsten van de BroadWorks-groep

Synchroniseren met Directory

Groepscontacten worden opgeslagen in de Webex-contactservice die is gekoppeld aan de specifieke groep

Lijsten met BroadWorks-enterpsie of persional-telefoons

Contactpersonen in de lijsten met zakelijke of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing


 

Openbare API moet worden bijgewerkt VÓÓR de MIGRATIE. Migratie kan niet worden voltooid totdat DEZE API is voltooid. De BroadWorks Enterprise Group-id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek https://developer.webex.com/docs/api/changelog#2023-march

Nadat de functie is ingeschakeld en als gevolg van de volgende adreslijstsynchronisatie worden de bedrijfsgebruikersgroepen ook weergegeven in Control Hub. Het visualiseren van de groepen in Control Hub voor Webex voor BroadWorks is in dit stadium puur informatief. Partner- en klantbeheerders mogen geen wijzigingen aanbrengen aan groepen of groepslidmaatschap in Control Hub, omdat deze wijzigingen niet worden teruggekoppeld naar BroadWorks. Groepsbeheer in Control Hub is bedoeld voor gebruik door partners die de komende API's voor contactbeheer gaan gebruiken.

Migratie en toekomstbestendigheid

De progressie van Cisco van de BroadSoft Unified Communications Client is om van UC-One naar Webex te gaan. Er is een overeenkomstige progressie van de ondersteunende services weg van het netwerk van serviceproviders – behalve bellen – naar het Webex-cloudplatform.

Of u nu UC-One SaaS of BroadWorks Collaborate gebruikt, de voorkeursmigratiestrategie is het implementeren van nieuwe, speciale XSP|ADP's voor integratie met Webex voor Cisco BroadWorks. U kunt de twee services parallel uitvoeren terwijl u klanten migreert naar Webex en uiteindelijk de infrastructuur terugverdienen die is gebruikt voor de vorige oplossing.

Aanbevolen documentabonnementen

Webex Help Center-artikelen (op help.webex.com) hebben een optie Abonneren waarmee u een e-mailmelding kunt ontvangen wanneer dat artikel wordt bijgewerkt.

We raden u aan u te abonneren op elk van de volgende artikelen om ervoor te zorgen dat u geen kritieke updates mist die van invloed zijn op de netwerkverbinding. Om u in te schrijven, gaat u naar elk van de onderstaande links en klikt u in het artikel dat wordt gelanceerd op de knop Subscribe.

We raden u aan om u minimaal in te schrijven voor bovenstaande lijst. De meeste Webex-artikelen en -documenten die worden vermeld onder Aanvullende documenten hebben echter een optie Abonneren. Als deze optie moet worden weergegeven, moet het artikel worden weergegeven op help.webex.com.


 
Er is geen abonnementsoptie voor landingspagina's van documentatie.

Aanvullende documenten

Raadpleeg de volgende gerelateerde documentatie voor meer informatie over Webex voor Cisco BroadWorks:

Webex voor Cisco BroadWorks-documenten

Partnerbeheerders kunnen de volgende documenten en sites gebruiken om informatie te verkrijgen over Webex voor Cisco BroadWorks.

Webex voor Cisco BroadWorks-artikelen

Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:

Cisco BroadWorks-documenten

Partnerbeheerders kunnen verwijzen naar de Cisco BroadWorks-site op cisco.com voor technische documenten die beschrijven hoe het Cisco BroadWorks-gedeelte van de oplossing moet worden geïmplementeerd:

Webex Help-artikelen

De volgende Webex Help-sites kunnen worden gebruikt om Webex-artikelen te vinden waarmee klantbeheerders en eindgebruikers Webex-functies kunnen gebruiken.

  • Webex van serviceproviders: deze landingspagina bevat koppelingen met informatie over aan de slag gaan en veelgebruikte artikelen voor gebruikers van de Webex-app die Webex-services hebben gekocht bij een serviceprovider.

  • Webex-helpcentrum: gebruik de zoekfunctie op help.webex.com om te zoeken naar aanvullende Webex-artikelen waarin de Webex-app en de Webex Meetings-functionaliteit worden beschreven. U kunt zoeken naar gebruikers- of beheerdersartikelen.

Documentatie voor ontwikkelaars

Uw omgeving voorbereiden

Beslissingspunten

Overweging Vragen om te beantwoorden Resources

Architectuur en infrastructuur

Hoeveel XSP|ADP’s?

Hoe nemen ze mTLS in?

Cisco BroadWorks-systeemcapaciteitsplanner

Technische handleiding voor Cisco BroadWorks-systemen

XSP|ADP CLI-referentie

Dit document

Klant- en gebruikersvoorzieningen

Kunt u bevestigen dat u e-mails vertrouwt in BroadWorks?

Wilt u dat gebruikers e-mailadressen opgeven om hun eigen accounts te activeren?

Kunt u tools maken om onze API te gebruiken?

Openbare API-documenten op https://developer.webex.com

Dit document

Branding Welke kleur en logo wilt u gebruiken? Brandingartikel van de Webex-app
Sjablonen Wat zijn uw verschillende gebruiksscenario's voor klanten? Dit document
Abonneefuncties per klant/onderneming/groep Kies een pakket om het serviceniveau per sjabloon te definiëren. Basic, Standard, Premium of Softphone.

Dit document

Functie-/pakketmatrix

Gebruikersverificatie BroadWorks of Webex Dit document
Inrichtingsadapter (voor flowthrough-inrichtingsopties)

Gebruikt u al geïntegreerde IM&P, bijv. voor UC-One SaaS?

Bent u van plan meerdere sjablonen te gebruiken?

Is er een meer voorkomende usecase voorzien?

Dit document

CLI-referentie toepassingsserver

Architectuur en infrastructuur

  • Met welke schaal gaat u beginnen? Het is mogelijk om in de toekomst op te schalen, maar uw huidige gebruiksinschatting zou de infrastructuurplanning moeten stimuleren.

  • Werk samen met uw Cisco-accountmanager/verkoopvertegenwoordiger om uw XSP|ADP-infrastructuur te vergroten, volgens de Cisco BroadWorks System Capacity Planner en de Cisco BroadWorks System Engineering Guide.

  • Hoe maakt Webex wederzijdse TLS-verbindingen met uw XSP|ADP's? Rechtstreeks naar de XSP|ADP in een DMZ, of via TLS-proxy? Dit is van invloed op uw certificaatbeheer en de URL's die u gebruikt voor de interfaces. (We ondersteunen geen ongecodeerde TCP-verbindingen met de rand van uw netwerk).

Klant- en gebruikersvoorzieningen

Welke gebruikersinrichtingsmethode past het beste bij u?

  • Flowthrough Provisioning Met Vertrouwde E-mails: Door de service 'Geïntegreerde IM&P' toe te wijzen op BroadWorks, wordt de abonnee automatisch ingericht in Webex.

    Als u ook kunt bevestigen dat de e-mailadressen van abonnees in BroadWorks geldig en uniek zijn voor Webex, kunt u de variant 'vertrouwde e-mail' van flowthrough-inrichting gebruiken. Webex-abonneeaccounts worden zonder hun tussenkomst gemaakt en geactiveerd. Ze downloaden gewoon de client en melden zich aan.

    E-mailadres is een belangrijk gebruikerskenmerk in Webex. Daarom moet de serviceprovider een geldig e-mailadres voor de gebruiker opgeven om deze in te richten voor Webex-services. Dit moet het e-mail-id-kenmerk van de gebruiker zijn in BroadWorks. We raden u aan deze ook te kopiëren naar het kenmerk Alternatieve id.

  • Flowthrough-inrichting zonder vertrouwde e-mails: Als u de e-mailadressen van abonnees niet kunt vertrouwen, kunt u nog steeds de geïntegreerde IM&P-service in BroadWorks toewijzen om gebruikers in Webex in te richten.

    Met deze optie worden de accounts gemaakt wanneer u de service toewijst, maar moeten de abonnees hun e-mailadressen opgeven en valideren om de Webex-accounts te activeren.

  • Zelfinrichting gebruiker: Voor deze optie is geen IM&P-servicetoewijzing in BroadWorks vereist. U (of uw klanten) distribueert in plaats daarvan een inrichtingskoppeling en de koppelingen om de verschillende clients te downloaden, met uw branding en instructies.

    Abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun Webex-accounts te maken en te activeren. Vervolgens downloaden ze de client en melden zich aan en haalt Webex een aantal extra configuraties over hen op vanuit BroadWorks (inclusief hun primaire nummers).

  • SP-beheerde inrichting via API's: Webex stelt een reeks openbare API's bloot waarmee serviceproviders gebruikersvoorzieningen/abonneevoorzieningen kunnen bouwen in hun bestaande workflows.

Inrichtingsvereisten

In de volgende tabel worden de vereisten voor elke inrichtingsmethode samengevat. Naast deze vereisten moet uw implementatie voldoen aan de algemene systeemvereisten die in deze handleiding worden beschreven.

Inrichtingsmethode

Vereisten

Doorstroominrichting

(Vertrouwde of niet-vertrouwde e-mails)

De Webex-provisioning-API voegt bestaande BroadWorks-gebruikers automatisch toe aan Webex zodra de gebruiker aan de vereisten voldoet en u de geïntegreerde IM+P-service inschakelt.

Er zijn twee stromen (vertrouwde e-mails of niet-vertrouwde e-mails) die u toewijst via de onboardsjabloon op Webex.

Vereisten voor BroadWorks:

  • Gebruiker bestaat in BroadWorks met een primair nummer of toestel.

  • De gebruiker krijgt de geïntegreerde IM+P-service toegewezen, die verwijst naar de URL van de Webex-inrichtingsservice.

  • Alleen vertrouwde e-mails. De gebruiker heeft een e-mailadres geconfigureerd in BroadWorks. We raden u aan om het e-mailadres ook toe te voegen aan het veld Alternatieve id, omdat de gebruiker zich op die manier kan aanmelden met BroadWorks-referenties.

  • BroadWorks heeft verplichte patches geïnstalleerd voor flowthrough-inrichting. Zie Vereiste patches met flowthrough-inrichting (hieronder) voor de patchvereisten.

  • BroadWorks AS is rechtstreeks verbonden met de Webex-cloud of de proxy van de inrichtingsadapter is geconfigureerd met verbinding met de URL van de Webex-inrichtingsservice.

    Zie Toepassingsserver configureren met inrichtingsservice-URL om de URL van de Webex-inrichtingsservice op te halen.

    Zie Cisco BroadWorks Implement Provisioning Adapter Proxy FD om de Provisioning Adapter Proxy te configureren.

Webex-vereisten:

Het onboardsjabloon bevat de volgende instellingen:

  • De schakelaar BroadWorks-flow via inrichting inschakelen is ingeschakeld.

  • De naam en het wachtwoord van het inrichtingsaccount worden toegewezen met de beheerdersreferenties op systeemniveau van BroadWorks

  • Gebruikersverificatie is ingesteld op Trust BroadWorks-e-mails of Niet-vertrouwde e-mails.

Zelfinrichting gebruiker

Beheerder biedt een bestaande BroadWorks-gebruiker een koppeling naar de portal voor gebruikersactivering. De gebruiker moet zich met de BroadWorks-referenties aanmelden bij de portal en een geldig e-mailadres opgeven. Nadat het e-mailadres is gevalideerd, haalt Webex aanvullende gebruikersinformatie op om de inrichting te voltooien.

Vereisten voor BroadWorks:

  • Gebruiker moet bestaan in BroadWorks met een primair nummer of toestel

Webex-vereisten:

Het onboardsjabloon bevat de volgende instellingen:

  • De schakelaar Flow Through Provisioning inschakelen is uitgeschakeld.

  • Gebruikersverificatie is ingesteld op Niet-vertrouwde e-mails.

  • Gebruikers toestaan zichzelf te activeren is ingeschakeld.

SP-beheerde inrichting via API

(Vertrouwde of niet-vertrouwde e-mails)

Webex toont een reeks openbare API's waarmee u gebruikersvoorzieningen kunt bouwen in uw bestaande werkstromen en tools. Er zijn twee stromen:

  • Vertrouwde e-mails: de API voorziet de gebruiker en past het BroadWorks-e-mailadres toe als het Webex-e-mailadres.

  • Niet-vertrouwde e-mails: de API voorziet in de gebruiker, maar de gebruiker moet zich aanmelden bij de User Activation Portal en een geldig e-mailadres opgeven.

Vereisten voor BroadWorks:

  • Gebruiker moet bestaan in BroadWorks met een primair nummer of toestel.

Webex-vereisten:

  • In de onboardsjabloon is de gebruikersverificatie ingesteld op Trust BroadWorks e-mails of Niet-vertrouwde e-mails.

  • U moet uw aanvraag registreren en hiervoor toestemming vragen.

  • U moet een OAuth-token aanvragen met de scopes die zijn gemarkeerd in het gedeelte 'Verificatie' van de Webex for BroadWorks-ontwikkelaarshandleiding.

  • Er moet een beheerder of inrichtingsbeheerder worden toegewezen aan uw partnerorganisatie.

Ga naar BroadWorks-abonnees om de API's te gebruiken.

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Ondersteunde taallandinstellingen

Tijdens het inrichten wordt de taal die in beheergebruiker is toegewezen aan de eerste ingerichte beheergebruiker automatisch toegewezen als de standaardlandinstelling voor die klantorganisatie. Deze instelling bepaalt de standaardtaal die wordt gebruikt voor activeringsmails, vergaderingen en uitnodigingen voor vergaderingen onder die klantorganisatie.

Taallandinstellingen met vijf tekens in (ISO-639-1)_(ISO-3166)-indeling worden ondersteund. en_VS komt bijvoorbeeld overeen met English_UnitedStates. Als er slechts een taal met twee letters wordt aangevraagd (in ISO-639-1-indeling), genereert de service een landinstelling met vijf tekens door de aangevraagde taal te combineren met een landcode uit de sjabloon, d.w.z. "requestedLanguage_CountryCode", als er geen geldige landinstelling kan worden verkregen, wordt de standaard verstandige landinstelling gebruikt op basis van de vereiste taalcode.

De volgende tabel bevat de ondersteunde landinstellingen en de toewijzing waarmee een taalcode van twee letters wordt omgezet in een landinstelling met vijf tekens voor situaties waarin een landinstelling met vijf tekens niet beschikbaar is.

Tabel 1. Ondersteunde taallandcodes

Ondersteunde taallandinstellingen

(ISO-639-1)_(ISO-3166)

Als er alleen een taalcode met twee letters beschikbaar is...

Taalcode (ISO-639-1) **

Gebruik in plaats daarvan Standaard verstandige landinstelling (ISO-639-1)_(ISO-3166)

en_VS

en_AU

en_GB

en_CA

en

en_VS

fr_vr

fr_CA

vr

fr_vr

cs_CZ, CZ

cs

cs_CZ, CZ

da_DK

da's, da's

da_DK

de_de

de

de_de

hu_HU

(aan)laars

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_NEE

nb

nb_NEE

pl_VERV.

verv.

pl_VERV.

pt_PT

pt_BR

pt

pt_PT

ru_ru

ru

ru_ru

ro_RO

ro

ro_RO

zh_CN

zh_TW

zweer

zh_CN

sv_SE

sv

sv_SE

ar_SA

ar, teken, teken

ar_SA

tr_TR

staartstuk

tr_TR


 

De landinstellingen es_CO, id_ID, nb_NO en pt_PT worden niet ondersteund door Webex Meeting-sites. Voor deze landinstellingen zijn De Webex Meetings-sites alleen in het Engels. Engels is de standaardlandinstelling voor sites als er geen/ongeldige/niet-ondersteunde landinstelling vereist is voor de site. Dit taalveld is van toepassing bij het maken van een organisatie- en Webex Meetings-site. Als er geen taal wordt vermeld in een bericht of in de API van de abonnee, wordt de taal van de sjabloon gebruikt als standaardtaal.

Branding

Partnerbeheerders kunnen geavanceerde merkaanpassingen gebruiken om aan te passen hoe de Webex app eruitziet voor de klantorganisaties die de partner beheert. Partnerbeheerders kunnen de volgende instellingen aanpassen om ervoor te zorgen dat de Webex -app het merk en de identiteit van hun bedrijf weerspiegelt:

  • Bedrijfslogo's

  • Unieke kleurenschema's voor de lichte modus of de donkere modus

  • Aangepaste ondersteunings-URL's

Meer informatie over het aanpassen van branding vindt u in Geavanceerde branding-aanpassingen configureren.


 
  • Aanpassingen voor basisbranding worden afgeschaft. We raden u aan Advanced Branding te implementeren, dat een breder scala aan aanpassingen biedt.

  • Voor meer informatie over hoe branding wordt toegepast bij het koppelen aan een bestaande klantorganisatie, raadpleegt u Voorwaarden van organisatiebijlage in het gedeelte Webex voor BroadWorks toevoegen aan bestaande organisatie.

Onboardingssjablonen

Met onboardsjablonen kunt u de parameters definiëren waarmee klanten en gekoppelde abonnees automatisch worden ingericht in Webex voor Cisco BroadWorks. U kunt indien nodig meerdere onboardsjablonen configureren, maar wanneer u een klant onboardt, is deze aan slechts één sjabloon gekoppeld (u kunt niet meerdere sjablonen op één klant toepassen).

Enkele van de primaire sjabloonparameters worden hieronder weergegeven.

Pakket

  • U moet een standaardpakket selecteren wanneer u een sjabloon aanmaakt (zie Pakketten in het gedeelte Overzicht voor meer informatie). Alle gebruikers die zijn ingericht met die sjabloon, hetzij door middel van flowthrough- of self-provisioning, ontvangen het standaardpakket.

  • U hebt controle over de pakketselectie voor verschillende klanten door meerdere sjablonen te maken en telkens verschillende standaardpakketten te selecteren. U kunt vervolgens verschillende inrichtingskoppelingen of verschillende inrichtingsadapters per onderneming distribueren, afhankelijk van de door u gekozen gebruikersinrichtingsmethode voor deze sjablonen.

  • U kunt het pakket met specifieke abonnees wijzigen vanaf deze standaard met behulp van de inrichtings-API (zie Webex voor Cisco BroadWorks API-documentatie of via Partner Hub (zie Gebruikerspakket wijzigen in Partner Hub).

  • U kunt het pakket van een abonnee niet wijzigen vanuit BroadWorks. De toewijzing van de geïntegreerde IM&P-service is in- of uitgeschakeld. Als de abonnee deze service in BroadWorks wordt toegewezen, definieert de Partner Hub-sjabloon die is gekoppeld aan de inrichtings-URL van de onderneming van die abonnee het pakket.

Doorverkoper en ondernemingen of serviceprovider en groepen?

  • De manier waarop uw BroadWorks-systeem is geconfigureerd, heeft invloed op de flow via inrichting. Als u een reseller bent met Enterprises, moet u de Enterprise-modus inschakelen wanneer u een sjabloon maakt.

  • Als uw BroadWorks-systeem is geconfigureerd in de serviceprovidermodus, kunt u de Enterprise-modus uitschakelen in uw sjablonen.

  • Als u van plan bent klantorganisaties in te richten met beide BroadWorks-modi, moet u verschillende sjablonen gebruiken voor groepen en bedrijven.


 
Zorg ervoor dat u de BroadWorks-patches hebt toegepast die vereist zijn voor doorstroominrichting. Zie Vereiste patches met doorstroominrichting voor meer informatie.

Verificatiemodus

Bepaal hoe u wilt dat abonnees zich verifiëren wanneer ze zich aanmelden bij Webex. U kunt de modus toewijzen met de instelling Verificatiemodus in de onboardingsjabloon. In de volgende tabel worden enkele opties beschreven.


 
Deze instelling heeft geen invloed op het aanmelden bij de User Activation Portal. Gebruikers die zich aanmelden bij de portal, moeten hun BroadWorks-gebruikers-id en -wachtwoord invoeren, zoals geconfigureerd in BroadWorks, ongeacht hoe u de verificatiemodus configureert in de onboardsjabloon.
VerificatiemodusBroadWorksWebex
Primaire gebruikersidentiteitBroadWorks-gebruikers-idE-mailadres
Identiteitsprovider

BroadWorks.

  • Als u een directe verbinding met BroadWorks configureert, wordt de Webex-app rechtstreeks geverifieerd bij de BroadWorks-server.

    Als u een directe verbinding wilt configureren, moet het selectievakje Directe BroadWorks-verificatie inschakelen zijn ingeschakeld in de BroadWorks-clusterconfiguratie op Partner Hub (de instelling is standaard uitgeschakeld).

  • Anders wordt verificatie naar BroadWorks mogelijk gemaakt via een intermediaire service die door Webex wordt gehost.

Cisco Common Identity
Meervoudige verificatie?NeeVereist Customer IdP die meervoudige verificatie ondersteunt.

Validatiepad gebruikergegevens

  1. Browser wordt gestart waarbij de gebruiker e-mail levert om de eerste aanmeldstroom te starten en de verificatiemodus te detecteren.

  2. De browser wordt vervolgens omgeleid naar een door Webex gehoste BroadWorks-aanmeldpagina (deze pagina is brandable)

  3. Gebruiker levert BroadWorks gebruikers-id en wachtwoord op de aanmeldpagina.

  4. Gebruikersreferenties worden gevalideerd met BroadWorks.

  5. Bij succes wordt een autorisatiecode verkregen van Webex. Dit wordt gebruikt om de benodigde toegangstokens voor Webex-services te verkrijgen.

  1. Browser wordt gestart waarbij de gebruiker e-mail levert om de eerste aanmeldstroom te starten en de verificatiemodus te detecteren.

  2. De browser wordt omgeleid naar IdP (Cisco Common Identity of Customer IdP), waar ze een aanmeldportal krijgen.

  3. Gebruiker levert de juiste aanmeldgegevens op de aanmeldpagina

  4. Verificatie met meerdere factoren kan plaatsvinden als de Customer IdP dit ondersteunt.

  5. Bij succes wordt een autorisatiecode verkregen van Webex. Dit wordt gebruikt om de benodigde toegangstokens voor Webex-services te verkrijgen.


 
Zie SSO-aanmeldstroom voor een gedetailleerder overzicht van de SSO-aanmeldstroom met directe verificatie naar BroadWorks.

UTF-8-codering met BroadWorks-verificatie

Met BroadWorks-verificatie raden we u aan UTF-8-codering voor de verificatiekoptekst te configureren. UTF-8 lost een probleem op dat zich kan voordoen met wachtwoorden die speciale tekens gebruiken waarbij de webbrowser de tekens niet goed codeert. Met behulp van een UTF-8-gecodeerde, basis 64-gecodeerde header lost dit probleem op.

U kunt UTF-8-codering configureren door een van de volgende CLI-opdrachten uit te voeren op de XSP of ADP:

  • XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

  • ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

Land

U moet een land selecteren wanneer u een sjabloon maakt. Dit land wordt automatisch toegewezen als het organisatieland voor alle klanten die zijn ingericht met de sjabloon in Common Identity. Daarnaast bepaalt het land van de organisatie de standaard internationale inbelnummers voor Cisco PSTN in Webex Meeting-sites.

De standaard internationale inbelnummers van de site worden ingesteld op het eerste beschikbare inbelnummer dat is gedefinieerd in het telefoniedomein op basis van het land van de organisatie. Als het land van de organisatie niet wordt gevonden in het inbelnummer dat is gedefinieerd in het telefoniedomein, wordt het standaardnummer van die locatie gebruikt.

Tabel 2. In de volgende tabel wordt de standaardlandcode voor inbellen weergegeven op basis van elke locatie:

S-nr.

Locatie

Landcode

Landnaam

1

AMER

+1

ONS, CA

2

APAC

+65

Singapore

3

ANUS, SCHEREN

+61

Australië

4

EMEA

+44

VK

5

EURO

+49

Duitsland

Regelingen voor meerdere partners

Gaat u Webex voor Cisco BroadWorks sublicentie geven aan een andere serviceprovider? In dit geval heeft elke serviceprovider een afzonderlijke partnerorganisatie nodig in Webex Control Hub om hen in staat te stellen de oplossing voor hun klantenbestand in te richten.

Inrichtingsadapter en sjablonen

Wanneer u flowthrough provisioning gebruikt, wordt de inrichtings-URL die u invoert in BroadWorks afgeleid van de sjabloon in Control Hub. U kunt meerdere sjablonen en dus meerdere inrichtings-URL's hebben. Hiermee kunt u per onderneming selecteren welk pakket u op abonnees wilt toepassen wanneer ze de geïntegreerde IM&P-service krijgen.

U moet overwegen of u een inrichtings-URL op systeemniveau wilt instellen als een standaardinrichtingspad en welke sjabloon u daarvoor wilt gebruiken. Op deze manier hoeft u alleen de inrichtings-URL expliciet in te stellen voor bedrijven die een andere sjabloon nodig hebben.

Houd er ook rekening mee dat u mogelijk al een inrichtings-URL op systeemniveau gebruikt, bijvoorbeeld met UC-One SaaS. Als dat het geval is, kunt u ervoor kiezen om de URL op systeemniveau te behouden voor het inrichten van gebruikers op UC-One SaaS en deze te overschrijven voor bedrijven die overstappen naar Webex voor Cisco BroadWorks. U kunt ook de andere kant op gaan en de URL op systeemniveau instellen voor Webex voor BroadWorks en de bedrijven die u wilt behouden op UC-One SaaS opnieuw configureren.

De configuratiekeuzes met betrekking tot deze beslissing worden beschreven in Toepassingsserver configureren met inrichtingsservice-URL.

Proxy inrichtingsadapter

Voor extra beveiliging kunt u met de Provisioning Adapter Proxy een HTTP(S)-proxy gebruiken op het Application Delivery Platform voor flowthrough-inrichting tussen de AS en Webex. De proxyverbinding maakt een end-to-end TCP-tunnel die verkeer tussen de AS en Webex doorgeeft, waardoor de AS geen directe verbinding met het openbare internet hoeft te maken. Voor veilige verbindingen kan TLS worden gebruikt.

Voor deze functie moet u de proxy instellen op BroadWorks. Zie voor meer informatie Beschrijving van de proxyfunctie van de Cisco BroadWorks-inrichtingsadapter.

Minimumvereisten

Accounts

Alle abonnees die u inricht voor Webex moeten bestaan in het BroadWorks-systeem dat u integreert met Webex. U kunt indien nodig meerdere BroadWorks-systemen integreren.

Alle abonnees moeten BroadWorks-licenties en een primair nummer of toestel hebben.

Webex gebruikt e-mailadressen als primaire id's voor alle gebruikers. Als u flowthrough-inrichting gebruikt met vertrouwde e-mails, moeten uw gebruikers geldige adressen hebben in het e-mailkenmerk in BroadWorks.

Als uw sjabloon BroadWorks-verificatie gebruikt, kunt u e-mailadressen van abonnees kopiëren naar het kenmerk Alternatieve id in BroadWorks. Hierdoor kunnen gebruikers zich aanmelden bij Webex met hun e-mailadressen en hun BroadWorks-wachtwoorden.

Uw beheerders moeten hun Webex-accounts gebruiken om zich aan te melden bij Partner Hub.


 
Het wordt niet ondersteund om een BroadWorks-beheerder te integreren in Webex voor Cisco BroadWorks. U kunt BroadWorks-bellende gebruikers met een primair nummer en/of toestel alleen onboarden. Als u flowthrough-inrichting gebruikt, moeten gebruikers ook de geïntegreerde IM&P-service krijgen toegewezen.

Servers in uw netwerk- en softwarevereisten

  • De BroadWorks-instantie(s) moet(en) ten minste de volgende servers bevatten:

    • Toepassingsserver (AS) met BroadWorks-versie zoals hierboven

    • Netwerkserver (NS)

    • Profielserver (PS)

  • Openbare XSP|ADP-server(s) of Application Delivery Platform (ADP) die aan de volgende vereisten voldoen:

    • Verificatieservice (BWAuth)

    • XSI-acties en -gebeurtenissen-interfaces

    • DMS (webapplicatie voor apparaatbeheer)

    • CTI-interface (intergratie van computertelefonie)

    • TLS 1.2 met een geldig certificaat (niet zelfondertekend) en vereiste tussenproducten. Vereist systeembeheerder om het opzoeken van bedrijven te vergemakkelijken.

    • Wederzijdse TLS-verificatie (mTLS) voor verificatieservice (vereist dat de openbare Webex-clientcertificaatketen als vertrouwensankers is geïnstalleerd)

    • Wederzijdse TLS-verificatie (mTLS) voor CTI-interface (vereist dat de openbare Webex-clientcertificaatketen als vertrouwensankers is geïnstalleerd)

  • Een afzonderlijke XSP/ADP-server die fungeert als een pushserver voor gespreksmeldingen (een NPS in uw omgeving die wordt gebruikt om gespreksmeldingen naar Apple/Google te pushen). We noemen het hier 'CNPS' om het te onderscheiden van de service in Webex die pushmeldingen voor berichten en aanwezigheid levert).

    Deze server moet op R22 of hoger zijn.

  • We mandaat een afzonderlijke XSP/ADP-server voor CNPS omdat de onvoorspelbaarheid van de belasting van Webex voor BWKS-cloudverbindingen een negatieve invloed kan hebben op de prestaties van de NPS-server, met als gevolg toenemende latentie van meldingen. Zie de Cisco BroadWorks System Engineering Guide voor meer informatie over de XSP|ADP-schaal.

Webex-app-platforms

Fysieke telefoons en accessoires

Apparaatintegratie

Zie de Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks voor meer informatie over het onboarden en gebruiken van OS- en MPP-apparaten in de serviceruimte voor Webex voor Cisco BroadWorks.

Apparaatprofielen

Hieronder staan de DTAF-bestanden die u op uw toepassingsservers moet laden om de Webex-app als een belclient te ondersteunen. Het zijn dezelfde DTAF-bestanden als gebruikt voor UC-One SaaS, maar er is een nieuwe config-wxt.xml.template bestand dat wordt gebruikt voor de Webex-app.

Als u de nieuwste apparaatprofielen wilt downloaden, gaat u naar de site van het Application Delivery Platform Software Downloads om de nieuwste DTAF-bestanden op te halen. Deze downloads werken voor zowel ADP als XSP.

Clientnaam

Type apparaatprofiel en pakketnaam

Webex Mobile-sjabloon

Type identiteit/apparaatprofiel: Verbinding maken - mobiel

DTAF: ucone-mobile-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Sjabloon voor Webex-tablet

Type identiteit/apparaatprofiel: Verbinding maken - tablet

DTAF: ucone-tablet-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Webex Desktop-sjabloon

Type identiteit/apparaatprofiel: Bedrijfscommunicator - PC

DTAF: ucone-desktop-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Identificeer/apparaatprofiel

Alle Webex voor Cisco BroadWorks-gebruikers moeten een Identity/Device Profile hebben toegewezen in BroadWorks dat een van de bovenstaande apparaatprofielen gebruikt om te bellen met de Webex-app. Het profiel biedt de configuratie waarmee de gebruiker gesprekken kan plaatsen.

OAuth-aanmeldgegevens voor uw Webex voor Cisco BroadWorks verkrijgen

Dien een serviceverzoek in bij uw onboardingagent of bij Cisco TAC om Cisco OAuth in te richten voor uw Cisco Identity Provider Federation-account.

Gebruik de volgende titel van het verzoek voor de respectieve functies:

  1. XSP|ADP AuthService Configuration' voor het configureren van de service op XSP|ADP.

  2. 'NPS-configuratie voor verificatie proxy instellen' om NPS te configureren voor het gebruik van de verificatieproxy.

  3. CI-gebruikers-UUID synchroniseren' voor CI-gebruikers-UUID synchroniseren. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.

  4. Configureer BroadWorks om Cisco-facturering voor BroadWorks en Webex Voor BroadWorks-abonnementen in te schakelen.

Cisco geeft u een OAuth-client-id, een clientgeheim en een vernieuwingstoken die 60 dagen geldig is. Als het token verloopt voordat u het gebruikt, kunt u een andere aanvraag indienen.


 

Als u al de referenties van de Cisco OAuth-identiteitsprovider hebt verkregen, voltooit u een nieuw serviceverzoek om uw referenties bij te werken.

Bestellingscertificaten

Certificaatvereisten voor TLS-verificatie

Voor alle vereiste toepassingen hebt u beveiligingscertificaten nodig, ondertekend door een bekende certificeringsinstantie en geïmplementeerd op uw openbare XSP|ADP's. Deze worden gebruikt om TLS-certificaatverificatie te ondersteunen voor alle inkomende verbindingen met uw XSP|ADP-servers.

Deze certificaten moeten uw XSP|ADP openbare volledig gekwalificeerde domeinnaam bevatten als algemene naam of alternatieve naam van het onderwerp.

De exacte vereisten voor het implementeren van deze servercertificaten zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt samengevat waar het door de CA ondertekende openbare servercertificaat in deze drie gevallen moet worden geladen:

De openbaar ondersteunde certificeringsinstanties die door de Webex-app worden ondersteund voor verificatie, worden weergegeven in Ondersteunde certificeringsinstanties voor hybride Webex-services.

Vereisten voor TLS-certificaat voor TLS-bridge Proxy

  • Het openbaar ondertekende servercertificaat wordt in de proxy geladen.

  • De proxy presenteert dit openbaar ondertekende servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • Een intern door een certificeringsinstantie ondertekend certificaat kan op de XSP|ADP worden geladen.

  • De XSP|ADP legt dit intern ondertekende servercertificaat voor aan de proxy.

  • De proxy vertrouwt de interne CA die het XSP|ADP-servercertificaat heeft ondertekend.

TLS-certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ

  • Het openbaar ondertekende servercertificaat wordt geladen in de XSP|ADP's.

  • De XSP|ADP's presenteren openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP|ADP's heeft ondertekend.

Aanvullende certificaatvereisten voor wederzijdse TLS-verificatie via de CTI-interface

Wanneer u verbinding maakt met de CTI-interface, presenteert Webex een clientcertificaat als onderdeel van wederzijdse TLS-verificatie. Het CA-/kettingcertificaat van het Webex-clientcertificaat kan worden gedownload via Control Hub.

Het certificaat downloaden:

Meld u aan bij Partner Hub en ga naar Instellingen > BroadWorks Calling en klik op de koppeling voor het downloaden van het certificaat.

De exacte vereisten voor het implementeren van deze Webex CA-certificaatketen zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

Het volgende diagram geeft een samenvatting van de certificaatvereisten in deze drie gevallen:

mTLS-certificaatuitwisseling voor CTI via verschillende Edge-configuraties

(Optie) Certificaatvereisten voor TLS-bridge Proxy

  • Webex presenteert een openbaar ondertekend clientcertificaat aan de proxy.

  • De proxy vertrouwt de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de vertrouwensopslag van de proxy. Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de proxy geladen.

  • De proxy presenteert het openbaar ondertekende servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • De volmachthebber legt een intern ondertekend clientcertificaat voor aan de XSP|ADP’s.

    Dit certificaat moet het uitbreidingsveld Extended Key Usage van x509.v3 bevatten met het BroadWorks-OID-doel 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS-clientAuth. Bijv.:

    X509v3 extensions:
        X509v3 Extended Key Usage:
            1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication

    De CN van het interne certificaat moet bwcticlient.webex.com.


     
    • Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

    • Openbare certificeringsinstanties zijn mogelijk niet bereid om certificaten te ondertekenen met het vereiste bedrijfseigen BroadWorks-OID. In het geval van een overbruggingsproxy moet u mogelijk een interne CA gebruiken om het clientcertificaat dat de proxy aanbiedt aan de XSP|ADP te ondertekenen.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP’s presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

  • De ClientIdentity van de toepassingsserver bevat de CN van het intern ondertekende clientcertificaat dat door de proxy wordt voorgelegd aan de XSP|ADP.

(Optie) Certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ

  • Webex presenteert een door een interne CA ondertekend Cisco-clientcertificaat aan de XSP|ADP's.

  • De XSP|ADP's vertrouwen de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de vertrouwensopslag van de proxy. Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de XSP|ADP's geladen.

  • De XSP|ADP's presenteren de openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP|ADP's heeft ondertekend.

  • De Application Server ClientIdentity bevat de algemene naam van het door Cisco ondertekende clientcertificaat dat door Webex wordt aangeboden aan de XSP|ADP.

Uw netwerk voorbereiden

Zie voor meer informatie over verbindingen die worden gebruikt door Webex voor Cisco BroadWorks: Netwerkvereisten voor Webex voor Cisco BroadWorks. Dit artikel bevat de lijst met IP-adressen, poorten en protocollen die vereist zijn om de ingress- en egress-regels van uw firewall te configureren.

Netwerkvereisten voor Webex-services

De voorgaande firewalltabellen met ingress- en exress-regels documenteren alleen de verbindingen die specifiek zijn voor Webex voor Cisco BroadWorks. Zie Netwerkvereisten voor Webex-services voor algemene informatie over verbindingen tussen de Webex-app en de Webex-cloud. Dit artikel is algemeen voor Webex, maar in de volgende tabel worden de verschillende gedeelten van het artikel aangegeven en wordt aangegeven hoe relevant elk gedeelte is voor Webex voor Cisco BroadWorks.

Tabel 3. Netwerkvereisten voor verbindingen met de Webex-app (algemeen)

Deel van artikel over netwerkvereisten

Relevantie van informatie

Overzicht van door Webex ondersteunde apparaattypen en protocollen

Informatief

Transportprotocollen en versleutelingscodes voor cloudgeregistreerde Webex-apps en -apparaten

Informatief

Webex-services - Poortnummers en protocollen

Moet gelezen worden

IP-subnetten voor Webex-mediaservices

Moet gelezen worden

Domeinen en URL's die toegankelijk moeten zijn voor Webex-services

Moet gelezen worden

Aanvullende URL's voor hybride Webex-services

Optioneel

Proxyfuncties

Optioneel

802.1X: netwerktoegangsbeheer op basis van poorten

Optioneel

Netwerkvereisten voor SIP-gebaseerde Webex-services

Optioneel

Netwerkvereisten voor Webex Edge Audio

Optioneel

Een overzicht van andere hybride Webex-services en documentatie

Optioneel

Webex-services voor FedRAMP-klanten

N.v.t.

Aanvullende informatie

Zie Firewall-whitepaper van de Webex-app (PDF) voor meer informatie.

Ondersteuning voor redundantie van BroadWorks

De Webex-cloudservices en de Webex-clientapps die toegang moeten krijgen tot het netwerk van de partner ondersteunen volledig de Broadworks XSP|ADP-redundantie die door de partner wordt geboden. Wanneer een XSP|ADP of site niet beschikbaar is voor gepland onderhoud of ongeplande reden, kunnen de Webex-services en -apps doorschakelen naar een andere XSP|ADP of site die door de partner wordt geleverd om een verzoek te voltooien.

Netwerktopologie

De Broadworks XSP|ADP's kunnen rechtstreeks op het internet worden geïmplementeerd of kunnen zich in een DMZ bevinden met een load balancing-element zoals de F5 BIG-IP. Om geo-redundantie te bieden, kunnen de XSP|ADP's worden geïmplementeerd in twee (of meer) datacenters, elk met een load balancer, elk met een openbaar IP-adres. Als de XSP|ADP's zich achter een load balancer bevinden, zien de Webex-microservices en -app alleen het IP-adres van de load balancer en lijkt Broadworks slechts één XSP|ADP te hebben, zelfs als er meerdere XSP|ADP's achter zitten.

In het onderstaande voorbeeld worden de XSP|ADP's geïmplementeerd op twee sites, Site A en Site B. Op elke site zijn er twee XSP|ADP's, voorafgegaan door een lastbalancer. Site A heeft XSP|ADP1 en XSP|ADP2 voor LB1, en Site B heeft XSP|ADP3 en XSP|ADP4 voor LB2. Alleen de lastbalancers worden op het openbare netwerk weergegeven en de XSP|ADP's bevinden zich in de privénetwerken van DMZ.

Webex-cloudservices

DNS-configuratie

De microservices van Webex Cloud moeten de Broadworks XSP|ADP-server(s) kunnen vinden om verbinding te maken met de Xsi-interfaces, de verificatieservice en CTI.

Webex Cloud-microservices voeren DNS A/AAAA-zoekopdrachten uit voor de geconfigureerde XSP|ADP-hostnaam en maken verbinding met het geretourneerde IP-adres. Dit kan een load balancing edge-element zijn, of de XSP|ADP-server zelf. Als er meerdere IP-adressen worden geretourneerd, wordt het eerste IP in de lijst geselecteerd. SRV-zoekopdrachten worden momenteel niet ondersteund.

Voorbeeld: De DNS van de partner A Record voor ontdekking van Round-Robin gebalanceerde internet-gerichte XSP|ADP-server/load balancers.

Recordtype

Naam

Doel

Doel

A

webex-cloud-xsp.example.com

198.51.100.48

Verwijst naar LB1 (Site A)

A

webex-cloud-xsp.example.com

198.51.100.49

Verwijst naar LB2 (Site B)


 

Elke verwijzing naar XSP omvat XSP of ADP.

Failover

Wanneer de Webex-microservices een verzoek naar de XSP|ADP/Load Balancer verzenden en het verzoek mislukt, kunnen er verschillende dingen gebeuren:

  • Als de fout te wijten is aan een netwerkfout (bv.: TCP, SSL) markeren de Webex-microservices het IP als geblokkeerd en voeren ze onmiddellijk een route door naar het volgende IP.

  • Als er een foutcode (HTTP 5xx) wordt geretourneerd, markeren de Webex-microservices het IP als geblokkeerd en voeren ze onmiddellijk een route door naar het volgende IP.

  • Als er binnen 2 seconden geen HTTP-reactie wordt ontvangen, time-out van het verzoek en de Webex-microservices markeren het IP als geblokkeerd en voeren een route door naar het volgende IP.

Elk verzoek wordt 3 keer geprobeerd voordat een storing wordt teruggekoppeld naar de microservice.

Wanneer een IP in de geblokkeerde lijst staat, wordt het niet opgenomen in de lijst met adressen die moet worden geprobeerd bij het verzenden van een aanvraag naar een XSP|ADP. Na een vooraf bepaalde tijdsperiode verloopt een geblokkeerd IP en gaat het terug naar de lijst om te proberen wanneer een ander verzoek wordt gedaan.

Als alle IP-adressen zijn geblokkeerd, probeert de microservice de aanvraag nog steeds te verzenden door willekeurig een IP-adres te selecteren in de geblokkeerde lijst. Als dit is gelukt, wordt dat IP-adres verwijderd uit de geblokkeerde lijst.

Status

De status van de verbinding van de Webex-cloudservices met de XSP|ADP's of load balancers is te zien in Control Hub. Onder een BroadWorks-gesprekscluster wordt een verbindingsstatus weergegeven voor elk van deze interfaces:

  • XSI-acties

  • XSI-gebeurtenissen

  • Verificatieservice

De verbindingsstatus wordt bijgewerkt wanneer de pagina wordt geladen of tijdens invoerupdates. De verbindingsstatussen kunnen zijn:

  • Groen: Wanneer de interface kan worden bereikt op een van de IP's in Een recordzoekopdracht.

  • Rood: Wanneer alle IP's in de A-recordzoekopdracht niet bereikbaar zijn en de interface niet beschikbaar is.

De volgende services gebruiken de microservices om verbinding te maken met de XSP|ADP's en worden beïnvloed door de beschikbaarheid van de XSP|ADP-interface:

  • Aanmelden bij Webex-app

  • Token voor Webex-app vernieuwen

  • Niet-vertrouwde e-mail/zelfactivering

  • Gezondheidscontrole van Broadworks-service

Webex-app

DNS-configuratie

De Webex-app heeft toegang tot de services Xtended Services Interface (XSI-acties en XSI-gebeurtenissen) en Device Management Service (DMS) op de XSP|ADP.

Om de XSI-service te vinden, voert de Webex-app DNS SRV-zoekopdrachten uit voor _xsi-client._tcp.<webex app xsi domain>. De SRV verwijst naar de geconfigureerde URL voor de XSP|ADP-hosts of load balancers voor de XSI-service. Als SRV-zoekopdrachten niet beschikbaar zijn, keert de Webex-app terug naar A/AAAA-zoekopdrachten.

De SRV kan overschakelen op meerdere A/AAAA-doelen. Elke A/AAAA-record moet echter alleen naar één IP-adres worden toegewezen. Als er meerdere XSP|ADP's in een DMZ achter het load balancer/edge-apparaat zijn, moet de load balancer worden geconfigureerd om de sessiepersistentie te behouden en alle verzoeken van dezelfde sessie naar dezelfde XSP|ADP te routeren. We machtigen deze configuratie omdat de XSI-event heartbeats van de client naar dezelfde XSP|ADP moeten gaan die wordt gebruikt om het gebeurteniskanaal op te zetten.


 

In voorbeeld 1 bestaat de A/AAAA-record voor webex-app-XSP|ADP.example.com niet en hoeft deze niet te worden gebruikt. Als uw DNS vereist dat één A/AAAA-record moet worden gedefinieerd, mag slechts 1 IP-adres worden geretourneerd. De SRV moet echter nog steeds worden gedefinieerd voor de Webex-app.

Als de Webex-app de A/AAAA-naam gebruikt die wordt omgezet naar meer dan één IP-adres, of als het load balancer/edge-element geen sessiepersistentie handhaaft, verzendt de client uiteindelijk heartbeats naar een XSP|ADP waar het geen gebeurteniskanaal tot stand heeft gebracht. Dit resulteert in het afbreken van het kanaal en ook in aanzienlijk meer intern verkeer, wat de prestaties van uw XSP|ADP-cluster belemmert.

Omdat de Webex-cloud en de Webex-app verschillende vereisten hebben voor het opzoeken van A/AAAA-opnamen, moet u een afzonderlijke FQDN gebruiken voor toegang tot uw XSP|ADP's voor de Webex-cloud en de Webex-app. Zoals in de voorbeelden wordt weergegeven, gebruikt Webex Cloud Een record webex-cloud-xsp.example.com en de Webex-app gebruikt SRV _xsi-client._tcp.webex-app-xsp.example.com.

Voorbeeld 1: meerdere XSP|ADP's, elk achter afzonderlijke lastbalancers

In dit voorbeeld wijst de SRV naar A-records met elk Een record die naar een andere lastbalancer op een andere locatie wijzen. De Webex-app gebruikt altijd het eerste IP-adres in de lijst en gaat alleen naar de volgende record als de eerste is uitgeschakeld.

Hieronder vindt u een voorbeeld van SRV-records.

Recordtype

Opnemen

Doel

Doel

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc1.example.com

Clientdetectie van Xsi-interface

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc2.example.com

Clientdetectie van Xsi-interface

A

xsp-dc1.example.com

198.51.100.48

Verwijst naar LB1 (site A)

A

xsp-dc2.example.com

198.51.100.49

Punten naar LB2 (site B)

Voorbeeld 2: meerdere XSP|ADP's achter één lastbalancer (met TLS-brug)

Voor het eerste verzoek selecteert de load balancer een willekeurige XSP|ADP. XSP|ADP retourneert een cookie dat de Webex-app in toekomstige verzoeken bevat. Voor toekomstige verzoeken gebruikt de load balancer de cookie om de verbinding naar de juiste XSP|ADP te routeren, zodat het gebeurteniskanaal niet wordt verbroken.

Recordtype

Opnemen

Doel

Doel

SRV

_xsi-client._tcp.webex-app-xsp.example.com

LB.example.com

Lastbalancer

A

LB.voorbeeld.com

198.51.100.83

IP-adres van load balancer (XSP|ADP's bevinden zich achter load balancer)

URL DMS

Tijdens het aanmeldproces haalt de Webex-app ook de DMS-URL op om het configuratiebestand te downloaden. De host in de URL wordt geparseerd en de Webex-app voert DNS A/AAAA-zoekopdrachten uit van de host om verbinding te maken met de XSP|ADP die de DMS-service host.

Voorbeeld: DNS Een record voor het ontdekken van Round-Robin gebalanceerde internet-gerichte XSP|ADP-server/load balancers door de Webex-app om configuratiebestanden te downloaden via DMS:

Recordtype

Naam

Doel

Doel

A

xsp-dms.example.com

198.51.100.48

Verwijst naar LB1 (site A)

A

xsp-dms.example.com

198.51.100.49

Punten naar LB2 (site B)


 
Elke verwijzing naar XSP omvat XSP of ADP.
Hoe de Webex-app XSP|ADP-adressen vindt

De client probeert de XSP|ADP-knooppunten te vinden met behulp van de volgende DNS-flow:

  1. De client haalt aanvankelijk URL's voor Xsi-acties/Xsi-Events op uit de Webex-cloud (u hebt deze ingevoerd bij het maken van het gekoppelde BroadWorks-gesprekscluster). De Xsi-hostnaam/het Xsi-domein wordt geparseerd vanaf de URL en de client voert de SRV-zoekopdracht als volgt uit:

    1. De client voert een SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">

    2. Als de SRV-zoekopdracht een of meer A/AAAA-doelen retourneert:

      1. De client zoekt A/AAAA op voor deze doelen en slaat de geretourneerde IP-adressen in de cache.

      2. De client maakt verbinding met een van de doelen (en dus de A/AAAA-record met één IP-adres) op basis van de SRV-prioriteit, vervolgens het gewicht (of willekeurig als ze allemaal gelijk zijn).

    3. Als de SRV-zoekopdracht geen doelen retourneert:

      De client zoekt A/AAAA op van de Xsi-hoofdparameter en probeert vervolgens verbinding te maken met het geretourneerde IP-adres. Dit kan een load balancing edge-element zijn, of de XSP|ADP-server zelf.

      Zoals vermeld, moet de A/AAAA-record om dezelfde redenen worden omgezet naar één IP-adres.

  2. (Optioneel) U kunt vervolgens aangepaste XSI-acties/XSI-gebeurtenissen opgeven in de apparaatconfiguratie voor de Webex-app, met behulp van de volgende tags:

    <protocols>
    	<xsi>
    		<paths>
    			<root>%XSI_ROOT_WXT%</root>
    			<actions>%XSI_ACTIONS_PATH_WXT%</actions>
    			<events>%XSI_EVENTS_PATH_WXT%</events>
    		</paths>
    	</xsi>
    </protocols>
    1. Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.

    2. Als deze bestaan, vergelijkt de client met het oorspronkelijke XSI-adres dat hij heeft ontvangen via de BroadWorks-clusterconfiguratie.

    3. Als er een verschil wordt gedetecteerd, initialiseert de client de XSI-acties/ XSI Events-verbinding opnieuw. De eerste stap hierin is om hetzelfde DNS-opzoekproces uit te voeren dat wordt vermeld onder stap 1. Dit keer wordt een zoekopdracht aangevraagd voor de waarde in de parameter %XSI_ROOT_WXT% vanuit het configuratiebestand.


       
      Zorg ervoor dat u de bijbehorende SRV-records maakt als u deze tag gebruikt om de Xsi-interfaces te wijzigen.
Failover

Tijdens het aanmelden voert de Webex-app een DNS SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">, stelt een lijst met hosts op en maakt verbinding met een van de hosts op basis van de SRV-prioriteit en vervolgens het gewicht. Deze verbonden host wordt de geselecteerde host voor alle toekomstige aanvragen. Er wordt vervolgens een gebeurteniskanaal geopend voor de geselecteerde host en er wordt regelmatig een hartslag verzonden om het kanaal te verifiëren. Alle aanvragen die na de eerste worden verzonden, bevatten een cookie dat wordt geretourneerd in de HTTP-respons. Daarom is het belangrijk dat de load balancer de sessiepersistentie (affiniteit) behoudt en altijd aanvragen naar dezelfde backend XSP|ADP-server verzendt.

Als een verzoek of een heartbeat-verzoek aan een host mislukt, kunnen er verschillende dingen gebeuren:

  • Als de fout het gevolg is van een netwerkfout (bijv. TCP, SSL) gaat de route van de Webex-app onmiddellijk door naar de volgende host in de lijst.

  • Als er een foutcode (HTTP 5xx) wordt geretourneerd, markeert de Webex-app dat IP-adres als geblokkeerd en leidt deze door naar de volgende host in de lijst.

  • Als er niet binnen een bepaalde periode een reactie wordt ontvangen, wordt het verzoek als mislukt beschouwd vanwege een time-out en worden de volgende verzoeken naar de volgende host verzonden. Het time-outverzoek wordt echter als mislukt beschouwd. Sommige verzoeken worden opnieuw geprobeerd na een fout (met toenemende tijd voor opnieuw proberen). De verzoeken om het veronderstelde niet-vitale niet opnieuw te proberen.

Wanneer een nieuwe host is geprobeerd, wordt deze de nieuwe geselecteerde host als de host aanwezig is in de lijst. Nadat de laatste host in de lijst is geprobeerd, rolt de Webex-app over naar de eerste.

In het geval van heartbeat, als er twee opeenvolgende mislukte verzoeken zijn, initialiseert de Webex-app het gebeurteniskanaal opnieuw.

Houd er rekening mee dat de Webex-app geen fail-back uitvoert en dat DNS-servicedetectie slechts één keer wordt uitgevoerd bij het aanmelden.

Tijdens het aanmelden probeert de Webex-app het configuratiebestand te downloaden via de XSP|ADP/Dms-interface. Het voert een A/AAAA-recordzoekopdracht uit van de host in de opgehaalde DMS-URL en maakt verbinding met het eerste IP. Eerst wordt geprobeerd het verzoek om het configuratiebestand te downloaden te verzenden met een SSO-token. Als dit om welke reden dan ook mislukt, wordt het opnieuw geprobeerd, maar wel met de gebruikersnaam en het wachtwoord van het apparaat.

Webex voor BroadWorks implementeren

Implementatieoverzicht

De volgende diagrammen geven de typische volgorde van uw implementatietaken weer voor de verschillende gebruikersinrichtingsmodi. Veel van de taken zijn gemeenschappelijk voor alle inrichtingsmodi.

Toont de volgorde van de taken die vereist zijn voor het implementeren van Webex voor BroadWorks met doorstroominrichting en vertrouwde e-mails
Taken vereist voor het implementeren van doorstroominrichting
Toont de volgorde van de taken die vereist zijn voor het implementeren van Webex voor BroadWorks met doorstroominrichting zonder e-mails
Taken vereist voor het implementeren van flowthrough-inrichting zonder vertrouwde e-mails
Toont de volgorde van de taken die vereist zijn voor het implementeren van Webex voor BroadWorks met zelfactivering
Taken vereist voor het implementeren van zelfinrichting van gebruikers

Onboarding van partners voor Webex voor Cisco BroadWorks

Elke Webex voor Cisco BroadWorks-serviceprovider of -reseller moet worden ingesteld als een partnerorganisatie voor Webex voor Cisco BroadWorks. Als u een bestaande Webex-partnerorganisatie hebt, kan dit worden gebruikt.

Om de noodzakelijke onboarding te voltooien, moet u uw Webex Cisco BroadWorks-papierwerk uitvoeren en moeten nieuwe partners de online overeenkomst voor indirecte kanaalpartners (ICPA) accepteren. Wanneer deze stappen zijn voltooid, maakt Cisco Compliance een nieuwe partnerorganisatie in Partner Hub (indien nodig) en verzendt een e-mail met verificatiegegevens naar de beheerder van uw administratie. Tegelijkertijd zal uw Partner Activation en/of Customer Success Program Manager contact met u opnemen om uw onboarding te starten.

Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's

We vereisen dat de NPS-toepassing op een andere XSP|ADP wordt uitgevoerd. Vereisten voor die XSP|ADP worden beschreven in Gespreksmeldingen configureren vanuit uw netwerk.

U hebt de volgende toepassingen/services nodig op uw XSP|ADP's.

Service/toepassing

Verificatie vereist

Doel van de dienst/toepassing

Xsi-gebeurtenissen

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, servicemeldingen

Xsi-acties

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, acties

Apparaatbeheer

TLS (server verifieert zichzelf bij clients)

Configuratie voor bellen downloaden

Verificatieservice

TLS (server verifieert zichzelf bij clients)

Gebruikersverificatie

Integratie van computertelefonie

mTLS (client en server verifiëren elkaar)

Telefonieaanwezigheid

Webview-toepassing voor gespreksinstellingen

TLS (server verifieert zichzelf bij clients)

Stelt gespreksinstellingen van gebruikers bloot in de selfcare-portal in de Webex-app

In dit gedeelte wordt beschreven hoe u de vereiste configuraties voor TLS en mTLS op deze interfaces kunt toepassen, maar u moet de bestaande documentatie raadplegen om de toepassingen op uw XSP|ADP's te laten installeren.

Vereisten co-residentie

  • De verificatieservice moet co-resident zijn met Xsi-toepassingen, omdat deze interfaces langdurige tokens voor serviceautorisatie moeten accepteren. De verificatieservice is vereist om deze tokens te valideren.

  • De verificatieservice en Xsi kunnen indien nodig op dezelfde poort worden uitgevoerd.

  • U kunt de andere services/toepassingen scheiden zoals vereist voor uw weegschaal (bijvoorbeeld dedicated device management XSP|ADP farm).

  • U kunt de Xsi-, CTI-, Authenticatieservice- en DMS-toepassingen co-lokaliseren.

  • Installeer geen andere toepassingen of services op de XSP|ADP's die worden gebruikt voor de integratie van BroadWorks met Webex.

  • Zoek de NPS-toepassing niet samen met andere toepassingen.

Xsi-interfaces

Installeer en configureer de Xsi-Actions- en Xsi-Events-toepassingen zoals beschreven in de Configuratiehandleiding voor Cisco BroadWorks Xtended Services Interface.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Voor alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moet dezelfde callControlApplicationName zijn gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker is geïntegreerd in Webex, maakt Webex een abonnement voor de gebruiker op de AS om telefoniegebeurtenissen te ontvangen voor aanwezigheid en gespreksgeschiedenis. Het abonnement is gekoppeld aan de callControlApplicationName en de AS gebruikt het om te weten naar welke Xsi-Events de telefonie-gebeurtenissen moeten worden verzonden.


 

Het wijzigen van de callControlApplicationName of het niet hebben van dezelfde naam op alle Xsi-Events-webapps zal invloed hebben op abonnementen en telefonie gebeurtenissen functionaliteit.

Verificatieservice configureren (met CI-tokenvalidatie)

Gebruik deze procedure om de verificatieservice te configureren voor het gebruik van CI-tokenvalidatie met TLS. Deze verificatiemethode wordt aanbevolen als u R22 of hoger gebruikt en uw systeem deze ondersteunt.


 

Wederzijdse TLS (mTLS) wordt ook ondersteund als een alternatieve verificatiemethode voor de verificatieservice. Als u meerdere Webex-organisaties op dezelfde XSP|ADP-server hebt uitgevoerd, moet u mTLS-verificatie gebruiken omdat CI-tokenvalidatie niet meerdere verbindingen met dezelfde XSP|ADP-verificatieservice ondersteunt.

Als u mTLS-verificatie wilt configureren voor de verificatieservice in plaats van CI-tokenvalidatie, raadpleegt u de bijlage voor Services configureren (met mTLS voor de verificatieservice).


 
Als u momenteel mTLS gebruikt voor de verificatieservice, is het niet verplicht om opnieuw te configureren voor het gebruik van CI-tokenvalidatie met TLS.
  1. Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.

  2. Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw versie:


     
    Elke verwijzing naar XSP omvat XSP of ADP.
  3. Installeer de AuthenticationService toepassing op elke XSP|ADP-service.

    1. Voer de volgende opdracht uit om de AuthenticationService-toepassing op de XSP|ADP te activeren op het contextpad /authService.

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
    2. Voer deze opdracht uit om de AuthenticationService te implementeren op de XSP|ADP:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
  4. Vanaf Broadworks build 2022.10 worden de certificerende autoriteiten die met Java komen niet meer automatisch opgenomen in de BroadWorks-vertrouwensopslag wanneer wordt overgeschakeld naar een nieuwe versie van java. De AuthenticationService opent een TLS-verbinding met Webex om het toegangstoken op te halen en moet het volgende in de truststore hebben om de IDBroker- en Webex-URL te valideren:

    • IdenTrust commercieel hoofd-CA 1

    • GoDaddy Root Certification Authority - G2

    Controleer of deze certificaten aanwezig zijn onder de volgende CLI

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

    Als dit niet aanwezig is, voert u de volgende opdracht uit om de standaard Java-trusts te importeren:

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

    U kunt deze certificaten ook handmatig toevoegen als vertrouwensankers met de volgende opdracht:

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

    Als de ADP is geüpgraded vanaf een vorige release, worden de certificeringsinstanties van de oude release automatisch geïmporteerd naar de nieuwe release en blijven ze geïmporteerd totdat ze handmatig worden verwijderd.


     

    De toepassing AuthenticationService is vrijgesteld van de instelling validatePeerIdentity onder ADP_CLI/System/SSLCommonSettings/GeneralSettings en valideert altijd de peer Identity. Zie de Cisco Broadworks X509 Certificate Validation FD voor meer informatie over deze instelling.

  5. Configureer de identiteitsproviders door de volgende opdrachten uit te voeren op elke XSP|ADP-server:

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

    • set clientId client-Id-From-Step1

    • set enabled true

    • set clientSecret client-Secret-From-Step1

    • set ciResponseBodyMaxSizeInBytes 65536

    • set issuerName <URL> —Voor de URL voer de URL van de IssuerName in die van toepassing is op uw CI-cluster. Zie volgende tabel.

    • set issuerUrl <URL> —Voor de URL voer de IssuerUrl in die van toepassing is op uw CI-cluster. Zie de volgende tabel.

    • set tokenInfoUrl <IdPProxy URL> —Voer de IdP-proxy-URL in die van toepassing is op uw Teams-cluster. Zie de tweede tabel die volgt.

    Tabel 1. Naam en URL van uitgever instellen
    Als CI-cluster is...Naam en URL van uitgever instellen op...

    US-A

    https://idbroker.webex.com/idb

    EU

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

    US-B

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


     
    Als u uw CI-cluster niet kent, kunt u de informatie verkrijgen via de klantgegevens in de helpdeskweergave van Control Hub.
    Tabel 2. TokenInfoURL instellen
    Als het Teams-cluster...TokenInfoURL instellen op... (IdP proxy-URL)

    ACHM, WATERPIJP

    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

    AASAPPEL

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


     
    • Als u uw Teams-cluster niet kent, kunt u de informatie verkrijgen via de klantgegevens in de helpdeskweergave van Control Hub.

    • Voor tests kunt u controleren of de tokenInfoURL geldig is door de " idp/authenticate" gedeelte van de URL met " ping".

  6. Geef de Webex-rechten op die aanwezig moeten zijn in het gebruikersprofiel in Webex door de volgende opdracht uit te voeren:

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

  7. Configureer identiteitsproviders voor Cisco Federation met de volgende opdrachten op elke XSP|ADP-server:

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

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

    • set refreshPeriodInMinutes 60

    • set refreshToken refresh-Token-From-Step1

  8. Voer de volgende opdracht uit om te valideren dat uw FLS-configuratie werkt. Met deze opdracht keert u de lijst met identiteitsproviders terug:

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

  9. Configureer Tokenbeheer met de volgende opdrachten op elke XSP|ADP-server:

    • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

    • set tokenIssuer BroadWorks

    • set tokenDurationInHours 720

  10. RSA-sleutels genereren en delen. U moet sleutels genereren op één XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's. Dit is te wijten aan de volgende factoren:

    • U moet dezelfde openbare/privésleutelparen gebruiken voor tokencodering/decodering in alle instanties van de verificatieservice.

    • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet uitgeven.


     
    Als u met de toetsen gaat fietsen of de lengte van de toetsen wijzigt, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw starten.
    1. Selecteer één XSP|ADP om een sleutelpaar te genereren.

    2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen in de browser van de client:

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

      (Dit genereert een privaat/openbaar sleutelpaar op de XSP|ADP, als dat er nog niet was)

    3. De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:

      XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere .keys bestand indien nodig.

    5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

  11. Geef de authService-URL op aan de webcontainer. De webcontainer van de XSP|ADP heeft de authService-URL nodig zodat deze tokens kan valideren. Op elk van de XSP|ADP's:

    1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het communicatiehulpprogramma BroadWorks:

      XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

    2. Voeg de URL van de verificatieservice toe aan de container:

      XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

      Hiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.

    3. Controleer de parameter met get.

    4. Start de XSP|ADP opnieuw op.

Clientverificatievereiste voor verificatieservice verwijderen (alleen R24)

Als u de verificatieservice met CI-tokenvalidatie op R24 hebt geconfigureerd, moet u ook de clientverificatievereiste voor de verificatieservice verwijderen. Voer de volgende CLI-opdracht uit:

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

TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)

De toepassingen Verificatieservice, Xsi-acties en Xsi-Events maken gebruik van HTTP-serverinterfaces. De TLS-configureerbaarheidsniveaus voor deze toepassingen zijn als volgt:

Meest algemeen = Systeem > Transport > HTTP > HTTP Server interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit CLI-context
Systeem (globaal)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze veilig zijn en of ze clientverificatie vereisen.

Apache tomcat vereist een certificaat voor elke veilige interface; het systeem genereert een zelfondertekend certificaat als dit nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2-protocol toevoegen aan de HTTP-serverinterface

De HTTP-interface die communiceert met de Webex-cloud moet zijn geconfigureerd voor TLSv1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren in de interface van de HTTP-server:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken in de HTTP-serverinterface

De vereiste cijfers configureren:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de interface van de HTTP-server.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 in de interface van de HTTP-server gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver

Profielserver en XSP|ADP zijn verplicht voor apparaatbeheer. Ze moeten worden geconfigureerd volgens de instructies in de configuratiehandleiding voor BroadWorks-apparaatbeheer.

CTI-interface en gerelateerde configuratie

De configuratievolgorde 'maximaal' wordt hieronder weergegeven. Het volgen van deze bestelling is niet verplicht.

  1. Toepassingsserver configureren voor CTI-abonnementen

  2. XSP|ADP's configureren voor mTLS geverifieerde CTI-abonnementen

  3. Inkomende poorten openen voor veilige CTI-interface

  4. Abonneer uw Webex-organisatie op BroadWorks CTI-gebeurtenissen

Toepassingsserver configureren voor CTI-abonnementen

Werk de ClientIdentity op de toepassingsserver bij met de algemene naam (CN) van het Webex voor Cisco BroadWorks CTI-clientcertificaat.

Voeg voor elke toepassingsserver die u met Webex gebruikt de certificaatidentiteit als volgt toe aan de ClientIdentity:

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


 

De algemene naam van het Webex voor Cisco BroadWorks-clientcertificaat is bwcticlient.webex.com.

TLS en cijfers configureren op de CTI-interface

De configureerbaarheidsniveaus voor de XSP|ADP CTI-interface zijn als volgt:

Meest algemeen = Systeem > Transport > CTI Interfaces > CTI interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit

CLI-context

Systeem (globaal)

(R22 en hoger)

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

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

Transportprotocollen voor dit systeem

(R22 en hoger)

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

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

Alle CTI-interfaces op dit systeem

(R22 en hoger)

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

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

Een specifieke CTI-interface op dit systeem

(R22 en hoger)

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

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


 

Bij een nieuwe installatie worden de volgende versleutelingen standaard op systeemniveau geïnstalleerd. Als er niets is geconfigureerd op het interfaceniveau (bijvoorbeeld op de CTI-interface of HTTP-interface), is deze coderingslijst van toepassing. Houd er rekening mee dat deze lijst in de loop der tijd kan veranderen:

  • TLS_ECDHE_RSA_MET_AES_128_GCM_SHA256

  • TLS_ECDHE_ECDSA_MET_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_MET_AES_128_CBC_SHA256

  • TLS_ECDHE_ECDSA_MET_AES_128_CBC_SHA256

  • TLS_DHE_DSS_MET_AES_128_GCM_SHA256

  • TLS_DHE_RSA_MET_AES_128_GCM_SHA256

  • TLS_DHE_RSA_MET_AES_128_CBC_SHA256

  • TLS_DHE_DSS_MET_AES_128_CBC_SHA256

  • TLS_ECDH_RSA_MET_AES_128_GCM_SHA256

  • TLS_ECDH_ECDSA_MET_AES_128_GCM_SHA256

  • TLS_ECDH_RSA_MET_AES_128_CBC_SHA256

  • TLS_ECDH_ECDSA_MET_AES_128_CBC_SHA256

CTI TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze een servercertificaat vereisen en of ze clientverificatie vereisen.

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

TLS 1.2-protocol toevoegen aan de CTI-interface

De XSP|ADP CTI-interface die communiceert met de Webex-cloud moet worden geconfigureerd voor TLS v1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren op de CTI-interface:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken op de CTI-interface

De vereiste cijfers configureren voor de CTI-interface:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Voer de get opdracht om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> <cipherName> om een code toe te voegen aan de CTI-interface.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 naar de CTI-interface gebruikt u: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Vertrouwensankers voor CTI-interface (R22 en hoger)

Bij deze procedure wordt ervan uitgegaan dat de XSP|ADP's ofwel naar het internet gericht zijn ofwel naar het internet gericht zijn via pass-through proxy. De certificaatconfiguratie is anders voor een brugproxy (zie TLS-certificaatvereisten voor TLS-brugproxy).

Ga als volgt te werk voor elke XSP|ADP in uw infrastructuur die CTI-gebeurtenissen publiceert in Webex:

  1. Aanmelden bij Partnerhub .

  2. Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om CombinedCertChain2023.txt op uw lokale computer.


     

    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze uploadt naar de XSP|ADP's. Alle bestanden zijn vereist.

  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE----- en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één tekstblok bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt

  5. Meld u aan bij de XSP|ADP en ga naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Optioneel) Uitvoeren help updateTrust om de parameters en opdrachtindeling weer te geven.

  7. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 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


     

    Alle aliassen moeten een andere naam hebben. webexclientroot2023 en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang alle ingangen uniek zijn.

  8. Bevestig dat de ankers zijn bijgewerkt:

    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. Clients toestaan te verifiëren met certificaten:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

CTI-interface toevoegen en mTLS inschakelen

  1. Voeg de CTI SSL-interface toe.

    De CLI-context is afhankelijk van uw BroadWorks-versie. De opdracht maakt een zelfondertekend servercertificaat in de interface en dwingt de interface om een clientcertificaat te vereisen.

    • Op BroadWorks R22 en R23:

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

  2. Vervang het servercertificaat en de sleutel op de CTI-interfaces van XSP|ADP. U hebt hiervoor het IP-adres van de CTI-interface nodig; u kunt dit lezen uit de volgende context:

    • Op BroadWorks R22 en R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Voer vervolgens de volgende opdrachten uit om het zelfondertekende certificaat van de interface te vervangen door uw eigen certificaat en privésleutel:

      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. Start de XSP|ADP opnieuw op.

Toegang tot BroadWorks CTI-gebeurtenissen inschakelen in Webex

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters configureert in Partner Hub. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters configureert in Partner Hub. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

  • Geef het CTI-adres op waarmee Webex zich kan abonneren op BroadWorks CTI Events.

  • CTI-abonnementen zijn per abonnee en worden alleen ingesteld en onderhouden terwijl die abonnee is ingericht voor Webex voor Cisco BroadWorks.

Webweergave Gespreksinstellingen

Call Settings Webview (CSWV) is een toepassing die wordt gehost op XSP|ADP zodat gebruikers hun BroadWorks-gespreksinstellingen kunnen wijzigen via een webview die ze in de softclient zien. Zie de Handleiding voor webview-oplossingen voor Cisco BroadWorks-gespreksinstellingen.

Webex maakt gebruik van deze functie om gebruikers toegang te geven tot algemene BroadWorks-gespreksinstellingen die niet eigen zijn aan de Webex-app.

Als u wilt dat uw Webex voor Cisco BroadWorks-abonnees toegang hebben tot gespreksinstellingen die verder gaan dan de standaardinstellingen die beschikbaar zijn in de Webex-app, moet u de functie Webview voor gespreksinstellingen implementeren.

De webview Gespreksinstellingen heeft twee onderdelen:

  • Webview-toepassing voor gespreksinstellingen, gehost op een Cisco BroadWorks XSP|ADP.

  • De Webex-app, die de gespreksinstellingen in een Webview weergeeft.

Gebruikerservaring

  • Windows-gebruikers: Klik op Gespreksinstellingen en klik vervolgens op Gespreksvoorkeuren openen > Geavanceerde gespreksinstellingen.

  • Mac-gebruikers: Klik op profielfoto en vervolgens op Voorkeuren > Geavanceerde gespreksinstellingen.

CSWV implementeren op BroadWorks

Webview Gespreksinstellingen installeren op XSP|ADP's

CSWV-toepassing moet zich op dezelfde XSP|ADP('s) bevinden als de host van de Xsi-Actions-interface in uw omgeving. Het is een onbeheerde toepassing op XSP|ADP, dus u moet een webarchiefbestand installeren en implementeren.

  1. Meld u aan bij cisco.com en zoek naar 'BWCallSettingsWeb' in het gedeelte software downloaden.

  2. Zoek en download de meest recente versie van het bestand.

    Bijvoorbeeld: BWCallSettingsWeb_1.8.2_1.war( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) was op het moment van schrijven het meest recent.

  3. Installeer, activeer en implementeer het webarchief volgens de configuratiehandleiding voor Cisco BroadWorks Xtended Service Platform voor uw XSP|ADP-versie. (Versie R24 is https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).

    1. Kopieer het .war-bestand naar een tijdelijke locatie op de XSP|ADP, zoals /tmp/.

    2. Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:

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

      De BroadWorks-softwaremanager valideert en installeert het bestand.

    3. [Optioneel] Verwijderen /tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist).

    4. Activeer de toepassing:

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      De naam en versie zijn verplicht voor elke toepassing, maar voor CSWV moet u ook een contextPath opgeven omdat het een onbeheerde toepassing is. U kunt alle waarden gebruiken die niet door een andere toepassing worden gebruikt, bijvoorbeeld: /callsettings.

    5. Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

  4. U kunt nu de URL voor gespreksinstellingen die u voor clients opgeeft, als volgt voorspellen:

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

    Opmerkingen:

    • U moet de trailing slash op deze URL opgeven wanneer u deze invoert in het clientconfiguratiebestand.

    • De XSP|ADP-FQDN moet overeenkomen met de FQDN voor Xsi-acties, omdat CSWV Xsi-acties moet gebruiken en CORS niet wordt ondersteund.

  5. Herhaal deze procedure voor andere XSP|ADP's in uw Webex voor Cisco BroadWorks-omgeving (indien nodig).

De toepassing Gespreksinstellingen Webview is nu actief op de XSP|ADP's.

Configureer de Webex-app om de webview met gespreksinstellingen te gebruiken

Zie de Webex voor Cisco BroadWorks-configuratiehandleiding voor meer informatie over clientconfiguratie.

Er is een aangepaste tag in het configuratiebestand van de Webex-app die u kunt gebruiken om de CSWV-URL in te stellen. Deze URL toont de gespreksinstellingen aan de gebruikers via de toepassingsinterface.

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

Configureer in de configuratiesjabloon van de Webex-app op BroadWorks de CSWV-URL in de tag %WEB_CALL_SETTINGS_URL_WXT%.

Als u de URL niet expliciet opgeeft, is de standaard leeg en is de pagina met gespreksinstellingen niet zichtbaar voor de gebruikers.

  1. Zorg ervoor dat u over de nieuwste configuratiesjablonen voor de Webex-app beschikt (zie Apparaatprofielen).

  2. Het doel voor webgespreksinstellingen instellen op csw:

    %WEB_CALL_SETTINGS_TARGET_WXT% csw

  3. Stel de URL voor webgespreksinstellingen voor uw omgeving in, bijvoorbeeld:

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

    U hebt deze waarde afgeleid bij het implementeren van de CSWV-toepassing.

  4. Het resulterende clientconfiguratiebestand moet als volgt worden ingevoerd:

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

     
    Elke verwijzing naar XSP omvat XSP of ADP.

Pushmeldingen voor gesprekken configureren in Webex voor Cisco BroadWorks

In dit document gebruiken we de term Call Notifications Push Server (CNPS) om een door XSP gehoste of door ADP gehoste toepassing te beschrijven die in uw omgeving wordt uitgevoerd. Uw CNPS werkt met uw BroadWorks-systeem om op de hoogte te zijn van binnenkomende gesprekken naar uw gebruikers en pusht meldingen van deze gesprekken naar de meldingsservices van Google Firebase Cloud Messaging (FCM) of Apple Push Notification Service (APN's).

Deze services melden de mobiele apparaten van Webex voor Cisco BroadWorks-abonnees dat ze inkomende gesprekken hebben op Webex.

Zie de functiebeschrijving van de pushserver voor meldingen voor meer informatie over NPS.

Een vergelijkbaar mechanisme in Webex werkt met Webex-berichten- en aanwezigheidsservices om meldingen naar de Google- (FCM) of Apple-meldingsservices (APNS) te pushen. Deze services brengen de mobiele Webex-gebruikers op hun beurt op de hoogte van inkomende berichten of aanwezigheidswijzigingen.


 

In dit gedeelte wordt beschreven hoe u NPS configureert voor de verificatieproxy wanneer de NPS nog geen andere apps ondersteunt. Als u een gedeelde NPS moet migreren om NPS-proxy te gebruiken, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruikenhttps://help.webex.com/nl5rir2/.

Overzicht van NPS-proxy

Voor compatibiliteit met Webex voor Cisco BroadWorks moet uw CNPS worden gepatcht ter ondersteuning van de NPS-proxyfunctie, Pushserver voor VoIP in UCaaS.

De functie implementeert een nieuw ontwerp in de pushserver voor meldingen om het beveiligingsprobleem van het delen van privésleutels voor pushmeldingscertificaten met serviceproviders voor mobiele clients op te lossen. In plaats van pushmeldingscertificaten en -sleutels te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een kortstondig pushmeldingstoken te verkrijgen van Webex voor Cisco BroadWorks-backend en gebruikt dit token voor verificatie met de Apple APN's en Google FCM-services.

De functie verbetert ook de mogelijkheid van de Notification Push Server om meldingen naar Android-apparaten te pushen via de nieuwe Google Firebase Cloud Messaging (FCM) HTTPv1 API.

APNS-overwegingen

Apple zal het op HTTP/1 gebaseerde binaire protocol over de Apple Push Notification-dienst na 31 maart 2021 niet langer ondersteunen. We raden u aan uw XSP|ADP te configureren om de op HTTP/2 gebaseerde interface voor APN's te gebruiken. Voor deze update moet uw XSP|ADP die de NPS host R22 of hoger uitvoeren.

Bereid uw NPS voor op Webex voor Cisco BroadWorks

1

Installeer en configureer een specifieke XSP (minimumversie R22) of Application Delivery Platform (ADP).

2

Installeer de NPS-verificatieproxypatches:

3

Activeer de toepassing Pushserver voor meldingen.

4

(Voor Android-meldingen) Schakel de FCM v1-API in op de NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.

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

6

Voeg een techsupport van de NPS XSP/ADP toe.

7

Op elke AS-server wordt het namedefs-bestand in /usr/local/broadworks/bw_base/conf moet worden geconfigureerd met SRV en A-records voor XSP/ADP-zoekopdrachten (Notification Push Server). Als er meerdere XSP/ADP zijn, voegt u voor elke zoekopdracht een vermelding toe.

Voorbeeld: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN EEN versie van 10.193.78.149


 

Na het instellen is een van de volgende opties vereist om de wijzigingen op te halen:

  1. Een restartbw wordt voorgevormd in een onderhoudsperiode.

  2. Via de Cisco BroadWorks CLI:

    R24 en ouder

    AS_CLI/ASDiagnostic/DNS> opnieuw laden

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> opnieuw laden

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> opnieuw laden

De volgende stappen

Als u een NPS opnieuw wilt installeren, gaat u naar NPS configureren om de verificatieproxy te gebruiken

Als u een bestaande Android-implementatie wilt migreren naar FCMv1, gaat u naar NPS migreren naar FCMv1

Configureer NPS om de verificatieproxy te gebruiken

Deze taak is van toepassing op een nieuwe installatie van NPS die is toegewezen aan Webex voor Cisco BroadWorks.

Als u de verificatieproxy wilt configureren op een NPS die met andere mobiele apps wordt gedeeld, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken ( https://help.webex.com/nl5rir2).

1

Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.

2

Maak het clientaccount aan op de 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: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get


 

De CiscoCI-uitgeverUrl moet ALTIJD een US CI-cluster zijn, ongeacht uw locatie. De standaardwaarde moet zijn:

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

Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):

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

(Voor Android-meldingen) Voeg de Android-toepassings-id toe aan de context van de FCM-toepassingen op de NPS.

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

5

(Voor Apple iOS-meldingen) Voeg de toepassings-id toe aan de context van de APNS-toepassingen en zorg ervoor dat u de verificatiesleutel weglaat. Stel deze in op leeg.

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

6

Configureer de volgende NPS-URL's:

XSP|ADP CLI-context

Parameter

Waarde

  • XSP|ADP_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|ADP_CLI/Applications/NotificationPushServer

    /APNS/Production>

url

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

7

Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:

XSP|ADP CLI-context

Parameter

Waarde

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen:

  1. Uitvoeren AS_CLI/System/PushNotification> get en controleer de waarde van enforceAllowedApplicationList. Als het true, moet u deze subtaak voltooien. Anders slaat u de rest van de deeltaak 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

Start de XSP|ADP opnieuw: bwrestart

10

Test gespreksmeldingen door gesprekken te voeren van een BroadWorks-abonnee naar twee mobiele Webex-gebruikers. Controleer of de gespreksmelding wordt weergegeven op iOS- en Android-apparaten.

NPS migreren naar FCMv1

Dit onderwerp bevat optionele procedures die u in Google FCM-console kunt gebruiken wanneer u een bestaande NPS-implementatie hebt die u naar FCMv1 moet migreren. Er zijn drie procedures:

UC-One-clients migreren naar FCMv1

Gebruik de onderstaande stappen in Google FCM-console om UC-One-clients te migreren naar Google FCM HTTPv1.


 

Als branding wordt toegepast op de client, moet de client de afzender-id hebben. Zie in de FCM-console Projectinstellingen > Cloud Messaging. De instelling wordt weergegeven in de aanmeldtabel voor het project.

Zie de Connect Mobile Branding Guide op 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? voor meer informatie. Raadpleeg de gcm_defaultSenderId parameter, die zich bevindt in het bestand Branding Kit, Resource folder, branding.xml met de onderstaande syntaxis:

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

  1. Meld u aan bij FCM-beheerder SDK op http://console.firebase.google.com.

  2. Selecteer de juiste Android-toepassing.

  3. Noteer de project-ID op het tabblad Algemeen

  4. Ga naar het tabblad Serviceaccounts om een serviceaccount te configureren. U kunt een nieuw serviceaccount maken of een bestaand serviceaccount configureren.

    Een nieuw serviceaccount maken:

    1. Klik op de blauwe knop om een nieuw serviceaccount aan te maken

    2. Klik op de blauwe knop om een nieuwe privésleutel te genereren

    3. Sleutel downloaden naar een veilige locatie

    Een bestaand serviceaccount hergebruiken:

    1. Klik op de blauwe tekst om bestaande serviceaccounts weer te geven.

    2. Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.

    3. Klik aan de rechterkant op het hamburgermenu en maak een nieuwe privésleutel aan.

    4. Download het json-bestand dat de sleutel bevat en sla het op naar een veilige locatie.

  5. Kopieer het json-bestand naar de XSP|ADP.

  6. Configureer de project-ID en:

    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. Configureer de toepassing:

    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. FCMv1 inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

SaaS-clients migreren naar FCMv1

Gebruik de onderstaande stappen op Google FCM Console als u SaaS-clients wilt migreren naar FCMv1.


 
Zorg ervoor dat u de procedure 'NPS configureren om verificatieproxy te gebruiken' al hebt voltooid.
  1. FCM uitschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

  3. FCM inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

ADP-server bijwerken

Gebruik de onderstaande stappen in Google FCM-console als u de NPS migreert om een ADP-server te gebruiken.

  1. Haal het JSON-bestand op van de Google Cloud-console:

    1. Ga op de Google Cloud Console naar de pagina Service Accounts.

    2. Klik op Selecteer een project, kies uw project en klik op Openen.

    3. Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.

    4. Selecteer een type Sleutel en klik op Aanmaken

      Het bestand wordt gedownload.

  2. FCM toevoegen aan de ADP-server:

    1. Importeer het JSON-bestand naar de ADP-server met de /bw/install opdracht.

    2. Meld u aan bij de ADP CLI en voeg project- en API-sleutel toe:

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

    3. Voeg vervolgens de toepassing en de sleutel toe:

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

    4. Controleer de configuratie:

      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

Uw partnerorganisatie configureren in Partner Hub

Uw BroadWorks-clusters configureren

[eenmaal per cluster]

Dit gebeurt om de volgende redenen:

  • Webex-cloud inschakelen om uw gebruikers te verifiëren met BroadWorks (via de door XSP|ADP gehoste verificatieservice).

  • Webex-apps inschakelen om de Xsi-interface te gebruiken voor gespreksbeheer.

  • Webex inschakelen om te luisteren naar door BroadWorks gepubliceerde CTI-gebeurtenissen (telefonische aanwezigheid en gespreksgeschiedenis).


 

De clusterwizard valideert de interfaces automatisch wanneer u ze toevoegt. U kunt de cluster blijven bewerken als een van de interfaces niet is gevalideerd, maar u kunt een cluster niet opslaan als er ongeldige invoer zijn.

We voorkomen dit omdat een onjuist geconfigureerde cluster problemen kan veroorzaken die moeilijk op te lossen zijn.

Wat u moet doen:

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Cluster toevoegen.

    Hiermee start u een wizard waarin u uw XSP|ADP-interfaces (URL's) levert. U kunt een poort toevoegen aan de interface-URL als u een niet-standaardpoort gebruikt.

  4. Geef dit cluster een naam en klik op Volgende.

    Het clusterconcept hier is slechts een verzameling van interfaces, meestal samengebracht op een XSP|ADP-server of -farm, waarmee Webex informatie van uw toepassingsserver (AS) kan lezen. U hebt mogelijk één XSP|ADP per AS-cluster of meerdere XSP|ADP's per cluster of meerdere AS-clusters per XSP|ADP. Schaalvereisten voor uw BroadWorks-systeem vallen hier buiten het bereik.

  5. (Optioneel) Een BroadWorks-gebruiker invoeren Accountnaam en Wachtwoord dat u weet dat u zich in het BroadWorks-systeem bevindt waarmee u verbinding maakt met Webex en klik vervolgens op Volgende.

    De validatietests kunnen dit account gebruiken om de verbindingen met de interfaces in het cluster te valideren.

  6. Voeg uw URL's voor XSI-acties en XSI-gebeurtenissen toe.

  7. Optioneel. Werk de DAS-URL bij met de URL van de apparaatactiveringsservice.

  8. Optioneel. Schakel het selectievakje Directe BroadWorks-verificatie inschakelen in als u wilt dat aanmeldingen bij BroadWorks rechtstreeks naar BroadWorks worden verzonden. Anders wordt verificatie naar BroadWorks via de Webex-gehoste IdP-proxyservice geproxy.

    Dit selectievakje is van invloed op deze aanmeldsituaties:

    • Aanmelding bij de gebruikersactiveringsportal: gebruikers moeten hun BroadWorks-aanmeldgegevens invoeren wanneer ze zich bij de portal aanmelden. De bovenstaande instelling bepaalt of de aanmelding rechtstreeks is naar BroadWorks of via de IdP-proxy.

    • Clientaanmelding: als BroadWorks-verificatie is geconfigureerd in de onboardsjabloon, bepaalt de bovenstaande instelling of de clientaanmelding bij de Webex-app rechtstreeks is naar BroadWorks of wordt geproxy via de IdP-proxy.

  9. Klik op Volgende.

  10. Ga als volgt te werk op de pagina CTI-interface:

    1. Voeg de CTI-URL en poort toe voor de CTI-interface waarmee u verbinding wilt maken.

    2. Optioneel. Schakel de schakelaar Gespreksgeschiedenis in en voer vervolgens uw BroadWorks-gebruikers-id in. Als deze optie is geselecteerd, worden BroadWorks-gespreksgeschiedenisgebeurtenissen gesynchroniseerd met de Webex-cloud. Gebruikers kunnen hun gespreksgeschiedenis bekijken in de Webex-app.

    3. Optioneel. Schakel de schakelaar Niet storen (NST) in en voer vervolgens uw BroadWorks-gebruikers-id in. Met deze optie worden NST-gebeurtenissen tussen Webex en BroadWorks gesynchroniseerd, zodat de functie op beide platforms hetzelfde werkt.

    4. Klik op Volgende.

  11. Voeg de URL van uw verificatieservice toe.

  12. Selecteer Verificatieservice met CI-tokenvalidatie.

    Voor deze optie is niet vereist dat mTLS de verbinding beschermt tegen Webex, omdat de verificatieservice het gebruikerstoken correct valideert met de Webex-identiteitsservice voordat het langlevende token aan de gebruiker wordt verstrekt.

  13. Controleer uw gegevens op het laatste scherm en klik op Maken. U zou een bericht met succes moeten zien.

    Partner Hub geeft de URL's door aan verschillende Webex-microservices die de verbindingen met de geleverde interfaces testen.

  14. Klik op Clusters weergeven en u moet uw nieuwe cluster zien en zien of de validatie is gelukt.

  15. De knop Aanmaken kan worden uitgeschakeld in het laatste (preview)scherm van de wizard. Als u de sjabloon niet kunt opslaan, geeft dit een probleem aan met een van de integraties die u zojuist hebt geconfigureerd.

    Deze controle hebben we doorgevoerd om fouten bij volgende taken te voorkomen. U kunt de wizard opnieuw doorlopen terwijl u uw implementatie configureert. Dit kan wijzigingen aan uw infrastructuur vereisen (bijv. XSP|ADP, load balancer of firewall), zoals beschreven in deze handleiding, voordat u de sjabloon kunt opslaan.

De verbindingen met uw BroadWorks-interfaces controleren

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Clusters weergeven.

  4. Partner Hub initieert verbindingstests van de verschillende microservices naar de interfaces in de clusters.

    Nadat de tests zijn voltooid, wordt op de pagina Clusterlijst het statusbericht weergegeven naast elk cluster.

    U moet groene succesberichten zien. Als u een rood foutbericht ziet, klikt u op de betreffende clusternaam om te zien welke instelling het probleem veroorzaakt.

  5. Optioneel. Selecteer een cluster als u bestaande instellingen voor dat cluster wilt zien, zoals XSI-acties, XSI-gebeurtenissen, DAS-URL en de instellingen van de CTI-interface.

Uw integratiesjablonen configureren

Onboardsjablonen zijn de manier waarop u gedeelde configuratie toepast op een of meer klanten terwijl u ze integreert via de inrichtingsmethoden. U moet elke sjabloon koppelen aan een cluster (dat u in het vorige gedeelte hebt gemaakt).

U kunt zoveel sjablonen maken als u nodig hebt, maar er kan slechts één sjabloon aan een klant worden gekoppeld.

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Sjabloon toevoegen.

    Hiermee start u een wizard waarin u de configuratie kunt leveren voor klanten die deze sjabloon gebruiken.

  4. Gebruik de vervolgkeuzelijst Cluster om het cluster te kiezen dat u met deze sjabloon wilt gebruiken.

  5. Voer een sjabloonnaam in en klik op Volgende.

  6. Configureer uw inrichtingsmodus met de volgende aanbevolen instellingen:

    Tabel 3. Aanbevolen inrichtingsinstellingen voor verschillende inrichtingsmodi

    Naam van instelling

    Flowthrough-inrichting met vertrouwde e-mails

    Flowthrough-inrichting zonder e-mails

    Zelfinrichting van de gebruiker

    BroadWorks-flow via inrichting inschakelen (inclusief inrichtingsaccountgegevens indien Ingeschakeld**)

    Aan

    Geef de accountnaam en het wachtwoord voor inrichting op volgens de BroadWorks-configuratie.

    Aan

    Geef de accountnaam en het wachtwoord voor inrichting op volgens de BroadWorks-configuratie.

    Uit

    Automatisch nieuwe organisaties maken in Control Hub

    Aan

    Aan

    Aan

    E-mailadres serviceprovider

    Selecteer een e-mailadres in de vervolgkeuzelijst (u kunt enkele tekens typen om het adres te vinden als het een lange lijst is).

    Dit e-mailadres identificeert de beheerder binnen uw partnerorganisatie aan wie gedelegeerde beheerderstoegang wordt verleend tot alle nieuwe klantorganisaties die met de onboardsjabloon zijn gemaakt.

    Land

    Kies welk land u voor deze sjabloon gebruikt.

    Het land dat u kiest, komt overeen met klantorganisaties die met deze sjabloon zijn gemaakt voor een bepaalde regio. Momenteel zou de regio (EMEAR) of (Noord-Amerika en de rest van de wereld) kunnen zijn. Zie de land-naar-regio toewijzingen in deze spreadsheet.

    Het land van de organisatie bepaalt de standaard internationale inbelnummers voor Cisco PSTN in Webex Meeting-sites. Raadpleeg het gedeelte Land van de Help-pagina voor meer informatie.

    BroadWorks-enterprisemodus actief

    Schakel dit in als de klanten die u met deze sjabloon inricht ondernemingen in BroadWorks zijn.

    Als het groepen zijn, laat deze schakelaar dan uit.

    Als u een mix van bedrijven en groepen in uw BroadWorks hebt, moet u verschillende sjablonen maken voor deze verschillende cases.

    Opmerkingen uit de tabel:

    • † Deze switch zorgt ervoor dat er een nieuwe klantorganisatie wordt gemaakt als het e-maildomein van een abonnee niet overeenkomt met een bestaande Webex-organisatie.

      Dit moet altijd zijn ingeschakeld, tenzij u een handmatig bestel- en uitvoeringsproces gebruikt (via Cisco Commerce Workspace) om klantorganisaties in Webex te maken (voordat u begint met het inrichten van gebruikers in die organisaties). Deze optie wordt vaak het model 'Hybride inrichting' genoemd en valt buiten het bereik van dit document.

    • ** 'Inrichtingsaccount' verwijst naar het BroadWorks-beheerdersaccount op systeemniveau. Op BroadWorks hebt u een beheerdersaccount met de volgende kenmerken nodig: Beheerderstype=Inrichting, Alleen-lezen=Uit.

  7. Selecteer het standaardservicepakket voor klanten met deze sjabloon (zie Pakketten in het gedeelte Overzicht); Basis, Standaard, Premium of Softphone.

    U kunt deze instelling voor individuele gebruikers overschrijven via Partner Hub.

  8. Optioneel. Schakel Gratis bellen via Cisco Webex uitschakelen in als u Webex-gesprekken wilt uitschakelen.

  9. Selecteer een van de volgende opties voor Configuratie voor deelnemen aan vergadering:

    • Cisco-inbelnummers (PSTN)

    • Door de partner verstrekte inbelnummers (BYoPSTN): als u deze optie selecteert, raadpleegt u de Bring Your Own PSTN Solution Guide for Webex for Cisco BroadWorks voor gedetailleerde informatie over het configureren van deze optie.

  10. Klik op Volgende.

  11. Er zijn twee benaderingen voor het inrichten van abonnees met betrekking tot hoe hun identiteiten worden geverifieerd - met behulp van vertrouwde e-mails of niet-vertrouwde e-mails.

    In de workflow voor vertrouwde e-mail geven gebruikers e-mailadressen door aan de partner die ze toevoegt in BroadWorks. Als partner bent u verantwoordelijk voor het inrichten van het e-mailadres als onderdeel van de doorstroommethode of de API-methode.


     

    Het wordt sterk aanbevolen om de vertrouwde inrichtingsmethode te gebruiken, omdat deze ervoor zorgt dat alle abonnees volledig door u als partner worden ingericht en er geen actie is vereist van de eindgebruikers.

    In het geval van niet-vertrouwde e-mail moeten gebruikers hun e-mails verifiëren voordat ze deze inrichten, of kunnen gebruikers zichzelf activeren.

    In het niet-vertrouwde geval zijn er verschillende inrichtingsmodi op basis van de verificatie-instellingen in de onderstaande tabel:

    Tabel 4. Aanbevolen verificatie-instellingen voor gebruikers voor niet-vertrouwde inrichtingsmodi

    Naam van instelling

    Flowthrough-inrichting zonder e-mails

    Zelfinrichting van de gebruiker

    Beheerder eerst inrichten

    Aanbevolen*

    Niet van toepassing

    Gebruikers toestaan zichzelf te activeren

    Niet van toepassing

    Vereist

    • Opmerkingen uit de tabel:

    • * Elke klantorganisatie in Webex moet ten minste één gebruiker met een beheerdersrol hebben. De eerste gebruiker aan wie u geïntegreerde IM&P in BroadWorks toewijst, neemt de rol van klantbeheerder als er een nieuwe klantorganisatie is gemaakt in Webex. Als serviceprovider wilt u mogelijk controle hebben over wie de rol krijgt. Als u deze instelling controleert, wordt het voltooien van de activering van gebruikers geblokkeerd totdat de eerste gebruiker die u hebt ingericht, is geactiveerd. Als u deze instelling uitschakelt, wordt de eerste gebruiker die in de nieuwe organisatie actief wordt, de klantbeheerder.

  12. Klik op Volgende.

  13. Selecteer de standaard verificatiemodus (BroadWorks-verificatie of Webex-verificatie) om u aan te melden bij Webex.


     
    Deze instelling heeft geen invloed op het aanmelden van gebruikers bij de User Activation Portal. Gebruikers moeten hun BroadWorks-gebruikers-id en -wachtwoord gebruiken wanneer ze zich aanmelden bij de portal, ongeacht hoe de onboardsjabloon is geconfigureerd.

     
    Deze instelling wordt alleen toegepast op nieuw gemaakte klantorganisaties. Als partnerbeheerders een nieuwe verificatie-instelling proberen toe te passen op bestaande klantorganisaties, zijn de bestaande instellingen van toepassing zodat bestaande gebruikers geen toegang verliezen. Als u de verificatiemodus voor bestaande klantorganisaties wilt wijzigen, moet u een ticket openen met Cisco TAC.

    (Zie Verificatiemodus in het gedeelte Uw omgeving voorbereiden).

  14. Klik op Volgende.

  15. Voor Voorkeuren configureert u het volgende:

    1. Kies of u de e-mailadressen van gebruikers vooraf wilt invullen op de aanmeldpagina.

      U moet deze optie alleen gebruiken als u BroadWorks-verificatie hebt geselecteerd en de e-mailadressen van de gebruikers ook in het kenmerk Alternatieve id in BroadWorks hebt geplaatst. Anders moeten ze hun BroadWorks-gebruikersnaam gebruiken. De aanmeldpagina biedt een optie om de gebruiker te wijzigen, indien nodig, maar dit kan leiden tot aanmeldproblemen.

    2. Als u adreslijstsynchronisatie wilt inschakelen, stelt u de schakelaar Telefoonlijstsynchronisatie inschakelen voor alle nieuwe klantorganisaties in op Aan.

      Met deze optie kan Webex BroadWorks-contactpersonen in de klantorganisatie lezen, zodat gebruikers deze kunnen vinden en bellen vanuit de Webex-app.

    3. Voer een partnerbeheerder in.

      Deze naam wordt gebruikt in het geautomatiseerde e-mailbericht van Webex, waarin gebruikers worden uitgenodigd om hun e-mailadres te valideren.

    4. Zorg ervoor dat de schakelaar Bestaande organisaties inrichten is ingeschakeld (de standaardinstelling is ingeschakeld).

    5. Klik op Volgende.

  16. Controleer uw gegevens op het laatste scherm. U kunt op de navigatieknoppen boven aan de wizard klikken om terug te gaan en eventuele details te wijzigen. Klik op Maken.

    U zou een bericht met succes moeten zien.

  17. Klik op Sjablonen weergeven en u moet uw nieuwe sjabloon met andere sjablonen in de lijst zien.

  18. Klik op de sjabloonnaam om de sjabloon indien nodig te wijzigen of te verwijderen.

    U hoeft de gegevens van het inrichtingsaccount niet opnieuw in te voeren. De velden Leeg wachtwoord/Wachtwoordbevestiging zijn er om de referenties te wijzigen als dat nodig is, maar laat ze leeg om de waarden te behouden die u aan de wizard hebt opgegeven.

  19. Voeg meer sjablonen toe als u verschillende gedeelde configuraties hebt die u aan klanten wilt aanbieden.


     

    Houd de pagina Sjablonen weergeven open, omdat u mogelijk sjabloongegevens nodig hebt voor een volgende taak.

Toepassingsserver configureren met inrichtingsservice-URL


 

Deze taak is alleen vereist voor flow door inrichting.

Patch Application Server (alleen R22, R23 en R24)

  1. Als u dit nog niet hebt gedaan, past u de volgende patch toe die van toepassing is op uw versie:.


     
    Zie BroadWorks-softwarevereisten in het gedeelte Referentie voor een volledige lijst met BroadWorks-patches die de vereiste vormen voor de implementatie van Webex voor Cisco BroadWorks.
  2. Wijzigen in de Maintenance/ContainerOptions context.

  3. De parameter voor de inrichtings-URL inschakelen:

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

De inrichtings-URL('s) ophalen in Partner Hub

Raadpleeg de Beheerhandleiding Cisco BroadWorks Application Server Command Line Interface voor meer informatie (Interface > Berichten en service > Geïntegreerde IM&P) over de AS-opdrachten.

  1. Meld u aan bij Partner Hub en ga naar Instellingen > BroadWorks-gesprekken.

  2. Klik op Sjablonen weergeven.

  3. Selecteer de sjabloon die u gebruikt om de abonnees van deze onderneming/groep in te richten in Webex.

    De sjabloondetails worden weergegeven in een flyout-deelvenster aan de rechterkant. Als u nog geen sjabloon hebt gemaakt, moet u dit doen voordat u de inrichtings-URL kunt krijgen.

  4. Kopieer de URL van de inrichtingsadapter.

Herhaal dit voor andere sjablonen als u er meer hebt dan één.

(Optie) Systeembrede inrichtingsparameters configureren op toepassingsserver


 

Mogelijk wilt u het systeembrede inrichtings- en servicedomein niet instellen als u UC-One SaaS gebruikt. Zie Beslissingspunten in het gedeelte Uw omgeving voorbereiden.

  1. Meld u aan bij de toepassingsserver en configureer de interface voor berichten.

    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. De geïntegreerde IMP-interface activeren:

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

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


 

U moet de volledig gekwalificeerde naam invoeren voor de provisioningURL parameter, zoals deze is gegeven in Control Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in de /etc/hosts bestand op het AS.

(Optie) Inrichtingsparameters per onderneming configureren op toepassingsserver

  1. Open in de BroadWorks-gebruikersinterface de onderneming die u wilt configureren en ga naar Services > Geïntegreerde IM&P.

  2. Selecteer Servicedomein gebruiken en voer een dummywaarde in (Webex negeert deze parameter. U kunt dit gebruiken example.com).

  3. Selecteer Messaging Server gebruiken.

  4. Plak in het veld URL de inrichtings-URL die u van uw sjabloon hebt gekopieerd in Partner Hub.


     

    U moet de volledig gekwalificeerde naam invoeren voor de provisioningURL parameter, zoals deze is gegeven in Partner Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in de /etc/hosts bestand op het AS.

  5. Voer in het veld Gebruikersnaam een naam in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.

  6. Voer een wachtwoord in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.

  7. Voor Standaard gebruikersidentiteit voor IM&P-id selecteert u Primair.

  8. Klik op Toepassen.

  9. Herhaal dit voor andere bedrijven die u wilt configureren voor flow door inrichting.

Inrichtingsgegevens gebruiker

Zie Gebruikersvoorzieningen voor serviceproviders voor informatie over de gebruikersgegevens die worden uitgewisseld tussen BroadWorks en Webex tijdens het inrichten van gebruikers.

Controle-API voorafgaand aan inrichting van partner

De API Pre-Provisioning Check helpt beheerders en verkoopteams door te controleren op fouten voordat u een klant of abonnee inricht voor een pakket. Gebruikers of integraties die zijn geautoriseerd door een gebruiker met de rol Volledige partnerbeheerder kunnen deze API gebruiken om ervoor te zorgen dat er geen conflicten of fouten zijn met de pakketinrichting voor een bepaalde klant of abonnee.

De API controleert of er conflicten zijn tussen deze klant/abonnee en bestaande klanten/abonnees op Webex. De API kan bijvoorbeeld fouten veroorzaken als de abonnee al is ingericht voor een andere klant of partner, als het e-mailadres al bestaat voor een andere abonnee of als er conflicten zijn tussen de inrichtingsparameters en wat er al bestaat in Webex. Dit geeft u de mogelijkheid om deze fouten op te lossen voordat u inricht, waardoor de kans op een succesvolle inrichting groter wordt.

Zie voor meer informatie over de API: Ontwikkelaarshandleiding van Webex voor groothandels

Als u de API wilt gebruiken, gaat u naar: Een Wholesale Subscriber-inrichting vooraf controleren


 

Als u toegang wilt krijgen tot een inrichtingsdocument voor groothandels voor abonnees, moet u zich aanmelden bij de https://developer.webex.com/-portal.

Partner SSO - SAML

Hiermee kunnen partnerbeheerders SAML SSO configureren voor nieuw gemaakte klantorganisaties. Partners kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren, evenals op hun eigen werknemers.


 
De onderstaande stappen voor Partner-SSO zijn alleen van toepassing op nieuw gemaakte klantorganisaties. Als partnerbeheerders proberen Partner SSO toe te voegen aan een bestaande klantorganisatie, blijft de bestaande verificatiemethode behouden om te voorkomen dat bestaande gebruikers de toegang verliezen. Als u partner-SSO wilt toevoegen aan een bestaande organisatie, moet u een ticket openen met Cisco TAC.
  1. Controleer of de provider van de externe identiteitsprovider voldoet aan de vereisten die worden vermeld in het gedeelte Vereisten voor identiteitsproviders van Integratie van eenmalige aanmelding in Control Hub.

  2. Open een serviceaanvraag met Cisco TAC. TAC moet een vertrouwensrelatie opbouwen tussen de externe identiteitsprovider en de Cisco Common Identity-service. .


     
    Als uw IdP de passEmailInRequest in te schakelen, zorg ervoor dat u deze vereiste in het serviceverzoek opneemt. Raadpleeg uw IdP als u niet zeker weet of deze functie vereist is.
  3. Upload het CI-metagegevensbestand dat TAC aan uw identiteitsprovider heeft geleverd.

  4. Configureer een integratiesjabloon. Selecteer Partnerverificatie voor de instelling Verificatiemodus. Voer voor de entiteits-id van de IDP-provider de entiteits-id in vanuit de XML-metagegevens van de SAML van de externe identiteitsprovider.

  5. Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.

  6. Precies dat de gebruiker kan inloggen.

Partner-SSO - OpenID Connect (OIDC)

Hiermee kunnen partnerbeheerders OIDC SSO configureren voor nieuw gemaakte klantorganisaties. Partners kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren, evenals op hun eigen werknemers.


 

De onderstaande stappen om Partner SSO OIDC in te stellen, zijn alleen van toepassing op nieuw gemaakte klantorganisaties. Als partnerbeheerders proberen het standaard verificatietype te wijzigen in Partner SSO OIDC in een bestaande tempel, zijn de wijzigingen niet van toepassing op de klantorganisaties die al zijn geïntegreerd met de sjabloon. Als u partner-SSO wilt toevoegen aan een bestaande klantorganisatie, moet u een ticket openen met Cisco TAC.

  1. Open een serviceaanvraag met Cisco TAC met de details van de OpenID Connect-id-provider. Hieronder staan verplichte en optionele IDP-kenmerken. TAC moet de id-provider instellen op de CI en de omleidings-URI opgeven die moet worden geconfigureerd op de id-provider.

    Kenmerk

    Vereist

    Beschrijving

    Naam IDP

    Ja

    Unieke maar hoofdlettergevoelige naam voor OIDC IdP-configuratie, kan bestaan uit letters, cijfers, koppeltekens, onderstrepingstekens, tildes en stippen en de maximale lengte is 128 tekens.

    OAuth-client-id

    Ja

    Wordt gebruikt om OIDC IdP-verificatie aan te vragen.

    OAuth-clientgeheim

    Ja

    Wordt gebruikt om OIDC IdP-verificatie aan te vragen.

    Lijst met scopes

    Ja

    Lijst met scopes die worden gebruikt om OIDC IdP-verificatie aan te vragen, opgesplitst per ruimte, bijvoorbeeld 'openid e-mailprofiel' Moet openid en e-mail bevatten.

    Autorisatieeindpunt

    Ja als DiscoveryEndpoint niet is verstrekt

    URL van het OAuth 2.0-verificatie-eindpunt van de IdP.

    tokenEindpunt

    Ja als DiscoveryEndpoint niet is verstrekt

    URL van het OAuth 2.0-tokeneindpunt van de IdP.

    Eindpunt van detectie

    Nee

    URL van het Discovery-eindpunt van de IdP voor detectie van OpenID-eindpunten.

    userInfoEindpunt

    Nee

    URL van het UserInfo-eindpunt van de IdP.

    Eindpunt sleutelset

    Nee

    URL van het eindpunt van de JSON-websleutelset van de IdP.


     

    Naast de bovenstaande IDP-attributen moet de id van de partnerorganisatie worden opgegeven in het TAC-verzoek.

  2. Configureer de omleidings-URI op de OpenID connect-id-provider.

  3. Configureer een integratiesjabloon. Voor de instelling Verificatiemodus selecteert u Partnerverificatie met OpenID Connect en voert u de IDP-naam in die tijdens de installatie van de IDP is opgegeven als de entiteits-id van OpenID Connect IDP.

  4. Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.

  5. Zeer dat de gebruiker zich kan aanmelden met de SSO-verificatieflow.

Gesprekscorrelatie-id inschakelen

Als u Webex voor Cisco BroadWorks wilt uitvoeren, moet u de gesprekscorrelatie-id inschakelen. Deze instelling is vereist voor veel gespreksfuncties, waaronder gespreksopname, groepsgesprek opnemen, directie en directie-assistent.

Gebruik de CLI om de functie in te schakelen op alle AS- en XSP|ADP-interfaces.

  • Voer de volgende opdrachten uit op AS-interfaces. Hierdoor kan het AS de X-BroadWorks-Correlation-Info SIP-koptekst:

    AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true

    AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true

  • Het enableCallCorrelationID parameter die is gekoppeld aan de toepassing Xsi-Actions wordt gebruikt om de opname van informatie over gesprekscorrelatie in Xsi-Actions-logboeken te beheren. Het wordt aanbevolen om enableCallCorrelationID ingeschakeld met de volgende opdracht op XSP|ADP-interfaces:

    XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true

Zie voor meer informatie over de gesprekscorrelatie-id de functiebeschrijving Cisco BroadWorks-gesprekscorrelatie-id.

Synchroniseren met Directory

Telefoonlijstsynchronisatie zorgt ervoor dat Webex voor Cisco BroadWorks-gebruikers de Webex-telefoonlijst kunnen gebruiken om elke belentiteit te bellen vanaf de BroadWorks-server. Wanneer deze functie is ingeschakeld, wordt de volledige telefoonlijst van de BroadWorks-server gesynchroniseerd met de Webex-telefoonlijst. Gebruikers kunnen toegang krijgen tot de telefoonlijst vanuit de Webex-app en een gesprek plaatsen naar elke belentiteit vanaf de BroadWorks-server.

Als u adreslijstsynchronisatie wilt inschakelen, gaat u naar Adreslijstsynchronisatie in Webex voor Cisco BroadWorks.


 
Webex voor Cisco BroadWorks-flowthrough-inrichting voegt berichtengebruikers en bijbehorende gespreksinformatie van de BroadWorks-server toe aan het Webex-platform. Telefoonlijsten, niet-berichtengebruikers en niet-gebruikersentiteiten zijn echter niet opgenomen (bijvoorbeeld een conferentieruimte-telefoon, faxapparaat of nummer van de Hunt-groep). Als u adreslijstsynchronisatie inschakelt, wordt gegarandeerd dat alle bellende entiteiten worden toegevoegd aan het Webex-platform.

Uniforme gespreksgeschiedenis

Wanneer Unified Call History is ingeschakeld, worden BroadWorks-gespreksgebeurtenissen gesynchroniseerd met de Webex-cloud en worden ze onderdeel van de Webex Unified Call- en Meetings-geschiedenis die wordt weergegeven in de Webex-app. Gebruikers kunnen hun eigen gedetailleerde gespreksgeschiedenis en vergaderingsgeschiedenis bekijken vanuit de Webex-app.

Unified Call History kan worden ingeschakeld door beheerders op partnerniveau in Partner Hub op clusterbasis. Wanneer deze functie is ingeschakeld, synchroniseert de BroadWorks-implementatie de volgende gespreksgebeurtenissen met de Webex-cloud:

  • Gespreksgeschiedenisgebeurtenissen: deze gebeurtenissen worden gebruikt om een gedetailleerde Unified-gespreksgeschiedenis op te bouwen

  • Hookstatusgebeurtenissen: Unified Call History bevat hookstatusoptimalisaties die de hoeveelheid netwerkbandbreedte voor Telephony Presence-updates verlagen

Vereisten voor Unified Call History

Voordat u Unified Call History kunt configureren, moet u ervoor zorgen dat u uw systeem hebt gepatcht. Deze functie is afhankelijk van de volgende BroadWorks-patches die worden geïnstalleerd:

Voor R22:

Voor R23:

Voor R24:


 
Voor de volledige lijst met BroadWorks-patches die u moet installeren als voorwaarde om Webex voor Cisco BroadWorks uit te voeren, raadpleegt u BroadWorks-softwarevereisten in het gedeelte Referentie.

Naast het patchen van uw systeem, wordt het clientconfiguratiebestand ( config-wxt.xml) moet de volgende tagset hebben: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>

Als u Hunt-groep, Call Center en andere omleidingsinformatie in de Unified-gespreksgeschiedenis wilt hebben, moeten de volgende Broadworks-patches zijn geïnstalleerd en actief zijn:

Voor R23:

  • AP.as.23.0.1075.ap383346

  • AP.as.23.0.1075.ap383994

Voor R24:

  • AP.as.24.0.944.ap383346

  • AP.as.24.0.944.ap383994

Als u informatie over de directie-assistent in de Unified-gespreksgeschiedenis wilt hebben, moeten de volgende Broadworks-patches zijn geïnstalleerd en actief zijn:

Voor R24:

  • AP.as.24.0.944.ap380052

  • AP.as.24.0.944.ap384239

  • ADP met Xsi-Events-24_2022.06 of hoger

Naast de Broadworks-patches moet adreslijstsynchronisatie ook zijn ingeschakeld voor de Unified-gespreksgeschiedenis van Executive-Assistant.


 

Wanneer u Gespreksgeschiedenis of NST-synchronisatie inschakelt, verzendt Webex CTI-abonnementsvernieuwingsaanvragen voor alle gebruikers onder het cluster. Afhankelijk van het aantal gebruikers kan dit tot enkele uren duren. Het wordt aanbevolen geen onderhoudsactiviteiten van Broadworks uit te voeren tijdens dezelfde onderhoudsperiode.

Gespreksgeschiedenis inschakelen (nieuw cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een nieuw cluster, raadpleegt u de stappen voor het toevoegen van een cluster in Uw partnerorganisatie configureren in Partner Hub.

Gespreksgeschiedenis inschakelen (bestaand cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een bestaand cluster, volgt u de volgende stappen:

  1. Meld u aan bij Partnerhub op admin.webex.com.

  2. Ga naar Instellingen en selecteer een bestaand cluster.

  3. Controleer of de clusterverbinding goed is. In het rechterdeelvenster moet een groen vinkje worden weergegeven met Connection established.

    Als dit niet wordt weergegeven, voert u onder Connnections controleren (optioneel) de BroadWorks-gebruikers-id en het BroadWorks-wachtwoord in en klikt u op Controleren om te controleren of de verbinding goed is.

  4. Schakel het selectievakje Gespreksgeschiedenis inschakelen in.

  5. Klik op Opslaan.

Interacties van functies

De volgende functieinteracties bestaan voor Unified Call History:

  • Unified Call History wordt niet ondersteund voor gebruikers die zijn geconfigureerd in BroadWorks met routelijsten of directe routes. Wanneer deze situatie bestaat, worden gebeurtenissen voor gespreksgeschiedenis en haakstatus niet naar de Webex-app verzonden.

  • Unified Call History wordt niet ondersteund bij toestelbellen. Gesprekken die zijn geplaatst via toestelbellen worden mogelijk niet correct weergegeven in de gespreksgeschiedenis.

Gespreksgeschiedenis weergeven in de Webex-app

Eindgebruikers kunnen hun Unified Call History openen en bekijken vanuit de Webex-app. Voor meer informatie raadpleegt u: Webex | Gespreks- en vergadergeschiedenis weergeven.

Unified Call History uitschakelen

Nadat u Unified Call History hebt ingeschakeld op een cluster, kunt u de functie niet zelf uitschakelen. Als u de functie wilt uitschakelen, neemt u contact op met het Cisco Technical Assistance Center (TAC).

Belleridentificatie en omleiding van gesprekken

Identificatie beller

Wanneer de Webex-app een gesprek ontvangt, wordt geprobeerd te identificeren wie de beller is en wordt deze informatie weergegeven in de melding voor een binnenkomend gesprek, in het gespreksvenster en nadat het gesprek is voltooid, in de gespreksgeschiedenis en voicemail.

De Webex-app probeert de beller-id te vinden door het inkomende telefoonnummer te koppelen aan de telefoonnummers van contactpersonen die in verschillende bronnen zijn gevonden. De Webex-app gebruikt de volgende bronnen in deze volgorde. Zodra het vindt het in een bron zal het niet proberen om ergens anders te zoeken.


 

Als er meerdere exemplaren van een nummer in één bron worden gevonden, wordt niet geprobeerd er een te kiezen. In dit geval wordt er geen beller-id weergegeven.

  • Webex Common Identity (CI) die gebruikers van uw organisatie bevat.

  • Persoonlijke contactpersonen en contactpersonen binnen de organisatie. Persoonlijke contactpersonen zijn zichtbaar op het tabblad Contactpersonen.

  • Lokaal adresboek. In Windows - Outlook-toepassing, in Mac - Mac-contactpersonen, in iOS - iPhone-contactpersonen, in Android - Android-contactpersonen.

Als er geen overeenkomst is gevonden met het inkomende telefoonnummer, gebruikt de app de weergavenaam in de SIP FROM-koptekst, indien beschikbaar. Anders wordt het gebruikersnaamgedeelte van de SIP-URI uit de koptekst SIP From als laatste redmiddel gebruikt.

Voor extern gespreksbeheer (d.w.z. Deskphone Control Mode) wordt XSI-informatie gebruikt, waarbij de BWKS-id of het toestel wordt gebruikt, geëxtraheerd uit informatie van externe partijen in de XSI-gebeurtenis. Als informatie van externe partijen niet beschikbaar is, wordt P-Asserted Identity (PAI) (indien geconfigureerd) gebruikt.

Gesprekken omleiden

Als een gesprek is omgeleid of doorgeschakeld, probeert de app te laten zien wie de beller is en hoe deze is doorgeschakeld in de gespreksmelding en de gespreksgeschiedenis.

  • Gesprek doorgeschakeld: Hier wordt het nummer weergegeven dat het gesprek heeft doorgeschakeld.

  • Hunt-groep: Hier wordt de naam weergegeven van de Hunt-groep die het gesprek heeft doorgeschakeld.

  • Callcenterwachtrij: Hier wordt de naam weergegeven van de wachtrij die het gesprek heeft doorgeschakeld.

  • Directie-assistent: Hier wordt de naam van de directeur weergegeven waarvoor het gesprek binnenkomt.

Uitzonderingen:

  • Voor interne gesprekken in de gesprekswachtrij, waarbij een agent een interne partij terugbelt, ziet de externe partij niet de naam van de gesprekswachtrij, maar de naam van de agent die deze belt.

Gesprek elders beantwoord:

Voor Hunt-groepen of gesprekswachtrijen die zijn ingesteld met gelijktijdige routering, zien agenten een gesprek dat elders in de gespreksgeschiedenis wordt beantwoord als een andere agent het gesprek opneemt. Voor Hunt-groepen of gesprekswachtrijen met opeenvolgende routering of in een overloop worden gesprekken weergegeven als gemiste oproep in de gespreksgeschiedenis als ze door een andere agent worden beantwoord.

Weergave van gedeelde lijn

Met de weergave van gedeelde lijn kunnen lijnen van andere gebruikers worden ingesteld als gedeelde lijnen op het apparaat voor eindgebruikers. De configuratie van de gedeelde lijn voor de Webex-app is vergelijkbaar met de configuratie van de gedeelde lijn voor bureautelefoons. Met deze specifieke functie kunt u weergaven voor gedeelde lijnen toewijzen aan de Webex-app van de eindgebruiker.

Deze functie biedt gebruikers de voordelen om gesprekken op het toestelnummer van een andere gebruiker rechtstreeks vanuit de Webex-app af te handelen.

  • U kunt de weergave van gedeelde lijn alleen instellen voor de bureaubladversie van een Webex-app.

  • U kunt maximaal 10 lijnen toevoegen, inclusief de primaire lijn Webex-app .

  • U kunt een workspace-lijn niet toewijzen als gedeelde lijn.

  • Een gebruiker kan niet tegelijkertijd met gedeelde lijnen worden ingericht met de service Executive Assistant.

  • De primaire lijnpoort van een gebruiker mag niet worden gewijzigd in een gedeelde lijn.

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

Pleister 1: Eigenaarsmarkering in apparaatlijst ter ondersteuning van gedeelde lijnen van Webex-client

R23 zonder ADP:

  • AP.as.23.0.1075.ap384179

  • AP.xsp.23.0.1075.ap384179

R23 met ADP:

  • AP.as.23.0.1075.ap384179

  • Xsi-Actions-23_2022.10

R24:

  • ALS: AP.as.24.0.944.ap384179

  • Xsi-Actions-24_2022.10

R25:

  • ALS: RI versie Rel_2022.10_1.310

  • Xsi-Actions-25_2022.10

Pleister 2: Patches voor het verhogen van het aantal poorten op apparaatprofieltypen (in dit geval voor de desktopclient: Business Communicator).

  • RI versie Rel_2022.10_1.310

Niet storen (NS)-synchronisatie

Synchronisatie Niet storen (NST) brengt de NST-instellingen op één lijn tussen Webex en BroadWorks door de NST-status tussen de twee platforms te synchroniseren. Als een gebruiker bijvoorbeeld Niet storen inschakelt vanuit de Webex-app, wordt die status gesynchroniseerd met BroadWorks-gespreksapparaten. Als gevolg daarvan gaat de bij BroadWorks geregistreerde bureautelefoon van de gebruiker niet over wanneer iemand deze probeert te bellen. Als een gebruiker NST instelt vanaf een bureautelefoon, wordt de status ook gesynchroniseerd met de Webex-app. Zonder deze functie worden NST-updates van het ene platform niet herkend door het andere platform.

NST-synchronisatie wordt toegepast op clusterniveau BroadWorks en kan door een partnerbeheerder worden ingeschakeld in Partnerhub.

Voorwaarden

Zorg ervoor dat de volgende patches worden toegepast op de AS en XSP|ADP. Pas alleen de patches toe voor uw BroadWorks-versie.

Voor versie 22:

  • AS-pleister: AP.as.22.0.1123.ap382615, AP.as.22.0.1123.ap382838

  • XSP|ADP-pleister: AP.xsp.22.0.1123.ap382615, AP.xsp.22.0.1123.ap382838

Voor versie 23:

  • AS-pleister: AP.as.23.0.1075.ap382615, AP.as.23.0.1075.ap382838

  • XSP|ADP-pleister: AP.xsp.23.0.1075.ap382615, AP.xsp.23.0.1075.ap382838

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

Voor versie 24:

  • AS-pleister: AP.as.24.0.944.ap382615, AP.as.24.0.944.ap382838

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

Nadat u de patches hebt aangebracht, activeert u functie 25433 op de AS:

AS_CLI/System/ActivatableFeature> activate 25433

Synchronisatie van apparaatfunctietoetsen configureren in BroadWorks. Zorg ervoor dat de telefoon SIP SUBSCRIBE/NOTIFY ondersteunt voor het gebeurtenispakket 'as-feature-event'. Zie Functietoetssynchronisatie voor Cisco BroadWorks-apparaten voor meer informatie.

NST-synchronisatie inschakelen (bestaand cluster)

  1. Aanmelden bij Partner Hub

  2. Klik op Instellingen.

  3. Klik op Cluster weergeven en selecteer het juiste BroadWorks-cluster.

  4. Schakel de schakelaar Niet storen (NST) in.

  5. Voer uw BroadWorks-gebruikers-id in en klik op Enable.

    Het systeem valideert dat het BroadWorks-cluster de juiste patches heeft om NST-synchronisatie te ondersteunen. Als de validatie mislukt, wordt de knop Opslaan uitgeschakeld.

  6. Als de validatie slaagt, klik dan op Save.


 
  • Zodra NST synchroniseren is ingeschakeld, vernieuwt Webex alle gebruikersabonnementen om het gebeurtenispakket Niet storen op te nemen. Afhankelijk van het aantal gebruikers kan het enkele uren duren voordat dit proces is voltooid.

  • NST-synchronisatie inschakelen is een eenrichtingsschakelaar. Zodra de functie is ingeschakeld, kunt u deze niet zelf uitschakelen.

NST-synchronisatie inschakelen (nieuw cluster)

U kunt de functie ook inschakelen tijdens het maken van het cluster. Zie 'Uw BroadWorks-clusters configureren' in Uw partnerorganisatie configureren in Partner Hub voor meer informatie.

NST-synchronisatie uitschakelen

U kunt NST-synchronisatie niet zelf uitschakelen. Als u de functie wilt uitschakelen, maakt u een BEMS-engineeringcase met de volgende informatie:

  • Gezin: Spark-service

  • Product: Bellen in Webex (Webex voor BroadWorks)

  • Onderdeel: WxBW- Inrichting

  • In het BEMS-geval moet worden vermeld dat Niet storen synchroniseren moet worden uitgeschakeld voor een partner. De case moet partnerId en BroadWorks clusterId bevatten.

Usecases

NST instellen en wissen in relatie tot werkstatus

Gespreksopname

Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopname.

Tabel 6. Opnamemodi

Opnamemodi

Beschrijving

Bedieningselementen/indicatoren die worden weergegeven in de Webex-app

Altijd

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker is niet in staat om te beginnen met of stoppen met opnemen.

  • Visuele indicator dat de opname bezig is

Altijd met onderbreken/hervatten

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker kan een opname onderbreken en hervatten.

  • Visuele indicator dat de opname bezig is

  • Knop Opname onderbreken

  • Knop Opname hervatten

OnDemand

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht, maar de opname wordt verwijderd tenzij de gebruiker op Opname starten drukt.

Als de gebruiker een opname start, blijft de volledige opname van de gespreksinstellingen behouden. Nadat de gebruiker de opname heeft gestart, kan de gebruiker de opname ook onderbreken en hervatten

  • Knop Opname starten

  • Knop Opname onderbreken

  • Knop Opname hervatten

OnDemand met door gebruiker geïnitieerde start

De opname wordt niet gestart tenzij de gebruiker de optie Opname starten selecteert in de Webex-app. De gebruiker heeft de optie om meerdere keren te starten en stoppen met opnemen tijdens een gesprek.

  • Knop Opname starten

  • Knop Opname stoppen

  • Knop Opname onderbreken

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

De Call Correlation Identifier (Correlatie-id gesprek) moet zijn ingeschakeld. Zie Gesprekscorrelatie-id inschakelen voor meer informatie.

De volgende configuratietag moet zijn ingeschakeld om deze functie te kunnen gebruiken: %ENABLE_CALL_RECORDING_WXT%.

Deze functie vereist een integratie met een gespreksopnameplatform van derden.

Als u gespreksopname op BroadWorks wilt configureren, gaat u naar de Cisco BroadWorks-interfacehandleiding voor gespreksopname.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van de opnamefunctie gaat u naar de help.webex.com artikel Webex | Uw gesprekken opnemen.

Als u een opname opnieuw wilt afspelen, moeten gebruikers of beheerders naar hun gespreksopnameplatform van derden gaan.

Groep gesprek parkeren en ophalen

Webex voor Cisco BroadWorks ondersteunt Groep gesprek parkeren en ophalen. Deze functie biedt gebruikers binnen een groep een manier om gesprekken te parkeren, die vervolgens door andere gebruikers in de groep kunnen worden opgehaald. Winkelmedewerkers in een winkelinstelling kunnen de functie bijvoorbeeld gebruiken om een gesprek te parkeren dat vervolgens kan worden opgehaald door iemand in een andere afdeling.

Werking van functies

Zodra de functie is geconfigureerd

  • Tijdens een gesprek klikt een gebruiker op de optie Parkeren in de Webex-app om het gesprek te parkeren op een toestel dat het systeem automatisch selecteert. Het systeem geeft het toestelnummer voor de gebruiker voor een periode van 10 seconden weer.

  • Een andere gebruiker in de groep klikt op de optie Gesprek ophalen in de Webex-app. De gebruiker voert vervolgens het toestelnummer van het geparkeerde gesprek in om het gesprek voort te zetten.

Vereisten

Zorg voor het volgende om deze functie te laten werken:

  • Het clientconfiguratiebestand moet de volgende tags hebben ingesteld:

    <call-park enabled="%ENABLE_CALL_PARK_WXT%"
            timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
  • De Call Correlatie-id moet zijn ingeschakeld op de AS en XSP|ADP. Zie Gesprekscorrelatie-id inschakelen voor meer informatie.

  • Uw SBC moet zijn geconfigureerd om de ' x-broadworks-correlation-in' SIP-kenmerk van en naar de toepassingsserver.

Configuratie

Zie 'Groep voor geparkeerde gesprekken toevoegen' in de Beheerhandleiding voor de webinterface van de Cisco BroadWorks-toepassingsservergroep - deel 2 voor meer informatie over het configureren van Groepsgesprek parkeren op BroadWorks. U moet een groep maken en gebruikers aan de groep toevoegen.

Meer informatie over het configureren van de gesprekscorrelatie-id in BroadWorks vindt u in Functiebeschrijving Cisco BroadWorks-gesprekscorrelatie-id.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van Groepsgesprek parkeren raadpleegt u Webex | Parkeren en Gesprekken ophalen.

Gesprek parkeren/doorverbonden gesprek parkeren

Normaal of doorverbonden gesprek parkeren wordt niet ondersteund in de gebruikersinterface van de Webex-app, maar ingerichte gebruikers kunnen de functie implementeren met behulp van functietoegangscodes:

  • Voer *68 in om een gesprek te parkeren

  • Voer *88 in om een gesprek op te halen

Inbreken

Inbrekersservice wordt vaak gebruikt in callcenteromgevingen of andere situaties waar directe hulp of interventie nodig kan zijn.

Wanneer een inbrekersservice is ingeschakeld, kan een aangewezen gebruiker of supervisor een actief gesprek invoeren door een specifieke opdracht te starten of door een speciale knop of toetscombinatie te gebruiken op hun telefoon of communicatieapparaat. Zodra de aanvraag voor inbreken is ingediend, brengt het systeem een verbinding tot stand met het lopende gesprek, zodat de bevoegde persoon het gesprek kan beluisteren of als actieve deelnemer aan het gesprek kan deelnemen.

Inbreken kan handig zijn in verschillende scenario's. In een callcenterinstelling kunnen supervisors of trainers vertegenwoordigers van de klantenservice controleren en coachen door hun gesprekken in realtime te beluisteren. Indien nodig kunnen ze ingrijpen om advies te geven of het gesprek overnemen als de vertegenwoordiger het moeilijk heeft. In noodsituaties of bij kritische gesprekken kan bevoegd personeel snel deelnemen aan lopende gesprekken om hulp te bieden of belangrijke beslissingen te nemen.

In de Webex-app voor inbreken krijgen we een melding dat het gesprek wordt omgezet in een conferentie. Er is geen extra informatie in de NOTIFY (call-info of conference-info) wat het type conferentie is, zodat we het op een andere manier kunnen behandelen.

Bij het inbreken wordt een drierichtingsgesprek tot stand gebracht tussen de partijen. De volgende termen worden geïntroduceerd:

  • Verantwoordelijke: Een supervisor is een persoon die toezicht houdt op en leiding geeft aan een team van klantenserviceagenten of callcentervertegenwoordigers. In het kader van het inbreken van gesprekken heeft een supervisor doorgaans de mogelijkheid om lopende gesprekken van klanten te controleren en tussenbeide te komen. Zij kunnen gespreksbewakingstools of -software gebruiken om gesprekken te beluisteren, agenten te begeleiden en kwaliteitscontrole te garanderen. De rol van de supervisor kan bestaan uit het trainen van agenten, het aanpakken van klantproblemen en het optimaliseren van de prestaties van het team.

  • Klant: Een klant verwijst naar een persoon of entiteit die contact opneemt met een bedrijf of organisatie om producten, diensten of ondersteuning te verkrijgen. In de context van gesprek inbreken is een klant iemand die een telefoongesprek voert of ontvangt met een agent van de klantenservice. Klanten kunnen tijdens het gesprek hulp, informatie of een oplossing zoeken voor hun vragen of problemen. Met de functie voor het inbreken van gesprekken kunnen supervisors of geautoriseerd personeel deelnemen aan het lopende gesprek tussen de klant en de agent.

  • Agent: Een agent, ook wel een vertegenwoordiger van de klantenservice of een callcenteragent genoemd, is een persoon die verantwoordelijk is voor het afhandelen van klantinteracties en het bieden van ondersteuning of hulp via de telefoon of andere communicatiekanalen. Agenten zijn opgeleid om vragen van klanten te beantwoorden, problemen op te lossen, transacties te verwerken en een positieve klantervaring te bieden. In de context van gesprek inbreken is een agent de persoon die rechtstreeks met de klant spreekt tijdens het telefoongesprek. De agent kan indien nodig begeleiding of feedback van de supervisor ontvangen via inbellen.

Mobiel systeemeigen gesprek escaleren naar vergadering

De Mobile Native Call Escalate to Meeting heeft twee unieke functies:

  • Nieuwe pushmelding

    Mobiele gebruikers in een native gesprek kunnen nu overschakelen naar de Webex-app door op de Nieuwe pushmelding te tikken. Wanneer u een systeemeigen gespreksscherm start, verschijnt er een Nieuwe pushmelding op het scherm en tikt u rechtstreeks op het scherm in gesprek van de Webex-app.

    U ziet de Webex-melding tijdens een telefoongesprek als u Webex Go gebruikt of als uw mobiele netwerkoperator (MNO) gesprekssignalering heeft met Cisco-gespreksbeheer voor uw mobiele telefoongesprekken.

  • Mobiel gesprek verplaatsen naar vergadering

    Wanneer u in gesprek bent met iemand, wilt u dat gesprek mogelijk verplaatsen naar een vergadering om gebruik te maken van enkele geavanceerde vergaderingsfuncties, zoals video, delen of whiteboards. Of nodig andere mensen uit in de discussie en ga naar een vergadering.

Vereisten voor BroadWorks

  • Activeerbare functie 25239

  • R23 met 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 met ADP:

    • AS-patch AP.as.23.0.1075.ap383064

    • ADP met Xsi-Actions-23, CommPilot-23 versie > 2022.05_1.303 en NPS versie > 2022.08_1.350

  • R24:

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

    • ADP met Xsi-Actions-24, CommPilot-24 versie > 2022.05_1.303 en NPS versie > 2022.08_1.350

  • R25:

    • AS RI versie Rel_2022.08_1.354

    • ADP met Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 en NPS-versie > 2022.08_1.350

Configuratie voor URI-bellen ter ondersteuning van het verplaatsen van een gesprek naar een vergadering

NS UrlDialing-beleid

Regel definiëren voor (.*)webex.com om te routeren via 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-routering NE voor I-SBC

Voorbeeldconfiguratie

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-routeringsprofiel

Het exemplaar van het URL-belbeleid is toegevoegd aan het/de juiste routeringsprofiel(en)

NS_CLI/Policy/Profile> get profile MyInst
 Profile:  Webex
                  Policy              Instance
    ==========================================
 …
              UrlDialing          WebexMeetings

ALS gebruik NS-route voor NetworkURL-gesprek

Schakel het AS in om de NS-route in de hybride AS-modus te respecteren

AS_CLI/Interface/IMS> set queryNSForNetworkURL true

E911-noodoproepen

Webex voor Cisco BroadWorks ondersteunt E911-noodoproepen. Met deze functie worden noodoproepen gerouteerd naar een PSAP (Public Safety Answering Point), dat vervolgens de hulpdiensten naar de locatie van de beller kan leiden. Als u deze functie wilt gebruiken, moet u Webex voor Cisco BroadWorks integreren met een E911-provider voor noodoproepen.

Gebruik de volgende Webex-artikelen om ondersteuning voor E911-noodoproepservices te configureren:

  • E911-noodoproepen in Webex voor BroadWorks: gebruik dit artikel om E911-noodoproepen in Webex voor Cisco BroadWorks te configureren met een van de volgende ondersteunde E911-providers:

    • Gegarandeerd

    • Binnen het systeem

    • RedSky

  • Disclaimer voor noodoproepen: als u een locatieservice hebt, kunt u het venster Disclaimer voor noodoproepen in de Webex-app zo configureren dat gebruikers hun locatie kunnen bijwerken wanneer ze zich aanmelden.

Clients aanpassen en inrichten

Gebruikers downloaden en installeren hun algemene Webex-apps voor desktop of mobiel (zie Webex-app-platforms voor downloadkoppelingen). Zodra de gebruiker zich heeft geverifieerd, wordt de client geregistreerd bij de Webex-cloud voor berichten en vergaderingen, worden de merkgegevens opgehaald, wordt de informatie over de BroadWorks-service ontdekt en wordt de belconfiguratie gedownload van de BroadWorks-toepassingsserver (via DMS op XSP|ADP).

U configureert de gespreksparameters voor Webex-apps in BroadWorks (zoals normaal). U configureert parameters voor branding, berichten en vergaderingen voor de clients in Control Hub. U kunt een configuratiebestand niet rechtstreeks wijzigen.

Deze twee sets configuraties kunnen overlappen. In dat geval vervangt de Webex-configuratie de BroadWorks-configuratie.

Configuratiesjablonen voor Webex-apps toevoegen aan de BroadWorks-toepassingsserver

Webex-apps worden geconfigureerd met DTAF-bestanden. De clients downloaden een XML-configuratiebestand van de toepassingsserver via de service Apparaatbeheer op de XSP|ADP.

  1. Haal de vereiste DTAF-bestanden op (zie Apparaatprofielen in het gedeelte Uw omgeving voorbereiden).

  2. Controleer of u de juiste tagsets hebt in BroadWorks System > Resources > Device Management Tagsets.

  3. Voor elke client die u inricht:

    1. Download en pak het DTAF zip-bestand voor de specifieke client uit.

    2. DTAF-bestanden importeren naar BroadWorks op System > Resources > Identity/Device Profile Types

    3. Open het nieuw toegevoegde apparaatprofiel voor bewerken en:

      • Voer de XSP|ADP farm FQDN en het Device Access Protocol in.

      • Schakel het selectievakje Support Remote Party Info in. Deze ondersteuning is vereist om bureaublad delen te laten werken.


         
        U kunt de ondersteuning voor Remote Party ook inschakelen door de volgende CLI-opdracht uit te voeren op de toepassingsserver: AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
    4. Pas de sjablonen aan volgens uw omgeving (zie onderstaande tabel).

    5. Sla het bestand op.

  4. Klik op Bestanden en verificatie en selecteer vervolgens de optie om alle systeembestanden opnieuw op te bouwen.

Naam

Beschrijving

Prioriteit codec

Prioriteitsvolgorde configureren voor de audio- en videocodecs voor VoIP-gesprekken

TCP, UDP en TLS

Configureer de protocollen die worden gebruikt voor SIP-signalering en media

RTP-audio- en videopoorten

Poortbereiken configureren voor RTP-audio en -video

SIP-opties

Configureer verschillende opties met betrekking tot SIP (SIP INFO, rport gebruiken, SIP-proxydetectie, vernieuwingsintervallen voor registratie en abonnement, enz.)

Branding voor Webex-app aanpassen


 

De portal voor gebruikersactivering gebruikt hetzelfde logo dat u toevoegt voor Client Branding.

Probleemrapportage en Help-URL's aanpassen

Als u deze opties wilt aanpassen, kunnen administators de procedure 'Feedback en Help-site-URL's toevoegen' volgen, die u in beide bovenstaande brandingartikelen kunt vinden.

Uw testorganisatie configureren voor Webex voor Cisco BroadWorks

Voordat u begint

Met Flowthrough-inrichting

U moet alle XSP|ADP-services en de partnerorganisatie in Control Hub configureren voordat u deze taak kunt uitvoeren.

1

Service toewijzen in BroadWorks:

  1. Maak een testonderneming onder uw serviceprovideronderneming in BroadWorks of maak een testgroep onder uw serviceprovider (afhankelijk van uw BroadWorks-configuratie).

  2. Configureer de IM&P-service voor die onderneming om naar de sjabloon te verwijzen die u test (haal de URL van de inrichtingsadapter en de referenties op in de Control Hub-onboardsjabloon).

  3. Maak testabonnees in die onderneming/groep.

  4. Geef de gebruikers unieke e-mailadressen in het e-mailveld in BroadWorks. Kopieer deze ook naar het kenmerk Alternatieve id.

  5. Wijs de geïntegreerde IM&P-service toe aan deze abonnees.


     

    Hierdoor worden de klantorganisatie en de eerste gebruikers gemaakt, wat enkele minuten duurt. Wacht even voordat u zich probeert aan te melden bij uw nieuwe gebruikers.

2

Klantorganisatie en gebruikers verifiëren in Control Hub:

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Klanten en controleer of uw nieuwe klantorganisatie in de lijst staat (de naam volgt de groepsnaam of de bedrijfsnaam, vanuit BroadWorks).

  3. Open de klantorganisatie en controleer of de abonnees gebruikers in die organisatie zijn.

  4. Controleer of de eerste abonnee aan wie u de geïntegreerde IM&P-service hebt toegewezen, de klantbeheerder van die organisatie is geworden.

Gebruikerstests

1

Download de Webex-app op twee verschillende machines.

2

Meld u aan als testgebruikers op de twee machines.

3

Voer testgesprekken.

Webex voor BroadWorks beheren

Klantorganisaties inrichten

In het huidige model richten we de klantorganisatie automatisch in wanneer u de eerste gebruiker integreert via een van de methoden die in dit document worden beschreven. Inrichting vindt slechts één keer plaats voor elke klant.

Gebruikers inrichten

U kunt gebruikers op de volgende manieren inrichten:

  • API's gebruiken om Webex-accounts te maken

  • Geïntegreerde IM&P (flowthrough provisioning) toewijzen met vertrouwde e-mails om Webex-accounts te maken

  • Wijs geïntegreerde IM&P (flowthrough provisioning) toe zonder vertrouwde e-mails. Gebruikers verstrekken en valideren e-mailadressen om Webex-accounts te maken

  • Gebruikers toestaan zichzelf te activeren (u stuurt ze een koppeling, ze maken Webex-accounts)

API's voor openbare inrichting

Webex stelt openbare API's bloot zodat serviceproviders Webex voor Cisco BroadWorks-abonneevoorzieningen kunnen integreren in hun bestaande inrichtingswerkstromen. De specificatie voor deze API's is beschikbaar op developer.webex.com. Als u wilt ontwikkelen met deze API's, neemt u contact op met uw Cisco-vertegenwoordiger om Webex voor Cisco BroadWorks op te halen.


 

Groothandels worden geweigerd door deze API's.

Doorstroominrichting

Op BroadWorks kunt u gebruikers inrichten met de optie Geïntegreerde IM&P inschakelen. Door deze actie voert de BroadWorks-inrichtingsadapter een API-oproep uit om de gebruiker in te richten op Webex. Onze provisioning-API is achterwaarts compatibel met de UC-One SaaS API. BroadWorks AS vereist geen codewijziging, alleen een configuratiewijziging naar het API-eindpunt voor de inrichtingsadapter.


 

Het inrichten van abonnees op Webex kan aanzienlijk duren (enkele minuten voor de eerste gebruiker binnen een onderneming). Webex voert de inrichting uit als een achtergrondtaak. Als de flowthrough-inrichting is geslaagd, geeft dit aan dat de inrichting is gestart. Het duidt niet op voltooiing.

Als u wilt bevestigen dat gebruikers en de klantorganisatie volledig zijn ingericht op Webex, moet u zich aanmelden bij Partner Hub en in uw lijst met klanten kijken.

BroadWorks-trunking-gebruikers kunnen Webex voor BroadWorks hebben via een gedeelde gespreksweergave (SCA). De trunking-gebruiker moet de verificatieservice hebben toegewezen. Zoals beschreven in de BroadWorks-handleiding voor trunking-oplossingen (Trunking Solution Guide) 8, kan de verificatie van de SCA Webex-weergave worden gescheiden van de algemene trunkverificatie. Webex voor BroadWorks kan niet worden ingericht voor trunking-gebruikers waaraan de functies Routelijst of Directe route zijn toegewezen.


 
De locatie van sjablonen is verplaatst van BroadWorks-gesprekken in de organisatie-instellingen naar het gedeelte Klantenlijst en wordt nu de onboardingsjabloon genoemd.

Zelfactivering van de gebruiker

BroadWorks-gebruikers inrichten in Webex zonder de geïntegreerde IM&P-service toe te wijzen:

  1. Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.

  2. Klik op Sjablonen weergeven.

  3. Selecteer de inrichtingssjabloon voor onboarding die u wilt toepassen op deze gebruiker.

    Vergeet niet dat elke sjabloon is gekoppeld aan een cluster en uw partnerorganisatie. Als de gebruiker zich niet in het BroadWorks-systeem bevindt dat aan deze sjabloon is gekoppeld, kan de gebruiker de koppeling niet zelf activeren.

  4. Kopieer de inrichtingskoppeling en verzend deze naar de gebruiker.

    U kunt ook de downloadkoppeling voor de software opnemen en de gebruiker eraan herinneren dat hij of zij zijn of haar e-mailadres moet opgeven en valideren om zijn of haar Webex-account te activeren.

  5. U kunt de activeringsstatus van de gebruiker op de geselecteerde sjabloon controleren.

Zie Gebruikersvoorzieningen en activeringsstromen voor meer informatie.

Inrichting met niet-vertrouwde e-mails

Partner Hub biedt een reeks besturingselementen in de weergave Gebruikersstatus waarmee Webex voor Cisco BroadWorks-serviceproviderbeheerders de gebruikersstatus kunnen controleren en fouten kunnen oplossen bij het inrichten van niet-vertrouwde e-mails. Zie Gebruikersvoorzieningen met niet-vertrouwde e-mails verifiëren voor meerinformatie.

Webex-gebruikers verplaatsen naar Webex voor Cisco BroadWorks

Als u bestaande Webex-gebruikers wilt verplaatsen naar Webex voor Cisco BroadWorks, raadpleegt u de onderstaande tabel om te bepalen welke procedure moet worden gevolgd.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfaanmelding (bv. gratis account, proefaccount)

  1. Inrichtingsgebruikers: als de Webex voor BroadWorks-organisatie niet bestaat (zonder dat er gebruikers zijn ingericht), volgt u de normale inrichting om de eerste gebruiker in te richten als beheerdersgebruiker en maakt u de organisatie. Hiermee wordt het Webex-gebruikersaccount automatisch verplaatst voor de eerste gebruiker. Gebruik de onderstaande procedure voor volgende gebruikers.

  2. Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks: als de Webex voor BroadWorks-organisatie bestaat (eerste gebruiker is ingericht), verkrijgt u toestemming van de gebruiker en verplaatst u volgende gebruikers.

Klantorganisatie

Webex voor BroadWorks toevoegen aan bestaande organisatie: de bijlage bij de organisatie (voor de eerste gebruiker) voegt ook Webex voor BroadWorks toe aan volgende gebruikers, zolang deze zijn toegewezen aan de juiste organisatie.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfaanmelding (bv. gratis account, proefaccount)

Als Webex voor BroadWorks-organisatie niet bestaat (er zijn geen gebruikers ingericht):

  • Inrichtingsgebruikers: volg de normale inrichting om de eerste gebruiker als een beheerdersgebruiker toe te voegen. Hiermee wordt het account voor de eerste gebruiker automatisch verplaatst en wordt de Webex for BroadWorks-organisatie gemaakt. Toestemming van de gebruiker is vereist om susbsequente gebruikers te verplaatsen (gebruik de onderstaande procedure).

Als Webex voor BroadWorks-organisatie bestaat (er is ten minste één gebruiker ingericht):

Klantorganisatie

Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks

Gebruik deze procedure om een bestaande Webex-gebruiker die zich in een consumentenorganisatie bevindt of een zelfaanmeldingsaccount heeft (gratis account of proefaccount) te verplaatsen naar Webex voor Cisco BroadWorks. Houd er rekening mee dat de Webex voor Cisco BroadWorks-organisatie moet bestaan (met de eerste gebruiker ingericht). In dit geval kunt u een van de volgende opties gebruiken om gebruikers te verplaatsen:

  • Gebruiker verplaatsen (met vertrouwde e-mail): gebruikt inrichting met vertrouwde e-mails

  • Gebruiker verplaatsen (met niet-vertrouwde e-mail): gebruikt inrichting met niet-vertrouwde e-mails

  • Zelfactivering


 
Als de Webex voor Cisco BroadWorks-organisatie nog niet is gemaakt (er zijn geen gebruikers ingericht), volgt u de normale inrichtingsprocessen (Inrichtingsgebruikers) om de organisatie te maken en de eerste gebruiker toe te voegen als een beheergebruiker. Nadat de eerste gebruiker is ingericht in de organisatie, volgt u de op toestemming gebaseerde methoden in deze procedure om volgende gebruikers te verplaatsen.

Gebruiker verplaatsen (met vertrouwd e-mailadres)

Als de onboardsjabloon vertrouwde e-mails gebruikt, kan de partnerbeheerder volgende gebruikers met dit proces verplaatsen:

  1. De beheerder voegt de gebruiker toe.

    • De gebruiker wordt gepusht naar de BroadWorks-inrichtingsbrug.

    • De CI-zoekopdracht bepaalt dat deze gebruiker een ander Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  2. De gebruiker opent de e-mail en klikt op Account activeren. De gebruiker wordt omgeleid naar de Webex-consumentenportal.

  3. Gebruiker meldt zich aan bij Webex.

  4. De gebruiker klikt op Verwijderen om het oude Webex-account te verwijderen.

    • Het oude Webex-account is verwijderd.

    • De gebruiker is ingericht in Webex voor Cisco BroadWorks met hetzelfde e-mailadres.

    • De gebruiker wordt omgeleid naar de pagina Downloaden.

Gebruiker verplaatsen (met niet-vertrouwde e-mail)

Als de onboardsjabloon niet-vertrouwde e-mails gebruikt, moet het e-mailadres van de gebruiker eerst worden gevalideerd. De beheerder kan dit proces volgen om volgende gebruikers te verplaatsen:

  1. De beheerder voegt de gebruiker toe.

    • De gebruiker wordt automatisch naar de BroadWorks-inrichtingsbrug gepusht.

    • Er wordt een tekst met een activeringskoppeling naar de gebruiker verzonden.

  2. De gebruiker klikt op de activeringskoppeling en voert het e-mailadres in.

    • De CI-zoekopdracht bepaalt dat deze gebruiker een ander Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op Nu deelnemen.

    • Het e-mailadres is gevalideerd.

    • De gebruiker wordt omgeleid om zich aan te melden bij de Webex-consumentenportal.

  4. Gebruiker meldt zich aan bij Webex.

  5. De gebruiker moet op Verwijderen klikken om het oude Webex-account te verwijderen.

    • Het oude Webex-account is verwijderd.

    • De gebruiker is ingericht in Webex voor Cisco BroadWorks met hetzelfde e-mailadres.

    • De gebruiker wordt omgeleid naar de pagina Downloaden.

Zelfactiveringsstroom

Als de gebruiker een bestaand BroadWorks-account heeft, kan hij of zij het zelfactiveringsproces gebruiken om zijn of haar account te verplaatsen.

  1. De gebruiker meldt zich aan bij de URL van de gebruikerstoegang met BroadWorks-aanmeldgegevens.

  2. De gebruiker voert zijn/haar e-mailadres in.

    • De gebruiker wordt gepusht naar de BroadWorks-inrichtingsbrug.

    • Er wordt een geautomatiseerd e-mailadres naar het e-mailadres van de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op de koppeling Nu deelnemen, waarmee het e-mailadres wordt gevalideerd.

    • CI zoekt gebruiker heeft een bestaand Webex-account. Gebruikers moeten het oude account verwijderen voordat ze kunnen doorgaan.

    • Gebruiker wordt omgeleid om zich aan te melden bij Webex.

  4. De gebruiker meldt zich aan bij de Consumentenportal.

  5. De gebruiker klikt op Account verwijderen.

    • Het oude Webex-account wordt verwijderd.

    • De gebruiker heeft een nieuw Webex voor Cisco BroadWorks-account met hetzelfde e-mailadres ingericht.

Webex voor BroadWorks toevoegen aan bestaande organisatie

Als u een partnerbeheerder bent die Webex voor BroadWorks-services toevoegt aan een bestaande Webex-klantorganisatie die nog niet is gekoppeld aan een door een partner beheerde BroadWorks-onderneming, MOET de beheerder van de klantorganisatie beheerderstoegang voor het inrichtingsverzoek goedkeuren om te slagen.

De goedkeuring van de organisatiebeheerder is vereist als een van de volgende situaties waar is:

  • De bestaande klantorganisatie heeft 100 gebruikers of meer

  • De organisatie heeft een geverifieerd e-maildomein

  • Het organisatiedomein is geclaimd

Als geen van de bovenstaande criteria waar is, kan een Automatic Attach optreden.


 
In een scenario met automatische bijlage wordt een Webex voor BroadWorks-abonnement toegevoegd aan een bestaande klantorganisatie zonder melding aan de bestaande organisatiebeheerder of eindgebruiker. In de meeste gevallen krijgt uw partnerorganisatie inrichtingsbeheerdersrechten. Als de klantorganisatie echter geen licenties heeft of alleen licenties heeft opgeschort/geannuleerd, wordt u een volledige beheerder gemaakt.

Met toegang tot de inrichtingsbeheerder hebt u beperkte zichtbaarheid in Control Hub voor de gebruikers in de bestaande organisatie. Het wordt aanbevolen dat u contact opneemt met de klantbeheerder en volledige beheerderstoegang tot de organisatie aanvraagt.

Partnerbeheerders kunnen de volgende procedure voltooien om BroadWorks-gespreksservices toe te voegen aan een bestaande Webex-organisatie:


 
In Partnerhub moet de schakelaar Bestaande organisaties inrichten zijn ingeschakeld in de instellingen voor Onboarding-sjabloon van die organisatie (de schakelaar is standaard ingeschakeld).
1

De partnerbeheerder richt Webex voor Cisco BroadWorks in voor de klant. Zie Inrichting van klantorganisaties voor hulp. Nu gebeurt het volgende:

  • Organisatiebijlage mislukt met een 2017 fout (Kan abonnee niet inrichten in een bestaande Webex-organisatie). (Er wordt geen fout ontvangen tijdens een automatische bijlage.)

  • Er wordt een e-mailmelding gegenereerd en verzonden naar de beheerders van de klantorganisatie (maximaal vijf beheerders). In de e-mailmelding wordt het e-mailadres van de partnerbeheerder gemarkeerd (zoals geconfigureerd in de sjabloon voor onboarding in Partner Hub) en wordt de organisatiebeheerder gevraagd de partnerbeheerder goed te keuren als externe beheerder. De klantorganisatiebeheerder moet het verzoek goedkeuren en de partnerbeheerder volledige beheerder toegang geven tot de klantorganisatie.


 

Stel dat de klantbeheerder geen e-mail ontvangt. In dat geval kan de klantbeheerder de partnerbeheerder (opgegeven in de sjabloon) handmatig toevoegen als de externe beheerder van de klantorganisatie vanuit de Control Hub. Probeer de gebruiker vervolgens opnieuw in te richten, waardoor de Webex voor Cisco BroadWorks-klantvoorziening wordt geactiveerd.

2

Met volledige beheerderstoegang kan de partnerbeheerder het proces voor het inrichten van de klant voltooien. Vanaf stap 1 hierboven moet u de inrichting van de klant opnieuw proberen. Nu u een externe Full Admin bent, mag u de fout 2017 echter niet waarnemen.

Zodra de inrichting van gespreksservices is voltooid, is de bestaande klantorganisatie zichtbaar als klant onder de partnerorganisatie van Webex voor BroadWorks.


 
De naam van de bijgevoegde organisatie verandert niet in de bedrijfsnaam van BroadWorks. De naam van de bijgevoegde organisatie blijft behouden zoals die was voorafgaand aan het bijvoegproces.

Voorwaarden van organisatiebijlage

  • Het e-mailadres van de eerste BroadWorks-abonnee die is ingericht, moet overeenkomen met het e-mailadres van een bestaande gebruiker in de beoogde klantorganisatie. Anders wordt een nieuwe klantorganisatie gemaakt.

  • De eerste gebruiker van de bestaande organisatie die is ingericht voor Webex voor BroadWorks, is niet ingericht als beheerdersgebruiker. Instellingen en rechten van de bestaande organisatie worden behouden.

  • De bestaande verificatie-instellingen van de organisatie hebben voorrang op wat is geconfigureerd op de Webex for BroadWorks-inrichtingssjabloon. Als gevolg hiervan verandert er niets aan de manier waarop bestaande gebruikers zich aanmelden.

    • Als de bestaande klantorganisatie echter basisbranding heeft ingeschakeld, hebben de geavanceerde branding-instellingen van de partner voorrang nadat de bijvoeging plaatsvindt. Als de klant wil dat de basisbranding intact blijft, moet de partner de klantorganisatie configureren om de branding in de instellingen voor geavanceerde branding te overschrijven.

  • De naam van de bestaande organisatie wordt niet gewijzigd.

  • Er is geen wijziging in de vlaggen voor e-mailonderdrukking in de instellingen van de bestaande organisatie. Dit kan van invloed zijn op nieuw ingerichte gebruikers. Afhankelijk van hoe de vlag is ingesteld, ontvangen nieuwe gebruikers al dan niet een e-mail met een code die moet worden ingevoerd om de activering te voltooien.

  • De beperkte beheermodus (ingesteld door de schakelaar voor beperkte partnermodus) is uitgeschakeld voor de bijgevoegde organisatie.

  • Zorg ervoor dat u het bevestigingsproces voor de organisatie voltooit (bestaande gebruikers verplaatsen en de organisatie-id bijwerken) voordat u nieuwe gebruikers inricht in de Webex voor Cisco BroadWorks-organisatie.

  • Een BroadWorks-onderneming kan slechts aan één Webex-organisatie worden gekoppeld. U kunt abonnees van één BroadWorks-onderneming niet inrichten in afzonderlijke Webex-organisaties.

Externe beheerder toevoegen

Zie het artikel Aanvraag externe beheerder goedkeuren voor de stappen die klantorganisatiebeheerders kunnen volgen om de partnerbeheerder toe te voegen als externe beheerder op help.webex.com.


 
De klantbeheerder moet de externe beheerder de volledige beheerdersrechten en -rechten geven.

 
Het e-mailadres dat de beheerder van de klantorganisatie als externe beheerder toevoegt, moet overeenkomen met het e-mailadres van de partnerbeheerder zoals is geconfigureerd in de sjabloon voor onboarding op Partner Hub.

Nadat u de e-mail van het onboardsjabloon op Partnerhub hebt toegevoegd als volledige beheerder, moeten eventuele extra partnerbeheerders ook worden toegevoegd als externe beheerder met volledige beheerdersrechten.

Webex voor BroadWorks loskoppelen van bestaande organisatie

Volg deze stappen om Webex voor BroadWorks los te koppelen van een bestaande Webex-organisatie. Als u bijvoorbeeld per ongeluk Webex voor BroadWorks aan een bestaande organisatie hebt gekoppeld en de bijlage wilt verwijderen.


 

Als u in Standaardstroom Webex voor BroadWorks loskoppelt van een bestaande Webex-organisatie (alleen standaardstroom), worden alle bijbehorende abonneegegevens verwijderd en wordt het Webex voor BroadWorks-abonnement van de klant gedeactiveerd. U verliest ook de toegang tot de klantorganisatie als dit het enige gekoppelde abonnement is. In de hybride stroom worden de klantabonnementen niet gewijzigd.

  1. Als u geen toegang hebt tot de klantinstellingen in Control Hub, laat de klantbeheerder u externe beheerder dan toegang verlenen door het verzoek van externe beheerder goed te keuren.

  2. Verwijder alle Webex voor BroadWorks-werkplekken uit de organisatie. Gebruik de API Een BroadWorks-werkplek verwijderen.

  3. Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de API Een BroadWorks-abonnee verwijderen.

  4. Verwijder in behandeling zijnde Webex voor BroadWorks-gebruikers uit de organisatie. Als gebruikers bijvoorbeeld zijn ingericht via de niet-vertrouwde e-mailstroom en er nog geen geldige e-mails zijn ingevoerd, blijven de gebruikers in behandeling. Volg Gebruikersvoorzieningen verifiëren met niet-vertrouwde e-mails om de gebruikers te verwijderen.

  5. Verwijder de configuratie van BroadWorks Calling voor deze klant. Open het Control Hub-exemplaar van de klant en klik op Hybrid onder het gedeelte BroadWorks Calling om alle configuraties te verwijderen.

Als u na de onthechting Webex voor BroadWorks aan de klant wilt koppelen, volgt u de inrichtingsprocessen om deze aan een bestaande klant te koppelen.


 
Een alternatieve optie om abonnees te verwijderen als u de API Een BroadWorks-abonnee verwijderen niet wilt gebruiken, is om naar BroadWorks CommPilot te gaan en de geïntegreerde IM&P-service voor de betrokken gebruikers te verwijderen.

Gebruikers en organisaties beheren

Als u gebruikers in Webex voor Cisco BroadWorks wilt beheren, moet u bedenken dat de gebruiker zowel in BroadWorks als in Webex bestaat. Belattributen en de BroadWorks-identiteit van de gebruiker worden in BroadWorks gehouden. Een afzonderlijke e-mailidentiteit voor de gebruiker en de licenties voor Webex-functies worden in Webex bewaard.

Gebruikersvoorzieningen verifiëren met niet-vertrouwde e-mails

Als u Webex voor BroadWorks-gebruikers inricht via doorstroominrichting met niet-vertrouwde e-mails, moeten gebruikers zichzelf inrichten door hun e-mailadres in de portal voor gebruikersactivering in te voeren. Als er een fout optreedt, kan de gebruiker de optie Opnieuw proberen gebruiken die in de portal wordt weergegeven om een nieuwe poging te doen. Als de gebruiker de fout opnieuw ondervindt, kan de beheerder de onderstaande stappen in Partner Hub gebruiken om de status te controleren en de gebruiker te onboarden, de gebruiker te verwijderen of configuratiewijzigingen toe te passen.

1

Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.

2

Klik op Sjablonen weergeven. Selecteer de juiste onboardsjabloon die u wilt toepassen op deze gebruiker.

3

Controleer onder Gebruikersverificatie of de volgende instellingen zijn ingesteld om ervoor te zorgen dat doorstroominrichting met niet-vertrouwde e-mails correct is geconfigureerd:

  • De optie Niet-vertrouwde e-mails moet zijn ingeschakeld
  • Het veld Koppeling delen moet naar de activeringskoppeling verwijzen. Als alles is geconfigureerd, kunnen gebruikers proberen zichzelf in te richten via de User Activation Portal.
4

Nadat de gebruiker is ingericht, klikt u in het gedeelte Gebruikersverificatie op Gebruikersstatus weergeven om de inrichtingsstatus te controleren.

In de weergave Gebruikersstatus wordt de lijst met gebruikers weergegeven, samen met details zoals de BroadWorks-id, het geselecteerde pakkettype en de huidige status. Deze weergave geeft aan of de gebruiker is ingericht of dat er een vereiste in behandeling is.
5

Voor gebruikers met fouten of vereisten in behandeling, klikt u op de drie stippen aan de rechterkant en kiest u een van de volgende beheeropties:

  • Activering opnieuw proberen: klik op deze optie om opnieuw te proberen de gebruiker te onboarden. Voer in het pop-upvenster een geldig e-mailadres in en klik op Onboard.
  • Gebruiker verwijderen: deze optie is mogelijk van toepassing als u de configuratie moet wijzigen om onboarding toe te staan. Nadat u de gebruiker hebt verwijderd en uw wijzigingen hebt aangebracht, kan de gebruiker opnieuw proberen te onboarden.
  • Pakkettype wijzigen: wijzig de instelling van het ene pakket naar het andere:
  • Fouttekst kopiëren: klik op deze optie om de fouttekst te kopiëren.

Aanvullende weergaveopties

De volgende extra opties zijn beschikbaar wanneer u de lijst met gebruikers bekijkt:

  • Exporteren: klik op deze knop als u de gebruikerslijst wilt exporteren naar een CSV-bestand.

  • Ingerichte gebruikers uitsluiten: schakel deze schakelaar in als u alleen gebruikers met vereisten of fouten in behandeling wilt weergeven.

Gebruikers-id of e-mailadres wijzigen

Wijzigingen gebruikers-id en e-mailadres

E-mail-id en alternatieve id zijn de BroadWorks-gebruikerskenmerken die worden gebruikt met Webex voor Cisco BroadWorks. De BroadWorks-gebruikers-id is nog steeds de primaire id van de gebruiker in BroadWorks. In de volgende tabel worden de doelstellingen van deze verschillende kenmerken beschreven en wordt beschreven wat u moet doen als u ze moet wijzigen:

Kenmerk in BroadWorksOvereenkomstig kenmerk in WebexDoelNotities
BroadWorks-gebruikers-idGeenPrimaire idU kunt deze id niet wijzigen en de gebruiker nog steeds aan hetzelfde account in Webex koppelen. U kunt de gebruiker verwijderen en opnieuw maken als dit onjuist is.
E-mail-idGebruikers-id

Verplicht voor doorstroominrichting (maken van Webex-gebruikers-id) wanneer u aangeeft dat u e-mail vertrouwt

Niet vereist in BroadWorks als u niet beweert dat u e-mails kunt vertrouwen

Niet vereist in BroadWorks als u abonnees toestaat zichzelf te activeren

Er is een handmatig proces om dit op beide plaatsen te wijzigen als de gebruiker het verkeerde e-mailadres heeft gekregen:

  1. Het e-mailadres van de gebruiker wijzigen in Control Hub

  2. E-mail-id-kenmerk wijzigen in BroadWorks

Wijzig de BroadWorks-gebruikers-id niet. Dit wordt niet ondersteund.

Alternatieve idGeenHiermee schakelt u het authn van de gebruiker in, via e-mail en wachtwoord, met de BroadWorks-gebruikers-idMoet hetzelfde zijn als de e-mail-id. Als U het e-mailadres niet in het kenmerk Alternatieve id kunt plaatsen, moeten gebruikers hun BroadWorks-gebruikers-id invoeren bij de verificatie.

Gebruikerspakket wijzigen in Partner Hub

1

Meld u aan bij Partner Hub en klik op Klanten.

2

Zoek en selecteer de klantorganisatie waar de gebruiker is gehuisvest.

De overzichtspagina van de organisatie wordt geopend in een deelvenster aan de rechterkant van het scherm.

3

Klik op Klant weergeven.

De klantorganisatie wordt geopend in Control Hub en toont de pagina Overzicht.
4

Klik op Users, zoek en klik op de getroffen gebruiker.

5

Klik in de Services van de gebruiker op Webex voor BroadWorks-pakketten (abonnementen).

Het deelvenster Pakketten van de gebruiker wordt geopend en u kunt zien welk pakket momenteel aan de gebruiker is toegewezen.

6

Kijk in het tabblad Profiel in het gedeelte Pakket en klik op het pijltje (>) om de weergave uit te vouwen.

7

Selecteer het gewenste pakket voor deze gebruiker (Basic, Standard, Premium of Softphone) en klik op Save.

Control Hub toont een bericht dat de gebruiker bijwerkt.

8

U kunt de gebruikersgegevens en het tabblad Control Hub sluiten.


 
Standaard- en Premium-pakketten hebben verschillende vergadersites die bij elk pakket horen. Wanneer een abonnee met beheerdersrechten met een van deze twee pakketten naar het andere pakket gaat, wordt de abonnee weergegeven met twee vergadersites in Control Hub. De vergaderingsmogelijkheden en vergaderingssite van de abonnee komen overeen met het huidige pakket. De vergadersite van het vorige pakket en alle eerder gemaakte inhoud op die site, zoals opnamen, blijven toegankelijk voor de sitebeheerder van de vergadering.

 
Het kan twee tot drie uur duren voordat nieuwe PMR-instellingen die het gevolg zijn van een pakketwijziging, worden bijgewerkt.

Gebruikers verwijderen

Er zijn verschillende methoden die beheerders kunnen gebruiken om een gebruiker te verwijderen uit Webex voor Cisco BroadWorks:


 
Als de gebruiker die u gaat verwijderen beheerdersrechten heeft, wijst u een nieuwe beheerder toe voordat u de gebruiker verwijdert. Er is geen automatische overdracht van de beheerdersrol als de laatste beheerder wordt verwijderd.

Webex voor Cisco BroadWorks API

Partnerbeheerders kunnen de Webex for Cisco BroadWorks API gebruiken om gebruikers te verwijderen:

  1. Voer de Remove a BroadWorks Subscriber API-aanvraag uit op https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Met deze aanvraag wordt het Webex for Cisco BroadWorks-abonnement verwijderd. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt behandeld als een gratis Webex-gebruiker.

  2. Voer het API-verzoek Een persoon verwijderen uit op https://developer.webex.com/docs/api/v1/people/delete-a-person om de gebruiker volledig te verwijderen.

Doorstroominrichting

Partnerbeheerders kunnen doorstroominrichting gebruiken om gebruikers te verwijderen:

  1. Op de BroadWorks-server verwijdert u de geïntegreerde IM+P-service van de gebruiker. U kunt de service voor de gebruiker uitschakelen via de pagina User – Integrated IM&P op BroadWorks. Zie 'Geïntegreerde IM&P configureren' in de Beheerhandleiding voor de webinterface van de Cisco BroadWorks-toepassingsservergroep – deel 2 voor een gedetailleerde procedure.

    Nadat de service is uitgeschakeld, verwijdert doorstroominrichting de Webex voor Cisco BroadWorks-susbscription van de gebruiker. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt behandeld als een gratis Webex-gebruiker.

  2. Zoek en selecteer de gebruiker in Control Hub.

  3. Ga naar Actions en selecteer Delete User.

Control Hub (klantbeheerders)

Klantbeheerders kunnen Control Hub gebruiken om gebruikers uit hun organisatie te verwijderen. Zie Een gebruiker uit uw organisatie verwijderen in Webex Control Hub op https://help.webex.com/0qse04/ voor meer informatie.

Organisatie verwijderen

Volg deze procedure om een Webex voor Cisco BroadWorks-organisatie uit het systeem te verwijderen.
1

Gebruik de People API's om alle gebruikers uit de organisatie te verwijderen:

  1. Voer de API Personen weergeven uit om een lijst met gebruikers op te halen.

  2. Voer de API Een persoon verwijderen uit om de gebruikers te verwijderen.


 
Met de Een BroadWorks-abonnee-API verwijderen worden Webex voor Cisco BroadWorks-rechten van een gebruiker verwijderd, maar wordt de gebruiker niet verwijderd.
2

Als adreslijstsynchronisatie is ingeschakeld, schakelt u deze uit. Dit kan via Partner Hub of via de openbare API.

Adreslijstsynchronisatie uitschakelen via Partner Hub:

  1. Meld u aan bij Partner Hub en klik op Instellingen.

  2. Klik onder BroadWorks Calling op Sjablonen weergeven en selecteer de juiste sjabloon.

  3. Klik op de knop Toon statuslijst klantsynchronisatie in het zijpaneel.

  4. Voor de juiste klant klikt u op de drie stippen helemaal rechts en selecteert u Synchronisatie uitschakelen.

Als u adreslijstsynchronisatie via API wilt uitschakelen, gebruikt u Adreslijstsynchronisatie voor een BroadWorks Enterprise-API bijwerken en schakelt u de instelling enableDirSync uit.

Alle gebruikers met betrekking tot BroadWorks-adreslijstsynchronisatie voor deze organisatie worden verwijderd. Houd er rekening mee dat het verwijderen van gebruikers (met behulp van een van beide methoden) enige tijd kan duren, afhankelijk van de hoeveelheid gebruikers.

3

Nadat alle gebruikers zijn verwijderd, gebruikt u de API Een organisatie verwijderen om de organisatie te verwijderen.

Vrijgavebeheer

Bedieningselementen voor releasebeheer in Partner Hub maken het eenvoudig voor Webex voor Cisco BroadWorks-serviceproviders om releases te beheren door hen de mogelijkheid te geven de releasecadans te beheren waarmee de Webex-apps van gebruikers upgraden naar de nieuwste software.

De Webex-app maakt standaard gebruik van automatische upgrades (door Cisco beheerde maandelijkse versies). Met deze functie kunnen partnerbeheerders echter:

  • Aangepaste releaseschema's configureren met uitstel van de standaardreleaseschema's van Cisco

  • Configureer één releaseschema en trapsgewijs die planning naar alle klantorganisaties die ze beheren

  • Verschillende releaseschema's toewijzen aan verschillende klantorganisaties

Zie het Webex-artikel Aanpassingen voor releasebeheer voor meer informatie over releasebeheer, waaronder informatie over het configureren en toepassen van aangepaste releaseplanningen.

Het systeem opnieuw configureren

U kunt het systeem als volgt opnieuw configureren:

  • Een BroadWorks-cluster toevoegen in Partner Hub

  • Een BroadWorks-cluster bewerken of verwijderen in Partnerhub

  • Een onboardingsjabloon toevoegen in Partner Hub

  • Een onboardsjabloon bewerken of verwijderen in Partner Hub

Een BroadWorks-cluster bewerken of verwijderen in Partnerhub

U kunt een BroadWorks-cluster bewerken of verwijderen in Partnerhub.

1

Meld u aan bij Partner Hub met uw partnerbeheergegevens op https://admin.webex.com.

2

Ga naar Instellingen en zoek het gedeelte BroadWorks-gesprekken.

3

Klik op Clusters weergeven.

4

Klik op het cluster dat u wilt bewerken of verwijderen.

De clusterdetails worden weergegeven in een flyout-venster aan de rechterkant.
5

U hebt de volgende opties:

  • Wijzig de gegevens die u moet wijzigen en klik op Opslaan.
  • Klik op Verwijderen om het cluster te verwijderen en bevestig.

     

    Als er veel klanten (>50) in het BroadWorks-cluster zijn, worden bewerkingen zoals het bijwerken van XSI-acties, XSI-gebeurtenissen, DAS-URL, XSP|ADP-URL of NST-synchronisatie niet ondersteund. In dergelijke gevallen wordt het aanbevolen contact op te nemen met een Cisco TAC-ondersteuningsmedewerker voor ondersteuning.

    Als een sjabloon is gekoppeld aan het cluster, kunt u een cluster niet verwijderen. Verwijder de gekoppelde sjablonen voordat u het cluster verwijdert. Zie Een onboardsjabloon bewerken of verwijderen in Partnerhub.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Een onboardsjabloon bewerken of verwijderen in Partner Hub

U kunt sjablonen voor onboarding bewerken of verwijderen in Partner Hub.

1

Meld u aan bij Partner Hub met uw partnerbeheergegevens op https://admin.webex.com.

2

Ga naar Instellingen en zoek het gedeelte BroadWorks-gesprekken.

3

Klik op Sjablonen weergeven.

4

Klik op de sjabloon die u wilt bewerken of verwijderen.

5

U hebt de volgende opties:

  • Bewerk de gegevens die u moet wijzigen en klik op Opslaan.
  • Klik op Verwijderen om de sjabloon te verwijderen en bevestig.

Instelling

Waarden

Notities

Accountnaam/wachtwoord inrichten

Door gebruiker geleverde tekenreeksen

U hoeft de inrichtingsaccountgegevens niet opnieuw in te voeren bij het bewerken van een sjabloon. De velden Leeg wachtwoord/Wachtwoordbevestiging zijn er om de referenties te wijzigen als dat nodig is, maar laat ze leeg om de waarden te behouden die u oorspronkelijk hebt opgegeven.

E-mailadres van de gebruiker vooraf invullen op de aanmeldpagina

Aan/uit

Het kan tot 7 uur duren voordat een wijziging in deze instelling van kracht wordt. Dat wil zeggen, nadat u deze hebt ingeschakeld, moeten gebruikers mogelijk nog steeds hun e-mailadres invoeren op het aanmeldscherm.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Webex Assistant

Webex-assistent Meetings is een intelligente, interactieve virtuele vergaderingassistent die vergaderingen doorzoekbaar, actiebaar en productiever maakt. U kunt de Webex Assistant vragen actie-items op te volgen, belangrijke beslissingen te nemen en belangrijke momenten tijdens een vergadering of gebeurtenis te markeren.

Webex Assistant voor vergaderingen is gratis beschikbaar voor vergadersites met het Premium- en Standard-pakket en voor persoonlijke vergaderruimten. Support omvat zowel nieuwe als bestaande sites.

Webex Assistant voor vergaderingen inschakelen

Webex Assistant is standaard ingeschakeld voor zowel Standard- als Premium-pakket Broadworks-klanten.

Partnerbeheerders en klantorganisatiebeheerders kunnen de functie voor klantorganisaties uitschakelen via Control Hub.

Beperkingen

De volgende beperkingen bestaan voor Webex voor Cisco BroadWorks:

  • De ondersteuning is beperkt tot vergadersites met het Premium- en Standard-pakket en alleen persoonlijke vergaderruimten.

  • Transcripties voor ondertiteling worden alleen ondersteund in het Engels, Spaans, Frans en Duits.

  • Inhoud delen via e-mail is alleen toegankelijk voor gebruikers binnen uw organisatie

  • Vergaderingsinhoud is niet toegankelijk voor gebruikers buiten uw organisatie. Vergaderingsinhoud is ook niet toegankelijk wanneer deze wordt gedeeld tussen gebruikers van verschillende pakketten binnen dezelfde organisatie.

  • Met het Premium-pakket zijn transcripties na de vergadering beschikbaar, ongeacht of Webex Assistant is in- of uitgeschakeld. Als er echter lokale opname is geselecteerd, worden er geen transcripties of markeringen na de vergadering vastgelegd.

  • Met het standaardpakket is de optie Vergadering opnemen in de cloud niet beschikbaar en zijn transcripties na de vergadering dus niet beschikbaar, ongeacht of Webex Assistant is in- of uitgeschakeld. Als lokale opname is geselecteerd, worden zelfs transcripties of markeringen na de vergadering niet vastgelegd.

Aanvullende Informatie Over Webex Assistant

Zie Webex Assistant gebruiken in Webex Meetings en Events voor gebruikersinformatie over het gebruik van de functie.

Webex-gesprekken uitschakelen

Gratis bellen via Webex is standaard ingeschakeld zodat gebruikers gratis gesprekken kunnen voeren naar elk apparaat waarvoor Webex is ingeschakeld. Als u echter wilt dat alle gesprekken de BroadWorks-infrastructuur gebruiken, kunt u Webex-gesprekken binnen een onboardsjabloon uitschakelen. Hiermee schakelt u die optie uit voor de klantorganisaties die de sjabloon gebruiken.

Functieondersteuning

Wanneer Webex Calling is uitgeschakeld, zijn de volgende voorwaarden van toepassing op Webex voor Cisco BroadWorks-gebruikers:

  • Gebruikers zien Bellen met Webex niet meer als een selecteerbare gespreksoptie in de Webex-app.

  • Gebruikers kunnen geen gratis Webex-gesprekken plaatsen of ontvangen naar niet-Webex voor Cisco BroadWorks-gebruikers. Dit omvat gesprekken die zijn gestart vanuit een Webex-teamruimte, gespreksgeschiedenis, contactpersonen door de URI of het e-mailadres van de andere gebruiker in te voeren in de zoekbalk.

  • Scherm delen werkt binnen een BroadWorks-gesprek.

  • Webex-vergaderingen en telefonische aanwezigheid werken nog steeds, zelfs als Webex-gesprekken zijn uitgeschakeld.

Webex-gesprekken uitschakelen (nieuwe onboardsjabloon)

Tijdens het configureren van een nieuwe onboardsjabloon kunt u configureren of Webex-gesprekken worden in- of uitgeschakeld door het selectievakje Gratis bellen via Cisco Webex uitschakelen in de wizard Een nieuwe sjabloon toevoegen in te schakelen of uit te schakelen. Deze instelling wordt opgehaald voor gebruikers in klantorganisaties die u aan de sjabloon toewijst.

Zie Uw partnerorganisatie configureren in Partner Hub voor meer informatie over het configureren van een nieuwe integratiesjabloon.

Webex-gesprekken uitschakelen (bestaande onboardsjabloon)

Volg deze procedure om Webex-gesprekken uit te schakelen van een bestaande integratiesjabloon. Hiermee wordt de functie uitgeschakeld voor alle nieuwe gebruikers in klantorganisaties die deze sjabloon gebruiken.

  1. Meld u aan bij Partnerhub op admin.webex.com.

  2. Kies Instellingen.

  3. Klik op Sjabloon weergeven en kies de juiste onboardingsjabloon.

  4. Klik op Cisco Webex Free Calling uitschakelen.

  5. Klik op Opslaan.

Webex-gesprekken uitschakelen (bestaande gebruiker)

Als u deze functie uitschakelt op een onboardsjabloon, wordt de instelling alleen gewijzigd voor nieuwe gebruikers die zijn toegewezen aan de sjabloon. Als u Webex-gesprekken wilt uitschakelen voor een bestaande gebruiker, kunt u een van de onderstaande procedures volgen om de gebruiker bij te werken.


 
Zorg ervoor dat u al een van de bovenstaande procedures hebt voltooid om Webex-gesprekken uit te schakelen van de onboardsjabloon waaraan de gebruiker is toegewezen. Anders configureert een van de onderstaande procedures de gebruiker opnieuw met Webex-gesprekken ingeschakeld.

Als u flow-through provisioning gebruikt, kunt u het volgende doen:

  1. Open CommPilot en ga naar de gebruikersconfiguratie.

  2. Verwijder de geïntegreerde IM+P-service van de gebruiker en klik op OK.

  3. Voeg de geïntegreerde IM+P-service toe aan de gebruiker en klik op OK.

Anders kunt u de API gebruiken om de gebruiker bij te werken.

  1. Gebruik de Een BroadWorks-abonnee-API verwijderen om de gebruiker te verwijderen.

  2. Gebruik de Een BroadWorks-abonnee-API inrichten om de gebruiker toe te voegen.

Video of scherm delen uitschakelen in gesprekken

Partnerbeheerders kunnen configuratietags gebruiken om videogesprekken en/of scherm delen uit te schakelen in een gesprek vanuit de Webex-app (beide mediatypen zijn standaard ingeschakeld voor gesprekken).

Zie Videogesprekken uitschakelen en Scherm delen uitschakelen in de configuratiehandleiding van Webex voor Cisco BroadWorks voor meer informatie over de configuratie en opties.


 
Voor video kunt u ook configureren of media voor inkomende gesprekken standaard alleen video of audio zijn.

Busy Lamp Field (BLF)/melding voor gesprek opnemen

Busy Lamp Field (BLF)/melding voor gesprek opnemen maakt gebruik van de functies BLF en doorverbonden gesprek opnemen. Een BLF-gebruiker ontvangt een auditieve en visuele melding in de Webex-app wanneer een gebruiker uit de BLF-bewaakte lijst een binnenkomend gesprek ontvangt. De BLF-gebruiker kan het gesprek van de gecontroleerde gebruiker negeren of opnemen.

De BLF-/Call Pickup-melding helpt in situaties waarin een gebruiker gesprekken moet beantwoorden voor andere teamleden die op een andere locatie werken.

Gebruikers kunnen hun door BLF gecontroleerde lijst ook zien in het gedeelte Multi-gespreksvenster - Wachtlijst - (alleen Windows, Mac niet ondersteund) om de aanwezigheid van hun Webex- en niet-Webex-teamleden te zien. Webex-leden hebben een volledige Webex-aanwezigheid. Niet-Webex-leden moeten worden gesynchroniseerd met een telefoonlijst in Webex. Ze hebben alleen de status 'onbekend' en 'in-a-call' (de belstatus activeert het dialoogvenster voor gesprek opnemen).

Beperkingen van aanwezigheid voor niet-Webex-gebruikers:

  1. Aanwezigheid wordt niet ondersteund voor niet-CI Broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.

  2. CI-gebruikers zonder Webex-cloudrechten of computertype accounts (werkplekken) geven alleen aanwezigheid 'in gesprek' en 'onbekend' weer. Er is geen status actief, overgaan, enz.

  3. Niet-Webex-gebruikers uit de BLF-volglijst, die een gesprek hebben gestart voordat de Webex-client werd gestart of terwijl deze offline was, worden weergegeven met een 'onbekende' aanwezigheid.

  4. Als u uw verbinding verliest, worden alle niet-Webex-gespreksstatussen bij het opnieuw verbinden teruggezet op 'onbekend'.

  5. Als een niet-Webex-gebruiker van de BLF een gesprek heeft, wordt dit gesprek nog steeds weergegeven als 'in een gesprek'.

Vereisten

Zorg ervoor dat de volgende patches worden toegepast op BroadWorks. Installeer alleen de patches die van toepassing zijn op uw versie:

Voor R22:

  • AP.platform.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382362

  • AP.xsp.22.0.1123.ap382053

  • AP.xsp.22.0.1123.ap382362

  • AP.as.22.0.1123.ap383459

  • AP.as.22.0.1123.ap383520

Voor R23:

  • AP.platform.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382362

  • AP.as.23.0.1075.ap383459

  • AP.as.23.0.1075.ap383520

  • Als u XSP|ADP gebruikt:

    • AP.xsp.23.0.1075.ap382053

    • AP.xsp.23.0.1075.ap382362

  • Als u ADP gebruikt:

    • Xsi-Actions-23_2022.01_1.200.bwar

    • Xsi-Events-23_2022.01_1.201.bwar (of hoger)

Voor R24:

  • AP.as.24.0.944.ap382053

  • AP.as.24.0.944.ap382362

  • AP.as.24.0.944.ap383459

  • AP.as.24.0.944. ap383520

  • Xsi-Actions-24_2022.01_1.200.bwar

  • Xsi-Events-24_2022.01_1.201.bwar (of hoger)

Zorg ervoor dat de volgende configuratietags zijn ingeschakeld in de Webex-app:

  • <busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">

  • <display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>

  • <notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>(deze tag is optioneel)

U moet functie 101642 Verbeterd Xsi-mechanisme Voor Teamtelefonie activeren op de AS:

AS_CLI/System/ActivatableFeature> activate 101642

Inschakelen X-BroadWorks-Remote-Party-Info op de AS met de onderstaande CLI-opdracht omdat voor sommige SIP-gespreksstromen deze functie nodig is:

AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Zorg ervoor dat de volgende services zijn toegewezen aan gebruikers:

  • De service Doorverbonden gesprek aannemen toewijzen voor alle gebruikers

  • Busy Lamp Field instellen voor gebruikers


 
Elke verwijzing naar XSP omvat XSP of ADP.

Busy Lamp Field configureren op BroadWorks

Partnerbeheerders kunnen de volgende procedure gebruiken om Busy Lamp Field in te stellen voor een gebruiker.

  1. Meld u aan bij BroadWorks CommPilot.

  2. Ga voor een geselecteerde gebruiker naar Clienttoepassingen en configureer het Busy Lamp Field.

  3. Voeg de URL van de BLF-lijst toe die wordt gecontroleerd.

  4. Gebruik de zoekparameters om gebruikers te zoeken en toe te voegen aan de lijst Bewaakte gebruikers.

  5. Klik op OK.

Slido Integratieondersteuning

Webex voor Cisco BroadWorks ondersteunt integratie van de Webex-app met Slido.

Slido is een eenvoudig te gebruiken tool voor betrokkenheid van het publiek. Het helpt mensen om het meeste uit vergaderingen te halen door de kloof tussen sprekers en hun publiek te overbruggen. Wanneer Slido is geïntegreerd in uw Control Hub-organisatie, kunnen uw gebruikers de Slido app toevoegen aan hun vergaderingen in de Webex-app. Deze integratie biedt extra vraag en antwoord en enquêtefunctionaliteit voor de vergadering.

Zie SlidoIntegreren met Webex-appSlido voor meer informatie over het implementeren en gebruiken met de Webex-app.

Webex-beschikbaarheid: In een agendavergadering

Wanneer u een vergadering in uw Outlook-client hebt geaccepteerd die een afspraak, ad-hocvergadering of een niet-Webex-vergadering is, wordt uw Webex-beschikbaarheid weergegeven als 'In een agendavergadering'. Deze beschikbaarheid laat uw collega's weten dat u anders betrokken bent en dat een reactie kan worden vertraagd.

Deze functie inschakelen:

  1. ga naar het tabblad Algemeen van uw tabblad Instellingen in Windows of Voorkeuren op de Mac.

  2. Schakel het selectievakje Weergeven in een agendavergadering in.


 
Voor gebruikers met ingeschakelde Outlook-aanwezigheidsintegratie wordt 'In een agendavergadering' in Webex toegewezen aan 'Bezet' in Outlook.

Caveat

Om deze functie te laten werken, moet de Webex-app en de Outlook-client tegelijkertijd worden uitgevoerd.

We werken momenteel aan de ondersteuning van de optie 'Show as Working Elsewhere' in Outlook om een gebruiker niet weer te geven als 'In een agendavergadering' in Webex.

Als een gebruiker ervoor kiest om 'Weergeven wanneer in een agendavergadering' uit te schakelen terwijl hij of zij momenteel in een agendavergadering zit, wordt zijn of haar aanwezigheid pas bijgewerkt wanneer de vergadering is beëindigd. Hiervoor moet de client opnieuw worden gestart om op te halen.

Automatisch beantwoorden met toon

Met automatisch beantwoorden met toon kunnen gebruikers bellen vanuit een app van derden, zoals Contact Center, en wordt het gesprek automatisch gerouteerd via de Webex-app op hun bureaublad. Wanneer de Webex-app de andere partij belt, hoort de gebruiker een bepaalde toon met het advies dat het gesprek wordt verbonden.

Voor een Webex voor Cisco BroadWorks-gebruiker om deze functie te gebruiken:

  • De functie wordt alleen ondersteund op de weergave van de primaire lijn

  • De Webex-app moet de primaire lijnweergave zijn

  • De %ENABLE_AUTO_ANSWER_WXT%-tag moet zijn ingeschakeld

Als de gebruiker ook Gedeelde gespreksweergaven heeft (een bureautelefoon wordt bijvoorbeeld geconfigureerd als een van de weergaven van de secundaire lijn), wordt de functie nog steeds ondersteund op de primaire weergave zolang de weergaven van gedeelde gesprekken zijn geconfigureerd om geen inkomende gesprekken te ontvangen. Dit kan worden bereikt door een van de volgende drie voorwaarden te configureren in BroadWorks voor alle gedeelde gespreksweergaven:

  • Alle weergaven voor Click-to-Dial-gesprekken waarschuwen is uitgeschakeld in de configuratie voor weergave gedeeld gesprek. Dit is de aanbevolen aanpak

    of

  • Beëindiging toestaan op deze locatie moet zijn uitgeschakeld voor alle gedeelde gespreksweergaven of

    of

  • Locaties zijn uitgeschakeld voor alle weergaven van gedeelde gesprekken

Capaciteit verhogen

XSP|ADP-bedrijven

We raden u aan de capaciteitsplanner te gebruiken om te bepalen hoeveel extra XSP|ADP-resources u nodig hebt voor de voorgestelde toename van het aantal abonnees. Voor de speciale NPS of Webex voor Cisco BroadWorks-boerderijen hebt u de volgende schaalbaarheidsopties:

  • Schaalspecifieke boerderij: Voeg een of meer XSP|ADP-servers toe aan het bedrijf die extra capaciteit nodig hebben. Installeer en activeer dezelfde set toepassingen en configuraties als de bestaande knooppunten van de boerderij.

  • Specifieke boerderij toevoegen: Voeg een nieuwe, specifieke XSP|ADP-boerderij toe. U moet een nieuw cluster en nieuwe sjablonen maken in Partner Hub, zodat u nieuwe klanten kunt toevoegen op de nieuwe boerderij om de druk op de bestaande boerderij te verlichten.

  • Gespecialiseerde boerderij toevoegen: Als u knelpunten ondervindt voor een bepaalde service, wilt u mogelijk een afzonderlijke XSP|ADP-farm creëren voor dat doel, rekening houdend met de vereisten voor co-residency vermeld in dit document. Mogelijk moet u uw Control Hub-clusters en DNS-vermeldingen opnieuw configureren als u de URL wijzigt van de service met een nieuwe boerderij.

In alle gevallen is het uw verantwoordelijkheid om uw BroadWorks-omgeving te controleren en te bevoorraden. Als u Cisco-ondersteuning wilt inschakelen, kunt u contact opnemen met uw accountvertegenwoordiger, die professionele services kan regelen.

HTTP-servercertificaten beheren

U moet deze certificaten voor mTLS-geverifieerde webtoepassingen beheren op uw XSP|ADP's:

  • Ons certificaat voor de vertrouwensketen van de Webex-cloud

  • De certificaten van uw XSP|ADP HTTP-serverinterfaces

Vertrouwensketen

U downloadt het certificaat van de vertrouwensketen van Control Hub en installeert het op uw XSP|ADP's tijdens uw eerste configuratie. We verwachten dat u het certificaat bijwerkt voordat het verloopt en u informeert over hoe en wanneer u het kunt wijzigen.

Uw HTTP-serverinterfaces

De XSP|ADP moet een openbaar ondertekend servercertificaat presenteren aan Webex, zoals wordt beschreven in Certificaten bestellen. Er wordt een zelfondertekend certificaat gegenereerd voor de interface wanneer u de interface voor het eerst beveiligt. Dit certificaat is één jaar geldig vanaf die datum. U moet het zelfondertekende certificaat vervangen door een openbaar ondertekend certificaat. Het is uw verantwoordelijkheid om een nieuw certificaat aan te vragen voordat het verloopt.

Beperkt door partnermodus

Beperkt door de partnermodus is een Partner Hub-instelling die partnerbeheerders kunnen toewijzen aan specifieke klantorganisaties om de organisatie-instellingen te beperken die klantbeheerders kunnen bijwerken in Control Hub. Wanneer deze instelling is ingeschakeld voor een bepaalde klantorganisatie, hebben alle klantbeheerders van die organisatie, ongeacht hun rolrechten, geen toegang tot een set beperkte besturingselementen in Control Hub. Alleen een partnerbeheerder kan de beperkte instellingen bijwerken.


 
Beperkt door de partnermodus is een instelling op organisatieniveau in plaats van een rol. De instelling beperkt echter specifieke rolrechten voor klantbeheerders in de organisatie waarop de instelling wordt toegepast.

Toegang als klantbeheerder

Klantbeheerders ontvangen een melding wanneer de modus Beperkt door partner wordt toegepast. Nadat ze zich hebben aangemeld, zien ze een meldingsbanner boven aan het scherm, direct onder de Control Hub-koptekst. De banner informeert de klantbeheerder dat de beperkte modus is ingeschakeld en dat deze bepaalde gespreksinstellingen mogelijk niet kan bijwerken.

Voor een klantbeheerder in een organisatie waar de modus Beperkt door partner is ingeschakeld, wordt het toegangsniveau van Control Hub bepaald met de volgende formule:

(Toegang tot Control Hub) = (rechten van organisatierol) - (beperkt door beperkingen in de partnermodus)

Beperkingen

Wanneer de modus Beperkt door partner is ingeschakeld voor een klantorganisatie, hebben klantbeheerders in die organisatie geen toegang tot de volgende Control Hub-instellingen:

  • In de weergave Gebruikers zijn de volgende instellingen niet beschikbaar:

    • De knop Gebruikers beheren is grijs.

    • Gebruikers handmatig toevoegen of wijzigen: er is geen optie om gebruikers handmatig of via CSV toe te voegen of te wijzigen.

    • Gebruikers claimen: niet beschikbaar

    • Licenties automatisch toewijzen: niet beschikbaar

    • Adreslijstsynchronisatie -Kan instellingen voor directorysynchronisatie niet bewerken (deze instelling is alleen beschikbaar voor beheerders op partnerniveau).

    • Gebruikersgegevens: gebruikersinstellingen zoals voornaam, achternaam, weergavenaam en primair e-mailadres* kunnen worden bewerkt.

    • Pakket herstellen: er is geen optie om het pakkettype te herstellen.

    • Services bewerken: er is geen optie om de services te bewerken die zijn ingeschakeld voor een gebruiker (bijvoorbeeld Berichten, Vergaderingen, Bellen)

    • Status van services weergeven: kan de volledige status van hybride services of software-upgradekanaal niet zien

    • Primair werknummer: dit veld is alleen-lezen.

  • In de weergave Account zijn de volgende instellingen niet beschikbaar:

    • Bedrijfsnaam is alleen-lezen.

  • In de weergave Organisatie-instellingen zijn de volgende instellingen niet beschikbaar:

    • Domein: toegang is alleen-lezen.

    • E-mail: de instellingen voor E-mailuitnodiging beheerder onderdrukken en Landinstelling e-mailadres zijn alleen-lezen.

    • Verificatie: er is geen optie om de instellingen Verificatie en SSO te bewerken.

  • In het menu Bellen zijn de volgende instellingen niet beschikbaar:

    • Gespreksinstellingen: de instellingen voor gespreksprioriteit van de appopties zijn alleen-lezen.

    • Belgedrag: instellingen zijn alleen-lezen.

    • Locatie > PSTN: de opties Lokale gateway en Cisco PSTN zijn verborgen.

  • Onder SERVICES worden de serviceopties Migraties en Verbonden UC onderdrukt.

Beperkt door partnermodus inschakelen

Partnerbeheerders kunnen de onderstaande procedure gebruiken om: Beperkt door partnermodus voor een bepaalde klantorganisatie (de standaardinstelling is ingeschakeld).

  1. Meld u aan bij Partnerhub ( https://admin.webex.com) en selecteer Klanten.

  2. Selecteer de toepasselijke klantorganisatie.

  3. Schakel in de instellingenweergave aan de rechterkant de Beperkt door partnermodus toggle om de instelling in te schakelen.

    Als u de modus Beperkt door partner wilt uitschakelen, schakelt u de schakelaar uit.


 

Als de partner de beperkte beheermodus voor een klantbeheerder verwijdert, kan de klantbeheerder het volgende uitvoeren:

  • Webex voor groothandels toevoegen (met de knop)

  • Pakketten voor een gebruiker wijzigen

Partneranalyses

Dankzij verbeteringen in Control Hub kunnen partnerbeheerders eenvoudig pakketgegevens weergeven en bijwerken namens hun gebruikers. Deze functie biedt partners de mogelijkheid om een totaaloverzicht van alle klanten te krijgen en bevat de volgende details:

  • Totaal aantal gebruikers per pakket (Softphone, Basic, Standard, Premium)

  • Gebruiker per pakkettrend (dagelijks/wekelijks/maandelijks)

  • Klanten met het aantal toegewezen pakketten

Raadpleeg het Webex artikel voor volledige informatie over het gebruik van Partner Analytics Analyse voor Webex voor groothandel en Webex voor Broadworks-pakketten in Partner Hub .

API's voor factureringsrapport

Webex for Developers biedt openbare API's die kunnen worden gebruikt voor maandelijkse factureringsrapporten. Partnerbeheerders kunnen deze API's gebruiken om factureringsrapporten te maken, op te sommen, op te halen en te verwijderen. De volgende tabel bevat de API's, het type toegang dat vereist is en de rolvereisten.

API voor facturering

Doel

Type toegang

Rolvereiste voor API

(Beheerder vereist ten minste één van deze rollen)

Een BroadWorks-factureringsrapport maken

Wordt gebruikt om een factureringsrapport te genereren.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

BroadWorks-factureringsrapporten weergeven

Wordt gebruikt om de rapporten weer te geven die beschikbaar zijn om te bekijken.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks-factureringsrapport ophalen

Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks-factureringsrapport verwijderen

Wordt gebruikt om een gegenereerd rapport te verwijderen.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

Factureringsvelden

In de volgende tabel worden de velden weergegeven die in het gegenereerde rapport zijn opgenomen.

Veld

Beschrijving

resellerNaam

Partnernaam of organisatie-id van partner

billingId

Unieke facturerings-id of C-nummer van partner

spEnterprise-id

De door de serviceprovider geleverde unieke id voor de onderneming van de abonnee.

Intern

De status van de interne proefperiode van de klant (ja/nee)

userId

De gebruikers-id van de abonnee op BroadWorks

abonnee-id

Een unieke id voor de abonnee in kwestie in Webex

zelf geactiveerd

Ja/Nee

eersteStartdatum

Datum waarop de abonnee is ingericht.

factureringStartdatum

Datum waarop facturering begint in deze maand

Einddatum facturering

Datum waarop facturering deze maand eindigt

pakket

Het pakkettype dat in rekening wordt gebracht

hoeveelheid

Geprorateerde hoeveelheid voor facturatie.

  • 1: geeft een volledige maand aan


 
  • Nadat u een factureringsrapport voor een specifieke periode hebt gegenereerd, kunt u dat rapport niet opnieuw genereren, tenzij u eerst het bestaande rapport verwijdert.

  • Als u het pakkettype of de BroadWorks-gebruikers-id voor een bepaalde gebruiker wijzigt, worden in het rapport voor de maand waarin de wijziging heeft plaatsgevonden meerdere vermeldingen voor die gebruiker weergegeven met afzonderlijke geprorateerde vermeldingen voor en na de wijziging.

Problemen met Webex voor Cisco BroadWorks oplossen

Abonneren op de statuspagina van Webex

Controleer eerst https://status.webex.com wanneer u een onverwachte onderbreking van de service ervaart. Als u uw configuratie in Control Hub of BroadWorks niet hebt gewijzigd vóór de onderbreking, controleert u de statuspagina. Lees meer over het abonneren op status- en incidentmeldingen in het Webex-helpcentrum.

Analyse van Control Hub gebruiken

Webex houdt gebruiks- en kwaliteitsgegevens bij voor uw organisatie en de organisaties van uw klant. Lees meer over de Control Hub-analyse in het Webex-helpcentrum.

Netwerkproblemen

Klanten of gebruikers worden niet gemaakt in Control Hub met flowthrough-inrichting:

  • Kan de toepassingsserver de inrichtings-URL bereiken?

  • Zijn het inrichtingsaccount en het wachtwoord correct? Bestaat dat account in BroadWorks?

Clusters falen consequent in verbindingstests:


 

Er wordt verwacht dat de mTLS-verbinding met de verificatieservice mislukt wanneer u het eerste cluster in Partner Hub maakt, omdat u het cluster moet maken om toegang te krijgen tot de Webex-certificaatketen. Zonder dat kunt u geen vertrouwensanker maken voor de verificatieservice XSP|ADP's. De mTLS-verbinding testen vanuit Partner Hub is dus niet gelukt.

  • Zijn de XSP|ADP-interfaces openbaar toegankelijk?

  • Gebruikt u de juiste poorten? U kunt een poort invoeren in de interfacedefinitie op het cluster.

Validatie van interfaces mislukt

Xsi-acties en Xsi-events-interfaces:

  • Controleer of de interface-URL's juist zijn ingevoerd op het cluster in Partner Hub, inclusief de /v2.0/ aan het einde van de URL's.
  • Controleer of de firewall communicatie tussen Webex en deze interfaces mogelijk maakt.

  • Bekijk het advies voor interfaceconfiguratie in dit document.

Interface voor verificatieservice:

  • Controleer of de interface-URL's juist zijn ingevoerd op het cluster in Partner Hub, inclusief de /v2.0/ aan het einde van de URL's.
  • Controleer of de firewall communicatie tussen Webex en deze interfaces mogelijk maakt.

  • Bekijk het advies voor interfaceconfiguratie in dit document, met bijzondere aandacht voor:

    1. Zorg ervoor dat u RSA-sleutels hebt gedeeld met alle XSP|ADP's.
    2. Zorg ervoor dat u op alle XSP|ADP's de AuthService-URL voor de webcontainer hebt opgegeven.
    3. Als u de TLS-coderingsconfiguratie hebt bewerkt, controleert u of u de juiste naamgevingsconventie hebt gebruikt. Voor de XSP|ADP moet u de IANA-naamnotatie voor de TLS-cijfers invoeren. In een eerdere versie van dit document zijn de vereiste versleutelingssuites onjuist vermeld in de naamgevingsconventie van OpenSSL.
    4. Als u mTLS gebruikt met de verificatieservice, worden de Webex-clientcertificaten dan geladen in uw XSP|ADP/ADP-vertrouwensarchief? Is de app (of de interface) geconfigureerd om clientcertificaten te vereisen?

    5. Als u CI-tokenvalidatie gebruikt met de verificatieservice, is de app (of interface) dan geconfigureerd om geen clientcertificaten te vereisen?

Clientproblemen

Controleer of de client is verbonden met BroadWorks

  1. Meld u aan bij de Webex-app.

  2. Controleer of het pictogram Gespreksopties (een handset met een versnelling erboven) aanwezig is op de zijbalk.

    Als het pictogram niet aanwezig is, is de gebruiker mogelijk nog niet ingeschakeld voor de gespreksservice in Control Hub.

  3. Open het menu Instellingen/Voorkeuren en ga naar het gedeelte Telefoonservices. U ziet de status SSO-sessie Waarvoor U bent aangemeld.

    Als een andere telefoonservice, zoals Webex Calling, wordt weergegeven, gebruikt de gebruiker Webex niet voor Cisco BroadWorks.

Deze verificatie betekent:

  • De client heeft de vereiste Webex-microservices getransverseerd.

  • De gebruiker is geverifieerd.

  • De client heeft een langlevend JSON-webtoken ontvangen van uw BroadWorks-systeem.

  • De client heeft zijn apparaatprofiel opgehaald en geregistreerd bij BroadWorks.

Clientlogboeken

Alle clients van de Webex-app kunnen logboeken Verzenden naar Webex. Dit is de beste optie voor mobiele clients. U moet ook het e-mailadres van de gebruiker noteren en de geschatte tijd waarop het probleem is opgetreden als u hulp zoekt bij TAC. Zie Waar vind ik ondersteuning voor Webex voor meer informatie?

Als u handmatig logboeken moet verzamelen vanaf een Windows-pc, bevinden ze zich als volgt:

Windows-pc: C:\Users\{username}\AppData\Local\CiscoSpark

Mac:/Users/{username}/Library/Logs/SparkMacDesktop

Problemen met aanmelden gebruiker

mTLS-verificatie verkeerd geconfigureerd

Als alle gebruikers zijn getroffen, controleert u de mTLS-verbinding van Webex met uw verificatieservice-URL:

  • Controleer of de toepassing voor de verificatieservice of de interface die wordt gebruikt, is geconfigureerd voor mTLS.

  • Controleer of de Webex-certificaatketen is geïnstalleerd als vertrouwensanker.

  • Controleer of het servercertificaat op de interface/toepassing geldig is en ondertekend is door een bekende CA.

Bericht over licentieoverschrijding

Dit bericht kan voor een klant worden weergegeven in de klantweergave van Partnerhub. Dit bericht wordt weergegeven wanneer het licentiegebruik hoger is dan wat in de licentie is toegestaan. Het bericht kan worden genegeerd.

Handleiding voor probleemoplossing

Voor gedetailleerde informatie over het oplossen van problemen met Webex voor Cisco BroadWorks raadpleegt u de Handleiding voor het oplossen van problemen met Webex voor Cisco BroadWorks.

Ondersteuning

Ondersteuningsbeleid voor steady-state

De Dienstverlener is het eerste aanspreekpunt voor de eindklant (enterprise) support. Escaleer problemen die de SP niet kan oplossen naar TAC. Ondersteuning voor BroadWorks-serverversies volgt het BroadSoft-beleid van de huidige versie en twee eerdere grote versies (N-2). Lees meer op Beleid voor de levenscyclus van BroadSoft-producten sectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.

Escalatiebeleid

  • U (serviceprovider/partner) bent het eerste aanspreekpunt voor ondersteuning van eindklanten (enterprise).

  • Problemen die niet door de SP kunnen worden opgelost, worden geëscaleerd naar TAC.

BroadWorks-versies

Resources voor zelfondersteuning

  • Gebruikers kunnen ondersteuning vinden via het Webex-helpcentrum, waar er een Webex voor Cisco BroadWorks-specifieke pagina is met algemene help- en ondersteuningsonderwerpen voor de Webex-app.

  • De Webex-app kan worden aangepast met deze Help-URL en de URL van een probleemrapport.

  • Gebruikers van de Webex-app kunnen feedback of logboeken rechtstreeks vanaf de client verzenden. De logboeken gaan naar de Webex-cloud, waar ze kunnen worden geanalyseerd door Webex DevOps.

  • We hebben ook een Help Center-pagina die is toegewezen aan Help op beheerdersniveau voor Webex voor Cisco BroadWorks.

Informatie verzamelen om een serviceaanvraag in te dienen

Wanneer u fouten ziet in Control Hub, hebben ze mogelijk informatie bijgevoegd die TAC kan helpen uw probleem te onderzoeken. Als u bijvoorbeeld een traceer-id ziet voor een bepaalde fout of een foutcode, slaat u de tekst op om met ons te delen.

Probeer ten minste de volgende informatie op te nemen wanneer u een query indient of een case opent:

  • Organisatie-id van de klant en de organisatie-id van de partner (elke id is een tekenreeks van 32 hexadecimale tekens, gescheiden door koppeltekens)

  • TrackingID (ook een tekenreeks van 32 hexadecimale cijfers) als de interface of het foutbericht er een bevat

  • E-mailadres gebruiker (als een bepaalde gebruiker problemen ondervindt)

  • Clientversies (als het probleem symptomen heeft die door de client worden opgemerkt)

Webex voor BroadWorks-referentie

UC-One SaaS-vergelijking met Webex voor Cisco BroadWorks

Oplossing >

UC-One SaaS

Webex voor Cisco BroadWorks

Cloud

Cisco UC-One Cloud (GCP)

Webex-cloud (AWS)

Clients

UC-One: Mobiel, bureaublad

Receptionist, supervisor

Webex: Mobiel, Desktop, Web

Groot technologieverschil

Vergaderingen geleverd op Broadsoft Meet-technologie

Vergaderingen geleverd via Webex Meetings-technologie

Vroege veldproeven

Staging-omgeving, bètaclients

Productieomgeving, GA-klanten

Gebruikersidentiteit

BroadWorks-id diende als primaire id, tenzij de serviceprovider al SSO-integratie heeft.

 

Gebruikers-id en geheim in BroadWorks

E-mail-id in Cisco CI dient als primaire id

SSO-integratie in serviceprovider BroadWorks waarbij de gebruiker zich op dat moment verifieert met de BroadWorks-gebruikers-id en BroadWorks-geheim.

 

Gebruiker levert referenties via SSO met BroadWorks en geheim in BroadWorks

OF

Gebruikers-id en geheim in CI IdP

OF

Gebruikers-id in CI, ID en geheimen in IdP

Clientverificatie

Gebruikers leveren referenties via client

BroadWorks-tokens met een lange levensduur vereist bij gebruik van Webex-berichten

Gebruikers leveren referenties via de browser (aanmeldingspagina van Webex BIdP-proxy of CI)

Webex-toegangs- en vernieuwingstokens

Beheer / configuratie

Uw OSS/BSS-systemen en

Doorverkoopportaal

Uw OSS/BSS-systemen en Control Hub

Activering van partner/serviceprovider

Eenmalige installatie door Cisco Operations

Eenmalige installatie door Cisco Operations

Activering van klant/onderneming

Doorverkoopportaal

Control Hub

Automatisch gemaakt bij inschrijving eerste gebruiker

Activeringsopties voor de gebruiker

Zelfingeschreven

Externe IM&P instellen in BroadWorks

Geïntegreerde IM&P instellen in BroadWorks (doorgaans bedrijven)

XSP|ADP-serviceinterfaces

XSI-acties

 

XSI-gebeurtenissen

CTI (mTLS)

Verificatieservice (mTLS optioneel)

DMS

XSI-acties

XSI-acties (mTLS)

XSI-gebeurtenissen

CTI (mTLS)

Verificatieservice (TLS)

DMS

Webex installeren en aanmelden (Subscriber Perspective)

1

Download en installeer Webex. Zie Webex | De app downloaden voor meer informatie.

2

Webex uitvoeren.

Webex vraagt u naar uw e-mailadres.
3

Voer uw e-mailadres in en klik op Volgende.

4

Afhankelijk van de manier waarop uw organisatie in Webex is geconfigureerd, vindt een van de volgende handelingen plaats:

  1. Webex start een browser waarmee u de verificatie met uw identiteitsprovider kunt voltooien. Dit kan meervoudige verificatie (MFA) zijn.

  2. Webex start een browser waarin u uw BroadWorks-gebruikers-id en -wachtwoord kunt invoeren.

Webex wordt geladen nadat u bent geverifieerd met de IdP of BroadWorks.

Gegevensuitwisseling en -opslag

Deze secties bevatten details over gegevensuitwisseling en opslag met Webex. Alle gegevens worden zowel in transit als in rust versleuteld. Zie Beveiliging van de Webex-app voor meer informatie.

Onboarding serviceprovider

Wanneer u clusters en gebruikerssjablonen configureert in Webex Control Hub tijdens de onboarding van serviceproviders, wisselt u de volgende BroadWorks-gegevens uit die Webex opslaat:

  • URL Xsi-acties

  • URL van Xsi-Events

  • URL CTI-interface

  • URL verificatieservice

  • Referenties voor BroadWorks-inrichtingsadapter

Gebruikersvoorzieningen serviceprovider

Deze tabel bevat gebruikers- en bedrijfsgegevens die worden uitgewisseld als onderdeel van gebruikersvoorzieningen via de Webex-API's.

Gegevens verplaatsen naar Webex

Van

Door

Opgeslagen door Webex?

Gebruikers-id voor BroadWorks

BroadWorks, volgens API

Webex-API's

Ja

E-mail (indien SP verstrekt)

BroadWorks, volgens API

Webex-API's

Ja

E-mail (indien door gebruiker opgegeven)

Gebruiker

Portal voor gebruikersactivering

Ja

Voornaam

BroadWorks, volgens API

Webex-API's

Ja

Achternaam

BroadWorks, volgens API

Webex-API's

Ja

Primair telefoonnummer

BroadWorks, volgens API

Webex-API's

Ja

Mobiel telefoonnummer

BroadWorks, volgens API

Webex-API's

Ja

Primair toestel

BroadWorks, volgens API

Webex-API's

Ja

BroadWorks-serviceprovider-id en groeps-id

BroadWorks, volgens API

Webex-API's

Ja

Taal

BroadWorks, volgens API

Webex-API's

Ja

Tijdzone

BroadWorks, volgens API

Webex-API's

Ja

Gebruiker verwijderen

Webex voor Cisco BroadWorks API's ondersteunen zowel gedeeltelijke als volledige verwijdering van gebruikers. Deze tabel bevat alle gebruikersgegevens die zijn opgeslagen tijdens het inrichten en wat in elk scenario wordt verwijderd.

Gebruikersgegevens

Gedeeltelijke verwijdering

Volledige verwijdering

Gebruikers-id voor BroadWorks

Ja

Ja

E-mail

Nee

Ja

Voornaam

Nee

Ja

Achternaam

Nee

Ja

Primair telefoonnummer

Ja

Ja

Mobiel telefoonnummer

Ja

Ja

Extensie

Ja

Ja

BroadWorks-serviceprovider-id en groeps-id

Ja

Ja

Taal

Nee

Ja

Gebruikersaanmelding en configuratie ophalen

Webex-verificatie

Webex-verificatie verwijst naar aanmelding van gebruikers bij een Webex-app door een van de Webex-ondersteuningsmechanismen. ( BroadWorks-verificatie wordt afzonderlijk behandeld.) In deze tabel wordt het type gegevens weergegeven dat tussen de verschillende componenten van de verificatiestroom wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via de Webex-app

Webex

Beperkt toegangstoken en (onafhankelijke) IdP-URL

Webex

Gebruikersbrowser

Gebruikersgegevens

Gebruikersbrowser

Identiteitsprovider (die al gebruikersidentiteit heeft)

SAML-verklaring

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Tokens voor toegang en vernieuwing

Webex

Gebruikersbrowser

Tokens voor toegang en vernieuwing

Gebruikersbrowser

Webex-app

BroadWorks-verificatie

BroadWorks-verificatie verwijst naar aanmelding van gebruikers bij een Webex-app met hun BroadWorks-referenties. In deze tabel wordt het type gegevens weergegeven dat tussen de verschillende componenten van de verificatiestroom wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via de Webex-app

Webex

Token voor beperkte toegang en IdP-URL (Webex Bwks IdP-proxy)

Webex

Gebruikersbrowser

Brandinginformatie en BroadWorks-URL's

Webex

Gebruikersbrowser

BroadWorks-gebruikersreferenties

Gebruiker via browser (aanmeldingspagina met merknaam, bediend door Webex)

Webex

BroadWorks-gebruikersreferenties

Webex

BroadWorks

BroadWorks-gebruikersprofiel

BroadWorks

Webex

SAML-verklaring

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Tokens voor toegang en vernieuwing

Webex

Gebruikersbrowser

Tokens voor toegang en vernieuwing

Gebruikersbrowser

Webex-app

Melding van verlopen BroadWorks-wachtwoord tijdens aanmelden

Deze functie verbetert het aanmeldproces en bepaalt de aanmeldstroom op basis van:

Verbetering van aanmeldwaarschuwing en foutberichten:

  • Op dit moment krijgen de Wexbex voor BWKS-gebruikers die gebruikmaken van BroadWorks-verificatie en -aanmelding via de UAP geen melding dat hun wachtwoord bijna verloopt of dat ze zich niet kunnen aanmelden omdat het wachtwoord al is verlopen. Als het wachtwoord over 10 dagen of minder verloopt, ontvangt de gebruiker met deze functie een waarschuwing dat het wachtwoord bijna verloopt en wordt aangegeven hoeveel dagen er nog over zijn. De gebruiker wordt geadviseerd contact op te nemen met de partner of de koppeling Wachtwoord vergeten op het aanmeldscherm te volgen om het wachtwoord opnieuw in te stellen.
  • Als het wachtwoord is verlopen en de configuratie in BroadWorks 'enforcePasswordChangeOnExpiry' is ingesteld op waar, is de fout 'onjuiste gebruikersnaam en wachtwoord' gegooid, maar nu met deze functie is het foutbericht verbeterd: De aanmeldpoging is mislukt De combinatie van de gebruikersnaam en het wachtwoord komt niet overeen met onze gegevens of uw wachtwoord moet worden bijgewerkt. Probeer het opnieuw of neem contact op met uw beheerder om het wachtwoord bij te werken. Foutcode 100006

Aanmeldstroom beheren:

  • De partner kan de aanmelding beperken door een instelling 'w4bwks-password-expiry-fail-login' in of uit te schakelen. Als BroadWorks-wachtwoord is verlopen, wordt de configuratie in BroadWorks 'enforcePasswordChangeOnExpiry' ingesteld op onwaar en wordt de instelling 'w4bwks-password-expiry-fail-login' ingeschakeld. Vervolgens wordt een fout geslingerd die zegt dat het wachtwoord x dagen geleden is verlopen, terwijl als de instellingsservice is uitgeschakeld, inloggen is toegestaan. De instelling is standaard uitgeschakeld.

De koppeling Wachtwoord vergeten op de aanmeldpagina kan door de partner worden geconfigureerd als onderdeel van de functie Geavanceerde aanpassing. Partners zouden de koppeling doorgaans configureren om de gebruiker naar een partnerportal te navigeren voor wachtwoordbeheer en het opnieuw instellen van het wachtwoord.


 

Deze functie verbetert alleen de aanmeldingservaring van de gebruiker tijdens het aanmelden van de geactiveerde gebruiker wanneer het wachtwoord op het punt staat te verlopen of al is verlopen. De functie wordt niet verwerkt als een wachtwoord verloopt terwijl de gebruiker is aangemeld bij de Webex-app. Bij de volgende aanmeldpoging krijgt de gebruiker een melding voor het verlopen van het wachtwoord.

De instelling 'w4bwks-password-expiry-fail-login' wordt op verzoek van een partner ingeschakeld of uitgeschakeld door Cisco.

Clientconfiguratie ophalen

Deze tabel toont het type gegevens dat tussen de verschillende componenten wordt uitgewisseld tijdens het ophalen van clientconfiguraties.

Gegevens verplaatsen

Van

Doel

Registratie

Klant

Webex

Organisatie-instellingen, inclusief BroadWorks-URL's

Webex

Klant

JWT-token voor BroadWorks

BroadWorks via Webex

Klant

JWT-token voor BroadWorks

Klant

BroadWorks

Apparaattoken

BroadWorks

Klant

Apparaattoken

Klant

BroadWorks

Configuratiebestand

BroadWorks

Klant

Gebruik bij steady-state

In dit gedeelte worden de gegevens beschreven die tussen componenten worden verplaatst tijdens herverificatie na het verlopen van een token, via BroadWorks of Webex.

In deze tabel wordt de gegevensbeweging voor bellen weergegeven.

Gegevens verplaatsen

Van

Doel

SIP-signalering

Klant

BroadWorks

SRTP-media

Klant

BroadWorks

SIP-signalering

BroadWorks

Klant

SRTP-media

BroadWorks

Klant

In deze tabel wordt de gegevensbeweging voor berichten, aanwezigheid en vergaderingen weergegeven.

Gegevens verplaatsen

Van

Doel

HTTPS REST-berichten en aanwezigheid

Klant

Webex

HTTPS REST-berichten en aanwezigheid

Webex

Klant

SIP-signalering

Klant

Webex

SRTP-media

Klant

Webex

SIP-signalering

Webex

Klant

SRTP-media

Webex

Klant

De inrichtings-API gebruiken

Toegang voor ontwikkelaars

De API-specificatie is beschikbaar op https://developer.webex.com en een handleiding voor het gebruik is te vinden op https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

U moet zich aanmelden om de API specificatie te lezen ophttps://developer.webex.com/docs/api/v1/broadworks-subscribers .

Toepassingsverificatie en autorisatie

Uw toepassing wordt geïntegreerd met Webex als een Integratie. Met dit mechanisme kan de toepassing beheertaken uitvoeren (zoals het inrichten van abonnees) voor een beheerder binnen uw partnerorganisatie.

Webex-API's volgen de OAuth 2-standaard ( http://oauth.net/2/). Met OAuth 2 kunnen integraties van derden vernieuwings- en toegangstokens verkrijgen namens de door u gekozen partnerbeheerder voor het verifiëren van API-gesprekken.

U moet eerst uw integratie met Webex registreren. Na registratie moet uw toepassing deze OAuth 2.0-autorisatietoekenningsflow ondersteunen om de benodigde vernieuwings- en toegangstokens te verkrijgen.

Zie https://developer.webex.com/docs/integrations voor meer informatie over integraties en hoe u deze OAuth 2-autorisatieflow in uw toepassing kunt opbouwen.


 

Er zijn twee rollen vereist voor het implementeren van integraties - de ontwikkelaar en de autorisatiegebruiker - en deze kunnen worden bekleed door afzonderlijke personen/teams in uw omgeving.

  • De ontwikkelaar maakt de app en registreert deze op https://developer.webex.com om de vereiste OAuth ClientID/Secret te genereren met scopes die worden verwacht voor de toepassing. Als uw toepassing wordt gemaakt door een derde partij, kan deze de toepassing registreren (als u om toegang hebt gevraagd) of kan u deze met uw eigen toegang doen.

  • De gebruiker autoriseren is het account dat de toepassing gebruikt om de API-oproepen te autoriseren, om uw partnerorganisatie, de organisaties van uw klanten of hun abonnees te wijzigen. Dit account moet de rol Volledige beheerder of Volledige verkoopbeheerder hebben in uw partnerorganisatie. Deze rekening mag niet door een derde worden aangehouden.

Naam organisatie

De organisatienaam is afhankelijk van de inrichtingsmodus die u gebruikt:

  • Enterprise-modus: de organisatienaam komt exact overeen met spEnterprise-id.

  • Serviceprovidermodus: de organisatienaam is het gedeelte groep-id van de spEnterprise-id.

De organisatienaam bevat alle spaties, hoofdletters en speciale tekens die zijn opgegeven in de oorspronkelijke spEnterprise-id.

Softwarevereisten voor BroadWorks

Zie Lifecycle Management - BroadSoft Servers.

We verwachten dat de serviceprovider "patch current" is met de nieuwste BroadWorks-patches en Release Independent (RI)-apps. De lijst met patches hieronder is de minimale vereiste voor integratie met Webex.


 
Controleer de patchnotities voor deze softwarepatches. Sommige patches hebben mogelijk aanvullende CLI-vereisten.

Versie R22

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.22.0.1123.ap364260

AP.as.22.0.1123.ap365173

AP.as.22.0.1123.ap368517

Vereist voor adreslijstsynchronisatie

AP.as.22.0.1123.ap369763

AP.as.22.0.1123.ap372989

AP.as.22.0.1123.ap372757

AP.as.22.0.1123.ap372963

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.22.0.1123.ap373197

Vereiste patch voor toepassingsserver

AP.as.22.0.1123.ap378391

AP.as.22.0.1123.ap374793

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.22.0.1123.ap377718

Vereiste patch voor de functie Gespreksopname

AP.as.22.0.1123.ap377868

AP.as.22.0.1123.ap376508

Vereiste patch voor doorstroominrichting

AP.xsp.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Profielserver

AP.ps.22.0.1123.ap372989

AP.ps.22.0.1123.ap372757

AP.ps.22.0.1123.ap378391

AP.ps.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Platform

AP.platform.22.0.1123.ap353577

AP.platform.22.0.1123.ap354313

Vereist voor NPS-verificatieproxy

AP.platform.22.0.1123.ap365173

AP.platform.22.0.1123.ap367732

AP.platform.22.0.1123.ap369433

AP.platform.22.0.1123.ap369607

Vereist voor NPS-verificatieproxy

AP.platform.22.0.1123.ap372757

AP.platform.22.0.1123.ap376508

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.platform.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

XSP|ADP

AP.xsp.22.0.1123.ap354313

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap365173

AP.xsp.22.0.1123.ap368067

AP.xsp.22.0.1123.ap368601

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.xsp.22.0.1123.ap369607

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap370952

AP.xsp.22.0.1123.ap373008

AP.xsp.22.0.1123.ap372757

AP.xsp.22.0.1123.ap372433

AP.xsp.22.0.1123.ap372963

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.xsp.22.0.1123.ap378391

AP.xsp.22.0.1123.ap374677

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap375206

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap376508

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.xsp.22.0.1123.ap378585

Vereist voor Unified Call History

Overig

AP.xsa.22.0.1123.ap372757

AP.xs.22.0.1123.ap372757

AP.ums.22.0.1123.ap378391

AP.nfm.22.0.1123.ap378391

Versie R23

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.23.0.1075.ap368517

Vereist voor adreslijstsynchronisatie

AP.as.23.0.1075.ap369763

AP.as.23.0.1075.ap373197

App-server configureren

AP.as.23.0.1075.ap373271

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.23.0.1075.ap378391

AP.as.23.0.1075.ap376509

AP.as.23.0.1075.ap377718

Vereist voor gespreksopname

AP.as.23.0.1075.ap377868

AP.as.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Profielserver

AP.ps.23.0.1075.ap378391

Platform

AP.platform.23.0.1075.ap367732

AP.platform.23.0.1075.ap370952

AP.platform.23.0.1075.ap369607

Vereist voor NPS-verificatieproxy

AP.platform.23.0.1075.ap376509

AP.platform.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

XSP|ADP

AP.xsp.23.0.1075.ap368067

AP.xsp.23.0.1075.ap369607

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap370952

AP.xsp.23.0.1075.ap373008

AP.xsp.23.0.1075.ap373271

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.xsp.23.0.1075.ap378391

AP.xsp.23.0.1075.ap374677

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap375206

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap376509

AP.xsp.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Overig

Bij gebruik van ADP...

Xsi-Events-23_2021.05_1.251.bwar

Vereiste patch voor haakstatus (Presence) en Unified Call History

Versie R24

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.24.0.944.ap384177

Vereist voor Unified Messaging Server (UMS)

AP.as.24.0.944.ap375100

Vereist voor flowthrough-inrichting

AP.as.24.0.944.ap377718

Vereist voor gespreksopname

AP.as.24.0.944.ap377868

AP.as.24.0.944.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Overig

Xsi-Events-24_2021.05_1.251.bwar

Vereiste patch voor haakstatus (Presence) en Unified Call History

Inrichtings- en activeringsstromen voor gebruikers


 

Inrichting beschrijft het toevoegen van de gebruiker aan Webex. Activering omvat e-mailvalidatie en servicetoewijzing in Webex.

E-mailadressen van gebruikers moeten uniek zijn, omdat Webex het e-mailadres gebruikt om een gebruiker te identificeren. Als u vertrouwde e-mailadressen voor de gebruikers hebt, kunt u ervoor kiezen deze automatisch te activeren wanneer u ze automatisch inricht. Dit proces is 'automatische inrichting en automatische activering'.

Automatische gebruikersinrichting en automatische activering (vertrouwde e-mailstroom)

Voorwaarden

  • Uw inrichtingsadapter wijst naar Webex voor Cisco BroadWorks (waarvoor een uitgaande verbinding van AS naar Webex Provisioning Bridge is vereist).

  • U moet geldige bereikbare e-mailadressen van eindgebruikers hebben als alternatieve id's in BroadWorks.

  • Control Hub heeft een inrichtingsaccount in de configuratie van uw partnerorganisatie.

Stap

Beschrijving

1

U noteert en neemt bestellingen voor de service op bij uw klanten.

2

U verwerkt de klantorder en richt de klant in uw systemen in.

3

Het service-inrichtingssysteem activeert de inrichting van BroadWorks. Deze stap, in het kort, maakt de onderneming en de gebruikers. Vervolgens wijst het de benodigde services en nummers toe aan elke gebruiker. Een van die diensten is de externe IM&P.

4

Met deze inrichtingsstap wordt de automatische inrichting van de klantorganisatie en gebruikers in Webex geactiveerd. (De IM&P-servicetoewijzing zorgt ervoor dat de inrichtingsadapter de Webex-inrichtings-API belt).

5

Uw systemen moeten de Webex-provisioning-API gebruiken als u het pakket later voor de gebruiker moet aanpassen (om van de standaardinstelling te veranderen).

SSO-aanmeldstroom

SAML SSO-aanmeldstroom met directe BroadWorks-verificatie (delen van resources tussen verschillende bronnen)

Hier volgt de SAML SSO-aanmeldstroom voor de Webex-app bij gebruik van BroadWorks-verificatie en wanneer Resource delen met meerdere bronnen is ingeschakeld, zodat directe verificatie naar BroadWorks mogelijk is. De afbeelding toont client- en gebruikersevenementen aan de linkerkant met tekst op de pijlen die weergeeft wat de client voor autorisatie voorziet. Stap 1 en 5 zijn gebruikersevenementen. Aan de rechterkant van de afbeelding ziet u gebeurtenissen voor aanmeldservices, samen met wat er wordt teruggestuurd naar de client.

BroadWorks-registratie en servicedetectiestroom

Hieronder volgt de BroadWorks-servicedetectiestroom die onmiddellijk volgt uit de vorige Webex SAML SSO-aanmeldstroom. De client gebruikt het toegangstoken dat is verkregen bij de registratie bij Webex-apparaatbeheer om registratie aan te vragen bij de BroadWorks-implementatie.

Alternatieve aanmeldstromen

De bovenstaande afbeeldingen gaan ervan uit dat SAML SSO-aanmelding is geconfigureerd met BroadWorks-verificatie waarvoor directe BroadWorks-verificatie is ingeschakeld (Cross-Origin Resource Sharing). Hieronder vindt u enkele alternatieve SAML SSO-aanmeldstromen:

  • BroadWorks-verificatie zonder directe BroadWorks-verificatie (delen van resources tussen verschillende bronnen):

    • Het enige verschil is in stap 5 en 6 van de Webex-aanmeldstroom. In stap 5 worden de aanmeldingsgegevens gevalideerd door de IdP-proxy (in plaats van XSI) en wordt een SAML-verklaring teruggestuurd naar de client.

    • De stroom loopt door de resterende stappen in de twee diagrammen.

    • Het SSO-token wordt niet gebruikt in deze flow.

  • SAML SSO Webex-verificatie:

    • In stap 3 van de Webex-aanmeldstroom retourneert de service Common Identity de identiteitsprovider die wordt gebruikt door Webex-verificatie.

    • Op dit moment wordt een alternatieve SAML SSO-aanmeldstroom voor Webex gestart.

Gebruikersinteracties

Aanmelden

  1. De Webex-app lanceert een browser naar Cisco Common Identity (CI) zodat gebruikers hun e-mailadres kunnen invoeren.

  2. CI ontdekt dat de gekoppelde klantorganisatie de BroadWorks IDP-proxy (IDP) heeft geconfigureerd als hun SAML IDP. CI wordt omgeleid naar de IDP die de gebruiker een aanmeldpagina aanbiedt. (De serviceprovider kan deze aanmeldpagina aanmerken.)

  3. De gebruiker voert zijn of haar BroadWorks-referenties in.

  4. Broadworks verifieert de gebruiker via de IDP. Bij succes stuurt de IDP de browser terug naar CI met een SAML-succes om de verificatieflow te voltooien (niet weergegeven in diagram).

  5. Bij succesvolle verificatie verkrijgt de Webex-app toegangstokens van CI (niet weergegeven in diagram). De client gebruikt deze om een BroadWorks langlevende Jason Web Token (JWT) aan te vragen.

  6. De Webex-app ontdekt de gespreksconfiguratie van BroadWorks en andere services van Webex.

  7. De Webex-app wordt geregistreerd bij BroadWorks.

Aanmelden vanuit het perspectief van een gebruiker

Dit diagram is de typische aanmeldingsstroom, zoals gezien door de eindgebruiker of abonnee:

  1. U downloadt en installeert de Webex-app.

  2. Mogelijk hebt u de koppeling van uw serviceprovider ontvangen of kunt u de download vinden op de pagina Webex-downloads.

  3. U voert uw e-mailadres in op het aanmeldscherm van Webex. Klik op Volgende.

  4. U wordt meestal omgeleid naar een pagina met het merk Serviceprovider.

  5. Die pagina kan u verwelkomen via uw e-mailadres.

    Als er geen e-mailadres is of als het e-mailadres onjuist is, voert u in plaats daarvan uw BroadWorks-gebruikersnaam in.

  6. Voer uw BroadWorks-wachtwoord in.

  7. Als u zich hebt aangemeld, wordt Webex geopend.

Gespreksstroom: bedrijfstelefoonlijst

Gespreksstroom: PSTN-nummer

Presentatie en delen

Een ruimtevergadering starten

Interacties met de klant

Profiel ophalen uit DMS en SIP-register met AS

  1. De client belt XSI om een apparaatbeheertoken en de URL naar het DMS op te halen.

  2. De klant vraagt zijn apparaatprofiel aan bij DMS door het token van stap 1 voor te leggen.

  3. De client leest het apparaatprofiel en haalt de SIP-referenties, adressen en poorten op.

  4. Client verzendt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.

  5. SBC stuurt het SIP REGISTER naar het AS (SBC kan een zoekopdracht uitvoeren in de NS om een AS te vinden als SBC de SIP-gebruiker nog niet kent.)

Test- en laboratoriumrichtlijnen

De volgende richtlijnen zijn van toepassing op test- en laboratoriumorganisaties:

  • Serviceproviderpartners zijn beperkt tot maximaal 50 testgebruikers die in meerdere organisaties kunnen worden ingericht.

  • Gebruikers buiten de eerste 50 testgebruikers worden gefactureerd.

  • Om een nauwkeurige verwerking op uw factuur te garanderen, moeten alle testorganisaties 'test' opnemen in de naam van de BroadWorks-organisatie.

  • Interne testorganisaties moeten worden aangewezen in Webex Control Hub. Dit is om te voorkomen dat testgebruikers worden gefactureerd als werkelijke gebruikers.

Een organisatie aanwijzen als een testorganisatie

Een organisatie aanwijzen als testorganisatie:

  1. Meld u aan bij Partner Hub en selecteer Klanten.

  2. Selecteer de juiste klant.

  3. Schakel in de rechterbedieningsbalk de schakelaar Interne testorganisatie in.

Voicemail afspelen

Zorg ervoor dat u voor voicemail de Mediaserver configureert om een van de volgende codes te gebruiken:

  • mp3

  • wav: WAV-bestanden worden ondersteund in de volgende indelingen: PCM (ondersteund op alle platforms) en DVI-ADPCM (niet ondersteund op Android

Als u wav-bestanden gebruikt, voert u de volgende CLI-opdrachten uit om de toepassingsserver en de mediaserver te configureren:

  • AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV

  • MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw

Terminologie

ACL (ACL)
Lijst met toegangscontrole
ALG
Gateway toepassingslaag
API
Toepassingsprogrammeerinterface
APNS
Apple Push-notificatieservice
AS
Toepassingsserver
ATA, VORMEN, VORMEN
Analoge telefoonoplader, adapter die analoge telefonie converteert naar VoIP
BAM
Toepassingsbeheer van BroadSoft
Basisverificatie
Een verificatiemethode waarbij een account (gebruikersnaam) wordt gevalideerd met een gedeeld geheim (wachtwoord)
BMS, (VER)LEIDEN
BroadSoft-berichtenserver
BOSJE
Bidirectionele stromen via synchrone HTTP
BRAADSTUK
Basic Rate Interface BRI is een ISDN-toegangsmethode
Bundel
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (cfr. Pakket)
CA
Certificeringsinstantie
Provider
Een organisatie die telefonieverkeer afhandelt (cfr. Partner, serviceprovider, Value Added Reseller)
CAPTCHA
Volledig geautomatiseerde Public Turing-test om computers en mensen uit elkaar te houden
CCXML
Taal voor eXtensible Markup voor gespreksbeheer
CIF
Algemeen Tussenformaat
CLI, VASTBINDEN
Opdrachtregelinterface
CN
Algemene naam
CNPS, CNPS
Pushserver voor gespreksmeldingen. Een pushserver voor meldingen die wordt uitgevoerd op een XSP|ADP in uw omgeving, om gespreksmeldingen naar FCM en APNS te pushen. Zie NPS-proxy.
CPE
Gebouwapparatuur van de klant
CPR, AFLEIDEN
Aangepaste aanwezigheidsregel
CSS, CVS
Cascade-stijlblad
CSV
Door komma's gescheiden waarde
CTI
Integratie van computertelefonie
CUBE
Cisco Unified Border Element
DMZ
Gedemilitariseerde zone
DN
Telefoonlijstnummer
Niet storen
Niet storen
DNS
Domeinnaamsysteem
DPG
Bel peergroep
DSCP
Punt Gedifferentieerde Servicecode
DTAF
Archiefbestand van apparaattype
DTG
Bestemmings-trunk-groep
DTMF
Dubbele toon met meerdere frequenties
Eindgebruiker
De persoon die de services gebruikt, die gesprekken voert, deelneemt aan vergaderingen of berichten verzendt (cf. Abonnee)
Organisatie
Een verzameling van eindgebruikers (cfr. Organisatie)
FCM
Firebase-cloudberichten
SCHAAMTE
Convergentie van vaste mobiele apparaten
Doorstroominrichting
Gebruikers maken in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' toe te wijzen in BroadWorks.
FQDN
Volledig gekwalificeerde domeinnaam (FQDN)
Volledige doorstroominrichting
Gebruikers maken en verifiëren in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' toe te wijzen in BroadWorks en te bevestigen dat elke BroadWorks-gebruiker een uniek en geldig e-mailadres heeft.
FXO, FXO
Foreign Exchange Office is de poort die de analoge lijn ontvangt. Dit is de stekker op de telefoon of faxmachine of de stekkers op uw analoge telefoonsysteem. Het levert een on-hook/off-hook indicatie (lussluiting). Aangezien de FXO-poort is gekoppeld aan een apparaat, zoals een fax of een telefoon, wordt het apparaat vaak het 'FXO-apparaat' genoemd.
FXS, FXS
Foreign Exchange Subscriber is de poort die daadwerkelijk de analoge lijn aan de abonnee levert. Met andere woorden, het is de "plug in the wall" die een kiestoon, accustroom en belspanning levert.
GCM
Google Cloud-bericht
GCM
Galois/Counter-modus (coderingstechnologie)
VERSTOPT
Apparaat voor menselijke interface
HTTPS
Beveiligde contactdozen met hypertekstdoorschakelprotocol
IAD
Apparaat voor geïntegreerde toegang
IM&P
Instant Messaging en Aanwezigheid
IP-PSTN
Een serviceprovider die VoIP-naar-PSTN-services levert, uitwisselbaar met ITSP, of een algemene term voor 'openbare' telefonie met internetverbinding, gezamenlijk geleverd door grote telecomproviders (in plaats van door landen, zoals PSTN is)
ITSP, ITSP
Internettelefonieserviceprovider
IVR, IVR
Interactieve spraakrespons / Responder
JID
Het systeemeigen adres van een XMPP-entiteit wordt een Jabber-id of JID localpart@domain.part.example.com/resourcepart (@ . / zijn separatoren)
JSON
Java-scriptobjectnotatie
JOOD
Java Secure Socket Extension; de onderliggende technologie die veilige verbindingsfuncties biedt voor BroadWorks-servers
KEM
Toetsuitbreidingsmodule (hardware Cisco-telefoons)
LLT
Long-lived (of Long Life) Token; een zelfbeschrijvende, veilige vorm van toondertoken waarmee gebruikers langer geverifieerd kunnen blijven en niet gekoppeld zijn aan specifieke toepassingen.
MA, MA, MAMA
Berichtarchivering
MIB, MIB
Basis managementinformatie
MEVROUW
Mediaserver
mTLS
Wederzijdse verificatie tussen twee partijen met behulp van certificaatuitwisseling bij het tot stand brengen van een TLS-verbinding
MUG, MUG, MUG
Chat met meerdere gebruikers
NAT, NAT
Vertalingen van netwerkadressen
NPS
Pushserver voor meldingen; zie CNPS
NPS-proxy

Een service in Webex die korte autorisatietokens levert aan uw CNPS, zodat deze de gespreksmeldingen naar FCM en APN's en uiteindelijk naar Android- en iOS-apparaten met Webex kan pushen.

OCI, OCI
Clientinterface openen
Organisatie
Een bedrijf of organisatie die een verzameling eindgebruikers vertegenwoordigt (cfr. Onderneming)
OTG
Uitgaande trunkgroep
Pakket
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (cfr. bundel)
Partner
Een agentorganisatie die samenwerkt met Cisco om producten en services te distribueren naar andere organisaties (cf. Value Added Reseller, serviceprovider, provider)
PBX
Ruilen privé-filiaal
PEM
E-mail met verbeterde privacy
PLONS
Openbaar mobiel landnetwerk
PRI, SNOEIWERK
Primary Rate Interface (PRI) is een standaard voor telecommunicatie-interface die wordt gebruikt op een digitaal netwerk voor geïntegreerde diensten (ISDN)
PS
Profielserver
PSTN
Openbaar geschakeld telefoonnetwerk
QoS
Servicekwaliteit
Doorverkoopportaal
Een website waarop de beheerder van de reseller zijn UC-One SaaS-oplossing kan configureren. Het wordt soms BAM-portal, beheerportal of beheerportal genoemd.
RTCP
Real-time beheerprotocol
RTP
Protocol voor realtime vervoer
SBC, ZWAARD
Sessie Border Controller
SCÈNE, SCÈNE
Weergave van gedeelde oproep
SD (SD)
Standaarddefinitie
SDP
Protocol voor sessiebeschrijving
SP
Serviceprovider; Een organisatie die telefonie of gerelateerde diensten levert aan andere organisaties (cf. Vervoerder, Partner, Value Added Reseller)
SIP
Protocol voor het starten van een sessie
SLET
Short-lived (of Short Life) Token (ook wel BroadWorks SSO Token genoemd); een authenticated token voor eenmalig gebruik dat wordt gebruikt om veilige toegang tot webtoepassingen te krijgen.
SMB
Kleine tot middelgrote ondernemingen
SNMP
Eenvoudig netwerkbeheerprotocol
sRTCP
secure Realtime Transfer Control Protocol (VoIP-gespreksmedia)
sRTP
beveiligd Realtime-doorverbindprotocol (VoIP-gespreksmedia)
SSL
Laag met veilige contactdozen
Abonnee
De persoon die de services gebruikt, die gesprekken voert, deelneemt aan vergaderingen of berichten verzendt (cf. Eindgebruiker)
TCP
Transmissieregelprotocol
TDM
Tijdverdeling multiplexen
TLS
Transportlagenbeveiliging
ToS
Soort service
UAP, UAP
Portal voor gebruikersactivering
UC
Unified Communications
GEBRUIKERSINTERFACE
Gebruikersinterface
U Id
Unieke id
AFMETINGEN
Berichtenserver
URI
Uniforme resource-id
URL
Uniforme bronzoeker
USS
Server voor delen
UTC
Gecoördineerde wereldtijd
UVS
Videoserver
Value Added Reseller (VAR)
Een agentorganisatie die samenwerkt met Cisco om producten en services te distribueren naar andere organisaties (cf. Vervoerder, Partner, Serviceprovider)
VGA
Grafische matrix voor video
VoIP
Voice over Internet Protocol (IP)
VXML
Taal voor uitbreidbare spraak
WebDAV
Webgedistribueerde creatie en versioning
WebRTC
Realtime webcommunicatie
WRS
WebRTC-server
XMPP
Extensible Messaging and Presence Protocol
Bijlage

Services configureren (met mTLS voor de verificatieservice)

De onderstaande procedures vervangen de procedures in het onderwerp Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's. Voltooi deze procedures alleen als u mTLS gebruikt voor de verificatieservice in plaats van CI-tokenvalidatie. Deze procedures zijn verplicht als u meerdere Webex-organisaties op dezelfde XSP|ADP-server uitvoert. Anders zijn ze optioneel.


 
Als u niet meerdere Webex-organisaties op dezelfde XSP|ADP-server uitvoert, wordt CI Token Validation (met TLS) aanbevolen voor de verificatieservice. Raadpleeg Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's voor meer informatie over het configureren van de verificatieservice en andere services.

Xsi-interfaces

Installeer en configureer de Xsi-Actions- en Xsi-Events-toepassingen zoals beschreven in de Configuratiehandleiding voor Cisco BroadWorks Xtended Services Interface.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Voor alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moet dezelfde callControlApplicationName zijn gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker is geïntegreerd in Webex, maakt Webex een abonnement voor de gebruiker op de AS om telefoniegebeurtenissen te ontvangen voor aanwezigheid en gespreksgeschiedenis. Het abonnement is gekoppeld aan de callControlApplicationName en de AS gebruikt het om te weten naar welke Xsi-Events de telefonie-gebeurtenissen moeten worden verzonden.


 

Het wijzigen van de callControlApplicationName of het niet hebben van dezelfde naam op alle Xsi-Events-webapps zal invloed hebben op abonnementen en telefonie gebeurtenissen functionaliteit.

Verificatieservice configureren (met mTLS)

BroadWorks-tokens met een lange levensduur worden gegenereerd en gevalideerd door de verificatieservice die wordt gehost op uw XSP|ADP's.

Vereisten

  • Op de XSP|ADP-servers die de verificatieservice hosten, moet een mTLS-interface zijn geconfigureerd.

  • XSP|ADP's moeten dezelfde sleutels delen voor het coderen/decoderen van BroadWorks-tokens met een lange levensduur. Het kopiëren van deze sleutels naar elke XSP|ADP is een handmatig proces.

  • XSP|ADP's moeten worden gesynchroniseerd met NTP.

Configuratieoverzicht

De essentiële configuratie op uw XSP|ADP's omvat:

  • Implementeer de verificatieservice.

  • Configureer de tokenduur tot ten minste 60 dagen (laat de uitgever staan als BroadWorks).

  • RSA-sleutels genereren en delen met XSP|ADP's.

  • Geef de authService-URL op aan de webcontainer.

De verificatieservice implementeren op XSP|ADP

Op elke XSP|ADP die met Webex wordt gebruikt:

  1. Activeer de toepassing voor de verificatieservice op het pad /authService(je moet dit pad gebruiken):

    XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService

    (waarbij <version> is uw BroadWorks-versie).

  2. Implementeer de toepassing:

    XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authService

Duur token configureren

  1. Controleer de bestaande tokenconfiguratie (uren):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> get

  2. Stel de duur in op 60 dagen (max. 180 dagen):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> set tokenDurationInHours 1440

RSA-sleutels genereren en delen

  • U moet dezelfde openbare/privésleutelparen gebruiken voor tokencodering/decodering in alle instanties van de verificatieservice.

  • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet uitgeven.

Vanwege deze twee factoren moet u sleutels genereren op één XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's.


 

Als u met de toetsen gaat fietsen of de lengte van de toetsen wijzigt, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw starten.

  1. Selecteer één XSP|ADP om een sleutelpaar te genereren.

  2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen in de browser van de client:

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

    (Dit genereert een privaat/openbaar sleutelpaar op de XSP|ADP, als dat er nog niet was)

  3. De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:

    XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

  4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere .keys bestand indien nodig.

  5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

Geef de authService-URL aan de webcontainer

De webcontainer van de XSP|ADP heeft de authService-URL nodig zodat deze tokens kan valideren.

Op elk van de XSP|ADP's:

  1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het communicatiehulpprogramma BroadWorks:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

  2. Voeg de URL van de verificatieservice toe aan de container:

    XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

    Hiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.

  3. Controleer de parameter met get.

  4. Start de XSP|ADP opnieuw op.

TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)

De toepassingen Verificatieservice, Xsi-acties en Xsi-Events maken gebruik van HTTP-serverinterfaces. De TLS-configureerbaarheidsniveaus voor deze toepassingen zijn als volgt:

Meest algemeen = Systeem > Transport > HTTP > HTTP Server interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit CLI-context
Systeem (globaal)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze veilig zijn en of ze clientverificatie vereisen.

Apache tomcat vereist een certificaat voor elke veilige interface; het systeem genereert een zelfondertekend certificaat als dit nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2-protocol toevoegen aan de HTTP-serverinterface

De HTTP-interface die communiceert met de Webex-cloud moet zijn geconfigureerd voor TLSv1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren in de interface van de HTTP-server:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken in de HTTP-serverinterface

De vereiste cijfers configureren:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de interface van de HTTP-server.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 in de interface van de HTTP-server gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Trust configureren voor verificatieservice (met mTLS)

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om CombinedCertChain2023.txt op uw lokale computer.


     
    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze uploadt naar de XSP|ADP's. Alle bestanden zijn vereist.
  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt.

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE----- en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één tekstblok bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt.

  5. Meld u aan bij de XSP|ADP en ga naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoeren UpdateTrust om de parameters en opdrachtindeling weer te geven.

  6. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023

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

     

    Alle aliassen moeten een andere naam hebben. webexclientroot, webexclientroot2023, webexclientissuing en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang de vier ingangen uniek zijn.

  7. Bevestig dat de ankers zijn bijgewerkt:

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get

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

(Optie) mTLS configureren op het niveau van de HTTP-interface/poort

Het is mogelijk om mTLS te configureren op het niveau van de HTTP-interface/poort of per webtoepassing.

De manier waarop u mTLS inschakelt voor uw toepassing, hangt af van de toepassingen die u host op de XSP|ADP. Als u meerdere toepassingen host waarvoor mTLS nodig is, moet u mTLS inschakelen op de interface. Als u slechts één van de verschillende toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op HTTP-interface/poortniveau is mTLS vereist voor alle gehoste webtoepassingen die via deze interface/poort worden geopend.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/HttpServer> en voer de get opdracht om de raakvlakken te zien.

  3. Als u een interface wilt toevoegen en daar clientverificatie wilt vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true

    Zie de XSP|ADP CLI-documentatie voor meer informatie. In wezen de eerste true beveiligt de interface met TLS (servercertificaat wordt gemaakt indien nodig) en de tweede true dwingt de interface om clientcertificaatverificatie te vereisen (samen zijn het mTLS).

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/HttpServer> get

Interface Port Name Secure Client Auth Req Cluster Fqdn
         =======================================================
         192.0.2.7 443 XSP|ADP01.collab.example.net true false 
         192.0.2.7 444 XSP|ADP01.collab.example.net true true

In dit voorbeeld is mTLS (Client Auth Req = true) ingeschakeld op 192.0.2.7 poort 444. TLS is ingeschakeld op 192.0.2.7 poort 443.

(Optie) mTLS configureren voor specifieke webtoepassingen

Het is mogelijk om mTLS te configureren op het niveau van de HTTP-interface/poort of per webtoepassing.

De manier waarop u mTLS inschakelt voor uw toepassing, hangt af van de toepassingen die u host op de XSP|ADP. Als u meerdere toepassingen host waarvoor mTLS nodig is, moet u mTLS inschakelen op de interface. Als u slechts één van de verschillende toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op toepassingsniveau is mTLS vereist voor die toepassing, ongeacht de HTTP-serverinterfaceconfiguratie.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> en voer de get om te zien welke toepassingen worden uitgevoerd.

  3. Een toepassing toevoegen en hiervoor clientverificatie vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true

    Zie de XSP|ADP CLI-documentatie voor meer informatie. Daar worden de toepassingsnamen opgesomd. Het true in dit commando wordt mTLS ingeschakeld.

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add 192.0.2.7 443 AuthenticationService true

De voorbeeldopdracht voegt de AuthenticationService-toepassing toe aan 192.0.2.7:443 en vereist dat de toepassing certificaten van de client aanvraagt en verifieert.

Vraag na bij get:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> get

Interface Ip Port Application Name Client Auth Req
         ===================================================
         192.0.2.7 443 AuthenticationService      true          

Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver

Profielserver en XSP|ADP zijn verplicht voor apparaatbeheer. Ze moeten worden geconfigureerd volgens de instructies in de configuratiehandleiding voor BroadWorks-apparaatbeheer.

Hoe gaat u verder?

Voor configuratie kunt u opnieuw deelnemen aan de hoofddocumentstroom via CTI-interface en gerelateerde configuratie.

Aanvullende certificaatvereisten voor wederzijdse TLS-verificatie tegen AuthService

Webex communiceert met de verificatieservice via een wederzijdse TLS-geverifieerde verbinding. Dit betekent dat Webex een clientcertificaat presenteert en dat de XSP|ADP moet valideren. Als u dit certificaat wilt vertrouwen, gebruikt u de Webex CA-certificaatketen om een vertrouwensanker op XSP|ADP (of proxy) te maken. De certificaatketen kan worden gedownload via Partner Hub:

  1. Ga naar Instellingen > BroadWorks Calling.

  2. Klik op de koppeling voor het downloadcertificaat.


 

U kunt de certificaatketen ook ophalen van https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.

De exacte vereisten voor het implementeren van deze Webex CA-certificaatketen zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt samengevat waar de Webex CA-certificaatketen in deze drie gevallen moet worden geïmplementeerd.

Vereisten voor wederzijds TLS-certificaat voor TLS-bridge Proxy

  • Webex presenteert een door Webex CA ondertekend clientcertificaat aan de proxy.

  • De Webex CA-certificaatketen wordt geïmplementeerd in het proxyvertrouwensarchief, zodat de proxy het clientcertificaat vertrouwt.

  • Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de proxy geladen.

  • De proxy presenteert een openbaar ondertekend servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • De volmachthebber legt een intern ondertekend clientcertificaat voor aan de XSP|ADP’s.

    Dit certificaat moet het uitbreidingsveld Extended Key Usage van x509.v3 bevatten met het BroadWorks-OID-doel 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS-clientAuth. Bijv.:

    X509v3 extensions:

    X509v3 Extended Key Usage:

    1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client
                  Authentication 

     

    Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP’s presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

Vereisten voor wederzijds TLS-certificaat voor TLS-passthrough Proxy of XSP in DMZ

  • Webex presenteert een door Webex CA ondertekend clientcertificaat aan de XSP's.

  • De Webex CA-certificaatketen wordt geïmplementeerd in het vertrouwensarchief van de XSP's, zodat de XSP's het clientcertificaat vertrouwen.

  • Het openbaar ondertekende XSP-servercertificaat wordt ook in de XSP's geladen.

  • De XSP's presenteren openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP's heeft ondertekend.

Revisiegeschiedenis van document

De volgende tabel toont een geschiedenis van wijzigingen aan dit document in de afgelopen 12 maanden.

Datum

Versie

Beschrijving van de wijziging

07 februari 2024

2-108

  • Een functie toegevoegd BroadWorks-melding voor het verlopen van een wachtwoord tijdens aanmelding onder Webex voor BroadWorks-referentie.

25 januari 2024

2-107

  • Redactionele wijzigingen.

23 januari 2024

2-106

  • Redactionele wijzigingen aangebracht in het gedeelte Gebruiker verplaatsen (met toestemming) naar Webex voor Cisco BroadWorks onder Webex beheren voor BroadWorks.

10 januari 2024

2-105

  • Redactionele wijzigingen.

20 december 2023

2-104

13 december 2023

2-103

  • Klantsjabloon is gewijzigd in 'Onboarding-sjabloon'. De oplossingshandleiding is bijgewerkt.

12 december 2023

2-102

  • Webex voor BroadWorks toevoegen aan het gedeelte Bestaande organisatie onder Webex voor BroadWorks beheren is bijgewerkt.

08 december 2023

2-101

  • Redactionele wijzigingen.

08 november 2023

2-100

  • Een opmerking toegevoegd in het gedeelte Webex voor BroadWorks toevoegen aan bestaande organisatie.

25 oktober 2023

2-99

  • R24 toegevoegd in het gedeelte Toepassingsserver configureren met inrichtingsservice-URL.

13 september 2023

2-98

  • Netwerkvereisten voor Webex voor Cisco Broadworks-koppelingen toegevoegd onder Aanbevolen documentabonnementen.

04 september 2023

2-97

  • Gedeelte Functies en beperkingen bijgewerkt onder Overzicht van Webex voor Cisco BroadWorks.

08 augustus 2023

2-96

  • Aantekeningen toegevoegd in Een BroadWorks-cluster bewerken of verwijderen in Partnerhub onder Webex beheren voor BroadWorks.

23 juni 2023

2-95

  • Het gedeelte Uw NPS voorbereiden op Webex voor Cisco BroadWorks is bijgewerkt onder Webex implementeren voor Cisco BroadWorks.

  • Het configureren van NPS voor het gebruik van Authentication Proxy connectionTimeout naar 3000 is bijgewerkt onder Webex voor Cisco BroadWorks implementeren.

30 mei 2023

2-94

  • Bijgewerkte sectie BroadWorks-softwarevereisten onder Webex voor Cisco BroadWorks-referentie.

26 mei 2023

2-93

  • Gedeelte Vertrouwensankers voor CTI-interface (R22 en hoger) bijgewerkt onder Webex implementeren voor Cisco BroadWorks.

  • Het gedeelte Vertrouwen configureren voor verificatieservice (met mTLS) is bijgewerkt onder Bijlage.

24 mei 2023

2-92

  • Het gedeelte Webex voor BroadWorks loskoppelen van bestaande organisatie is bijgewerkt onder Webex voor Cisco BroadWorks beheren.

  • Gedeelte Inbreken toegevoegd onder Webex voor Cisco BroadWorks implementeren.

10 mei 2023

2-91

  • Het gedeelte Busy Lamp Field/Call Pickup Notification is bijgewerkt onder Webex beheren voor Cisco BroadWorks.

09 mei 2023

2-90

  • Bijgewerkte sectie Land onder Uw omgeving voorbereiden.

04 mei 2023

2-89

  • Het gedeelte Uw klantsjablonen configureren is bijgewerkt onder Uw partnerorganisatie configureren in Partner Hub.

27 april 2023

2-88

  • Sectie Land toegevoegd onder Uw omgeving voorbereiden.

14 april 2023

2-87

  • Het gedeelte Ondersteuning voor groepscontactpersonen is bijgewerkt onder Bestellen en inrichten.

17 maart 2023

2-86

  • Het gedeelte Mobiel systeemeigen gesprek escaleren naar vergadering is toegevoegd onder Webex voor BroadWorks implementeren.

11 maart 2023

2-85

  • Bijgewerkte stappen in Verificatieservice configureren (met CI-tokenvalidatie) onder Webex voor Cisco BroadWorks implementeren.

10 maart 2023

2-84

  • Bijgewerkte sectie Xsi-interfaces.

07 maart 2023

2-83

  • Het gedeelte Ondersteuning voor groepscontactpersonen is toegevoegd onder Bestellen en inrichten.

28 februari 2023

2-82

  • Gedeelte Partner-SSO - OpenID Connect (OIDC) toegevoegd onder Webex voor Cisco BroadWorks implementeren.

15 februari 2023

2-81

  • Sectie Vertrouwensankers voor CTI-interface (R22 en hoger) bijgewerkt onder Webex implementeren voor Cisco BroadWorks en Vertrouwensservice configureren voor verificatieservice (met mTLS) onder Bijlage.

10 februari 2023

2-80

  • Toestelnummer bijgewerkt onder Overzicht van Webex voor Cisco BroadWorks.

Bijlage

Services configureren (met mTLS voor de verificatieservice)

De onderstaande procedures vervangen de procedures in het onderwerp Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's. Voltooi deze procedures alleen als u mTLS gebruikt voor de verificatieservice in plaats van CI-tokenvalidatie. Deze procedures zijn verplicht als u meerdere Webex-organisaties op dezelfde XSP|ADP-server uitvoert. Anders zijn ze optioneel.


 
Als u niet meerdere Webex-organisaties op dezelfde XSP|ADP-server uitvoert, wordt CI Token Validation (met TLS) aanbevolen voor de verificatieservice. Raadpleeg Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's voor meer informatie over het configureren van de verificatieservice en andere services.

Xsi-interfaces

Installeer en configureer de Xsi-Actions- en Xsi-Events-toepassingen zoals beschreven in de Configuratiehandleiding voor Cisco BroadWorks Xtended Services Interface.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Voor alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moet dezelfde callControlApplicationName zijn gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker is geïntegreerd in Webex, maakt Webex een abonnement voor de gebruiker op de AS om telefoniegebeurtenissen te ontvangen voor aanwezigheid en gespreksgeschiedenis. Het abonnement is gekoppeld aan de callControlApplicationName en de AS gebruikt het om te weten naar welke Xsi-Events de telefonie-gebeurtenissen moeten worden verzonden.


 

Het wijzigen van de callControlApplicationName of het niet hebben van dezelfde naam op alle Xsi-Events-webapps zal invloed hebben op abonnementen en telefonie gebeurtenissen functionaliteit.

Verificatieservice configureren (met mTLS)

BroadWorks-tokens met een lange levensduur worden gegenereerd en gevalideerd door de verificatieservice die wordt gehost op uw XSP|ADP's.

Vereisten

  • Op de XSP|ADP-servers die de verificatieservice hosten, moet een mTLS-interface zijn geconfigureerd.

  • XSP|ADP's moeten dezelfde sleutels delen voor het coderen/decoderen van BroadWorks-tokens met een lange levensduur. Het kopiëren van deze sleutels naar elke XSP|ADP is een handmatig proces.

  • XSP|ADP's moeten worden gesynchroniseerd met NTP.

Configuratieoverzicht

De essentiële configuratie op uw XSP|ADP's omvat:

  • Implementeer de verificatieservice.

  • Configureer de tokenduur tot ten minste 60 dagen (laat de uitgever staan als BroadWorks).

  • RSA-sleutels genereren en delen met XSP|ADP's.

  • Geef de authService-URL op aan de webcontainer.

De verificatieservice implementeren op XSP|ADP

Op elke XSP|ADP die met Webex wordt gebruikt:

  1. Activeer de toepassing voor de verificatieservice op het pad /authService(je moet dit pad gebruiken):

    XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService

    (waarbij <version> is uw BroadWorks-versie).

  2. Implementeer de toepassing:

    XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authService

Duur token configureren

  1. Controleer de bestaande tokenconfiguratie (uren):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> get

  2. Stel de duur in op 60 dagen (max. 180 dagen):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> set tokenDurationInHours 1440

RSA-sleutels genereren en delen

  • U moet dezelfde openbare/privésleutelparen gebruiken voor tokencodering/decodering in alle instanties van de verificatieservice.

  • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet uitgeven.

Vanwege deze twee factoren moet u sleutels genereren op één XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's.


 

Als u met de toetsen gaat fietsen of de lengte van de toetsen wijzigt, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw starten.

  1. Selecteer één XSP|ADP om een sleutelpaar te genereren.

  2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen in de browser van de client:

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

    (Dit genereert een privaat/openbaar sleutelpaar op de XSP|ADP, als dat er nog niet was)

  3. De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:

    XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

  4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere .keys bestand indien nodig.

  5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

Geef de authService-URL aan de webcontainer

De webcontainer van de XSP|ADP heeft de authService-URL nodig zodat deze tokens kan valideren.

Op elk van de XSP|ADP's:

  1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het communicatiehulpprogramma BroadWorks:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

  2. Voeg de URL van de verificatieservice toe aan de container:

    XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

    Hiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.

  3. Controleer de parameter met get.

  4. Start de XSP|ADP opnieuw op.

TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)

De toepassingen Verificatieservice, Xsi-acties en Xsi-Events maken gebruik van HTTP-serverinterfaces. De TLS-configureerbaarheidsniveaus voor deze toepassingen zijn als volgt:

Meest algemeen = Systeem > Transport > HTTP > HTTP Server interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit CLI-context
Systeem (globaal)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze veilig zijn en of ze clientverificatie vereisen.

Apache tomcat vereist een certificaat voor elke veilige interface; het systeem genereert een zelfondertekend certificaat als dit nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2-protocol toevoegen aan de HTTP-serverinterface

De HTTP-interface die communiceert met de Webex-cloud moet zijn geconfigureerd voor TLSv1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren in de interface van de HTTP-server:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken in de HTTP-serverinterface

De vereiste cijfers configureren:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de interface van de HTTP-server.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 in de interface van de HTTP-server gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Trust configureren voor verificatieservice (met mTLS)

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om CombinedCertChain2023.txt op uw lokale computer.


     
    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze uploadt naar de XSP|ADP's. Alle bestanden zijn vereist.
  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt.

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE----- en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één tekstblok bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt.

  5. Meld u aan bij de XSP|ADP en ga naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoeren UpdateTrust om de parameters en opdrachtindeling weer te geven.

  6. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023

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

     

    Alle aliassen moeten een andere naam hebben. webexclientroot, webexclientroot2023, webexclientissuing en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang de vier ingangen uniek zijn.

  7. Bevestig dat de ankers zijn bijgewerkt:

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get

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

(Optie) mTLS configureren op het niveau van de HTTP-interface/poort

Het is mogelijk om mTLS te configureren op het niveau van de HTTP-interface/poort of per webtoepassing.

De manier waarop u mTLS inschakelt voor uw toepassing, hangt af van de toepassingen die u host op de XSP|ADP. Als u meerdere toepassingen host waarvoor mTLS nodig is, moet u mTLS inschakelen op de interface. Als u slechts één van de verschillende toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op HTTP-interface/poortniveau is mTLS vereist voor alle gehoste webtoepassingen die via deze interface/poort worden geopend.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/HttpServer> en voer de get opdracht om de raakvlakken te zien.

  3. Als u een interface wilt toevoegen en daar clientverificatie wilt vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true

    Zie de XSP|ADP CLI-documentatie voor meer informatie. In wezen de eerste true beveiligt de interface met TLS (servercertificaat wordt gemaakt indien nodig) en de tweede true dwingt de interface om clientcertificaatverificatie te vereisen (samen zijn het mTLS).

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/HttpServer> get

Interface Port Name Secure Client Auth Req Cluster Fqdn
         =======================================================
         192.0.2.7 443 XSP|ADP01.collab.example.net true false 
         192.0.2.7 444 XSP|ADP01.collab.example.net true true

In dit voorbeeld is mTLS (Client Auth Req = true) ingeschakeld op 192.0.2.7 poort 444. TLS is ingeschakeld op 192.0.2.7 poort 443.

(Optie) mTLS configureren voor specifieke webtoepassingen

Het is mogelijk om mTLS te configureren op het niveau van de HTTP-interface/poort of per webtoepassing.

De manier waarop u mTLS inschakelt voor uw toepassing, hangt af van de toepassingen die u host op de XSP|ADP. Als u meerdere toepassingen host waarvoor mTLS nodig is, moet u mTLS inschakelen op de interface. Als u slechts één van de verschillende toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op toepassingsniveau is mTLS vereist voor die toepassing, ongeacht de HTTP-serverinterfaceconfiguratie.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> en voer de get om te zien welke toepassingen worden uitgevoerd.

  3. Een toepassing toevoegen en hiervoor clientverificatie vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true

    Zie de XSP|ADP CLI-documentatie voor meer informatie. Daar worden de toepassingsnamen opgesomd. Het true in dit commando wordt mTLS ingeschakeld.

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add 192.0.2.7 443 AuthenticationService true

De voorbeeldopdracht voegt de AuthenticationService-toepassing toe aan 192.0.2.7:443 en vereist dat de toepassing certificaten van de client aanvraagt en verifieert.

Vraag na bij get:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> get

Interface Ip Port Application Name Client Auth Req
         ===================================================
         192.0.2.7 443 AuthenticationService      true          

Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver

Profielserver en XSP|ADP zijn verplicht voor apparaatbeheer. Ze moeten worden geconfigureerd volgens de instructies in de configuratiehandleiding voor BroadWorks-apparaatbeheer.

Hoe gaat u verder?

Voor configuratie kunt u opnieuw deelnemen aan de hoofddocumentstroom via CTI-interface en gerelateerde configuratie.

Aanvullende certificaatvereisten voor wederzijdse TLS-verificatie tegen AuthService

Webex communiceert met de verificatieservice via een wederzijdse TLS-geverifieerde verbinding. Dit betekent dat Webex een clientcertificaat presenteert en dat de XSP|ADP moet valideren. Als u dit certificaat wilt vertrouwen, gebruikt u de Webex CA-certificaatketen om een vertrouwensanker op XSP|ADP (of proxy) te maken. De certificaatketen kan worden gedownload via Partner Hub:

  1. Ga naar Instellingen > BroadWorks Calling.

  2. Klik op de koppeling voor het downloadcertificaat.


 

U kunt de certificaatketen ook ophalen van https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.

De exacte vereisten voor het implementeren van deze Webex CA-certificaatketen zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt samengevat waar de Webex CA-certificaatketen in deze drie gevallen moet worden geïmplementeerd.

Vereisten voor wederzijds TLS-certificaat voor TLS-bridge Proxy

  • Webex presenteert een door Webex CA ondertekend clientcertificaat aan de proxy.

  • De Webex CA-certificaatketen wordt geïmplementeerd in het proxyvertrouwensarchief, zodat de proxy het clientcertificaat vertrouwt.

  • Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de proxy geladen.

  • De proxy presenteert een openbaar ondertekend servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • De volmachthebber legt een intern ondertekend clientcertificaat voor aan de XSP|ADP’s.

    Dit certificaat moet het uitbreidingsveld Extended Key Usage van x509.v3 bevatten met het BroadWorks-OID-doel 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS-clientAuth. Bijv.:

    X509v3 extensions:

    X509v3 Extended Key Usage:

    1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client
                  Authentication 

     

    Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP’s presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

Vereisten voor wederzijds TLS-certificaat voor TLS-passthrough Proxy of XSP in DMZ

  • Webex presenteert een door Webex CA ondertekend clientcertificaat aan de XSP's.

  • De Webex CA-certificaatketen wordt geïmplementeerd in het vertrouwensarchief van de XSP's, zodat de XSP's het clientcertificaat vertrouwen.

  • Het openbaar ondertekende XSP-servercertificaat wordt ook in de XSP's geladen.

  • De XSP's presenteren openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP's heeft ondertekend.

Revisiegeschiedenis van document

De volgende tabel toont een geschiedenis van wijzigingen aan dit document in de afgelopen 12 maanden.

Datum

Versie

Beschrijving van de wijziging

07 maart 2024

2-111

  • Het gedeelte Aanmeldstroom beheren is bijgewerkt in Gebruikersaanmelding en Configuratie ophalen.

24 februari 2024

2-110

  • Redactionele wijzigingen.

20 februari 2024

2-109

  • Het gedeelte Indicatie visuele spam toegevoegd onder Webex voor BroadWorks implementeren.

07 februari 2024

2-108

  • Een functie BroadWorks-melding voor het verlopen van een wachtwoord toegevoegd tijdens het aanmelden onder Webex for BroadWorks-referentie.

25 januari 2024

2-107

  • Redactionele wijzigingen.

23 januari 2024

2-106

  • Redactionele wijzigingen aangebracht in het gedeelte Gebruiker verplaatsen (met toestemming) naar Webex voor Cisco BroadWorks onder Webex beheren voor BroadWorks.

10 januari 2024

2-105

  • Redactionele wijzigingen.

20 december 2023

2-104

13 december 2023

2-103

  • Klantsjabloon is gewijzigd in 'Onboarding-sjabloon'. De oplossingshandleiding is bijgewerkt.

12 december 2023

2-102

  • Webex voor BroadWorks toevoegen aan het gedeelte Bestaande organisatie onder Webex voor BroadWorks beheren is bijgewerkt.

08 december 2023

2-101

  • Redactionele wijzigingen.

08 november 2023

2-100

  • Een opmerking toegevoegd in het gedeelte Webex voor BroadWorks toevoegen aan bestaande organisatie.

25 oktober 2023

2-99

  • R24 toegevoegd in het gedeelte Toepassingsserver configureren met inrichtingsservice-URL.

13 september 2023

2-98

  • Netwerkvereisten voor Webex voor Cisco Broadworks-koppelingen toegevoegd onder Aanbevolen documentabonnementen.

04 september 2023

2-97

  • Gedeelte Functies en beperkingen bijgewerkt onder Overzicht van Webex voor Cisco BroadWorks.

08 augustus 2023

2-96

  • Aantekeningen toegevoegd in Een BroadWorks-cluster bewerken of verwijderen in Partnerhub onder Webex beheren voor BroadWorks.

23 juni 2023

2-95

  • Het gedeelte Uw NPS voorbereiden op Webex voor Cisco BroadWorks is bijgewerkt onder Webex implementeren voor Cisco BroadWorks.

  • Het configureren van NPS voor het gebruik van Authentication Proxy connectionTimeout naar 3000 is bijgewerkt onder Webex voor Cisco BroadWorks implementeren.

30 mei 2023

2-94

  • Bijgewerkte sectie BroadWorks-softwarevereisten onder Webex voor Cisco BroadWorks-referentie.

26 mei 2023

2-93

  • Gedeelte Vertrouwensankers voor CTI-interface (R22 en hoger) bijgewerkt onder Webex implementeren voor Cisco BroadWorks.

  • Het gedeelte Vertrouwen configureren voor verificatieservice (met mTLS) is bijgewerkt onder Bijlage.

24 mei 2023

2-92

  • Het gedeelte Webex voor BroadWorks loskoppelen van bestaande organisatie is bijgewerkt onder Webex voor Cisco BroadWorks beheren.

  • Gedeelte Inbreken toegevoegd onder Webex voor Cisco BroadWorks implementeren.

10 mei 2023

2-91

  • Het gedeelte Busy Lamp Field/Call Pickup Notification is bijgewerkt onder Webex beheren voor Cisco BroadWorks.

09 mei 2023

2-90

  • Bijgewerkte sectie Land onder Uw omgeving voorbereiden.

04 mei 2023

2-89

  • Het gedeelte Uw klantsjablonen configureren is bijgewerkt onder Uw partnerorganisatie configureren in Partner Hub.

27 april 2023

2-88

  • Sectie Land toegevoegd onder Uw omgeving voorbereiden.

14 april 2023

2-87

  • Het gedeelte Ondersteuning voor groepscontactpersonen is bijgewerkt onder Bestellen en inrichten.

17 maart 2023

2-86

  • Het gedeelte Mobiel systeemeigen gesprek escaleren naar vergadering is toegevoegd onder Webex voor BroadWorks implementeren.

11 maart 2023

2-85

  • Bijgewerkte stappen in Verificatieservice configureren (met CI-tokenvalidatie) onder Webex voor Cisco BroadWorks implementeren.

10 maart 2023

2-84

  • Bijgewerkte sectie Xsi-interfaces.

07 maart 2023

2-83

  • Het gedeelte Ondersteuning voor groepscontactpersonen is toegevoegd onder Bestellen en inrichten.

28 februari 2023

2-82

  • Gedeelte Partner-SSO - OpenID Connect (OIDC) toegevoegd onder Webex voor Cisco BroadWorks implementeren.

15 februari 2023

2-81

  • Sectie Vertrouwensankers voor CTI-interface (R22 en hoger) bijgewerkt onder Webex implementeren voor Cisco BroadWorks en Vertrouwensservice configureren voor verificatieservice (met mTLS) onder Bijlage.

10 februari 2023

2-80

  • Toestelnummer bijgewerkt onder Overzicht van Webex voor Cisco BroadWorks.

Overzicht van Webex voor Cisco BroadWorks

Introductie van Webex voor Cisco BroadWorks

Revisiegeschiedenis van document

Dit gedeelte behandelt systeembeheerders bij Cisco-partnerorganisaties (serviceproviders) die Webex implementeren voor hun klantorganisaties of deze oplossing rechtstreeks aanbieden aan hun eigen abonnees.

Doel van de oplossing

  • Webex-cloudsamenwerkingsfuncties aanbieden aan kleine en middelgrote klanten die al gespreksservice hebben die wordt geleverd door BroadWorks-serviceproviders.

  • BroadWorks-gebaseerde gespreksservice aanbieden aan kleine en middelgrote Webex-klanten.

Context

We evolueren al onze samenwerkingsklanten naar een uniforme toepassing. Dit pad vermindert aannameproblemen, verbetert de interoperabiliteit en migratie en biedt voorspelbare gebruikerservaringen in ons hele samenwerkingsportfolio. Een deel van deze inspanning is het verplaatsen van de BroadWorks-gespreksmogelijkheden naar de Webex-app en uiteindelijk het verminderen van investeringen in de UC-One-clients.

Voordelen

  • Toekomstbestendigheid: tegen beëindiging van UC-One Collaborate, beweging van alle clients naar het Unified Client Framework (UCF)

  • Het beste van beide: Webex-functies voor berichten en vergaderingen inschakelen met behoud van BroadWorks-gesprekken op uw telefonienetwerk

Toepassingsgebied van de oplossing

  • Bestaande/nieuwe kleine tot middelgrote klanten (minder dan 250 abonnees) die een reeks samenwerkingsfuncties willen, hebben mogelijk al BroadWorks-gesprekken.

  • Bestaande kleine tot middelgrote Webex-klanten die BroadWorks Calling willen toevoegen.

  • Niet voor grotere ondernemingen (raadpleeg ons Enterprise-portfolio voor Webex).

  • Niet voor één gebruiker (evalueer Webex Online-aanbiedingen).

De functiesets in Webex voor Cisco BroadWorks zijn gericht op gebruiksscenario's voor kleine tot middelgrote bedrijven. De Webex voor Cisco BroadWorks-pakketten zijn ontworpen om de complexiteit voor kleine en middelgrote ondernemingen te verminderen en we evalueren voortdurend hun geschiktheid voor dit segment. We kunnen ervoor kiezen functies die anders beschikbaar zijn in de bedrijfspakketten te verbergen of te verwijderen.

Vereisten voor succes met Webex voor Cisco BroadWorks

#

Vereiste

Notities

1

Patchstroom BroadWorks R22 of hoger

2

XSP|ADP voor XSI, CTI, DMS en authService

Specifieke XSP|ADP voor Webex voor Cisco BroadWorks

3

Afzonderlijke XSP|ADP voor NPS kunnen worden gedeeld met andere oplossingen die NPS gebruiken.

Als u een bestaande implementatie voor samenwerken hebt, controleert u aanbevelingen voor XSP|ADP- en NPS-configuraties.

4

CI-tokenvalidatie (met TLS) geconfigureerd voor Webex-verbindingen met de verificatieservice.

5

mTLS is geconfigureerd voor Webex-verbindingen met de CTI-interface.

Voor andere toepassingen is geen mTLS vereist.

6

Gebruikers moeten bestaan in BroadWorks en hebben de volgende kenmerken nodig, afhankelijk van uw inrichtingsbeslissing:

  • Doorloop met vertrouwde e-mails: Het e-mailkenmerk van de BroadWorks-gebruiker moet een geldig e-mailadres bevatten dat uniek is voor die gebruiker. De gebruiker moet ook een primair nummer of toestel hebben.

  • Doorloop met niet-vertrouwde e-mails, zelfactivering of API-inrichting: Gebruiker heeft geen e-mailadres nodig, maar moet een primair nummer of toestel hebben.

Voor vertrouwde e-mails: We raden u aan hetzelfde e-mailadres ook in het kenmerk Alternatieve id in te voeren, zodat gebruikers zich met e-mailadres kunnen aanmelden bij BroadWorks.

Voor niet-vertrouwde e-mails: Afhankelijk van de e-mailinstellingen van de gebruiker kan het gebruik van niet-vertrouwde e-mails ertoe leiden dat de e-mail wordt verzonden naar de ongewenste of spammap van de gebruiker. De beheerder moet mogelijk de e-mailinstellingen van de gebruiker wijzigen om domeinen toe te staan

7

Webex voor Cisco BroadWorks DTAF-bestand voor de Webex-app

8

BW Business Lic of Std Enterprise of Prem Enterprise User Lic + Webex voor Cisco BroadWorks-abonnement

Als u een bestaande implementatie voor samenwerken hebt, hebt u geen UC-One Add-On Bundle, Collab Lic en Meet-me Conference Ports meer nodig.

Als u een bestaande UC-One SaaS-implementatie hebt, zijn er geen andere wijzigingen dan het accepteren van de voorwaarden van het Premium-pakket.

9

IP/poorten moeten toegankelijk zijn via de Webex-backend-services en de Webex-apps via openbaar internet.

Zie het gedeelte “Uw netwerk voorbereiden”.

10

TLS v1.2-configuratie op XSP|ADP's

11

Voor Flowthrough-inrichting moet de toepassingsserver verbinding maken met de BroadWorks-inrichtingsadapter.


 

We testen of ondersteunen geen uitgaande proxyconfiguratie. Als u een uitgaande proxy gebruikt, accepteert u de verantwoordelijkheid om deze te ondersteunen met Webex voor Cisco BroadWorks.

Zie het onderwerp “Uw netwerk voorbereiden”.

Over dit document

Het doel van dit document is u te helpen uw Webex for Cisco BroadWorks-oplossing te begrijpen, voor te bereiden, te implementeren en te beheren. De grote delen in het document weerspiegelen dit doel.

Deze gids bevat conceptueel en referentiemateriaal. We zijn van plan alle aspecten van de oplossing in dit ene document te behandelen.

De minimale set taken om de oplossing te implementeren zijn:

  1. Bereik uw accountteam om een Cisco-partner te worden. Het is noodzakelijk dat u de Cisco-aanrakingspunten onderzoekt om uzelf vertrouwd te maken (en getraind te worden). Wanneer u een Cisco-partner wordt, passen we de Webex voor Cisco BroadWorks-schakelaar toe op uw Webex-partnerorganisatie. (Zie Webex implementeren voor Cisco BroadWorks > Onboarding voor partners in dit document.)

  2. Configureer uw BroadWorks-systemen voor integratie met Webex. (Zie Webex implementeren voor Cisco BroadWorks > Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's in dit document.)

  3. Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)

  4. Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)

  5. Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)


 
  • Dit zijn stappen van hoog niveau, in de typische volgorde. Er zijn verschillende bijdragende taken die u niet kunt negeren.

  • Als u uw eigen toepassingen wilt maken om uw Webex voor Cisco BroadWorks-abonnees te beheren, leest u De inrichtings-API gebruiken in het gedeelte Referentie van deze handleiding.

Terminologie

We proberen het jargon en de letterwoorden in dit document te beperken en elke term uit te leggen wanneer deze voor het eerst wordt gebruikt. (Zie Webex voor Cisco BroadWorks-referentie > Terminologie als een term niet in de context wordt uitgelegd.)

Hoe het werkt

Webex voor Cisco BroadWorks is een aanbieding die BroadWorks-gesprekken integreert in Webex. Abonnees gebruiken één toepassing (de Webex-app) om gebruik te maken van functies die door beide platforms worden aangeboden:

  • Gebruikers bellen PSTN-nummers via uw BroadWorks-infrastructuur.

  • Gebruikers bellen met andere BroadWorks-nummers via uw BroadWorks-infrastructuur (audio-/videogesprekken door de nummers te selecteren die zijn gekoppeld aan de gebruikers of het toetsenblok om de nummers te introduceren).

  • Gebruikers kunnen ook een Webex VoIP-gesprek plaatsen via de Webex-infrastructuur door de optie 'Webex Call' te selecteren in de Webex-app. (Deze gesprekken zijn de Webex-app naar de Webex-app, niet de Webex-app naar PSTN).

  • Gebruikers kunnen Webex Meetings hosten en eraan deelnemen.

  • Gebruikers kunnen elkaar een voor een berichten sturen of in ruimten (permanente groepchat) en profiteren van functies als zoeken en bestanden delen (op Webex-infrastructuur).

  • Gebruikers kunnen aanwezigheid (status) delen. Ze kunnen aangepaste aanwezigheid of door de klant berekende aanwezigheid kiezen.

  • Nadat we u als partnerorganisatie hebben geïntegreerd in Control Hub, met de juiste rechten, kunt u de relatie tussen uw BroadWorks-exemplaar en Webex configureren.

  • U maakt klantorganisaties in Control Hub en richt gebruikers in deze organisaties in.

  • Elke abonnee in BroadWorks krijgt een Webex-identiteit op basis van zijn/haar e-mailadres (kenmerk e-mail-id in BroadWorks).

  • Gebruikers worden geverifieerd voor BroadWorks of voor Webex.

  • Clients krijgen langdurige tokens om ze te autoriseren voor services bij BroadWorks en Webex.

De Webex-app in het midden van deze oplossing; het is een brandbare toepassing die beschikbaar is op Mac/Windows-bureaubladen en Android/iOS-telefoons en -tablets.

Er is ook een webversie van de Webex-app die momenteel geen gespreksfuncties bevat.

De client maakt verbinding met de Webex-cloud om functies voor berichten, aanwezigheid en vergaderingen te leveren.

De client registreert zich bij uw BroadWorks-systemen voor gespreksfuncties.

De Webex-cloud werkt met uw BroadWorks-systemen om een naadloze gebruikersinrichting te garanderen.

Functies en beperkingen

Wij bieden verschillende pakketten met verschillende functies.

Softphone-pakket

Dit pakkettype gebruikt de Webex-app als een softphone only-client met belmogelijkheden, maar geen berichtmogelijkheden. Gebruikers met dit pakkettype kunnen deelnemen aan Webex-vergaderingen, maar kunnen geen vergaderingen zelf starten. Wanneer andere gebruikers (softphone of niet-softphone) in de telefoonlijst zoeken naar een softphone-gebruiker, bieden de zoekresultaten geen optie om een bericht te verzenden.

Softphone-gebruikers kunnen hun scherm delen tijdens een gesprek.

Basispakket

Het basispakket bevat functies voor bellen, chatten en vergaderen. Het omvat 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room). (** zie onderstaande Note voor uitzondering). In dit pakket kunnen de vergaderingen een maximale duur van 40 minuten hebben.

Pakket "Standaard"

Dit pakket omvat ook alles in het basispakket, zoals maximaal 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room).

Scherm delen binnen een PMR-vergadering is een rol die in eerste instantie alleen wordt uitgeoefend door de host van de vergadering, maar de host kan de rol van presentator overdragen aan een door hem of haar gekozen deelnemer aan de vergadering. Alleen de host kan de rol van presentator opnieuw opnemen zonder dat de huidige host deze aan hem of haar heeft doorgegeven.

"Premium"-pakket

Dit pakket omvat alles in het standaardpakket plus maximaal 300 deelnemers aan een vergadering in een 'unified space' en maximaal 1000 deelnemers in een persoonlijke vergaderruimte (PMR).

Scherm delen binnen een PMR-vergadering wordt ondersteund voor elke deelnemer aan de vergadering.

Pakketten vergelijken

Pakket

Oproepen

Berichten

Unified Space-vergaderingen

PMR Meetings

Softphone

Opgenomen

Niet inbegrepen

Geen

Geen

Eenvoudig

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Standaard

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Premium

Opgenomen

Opgenomen

300 deelnemers

1000 deelnemers


 
De limiet voor Unified Space-vergaderingen voor basisgebruikers is 100 deelnemers per Unified Space-vergadering, tenzij de ruimte ook gebruikers bevat waaraan de pakketten 'Standaard' of 'Premium' zijn toegewezen. In dat geval wordt de limiet verhoogd op basis van het gebruikerspakket van de host.

 

'Unified Space Meetings' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in een Webex-ruimte. Een gebruiker start bijvoorbeeld een vergadering vanuit de ruimte via de knoppen 'Vergaderen' of 'Plannen'.

'PMR-vergaderingen' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in de persoonlijke vergaderruimte (PMR) van een gebruiker. Deze vergaderingen gebruiken een speciale URL (bijvoorbeeld: cisco.webex.com/meet/roomOwnerUserID).

Berichten en vergaderingsfuncties

Raadpleeg de volgende tabel voor verschillen in ondersteuning van PMR-vergaderingsfuncties voor Basic-, Standard- en Premium-pakketten.

Tabel 1. Verschillen in functieondersteuning voor PMR-vergaderingen

Vergaderingsfunctie

Ondersteund met basispakket

Overgezet met standaardpakket

Ondersteund met Preminum-pakket

Opmerking

Vergaderduur

40 minuten of minder

Onbeperkt

Onbeperkt

Bureaublad delen

Ja

Ja

Ja

Basis: bureaublad delen door een PMR-vergaderingdeelnemer.

Standaard : bureaublad delen alleen door de host van de PMR-vergadering.

Premium: bureaublad delen door een deelnemer aan een PMR-vergadering.

Toepassingen delen

Ja

Ja

Ja

Basis: toepassingen delen door elke deelnemer aan een PMR-vergadering.

Standaard : toepassingen delen alleen door de host van de PMR-vergadering.

Premium: toepassingen delen door deelnemers aan een PMR-vergadering.

Chat met meerdere partijen

Ja

Ja

Ja

Whiteboarden

Ja

Ja

Ja

Wachtwoordbeveiliging

Ja

Ja

Ja

Web-app - geen downloaden of invoegtoepassingen (gastervaring)

Ja

Ja

Ja

Ondersteuning voor koppelen met Webex-apparaten

Ja

Ja

Ja

Vloerbeheer (Eén dempen / Alles verwijderen)

Ja

Ja

Ja

Koppeling voor blijvende vergaderingen

Ja

Ja

Ja

Toegang tot de Meetings-site

Ja

Ja

Ja

Deelnemen aan vergadering via VoIP

Ja

Ja

Ja

Vergrendeling

Ja

Ja

Ja

Bedieningselementen voor presentator

Nee

Nee

Ja

Extern bureaubladbeheer

Nee

Nee

Ja

Aantal deelnemers

100

100

1000

Opname lokaal opgeslagen in het systeem

Ja

Ja

Ja

Opnemen in de cloud

Nee

Nee

Ja

Opname - Cloudopslag

Nee

Nee

10 GB per locatie

Opnametranscripties

Nee

Nee

Ja

Vergaderingen plannen

Ja

Ja

Ja

Inhoud delen met externe integraties inschakelen

Nee

Nee

Ja

Basic— Inhoud delen door een deelnemer aan een PMR-vergadering.

Standaard: inhoud delen met alleen de host van de PMR-vergadering.

Premium: inhoud delen door een deelnemer aan een PMR-vergadering.

PMR-URL wijzigen toestaan

Nee

Nee

Ja

Basic— Gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL wijzigen vanuit Control Hub.

Standaard: de PMR-URL kan alleen worden gewijzigd vanuit Partner Hub door partner- en organisatiebeheerders.

Premium: gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL vanuit Partner Hub wijzigen.

Live streaming van vergaderingen (Bv. op Facebook, Youtube)

Nee

Nee

Ja

Andere gebruikers toestaan vergaderingen namens hen te plannen

Nee

Nee

Ja

Een alternatieve host toevoegen

Ja

Nee

Ja

App-integratie (bijv. Zendesk, Slack)

Afhankelijk van de integratie

Afhankelijk van de integratie

Ja

Zie het gedeelte App-integraties hieronder voor meer informatie over ondersteuning.

Integratie met Microsoft Office 365-agenda

Ja

Ja

Ja

Integratie met Google-agenda voor G Suite

Ja

Ja

Ja

Het Webex-helpcentrum publiceert de functies en documentatie voor gebruikers voor Webex op help.webex.com. Lees de volgende artikelen voor meer informatie over de functies:

Gespreksfuncties

De belervaring is vergelijkbaar met eerdere oplossingen die gebruikmaken van de BroadWorks-gespreksbeheermotor. Het verschil met UC-One Collaborate en UC-One SaaS is dat de Webex-app de primaire softclient is.

App-integraties

U kunt Webex voor Cisco BroadWorks integreren met de volgende toepassingen:

Ondersteuning voor Virtual Desktop Infrastructure (VDI)

Webex voor Cisco BroadWorks ondersteunt nu VDI-omgevingen (Virtual Desktop Infrastructure). Raadpleeg de Implementatiehandleiding voor Webex voor Virtual Desktop Infrastructure (VDI) voor meer informatie over de implementatie van VDI-infrastructuur.

IPv6-ondersteuning

Webex voor Cisco BroadWorks ondersteunt IPv6-adressering voor de Webex-app.

Toekomstige routekaart

Ga naar https://salesconnect.cisco.com/#/program/PAGE-16649 voor meer informatie over onze voornemens voor de toekomstige versies van Webex voor Cisco BroadWorks. De items van het stappenplan zijn in geen enkele hoedanigheid bindend. Cisco behoudt zich het recht voor om een of al deze items uit toekomstige releases te onthouden of te herzien.

Beperkingen

Inrichtingsbeperkingen

Tijdzone van Meetings-site

De tijdzone van de eerste abonnee voor elk pakket wordt de tijdzone voor de Webex Meetings-site die voor dat pakket is gemaakt.

Als er geen tijdzone is opgegeven in het inrichtingsverzoek voor de eerste gebruiker van elk pakket, wordt de tijdzone van de Webex Meetings-site voor dat pakket ingesteld op de regionale standaard van de organisatie van de abonnees.

Als uw klant een specifieke tijdzone van de Webex Meetings-site nodig heeft, geeft u de timezone parameter in de inrichtingsaanvraag voor:

  • de eerste abonnee die is ingericht voor het standaardpakket in de organisatie.

  • de eerste abonnee die is ingericht voor Premium-pakket in de organisatie.

  • de eerste abonnee die is ingericht voor het basispakket in de organisatie.

Algemene beperkingen

  • Geen gesprekken in de webversie van de Webex-client (dit is een clientbeperking, geen oplossingsbeperking.)

  • Webex beschikt mogelijk nog niet over alle besturingselementen voor de gebruikersinterface om bepaalde functies voor gespreksbeheer te ondersteunen die beschikbaar zijn via BroadWorks.

  • De Webex-client kan momenteel geen 'wit label' hebben.

  • Wanneer u klantorganisaties maakt met de door u gekozen inrichtingsmethode, worden deze automatisch gemaakt in dezelfde regio als uw partnerorganisatie. Dit gedrag is zo bepaald. We verwachten van multinationale partners dat ze in elke regio een partnerorganisatie creëren waar ze klantorganisaties beheren.

  • Rapportage over het gebruik van vergaderingen en berichten is beschikbaar via de klantorganisatie in Control Hub.

Bekende problemen en beperkingen

Zie Bekende problemen en beperkingen voor een actuele lijst met bekende problemen en beperkingen met het Webex voor Cisco BroadWorks-aanbod.

Berichtenlimieten

De volgende opslaglimieten voor gegevens (berichten en bestanden gecombineerd) zijn van toepassing op organisaties die Webex voor Cisco BroadWorks-services hebben aangeschaft via een serviceprovider. Deze limieten vertegenwoordigen de maximale opslag voor berichten en bestanden gecombineerd.

  • Basis: 2 GB per gebruiker gedurende 3 jaar

  • Standaard 5 GB per gebruiker gedurende 3 jaar

  • Premie: 10 GB per gebruiker gedurende 5 jaar

Voor elke klantorganisatie worden deze totalen per gebruiker samengevoegd om een geaggregeerd totaal voor die klant op te geven, op basis van het aantal gebruikers. Een bedrijf met vijf premium-gebruikers heeft bijvoorbeeld een totale limiet voor berichten en bestandsopslag van 50 GB. Een individuele gebruiker kan de limiet per gebruiker (10 GB) overschrijden op voorwaarde dat het bedrijf nog onder het geaggregeerde maximum (50 GB) zit.

Voor teamruimten die worden gemaakt, gelden de berichtlimieten voor het geaggregeerde totaal voor de klantorganisatie die eigenaar is van de teamruimte. U vindt informatie over de eigenaar van individuele teamruimten in het ruimtebeleid. Zie https://help.webex.com/en-us/baztm6/Webex-Space-Policy voor meer informatie over het bekijken van het ruimtebeleid voor een individuele teamruimte.

Aanvullende informatie

Raadpleeg https://help.webex.com/en-us/n8vw82eb/Webex-Capacities voor meer informatie over algemene berichtbeperkingen die van toepassing zijn op Webex-ruimten van het berichtenteam.

Beveiliging, gegevens en rollen

Webex-beveiliging

De Webex-client is een veilige toepassing die veilige verbindingen maakt met Webex en BroadWorks. De gegevens die in de Webex-cloud zijn opgeslagen en via de Webex-app aan de gebruiker zijn blootgesteld, worden zowel onderweg als in rust gecodeerd.

Meer informatie over gegevensuitwisseling vindt u in het deel Referentie van dit document.

Bijkomende lectuur

Locatie organisatiegegevens

We slaan uw Webex-gegevens op in het datacenter dat het meest overeenkomt met uw regio. Zie Gegevensresidentie in Webex in het Helpcentrum.

Rollen

Beheerder serviceprovider (u): Voor dagelijkse onderhoudsactiviteiten beheert u de lokale (bel)onderdelen van de oplossing met behulp van uw eigen systemen. U beheert de Webex-onderdelen van de oplossing via Partner Hub.

Zie Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM voor informatie over de rollen die beschikbaar zijn voor partners, de toegangsrechten die bij deze rollen horen en hoe u rollen kunt toewijzen.


 
De eerste gebruiker die is ingericht voor een nieuw partnerorganizaiton, wordt automatisch toegewezen aan de rollen Volledige beheerder en Volledige partnerbeheerder. Die beheerder kan het bovenstaande artikel gebruiken om extra rollen toe te wijzen.

Cisco Cloud Operations-team: Maakt uw 'partnerorganisatie' in Partner Hub, als deze niet bestaat, tijdens uw onboarding.

Zodra u uw Partner Hub-account hebt, configureert u de Webex-interfaces met uw eigen systemen. Vervolgens maakt u 'Onboarding-sjablonen' om de suites of pakketten weer te geven die via deze systemen worden aangeboden. Vervolgens richt u uw klanten of abonnees in.

#

Typische taak

SP

Cisco

1

Onboarding voor partners - De partnerorganisatie maken als deze nog niet bestaat en de benodigde functieschakelaars inschakelen

2

BroadWorks-configuratie in partnerorganisatie via Partner Hub (cluster)

3

Integratie-instellingen configureren in de partnerorganisatie via Partner Hub (aanbiedingssjablonen, branding)

4

BroadWorks-omgeving voorbereiden voor integratie (AS, XSP|ADP Patching, firewalls, XSP|ADP-configuratie, XSI, AuthService, CTI, NPS, DMS-toepassingen op XSP|ADP)

5

Inrichtingsintegratie of -proces ontwikkelen

6

GTM-materialen voorbereiden

7

Nieuwe gebruikers migreren of inrichten

Architectuur

Wat staat er in het diagram?

Clients

  • De Webex-app-client dient als de primaire toepassing in Webex voor Cisco BroadWorks-aanbiedingen. De client is beschikbaar op desktop-, mobiele en webplatforms.

    De client heeft systeemeigen chat-, presence- en meerpartijenaudio-/videovergaderingen die door de Webex-cloud worden geleverd. De Webex-client gebruikt uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken.

  • Cisco IP-telefoons en gerelateerde accessoires gebruiken ook uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken. We verwachten telefoons van derden te kunnen ondersteunen.

  • Activeringsportal voor gebruikers om zich aan te melden bij Webex met hun BroadWorks-aanmeldgegevens.

  • Partner Hub is een webinterface voor het beheren van uw Webex-organisatie en de organisaties van uw klanten. In Partner Hub kunt u de integratie tussen uw BroadWorks-infrastructuur en Webex configureren. U gebruikt ook Partner Hub om de clientconfiguratie en facturering te beheren.

Netwerk van serviceproviders

Het groene blok links op het diagram staat voor uw netwerk. Componenten die in uw netwerk worden gehost, bieden de volgende services en interfaces aan andere delen van de oplossing:

  • Openbare XSP|ADP, voor Webex voor Cisco BroadWorks: (De box staat voor een of meerdere XSP|ADP-boerderijen, mogelijk aan de voorkant door lastbalancers.)

    • Host de Xtended Services-interface (XSI-acties en XSI-gebeurtenissen), de Device Management-service (DMS), CTI-interface en de verificatieservice. Samen stellen deze toepassingen telefoons en Webex-clients in staat om zichzelf te verifiëren, hun gespreksconfiguratiebestanden te downloaden, gesprekken te starten en te ontvangen en elkaars haakstatus (telefonische aanwezigheid) en gespreksgeschiedenis te bekijken.

    • Publiceert directory naar Webex-clients.

  • Openbare XSP|ADP, met NPS:

    • Pushserver voor hostmeldingen: Een pushserver voor meldingen op een XSP|ADP in uw omgeving. Het werkt samen tussen uw toepassingsserver en onze NPS-proxy. De proxy levert korte tokens aan uw NPS om meldingen naar de cloudservices te autoriseren. Deze services (APNS & FCM) verzenden gespreksmeldingen naar Webex-clients op Apple iOS- en Google Android-apparaten.

  • Toepassingsserver:

    • Biedt gespreksbeheer en interfaces met andere BroadWorks-systemen (doorgaans)

    • Voor flowthrough-inrichting wordt het AS gebruikt door de partnerbeheerder om gebruikers in te richten in Webex

    • Hiermee wordt het gebruikersprofiel naar BroadWorks gepusht

  • OSS/BSS: Uw Operations Support System / Business SIP-services voor het beheer van uw BroadWorks-ondernemingen.

Webex Cloud

Het blauwe blok in het diagram staat voor de Webex-cloud. Webex-microservices ondersteunen het volledige spectrum van Webex-samenwerkingsmogelijkheden:

  • Cisco Common Identity (CI) is de identiteitsservice binnen Webex.

  • Webex voor Cisco BroadWorks staat voor de set microservices die de integratie tussen Webex en de gehoste BroadWorks-serviceprovider ondersteunen:

    • API's voor gebruikersinrichting

    • Configuratie van serviceprovider

    • Gebruikersaanmelding met BroadWorks-aanmeldgegevens

  • Webex-berichtenbox voor berichtengerelateerde microservices.

  • Webex Meetings-venster voor mediaverwerkingsservers en SBC's voor videovergaderingen met meerdere deelnemers (SIP & SRTP)

Webservices van derden

De volgende onderdelen van derden zijn weergegeven in het diagram:

  • APNS (Apple Push Notifications Service) pusht oproep- en berichtmeldingen naar Webex-toepassingen op Apple-apparaten.

  • FCM (FireBase Cloud Messaging) pusht meldingen voor gesprekken en berichten naar Webex-toepassingen op Android-apparaten.

XSP|ADP-architectuuroverwegingen

De rol van openbare XSP|ADP-servers in Webex voor Cisco BroadWorks

De openbare XSP|ADP in uw omgeving biedt de volgende interfaces/services aan Webex en clients:

  • Verificatieservice (AuthService), beveiligd door TLS, die reageert op Webex-verzoeken voor BroadWorks JWT (JSON Web Token) namens de gebruiker

  • CTI-interface, beveiligd door mTLS, waarop Webex zich abonneert voor gebeurtenissen uit de gespreksgeschiedenis en aanwezigheidsstatus van telefonie vanuit BroadWorks (haakstatus).

  • Xsi-acties en -gebeurtenissen-interfaces (eXtended Services Interface) voor gespreksbeheer voor abonnees, telefoonlijsten voor contactpersonen en gesprekslijsten en configuratie van de telefoonservice voor eindgebruikers

  • DM-service (Device Management) voor clients om hun configuratiebestanden voor gesprekken op te halen

Geef URL's op voor deze interfaces wanneer u Webex voor Cisco BroadWorks configureert. (Zie Uw BroadWorks-clusters configureren in Partnerhub in dit document.) Voor elk cluster kunt u slechts één URL voor elke interface opgeven. Als u meerdere interfaces hebt in uw BroadWorks-infrastructuur, kunt u meerdere clusters maken.

XSP|ADP-architectuur

XSP|ADP-architectuur: Optie 1
XSP|ADP-architectuur: Optie 2

We vereisen dat u een afzonderlijk, toegewezen XSP|ADP-exemplaar of -farm gebruikt om uw NPS-toepassing (Notification Push Server) te hosten. U kunt dezelfde NPS gebruiken met UC-One SaaS of UC-One Collaborate. Het is echter mogelijk dat u de andere toepassingen die vereist zijn voor Webex voor Cisco BroadWorks niet host op dezelfde XSP|ADP die de NPS-toepassing host.

We raden u aan een speciaal XSP|ADP-exemplaar/farm te gebruiken om de vereiste toepassingen voor Webex-integratie te hosten om de volgende redenen:

  • Als u bijvoorbeeld UC-One SaaS aanbiedt, raden we u aan een nieuwe XSP|ADP-farm te maken voor Webex voor Cisco BroadWorks. Op deze manier kunnen de twee diensten onafhankelijk werken terwijl u abonnees migreert.

  • Als u de Webex voor Cisco BroadWorks-toepassingen op een XSP|ADP-boerderij zoekt die voor andere doeleinden wordt gebruikt, is het uw verantwoordelijkheid om het gebruik te controleren, de daaruit voortvloeiende complexiteit te beheren en de verhoogde schaal te plannen.

  • De Cisco BroadWorks-systeemcapaciteitsplanner gaat uit van een specifieke XSP|ADP-farm en is mogelijk niet juist als u deze gebruikt voor collocatieberekeningen.

Tenzij anders vermeld, moet de speciale Webex voor Cisco BroadWorks XSP|ADP's de volgende toepassingen hosten:

  • Verificatieservice (TLS met CI-tokenvalidatie of mTLS)

  • CTI (mTLS)

  • XSI-acties (TLS)

  • XSI-gebeurtenissen (TLS)

  • DMS (TLS): optioneel. Het is niet verplicht om een afzonderlijk DMS-exemplaar of -bedrijf specifiek voor Webex voor Cisco BroadWorks te implementeren. U kunt hetzelfde DMS-exemplaar gebruiken dat u gebruikt voor UC-One SaaS of UC-One Collaborate.

  • Webview Gespreksinstellingen (TLS): optioneel. Webview voor gespreksinstellingen (CSW) is alleen vereist als u wilt dat Webex voor Cisco BroadWorks-gebruikers gespreksfuncties kunnen configureren in de Webex-app.

Webex vereist toegang tot CTI via een interface die is beveiligd door wederzijdse TLS-verificatie. Om deze vereiste te ondersteunen, raden we een van de volgende opties aan:

  • (Diagram gelabeld met Optie 1) Eén XSP|ADP-exemplaar of -bedrijf voor alle toepassingen, met twee interfaces die op elke server zijn geconfigureerd: een mTLS-interface voor CTI en een TLS-interface voor andere apps zoals de AuthService.

  • (Diagram gelabeld met Optie 2) Twee XSP|ADP-instanties of -farms, een met een mTLS-interface voor CTI, en de andere met een TLS-interface voor andere apps, zoals de AuthService.


 

XSP|ADP-hergebruik

Als u een bestaande XSP|ADP-boerderij hebt die voldoet aan een van de bovenstaande voorgestelde architecturen (optie 1 of 2) en deze lichtjes wordt geladen, is het mogelijk om uw bestaande XSP|ADP's opnieuw te gebruiken. U moet controleren of er geen tegenstrijdige configuratievereisten zijn tussen bestaande toepassingen en de nieuwe toepassingsvereisten voor Webex. De twee belangrijkste overwegingen zijn:

  • Als u meerdere Webex-partnerorganisaties op de XSP|ADP moet ondersteunen, betekent dit dat u mTLS moet gebruiken op de verificatieservice (CI Token Validation wordt alleen ondersteund voor één partnerorganisatie op een XSP|ADP). Als u mTLS gebruikt op de verificatieservice, betekent dit dat u niet tegelijkertijd clients kunt hebben die basisverificatie gebruiken op de verificatieservice. Deze situatie zou hergebruik van de XSP|ADP voorkomen.

  • Als de bestaande CTI-service is geconfigureerd voor gebruik door clients met de veilige poort (doorgaans 8012) maar zonder mTLS (d.w.z. clientverificatie), is dat in strijd met de Webex-vereiste om mTLS te hebben.

Omdat de XSP|ADP’s veel toepassingen hebben en het aantal permutaties van deze toepassingen groot is, kunnen er andere niet-geïdentificeerde conflicten zijn. Om deze reden moet elk mogelijk hergebruik van XSP|ADP's worden geverifieerd in een lab met de beoogde configuratie voordat wordt toegewezen aan het hergebruik.

NTP-synchronisatie configureren op XSP|ADP

De implementatie vereist tijdsynchronisatie voor alle XSP|ADP's die u met Webex gebruikt.

Installeer de ntp pakket nadat u het besturingssysteem hebt geïnstalleerd en voordat u de BroadWorks-software installeert. Vervolgens kunt u NTP configureren tijdens de installatie van de XSP|ADP-software. Zie de BroadWorks-handleiding voor softwarebeheer voor meer informatie.

Tijdens de interactieve installatie van de XSP|ADP-software krijgt u de optie om NTP te configureren. Ga verder als volgt:

  1. Wanneer het installatieprogramma hierom vraagt, Do you want to configure NTP?, voer in y.

  2. Wanneer het installatieprogramma hierom vraagt, Is this server going to be a NTP server?, voer in n.

  3. Wanneer het installatieprogramma hierom vraagt, What is the NTP address, hostname, or FQDN?, voer het adres van uw NTP-server of een openbare NTP-service in, bijvoorbeeld, pool.ntp.org.

Als uw XSP|ADP's een stille (niet-interactieve) installatie gebruiken, moet het installatieconfiguratiebestand de volgende Key=Value-paren bevatten:

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

XSP|ADP-identiteits- en beveiligingsvereisten

Achtergrond

De protocollen en coderingen van Cisco BroadWorks TLS-verbindingen kunnen op verschillende specificiteitsniveaus worden geconfigureerd. Deze niveaus variëren van de meest algemene (SSL-provider) tot de meest specifieke (individuele interface). Een meer specifieke instelling overschrijft altijd een meer algemene instelling. Als deze niet zijn opgegeven, worden SSL-instellingen op een lager niveau overgenomen van hogere niveaus.

Als er geen instellingen worden gewijzigd ten opzichte van de standaardinstellingen, worden de standaardinstellingen van de SSL-provider door alle niveaus overgenomen (JSSE Java Secure Sockets Extension).

Lijst met vereisten

  • De XSP|ADP moet zichzelf verifiëren bij clients met een door een certificeringsinstantie ondertekend certificaat waarin de algemene naam of alternatieve naam voor het onderwerp overeenkomt met het domeingedeelte van de XSI-interface.

  • De Xsi-interface moet het TLSv1.2-protocol ondersteunen.

  • De Xsi-interface moet een cijfersuite gebruiken die aan de volgende vereisten voldoet.

    • Diffie-Hellman Ephemeral (DHE) of Elliptic Curves Diffie-Hellman Ephemeral (ECDHE) sleuteluitwisseling

    • AES-code (Advanced Encryption Standard) met een minimale blokgrootte van 128 bits (bijv. AES-128 of AES-256)

    • GCM (Galois/Counter Mode) of CBC (Cipher Block Chaining) cipher mode

      • Indien een CBC-code gebruikt wordt, is enkel de SHA2-familie van hash-functies toegelaten voor sleutelafleiding (SHA256, SHA384, SHA512).

De volgende cijfers voldoen bijvoorbeeld aan de vereisten:

  • 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


 

De XSP|ADP CLI vereist de IANA-naamgevingsconventie voor versleutelingssuites, zoals hierboven weergegeven, niet de openSSL-conventie.

Ondersteunde TLS-cijfers voor de AuthService- en XSI-interfaces


 

Deze lijst kan worden gewijzigd naarmate onze cloudbeveiligingsvereisten evolueren. Volg de huidige aanbeveling voor Cisco-cloudbeveiliging voor cijferselectie, zoals beschreven in de lijst met vereisten in dit document.

  • 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

Parameters voor Xsi-gebeurtenisschaal

Mogelijk moet u de grootte van de Xsi-Events-wachtrij en het aantal thread verhogen om het volume aan gebeurtenissen af te handelen dat de Webex voor Cisco BroadWorks-oplossing vereist. U kunt de parameters als volgt verhogen tot de weergegeven minimumwaarden (verlaag ze niet als ze boven deze minimumwaarden liggen):

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

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

Meerdere XSP|ADP's

Randelement lastverdeling

Als u een load balancing-element op uw netwerkrand hebt, moet dit transparant omgaan met de verdeling van verkeer tussen uw meerdere XSP|ADP-servers en de Webex voor Cisco BroadWorks-cloud en -clients. In dit geval geeft u de URL van de load balancer op aan de Webex voor Cisco BroadWorks-configuratie.

Opmerkingen over deze architectuur:

  • Configureer DNS zodat de clients de load balancer kunnen vinden wanneer ze verbinding maken met de Xsi-interface (zie DNS-configuratie).

  • We raden u aan het randelement te configureren in de reverse SSL-proxymodus om punt-naar-punt-gegevenscodering te garanderen.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam. U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

Internetgerichte XSP|ADP-servers

Als u de Xsi-interfaces rechtstreeks blootstelt, gebruikt u DNS om het verkeer te distribueren naar de meerdere XSP|ADP-servers.

Opmerkingen over deze architectuur:

  • Er zijn twee records vereist om verbinding te maken met de XSP|ADP-servers:

    • Voor Webex-microservices: Round-robin A/AAAA-records zijn vereist om de meerdere XSP|ADP IP-adressen te bereiken. De reden hiervoor is dat de Webex-microservices geen SRV-zoekopdrachten kunnen uitvoeren. Zie Webex-cloudservices voor voorbeelden.

    • Voor de Webex-app: Een SRV-record dat wordt omgezet in A-records waarbij elk A-record wordt omgezet in één XSP|ADP. Zie de Webex-app voor voorbeelden.

      Gebruik geprioriteerde SRV-records om de XSI-service te richten op de meerdere XSP|ADP-adressen. Geef prioriteit aan uw SRV-records zodat de microservices altijd naar dezelfde A-record gaan (en het volgende IP-adres) en alleen naar de volgende A-record (en IP-adres) gaan als het eerste IP-adres niet beschikbaar is. GEBRUIK GEEN round-robin-benadering voor de Webex-app.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam.

  • U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

HTTP-omleidingen vermijden

Soms is DNS geconfigureerd om de XSP|ADP-URL op te lossen naar een HTTP-laadbalancer en is de laadbalancer geconfigureerd voor omleiding via een reverse proxy naar de XSP|ADP-servers.

Webex volgt geen omleiding wanneer u verbinding maakt met de URL's die u levert, dus deze configuratie werkt niet.

Bestellen en inrichten

Bestellen en inrichten is van toepassing op deze niveaus:

  • Inrichting van partner/serviceprovider:

    Elke geïntegreerde Webex voor Cisco BroadWorks-serviceprovider (of reseller) moet worden geconfigureerd als een partnerorganisatie in Webex en de nodige rechten krijgen. Cisco Operations biedt de beheerder van de partnerorganisatie toegang tot het beheren van Webex voor Cisco BroadWorks op Webex Partner Hub. De partnerbeheerder moet alle vereiste inrichtingsstappen uitvoeren voordat hij/zij een klant/bedrijfsorganisatie kan inrichten.

  • Bestellen en inrichten klant/onderneming:

    Elke BroadWorks Enterprise die is ingeschakeld voor Webex voor Cisco BroadWorks, activeert het maken van een gekoppelde Webex-klantorganisatie. Dit proces vindt automatisch plaats als onderdeel van de inrichting van de gebruiker/abonnee. Alle gebruikers/abonnees binnen een BroadWorks-onderneming zijn ingericht in dezelfde Webex-klantorganisatie.

    Hetzelfde gedrag is van toepassing als uw BroadWorks-systeem is geconfigureerd als serviceprovider met groepen. Wanneer u een abonnee inricht in een BroadWorks-groep, wordt er automatisch een klantorganisatie gemaakt in Webex die overeenkomt met de groep.

  • Bestellen en inrichten van gebruikers/abonnees:

    Webex voor Cisco BroadWorks ondersteunt momenteel de volgende modellen voor gebruikersinrichting:

    • Flowthrough-inrichting met vertrouwde e-mails

    • Flowthrough-inrichting zonder vertrouwde e-mails

    • Zelfinrichting gebruiker

    • API-inrichting

Flowthrough-inrichting met vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u kunt bevestigen dat BroadWorks e-mailadressen van abonnees heeft die geldig en uniek zijn voor Webex, maakt en activeert deze inrichtingsoptie automatisch Webex-accounts met deze e-mailadressen als gebruikers-id's.

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Flowthrough-inrichting met vertrouwde e-mails

Flowthrough-inrichting zonder vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u niet kunt vertrouwen op de e-mailadressen van abonnees die in handen zijn van BroadWorks, maakt deze inrichtingsoptie Webex-accounts, maar kan deze niet worden geactiveerd totdat abonnees hun e-mailadressen leveren en valideren. Op dat moment kan Webex de accounts met deze e-mailadressen activeren als gebruikers-id's.

Flowthrough-inrichting zonder vertrouwde e-mails

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Zelfinrichting gebruiker

Met deze optie is er geen flowthrough-inrichting van BroadWorks naar Webex. Nadat u de integratie tussen Webex en uw BroadWorks-systeem hebt geconfigureerd, krijgt u een of meer koppelingen die specifiek zijn voor het inrichten van gebruikers binnen uw Webex voor Cisco BroadWorks-partnerorganisatie.

Vervolgens ontwerpt u uw eigen communicatie (of delegeert u aan uw klanten) om de link naar abonnees te verspreiden. De abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun eigen Webex-accounts te maken en te activeren.

Zelfinrichting gebruiker

Omdat de accounts zijn ingericht binnen het bereik van uw partnerorganisatie, kunt u gebruikerspakketten handmatig aanpassen via Partner Hub of de API gebruiken om dit te doen.


 

Gebruikers moeten bestaan in het BroadWorks-systeem dat u met Webex integreert, of ze mogen geen accounts maken met die koppeling.

Serviceproviderinrichting door API's

Webex toont een reeks openbare API's waarmee u Webex voor Cisco BroadWorks gebruikers-/abonneevoorzieningen kunt maken in uw bestaande gebruikersbeheerworkflow/-tools.

Serviceproviderinrichting door API's - Vertrouwde e-mails
Serviceproviderinrichting door API's - Niet-vertrouwde e-mails

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Toestelnummer bellen

Met ondersteuning voor de functie voor toestelbellen kunnen Webex-gebruikers van Cisco Broadworks andere gebruikers bellen met een toestel dat vergelijkbaar is met het primaire telefoonnummer binnen dezelfde onderneming. Dit is vooral handig voor gebruikers die geen DID-nummers hebben.

Tijdens het inrichten wordt het toestelnummer van de gebruikers opgeslagen in de Webex-directory als het toestelnummer van de gebruiker. Voor BroadWorks-gesprekken wordt het toestelnummer weergegeven in de Webex-app in het toestelveld van alle gebieden met de gespreksinitiatiemethode en het profiel van de gebruiker. Webex voor Cisco BroadWorks ondersteunt alleen-toestelgesprekken tussen gebruikers binnen dezelfde groep en verschillende groepen van dezelfde onderneming met de combinatie van kiescode voor locatie en toestel. Bellen tussen twee bedrijven die alleen extensies gebruiken, wordt echter niet ondersteund.

Er kan een toestel worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'toestel'

      • De toestelparameter moet expliciet worden doorgegeven als onderdeel van de API-oproep. Voor bedrijven/groepen waarvoor LDC (Location Dialing Code) is geconfigureerd, moet de toestelparameter de combinatie LDC en 'toestelnummer' zijn.

    • Flowthrough- of zelfactiveringsinrichting

      • Toestel en LDC (indien van toepassing) worden automatisch opgehaald uit BroadWorks.

  • Gespreksgebruikers of -entiteiten met alleen BroadWorks

    • Automatisch gesynchroniseerd vanuit BroadWorks via adreslijstsynchronisatie met de combinatie van LDC (Location Dialing Code) en toestelnummer.

Tabel 2. Toestelnummers beheren op basis van de inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Toestelnummer beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

Toestelnummer moet worden doorgegeven als parameter

Doorstroomd

Toestel automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

BroadWorks-telefoonlijsten

Lijsten met bedrijven, groepen of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing

Voorwaarden

  1. De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.

  2. Patch waarbij kiescodes voor toestelnummers en locaties worden toegevoegd aan XSI en inrichtingsadapter februari 2022 voor versie 23 of hoger als onderdeel van:

    • 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. Schakel de koptekst X-BroadWorks-Remote-Party-Info in op het AS met de onderstaande CLI-opdracht voor deze SIP-gespreksstroom die vereist is voor ondersteuning van de functie voor toestelbellen.

    AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Prioriteit oproepopties in de app

Als onderdeel van de ondersteuning voor de functie Toestelbellen wordt De prioriteitsinstelling voor gespreksopties van de app ook op partnerniveau aangeboden voor alle Webex voor Cisco Broadworks-partners. Met deze instelling kan de partner de gespreksprioriteitsinstellingen van al zijn beheerde klanten beheren vanuit Partner Hub. De prioriteitsinstelling voor app-gespreksopties voor een klant kan ook op klantniveau worden gewijzigd vanuit Control Hub.

De prioriteitsinstelling voor app-gespreksopties bevat toestel als tweede optie in zowel Partner Hub als Control Hub wanneer een Webex voor Cisco Broadworks-gebruiker nieuw is ingericht met toestel via een van de bovengenoemde inrichtingsmethoden.

Voor alle bestaande ingerichte organisaties heeft de uitbreidingsoptie de verborgen status (standaard) in de prioriteitsinstelling voor app-gespreksopties. Er wordt geen toestel weergegeven in de optie voor audio-/videogesprekken van de gebruiker in de Webex-app.

Hieronder ziet u de opties om de optie Toestelgesprek zichtbaar te maken voor de bestaande klanten:

  1. Als een partner wil dat al zijn beheerde klantorganisaties een toestel krijgen als een van de gespreksopties, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Partnerhub. Hierdoor kunnen de beheerde klantorganisaties de instelling van hun partner overnemen.

  2. Als een partner een toestel wil aanbieden in gespreksopties voor een specifieke klantorganisatie, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Control Hub.

Ondersteuning voor groepscontactpersonen

Met deze functie wordt de Webex for BroadWorks DirSync-service verbeterd door de beperking voor het synchroniseren van maximaal 1500 contactpersonen uit de telefoonlijsten van de groep in BroadWorks te verwijderen en partners in staat te stellen maximaal 30K contactpersonen uit een enkele telefoonlijst van de groep te synchroniseren en deze gelijk te maken met de verhoging van 30K contactpersonen voor de Enterprise telefoonlijst, die afzonderlijk is vrijgegeven.

Er is een totale limiet van 200K voor alle externe contactpersonen per organisatie, die van toepassing is op de som van Enterprise- en Group-telefoonlijsten in één BroadWorks-onderneming. Een BroadWorks-onderneming met een bedrijfstelefoonlijst met 30K en ook 5 groepstelefoonlijsten met elk 30K worden ondersteund (180K totaal per organisatie). Als er echter 6 groepstelefoonlijsten zijn met elk 30K, wordt dit niet ondersteund (210K totaal).


 

Deze functie is beschikbaar op aanvraag. Neem contact op met uw accountteam om dit in te schakelen.

  • Voordat u de functie inschakelt, moet een vereiste migratie worden uitgevoerd om groepen in te richten en te koppelen voor alle bestaande ingerichte gebruikers.

  • Het Cisco-team voert een interne API uit om bestaande ingerichte gebruikers te migreren om ze aan de juiste groep te koppelen. OPMERKING: Dit kan tot een week duren om te verwerken.

  • Zodra de migratie is voltooid voor de partner en de functie is ingeschakeld, worden alle nieuw ingerichte gebruikers op de juiste manier 'gegroepeerd'.

Nadat de functie is ingeschakeld, begint de DirSync-service met het synchroniseren van contactpersonen uit de telefoonlijst van de BroadWorks-groep in de speciale opslag voor groepscontactpersonen in de Webex-contactservice.

Tijdens het inrichten moet de bedrijfsgroep van de gebruiker worden opgeslagen in de Webex-directory om aan te geven tot welke groep deze gebruiker behoort. Met de koppeling van de gebruiker aan een BroadWorks-groep in de Webex-directory kan de Webex-app contact zoeken in de opslag voor de contactservicegroep voor de specifieke groep van de gebruiker.

Voor deze functie moeten de Webex for BroadWorks-abonnees in Webex worden ingericht met de BroadWorks-bedrijfs-groeps-id.

De BroadWorks Enterprise Group Id kan worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Webex voor Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'spEnterpriseGroupId'

      • De BroadWorks Enterprise Group Id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek.

    • Flowthrough- of zelfactiveringsinrichting

      • BroadWorks-bedrijfs-groeps-id wordt automatisch opgehaald uit BroadWorks.

    • Gespreksgebruikers of -entiteiten met alleen BroadWorks

      • Niet van toepassing. Het is niet vereist om de BroadWorks Enterprise Group-id voor deze gebruikers te synchroniseren.

Tabel 3. Beheer van Enterprise Group ID op basis van inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Bedrijfs-groeps-id beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

BroadWorks-bedrijfs groep-id moet worden doorgegeven als parameter spEnterpriseGroupId

Doorstroomd

BroadWorks-bedrijfs groep-id wordt automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Niet van toepassing

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Niet van toepassing

BroadWorks-telefoonlijsten

Contactpersonen in de telefoonlijsten van de BroadWorks-groep

Synchroniseren met Directory

Groepscontacten worden opgeslagen in de Webex-contactservice die is gekoppeld aan de specifieke groep

Lijsten met BroadWorks-enterpsie of persional-telefoons

Contactpersonen in de lijsten met zakelijke of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing


 

Openbare API moet worden bijgewerkt VÓÓR de MIGRATIE. Migratie kan niet worden voltooid totdat DEZE API is voltooid. De BroadWorks Enterprise Group-id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek https://developer.webex.com/docs/api/changelog#2023-march

Nadat de functie is ingeschakeld en als gevolg van de volgende adreslijstsynchronisatie worden de bedrijfsgebruikersgroepen ook weergegeven in Control Hub. Het visualiseren van de groepen in Control Hub voor Webex voor BroadWorks is in dit stadium puur informatief. Partner- en klantbeheerders mogen geen wijzigingen aanbrengen aan groepen of groepslidmaatschap in Control Hub, omdat deze wijzigingen niet worden teruggekoppeld naar BroadWorks. Groepsbeheer in Control Hub is bedoeld voor gebruik door partners die de komende API's voor contactbeheer gaan gebruiken.

Migratie en toekomstbestendigheid

De progressie van Cisco van de BroadSoft Unified Communications Client is om van UC-One naar Webex te gaan. Er is een overeenkomstige progressie van de ondersteunende services weg van het netwerk van serviceproviders – behalve bellen – naar het Webex-cloudplatform.

Of u nu UC-One SaaS of BroadWorks Collaborate gebruikt, de voorkeursmigratiestrategie is het implementeren van nieuwe, speciale XSP|ADP's voor integratie met Webex voor Cisco BroadWorks. U kunt de twee services parallel uitvoeren terwijl u klanten migreert naar Webex en uiteindelijk de infrastructuur terugverdienen die is gebruikt voor de vorige oplossing.

Aanbevolen documentabonnementen

Webex Help Center-artikelen (op help.webex.com) hebben een optie Abonneren waarmee u een e-mailmelding kunt ontvangen wanneer dat artikel wordt bijgewerkt.

We raden u aan u te abonneren op elk van de volgende artikelen om ervoor te zorgen dat u geen kritieke updates mist die van invloed zijn op de netwerkverbinding. Om u in te schrijven, gaat u naar elk van de onderstaande links en klikt u in het artikel dat wordt gelanceerd op de knop Subscribe.

We raden u aan om u minimaal in te schrijven voor bovenstaande lijst. De meeste Webex-artikelen en -documenten die worden vermeld onder Aanvullende documenten hebben echter een optie Abonneren. Als deze optie moet worden weergegeven, moet het artikel worden weergegeven op help.webex.com.


 
Er is geen abonnementsoptie voor landingspagina's van documentatie.

Aanvullende documenten

Raadpleeg de volgende gerelateerde documentatie voor meer informatie over Webex voor Cisco BroadWorks:

Webex voor Cisco BroadWorks-documenten

Partnerbeheerders kunnen de volgende documenten en sites gebruiken om informatie te verkrijgen over Webex voor Cisco BroadWorks.

Webex voor Cisco BroadWorks-artikelen

Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:

Cisco BroadWorks-documenten

Partnerbeheerders kunnen verwijzen naar de Cisco BroadWorks-site op cisco.com voor technische documenten die beschrijven hoe het Cisco BroadWorks-gedeelte van de oplossing moet worden geïmplementeerd:

Webex Help-artikelen

De volgende Webex Help-sites kunnen worden gebruikt om Webex-artikelen te vinden waarmee klantbeheerders en eindgebruikers Webex-functies kunnen gebruiken.

  • Webex van serviceproviders: deze landingspagina bevat koppelingen met informatie over aan de slag gaan en veelgebruikte artikelen voor gebruikers van de Webex-app die Webex-services hebben gekocht bij een serviceprovider.

  • Webex-helpcentrum: gebruik de zoekfunctie op help.webex.com om te zoeken naar aanvullende Webex-artikelen waarin de Webex-app en de Webex Meetings-functionaliteit worden beschreven. U kunt zoeken naar gebruikers- of beheerdersartikelen.

Documentatie voor ontwikkelaars

Uw omgeving voorbereiden

Beslissingspunten

Overweging Vragen om te beantwoorden Resources

Architectuur en infrastructuur

Hoeveel XSP|ADP’s?

Hoe nemen ze mTLS in?

Cisco BroadWorks-systeemcapaciteitsplanner

Technische handleiding voor Cisco BroadWorks-systemen

XSP|ADP CLI-referentie

Dit document

Klant- en gebruikersvoorzieningen

Kunt u bevestigen dat u e-mails vertrouwt in BroadWorks?

Wilt u dat gebruikers e-mailadressen opgeven om hun eigen accounts te activeren?

Kunt u tools maken om onze API te gebruiken?

Openbare API-documenten op https://developer.webex.com

Dit document

Branding Welke kleur en logo wilt u gebruiken? Brandingartikel van de Webex-app
Sjablonen Wat zijn uw verschillende gebruiksscenario's voor klanten? Dit document
Abonneefuncties per klant/onderneming/groep Kies een pakket om het serviceniveau per sjabloon te definiëren. Basic, Standard, Premium of Softphone.

Dit document

Functie-/pakketmatrix

Gebruikersverificatie BroadWorks of Webex Dit document
Inrichtingsadapter (voor flowthrough-inrichtingsopties)

Gebruikt u al geïntegreerde IM&P, bijv. voor UC-One SaaS?

Bent u van plan meerdere sjablonen te gebruiken?

Is er een meer voorkomende usecase voorzien?

Dit document

CLI-referentie toepassingsserver

Architectuur en infrastructuur

  • Met welke schaal gaat u beginnen? Het is mogelijk om in de toekomst op te schalen, maar uw huidige gebruiksinschatting zou de infrastructuurplanning moeten stimuleren.

  • Werk samen met uw Cisco-accountmanager/verkoopvertegenwoordiger om uw XSP|ADP-infrastructuur te vergroten, volgens de Cisco BroadWorks System Capacity Planner en de Cisco BroadWorks System Engineering Guide.

  • Hoe maakt Webex wederzijdse TLS-verbindingen met uw XSP|ADP's? Rechtstreeks naar de XSP|ADP in een DMZ, of via TLS-proxy? Dit is van invloed op uw certificaatbeheer en de URL's die u gebruikt voor de interfaces. (We ondersteunen geen ongecodeerde TCP-verbindingen met de rand van uw netwerk).

Klant- en gebruikersvoorzieningen

Welke gebruikersinrichtingsmethode past het beste bij u?

  • Flowthrough Provisioning Met Vertrouwde E-mails: Door de service 'Geïntegreerde IM&P' toe te wijzen op BroadWorks, wordt de abonnee automatisch ingericht in Webex.

    Als u ook kunt bevestigen dat de e-mailadressen van abonnees in BroadWorks geldig en uniek zijn voor Webex, kunt u de variant 'vertrouwde e-mail' van flowthrough-inrichting gebruiken. Webex-abonneeaccounts worden zonder hun tussenkomst gemaakt en geactiveerd. Ze downloaden gewoon de client en melden zich aan.

    E-mailadres is een belangrijk gebruikerskenmerk in Webex. Daarom moet de serviceprovider een geldig e-mailadres voor de gebruiker opgeven om deze in te richten voor Webex-services. Dit moet het e-mail-id-kenmerk van de gebruiker zijn in BroadWorks. We raden u aan deze ook te kopiëren naar het kenmerk Alternatieve id.

  • Flowthrough-inrichting zonder vertrouwde e-mails: Als u de e-mailadressen van abonnees niet kunt vertrouwen, kunt u nog steeds de geïntegreerde IM&P-service in BroadWorks toewijzen om gebruikers in Webex in te richten.

    Met deze optie worden de accounts gemaakt wanneer u de service toewijst, maar moeten de abonnees hun e-mailadressen opgeven en valideren om de Webex-accounts te activeren.

  • Zelfinrichting gebruiker: Voor deze optie is geen IM&P-servicetoewijzing in BroadWorks vereist. U (of uw klanten) distribueert in plaats daarvan een inrichtingskoppeling en de koppelingen om de verschillende clients te downloaden, met uw branding en instructies.

    Abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun Webex-accounts te maken en te activeren. Vervolgens downloaden ze de client en melden zich aan en haalt Webex een aantal extra configuraties over hen op vanuit BroadWorks (inclusief hun primaire nummers).

  • SP-beheerde inrichting via API's: Webex stelt een reeks openbare API's bloot waarmee serviceproviders gebruikersvoorzieningen/abonneevoorzieningen kunnen bouwen in hun bestaande workflows.

Inrichtingsvereisten

In de volgende tabel worden de vereisten voor elke inrichtingsmethode samengevat. Naast deze vereisten moet uw implementatie voldoen aan de algemene systeemvereisten die in deze handleiding worden beschreven.

Inrichtingsmethode

Vereisten

Doorstroominrichting

(Vertrouwde of niet-vertrouwde e-mails)

De Webex-provisioning-API voegt bestaande BroadWorks-gebruikers automatisch toe aan Webex zodra de gebruiker aan de vereisten voldoet en u de geïntegreerde IM+P-service inschakelt.

Er zijn twee stromen (vertrouwde e-mails of niet-vertrouwde e-mails) die u toewijst via de onboardsjabloon op Webex.

Vereisten voor BroadWorks:

  • Gebruiker bestaat in BroadWorks met een primair nummer of toestel.

  • De gebruiker krijgt de geïntegreerde IM+P-service toegewezen, die verwijst naar de URL van de Webex-inrichtingsservice.

  • Alleen vertrouwde e-mails. De gebruiker heeft een e-mailadres geconfigureerd in BroadWorks. We raden u aan om het e-mailadres ook toe te voegen aan het veld Alternatieve id, omdat de gebruiker zich op die manier kan aanmelden met BroadWorks-referenties.

  • BroadWorks heeft verplichte patches geïnstalleerd voor flowthrough-inrichting. Zie Vereiste patches met flowthrough-inrichting (hieronder) voor de patchvereisten.

  • BroadWorks AS is rechtstreeks verbonden met de Webex-cloud of de proxy van de inrichtingsadapter is geconfigureerd met verbinding met de URL van de Webex-inrichtingsservice.

    Zie Toepassingsserver configureren met inrichtingsservice-URL om de URL van de Webex-inrichtingsservice op te halen.

    Zie Cisco BroadWorks Implement Provisioning Adapter Proxy FD om de Provisioning Adapter Proxy te configureren.

Webex-vereisten:

Het onboardsjabloon bevat de volgende instellingen:

  • De schakelaar BroadWorks-flow via inrichting inschakelen is ingeschakeld.

  • De naam en het wachtwoord van het inrichtingsaccount worden toegewezen met de beheerdersreferenties op systeemniveau van BroadWorks

  • Gebruikersverificatie is ingesteld op Trust BroadWorks-e-mails of Niet-vertrouwde e-mails.

Zelfinrichting gebruiker

Beheerder biedt een bestaande BroadWorks-gebruiker een koppeling naar de portal voor gebruikersactivering. De gebruiker moet zich met de BroadWorks-referenties aanmelden bij de portal en een geldig e-mailadres opgeven. Nadat het e-mailadres is gevalideerd, haalt Webex aanvullende gebruikersinformatie op om de inrichting te voltooien.

Vereisten voor BroadWorks:

  • Gebruiker moet bestaan in BroadWorks met een primair nummer of toestel

Webex-vereisten:

Het onboardsjabloon bevat de volgende instellingen:

  • De schakelaar Flow Through Provisioning inschakelen is uitgeschakeld.

  • Gebruikersverificatie is ingesteld op Niet-vertrouwde e-mails.

  • Gebruikers toestaan zichzelf te activeren is ingeschakeld.

SP-beheerde inrichting via API

(Vertrouwde of niet-vertrouwde e-mails)

Webex toont een reeks openbare API's waarmee u gebruikersvoorzieningen kunt bouwen in uw bestaande werkstromen en tools. Er zijn twee stromen:

  • Vertrouwde e-mails: de API voorziet de gebruiker en past het BroadWorks-e-mailadres toe als het Webex-e-mailadres.

  • Niet-vertrouwde e-mails: de API voorziet in de gebruiker, maar de gebruiker moet zich aanmelden bij de User Activation Portal en een geldig e-mailadres opgeven.

Vereisten voor BroadWorks:

  • Gebruiker moet bestaan in BroadWorks met een primair nummer of toestel.

Webex-vereisten:

  • In de onboardsjabloon is de gebruikersverificatie ingesteld op Trust BroadWorks e-mails of Niet-vertrouwde e-mails.

  • U moet uw aanvraag registreren en hiervoor toestemming vragen.

  • U moet een OAuth-token aanvragen met de scopes die zijn gemarkeerd in het gedeelte 'Verificatie' van de Webex for BroadWorks-ontwikkelaarshandleiding.

  • Er moet een beheerder of inrichtingsbeheerder worden toegewezen aan uw partnerorganisatie.

Ga naar BroadWorks-abonnees om de API's te gebruiken.

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Ondersteunde taallandinstellingen

Tijdens het inrichten wordt de taal die in beheergebruiker is toegewezen aan de eerste ingerichte beheergebruiker automatisch toegewezen als de standaardlandinstelling voor die klantorganisatie. Deze instelling bepaalt de standaardtaal die wordt gebruikt voor activeringsmails, vergaderingen en uitnodigingen voor vergaderingen onder die klantorganisatie.

Taallandinstellingen met vijf tekens in (ISO-639-1)_(ISO-3166)-indeling worden ondersteund. en_VS komt bijvoorbeeld overeen met English_UnitedStates. Als er slechts een taal met twee letters wordt aangevraagd (in ISO-639-1-indeling), genereert de service een landinstelling met vijf tekens door de aangevraagde taal te combineren met een landcode uit de sjabloon, d.w.z. "requestedLanguage_CountryCode", als er geen geldige landinstelling kan worden verkregen, wordt de standaard verstandige landinstelling gebruikt op basis van de vereiste taalcode.

De volgende tabel bevat de ondersteunde landinstellingen en de toewijzing waarmee een taalcode van twee letters wordt omgezet in een landinstelling met vijf tekens voor situaties waarin een landinstelling met vijf tekens niet beschikbaar is.

Tabel 1. Ondersteunde taallandcodes

Ondersteunde taallandinstellingen

(ISO-639-1)_(ISO-3166)

Als er alleen een taalcode met twee letters beschikbaar is...

Taalcode (ISO-639-1) **

Gebruik in plaats daarvan Standaard verstandige landinstelling (ISO-639-1)_(ISO-3166)

en_VS

en_AU

en_GB

en_CA

en

en_VS

fr_vr

fr_CA

vr

fr_vr

cs_CZ, CZ

cs

cs_CZ, CZ

da_DK

da's, da's

da_DK

de_de

de

de_de

hu_HU

(aan)laars

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_NEE

nb

nb_NEE

pl_VERV.

verv.

pl_VERV.

pt_PT

pt_BR

pt

pt_PT

ru_ru

ru

ru_ru

ro_RO

ro

ro_RO

zh_CN

zh_TW

zweer

zh_CN

sv_SE

sv

sv_SE

ar_SA

ar, teken, teken

ar_SA

tr_TR

staartstuk

tr_TR


 

De landinstellingen es_CO, id_ID, nb_NO en pt_PT worden niet ondersteund door Webex Meeting-sites. Voor deze landinstellingen zijn De Webex Meetings-sites alleen in het Engels. Engels is de standaardlandinstelling voor sites als er geen/ongeldige/niet-ondersteunde landinstelling vereist is voor de site. Dit taalveld is van toepassing bij het maken van een organisatie- en Webex Meetings-site. Als er geen taal wordt vermeld in een bericht of in de API van de abonnee, wordt de taal van de sjabloon gebruikt als standaardtaal.

Branding

Partnerbeheerders kunnen geavanceerde merkaanpassingen gebruiken om aan te passen hoe de Webex app eruitziet voor de klantorganisaties die de partner beheert. Partnerbeheerders kunnen de volgende instellingen aanpassen om ervoor te zorgen dat de Webex -app het merk en de identiteit van hun bedrijf weerspiegelt:

  • Bedrijfslogo's

  • Unieke kleurenschema's voor de lichte modus of de donkere modus

  • Aangepaste ondersteunings-URL's

Meer informatie over het aanpassen van branding vindt u in Geavanceerde branding-aanpassingen configureren.


 
  • Aanpassingen voor basisbranding worden afgeschaft. We raden u aan Advanced Branding te implementeren, dat een breder scala aan aanpassingen biedt.

  • Voor meer informatie over hoe branding wordt toegepast bij het koppelen aan een bestaande klantorganisatie, raadpleegt u Voorwaarden van organisatiebijlage in het gedeelte Webex voor BroadWorks toevoegen aan bestaande organisatie.

Onboardingssjablonen

Met onboardsjablonen kunt u de parameters definiëren waarmee klanten en gekoppelde abonnees automatisch worden ingericht in Webex voor Cisco BroadWorks. U kunt indien nodig meerdere onboardsjablonen configureren, maar wanneer u een klant onboardt, is deze aan slechts één sjabloon gekoppeld (u kunt niet meerdere sjablonen op één klant toepassen).

Enkele van de primaire sjabloonparameters worden hieronder weergegeven.

Pakket

  • U moet een standaardpakket selecteren wanneer u een sjabloon aanmaakt (zie Pakketten in het gedeelte Overzicht voor meer informatie). Alle gebruikers die zijn ingericht met die sjabloon, hetzij door middel van flowthrough- of self-provisioning, ontvangen het standaardpakket.

  • U hebt controle over de pakketselectie voor verschillende klanten door meerdere sjablonen te maken en telkens verschillende standaardpakketten te selecteren. U kunt vervolgens verschillende inrichtingskoppelingen of verschillende inrichtingsadapters per onderneming distribueren, afhankelijk van de door u gekozen gebruikersinrichtingsmethode voor deze sjablonen.

  • U kunt het pakket met specifieke abonnees wijzigen vanaf deze standaard met behulp van de inrichtings-API (zie Webex voor Cisco BroadWorks API-documentatie of via Partner Hub (zie Gebruikerspakket wijzigen in Partner Hub).

  • U kunt het pakket van een abonnee niet wijzigen vanuit BroadWorks. De toewijzing van de geïntegreerde IM&P-service is in- of uitgeschakeld. Als de abonnee deze service in BroadWorks wordt toegewezen, definieert de Partner Hub-sjabloon die is gekoppeld aan de inrichtings-URL van de onderneming van die abonnee het pakket.

Doorverkoper en ondernemingen of serviceprovider en groepen?

  • De manier waarop uw BroadWorks-systeem is geconfigureerd, heeft invloed op de flow via inrichting. Als u een reseller bent met Enterprises, moet u de Enterprise-modus inschakelen wanneer u een sjabloon maakt.

  • Als uw BroadWorks-systeem is geconfigureerd in de serviceprovidermodus, kunt u de Enterprise-modus uitschakelen in uw sjablonen.

  • Als u van plan bent klantorganisaties in te richten met beide BroadWorks-modi, moet u verschillende sjablonen gebruiken voor groepen en bedrijven.


 
Zorg ervoor dat u de BroadWorks-patches hebt toegepast die vereist zijn voor doorstroominrichting. Zie Vereiste patches met doorstroominrichting voor meer informatie.

Verificatiemodus

Bepaal hoe u wilt dat abonnees zich verifiëren wanneer ze zich aanmelden bij Webex. U kunt de modus toewijzen met de instelling Verificatiemodus in de onboardingsjabloon. In de volgende tabel worden enkele opties beschreven.


 
Deze instelling heeft geen invloed op het aanmelden bij de User Activation Portal. Gebruikers die zich aanmelden bij de portal, moeten hun BroadWorks-gebruikers-id en -wachtwoord invoeren, zoals geconfigureerd in BroadWorks, ongeacht hoe u de verificatiemodus configureert in de onboardsjabloon.
VerificatiemodusBroadWorksWebex
Primaire gebruikersidentiteitBroadWorks-gebruikers-idE-mailadres
Identiteitsprovider

BroadWorks.

  • Als u een directe verbinding met BroadWorks configureert, wordt de Webex-app rechtstreeks geverifieerd bij de BroadWorks-server.

    Als u een directe verbinding wilt configureren, moet het selectievakje Directe BroadWorks-verificatie inschakelen zijn ingeschakeld in de BroadWorks-clusterconfiguratie op Partner Hub (de instelling is standaard uitgeschakeld).

  • Anders wordt verificatie naar BroadWorks mogelijk gemaakt via een intermediaire service die door Webex wordt gehost.

Cisco Common Identity
Meervoudige verificatie?NeeVereist Customer IdP die meervoudige verificatie ondersteunt.

Validatiepad gebruikergegevens

  1. Browser wordt gestart waarbij de gebruiker e-mail levert om de eerste aanmeldstroom te starten en de verificatiemodus te detecteren.

  2. De browser wordt vervolgens omgeleid naar een door Webex gehoste BroadWorks-aanmeldpagina (deze pagina is brandable)

  3. Gebruiker levert BroadWorks gebruikers-id en wachtwoord op de aanmeldpagina.

  4. Gebruikersreferenties worden gevalideerd met BroadWorks.

  5. Bij succes wordt een autorisatiecode verkregen van Webex. Dit wordt gebruikt om de benodigde toegangstokens voor Webex-services te verkrijgen.

  1. Browser wordt gestart waarbij de gebruiker e-mail levert om de eerste aanmeldstroom te starten en de verificatiemodus te detecteren.

  2. De browser wordt omgeleid naar IdP (Cisco Common Identity of Customer IdP), waar ze een aanmeldportal krijgen.

  3. Gebruiker levert de juiste aanmeldgegevens op de aanmeldpagina

  4. Verificatie met meerdere factoren kan plaatsvinden als de Customer IdP dit ondersteunt.

  5. Bij succes wordt een autorisatiecode verkregen van Webex. Dit wordt gebruikt om de benodigde toegangstokens voor Webex-services te verkrijgen.


 
Zie SSO-aanmeldstroom voor een gedetailleerder overzicht van de SSO-aanmeldstroom met directe verificatie naar BroadWorks.

UTF-8-codering met BroadWorks-verificatie

Met BroadWorks-verificatie raden we u aan UTF-8-codering voor de verificatiekoptekst te configureren. UTF-8 lost een probleem op dat zich kan voordoen met wachtwoorden die speciale tekens gebruiken waarbij de webbrowser de tekens niet goed codeert. Met behulp van een UTF-8-gecodeerde, basis 64-gecodeerde header lost dit probleem op.

U kunt UTF-8-codering configureren door een van de volgende CLI-opdrachten uit te voeren op de XSP of ADP:

  • XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

  • ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

Land

U moet een land selecteren wanneer u een sjabloon maakt. Dit land wordt automatisch toegewezen als het organisatieland voor alle klanten die zijn ingericht met de sjabloon in Common Identity. Daarnaast bepaalt het land van de organisatie de standaard internationale inbelnummers voor Cisco PSTN in Webex Meeting-sites.

De standaard internationale inbelnummers van de site worden ingesteld op het eerste beschikbare inbelnummer dat is gedefinieerd in het telefoniedomein op basis van het land van de organisatie. Als het land van de organisatie niet wordt gevonden in het inbelnummer dat is gedefinieerd in het telefoniedomein, wordt het standaardnummer van die locatie gebruikt.

Tabel 2. In de volgende tabel wordt de standaardlandcode voor inbellen weergegeven op basis van elke locatie:

S-nr.

Locatie

Landcode

Landnaam

1

AMER

+1

ONS, CA

2

APAC

+65

Singapore

3

ANUS, SCHEREN

+61

Australië

4

EMEA

+44

VK

5

EURO

+49

Duitsland

Regelingen voor meerdere partners

Gaat u Webex voor Cisco BroadWorks sublicentie geven aan een andere serviceprovider? In dit geval heeft elke serviceprovider een afzonderlijke partnerorganisatie nodig in Webex Control Hub om hen in staat te stellen de oplossing voor hun klantenbestand in te richten.

Inrichtingsadapter en sjablonen

Wanneer u flowthrough provisioning gebruikt, wordt de inrichtings-URL die u invoert in BroadWorks afgeleid van de sjabloon in Control Hub. U kunt meerdere sjablonen en dus meerdere inrichtings-URL's hebben. Hiermee kunt u per onderneming selecteren welk pakket u op abonnees wilt toepassen wanneer ze de geïntegreerde IM&P-service krijgen.

U moet overwegen of u een inrichtings-URL op systeemniveau wilt instellen als een standaardinrichtingspad en welke sjabloon u daarvoor wilt gebruiken. Op deze manier hoeft u alleen de inrichtings-URL expliciet in te stellen voor bedrijven die een andere sjabloon nodig hebben.

Houd er ook rekening mee dat u mogelijk al een inrichtings-URL op systeemniveau gebruikt, bijvoorbeeld met UC-One SaaS. Als dat het geval is, kunt u ervoor kiezen om de URL op systeemniveau te behouden voor het inrichten van gebruikers op UC-One SaaS en deze te overschrijven voor bedrijven die overstappen naar Webex voor Cisco BroadWorks. U kunt ook de andere kant op gaan en de URL op systeemniveau instellen voor Webex voor BroadWorks en de bedrijven die u wilt behouden op UC-One SaaS opnieuw configureren.

De configuratiekeuzes met betrekking tot deze beslissing worden beschreven in Toepassingsserver configureren met inrichtingsservice-URL.

Proxy inrichtingsadapter

Voor extra beveiliging kunt u met de Provisioning Adapter Proxy een HTTP(S)-proxy gebruiken op het Application Delivery Platform voor flowthrough-inrichting tussen de AS en Webex. De proxyverbinding maakt een end-to-end TCP-tunnel die verkeer tussen de AS en Webex doorgeeft, waardoor de AS geen directe verbinding met het openbare internet hoeft te maken. Voor veilige verbindingen kan TLS worden gebruikt.

Voor deze functie moet u de proxy instellen op BroadWorks. Zie voor meer informatie Beschrijving van de proxyfunctie van de Cisco BroadWorks-inrichtingsadapter.

Minimumvereisten

Accounts

Alle abonnees die u inricht voor Webex moeten bestaan in het BroadWorks-systeem dat u integreert met Webex. U kunt indien nodig meerdere BroadWorks-systemen integreren.

Alle abonnees moeten BroadWorks-licenties en een primair nummer of toestel hebben.

Webex gebruikt e-mailadressen als primaire id's voor alle gebruikers. Als u flowthrough-inrichting gebruikt met vertrouwde e-mails, moeten uw gebruikers geldige adressen hebben in het e-mailkenmerk in BroadWorks.

Als uw sjabloon BroadWorks-verificatie gebruikt, kunt u e-mailadressen van abonnees kopiëren naar het kenmerk Alternatieve id in BroadWorks. Hierdoor kunnen gebruikers zich aanmelden bij Webex met hun e-mailadressen en hun BroadWorks-wachtwoorden.

Uw beheerders moeten hun Webex-accounts gebruiken om zich aan te melden bij Partner Hub.


 
Het wordt niet ondersteund om een BroadWorks-beheerder te integreren in Webex voor Cisco BroadWorks. U kunt BroadWorks-bellende gebruikers met een primair nummer en/of toestel alleen onboarden. Als u flowthrough-inrichting gebruikt, moeten gebruikers ook de geïntegreerde IM&P-service krijgen toegewezen.

Servers in uw netwerk- en softwarevereisten

  • De BroadWorks-instantie(s) moet(en) ten minste de volgende servers bevatten:

    • Toepassingsserver (AS) met BroadWorks-versie zoals hierboven

    • Netwerkserver (NS)

    • Profielserver (PS)

  • Openbare XSP|ADP-server(s) of Application Delivery Platform (ADP) die aan de volgende vereisten voldoen:

    • Verificatieservice (BWAuth)

    • XSI-acties en -gebeurtenissen-interfaces

    • DMS (webapplicatie voor apparaatbeheer)

    • CTI-interface (intergratie van computertelefonie)

    • TLS 1.2 met een geldig certificaat (niet zelfondertekend) en vereiste tussenproducten. Vereist systeembeheerder om het opzoeken van bedrijven te vergemakkelijken.

    • Wederzijdse TLS-verificatie (mTLS) voor verificatieservice (vereist dat de openbare Webex-clientcertificaatketen als vertrouwensankers is geïnstalleerd)

    • Wederzijdse TLS-verificatie (mTLS) voor CTI-interface (vereist dat de openbare Webex-clientcertificaatketen als vertrouwensankers is geïnstalleerd)

  • Een afzonderlijke XSP/ADP-server die fungeert als een pushserver voor gespreksmeldingen (een NPS in uw omgeving die wordt gebruikt om gespreksmeldingen naar Apple/Google te pushen). We noemen het hier 'CNPS' om het te onderscheiden van de service in Webex die pushmeldingen voor berichten en aanwezigheid levert).

    Deze server moet op R22 of hoger zijn.

  • We mandaat een afzonderlijke XSP/ADP-server voor CNPS omdat de onvoorspelbaarheid van de belasting van Webex voor BWKS-cloudverbindingen een negatieve invloed kan hebben op de prestaties van de NPS-server, met als gevolg toenemende latentie van meldingen. Zie de Cisco BroadWorks System Engineering Guide voor meer informatie over de XSP|ADP-schaal.

Webex-app-platforms

Fysieke telefoons en accessoires

Apparaatintegratie

Zie de Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks voor meer informatie over het onboarden en gebruiken van OS- en MPP-apparaten in de serviceruimte voor Webex voor Cisco BroadWorks.

Apparaatprofielen

Hieronder staan de DTAF-bestanden die u op uw toepassingsservers moet laden om de Webex-app als een belclient te ondersteunen. Het zijn dezelfde DTAF-bestanden als gebruikt voor UC-One SaaS, maar er is een nieuwe config-wxt.xml.template bestand dat wordt gebruikt voor de Webex-app.

Als u de nieuwste apparaatprofielen wilt downloaden, gaat u naar de site van het Application Delivery Platform Software Downloads om de nieuwste DTAF-bestanden op te halen. Deze downloads werken voor zowel ADP als XSP.

Clientnaam

Type apparaatprofiel en pakketnaam

Webex Mobile-sjabloon

Type identiteit/apparaatprofiel: Verbinding maken - mobiel

DTAF: ucone-mobile-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Sjabloon voor Webex-tablet

Type identiteit/apparaatprofiel: Verbinding maken - tablet

DTAF: ucone-tablet-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Webex Desktop-sjabloon

Type identiteit/apparaatprofiel: Bedrijfscommunicator - PC

DTAF: ucone-desktop-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Identificeer/apparaatprofiel

Alle Webex voor Cisco BroadWorks-gebruikers moeten een Identity/Device Profile hebben toegewezen in BroadWorks dat een van de bovenstaande apparaatprofielen gebruikt om te bellen met de Webex-app. Het profiel biedt de configuratie waarmee de gebruiker gesprekken kan plaatsen.

OAuth-aanmeldgegevens voor uw Webex voor Cisco BroadWorks verkrijgen

Dien een serviceverzoek in bij uw onboardingagent of bij Cisco TAC om Cisco OAuth in te richten voor uw Cisco Identity Provider Federation-account.

Gebruik de volgende titel van het verzoek voor de respectieve functies:

  1. XSP|ADP AuthService Configuration' voor het configureren van de service op XSP|ADP.

  2. 'NPS-configuratie voor verificatie proxy instellen' om NPS te configureren voor het gebruik van de verificatieproxy.

  3. CI-gebruikers-UUID synchroniseren' voor CI-gebruikers-UUID synchroniseren. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.

  4. Configureer BroadWorks om Cisco-facturering voor BroadWorks en Webex Voor BroadWorks-abonnementen in te schakelen.

Cisco geeft u een OAuth-client-id, een clientgeheim en een vernieuwingstoken die 60 dagen geldig is. Als het token verloopt voordat u het gebruikt, kunt u een andere aanvraag indienen.


 

Als u al de referenties van de Cisco OAuth-identiteitsprovider hebt verkregen, voltooit u een nieuw serviceverzoek om uw referenties bij te werken.

Bestellingscertificaten

Certificaatvereisten voor TLS-verificatie

Voor alle vereiste toepassingen hebt u beveiligingscertificaten nodig, ondertekend door een bekende certificeringsinstantie en geïmplementeerd op uw openbare XSP|ADP's. Deze worden gebruikt om TLS-certificaatverificatie te ondersteunen voor alle inkomende verbindingen met uw XSP|ADP-servers.

Deze certificaten moeten uw XSP|ADP openbare volledig gekwalificeerde domeinnaam bevatten als algemene naam of alternatieve naam van het onderwerp.

De exacte vereisten voor het implementeren van deze servercertificaten zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt samengevat waar het door de CA ondertekende openbare servercertificaat in deze drie gevallen moet worden geladen:

De openbaar ondersteunde certificeringsinstanties die door de Webex-app worden ondersteund voor verificatie, worden weergegeven in Ondersteunde certificeringsinstanties voor hybride Webex-services.

Vereisten voor TLS-certificaat voor TLS-bridge Proxy

  • Het openbaar ondertekende servercertificaat wordt in de proxy geladen.

  • De proxy presenteert dit openbaar ondertekende servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • Een intern door een certificeringsinstantie ondertekend certificaat kan op de XSP|ADP worden geladen.

  • De XSP|ADP legt dit intern ondertekende servercertificaat voor aan de proxy.

  • De proxy vertrouwt de interne CA die het XSP|ADP-servercertificaat heeft ondertekend.

TLS-certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ

  • Het openbaar ondertekende servercertificaat wordt geladen in de XSP|ADP's.

  • De XSP|ADP's presenteren openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP|ADP's heeft ondertekend.

Aanvullende certificaatvereisten voor wederzijdse TLS-verificatie via de CTI-interface

Wanneer u verbinding maakt met de CTI-interface, presenteert Webex een clientcertificaat als onderdeel van wederzijdse TLS-verificatie. Het CA-/kettingcertificaat van het Webex-clientcertificaat kan worden gedownload via Control Hub.

Het certificaat downloaden:

Meld u aan bij Partner Hub en ga naar Instellingen > BroadWorks Calling en klik op de koppeling voor het downloaden van het certificaat.

De exacte vereisten voor het implementeren van deze Webex CA-certificaatketen zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

Het volgende diagram geeft een samenvatting van de certificaatvereisten in deze drie gevallen:

mTLS-certificaatuitwisseling voor CTI via verschillende Edge-configuraties

(Optie) Certificaatvereisten voor TLS-bridge Proxy

  • Webex presenteert een openbaar ondertekend clientcertificaat aan de proxy.

  • De proxy vertrouwt de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de vertrouwensopslag van de proxy. Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de proxy geladen.

  • De proxy presenteert het openbaar ondertekende servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • De volmachthebber legt een intern ondertekend clientcertificaat voor aan de XSP|ADP’s.

    Dit certificaat moet het uitbreidingsveld Extended Key Usage van x509.v3 bevatten met het BroadWorks-OID-doel 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS-clientAuth. Bijv.:

    X509v3 extensions:
        X509v3 Extended Key Usage:
            1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication

    De CN van het interne certificaat moet bwcticlient.webex.com.


     
    • Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

    • Openbare certificeringsinstanties zijn mogelijk niet bereid om certificaten te ondertekenen met het vereiste bedrijfseigen BroadWorks-OID. In het geval van een overbruggingsproxy moet u mogelijk een interne CA gebruiken om het clientcertificaat dat de proxy aanbiedt aan de XSP|ADP te ondertekenen.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP’s presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

  • De ClientIdentity van de toepassingsserver bevat de CN van het intern ondertekende clientcertificaat dat door de proxy wordt voorgelegd aan de XSP|ADP.

(Optie) Certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ

  • Webex presenteert een door een interne CA ondertekend Cisco-clientcertificaat aan de XSP|ADP's.

  • De XSP|ADP's vertrouwen de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de vertrouwensopslag van de proxy. Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de XSP|ADP's geladen.

  • De XSP|ADP's presenteren de openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP|ADP's heeft ondertekend.

  • De Application Server ClientIdentity bevat de algemene naam van het door Cisco ondertekende clientcertificaat dat door Webex wordt aangeboden aan de XSP|ADP.

Uw netwerk voorbereiden

Zie voor meer informatie over verbindingen die worden gebruikt door Webex voor Cisco BroadWorks: Netwerkvereisten voor Webex voor Cisco BroadWorks. Dit artikel bevat de lijst met IP-adressen, poorten en protocollen die vereist zijn om de ingress- en egress-regels van uw firewall te configureren.

Netwerkvereisten voor Webex-services

De voorgaande firewalltabellen met ingress- en exress-regels documenteren alleen de verbindingen die specifiek zijn voor Webex voor Cisco BroadWorks. Zie Netwerkvereisten voor Webex-services voor algemene informatie over verbindingen tussen de Webex-app en de Webex-cloud. Dit artikel is algemeen voor Webex, maar in de volgende tabel worden de verschillende gedeelten van het artikel aangegeven en wordt aangegeven hoe relevant elk gedeelte is voor Webex voor Cisco BroadWorks.

Tabel 3. Netwerkvereisten voor verbindingen met de Webex-app (algemeen)

Deel van artikel over netwerkvereisten

Relevantie van informatie

Overzicht van door Webex ondersteunde apparaattypen en protocollen

Informatief

Transportprotocollen en versleutelingscodes voor cloudgeregistreerde Webex-apps en -apparaten

Informatief

Webex-services - Poortnummers en protocollen

Moet gelezen worden

IP-subnetten voor Webex-mediaservices

Moet gelezen worden

Domeinen en URL's die toegankelijk moeten zijn voor Webex-services

Moet gelezen worden

Aanvullende URL's voor hybride Webex-services

Optioneel

Proxyfuncties

Optioneel

802.1X: netwerktoegangsbeheer op basis van poorten

Optioneel

Netwerkvereisten voor SIP-gebaseerde Webex-services

Optioneel

Netwerkvereisten voor Webex Edge Audio

Optioneel

Een overzicht van andere hybride Webex-services en documentatie

Optioneel

Webex-services voor FedRAMP-klanten

N.v.t.

Aanvullende informatie

Zie Firewall-whitepaper van de Webex-app (PDF) voor meer informatie.

Ondersteuning voor redundantie van BroadWorks

De Webex-cloudservices en de Webex-clientapps die toegang moeten krijgen tot het netwerk van de partner ondersteunen volledig de Broadworks XSP|ADP-redundantie die door de partner wordt geboden. Wanneer een XSP|ADP of site niet beschikbaar is voor gepland onderhoud of ongeplande reden, kunnen de Webex-services en -apps doorschakelen naar een andere XSP|ADP of site die door de partner wordt geleverd om een verzoek te voltooien.

Netwerktopologie

De Broadworks XSP|ADP's kunnen rechtstreeks op het internet worden geïmplementeerd of kunnen zich in een DMZ bevinden met een load balancing-element zoals de F5 BIG-IP. Om geo-redundantie te bieden, kunnen de XSP|ADP's worden geïmplementeerd in twee (of meer) datacenters, elk met een load balancer, elk met een openbaar IP-adres. Als de XSP|ADP's zich achter een load balancer bevinden, zien de Webex-microservices en -app alleen het IP-adres van de load balancer en lijkt Broadworks slechts één XSP|ADP te hebben, zelfs als er meerdere XSP|ADP's achter zitten.

In het onderstaande voorbeeld worden de XSP|ADP's geïmplementeerd op twee sites, Site A en Site B. Op elke site zijn er twee XSP|ADP's, voorafgegaan door een lastbalancer. Site A heeft XSP|ADP1 en XSP|ADP2 voor LB1, en Site B heeft XSP|ADP3 en XSP|ADP4 voor LB2. Alleen de lastbalancers worden op het openbare netwerk weergegeven en de XSP|ADP's bevinden zich in de privénetwerken van DMZ.

Webex-cloudservices

DNS-configuratie

De microservices van Webex Cloud moeten de Broadworks XSP|ADP-server(s) kunnen vinden om verbinding te maken met de Xsi-interfaces, de verificatieservice en CTI.

Webex Cloud-microservices voeren DNS A/AAAA-zoekopdrachten uit voor de geconfigureerde XSP|ADP-hostnaam en maken verbinding met het geretourneerde IP-adres. Dit kan een load balancing edge-element zijn, of de XSP|ADP-server zelf. Als er meerdere IP-adressen worden geretourneerd, wordt het eerste IP in de lijst geselecteerd. SRV-zoekopdrachten worden momenteel niet ondersteund.

Voorbeeld: De DNS van de partner A Record voor ontdekking van Round-Robin gebalanceerde internet-gerichte XSP|ADP-server/load balancers.

Recordtype

Naam

Doel

Doel

A

webex-cloud-xsp.example.com

198.51.100.48

Verwijst naar LB1 (Site A)

A

webex-cloud-xsp.example.com

198.51.100.49

Verwijst naar LB2 (Site B)


 

Elke verwijzing naar XSP omvat XSP of ADP.

Failover

Wanneer de Webex-microservices een verzoek naar de XSP|ADP/Load Balancer verzenden en het verzoek mislukt, kunnen er verschillende dingen gebeuren:

  • Als de fout te wijten is aan een netwerkfout (bv.: TCP, SSL) markeren de Webex-microservices het IP als geblokkeerd en voeren ze onmiddellijk een route door naar het volgende IP.

  • Als er een foutcode (HTTP 5xx) wordt geretourneerd, markeren de Webex-microservices het IP als geblokkeerd en voeren ze onmiddellijk een route door naar het volgende IP.

  • Als er binnen 2 seconden geen HTTP-reactie wordt ontvangen, time-out van het verzoek en de Webex-microservices markeren het IP als geblokkeerd en voeren een route door naar het volgende IP.

Elk verzoek wordt 3 keer geprobeerd voordat een storing wordt teruggekoppeld naar de microservice.

Wanneer een IP in de geblokkeerde lijst staat, wordt het niet opgenomen in de lijst met adressen die moet worden geprobeerd bij het verzenden van een aanvraag naar een XSP|ADP. Na een vooraf bepaalde tijdsperiode verloopt een geblokkeerd IP en gaat het terug naar de lijst om te proberen wanneer een ander verzoek wordt gedaan.

Als alle IP-adressen zijn geblokkeerd, probeert de microservice de aanvraag nog steeds te verzenden door willekeurig een IP-adres te selecteren in de geblokkeerde lijst. Als dit is gelukt, wordt dat IP-adres verwijderd uit de geblokkeerde lijst.

Status

De status van de verbinding van de Webex-cloudservices met de XSP|ADP's of load balancers is te zien in Control Hub. Onder een BroadWorks-gesprekscluster wordt een verbindingsstatus weergegeven voor elk van deze interfaces:

  • XSI-acties

  • XSI-gebeurtenissen

  • Verificatieservice

De verbindingsstatus wordt bijgewerkt wanneer de pagina wordt geladen of tijdens invoerupdates. De verbindingsstatussen kunnen zijn:

  • Groen: Wanneer de interface kan worden bereikt op een van de IP's in Een recordzoekopdracht.

  • Rood: Wanneer alle IP's in de A-recordzoekopdracht niet bereikbaar zijn en de interface niet beschikbaar is.

De volgende services gebruiken de microservices om verbinding te maken met de XSP|ADP's en worden beïnvloed door de beschikbaarheid van de XSP|ADP-interface:

  • Aanmelden bij Webex-app

  • Token voor Webex-app vernieuwen

  • Niet-vertrouwde e-mail/zelfactivering

  • Gezondheidscontrole van Broadworks-service

Webex-app

DNS-configuratie

De Webex-app heeft toegang tot de services Xtended Services Interface (XSI-acties en XSI-gebeurtenissen) en Device Management Service (DMS) op de XSP|ADP.

Om de XSI-service te vinden, voert de Webex-app DNS SRV-zoekopdrachten uit voor _xsi-client._tcp.<webex app xsi domain>. De SRV verwijst naar de geconfigureerde URL voor de XSP|ADP-hosts of load balancers voor de XSI-service. Als SRV-zoekopdrachten niet beschikbaar zijn, keert de Webex-app terug naar A/AAAA-zoekopdrachten.

De SRV kan overschakelen op meerdere A/AAAA-doelen. Elke A/AAAA-record moet echter alleen naar één IP-adres worden toegewezen. Als er meerdere XSP|ADP's in een DMZ achter het load balancer/edge-apparaat zijn, moet de load balancer worden geconfigureerd om de sessiepersistentie te behouden en alle verzoeken van dezelfde sessie naar dezelfde XSP|ADP te routeren. We machtigen deze configuratie omdat de XSI-event heartbeats van de client naar dezelfde XSP|ADP moeten gaan die wordt gebruikt om het gebeurteniskanaal op te zetten.


 

In voorbeeld 1 bestaat de A/AAAA-record voor webex-app-XSP|ADP.example.com niet en hoeft deze niet te worden gebruikt. Als uw DNS vereist dat één A/AAAA-record moet worden gedefinieerd, mag slechts 1 IP-adres worden geretourneerd. De SRV moet echter nog steeds worden gedefinieerd voor de Webex-app.

Als de Webex-app de A/AAAA-naam gebruikt die wordt omgezet naar meer dan één IP-adres, of als het load balancer/edge-element geen sessiepersistentie handhaaft, verzendt de client uiteindelijk heartbeats naar een XSP|ADP waar het geen gebeurteniskanaal tot stand heeft gebracht. Dit resulteert in het afbreken van het kanaal en ook in aanzienlijk meer intern verkeer, wat de prestaties van uw XSP|ADP-cluster belemmert.

Omdat de Webex-cloud en de Webex-app verschillende vereisten hebben voor het opzoeken van A/AAAA-opnamen, moet u een afzonderlijke FQDN gebruiken voor toegang tot uw XSP|ADP's voor de Webex-cloud en de Webex-app. Zoals in de voorbeelden wordt weergegeven, gebruikt Webex Cloud Een record webex-cloud-xsp.example.com en de Webex-app gebruikt SRV _xsi-client._tcp.webex-app-xsp.example.com.

Voorbeeld 1: meerdere XSP|ADP's, elk achter afzonderlijke lastbalancers

In dit voorbeeld wijst de SRV naar A-records met elk Een record die naar een andere lastbalancer op een andere locatie wijzen. De Webex-app gebruikt altijd het eerste IP-adres in de lijst en gaat alleen naar de volgende record als de eerste is uitgeschakeld.

Hieronder vindt u een voorbeeld van SRV-records.

Recordtype

Opnemen

Doel

Doel

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc1.example.com

Clientdetectie van Xsi-interface

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc2.example.com

Clientdetectie van Xsi-interface

A

xsp-dc1.example.com

198.51.100.48

Verwijst naar LB1 (site A)

A

xsp-dc2.example.com

198.51.100.49

Punten naar LB2 (site B)

Voorbeeld 2: meerdere XSP|ADP's achter één lastbalancer (met TLS-brug)

Voor het eerste verzoek selecteert de load balancer een willekeurige XSP|ADP. XSP|ADP retourneert een cookie dat de Webex-app in toekomstige verzoeken bevat. Voor toekomstige verzoeken gebruikt de load balancer de cookie om de verbinding naar de juiste XSP|ADP te routeren, zodat het gebeurteniskanaal niet wordt verbroken.

Recordtype

Opnemen

Doel

Doel

SRV

_xsi-client._tcp.webex-app-xsp.example.com

LB.example.com

Lastbalancer

A

LB.voorbeeld.com

198.51.100.83

IP-adres van load balancer (XSP|ADP's bevinden zich achter load balancer)

URL DMS

Tijdens het aanmeldproces haalt de Webex-app ook de DMS-URL op om het configuratiebestand te downloaden. De host in de URL wordt geparseerd en de Webex-app voert DNS A/AAAA-zoekopdrachten uit van de host om verbinding te maken met de XSP|ADP die de DMS-service host.

Voorbeeld: DNS Een record voor het ontdekken van Round-Robin gebalanceerde internet-gerichte XSP|ADP-server/load balancers door de Webex-app om configuratiebestanden te downloaden via DMS:

Recordtype

Naam

Doel

Doel

A

xsp-dms.example.com

198.51.100.48

Verwijst naar LB1 (site A)

A

xsp-dms.example.com

198.51.100.49

Punten naar LB2 (site B)


 
Elke verwijzing naar XSP omvat XSP of ADP.
Hoe de Webex-app XSP|ADP-adressen vindt

De client probeert de XSP|ADP-knooppunten te vinden met behulp van de volgende DNS-flow:

  1. De client haalt aanvankelijk URL's voor Xsi-acties/Xsi-Events op uit de Webex-cloud (u hebt deze ingevoerd bij het maken van het gekoppelde BroadWorks-gesprekscluster). De Xsi-hostnaam/het Xsi-domein wordt geparseerd vanaf de URL en de client voert de SRV-zoekopdracht als volgt uit:

    1. De client voert een SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">

    2. Als de SRV-zoekopdracht een of meer A/AAAA-doelen retourneert:

      1. De client zoekt A/AAAA op voor deze doelen en slaat de geretourneerde IP-adressen in de cache.

      2. De client maakt verbinding met een van de doelen (en dus de A/AAAA-record met één IP-adres) op basis van de SRV-prioriteit, vervolgens het gewicht (of willekeurig als ze allemaal gelijk zijn).

    3. Als de SRV-zoekopdracht geen doelen retourneert:

      De client zoekt A/AAAA op van de Xsi-hoofdparameter en probeert vervolgens verbinding te maken met het geretourneerde IP-adres. Dit kan een load balancing edge-element zijn, of de XSP|ADP-server zelf.

      Zoals vermeld, moet de A/AAAA-record om dezelfde redenen worden omgezet naar één IP-adres.

  2. (Optioneel) U kunt vervolgens aangepaste XSI-acties/XSI-gebeurtenissen opgeven in de apparaatconfiguratie voor de Webex-app, met behulp van de volgende tags:

    <protocols>
    	<xsi>
    		<paths>
    			<root>%XSI_ROOT_WXT%</root>
    			<actions>%XSI_ACTIONS_PATH_WXT%</actions>
    			<events>%XSI_EVENTS_PATH_WXT%</events>
    		</paths>
    	</xsi>
    </protocols>
    1. Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.

    2. Als deze bestaan, vergelijkt de client met het oorspronkelijke XSI-adres dat hij heeft ontvangen via de BroadWorks-clusterconfiguratie.

    3. Als er een verschil wordt gedetecteerd, initialiseert de client de XSI-acties/ XSI Events-verbinding opnieuw. De eerste stap hierin is om hetzelfde DNS-opzoekproces uit te voeren dat wordt vermeld onder stap 1. Dit keer wordt een zoekopdracht aangevraagd voor de waarde in de parameter %XSI_ROOT_WXT% vanuit het configuratiebestand.


       
      Zorg ervoor dat u de bijbehorende SRV-records maakt als u deze tag gebruikt om de Xsi-interfaces te wijzigen.
Failover

Tijdens het aanmelden voert de Webex-app een DNS SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">, stelt een lijst met hosts op en maakt verbinding met een van de hosts op basis van de SRV-prioriteit en vervolgens het gewicht. Deze verbonden host wordt de geselecteerde host voor alle toekomstige aanvragen. Er wordt vervolgens een gebeurteniskanaal geopend voor de geselecteerde host en er wordt regelmatig een hartslag verzonden om het kanaal te verifiëren. Alle aanvragen die na de eerste worden verzonden, bevatten een cookie dat wordt geretourneerd in de HTTP-respons. Daarom is het belangrijk dat de load balancer de sessiepersistentie (affiniteit) behoudt en altijd aanvragen naar dezelfde backend XSP|ADP-server verzendt.

Als een verzoek of een heartbeat-verzoek aan een host mislukt, kunnen er verschillende dingen gebeuren:

  • Als de fout het gevolg is van een netwerkfout (bijv. TCP, SSL) gaat de route van de Webex-app onmiddellijk door naar de volgende host in de lijst.

  • Als er een foutcode (HTTP 5xx) wordt geretourneerd, markeert de Webex-app dat IP-adres als geblokkeerd en leidt deze door naar de volgende host in de lijst.

  • Als er niet binnen een bepaalde periode een reactie wordt ontvangen, wordt het verzoek als mislukt beschouwd vanwege een time-out en worden de volgende verzoeken naar de volgende host verzonden. Het time-outverzoek wordt echter als mislukt beschouwd. Sommige verzoeken worden opnieuw geprobeerd na een fout (met toenemende tijd voor opnieuw proberen). De verzoeken om het veronderstelde niet-vitale niet opnieuw te proberen.

Wanneer een nieuwe host is geprobeerd, wordt deze de nieuwe geselecteerde host als de host aanwezig is in de lijst. Nadat de laatste host in de lijst is geprobeerd, rolt de Webex-app over naar de eerste.

In het geval van heartbeat, als er twee opeenvolgende mislukte verzoeken zijn, initialiseert de Webex-app het gebeurteniskanaal opnieuw.

Houd er rekening mee dat de Webex-app geen fail-back uitvoert en dat DNS-servicedetectie slechts één keer wordt uitgevoerd bij het aanmelden.

Tijdens het aanmelden probeert de Webex-app het configuratiebestand te downloaden via de XSP|ADP/Dms-interface. Het voert een A/AAAA-recordzoekopdracht uit van de host in de opgehaalde DMS-URL en maakt verbinding met het eerste IP. Eerst wordt geprobeerd het verzoek om het configuratiebestand te downloaden te verzenden met een SSO-token. Als dit om welke reden dan ook mislukt, wordt het opnieuw geprobeerd, maar wel met de gebruikersnaam en het wachtwoord van het apparaat.

Webex voor BroadWorks implementeren

Implementatieoverzicht

De volgende diagrammen geven de typische volgorde van uw implementatietaken weer voor de verschillende gebruikersinrichtingsmodi. Veel van de taken zijn gemeenschappelijk voor alle inrichtingsmodi.

Toont de volgorde van de taken die vereist zijn voor het implementeren van Webex voor BroadWorks met doorstroominrichting en vertrouwde e-mails
Taken vereist voor het implementeren van doorstroominrichting
Toont de volgorde van de taken die vereist zijn voor het implementeren van Webex voor BroadWorks met doorstroominrichting zonder e-mails
Taken vereist voor het implementeren van flowthrough-inrichting zonder vertrouwde e-mails
Toont de volgorde van de taken die vereist zijn voor het implementeren van Webex voor BroadWorks met zelfactivering
Taken vereist voor het implementeren van zelfinrichting van gebruikers

Onboarding van partners voor Webex voor Cisco BroadWorks

Elke Webex voor Cisco BroadWorks-serviceprovider of -reseller moet worden ingesteld als een partnerorganisatie voor Webex voor Cisco BroadWorks. Als u een bestaande Webex-partnerorganisatie hebt, kan dit worden gebruikt.

Om de noodzakelijke onboarding te voltooien, moet u uw Webex Cisco BroadWorks-papierwerk uitvoeren en moeten nieuwe partners de online overeenkomst voor indirecte kanaalpartners (ICPA) accepteren. Wanneer deze stappen zijn voltooid, maakt Cisco Compliance een nieuwe partnerorganisatie in Partner Hub (indien nodig) en verzendt een e-mail met verificatiegegevens naar de beheerder van uw administratie. Tegelijkertijd zal uw Partner Activation en/of Customer Success Program Manager contact met u opnemen om uw onboarding te starten.

Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's

We vereisen dat de NPS-toepassing op een andere XSP|ADP wordt uitgevoerd. Vereisten voor die XSP|ADP worden beschreven in Gespreksmeldingen configureren vanuit uw netwerk.

U hebt de volgende toepassingen/services nodig op uw XSP|ADP's.

Service/toepassing

Verificatie vereist

Doel van de dienst/toepassing

Xsi-gebeurtenissen

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, servicemeldingen

Xsi-acties

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, acties

Apparaatbeheer

TLS (server verifieert zichzelf bij clients)

Configuratie voor bellen downloaden

Verificatieservice

TLS (server verifieert zichzelf bij clients)

Gebruikersverificatie

Integratie van computertelefonie

mTLS (client en server verifiëren elkaar)

Telefonieaanwezigheid

Webview-toepassing voor gespreksinstellingen

TLS (server verifieert zichzelf bij clients)

Stelt gespreksinstellingen van gebruikers bloot in de selfcare-portal in de Webex-app

In dit gedeelte wordt beschreven hoe u de vereiste configuraties voor TLS en mTLS op deze interfaces kunt toepassen, maar u moet de bestaande documentatie raadplegen om de toepassingen op uw XSP|ADP's te laten installeren.

Vereisten co-residentie

  • De verificatieservice moet co-resident zijn met Xsi-toepassingen, omdat deze interfaces langdurige tokens voor serviceautorisatie moeten accepteren. De verificatieservice is vereist om deze tokens te valideren.

  • De verificatieservice en Xsi kunnen indien nodig op dezelfde poort worden uitgevoerd.

  • U kunt de andere services/toepassingen scheiden zoals vereist voor uw weegschaal (bijvoorbeeld dedicated device management XSP|ADP farm).

  • U kunt de Xsi-, CTI-, Authenticatieservice- en DMS-toepassingen co-lokaliseren.

  • Installeer geen andere toepassingen of services op de XSP|ADP's die worden gebruikt voor de integratie van BroadWorks met Webex.

  • Zoek de NPS-toepassing niet samen met andere toepassingen.

Xsi-interfaces

Installeer en configureer de Xsi-Actions- en Xsi-Events-toepassingen zoals beschreven in de Configuratiehandleiding voor Cisco BroadWorks Xtended Services Interface.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Voor alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moet dezelfde callControlApplicationName zijn gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker is geïntegreerd in Webex, maakt Webex een abonnement voor de gebruiker op de AS om telefoniegebeurtenissen te ontvangen voor aanwezigheid en gespreksgeschiedenis. Het abonnement is gekoppeld aan de callControlApplicationName en de AS gebruikt het om te weten naar welke Xsi-Events de telefonie-gebeurtenissen moeten worden verzonden.


 

Het wijzigen van de callControlApplicationName of het niet hebben van dezelfde naam op alle Xsi-Events-webapps zal invloed hebben op abonnementen en telefonie gebeurtenissen functionaliteit.

Verificatieservice configureren (met CI-tokenvalidatie)

Gebruik deze procedure om de verificatieservice te configureren voor het gebruik van CI-tokenvalidatie met TLS. Deze verificatiemethode wordt aanbevolen als u R22 of hoger gebruikt en uw systeem deze ondersteunt.


 

Wederzijdse TLS (mTLS) wordt ook ondersteund als een alternatieve verificatiemethode voor de verificatieservice. Als u meerdere Webex-organisaties op dezelfde XSP|ADP-server hebt uitgevoerd, moet u mTLS-verificatie gebruiken omdat CI-tokenvalidatie niet meerdere verbindingen met dezelfde XSP|ADP-verificatieservice ondersteunt.

Als u mTLS-verificatie wilt configureren voor de verificatieservice in plaats van CI-tokenvalidatie, raadpleegt u de bijlage voor Services configureren (met mTLS voor de verificatieservice).


 
Als u momenteel mTLS gebruikt voor de verificatieservice, is het niet verplicht om opnieuw te configureren voor het gebruik van CI-tokenvalidatie met TLS.
  1. Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.

  2. Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw versie:


     
    Elke verwijzing naar XSP omvat XSP of ADP.
  3. Installeer de AuthenticationService toepassing op elke XSP|ADP-service.

    1. Voer de volgende opdracht uit om de AuthenticationService-toepassing op de XSP|ADP te activeren op het contextpad /authService.

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
    2. Voer deze opdracht uit om de AuthenticationService te implementeren op de XSP|ADP:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
  4. Vanaf Broadworks build 2022.10 worden de certificerende autoriteiten die met Java komen niet meer automatisch opgenomen in de BroadWorks-vertrouwensopslag wanneer wordt overgeschakeld naar een nieuwe versie van java. De AuthenticationService opent een TLS-verbinding met Webex om het toegangstoken op te halen en moet het volgende in de truststore hebben om de IDBroker- en Webex-URL te valideren:

    • IdenTrust commercieel hoofd-CA 1

    • GoDaddy Root Certification Authority - G2

    Controleer of deze certificaten aanwezig zijn onder de volgende CLI

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

    Als dit niet aanwezig is, voert u de volgende opdracht uit om de standaard Java-trusts te importeren:

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

    U kunt deze certificaten ook handmatig toevoegen als vertrouwensankers met de volgende opdracht:

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

    Als de ADP is geüpgraded vanaf een vorige release, worden de certificeringsinstanties van de oude release automatisch geïmporteerd naar de nieuwe release en blijven ze geïmporteerd totdat ze handmatig worden verwijderd.


     

    De toepassing AuthenticationService is vrijgesteld van de instelling validatePeerIdentity onder ADP_CLI/System/SSLCommonSettings/GeneralSettings en valideert altijd de peer Identity. Zie de Cisco Broadworks X509 Certificate Validation FD voor meer informatie over deze instelling.

  5. Configureer de identiteitsproviders door de volgende opdrachten uit te voeren op elke XSP|ADP-server:

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

    • set clientId client-Id-From-Step1

    • set enabled true

    • set clientSecret client-Secret-From-Step1

    • set ciResponseBodyMaxSizeInBytes 65536

    • set issuerName <URL> —Voor de URL voer de URL van de IssuerName in die van toepassing is op uw CI-cluster. Zie volgende tabel.

    • set issuerUrl <URL> —Voor de URL voer de IssuerUrl in die van toepassing is op uw CI-cluster. Zie de volgende tabel.

    • set tokenInfoUrl <IdPProxy URL> —Voer de IdP-proxy-URL in die van toepassing is op uw Teams-cluster. Zie de tweede tabel die volgt.

    Tabel 1. Naam en URL van uitgever instellen
    Als CI-cluster is...Naam en URL van uitgever instellen op...

    US-A

    https://idbroker.webex.com/idb

    EU

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

    US-B

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


     
    Als u uw CI-cluster niet kent, kunt u de informatie verkrijgen via de klantgegevens in de helpdeskweergave van Control Hub.
    Tabel 2. TokenInfoURL instellen
    Als het Teams-cluster...TokenInfoURL instellen op... (IdP proxy-URL)

    ACHM, WATERPIJP

    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

    AASAPPEL

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


     
    • Als u uw Teams-cluster niet kent, kunt u de informatie verkrijgen via de klantgegevens in de helpdeskweergave van Control Hub.

    • Voor tests kunt u controleren of de tokenInfoURL geldig is door de " idp/authenticate" gedeelte van de URL met " ping".

  6. Geef de Webex-rechten op die aanwezig moeten zijn in het gebruikersprofiel in Webex door de volgende opdracht uit te voeren:

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

  7. Configureer identiteitsproviders voor Cisco Federation met de volgende opdrachten op elke XSP|ADP-server:

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

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

    • set refreshPeriodInMinutes 60

    • set refreshToken refresh-Token-From-Step1

  8. Voer de volgende opdracht uit om te valideren dat uw FLS-configuratie werkt. Met deze opdracht keert u de lijst met identiteitsproviders terug:

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

  9. Configureer Tokenbeheer met de volgende opdrachten op elke XSP|ADP-server:

    • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

    • set tokenIssuer BroadWorks

    • set tokenDurationInHours 720

  10. RSA-sleutels genereren en delen. U moet sleutels genereren op één XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's. Dit is te wijten aan de volgende factoren:

    • U moet dezelfde openbare/privésleutelparen gebruiken voor tokencodering/decodering in alle instanties van de verificatieservice.

    • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet uitgeven.


     
    Als u met de toetsen gaat fietsen of de lengte van de toetsen wijzigt, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw starten.
    1. Selecteer één XSP|ADP om een sleutelpaar te genereren.

    2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen in de browser van de client:

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

      (Dit genereert een privaat/openbaar sleutelpaar op de XSP|ADP, als dat er nog niet was)

    3. De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:

      XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere .keys bestand indien nodig.

    5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

  11. Geef de authService-URL op aan de webcontainer. De webcontainer van de XSP|ADP heeft de authService-URL nodig zodat deze tokens kan valideren. Op elk van de XSP|ADP's:

    1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het communicatiehulpprogramma BroadWorks:

      XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

    2. Voeg de URL van de verificatieservice toe aan de container:

      XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

      Hiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.

    3. Controleer de parameter met get.

    4. Start de XSP|ADP opnieuw op.

Clientverificatievereiste voor verificatieservice verwijderen (alleen R24)

Als u de verificatieservice met CI-tokenvalidatie op R24 hebt geconfigureerd, moet u ook de clientverificatievereiste voor de verificatieservice verwijderen. Voer de volgende CLI-opdracht uit:

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

TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)

De toepassingen Verificatieservice, Xsi-acties en Xsi-Events maken gebruik van HTTP-serverinterfaces. De TLS-configureerbaarheidsniveaus voor deze toepassingen zijn als volgt:

Meest algemeen = Systeem > Transport > HTTP > HTTP Server interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit CLI-context
Systeem (globaal)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze veilig zijn en of ze clientverificatie vereisen.

Apache tomcat vereist een certificaat voor elke veilige interface; het systeem genereert een zelfondertekend certificaat als dit nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2-protocol toevoegen aan de HTTP-serverinterface

De HTTP-interface die communiceert met de Webex-cloud moet zijn geconfigureerd voor TLSv1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren in de interface van de HTTP-server:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken in de HTTP-serverinterface

De vereiste cijfers configureren:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de interface van de HTTP-server.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 in de interface van de HTTP-server gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver

Profielserver en XSP|ADP zijn verplicht voor apparaatbeheer. Ze moeten worden geconfigureerd volgens de instructies in de configuratiehandleiding voor BroadWorks-apparaatbeheer.

CTI-interface en gerelateerde configuratie

De configuratievolgorde 'maximaal' wordt hieronder weergegeven. Het volgen van deze bestelling is niet verplicht.

  1. Toepassingsserver configureren voor CTI-abonnementen

  2. XSP|ADP's configureren voor mTLS geverifieerde CTI-abonnementen

  3. Inkomende poorten openen voor veilige CTI-interface

  4. Abonneer uw Webex-organisatie op BroadWorks CTI-gebeurtenissen

Toepassingsserver configureren voor CTI-abonnementen

Werk de ClientIdentity op de toepassingsserver bij met de algemene naam (CN) van het Webex voor Cisco BroadWorks CTI-clientcertificaat.

Voeg voor elke toepassingsserver die u met Webex gebruikt de certificaatidentiteit als volgt toe aan de ClientIdentity:

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


 

De algemene naam van het Webex voor Cisco BroadWorks-clientcertificaat is bwcticlient.webex.com.

TLS en cijfers configureren op de CTI-interface

De configureerbaarheidsniveaus voor de XSP|ADP CTI-interface zijn als volgt:

Meest algemeen = Systeem > Transport > CTI Interfaces > CTI interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit

CLI-context

Systeem (globaal)

(R22 en hoger)

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

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

Transportprotocollen voor dit systeem

(R22 en hoger)

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

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

Alle CTI-interfaces op dit systeem

(R22 en hoger)

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

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

Een specifieke CTI-interface op dit systeem

(R22 en hoger)

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

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


 

Bij een nieuwe installatie worden de volgende versleutelingen standaard op systeemniveau geïnstalleerd. Als er niets is geconfigureerd op het interfaceniveau (bijvoorbeeld op de CTI-interface of HTTP-interface), is deze coderingslijst van toepassing. Houd er rekening mee dat deze lijst in de loop der tijd kan veranderen:

  • TLS_ECDHE_RSA_MET_AES_128_GCM_SHA256

  • TLS_ECDHE_ECDSA_MET_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_MET_AES_128_CBC_SHA256

  • TLS_ECDHE_ECDSA_MET_AES_128_CBC_SHA256

  • TLS_DHE_DSS_MET_AES_128_GCM_SHA256

  • TLS_DHE_RSA_MET_AES_128_GCM_SHA256

  • TLS_DHE_RSA_MET_AES_128_CBC_SHA256

  • TLS_DHE_DSS_MET_AES_128_CBC_SHA256

  • TLS_ECDH_RSA_MET_AES_128_GCM_SHA256

  • TLS_ECDH_ECDSA_MET_AES_128_GCM_SHA256

  • TLS_ECDH_RSA_MET_AES_128_CBC_SHA256

  • TLS_ECDH_ECDSA_MET_AES_128_CBC_SHA256

CTI TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze een servercertificaat vereisen en of ze clientverificatie vereisen.

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

TLS 1.2-protocol toevoegen aan de CTI-interface

De XSP|ADP CTI-interface die communiceert met de Webex-cloud moet worden geconfigureerd voor TLS v1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren op de CTI-interface:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken op de CTI-interface

De vereiste cijfers configureren voor de CTI-interface:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Voer de get opdracht om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> <cipherName> om een code toe te voegen aan de CTI-interface.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 naar de CTI-interface gebruikt u: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Vertrouwensankers voor CTI-interface (R22 en hoger)

Bij deze procedure wordt ervan uitgegaan dat de XSP|ADP's ofwel naar het internet gericht zijn ofwel naar het internet gericht zijn via pass-through proxy. De certificaatconfiguratie is anders voor een brugproxy (zie TLS-certificaatvereisten voor TLS-brugproxy).

Ga als volgt te werk voor elke XSP|ADP in uw infrastructuur die CTI-gebeurtenissen publiceert in Webex:

  1. Aanmelden bij Partnerhub .

  2. Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om CombinedCertChain2023.txt op uw lokale computer.


     

    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze uploadt naar de XSP|ADP's. Alle bestanden zijn vereist.

  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE----- en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één tekstblok bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt

  5. Meld u aan bij de XSP|ADP en ga naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Optioneel) Uitvoeren help updateTrust om de parameters en opdrachtindeling weer te geven.

  7. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 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


     

    Alle aliassen moeten een andere naam hebben. webexclientroot2023 en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang alle ingangen uniek zijn.

  8. Bevestig dat de ankers zijn bijgewerkt:

    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. Clients toestaan te verifiëren met certificaten:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

CTI-interface toevoegen en mTLS inschakelen

  1. Voeg de CTI SSL-interface toe.

    De CLI-context is afhankelijk van uw BroadWorks-versie. De opdracht maakt een zelfondertekend servercertificaat in de interface en dwingt de interface om een clientcertificaat te vereisen.

    • Op BroadWorks R22 en R23:

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

  2. Vervang het servercertificaat en de sleutel op de CTI-interfaces van XSP|ADP. U hebt hiervoor het IP-adres van de CTI-interface nodig; u kunt dit lezen uit de volgende context:

    • Op BroadWorks R22 en R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Voer vervolgens de volgende opdrachten uit om het zelfondertekende certificaat van de interface te vervangen door uw eigen certificaat en privésleutel:

      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. Start de XSP|ADP opnieuw op.

Toegang tot BroadWorks CTI-gebeurtenissen inschakelen in Webex

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters configureert in Partner Hub. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters configureert in Partner Hub. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

  • Geef het CTI-adres op waarmee Webex zich kan abonneren op BroadWorks CTI Events.

  • CTI-abonnementen zijn per abonnee en worden alleen ingesteld en onderhouden terwijl die abonnee is ingericht voor Webex voor Cisco BroadWorks.

Webweergave Gespreksinstellingen

Call Settings Webview (CSWV) is een toepassing die wordt gehost op XSP|ADP zodat gebruikers hun BroadWorks-gespreksinstellingen kunnen wijzigen via een webview die ze in de softclient zien. Zie de Handleiding voor webview-oplossingen voor Cisco BroadWorks-gespreksinstellingen.

Webex maakt gebruik van deze functie om gebruikers toegang te geven tot algemene BroadWorks-gespreksinstellingen die niet eigen zijn aan de Webex-app.

Als u wilt dat uw Webex voor Cisco BroadWorks-abonnees toegang hebben tot gespreksinstellingen die verder gaan dan de standaardinstellingen die beschikbaar zijn in de Webex-app, moet u de functie Webview voor gespreksinstellingen implementeren.

De webview Gespreksinstellingen heeft twee onderdelen:

  • Webview-toepassing voor gespreksinstellingen, gehost op een Cisco BroadWorks XSP|ADP.

  • De Webex-app, die de gespreksinstellingen in een Webview weergeeft.

Gebruikerservaring

  • Windows-gebruikers: Klik op Gespreksinstellingen en klik vervolgens op Gespreksvoorkeuren openen > Geavanceerde gespreksinstellingen.

  • Mac-gebruikers: Klik op profielfoto en vervolgens op Voorkeuren > Geavanceerde gespreksinstellingen.

CSWV implementeren op BroadWorks

Webview Gespreksinstellingen installeren op XSP|ADP's

CSWV-toepassing moet zich op dezelfde XSP|ADP('s) bevinden als de host van de Xsi-Actions-interface in uw omgeving. Het is een onbeheerde toepassing op XSP|ADP, dus u moet een webarchiefbestand installeren en implementeren.

  1. Meld u aan bij cisco.com en zoek naar 'BWCallSettingsWeb' in het gedeelte software downloaden.

  2. Zoek en download de meest recente versie van het bestand.

    Bijvoorbeeld: BWCallSettingsWeb_1.8.2_1.war( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) was op het moment van schrijven het meest recent.

  3. Installeer, activeer en implementeer het webarchief volgens de configuratiehandleiding voor Cisco BroadWorks Xtended Service Platform voor uw XSP|ADP-versie. (Versie R24 is https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).

    1. Kopieer het .war-bestand naar een tijdelijke locatie op de XSP|ADP, zoals /tmp/.

    2. Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:

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

      De BroadWorks-softwaremanager valideert en installeert het bestand.

    3. [Optioneel] Verwijderen /tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist).

    4. Activeer de toepassing:

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      De naam en versie zijn verplicht voor elke toepassing, maar voor CSWV moet u ook een contextPath opgeven omdat het een onbeheerde toepassing is. U kunt alle waarden gebruiken die niet door een andere toepassing worden gebruikt, bijvoorbeeld: /callsettings.

    5. Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

  4. U kunt nu de URL voor gespreksinstellingen die u voor clients opgeeft, als volgt voorspellen:

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

    Opmerkingen:

    • U moet de trailing slash op deze URL opgeven wanneer u deze invoert in het clientconfiguratiebestand.

    • De XSP|ADP-FQDN moet overeenkomen met de FQDN voor Xsi-acties, omdat CSWV Xsi-acties moet gebruiken en CORS niet wordt ondersteund.

  5. Herhaal deze procedure voor andere XSP|ADP's in uw Webex voor Cisco BroadWorks-omgeving (indien nodig).

De toepassing Gespreksinstellingen Webview is nu actief op de XSP|ADP's.

Configureer de Webex-app om de webview met gespreksinstellingen te gebruiken

Zie de Webex voor Cisco BroadWorks-configuratiehandleiding voor meer informatie over clientconfiguratie.

Er is een aangepaste tag in het configuratiebestand van de Webex-app die u kunt gebruiken om de CSWV-URL in te stellen. Deze URL toont de gespreksinstellingen aan de gebruikers via de toepassingsinterface.

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

Configureer in de configuratiesjabloon van de Webex-app op BroadWorks de CSWV-URL in de tag %WEB_CALL_SETTINGS_URL_WXT%.

Als u de URL niet expliciet opgeeft, is de standaard leeg en is de pagina met gespreksinstellingen niet zichtbaar voor de gebruikers.

  1. Zorg ervoor dat u over de nieuwste configuratiesjablonen voor de Webex-app beschikt (zie Apparaatprofielen).

  2. Het doel voor webgespreksinstellingen instellen op csw:

    %WEB_CALL_SETTINGS_TARGET_WXT% csw

  3. Stel de URL voor webgespreksinstellingen voor uw omgeving in, bijvoorbeeld:

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

    U hebt deze waarde afgeleid bij het implementeren van de CSWV-toepassing.

  4. Het resulterende clientconfiguratiebestand moet als volgt worden ingevoerd:

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

     
    Elke verwijzing naar XSP omvat XSP of ADP.

Pushmeldingen voor gesprekken configureren in Webex voor Cisco BroadWorks

In dit document gebruiken we de term Call Notifications Push Server (CNPS) om een door XSP gehoste of door ADP gehoste toepassing te beschrijven die in uw omgeving wordt uitgevoerd. Uw CNPS werkt met uw BroadWorks-systeem om op de hoogte te zijn van binnenkomende gesprekken naar uw gebruikers en pusht meldingen van deze gesprekken naar de meldingsservices van Google Firebase Cloud Messaging (FCM) of Apple Push Notification Service (APN's).

Deze services melden de mobiele apparaten van Webex voor Cisco BroadWorks-abonnees dat ze inkomende gesprekken hebben op Webex.

Zie de functiebeschrijving van de pushserver voor meldingen voor meer informatie over NPS.

Een vergelijkbaar mechanisme in Webex werkt met Webex-berichten- en aanwezigheidsservices om meldingen naar de Google- (FCM) of Apple-meldingsservices (APNS) te pushen. Deze services brengen de mobiele Webex-gebruikers op hun beurt op de hoogte van inkomende berichten of aanwezigheidswijzigingen.


 

In dit gedeelte wordt beschreven hoe u NPS configureert voor de verificatieproxy wanneer de NPS nog geen andere apps ondersteunt. Als u een gedeelde NPS moet migreren om NPS-proxy te gebruiken, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruikenhttps://help.webex.com/nl5rir2/.

Overzicht van NPS-proxy

Voor compatibiliteit met Webex voor Cisco BroadWorks moet uw CNPS worden gepatcht ter ondersteuning van de NPS-proxyfunctie, Pushserver voor VoIP in UCaaS.

De functie implementeert een nieuw ontwerp in de pushserver voor meldingen om het beveiligingsprobleem van het delen van privésleutels voor pushmeldingscertificaten met serviceproviders voor mobiele clients op te lossen. In plaats van pushmeldingscertificaten en -sleutels te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een kortstondig pushmeldingstoken te verkrijgen van Webex voor Cisco BroadWorks-backend en gebruikt dit token voor verificatie met de Apple APN's en Google FCM-services.

De functie verbetert ook de mogelijkheid van de Notification Push Server om meldingen naar Android-apparaten te pushen via de nieuwe Google Firebase Cloud Messaging (FCM) HTTPv1 API.

APNS-overwegingen

Apple zal het op HTTP/1 gebaseerde binaire protocol over de Apple Push Notification-dienst na 31 maart 2021 niet langer ondersteunen. We raden u aan uw XSP|ADP te configureren om de op HTTP/2 gebaseerde interface voor APN's te gebruiken. Voor deze update moet uw XSP|ADP die de NPS host R22 of hoger uitvoeren.

Bereid uw NPS voor op Webex voor Cisco BroadWorks

1

Installeer en configureer een specifieke XSP (minimumversie R22) of Application Delivery Platform (ADP).

2

Installeer de NPS-verificatieproxypatches:

3

Activeer de toepassing Pushserver voor meldingen.

4

(Voor Android-meldingen) Schakel de FCM v1-API in op de NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.

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

6

Voeg een techsupport van de NPS XSP/ADP toe.

7

Op elke AS-server wordt het namedefs-bestand in /usr/local/broadworks/bw_base/conf moet worden geconfigureerd met SRV en A-records voor XSP/ADP-zoekopdrachten (Notification Push Server). Als er meerdere XSP/ADP zijn, voegt u voor elke zoekopdracht een vermelding toe.

Voorbeeld: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN EEN versie van 10.193.78.149


 

Na het instellen is een van de volgende opties vereist om de wijzigingen op te halen:

  1. Een restartbw wordt voorgevormd in een onderhoudsperiode.

  2. Via de Cisco BroadWorks CLI:

    R24 en ouder

    AS_CLI/ASDiagnostic/DNS> opnieuw laden

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> opnieuw laden

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> opnieuw laden

De volgende stappen

Als u een NPS opnieuw wilt installeren, gaat u naar NPS configureren om de verificatieproxy te gebruiken

Als u een bestaande Android-implementatie wilt migreren naar FCMv1, gaat u naar NPS migreren naar FCMv1

Configureer NPS om de verificatieproxy te gebruiken

Deze taak is van toepassing op een nieuwe installatie van NPS die is toegewezen aan Webex voor Cisco BroadWorks.

Als u de verificatieproxy wilt configureren op een NPS die met andere mobiele apps wordt gedeeld, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken ( https://help.webex.com/nl5rir2).

1

Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.

2

Maak het clientaccount aan op de 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: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get


 

De CiscoCI-uitgeverUrl moet ALTIJD een US CI-cluster zijn, ongeacht uw locatie. De standaardwaarde moet zijn:

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

Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):

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

(Voor Android-meldingen) Voeg de Android-toepassings-id toe aan de context van de FCM-toepassingen op de NPS.

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

5

(Voor Apple iOS-meldingen) Voeg de toepassings-id toe aan de context van de APNS-toepassingen en zorg ervoor dat u de verificatiesleutel weglaat. Stel deze in op leeg.

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

6

Configureer de volgende NPS-URL's:

XSP|ADP CLI-context

Parameter

Waarde

  • XSP|ADP_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|ADP_CLI/Applications/NotificationPushServer

    /APNS/Production>

url

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

7

Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:

XSP|ADP CLI-context

Parameter

Waarde

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen:

  1. Uitvoeren AS_CLI/System/PushNotification> get en controleer de waarde van enforceAllowedApplicationList. Als het true, moet u deze subtaak voltooien. Anders slaat u de rest van de deeltaak 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

Start de XSP|ADP opnieuw: bwrestart

10

Test gespreksmeldingen door gesprekken te voeren van een BroadWorks-abonnee naar twee mobiele Webex-gebruikers. Controleer of de gespreksmelding wordt weergegeven op iOS- en Android-apparaten.

NPS migreren naar FCMv1

Dit onderwerp bevat optionele procedures die u in Google FCM-console kunt gebruiken wanneer u een bestaande NPS-implementatie hebt die u naar FCMv1 moet migreren. Er zijn drie procedures:

UC-One-clients migreren naar FCMv1

Gebruik de onderstaande stappen in Google FCM-console om UC-One-clients te migreren naar Google FCM HTTPv1.


 

Als branding wordt toegepast op de client, moet de client de afzender-id hebben. Zie in de FCM-console Projectinstellingen > Cloud Messaging. De instelling wordt weergegeven in de aanmeldtabel voor het project.

Zie de Connect Mobile Branding Guide op 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? voor meer informatie. Raadpleeg de gcm_defaultSenderId parameter, die zich bevindt in het bestand Branding Kit, Resource folder, branding.xml met de onderstaande syntaxis:

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

  1. Meld u aan bij FCM-beheerder SDK op http://console.firebase.google.com.

  2. Selecteer de juiste Android-toepassing.

  3. Noteer de project-ID op het tabblad Algemeen

  4. Ga naar het tabblad Serviceaccounts om een serviceaccount te configureren. U kunt een nieuw serviceaccount maken of een bestaand serviceaccount configureren.

    Een nieuw serviceaccount maken:

    1. Klik op de blauwe knop om een nieuw serviceaccount aan te maken

    2. Klik op de blauwe knop om een nieuwe privésleutel te genereren

    3. Sleutel downloaden naar een veilige locatie

    Een bestaand serviceaccount hergebruiken:

    1. Klik op de blauwe tekst om bestaande serviceaccounts weer te geven.

    2. Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.

    3. Klik aan de rechterkant op het hamburgermenu en maak een nieuwe privésleutel aan.

    4. Download het json-bestand dat de sleutel bevat en sla het op naar een veilige locatie.

  5. Kopieer het json-bestand naar de XSP|ADP.

  6. Configureer de project-ID en:

    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. Configureer de toepassing:

    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. FCMv1 inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

SaaS-clients migreren naar FCMv1

Gebruik de onderstaande stappen op Google FCM Console als u SaaS-clients wilt migreren naar FCMv1.


 
Zorg ervoor dat u de procedure 'NPS configureren om verificatieproxy te gebruiken' al hebt voltooid.
  1. FCM uitschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

  3. FCM inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

ADP-server bijwerken

Gebruik de onderstaande stappen in Google FCM-console als u de NPS migreert om een ADP-server te gebruiken.

  1. Haal het JSON-bestand op van de Google Cloud-console:

    1. Ga op de Google Cloud Console naar de pagina Service Accounts.

    2. Klik op Selecteer een project, kies uw project en klik op Openen.

    3. Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.

    4. Selecteer een type Sleutel en klik op Aanmaken

      Het bestand wordt gedownload.

  2. FCM toevoegen aan de ADP-server:

    1. Importeer het JSON-bestand naar de ADP-server met de /bw/install opdracht.

    2. Meld u aan bij de ADP CLI en voeg project- en API-sleutel toe:

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

    3. Voeg vervolgens de toepassing en de sleutel toe:

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

    4. Controleer de configuratie:

      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

Uw partnerorganisatie configureren in Partner Hub

Uw BroadWorks-clusters configureren

[eenmaal per cluster]

Dit gebeurt om de volgende redenen:

  • Webex-cloud inschakelen om uw gebruikers te verifiëren met BroadWorks (via de door XSP|ADP gehoste verificatieservice).

  • Webex-apps inschakelen om de Xsi-interface te gebruiken voor gespreksbeheer.

  • Webex inschakelen om te luisteren naar door BroadWorks gepubliceerde CTI-gebeurtenissen (telefonische aanwezigheid en gespreksgeschiedenis).


 

De clusterwizard valideert de interfaces automatisch wanneer u ze toevoegt. U kunt de cluster blijven bewerken als een van de interfaces niet is gevalideerd, maar u kunt een cluster niet opslaan als er ongeldige invoer zijn.

We voorkomen dit omdat een onjuist geconfigureerde cluster problemen kan veroorzaken die moeilijk op te lossen zijn.

Wat u moet doen:

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Cluster toevoegen.

    Hiermee start u een wizard waarin u uw XSP|ADP-interfaces (URL's) levert. U kunt een poort toevoegen aan de interface-URL als u een niet-standaardpoort gebruikt.

  4. Geef dit cluster een naam en klik op Volgende.

    Het clusterconcept hier is slechts een verzameling van interfaces, meestal samengebracht op een XSP|ADP-server of -farm, waarmee Webex informatie van uw toepassingsserver (AS) kan lezen. U hebt mogelijk één XSP|ADP per AS-cluster of meerdere XSP|ADP's per cluster of meerdere AS-clusters per XSP|ADP. Schaalvereisten voor uw BroadWorks-systeem vallen hier buiten het bereik.

  5. (Optioneel) Een BroadWorks-gebruiker invoeren Accountnaam en Wachtwoord dat u weet dat u zich in het BroadWorks-systeem bevindt waarmee u verbinding maakt met Webex en klik vervolgens op Volgende.

    De validatietests kunnen dit account gebruiken om de verbindingen met de interfaces in het cluster te valideren.

  6. Voeg uw URL's voor XSI-acties en XSI-gebeurtenissen toe.

  7. Optioneel. Werk de DAS-URL bij met de URL van de apparaatactiveringsservice.

  8. Optioneel. Schakel het selectievakje Directe BroadWorks-verificatie inschakelen in als u wilt dat aanmeldingen bij BroadWorks rechtstreeks naar BroadWorks worden verzonden. Anders wordt verificatie naar BroadWorks via de Webex-gehoste IdP-proxyservice geproxy.

    Dit selectievakje is van invloed op deze aanmeldsituaties:

    • Aanmelding bij de gebruikersactiveringsportal: gebruikers moeten hun BroadWorks-aanmeldgegevens invoeren wanneer ze zich bij de portal aanmelden. De bovenstaande instelling bepaalt of de aanmelding rechtstreeks is naar BroadWorks of via de IdP-proxy.

    • Clientaanmelding: als BroadWorks-verificatie is geconfigureerd in de onboardsjabloon, bepaalt de bovenstaande instelling of de clientaanmelding bij de Webex-app rechtstreeks is naar BroadWorks of wordt geproxy via de IdP-proxy.

  9. Klik op Volgende.

  10. Ga als volgt te werk op de pagina CTI-interface:

    1. Voeg de CTI-URL en poort toe voor de CTI-interface waarmee u verbinding wilt maken.

    2. Optioneel. Schakel de schakelaar Gespreksgeschiedenis in en voer vervolgens uw BroadWorks-gebruikers-id in. Als deze optie is geselecteerd, worden BroadWorks-gespreksgeschiedenisgebeurtenissen gesynchroniseerd met de Webex-cloud. Gebruikers kunnen hun gespreksgeschiedenis bekijken in de Webex-app.

    3. Optioneel. Schakel de schakelaar Niet storen (NST) in en voer vervolgens uw BroadWorks-gebruikers-id in. Met deze optie worden NST-gebeurtenissen tussen Webex en BroadWorks gesynchroniseerd, zodat de functie op beide platforms hetzelfde werkt.

    4. Klik op Volgende.

  11. Voeg de URL van uw verificatieservice toe.

  12. Selecteer Verificatieservice met CI-tokenvalidatie.

    Voor deze optie is niet vereist dat mTLS de verbinding beschermt tegen Webex, omdat de verificatieservice het gebruikerstoken correct valideert met de Webex-identiteitsservice voordat het langlevende token aan de gebruiker wordt verstrekt.

  13. Controleer uw gegevens op het laatste scherm en klik op Maken. U zou een bericht met succes moeten zien.

    Partner Hub geeft de URL's door aan verschillende Webex-microservices die de verbindingen met de geleverde interfaces testen.

  14. Klik op Clusters weergeven en u moet uw nieuwe cluster zien en zien of de validatie is gelukt.

  15. De knop Aanmaken kan worden uitgeschakeld in het laatste (preview)scherm van de wizard. Als u de sjabloon niet kunt opslaan, geeft dit een probleem aan met een van de integraties die u zojuist hebt geconfigureerd.

    Deze controle hebben we doorgevoerd om fouten bij volgende taken te voorkomen. U kunt de wizard opnieuw doorlopen terwijl u uw implementatie configureert. Dit kan wijzigingen aan uw infrastructuur vereisen (bijv. XSP|ADP, load balancer of firewall), zoals beschreven in deze handleiding, voordat u de sjabloon kunt opslaan.

De verbindingen met uw BroadWorks-interfaces controleren

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Clusters weergeven.

  4. Partner Hub initieert verbindingstests van de verschillende microservices naar de interfaces in de clusters.

    Nadat de tests zijn voltooid, wordt op de pagina Clusterlijst het statusbericht weergegeven naast elk cluster.

    U moet groene succesberichten zien. Als u een rood foutbericht ziet, klikt u op de betreffende clusternaam om te zien welke instelling het probleem veroorzaakt.

  5. Optioneel. Selecteer een cluster als u bestaande instellingen voor dat cluster wilt zien, zoals XSI-acties, XSI-gebeurtenissen, DAS-URL en de instellingen van de CTI-interface.

Uw integratiesjablonen configureren

Onboardsjablonen zijn de manier waarop u gedeelde configuratie toepast op een of meer klanten terwijl u ze integreert via de inrichtingsmethoden. U moet elke sjabloon koppelen aan een cluster (dat u in het vorige gedeelte hebt gemaakt).

U kunt zoveel sjablonen maken als u nodig hebt, maar er kan slechts één sjabloon aan een klant worden gekoppeld.

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Sjabloon toevoegen.

    Hiermee start u een wizard waarin u de configuratie kunt leveren voor klanten die deze sjabloon gebruiken.

  4. Gebruik de vervolgkeuzelijst Cluster om het cluster te kiezen dat u met deze sjabloon wilt gebruiken.

  5. Voer een sjabloonnaam in en klik op Volgende.

  6. Configureer uw inrichtingsmodus met de volgende aanbevolen instellingen:

    Tabel 3. Aanbevolen inrichtingsinstellingen voor verschillende inrichtingsmodi

    Naam van instelling

    Flowthrough-inrichting met vertrouwde e-mails

    Flowthrough-inrichting zonder e-mails

    Zelfinrichting van de gebruiker

    BroadWorks-flow via inrichting inschakelen (inclusief inrichtingsaccountgegevens indien Ingeschakeld**)

    Aan

    Geef de accountnaam en het wachtwoord voor inrichting op volgens de BroadWorks-configuratie.

    Aan

    Geef de accountnaam en het wachtwoord voor inrichting op volgens de BroadWorks-configuratie.

    Uit

    Automatisch nieuwe organisaties maken in Control Hub

    Aan

    Aan

    Aan

    E-mailadres serviceprovider

    Selecteer een e-mailadres in de vervolgkeuzelijst (u kunt enkele tekens typen om het adres te vinden als het een lange lijst is).

    Dit e-mailadres identificeert de beheerder binnen uw partnerorganisatie aan wie gedelegeerde beheerderstoegang wordt verleend tot alle nieuwe klantorganisaties die met de onboardsjabloon zijn gemaakt.

    Land

    Kies welk land u voor deze sjabloon gebruikt.

    Het land dat u kiest, komt overeen met klantorganisaties die met deze sjabloon zijn gemaakt voor een bepaalde regio. Momenteel zou de regio (EMEAR) of (Noord-Amerika en de rest van de wereld) kunnen zijn. Zie de land-naar-regio toewijzingen in deze spreadsheet.

    Het land van de organisatie bepaalt de standaard internationale inbelnummers voor Cisco PSTN in Webex Meeting-sites. Raadpleeg het gedeelte Land van de Help-pagina voor meer informatie.

    BroadWorks-enterprisemodus actief

    Schakel dit in als de klanten die u met deze sjabloon inricht ondernemingen in BroadWorks zijn.

    Als het groepen zijn, laat deze schakelaar dan uit.

    Als u een mix van bedrijven en groepen in uw BroadWorks hebt, moet u verschillende sjablonen maken voor deze verschillende cases.

    Opmerkingen uit de tabel:

    • † Deze switch zorgt ervoor dat er een nieuwe klantorganisatie wordt gemaakt als het e-maildomein van een abonnee niet overeenkomt met een bestaande Webex-organisatie.

      Dit moet altijd zijn ingeschakeld, tenzij u een handmatig bestel- en uitvoeringsproces gebruikt (via Cisco Commerce Workspace) om klantorganisaties in Webex te maken (voordat u begint met het inrichten van gebruikers in die organisaties). Deze optie wordt vaak het model 'Hybride inrichting' genoemd en valt buiten het bereik van dit document.

    • ** 'Inrichtingsaccount' verwijst naar het BroadWorks-beheerdersaccount op systeemniveau. Op BroadWorks hebt u een beheerdersaccount met de volgende kenmerken nodig: Beheerderstype=Inrichting, Alleen-lezen=Uit.

  7. Selecteer het standaardservicepakket voor klanten met deze sjabloon (zie Pakketten in het gedeelte Overzicht); Basis, Standaard, Premium of Softphone.

    U kunt deze instelling voor individuele gebruikers overschrijven via Partner Hub.

  8. Optioneel. Schakel Gratis bellen via Cisco Webex uitschakelen in als u Webex-gesprekken wilt uitschakelen.

  9. Selecteer een van de volgende opties voor Configuratie voor deelnemen aan vergadering:

    • Cisco-inbelnummers (PSTN)

    • Door de partner verstrekte inbelnummers (BYoPSTN): als u deze optie selecteert, raadpleegt u de Bring Your Own PSTN Solution Guide for Webex for Cisco BroadWorks voor gedetailleerde informatie over het configureren van deze optie.

  10. Klik op Volgende.

  11. Er zijn twee benaderingen voor het inrichten van abonnees met betrekking tot hoe hun identiteiten worden geverifieerd - met behulp van vertrouwde e-mails of niet-vertrouwde e-mails.

    In de workflow voor vertrouwde e-mail geven gebruikers e-mailadressen door aan de partner die ze toevoegt in BroadWorks. Als partner bent u verantwoordelijk voor het inrichten van het e-mailadres als onderdeel van de doorstroommethode of de API-methode.


     

    Het wordt sterk aanbevolen om de vertrouwde inrichtingsmethode te gebruiken, omdat deze ervoor zorgt dat alle abonnees volledig door u als partner worden ingericht en er geen actie is vereist van de eindgebruikers.

    In het geval van niet-vertrouwde e-mail moeten gebruikers hun e-mails verifiëren voordat ze deze inrichten, of kunnen gebruikers zichzelf activeren.

    In het niet-vertrouwde geval zijn er verschillende inrichtingsmodi op basis van de verificatie-instellingen in de onderstaande tabel:

    Tabel 4. Aanbevolen verificatie-instellingen voor gebruikers voor niet-vertrouwde inrichtingsmodi

    Naam van instelling

    Flowthrough-inrichting zonder e-mails

    Zelfinrichting van de gebruiker

    Beheerder eerst inrichten

    Aanbevolen*

    Niet van toepassing

    Gebruikers toestaan zichzelf te activeren

    Niet van toepassing

    Vereist

    • Opmerkingen uit de tabel:

    • * Elke klantorganisatie in Webex moet ten minste één gebruiker met een beheerdersrol hebben. De eerste gebruiker aan wie u geïntegreerde IM&P in BroadWorks toewijst, neemt de rol van klantbeheerder als er een nieuwe klantorganisatie is gemaakt in Webex. Als serviceprovider wilt u mogelijk controle hebben over wie de rol krijgt. Als u deze instelling controleert, wordt het voltooien van de activering van gebruikers geblokkeerd totdat de eerste gebruiker die u hebt ingericht, is geactiveerd. Als u deze instelling uitschakelt, wordt de eerste gebruiker die in de nieuwe organisatie actief wordt, de klantbeheerder.

  12. Klik op Volgende.

  13. Selecteer de standaard verificatiemodus (BroadWorks-verificatie of Webex-verificatie) om u aan te melden bij Webex.


     
    Deze instelling heeft geen invloed op het aanmelden van gebruikers bij de User Activation Portal. Gebruikers moeten hun BroadWorks-gebruikers-id en -wachtwoord gebruiken wanneer ze zich aanmelden bij de portal, ongeacht hoe de onboardsjabloon is geconfigureerd.

     
    Deze instelling wordt alleen toegepast op nieuw gemaakte klantorganisaties. Als partnerbeheerders een nieuwe verificatie-instelling proberen toe te passen op bestaande klantorganisaties, zijn de bestaande instellingen van toepassing zodat bestaande gebruikers geen toegang verliezen. Als u de verificatiemodus voor bestaande klantorganisaties wilt wijzigen, moet u een ticket openen met Cisco TAC.

    (Zie Verificatiemodus in het gedeelte Uw omgeving voorbereiden).

  14. Klik op Volgende.

  15. Voor Voorkeuren configureert u het volgende:

    1. Kies of u de e-mailadressen van gebruikers vooraf wilt invullen op de aanmeldpagina.

      U moet deze optie alleen gebruiken als u BroadWorks-verificatie hebt geselecteerd en de e-mailadressen van de gebruikers ook in het kenmerk Alternatieve id in BroadWorks hebt geplaatst. Anders moeten ze hun BroadWorks-gebruikersnaam gebruiken. De aanmeldpagina biedt een optie om de gebruiker te wijzigen, indien nodig, maar dit kan leiden tot aanmeldproblemen.

    2. Als u adreslijstsynchronisatie wilt inschakelen, stelt u de schakelaar Telefoonlijstsynchronisatie inschakelen voor alle nieuwe klantorganisaties in op Aan.

      Met deze optie kan Webex BroadWorks-contactpersonen in de klantorganisatie lezen, zodat gebruikers deze kunnen vinden en bellen vanuit de Webex-app.

    3. Voer een partnerbeheerder in.

      Deze naam wordt gebruikt in het geautomatiseerde e-mailbericht van Webex, waarin gebruikers worden uitgenodigd om hun e-mailadres te valideren.

    4. Zorg ervoor dat de schakelaar E-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties is ingeschakeld (de standaardinstelling is ingeschakeld).

    5. Klik op Volgende.

  16. Controleer uw gegevens op het laatste scherm. U kunt op de navigatieknoppen boven aan de wizard klikken om terug te gaan en eventuele details te wijzigen. Klik op Maken.

    U zou een bericht met succes moeten zien.

  17. Klik op Sjablonen weergeven en u moet uw nieuwe sjabloon met andere sjablonen in de lijst zien.

  18. Klik op de sjabloonnaam om de sjabloon indien nodig te wijzigen of te verwijderen.

    U hoeft de gegevens van het inrichtingsaccount niet opnieuw in te voeren. De velden Leeg wachtwoord/Wachtwoordbevestiging zijn er om de referenties te wijzigen als dat nodig is, maar laat ze leeg om de waarden te behouden die u aan de wizard hebt opgegeven.

  19. Voeg meer sjablonen toe als u verschillende gedeelde configuraties hebt die u aan klanten wilt aanbieden.


     

    Houd de pagina Sjablonen weergeven open, omdat u mogelijk sjabloongegevens nodig hebt voor een volgende taak.

Toepassingsserver configureren met inrichtingsservice-URL


 

Deze taak is alleen vereist voor flow door inrichting.

Patch Application Server (alleen R22, R23 en R24)

  1. Als u dit nog niet hebt gedaan, past u de volgende patch toe die van toepassing is op uw versie:.


     
    Zie BroadWorks-softwarevereisten in het gedeelte Referentie voor een volledige lijst met BroadWorks-patches die de vereiste vormen voor de implementatie van Webex voor Cisco BroadWorks.
  2. Wijzigen in de Maintenance/ContainerOptions context.

  3. De parameter voor de inrichtings-URL inschakelen:

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

De inrichtings-URL('s) ophalen in Partner Hub

Raadpleeg de Beheerhandleiding Cisco BroadWorks Application Server Command Line Interface voor meer informatie (Interface > Berichten en service > Geïntegreerde IM&P) over de AS-opdrachten.

  1. Meld u aan bij Partner Hub en ga naar Instellingen > BroadWorks-gesprekken.

  2. Klik op Sjablonen weergeven.

  3. Selecteer de sjabloon die u gebruikt om de abonnees van deze onderneming/groep in te richten in Webex.

    De sjabloondetails worden weergegeven in een flyout-deelvenster aan de rechterkant. Als u nog geen sjabloon hebt gemaakt, moet u dit doen voordat u de inrichtings-URL kunt krijgen.

  4. Kopieer de URL van de inrichtingsadapter.

Herhaal dit voor andere sjablonen als u er meer hebt dan één.

(Optie) Systeembrede inrichtingsparameters configureren op toepassingsserver


 

Mogelijk wilt u het systeembrede inrichtings- en servicedomein niet instellen als u UC-One SaaS gebruikt. Zie Beslissingspunten in het gedeelte Uw omgeving voorbereiden.

  1. Meld u aan bij de toepassingsserver en configureer de interface voor berichten.

    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. De geïntegreerde IMP-interface activeren:

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

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


 

U moet de volledig gekwalificeerde naam invoeren voor de provisioningURL parameter, zoals deze is gegeven in Control Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in de /etc/hosts bestand op het AS.

(Optie) Inrichtingsparameters per onderneming configureren op toepassingsserver

  1. Open in de BroadWorks-gebruikersinterface de onderneming die u wilt configureren en ga naar Services > Geïntegreerde IM&P.

  2. Selecteer Servicedomein gebruiken en voer een dummywaarde in (Webex negeert deze parameter. U kunt dit gebruiken example.com).

  3. Selecteer Messaging Server gebruiken.

  4. Plak in het veld URL de inrichtings-URL die u van uw sjabloon hebt gekopieerd in Partner Hub.


     

    U moet de volledig gekwalificeerde naam invoeren voor de provisioningURL parameter, zoals deze is gegeven in Partner Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in de /etc/hosts bestand op het AS.

  5. Voer in het veld Gebruikersnaam een naam in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.

  6. Voer een wachtwoord in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.

  7. Voor Standaard gebruikersidentiteit voor IM&P-id selecteert u Primair.

  8. Klik op Toepassen.

  9. Herhaal dit voor andere bedrijven die u wilt configureren voor flow door inrichting.

Inrichtingsgegevens gebruiker

Zie Gebruikersvoorzieningen voor serviceproviders voor informatie over de gebruikersgegevens die worden uitgewisseld tussen BroadWorks en Webex tijdens het inrichten van gebruikers.

Controle-API voorafgaand aan inrichting van partner

De API Pre-Provisioning Check helpt beheerders en verkoopteams door te controleren op fouten voordat u een klant of abonnee inricht voor een pakket. Gebruikers of integraties die zijn geautoriseerd door een gebruiker met de rol Volledige partnerbeheerder kunnen deze API gebruiken om ervoor te zorgen dat er geen conflicten of fouten zijn met de pakketinrichting voor een bepaalde klant of abonnee.

De API controleert of er conflicten zijn tussen deze klant/abonnee en bestaande klanten/abonnees op Webex. De API kan bijvoorbeeld fouten veroorzaken als de abonnee al is ingericht voor een andere klant of partner, als het e-mailadres al bestaat voor een andere abonnee of als er conflicten zijn tussen de inrichtingsparameters en wat er al bestaat in Webex. Dit geeft u de mogelijkheid om deze fouten op te lossen voordat u inricht, waardoor de kans op een succesvolle inrichting groter wordt.

Zie voor meer informatie over de API: Ontwikkelaarshandleiding van Webex voor groothandels

Als u de API wilt gebruiken, gaat u naar: Een Wholesale Subscriber-inrichting vooraf controleren


 

Als u toegang wilt krijgen tot een inrichtingsdocument voor groothandels voor abonnees, moet u zich aanmelden bij de https://developer.webex.com/-portal.

Partner SSO - SAML

Hiermee kunnen partnerbeheerders SAML SSO configureren voor nieuw gemaakte klantorganisaties. Partners kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren, evenals op hun eigen werknemers.


 
De onderstaande stappen voor Partner-SSO zijn alleen van toepassing op nieuw gemaakte klantorganisaties. Als partnerbeheerders proberen Partner SSO toe te voegen aan een bestaande klantorganisatie, blijft de bestaande verificatiemethode behouden om te voorkomen dat bestaande gebruikers de toegang verliezen. Als u partner-SSO wilt toevoegen aan een bestaande organisatie, moet u een ticket openen met Cisco TAC.
  1. Controleer of de provider van de externe identiteitsprovider voldoet aan de vereisten die worden vermeld in het gedeelte Vereisten voor identiteitsproviders van Integratie van eenmalige aanmelding in Control Hub.

  2. Open een serviceaanvraag met Cisco TAC. TAC moet een vertrouwensrelatie opbouwen tussen de externe identiteitsprovider en de Cisco Common Identity-service. .


     
    Als uw IdP de passEmailInRequest in te schakelen, zorg ervoor dat u deze vereiste in het serviceverzoek opneemt. Raadpleeg uw IdP als u niet zeker weet of deze functie vereist is.
  3. Upload het CI-metagegevensbestand dat TAC aan uw identiteitsprovider heeft geleverd.

  4. Configureer een integratiesjabloon. Selecteer Partnerverificatie voor de instelling Verificatiemodus. Voer voor de entiteits-id van de IDP-provider de entiteits-id in vanuit de XML-metagegevens van de SAML van de externe identiteitsprovider.

  5. Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.

  6. Precies dat de gebruiker kan inloggen.

Partner-SSO - OpenID Connect (OIDC)

Hiermee kunnen partnerbeheerders OIDC SSO configureren voor nieuw gemaakte klantorganisaties. Partners kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren, evenals op hun eigen werknemers.


 

De onderstaande stappen om Partner SSO OIDC in te stellen, zijn alleen van toepassing op nieuw gemaakte klantorganisaties. Als partnerbeheerders proberen het standaard verificatietype te wijzigen in Partner SSO OIDC in een bestaande tempel, zijn de wijzigingen niet van toepassing op de klantorganisaties die al zijn geïntegreerd met de sjabloon. Als u partner-SSO wilt toevoegen aan een bestaande klantorganisatie, moet u een ticket openen met Cisco TAC.

  1. Open een serviceaanvraag met Cisco TAC met de details van de OpenID Connect-id-provider. Hieronder staan verplichte en optionele IDP-kenmerken. TAC moet de id-provider instellen op de CI en de omleidings-URI opgeven die moet worden geconfigureerd op de id-provider.

    Kenmerk

    Vereist

    Beschrijving

    Naam IDP

    Ja

    Unieke maar hoofdlettergevoelige naam voor OIDC IdP-configuratie, kan bestaan uit letters, cijfers, koppeltekens, onderstrepingstekens, tildes en stippen en de maximale lengte is 128 tekens.

    OAuth-client-id

    Ja

    Wordt gebruikt om OIDC IdP-verificatie aan te vragen.

    OAuth-clientgeheim

    Ja

    Wordt gebruikt om OIDC IdP-verificatie aan te vragen.

    Lijst met scopes

    Ja

    Lijst met scopes die worden gebruikt om OIDC IdP-verificatie aan te vragen, opgesplitst per ruimte, bijvoorbeeld 'openid e-mailprofiel' Moet openid en e-mail bevatten.

    Autorisatieeindpunt

    Ja als DiscoveryEndpoint niet is verstrekt

    URL van het OAuth 2.0-verificatie-eindpunt van de IdP.

    tokenEindpunt

    Ja als DiscoveryEndpoint niet is verstrekt

    URL van het OAuth 2.0-tokeneindpunt van de IdP.

    Eindpunt van detectie

    Nee

    URL van het Discovery-eindpunt van de IdP voor detectie van OpenID-eindpunten.

    userInfoEindpunt

    Nee

    URL van het UserInfo-eindpunt van de IdP.

    Eindpunt sleutelset

    Nee

    URL van het eindpunt van de JSON-websleutelset van de IdP.


     

    Naast de bovenstaande IDP-attributen moet de id van de partnerorganisatie worden opgegeven in het TAC-verzoek.

  2. Configureer de omleidings-URI op de OpenID connect-id-provider.

  3. Configureer een integratiesjabloon. Voor de instelling Verificatiemodus selecteert u Partnerverificatie met OpenID Connect en voert u de IDP-naam in die tijdens de installatie van de IDP is opgegeven als de entiteits-id van OpenID Connect IDP.

  4. Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.

  5. Zeer dat de gebruiker zich kan aanmelden met de SSO-verificatieflow.

Gesprekscorrelatie-id inschakelen

Als u Webex voor Cisco BroadWorks wilt uitvoeren, moet u de gesprekscorrelatie-id inschakelen. Deze instelling is vereist voor veel gespreksfuncties, waaronder gespreksopname, groepsgesprek opnemen, directie en directie-assistent.

Gebruik de CLI om de functie in te schakelen op alle AS- en XSP|ADP-interfaces.

  • Voer de volgende opdrachten uit op AS-interfaces. Hierdoor kan het AS de X-BroadWorks-Correlation-Info SIP-koptekst:

    AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true

    AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true

  • Het enableCallCorrelationID parameter die is gekoppeld aan de toepassing Xsi-Actions wordt gebruikt om de opname van informatie over gesprekscorrelatie in Xsi-Actions-logboeken te beheren. Het wordt aanbevolen om enableCallCorrelationID ingeschakeld met de volgende opdracht op XSP|ADP-interfaces:

    XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true

Zie voor meer informatie over de gesprekscorrelatie-id de functiebeschrijving Cisco BroadWorks-gesprekscorrelatie-id.

Synchroniseren met Directory

Telefoonlijstsynchronisatie zorgt ervoor dat Webex voor Cisco BroadWorks-gebruikers de Webex-telefoonlijst kunnen gebruiken om elke belentiteit te bellen vanaf de BroadWorks-server. Wanneer deze functie is ingeschakeld, wordt de volledige telefoonlijst van de BroadWorks-server gesynchroniseerd met de Webex-telefoonlijst. Gebruikers kunnen toegang krijgen tot de telefoonlijst vanuit de Webex-app en een gesprek plaatsen naar elke belentiteit vanaf de BroadWorks-server.

Als u adreslijstsynchronisatie wilt inschakelen, gaat u naar Adreslijstsynchronisatie in Webex voor Cisco BroadWorks.


 
Webex voor Cisco BroadWorks-flowthrough-inrichting voegt berichtengebruikers en bijbehorende gespreksinformatie van de BroadWorks-server toe aan het Webex-platform. Telefoonlijsten, niet-berichtengebruikers en niet-gebruikersentiteiten zijn echter niet opgenomen (bijvoorbeeld een conferentieruimte-telefoon, faxapparaat of nummer van de Hunt-groep). Als u adreslijstsynchronisatie inschakelt, wordt gegarandeerd dat alle bellende entiteiten worden toegevoegd aan het Webex-platform.

Uniforme gespreksgeschiedenis

Wanneer Unified Call History is ingeschakeld, worden BroadWorks-gespreksgebeurtenissen gesynchroniseerd met de Webex-cloud en worden ze onderdeel van de Webex Unified Call- en Meetings-geschiedenis die wordt weergegeven in de Webex-app. Gebruikers kunnen hun eigen gedetailleerde gespreksgeschiedenis en vergaderingsgeschiedenis bekijken vanuit de Webex-app.

Unified Call History kan worden ingeschakeld door beheerders op partnerniveau in Partner Hub op clusterbasis. Wanneer deze functie is ingeschakeld, synchroniseert de BroadWorks-implementatie de volgende gespreksgebeurtenissen met de Webex-cloud:

  • Gespreksgeschiedenisgebeurtenissen: deze gebeurtenissen worden gebruikt om een gedetailleerde Unified-gespreksgeschiedenis op te bouwen

  • Hookstatusgebeurtenissen: Unified Call History bevat hookstatusoptimalisaties die de hoeveelheid netwerkbandbreedte voor Telephony Presence-updates verlagen

Vereisten voor Unified Call History

Voordat u Unified Call History kunt configureren, moet u ervoor zorgen dat u uw systeem hebt gepatcht. Deze functie is afhankelijk van de volgende BroadWorks-patches die worden geïnstalleerd:

Voor R22:

Voor R23:

Voor R24:


 
Voor de volledige lijst met BroadWorks-patches die u moet installeren als voorwaarde om Webex voor Cisco BroadWorks uit te voeren, raadpleegt u BroadWorks-softwarevereisten in het gedeelte Referentie.

Naast het patchen van uw systeem, wordt het clientconfiguratiebestand ( config-wxt.xml) moet de volgende tagset hebben: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>

Als u Hunt-groep, Call Center en andere omleidingsinformatie in de Unified-gespreksgeschiedenis wilt hebben, moeten de volgende Broadworks-patches zijn geïnstalleerd en actief zijn:

Voor R23:

  • AP.as.23.0.1075.ap383346

  • AP.as.23.0.1075.ap383994

Voor R24:

  • AP.as.24.0.944.ap383346

  • AP.as.24.0.944.ap383994

Als u informatie over de directie-assistent in de Unified-gespreksgeschiedenis wilt hebben, moeten de volgende Broadworks-patches zijn geïnstalleerd en actief zijn:

Voor R24:

  • AP.as.24.0.944.ap380052

  • AP.as.24.0.944.ap384239

  • ADP met Xsi-Events-24_2022.06 of hoger

Naast de Broadworks-patches moet adreslijstsynchronisatie ook zijn ingeschakeld voor de Unified-gespreksgeschiedenis van Executive-Assistant.


 

Wanneer u Gespreksgeschiedenis of NST-synchronisatie inschakelt, verzendt Webex CTI-abonnementsvernieuwingsaanvragen voor alle gebruikers onder het cluster. Afhankelijk van het aantal gebruikers kan dit tot enkele uren duren. Het wordt aanbevolen geen onderhoudsactiviteiten van Broadworks uit te voeren tijdens dezelfde onderhoudsperiode.

Gespreksgeschiedenis inschakelen (nieuw cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een nieuw cluster, raadpleegt u de stappen voor het toevoegen van een cluster in Uw partnerorganisatie configureren in Partner Hub.

Gespreksgeschiedenis inschakelen (bestaand cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een bestaand cluster, volgt u de volgende stappen:

  1. Meld u aan bij Partnerhub op admin.webex.com.

  2. Ga naar Instellingen en selecteer een bestaand cluster.

  3. Controleer of de clusterverbinding goed is. In het rechterdeelvenster moet een groen vinkje worden weergegeven met Connection established.

    Als dit niet wordt weergegeven, voert u onder Connnections controleren (optioneel) de BroadWorks-gebruikers-id en het BroadWorks-wachtwoord in en klikt u op Controleren om te controleren of de verbinding goed is.

  4. Schakel het selectievakje Gespreksgeschiedenis inschakelen in.

  5. Klik op Opslaan.

Interacties van functies

De volgende functieinteracties bestaan voor Unified Call History:

  • Unified Call History wordt niet ondersteund voor gebruikers die zijn geconfigureerd in BroadWorks met routelijsten of directe routes. Wanneer deze situatie bestaat, worden gebeurtenissen voor gespreksgeschiedenis en haakstatus niet naar de Webex-app verzonden.

  • Unified Call History wordt niet ondersteund bij toestelbellen. Gesprekken die zijn geplaatst via toestelbellen worden mogelijk niet correct weergegeven in de gespreksgeschiedenis.

Gespreksgeschiedenis weergeven in de Webex-app

Eindgebruikers kunnen hun Unified Call History openen en bekijken vanuit de Webex-app. Voor meer informatie raadpleegt u: Webex | Gespreks- en vergadergeschiedenis weergeven.

Unified Call History uitschakelen

Nadat u Unified Call History hebt ingeschakeld op een cluster, kunt u de functie niet zelf uitschakelen. Als u de functie wilt uitschakelen, neemt u contact op met het Cisco Technical Assistance Center (TAC).

Indicatie Visuele Spam

De Webex-app ondersteunt een visuele indicatie van spamgesprekken in de gesprekstoast wanneer het gesprek wordt weergegeven aan de gebelde en in de Unified Call History-records wanneer BroadWorks wordt bijgewerkt om de beller-id te valideren via het STIR/SHAKEN-framework. Deze functie hebben:

  1. Schakel Unified Call History in zoals beschreven in het vorige gedeelte.
  2. De volgende patches moeten geïnstalleerd en actief zijn:
    • AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
    • of minimaal AS-25_Rel_2022.12
  3. De functie moet geactiveerd worden via de AS CLI:
    • AS_CLI/System/ActivatableFeature> 104112 activeren
    • AS_CLI/System/StirShaken> enableVerification true instellen
  4. Broadworks moet worden geconfigureerd voor het ondertekenen, labelen en verifiëren van STIR-SHAKEN zoals beschreven in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification

Wanneer BroadWorks correct is geconfigureerd, wordt een nieuwe koptekst X-Cisco-CallerId-Disposition toegevoegd in INVITE-verzoeken die naar Cisco-clients worden verzonden en wordt een nieuwe veldbellerIdDisposition toegevoegd aan de bestaande gespreksgeschiedenisgebeurtenissen die via de CTI-interface naar de Webex-cloud worden verzonden. Webex-apparaten gebruiken deze informatie om een visuele spamindicatie te geven in de gesprekspresentatie en de Unified Call History van de gebelde.

Belleridentificatie en omleiding van gesprekken

Identificatie beller

Wanneer de Webex-app een gesprek ontvangt, wordt geprobeerd te identificeren wie de beller is en wordt deze informatie weergegeven in de melding voor een binnenkomend gesprek, in het gespreksvenster en nadat het gesprek is voltooid, in de gespreksgeschiedenis en voicemail.

De Webex-app probeert de beller-id te vinden door het inkomende telefoonnummer te koppelen aan de telefoonnummers van contactpersonen die in verschillende bronnen zijn gevonden. De Webex-app gebruikt de volgende bronnen in deze volgorde. Zodra het vindt het in een bron zal het niet proberen om ergens anders te zoeken.


 

Als er meerdere exemplaren van een nummer in één bron worden gevonden, wordt niet geprobeerd er een te kiezen. In dit geval wordt er geen beller-id weergegeven.

  • Webex Common Identity (CI) die gebruikers van uw organisatie bevat.

  • Persoonlijke contactpersonen en contactpersonen binnen de organisatie. Persoonlijke contactpersonen zijn zichtbaar op het tabblad Contactpersonen.

  • Lokaal adresboek. In Windows - Outlook-toepassing, in Mac - Mac-contactpersonen, in iOS - iPhone-contactpersonen, in Android - Android-contactpersonen.

Als er geen overeenkomst is gevonden met het inkomende telefoonnummer, gebruikt de app de weergavenaam in de SIP FROM-koptekst, indien beschikbaar. Anders wordt het gebruikersnaamgedeelte van de SIP-URI uit de koptekst SIP From als laatste redmiddel gebruikt.

Voor extern gespreksbeheer (d.w.z. Deskphone Control Mode) wordt XSI-informatie gebruikt, waarbij de BWKS-id of het toestel wordt gebruikt, geëxtraheerd uit informatie van externe partijen in de XSI-gebeurtenis. Als informatie van externe partijen niet beschikbaar is, wordt P-Asserted Identity (PAI) (indien geconfigureerd) gebruikt.

Gesprekken omleiden

Als een gesprek is omgeleid of doorgeschakeld, probeert de app te laten zien wie de beller is en hoe deze is doorgeschakeld in de gespreksmelding en de gespreksgeschiedenis.

  • Gesprek doorgeschakeld: Hier wordt het nummer weergegeven dat het gesprek heeft doorgeschakeld.

  • Hunt-groep: Hier wordt de naam weergegeven van de Hunt-groep die het gesprek heeft doorgeschakeld.

  • Callcenterwachtrij: Hier wordt de naam weergegeven van de wachtrij die het gesprek heeft doorgeschakeld.

  • Directie-assistent: Hier wordt de naam van de directeur weergegeven waarvoor het gesprek binnenkomt.

Uitzonderingen:

  • Voor interne gesprekken in de gesprekswachtrij, waarbij een agent een interne partij terugbelt, ziet de externe partij niet de naam van de gesprekswachtrij, maar de naam van de agent die deze belt.

Gesprek elders beantwoord:

Voor Hunt-groepen of gesprekswachtrijen die zijn ingesteld met gelijktijdige routering, zien agenten een gesprek dat elders in de gespreksgeschiedenis wordt beantwoord als een andere agent het gesprek opneemt. Voor Hunt-groepen of gesprekswachtrijen met opeenvolgende routering of in een overloop worden gesprekken weergegeven als gemiste oproep in de gespreksgeschiedenis als ze door een andere agent worden beantwoord.

Weergave van gedeelde lijn

Met de weergave van gedeelde lijn kunnen lijnen van andere gebruikers worden ingesteld als gedeelde lijnen op het apparaat voor eindgebruikers. De configuratie van de gedeelde lijn voor de Webex-app is vergelijkbaar met de configuratie van de gedeelde lijn voor bureautelefoons. Met deze specifieke functie kunt u weergaven voor gedeelde lijnen toewijzen aan de Webex-app van de eindgebruiker.

Deze functie biedt gebruikers de voordelen om gesprekken op het toestelnummer van een andere gebruiker rechtstreeks vanuit de Webex-app af te handelen.

  • U kunt de weergave van gedeelde lijn alleen instellen voor de bureaubladversie van een Webex-app.

  • U kunt maximaal 10 lijnen toevoegen, inclusief de primaire lijn Webex-app .

  • U kunt een workspace-lijn niet toewijzen als gedeelde lijn.

  • Een gebruiker kan niet tegelijkertijd met gedeelde lijnen worden ingericht met de service Executive Assistant.

  • De primaire lijnpoort van een gebruiker mag niet worden gewijzigd in een gedeelde lijn.

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

Pleister 1: Eigenaarsmarkering in apparaatlijst ter ondersteuning van gedeelde lijnen van Webex-client

R23 zonder ADP:

  • AP.as.23.0.1075.ap384179

  • AP.xsp.23.0.1075.ap384179

R23 met ADP:

  • AP.as.23.0.1075.ap384179

  • Xsi-Actions-23_2022.10

R24:

  • ALS: AP.as.24.0.944.ap384179

  • Xsi-Actions-24_2022.10

R25:

  • ALS: RI versie Rel_2022.10_1.310

  • Xsi-Actions-25_2022.10

Pleister 2: Patches voor het verhogen van het aantal poorten op apparaatprofieltypen (in dit geval voor de desktopclient: Business Communicator).

  • RI versie Rel_2022.10_1.310

Niet storen (NS)-synchronisatie

Synchronisatie Niet storen (NST) brengt de NST-instellingen op één lijn tussen Webex en BroadWorks door de NST-status tussen de twee platforms te synchroniseren. Als een gebruiker bijvoorbeeld Niet storen inschakelt vanuit de Webex-app, wordt die status gesynchroniseerd met BroadWorks-gespreksapparaten. Als gevolg daarvan gaat de bij BroadWorks geregistreerde bureautelefoon van de gebruiker niet over wanneer iemand deze probeert te bellen. Als een gebruiker NST instelt vanaf een bureautelefoon, wordt de status ook gesynchroniseerd met de Webex-app. Zonder deze functie worden NST-updates van het ene platform niet herkend door het andere platform.

NST-synchronisatie wordt toegepast op clusterniveau BroadWorks en kan door een partnerbeheerder worden ingeschakeld in Partnerhub.

Voorwaarden

Zorg ervoor dat de volgende patches worden toegepast op de AS en XSP|ADP. Pas alleen de patches toe voor uw BroadWorks-versie.

Voor versie 22:

  • AS-pleister: AP.as.22.0.1123.ap382615, AP.as.22.0.1123.ap382838

  • XSP|ADP-pleister: AP.xsp.22.0.1123.ap382615, AP.xsp.22.0.1123.ap382838

Voor versie 23:

  • AS-pleister: AP.as.23.0.1075.ap382615, AP.as.23.0.1075.ap382838

  • XSP|ADP-pleister: AP.xsp.23.0.1075.ap382615, AP.xsp.23.0.1075.ap382838

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

Voor versie 24:

  • AS-pleister: AP.as.24.0.944.ap382615, AP.as.24.0.944.ap382838

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

Nadat u de patches hebt aangebracht, activeert u functie 25433 op de AS:

AS_CLI/System/ActivatableFeature> activate 25433

Synchronisatie van apparaatfunctietoetsen configureren in BroadWorks. Zorg ervoor dat de telefoon SIP SUBSCRIBE/NOTIFY ondersteunt voor het gebeurtenispakket 'as-feature-event'. Zie Functietoetssynchronisatie voor Cisco BroadWorks-apparaten voor meer informatie.

NST-synchronisatie inschakelen (bestaand cluster)

  1. Aanmelden bij Partner Hub

  2. Klik op Instellingen.

  3. Klik op Cluster weergeven en selecteer het juiste BroadWorks-cluster.

  4. Schakel de schakelaar Niet storen (NST) in.

  5. Voer uw BroadWorks-gebruikers-id in en klik op Enable.

    Het systeem valideert dat het BroadWorks-cluster de juiste patches heeft om NST-synchronisatie te ondersteunen. Als de validatie mislukt, wordt de knop Opslaan uitgeschakeld.

  6. Als de validatie slaagt, klik dan op Save.


 
  • Zodra NST synchroniseren is ingeschakeld, vernieuwt Webex alle gebruikersabonnementen om het gebeurtenispakket Niet storen op te nemen. Afhankelijk van het aantal gebruikers kan het enkele uren duren voordat dit proces is voltooid.

  • NST-synchronisatie inschakelen is een eenrichtingsschakelaar. Zodra de functie is ingeschakeld, kunt u deze niet zelf uitschakelen.

NST-synchronisatie inschakelen (nieuw cluster)

U kunt de functie ook inschakelen tijdens het maken van het cluster. Zie 'Uw BroadWorks-clusters configureren' in Uw partnerorganisatie configureren in Partner Hub voor meer informatie.

NST-synchronisatie uitschakelen

U kunt NST-synchronisatie niet zelf uitschakelen. Als u de functie wilt uitschakelen, maakt u een BEMS-engineeringcase met de volgende informatie:

  • Gezin: Spark-service

  • Product: Bellen in Webex (Webex voor BroadWorks)

  • Onderdeel: WxBW- Inrichting

  • In het BEMS-geval moet worden vermeld dat Niet storen synchroniseren moet worden uitgeschakeld voor een partner. De case moet partnerId en BroadWorks clusterId bevatten.

Usecases

NST instellen en wissen in relatie tot werkstatus

Gespreksopname

Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopname.

Tabel 6. Opnamemodi

Opnamemodi

Beschrijving

Bedieningselementen/indicatoren die worden weergegeven in de Webex-app

Altijd

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker is niet in staat om te beginnen met of stoppen met opnemen.

  • Visuele indicator dat de opname bezig is

Altijd met onderbreken/hervatten

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker kan een opname onderbreken en hervatten.

  • Visuele indicator dat de opname bezig is

  • Knop Opname onderbreken

  • Knop Opname hervatten

OnDemand

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht, maar de opname wordt verwijderd tenzij de gebruiker op Opname starten drukt.

Als de gebruiker een opname start, blijft de volledige opname van de gespreksinstellingen behouden. Nadat de gebruiker de opname heeft gestart, kan de gebruiker de opname ook onderbreken en hervatten

  • Knop Opname starten

  • Knop Opname onderbreken

  • Knop Opname hervatten

OnDemand met door gebruiker geïnitieerde start

De opname wordt niet gestart tenzij de gebruiker de optie Opname starten selecteert in de Webex-app. De gebruiker heeft de optie om meerdere keren te starten en stoppen met opnemen tijdens een gesprek.

  • Knop Opname starten

  • Knop Opname stoppen

  • Knop Opname onderbreken

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

De Call Correlation Identifier (Correlatie-id gesprek) moet zijn ingeschakeld. Zie Gesprekscorrelatie-id inschakelen voor meer informatie.

De volgende configuratietag moet zijn ingeschakeld om deze functie te kunnen gebruiken: %ENABLE_CALL_RECORDING_WXT%.

Deze functie vereist een integratie met een gespreksopnameplatform van derden.

Als u gespreksopname op BroadWorks wilt configureren, gaat u naar de Cisco BroadWorks-interfacehandleiding voor gespreksopname.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van de opnamefunctie gaat u naar de help.webex.com artikel Webex | Uw gesprekken opnemen.

Als u een opname opnieuw wilt afspelen, moeten gebruikers of beheerders naar hun gespreksopnameplatform van derden gaan.

Groep gesprek parkeren en ophalen

Webex voor Cisco BroadWorks ondersteunt Groep gesprek parkeren en ophalen. Deze functie biedt gebruikers binnen een groep een manier om gesprekken te parkeren, die vervolgens door andere gebruikers in de groep kunnen worden opgehaald. Winkelmedewerkers in een winkelinstelling kunnen de functie bijvoorbeeld gebruiken om een gesprek te parkeren dat vervolgens kan worden opgehaald door iemand in een andere afdeling.

Werking van functies

Zodra de functie is geconfigureerd

  • Tijdens een gesprek klikt een gebruiker op de optie Parkeren in de Webex-app om het gesprek te parkeren op een toestel dat het systeem automatisch selecteert. Het systeem geeft het toestelnummer voor de gebruiker voor een periode van 10 seconden weer.

  • Een andere gebruiker in de groep klikt op de optie Gesprek ophalen in de Webex-app. De gebruiker voert vervolgens het toestelnummer van het geparkeerde gesprek in om het gesprek voort te zetten.

Vereisten

Zorg voor het volgende om deze functie te laten werken:

  • Het clientconfiguratiebestand moet de volgende tags hebben ingesteld:

    <call-park enabled="%ENABLE_CALL_PARK_WXT%"
            timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
  • De Call Correlatie-id moet zijn ingeschakeld op de AS en XSP|ADP. Zie Gesprekscorrelatie-id inschakelen voor meer informatie.

  • Uw SBC moet zijn geconfigureerd om de ' x-broadworks-correlation-in' SIP-kenmerk van en naar de toepassingsserver.

Configuratie

Zie 'Groep voor geparkeerde gesprekken toevoegen' in de Beheerhandleiding voor de webinterface van de Cisco BroadWorks-toepassingsservergroep - deel 2 voor meer informatie over het configureren van Groepsgesprek parkeren op BroadWorks. U moet een groep maken en gebruikers aan de groep toevoegen.

Meer informatie over het configureren van de gesprekscorrelatie-id in BroadWorks vindt u in Functiebeschrijving Cisco BroadWorks-gesprekscorrelatie-id.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van Groepsgesprek parkeren raadpleegt u Webex | Parkeren en Gesprekken ophalen.

Gesprek parkeren/doorverbonden gesprek parkeren

Normaal of doorverbonden gesprek parkeren wordt niet ondersteund in de gebruikersinterface van de Webex-app, maar ingerichte gebruikers kunnen de functie implementeren met behulp van functietoegangscodes:

  • Voer *68 in om een gesprek te parkeren

  • Voer *88 in om een gesprek op te halen

Inbreken

Inbrekersservice wordt vaak gebruikt in callcenteromgevingen of andere situaties waar directe hulp of interventie nodig kan zijn.

Wanneer een inbrekersservice is ingeschakeld, kan een aangewezen gebruiker of supervisor een actief gesprek invoeren door een specifieke opdracht te starten of door een speciale knop of toetscombinatie te gebruiken op hun telefoon of communicatieapparaat. Zodra de aanvraag voor inbreken is ingediend, brengt het systeem een verbinding tot stand met het lopende gesprek, zodat de bevoegde persoon het gesprek kan beluisteren of als actieve deelnemer aan het gesprek kan deelnemen.

Inbreken kan handig zijn in verschillende scenario's. In een callcenterinstelling kunnen supervisors of trainers vertegenwoordigers van de klantenservice controleren en coachen door hun gesprekken in realtime te beluisteren. Indien nodig kunnen ze ingrijpen om advies te geven of het gesprek overnemen als de vertegenwoordiger het moeilijk heeft. In noodsituaties of bij kritische gesprekken kan bevoegd personeel snel deelnemen aan lopende gesprekken om hulp te bieden of belangrijke beslissingen te nemen.

In de Webex-app voor inbreken krijgen we een melding dat het gesprek wordt omgezet in een conferentie. Er is geen extra informatie in de NOTIFY (call-info of conference-info) wat het type conferentie is, zodat we het op een andere manier kunnen behandelen.

Bij het inbreken wordt een drierichtingsgesprek tot stand gebracht tussen de partijen. De volgende termen worden geïntroduceerd:

  • Verantwoordelijke: Een supervisor is een persoon die toezicht houdt op en leiding geeft aan een team van klantenserviceagenten of callcentervertegenwoordigers. In het kader van het inbreken van gesprekken heeft een supervisor doorgaans de mogelijkheid om lopende gesprekken van klanten te controleren en tussenbeide te komen. Zij kunnen gespreksbewakingstools of -software gebruiken om gesprekken te beluisteren, agenten te begeleiden en kwaliteitscontrole te garanderen. De rol van de supervisor kan bestaan uit het trainen van agenten, het aanpakken van klantproblemen en het optimaliseren van de prestaties van het team.

  • Klant: Een klant verwijst naar een persoon of entiteit die contact opneemt met een bedrijf of organisatie om producten, diensten of ondersteuning te verkrijgen. In de context van gesprek inbreken is een klant iemand die een telefoongesprek voert of ontvangt met een agent van de klantenservice. Klanten kunnen tijdens het gesprek hulp, informatie of een oplossing zoeken voor hun vragen of problemen. Met de functie voor het inbreken van gesprekken kunnen supervisors of geautoriseerd personeel deelnemen aan het lopende gesprek tussen de klant en de agent.

  • Agent: Een agent, ook wel een vertegenwoordiger van de klantenservice of een callcenteragent genoemd, is een persoon die verantwoordelijk is voor het afhandelen van klantinteracties en het bieden van ondersteuning of hulp via de telefoon of andere communicatiekanalen. Agenten zijn opgeleid om vragen van klanten te beantwoorden, problemen op te lossen, transacties te verwerken en een positieve klantervaring te bieden. In de context van gesprek inbreken is een agent de persoon die rechtstreeks met de klant spreekt tijdens het telefoongesprek. De agent kan indien nodig begeleiding of feedback van de supervisor ontvangen via inbellen.

Mobiel systeemeigen gesprek escaleren naar vergadering

De Mobile Native Call Escalate to Meeting heeft twee unieke functies:

  • Nieuwe pushmelding

    Mobiele gebruikers in een native gesprek kunnen nu overschakelen naar de Webex-app door op de Nieuwe pushmelding te tikken. Wanneer u een systeemeigen gespreksscherm start, verschijnt er een Nieuwe pushmelding op het scherm en tikt u rechtstreeks op het scherm in gesprek van de Webex-app.

    U ziet de Webex-melding tijdens een telefoongesprek als u Webex Go gebruikt of als uw mobiele netwerkoperator (MNO) gesprekssignalering heeft met Cisco-gespreksbeheer voor uw mobiele telefoongesprekken.

  • Mobiel gesprek verplaatsen naar vergadering

    Wanneer u in gesprek bent met iemand, wilt u dat gesprek mogelijk verplaatsen naar een vergadering om gebruik te maken van enkele geavanceerde vergaderingsfuncties, zoals video, delen of whiteboards. Of nodig andere mensen uit in de discussie en ga naar een vergadering.

Vereisten voor BroadWorks

  • Activeerbare functie 25239

  • R23 met 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 met ADP:

    • AS-patch AP.as.23.0.1075.ap383064

    • ADP met Xsi-Actions-23, CommPilot-23 versie > 2022.05_1.303 en NPS versie > 2022.08_1.350

  • R24:

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

    • ADP met Xsi-Actions-24, CommPilot-24 versie > 2022.05_1.303 en NPS versie > 2022.08_1.350

  • R25:

    • AS RI versie Rel_2022.08_1.354

    • ADP met Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 en NPS-versie > 2022.08_1.350

Configuratie voor URI-bellen ter ondersteuning van het verplaatsen van een gesprek naar een vergadering

NS UrlDialing-beleid

Regel definiëren voor (.*)webex.com om te routeren via 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-routering NE voor I-SBC

Voorbeeldconfiguratie

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-routeringsprofiel

Het exemplaar van het URL-belbeleid is toegevoegd aan het/de juiste routeringsprofiel(en)

NS_CLI/Policy/Profile> get profile MyInst
 Profile:  Webex
                  Policy              Instance
    ==========================================
 …
              UrlDialing          WebexMeetings

ALS gebruik NS-route voor NetworkURL-gesprek

Schakel het AS in om de NS-route in de hybride AS-modus te respecteren

AS_CLI/Interface/IMS> set queryNSForNetworkURL true

E911-noodoproepen

Webex voor Cisco BroadWorks ondersteunt E911-noodoproepen. Met deze functie worden noodoproepen gerouteerd naar een PSAP (Public Safety Answering Point), dat vervolgens de hulpdiensten naar de locatie van de beller kan leiden. Als u deze functie wilt gebruiken, moet u Webex voor Cisco BroadWorks integreren met een E911-provider voor noodoproepen.

Gebruik de volgende Webex-artikelen om ondersteuning voor E911-noodoproepservices te configureren:

  • E911-noodoproepen in Webex voor BroadWorks: gebruik dit artikel om E911-noodoproepen in Webex voor Cisco BroadWorks te configureren met een van de volgende ondersteunde E911-providers:

    • Gegarandeerd

    • Binnen het systeem

    • RedSky

  • Disclaimer voor noodoproepen: als u een locatieservice hebt, kunt u het venster Disclaimer voor noodoproepen in de Webex-app zo configureren dat gebruikers hun locatie kunnen bijwerken wanneer ze zich aanmelden.

Clients aanpassen en inrichten

Gebruikers downloaden en installeren hun algemene Webex-apps voor desktop of mobiel (zie Webex-app-platforms voor downloadkoppelingen). Zodra de gebruiker zich heeft geverifieerd, wordt de client geregistreerd bij de Webex-cloud voor berichten en vergaderingen, worden de merkgegevens opgehaald, wordt de informatie over de BroadWorks-service ontdekt en wordt de belconfiguratie gedownload van de BroadWorks-toepassingsserver (via DMS op XSP|ADP).

U configureert de gespreksparameters voor Webex-apps in BroadWorks (zoals normaal). U configureert parameters voor branding, berichten en vergaderingen voor de clients in Control Hub. U kunt een configuratiebestand niet rechtstreeks wijzigen.

Deze twee sets configuraties kunnen overlappen. In dat geval vervangt de Webex-configuratie de BroadWorks-configuratie.

Configuratiesjablonen voor Webex-apps toevoegen aan de BroadWorks-toepassingsserver

Webex-apps worden geconfigureerd met DTAF-bestanden. De clients downloaden een XML-configuratiebestand van de toepassingsserver via de service Apparaatbeheer op de XSP|ADP.

  1. Haal de vereiste DTAF-bestanden op (zie Apparaatprofielen in het gedeelte Uw omgeving voorbereiden).

  2. Controleer of u de juiste tagsets hebt in BroadWorks System > Resources > Device Management Tagsets.

  3. Voor elke client die u inricht:

    1. Download en pak het DTAF zip-bestand voor de specifieke client uit.

    2. DTAF-bestanden importeren naar BroadWorks op System > Resources > Identity/Device Profile Types

    3. Open het nieuw toegevoegde apparaatprofiel voor bewerken en:

      • Voer de XSP|ADP farm FQDN en het Device Access Protocol in.

      • Schakel het selectievakje Support Remote Party Info in. Deze ondersteuning is vereist om bureaublad delen te laten werken.


         
        U kunt de ondersteuning voor Remote Party ook inschakelen door de volgende CLI-opdracht uit te voeren op de toepassingsserver: AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
    4. Pas de sjablonen aan volgens uw omgeving (zie onderstaande tabel).

    5. Sla het bestand op.

  4. Klik op Bestanden en verificatie en selecteer vervolgens de optie om alle systeembestanden opnieuw op te bouwen.

Naam

Beschrijving

Prioriteit codec

Prioriteitsvolgorde configureren voor de audio- en videocodecs voor VoIP-gesprekken

TCP, UDP en TLS

Configureer de protocollen die worden gebruikt voor SIP-signalering en media

RTP-audio- en videopoorten

Poortbereiken configureren voor RTP-audio en -video

SIP-opties

Configureer verschillende opties met betrekking tot SIP (SIP INFO, rport gebruiken, SIP-proxydetectie, vernieuwingsintervallen voor registratie en abonnement, enz.)

Branding voor Webex-app aanpassen


 

De portal voor gebruikersactivering gebruikt hetzelfde logo dat u toevoegt voor Client Branding.

Probleemrapportage en Help-URL's aanpassen

Als u deze opties wilt aanpassen, kunnen administators de procedure 'Feedback en Help-site-URL's toevoegen' volgen, die u in beide bovenstaande brandingartikelen kunt vinden.

Uw testorganisatie configureren voor Webex voor Cisco BroadWorks

Voordat u begint

Met Flowthrough-inrichting

U moet alle XSP|ADP-services en de partnerorganisatie in Control Hub configureren voordat u deze taak kunt uitvoeren.

1

Service toewijzen in BroadWorks:

  1. Maak een testonderneming onder uw serviceprovideronderneming in BroadWorks of maak een testgroep onder uw serviceprovider (afhankelijk van uw BroadWorks-configuratie).

  2. Configureer de IM&P-service voor die onderneming om naar de sjabloon te verwijzen die u test (haal de URL van de inrichtingsadapter en de referenties op in de Control Hub-onboardsjabloon).

  3. Maak testabonnees in die onderneming/groep.

  4. Geef de gebruikers unieke e-mailadressen in het e-mailveld in BroadWorks. Kopieer deze ook naar het kenmerk Alternatieve id.

  5. Wijs de geïntegreerde IM&P-service toe aan deze abonnees.


     

    Hierdoor worden de klantorganisatie en de eerste gebruikers gemaakt, wat enkele minuten duurt. Wacht even voordat u zich probeert aan te melden bij uw nieuwe gebruikers.

2

Klantorganisatie en gebruikers verifiëren in Control Hub:

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Klanten en controleer of uw nieuwe klantorganisatie in de lijst staat (de naam volgt de groepsnaam of de bedrijfsnaam, vanuit BroadWorks).

  3. Open de klantorganisatie en controleer of de abonnees gebruikers in die organisatie zijn.

  4. Controleer of de eerste abonnee aan wie u de geïntegreerde IM&P-service hebt toegewezen, de klantbeheerder van die organisatie is geworden.

Gebruikerstests

1

Download de Webex-app op twee verschillende machines.

2

Meld u aan als testgebruikers op de twee machines.

3

Voer testgesprekken.

Webex voor BroadWorks beheren

Klantorganisaties inrichten

In het huidige model richten we de klantorganisatie automatisch in wanneer u de eerste gebruiker integreert via een van de methoden die in dit document worden beschreven. Inrichting vindt slechts één keer plaats voor elke klant.

Gebruikers inrichten

U kunt gebruikers op de volgende manieren inrichten:

  • API's gebruiken om Webex-accounts te maken

  • Geïntegreerde IM&P (flowthrough provisioning) toewijzen met vertrouwde e-mails om Webex-accounts te maken

  • Wijs geïntegreerde IM&P (flowthrough provisioning) toe zonder vertrouwde e-mails. Gebruikers verstrekken en valideren e-mailadressen om Webex-accounts te maken

  • Gebruikers toestaan zichzelf te activeren (u stuurt ze een koppeling, ze maken Webex-accounts)

API's voor openbare inrichting

Webex stelt openbare API's bloot zodat serviceproviders Webex voor Cisco BroadWorks-abonneevoorzieningen kunnen integreren in hun bestaande inrichtingswerkstromen. De specificatie voor deze API's is beschikbaar op developer.webex.com. Als u wilt ontwikkelen met deze API's, neemt u contact op met uw Cisco-vertegenwoordiger om Webex voor Cisco BroadWorks op te halen.


 

Groothandels worden geweigerd door deze API's.

Doorstroominrichting

Op BroadWorks kunt u gebruikers inrichten met de optie Geïntegreerde IM&P inschakelen. Door deze actie voert de BroadWorks-inrichtingsadapter een API-oproep uit om de gebruiker in te richten op Webex. Onze provisioning-API is achterwaarts compatibel met de UC-One SaaS API. BroadWorks AS vereist geen codewijziging, alleen een configuratiewijziging naar het API-eindpunt voor de inrichtingsadapter.


 

Het inrichten van abonnees op Webex kan aanzienlijk duren (enkele minuten voor de eerste gebruiker binnen een onderneming). Webex voert de inrichting uit als een achtergrondtaak. Als de flowthrough-inrichting is geslaagd, geeft dit aan dat de inrichting is gestart. Het duidt niet op voltooiing.

Als u wilt bevestigen dat gebruikers en de klantorganisatie volledig zijn ingericht op Webex, moet u zich aanmelden bij Partner Hub en in uw lijst met klanten kijken.

BroadWorks-trunking-gebruikers kunnen Webex voor BroadWorks hebben via een gedeelde gespreksweergave (SCA). De trunking-gebruiker moet de verificatieservice hebben toegewezen. Zoals beschreven in de BroadWorks-handleiding voor trunking-oplossingen (Trunking Solution Guide) 8, kan de verificatie van de SCA Webex-weergave worden gescheiden van de algemene trunkverificatie. Webex voor BroadWorks kan niet worden ingericht voor trunking-gebruikers waaraan de functies Routelijst of Directe route zijn toegewezen.


 
De locatie van sjablonen is verplaatst van BroadWorks-gesprekken in de organisatie-instellingen naar het gedeelte Klantenlijst en wordt nu de onboardingsjabloon genoemd.

Zelfactivering van de gebruiker

BroadWorks-gebruikers inrichten in Webex zonder de geïntegreerde IM&P-service toe te wijzen:

  1. Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.

  2. Klik op Sjablonen weergeven.

  3. Selecteer de inrichtingssjabloon voor onboarding die u wilt toepassen op deze gebruiker.

    Vergeet niet dat elke sjabloon is gekoppeld aan een cluster en uw partnerorganisatie. Als de gebruiker zich niet in het BroadWorks-systeem bevindt dat aan deze sjabloon is gekoppeld, kan de gebruiker de koppeling niet zelf activeren.

  4. Kopieer de inrichtingskoppeling en verzend deze naar de gebruiker.

    U kunt ook de downloadkoppeling voor de software opnemen en de gebruiker eraan herinneren dat hij of zij zijn of haar e-mailadres moet opgeven en valideren om zijn of haar Webex-account te activeren.

  5. U kunt de activeringsstatus van de gebruiker op de geselecteerde sjabloon controleren.

Zie Gebruikersvoorzieningen en activeringsstromen voor meer informatie.

Inrichting met niet-vertrouwde e-mails

Partner Hub biedt een reeks besturingselementen in de weergave Gebruikersstatus waarmee Webex voor Cisco BroadWorks-serviceproviderbeheerders de gebruikersstatus kunnen controleren en fouten kunnen oplossen bij het inrichten van niet-vertrouwde e-mails. Zie Gebruikersvoorzieningen met niet-vertrouwde e-mails verifiëren voor meerinformatie.

Webex-gebruikers verplaatsen naar Webex voor Cisco BroadWorks

Als u bestaande Webex-gebruikers wilt verplaatsen naar Webex voor Cisco BroadWorks, raadpleegt u de onderstaande tabel om te bepalen welke procedure moet worden gevolgd.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfaanmelding (bv. gratis account, proefaccount)

  1. Inrichtingsgebruikers: als de Webex voor BroadWorks-organisatie niet bestaat (zonder dat er gebruikers zijn ingericht), volgt u de normale inrichting om de eerste gebruiker in te richten als beheerdersgebruiker en maakt u de organisatie. Hiermee wordt het Webex-gebruikersaccount automatisch verplaatst voor de eerste gebruiker. Gebruik de onderstaande procedure voor volgende gebruikers.

  2. Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks: als de Webex voor BroadWorks-organisatie bestaat (eerste gebruiker is ingericht), verkrijgt u toestemming van de gebruiker en verplaatst u volgende gebruikers.

Klantorganisatie

Webex voor BroadWorks toevoegen aan bestaande organisatie: de bijlage bij de organisatie (voor de eerste gebruiker) voegt ook Webex voor BroadWorks toe aan volgende gebruikers, zolang deze zijn toegewezen aan de juiste organisatie.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfaanmelding (bv. gratis account, proefaccount)

Als Webex voor BroadWorks-organisatie niet bestaat (er zijn geen gebruikers ingericht):

  • Inrichtingsgebruikers: volg de normale inrichting om de eerste gebruiker als een beheerdersgebruiker toe te voegen. Hiermee wordt het account voor de eerste gebruiker automatisch verplaatst en wordt de Webex for BroadWorks-organisatie gemaakt. Toestemming van de gebruiker is vereist om susbsequente gebruikers te verplaatsen (gebruik de onderstaande procedure).

Als Webex voor BroadWorks-organisatie bestaat (er is ten minste één gebruiker ingericht):

Klantorganisatie

Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks

Gebruik deze procedure om een bestaande Webex-gebruiker die zich in een consumentenorganisatie bevindt of een zelfaanmeldingsaccount heeft (gratis account of proefaccount) te verplaatsen naar Webex voor Cisco BroadWorks. Houd er rekening mee dat de Webex voor Cisco BroadWorks-organisatie moet bestaan (met de eerste gebruiker ingericht). In dit geval kunt u een van de volgende opties gebruiken om gebruikers te verplaatsen:

  • Gebruiker verplaatsen (met vertrouwde e-mail): gebruikt inrichting met vertrouwde e-mails

  • Gebruiker verplaatsen (met niet-vertrouwde e-mail): gebruikt inrichting met niet-vertrouwde e-mails

  • Zelfactivering


 
Als de Webex voor Cisco BroadWorks-organisatie nog niet is gemaakt (er zijn geen gebruikers ingericht), volgt u de normale inrichtingsprocessen (Inrichtingsgebruikers) om de organisatie te maken en de eerste gebruiker toe te voegen als een beheergebruiker. Nadat de eerste gebruiker is ingericht in de organisatie, volgt u de op toestemming gebaseerde methoden in deze procedure om volgende gebruikers te verplaatsen.

Gebruiker verplaatsen (met vertrouwd e-mailadres)

Als de onboardsjabloon vertrouwde e-mails gebruikt, kan de partnerbeheerder volgende gebruikers met dit proces verplaatsen:

  1. De beheerder voegt de gebruiker toe.

    • De gebruiker wordt gepusht naar de BroadWorks-inrichtingsbrug.

    • De CI-zoekopdracht bepaalt dat deze gebruiker een ander Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  2. De gebruiker opent de e-mail en klikt op Account activeren. De gebruiker wordt omgeleid naar de Webex-consumentenportal.

  3. Gebruiker meldt zich aan bij Webex.

  4. De gebruiker klikt op Verwijderen om het oude Webex-account te verwijderen.

    • Het oude Webex-account is verwijderd.

    • De gebruiker is ingericht in Webex voor Cisco BroadWorks met hetzelfde e-mailadres.

    • De gebruiker wordt omgeleid naar de pagina Downloaden.

Gebruiker verplaatsen (met niet-vertrouwde e-mail)

Als de onboardsjabloon niet-vertrouwde e-mails gebruikt, moet het e-mailadres van de gebruiker eerst worden gevalideerd. De beheerder kan dit proces volgen om volgende gebruikers te verplaatsen:

  1. De beheerder voegt de gebruiker toe.

    • De gebruiker wordt automatisch naar de BroadWorks-inrichtingsbrug gepusht.

    • Er wordt een tekst met een activeringskoppeling naar de gebruiker verzonden.

  2. De gebruiker klikt op de activeringskoppeling en voert het e-mailadres in.

    • De CI-zoekopdracht bepaalt dat deze gebruiker een ander Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op Nu deelnemen.

    • Het e-mailadres is gevalideerd.

    • De gebruiker wordt omgeleid om zich aan te melden bij de Webex-consumentenportal.

  4. Gebruiker meldt zich aan bij Webex.

  5. De gebruiker moet op Verwijderen klikken om het oude Webex-account te verwijderen.

    • Het oude Webex-account is verwijderd.

    • De gebruiker is ingericht in Webex voor Cisco BroadWorks met hetzelfde e-mailadres.

    • De gebruiker wordt omgeleid naar de pagina Downloaden.

Zelfactiveringsstroom

Als de gebruiker een bestaand BroadWorks-account heeft, kan hij of zij het zelfactiveringsproces gebruiken om zijn of haar account te verplaatsen.

  1. De gebruiker meldt zich aan bij de URL van de gebruikerstoegang met BroadWorks-aanmeldgegevens.

  2. De gebruiker voert zijn/haar e-mailadres in.

    • De gebruiker wordt gepusht naar de BroadWorks-inrichtingsbrug.

    • Er wordt een geautomatiseerd e-mailadres naar het e-mailadres van de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op de koppeling Nu deelnemen, waarmee het e-mailadres wordt gevalideerd.

    • CI zoekt gebruiker heeft een bestaand Webex-account. Gebruikers moeten het oude account verwijderen voordat ze kunnen doorgaan.

    • Gebruiker wordt omgeleid om zich aan te melden bij Webex.

  4. De gebruiker meldt zich aan bij de Consumentenportal.

  5. De gebruiker klikt op Account verwijderen.

    • Het oude Webex-account wordt verwijderd.

    • De gebruiker heeft een nieuw Webex voor Cisco BroadWorks-account met hetzelfde e-mailadres ingericht.

Webex voor BroadWorks toevoegen aan bestaande organisatie

Als u een partnerbeheerder bent die Webex voor BroadWorks-services toevoegt aan een bestaande Webex-klantorganisatie die nog niet is gekoppeld aan een door een partner beheerde BroadWorks-onderneming, MOET de beheerder van de klantorganisatie beheerderstoegang voor het inrichtingsverzoek goedkeuren om te slagen.

De goedkeuring van de organisatiebeheerder is vereist als een van de volgende situaties waar is:

  • De bestaande klantorganisatie heeft 100 gebruikers of meer

  • De organisatie heeft een geverifieerd e-maildomein

  • Het organisatiedomein is geclaimd

Als geen van de bovenstaande criteria waar is, kan een Automatic Attach optreden.


 
In een scenario met automatische bijlage wordt een Webex voor BroadWorks-abonnement toegevoegd aan een bestaande klantorganisatie zonder melding aan de bestaande organisatiebeheerder of eindgebruiker. In de meeste gevallen krijgt uw partnerorganisatie inrichtingsbeheerdersrechten. Als de klantorganisatie echter geen licenties heeft of alleen licenties heeft opgeschort/geannuleerd, wordt u een volledige beheerder gemaakt.

Met toegang tot de inrichtingsbeheerder hebt u beperkte zichtbaarheid in Control Hub voor de gebruikers in de bestaande organisatie. Het wordt aanbevolen dat u contact opneemt met de klantbeheerder en volledige beheerderstoegang tot de organisatie aanvraagt.

Partnerbeheerders kunnen de volgende procedure voltooien om BroadWorks-gespreksservices toe te voegen aan een bestaande Webex-organisatie:


 
Zorg ervoor dat de e-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties (de schakelaar is standaard ingeschakeld).
1

De partnerbeheerder richt Webex voor Cisco BroadWorks in voor de klant. Zie Inrichting van klantorganisaties voor hulp. Nu gebeurt het volgende:

  • Organisatiebijlage mislukt met een 2017 fout (Kan abonnee niet inrichten in een bestaande Webex-organisatie). (Er wordt geen fout ontvangen tijdens een automatische bijlage.)

  • Er wordt een e-mailmelding gegenereerd en verzonden naar de beheerders van de klantorganisatie (maximaal vijf beheerders). In de e-mailmelding wordt het e-mailadres van de partnerbeheerder gemarkeerd (zoals geconfigureerd in de sjabloon voor onboarding in Partner Hub) en wordt de organisatiebeheerder gevraagd de partnerbeheerder goed te keuren als externe beheerder. De klantorganisatiebeheerder moet het verzoek goedkeuren en de partnerbeheerder volledige beheerder toegang geven tot de klantorganisatie.


 

Stel dat de klantbeheerder geen e-mail ontvangt. In dat geval kan de klantbeheerder de partnerbeheerder (opgegeven in de sjabloon) handmatig toevoegen als de externe beheerder van de klantorganisatie vanuit de Control Hub. Probeer de gebruiker vervolgens opnieuw in te richten, waardoor de Webex voor Cisco BroadWorks-klantvoorziening wordt geactiveerd.

2

Met volledige beheerderstoegang kan de partnerbeheerder het proces voor het inrichten van de klant voltooien. Vanaf stap 1 hierboven moet u de inrichting van de klant opnieuw proberen. Nu u een externe Full Admin bent, mag u de fout 2017 echter niet waarnemen.

Zodra de inrichting van gespreksservices is voltooid, is de bestaande klantorganisatie zichtbaar als klant onder de partnerorganisatie van Webex voor BroadWorks.


 
De naam van de bijgevoegde organisatie verandert niet in de bedrijfsnaam van BroadWorks. De naam van de bijgevoegde organisatie blijft behouden zoals die was voorafgaand aan het bijvoegproces.

Voorwaarden van organisatiebijlage

  • Het e-mailadres van de eerste BroadWorks-abonnee die is ingericht, moet overeenkomen met het e-mailadres van een bestaande gebruiker in de beoogde klantorganisatie. Anders wordt een nieuwe klantorganisatie gemaakt.

  • De eerste gebruiker van de bestaande organisatie die is ingericht voor Webex voor BroadWorks, is niet ingericht als beheerdersgebruiker. Instellingen en rechten van de bestaande organisatie worden behouden.

  • De bestaande verificatie-instellingen van de organisatie hebben voorrang op wat is geconfigureerd op de Webex for BroadWorks-inrichtingssjabloon. Als gevolg hiervan verandert er niets aan de manier waarop bestaande gebruikers zich aanmelden.

    • Als de bestaande klantorganisatie echter basisbranding heeft ingeschakeld, hebben de geavanceerde branding-instellingen van de partner voorrang nadat de bijvoeging plaatsvindt. Als de klant wil dat de basisbranding intact blijft, moet de partner de klantorganisatie configureren om de branding in de instellingen voor geavanceerde branding te overschrijven.

  • De naam van de bestaande organisatie wordt niet gewijzigd.

  • Er is geen wijziging in de vlaggen voor e-mailonderdrukking in de instellingen van de bestaande organisatie. Dit kan van invloed zijn op nieuw ingerichte gebruikers. Afhankelijk van hoe de vlag is ingesteld, ontvangen nieuwe gebruikers al dan niet een e-mail met een code die moet worden ingevoerd om de activering te voltooien.

  • De beperkte beheermodus (ingesteld door de schakelaar voor beperkte partnermodus) is uitgeschakeld voor de bijgevoegde organisatie.

  • Zorg ervoor dat u het bevestigingsproces voor de organisatie voltooit (bestaande gebruikers verplaatsen en de organisatie-id bijwerken) voordat u nieuwe gebruikers inricht in de Webex voor Cisco BroadWorks-organisatie.

  • Een BroadWorks-onderneming kan slechts aan één Webex-organisatie worden gekoppeld. U kunt abonnees van één BroadWorks-onderneming niet inrichten in afzonderlijke Webex-organisaties.

Externe beheerder toevoegen

Zie het artikel Aanvraag externe beheerder goedkeuren voor de stappen die klantorganisatiebeheerders kunnen volgen om de partnerbeheerder toe te voegen als externe beheerder op help.webex.com.


 
De klantbeheerder moet de externe beheerder de volledige beheerdersrechten en -rechten geven.

 
Het e-mailadres dat de beheerder van de klantorganisatie als externe beheerder toevoegt, moet overeenkomen met het e-mailadres van de partnerbeheerder zoals is geconfigureerd in de sjabloon voor onboarding op Partner Hub.

Nadat u de e-mail van het onboardsjabloon op Partnerhub hebt toegevoegd als volledige beheerder, moeten eventuele extra partnerbeheerders ook worden toegevoegd als externe beheerder met volledige beheerdersrechten.

Webex voor BroadWorks loskoppelen van bestaande organisatie

Volg deze stappen om Webex voor BroadWorks los te koppelen van een bestaande Webex-organisatie. Als u bijvoorbeeld per ongeluk Webex voor BroadWorks aan een bestaande organisatie hebt gekoppeld en de bijlage wilt verwijderen.


 

Als u in Standaardstroom Webex voor BroadWorks loskoppelt van een bestaande Webex-organisatie (alleen standaardstroom), worden alle bijbehorende abonneegegevens verwijderd en wordt het Webex voor BroadWorks-abonnement van de klant gedeactiveerd. U verliest ook de toegang tot de klantorganisatie als dit het enige gekoppelde abonnement is. In de hybride stroom worden de klantabonnementen niet gewijzigd.

  1. Als u geen toegang hebt tot de klantinstellingen in Control Hub, laat de klantbeheerder u externe beheerder dan toegang verlenen door het verzoek van externe beheerder goed te keuren.

  2. Verwijder alle Webex voor BroadWorks-werkplekken uit de organisatie. Gebruik de API Een BroadWorks-werkplek verwijderen.

  3. Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de API Een BroadWorks-abonnee verwijderen.

  4. Verwijder in behandeling zijnde Webex voor BroadWorks-gebruikers uit de organisatie. Als gebruikers bijvoorbeeld zijn ingericht via de niet-vertrouwde e-mailstroom en er nog geen geldige e-mails zijn ingevoerd, blijven de gebruikers in behandeling. Volg Gebruikersvoorzieningen verifiëren met niet-vertrouwde e-mails om de gebruikers te verwijderen.

  5. Verwijder de configuratie van BroadWorks Calling voor deze klant. Open het Control Hub-exemplaar van de klant en klik op Hybrid onder het gedeelte BroadWorks Calling om alle configuraties te verwijderen.

Als u na de onthechting Webex voor BroadWorks aan de klant wilt koppelen, volgt u de inrichtingsprocessen om deze aan een bestaande klant te koppelen.


 
Een alternatieve optie om abonnees te verwijderen als u de API Een BroadWorks-abonnee verwijderen niet wilt gebruiken, is om naar BroadWorks CommPilot te gaan en de geïntegreerde IM&P-service voor de betrokken gebruikers te verwijderen.

Gebruikers en organisaties beheren

Als u gebruikers in Webex voor Cisco BroadWorks wilt beheren, moet u bedenken dat de gebruiker zowel in BroadWorks als in Webex bestaat. Belattributen en de BroadWorks-identiteit van de gebruiker worden in BroadWorks gehouden. Een afzonderlijke e-mailidentiteit voor de gebruiker en de licenties voor Webex-functies worden in Webex bewaard.

Gebruikersvoorzieningen verifiëren met niet-vertrouwde e-mails

Als u Webex voor BroadWorks-gebruikers inricht via doorstroominrichting met niet-vertrouwde e-mails, moeten gebruikers zichzelf inrichten door hun e-mailadres in de portal voor gebruikersactivering in te voeren. Als er een fout optreedt, kan de gebruiker de optie Opnieuw proberen gebruiken die in de portal wordt weergegeven om een nieuwe poging te doen. Als de gebruiker de fout opnieuw ondervindt, kan de beheerder de onderstaande stappen in Partner Hub gebruiken om de status te controleren en de gebruiker te onboarden, de gebruiker te verwijderen of configuratiewijzigingen toe te passen.

1

Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.

2

Klik op Sjablonen weergeven. Selecteer de juiste onboardsjabloon die u wilt toepassen op deze gebruiker.

3

Controleer onder Gebruikersverificatie of de volgende instellingen zijn ingesteld om ervoor te zorgen dat doorstroominrichting met niet-vertrouwde e-mails correct is geconfigureerd:

  • De optie Niet-vertrouwde e-mails moet zijn ingeschakeld
  • Het veld Koppeling delen moet naar de activeringskoppeling verwijzen. Als alles is geconfigureerd, kunnen gebruikers proberen zichzelf in te richten via de User Activation Portal.
4

Nadat de gebruiker is ingericht, klikt u in het gedeelte Gebruikersverificatie op Gebruikersstatus weergeven om de inrichtingsstatus te controleren.

In de weergave Gebruikersstatus wordt de lijst met gebruikers weergegeven, samen met details zoals de BroadWorks-id, het geselecteerde pakkettype en de huidige status. Deze weergave geeft aan of de gebruiker is ingericht of dat er een vereiste in behandeling is.
5

Voor gebruikers met fouten of vereisten in behandeling, klikt u op de drie stippen aan de rechterkant en kiest u een van de volgende beheeropties:

  • Activering opnieuw proberen: klik op deze optie om opnieuw te proberen de gebruiker te onboarden. Voer in het pop-upvenster een geldig e-mailadres in en klik op Onboard.
  • Gebruiker verwijderen: deze optie is mogelijk van toepassing als u de configuratie moet wijzigen om onboarding toe te staan. Nadat u de gebruiker hebt verwijderd en uw wijzigingen hebt aangebracht, kan de gebruiker opnieuw proberen te onboarden.
  • Pakkettype wijzigen: wijzig de instelling van het ene pakket naar het andere:
  • Fouttekst kopiëren: klik op deze optie om de fouttekst te kopiëren.

Aanvullende weergaveopties

De volgende extra opties zijn beschikbaar wanneer u de lijst met gebruikers bekijkt:

  • Exporteren: klik op deze knop als u de gebruikerslijst wilt exporteren naar een CSV-bestand.

  • Ingerichte gebruikers uitsluiten: schakel deze schakelaar in als u alleen gebruikers met vereisten of fouten in behandeling wilt weergeven.

Gebruikers-id of e-mailadres wijzigen

Wijzigingen gebruikers-id en e-mailadres

E-mail-id en alternatieve id zijn de BroadWorks-gebruikerskenmerken die worden gebruikt met Webex voor Cisco BroadWorks. De BroadWorks-gebruikers-id is nog steeds de primaire id van de gebruiker in BroadWorks. In de volgende tabel worden de doelstellingen van deze verschillende kenmerken beschreven en wordt beschreven wat u moet doen als u ze moet wijzigen:

Kenmerk in BroadWorksOvereenkomstig kenmerk in WebexDoelNotities
BroadWorks-gebruikers-idGeenPrimaire idU kunt deze id niet wijzigen en de gebruiker nog steeds aan hetzelfde account in Webex koppelen. U kunt de gebruiker verwijderen en opnieuw maken als dit onjuist is.
E-mail-idGebruikers-id

Verplicht voor doorstroominrichting (maken van Webex-gebruikers-id) wanneer u aangeeft dat u e-mail vertrouwt

Niet vereist in BroadWorks als u niet beweert dat u e-mails kunt vertrouwen

Niet vereist in BroadWorks als u abonnees toestaat zichzelf te activeren

Er is een handmatig proces om dit op beide plaatsen te wijzigen als de gebruiker het verkeerde e-mailadres heeft gekregen:

  1. Het e-mailadres van de gebruiker wijzigen in Control Hub

  2. E-mail-id-kenmerk wijzigen in BroadWorks

Wijzig de BroadWorks-gebruikers-id niet. Dit wordt niet ondersteund.

Alternatieve idGeenHiermee schakelt u het authn van de gebruiker in, via e-mail en wachtwoord, met de BroadWorks-gebruikers-idMoet hetzelfde zijn als de e-mail-id. Als U het e-mailadres niet in het kenmerk Alternatieve id kunt plaatsen, moeten gebruikers hun BroadWorks-gebruikers-id invoeren bij de verificatie.

Gebruikerspakket wijzigen in Partner Hub

1

Meld u aan bij Partner Hub en klik op Klanten.

2

Zoek en selecteer de klantorganisatie waar de gebruiker is gehuisvest.

De overzichtspagina van de organisatie wordt geopend in een deelvenster aan de rechterkant van het scherm.

3

Klik op Klant weergeven.

De klantorganisatie wordt geopend in Control Hub en toont de pagina Overzicht.
4

Klik op Users, zoek en klik op de getroffen gebruiker.

5

Klik in de Services van de gebruiker op Webex voor BroadWorks-pakketten (abonnementen).

Het deelvenster Pakketten van de gebruiker wordt geopend en u kunt zien welk pakket momenteel aan de gebruiker is toegewezen.

6

Kijk in het tabblad Profiel in het gedeelte Pakket en klik op het pijltje (>) om de weergave uit te vouwen.

7

Selecteer het gewenste pakket voor deze gebruiker (Basic, Standard, Premium of Softphone) en klik op Save.

Control Hub toont een bericht dat de gebruiker bijwerkt.

8

U kunt de gebruikersgegevens en het tabblad Control Hub sluiten.


 
Standaard- en Premium-pakketten hebben verschillende vergadersites die bij elk pakket horen. Wanneer een abonnee met beheerdersrechten met een van deze twee pakketten naar het andere pakket gaat, wordt de abonnee weergegeven met twee vergadersites in Control Hub. De vergaderingsmogelijkheden en vergaderingssite van de abonnee komen overeen met het huidige pakket. De vergadersite van het vorige pakket en alle eerder gemaakte inhoud op die site, zoals opnamen, blijven toegankelijk voor de sitebeheerder van de vergadering.

 
Het kan twee tot drie uur duren voordat nieuwe PMR-instellingen die het gevolg zijn van een pakketwijziging, worden bijgewerkt.

Gebruikers verwijderen

Er zijn verschillende methoden die beheerders kunnen gebruiken om een gebruiker te verwijderen uit Webex voor Cisco BroadWorks:


 
Als de gebruiker die u gaat verwijderen beheerdersrechten heeft, wijst u een nieuwe beheerder toe voordat u de gebruiker verwijdert. Er is geen automatische overdracht van de beheerdersrol als de laatste beheerder wordt verwijderd.

Webex voor Cisco BroadWorks API

Partnerbeheerders kunnen de Webex for Cisco BroadWorks API gebruiken om gebruikers te verwijderen:

  1. Voer de Remove a BroadWorks Subscriber API-aanvraag uit op https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Met deze aanvraag wordt het Webex for Cisco BroadWorks-abonnement verwijderd. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt behandeld als een gratis Webex-gebruiker.

  2. Voer het API-verzoek Een persoon verwijderen uit op https://developer.webex.com/docs/api/v1/people/delete-a-person om de gebruiker volledig te verwijderen.

Doorstroominrichting

Partnerbeheerders kunnen doorstroominrichting gebruiken om gebruikers te verwijderen:

  1. Op de BroadWorks-server verwijdert u de geïntegreerde IM+P-service van de gebruiker. U kunt de service voor de gebruiker uitschakelen via de pagina User – Integrated IM&P op BroadWorks. Zie 'Geïntegreerde IM&P configureren' in de Beheerhandleiding voor de webinterface van de Cisco BroadWorks-toepassingsservergroep – deel 2 voor een gedetailleerde procedure.

    Nadat de service is uitgeschakeld, verwijdert doorstroominrichting de Webex voor Cisco BroadWorks-susbscription van de gebruiker. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt behandeld als een gratis Webex-gebruiker.

  2. Zoek en selecteer de gebruiker in Control Hub.

  3. Ga naar Actions en selecteer Delete User.

Control Hub (klantbeheerders)

Klantbeheerders kunnen Control Hub gebruiken om gebruikers uit hun organisatie te verwijderen. Zie Een gebruiker uit uw organisatie verwijderen in Webex Control Hub op https://help.webex.com/0qse04/ voor meer informatie.

Organisatie verwijderen

Volg deze procedure om een Webex voor Cisco BroadWorks-organisatie uit het systeem te verwijderen.
1

Gebruik de People API's om alle gebruikers uit de organisatie te verwijderen:

  1. Voer de API Personen weergeven uit om een lijst met gebruikers op te halen.

  2. Voer de API Een persoon verwijderen uit om de gebruikers te verwijderen.


 
Met de Een BroadWorks-abonnee-API verwijderen worden Webex voor Cisco BroadWorks-rechten van een gebruiker verwijderd, maar wordt de gebruiker niet verwijderd.
2

Als adreslijstsynchronisatie is ingeschakeld, schakelt u deze uit. Dit kan via Partner Hub of via de openbare API.

Adreslijstsynchronisatie uitschakelen via Partner Hub:

  1. Meld u aan bij Partner Hub en klik op Instellingen.

  2. Klik onder BroadWorks Calling op Sjablonen weergeven en selecteer de juiste sjabloon.

  3. Klik op de knop Toon statuslijst klantsynchronisatie in het zijpaneel.

  4. Voor de juiste klant klikt u op de drie stippen helemaal rechts en selecteert u Synchronisatie uitschakelen.

Als u adreslijstsynchronisatie via API wilt uitschakelen, gebruikt u Adreslijstsynchronisatie voor een BroadWorks Enterprise-API bijwerken en schakelt u de instelling enableDirSync uit.

Alle gebruikers met betrekking tot BroadWorks-adreslijstsynchronisatie voor deze organisatie worden verwijderd. Houd er rekening mee dat het verwijderen van gebruikers (met behulp van een van beide methoden) enige tijd kan duren, afhankelijk van de hoeveelheid gebruikers.

3

Nadat alle gebruikers zijn verwijderd, gebruikt u de API Een organisatie verwijderen om de organisatie te verwijderen.

Vrijgavebeheer

Bedieningselementen voor releasebeheer in Partner Hub maken het eenvoudig voor Webex voor Cisco BroadWorks-serviceproviders om releases te beheren door hen de mogelijkheid te geven de releasecadans te beheren waarmee de Webex-apps van gebruikers upgraden naar de nieuwste software.

De Webex-app maakt standaard gebruik van automatische upgrades (door Cisco beheerde maandelijkse versies). Met deze functie kunnen partnerbeheerders echter:

  • Aangepaste releaseschema's configureren met uitstel van de standaardreleaseschema's van Cisco

  • Configureer één releaseschema en trapsgewijs die planning naar alle klantorganisaties die ze beheren

  • Verschillende releaseschema's toewijzen aan verschillende klantorganisaties

Zie het Webex-artikel Aanpassingen voor releasebeheer voor meer informatie over releasebeheer, waaronder informatie over het configureren en toepassen van aangepaste releaseplanningen.

Het systeem opnieuw configureren

U kunt het systeem als volgt opnieuw configureren:

  • Een BroadWorks-cluster toevoegen in Partner Hub

  • Een BroadWorks-cluster bewerken of verwijderen in Partnerhub

  • Een onboardingsjabloon toevoegen in Partner Hub

  • Een onboardsjabloon bewerken of verwijderen in Partner Hub

Een BroadWorks-cluster bewerken of verwijderen in Partnerhub

U kunt een BroadWorks-cluster bewerken of verwijderen in Partnerhub.

1

Meld u aan bij Partner Hub met uw partnerbeheergegevens op https://admin.webex.com.

2

Ga naar Instellingen en zoek het gedeelte BroadWorks-gesprekken.

3

Klik op Clusters weergeven.

4

Klik op het cluster dat u wilt bewerken of verwijderen.

De clusterdetails worden weergegeven in een flyout-venster aan de rechterkant.
5

U hebt de volgende opties:

  • Wijzig de gegevens die u moet wijzigen en klik op Opslaan.
  • Klik op Verwijderen om het cluster te verwijderen en bevestig.

     

    Als er veel klanten (>50) in het BroadWorks-cluster zijn, worden bewerkingen zoals het bijwerken van XSI-acties, XSI-gebeurtenissen, DAS-URL, XSP|ADP-URL of NST-synchronisatie niet ondersteund. In dergelijke gevallen wordt het aanbevolen contact op te nemen met een Cisco TAC-ondersteuningsmedewerker voor ondersteuning.

    Als een sjabloon is gekoppeld aan het cluster, kunt u een cluster niet verwijderen. Verwijder de gekoppelde sjablonen voordat u het cluster verwijdert. Zie Een onboardsjabloon bewerken of verwijderen in Partnerhub.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Een onboardsjabloon bewerken of verwijderen in Partner Hub

U kunt sjablonen voor onboarding bewerken of verwijderen in Partner Hub.

1

Meld u aan bij Partner Hub met uw partnerbeheergegevens op https://admin.webex.com.

2

Ga naar Instellingen en zoek het gedeelte BroadWorks-gesprekken.

3

Klik op Sjablonen weergeven.

4

Klik op de sjabloon die u wilt bewerken of verwijderen.

5

U hebt de volgende opties:

  • Bewerk de gegevens die u moet wijzigen en klik op Opslaan.
  • Klik op Verwijderen om de sjabloon te verwijderen en bevestig.

Instelling

Waarden

Notities

Accountnaam/wachtwoord inrichten

Door gebruiker geleverde tekenreeksen

U hoeft de inrichtingsaccountgegevens niet opnieuw in te voeren bij het bewerken van een sjabloon. De velden Leeg wachtwoord/Wachtwoordbevestiging zijn er om de referenties te wijzigen als dat nodig is, maar laat ze leeg om de waarden te behouden die u oorspronkelijk hebt opgegeven.

E-mailadres van de gebruiker vooraf invullen op de aanmeldpagina

Aan/uit

Het kan tot 7 uur duren voordat een wijziging in deze instelling van kracht wordt. Dat wil zeggen, nadat u deze hebt ingeschakeld, moeten gebruikers mogelijk nog steeds hun e-mailadres invoeren op het aanmeldscherm.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Webex Assistant

Webex-assistent Meetings is een intelligente, interactieve virtuele vergaderingassistent die vergaderingen doorzoekbaar, actiebaar en productiever maakt. U kunt de Webex Assistant vragen actie-items op te volgen, belangrijke beslissingen te nemen en belangrijke momenten tijdens een vergadering of gebeurtenis te markeren.

Webex Assistant voor vergaderingen is gratis beschikbaar voor vergadersites met het Premium- en Standard-pakket en voor persoonlijke vergaderruimten. Support omvat zowel nieuwe als bestaande sites.

Webex Assistant voor vergaderingen inschakelen

Webex Assistant is standaard ingeschakeld voor zowel Standard- als Premium-pakket Broadworks-klanten.

Partnerbeheerders en klantorganisatiebeheerders kunnen de functie voor klantorganisaties uitschakelen via Control Hub.

Beperkingen

De volgende beperkingen bestaan voor Webex voor Cisco BroadWorks:

  • De ondersteuning is beperkt tot vergadersites met het Premium- en Standard-pakket en alleen persoonlijke vergaderruimten.

  • Transcripties voor ondertiteling worden alleen ondersteund in het Engels, Spaans, Frans en Duits.

  • Inhoud delen via e-mail is alleen toegankelijk voor gebruikers binnen uw organisatie

  • Vergaderingsinhoud is niet toegankelijk voor gebruikers buiten uw organisatie. Vergaderingsinhoud is ook niet toegankelijk wanneer deze wordt gedeeld tussen gebruikers van verschillende pakketten binnen dezelfde organisatie.

  • Met het Premium-pakket zijn transcripties na de vergadering beschikbaar, ongeacht of Webex Assistant is in- of uitgeschakeld. Als er echter lokale opname is geselecteerd, worden er geen transcripties of markeringen na de vergadering vastgelegd.

  • Met het standaardpakket is de optie Vergadering opnemen in de cloud niet beschikbaar en zijn transcripties na de vergadering dus niet beschikbaar, ongeacht of Webex Assistant is in- of uitgeschakeld. Als lokale opname is geselecteerd, worden zelfs transcripties of markeringen na de vergadering niet vastgelegd.

Aanvullende Informatie Over Webex Assistant

Zie Webex Assistant gebruiken in Webex Meetings en Events voor gebruikersinformatie over het gebruik van de functie.

Webex-gesprekken uitschakelen

Gratis bellen via Webex is standaard ingeschakeld zodat gebruikers gratis gesprekken kunnen voeren naar elk apparaat waarvoor Webex is ingeschakeld. Als u echter wilt dat alle gesprekken de BroadWorks-infrastructuur gebruiken, kunt u Webex-gesprekken binnen een onboardsjabloon uitschakelen. Hiermee schakelt u die optie uit voor de klantorganisaties die de sjabloon gebruiken.

Functieondersteuning

Wanneer Webex Calling is uitgeschakeld, zijn de volgende voorwaarden van toepassing op Webex voor Cisco BroadWorks-gebruikers:

  • Gebruikers zien Bellen met Webex niet meer als een selecteerbare gespreksoptie in de Webex-app.

  • Gebruikers kunnen geen gratis Webex-gesprekken plaatsen of ontvangen naar niet-Webex voor Cisco BroadWorks-gebruikers. Dit omvat gesprekken die zijn gestart vanuit een Webex-teamruimte, gespreksgeschiedenis, contactpersonen door de URI of het e-mailadres van de andere gebruiker in te voeren in de zoekbalk.

  • Scherm delen werkt binnen een BroadWorks-gesprek.

  • Webex-vergaderingen en telefonische aanwezigheid werken nog steeds, zelfs als Webex-gesprekken zijn uitgeschakeld.

Webex-gesprekken uitschakelen (nieuwe onboardsjabloon)

Tijdens het configureren van een nieuwe onboardsjabloon kunt u configureren of Webex-gesprekken worden in- of uitgeschakeld door het selectievakje Gratis bellen via Cisco Webex uitschakelen in de wizard Een nieuwe sjabloon toevoegen in te schakelen of uit te schakelen. Deze instelling wordt opgehaald voor gebruikers in klantorganisaties die u aan de sjabloon toewijst.

Zie Uw partnerorganisatie configureren in Partner Hub voor meer informatie over het configureren van een nieuwe integratiesjabloon.

Webex-gesprekken uitschakelen (bestaande onboardsjabloon)

Volg deze procedure om Webex-gesprekken uit te schakelen van een bestaande integratiesjabloon. Hiermee wordt de functie uitgeschakeld voor alle nieuwe gebruikers in klantorganisaties die deze sjabloon gebruiken.

  1. Meld u aan bij Partnerhub op admin.webex.com.

  2. Kies Instellingen.

  3. Klik op Sjabloon weergeven en kies de juiste onboardingsjabloon.

  4. Klik op Cisco Webex Free Calling uitschakelen.

  5. Klik op Opslaan.

Webex-gesprekken uitschakelen (bestaande gebruiker)

Als u deze functie uitschakelt op een onboardsjabloon, wordt de instelling alleen gewijzigd voor nieuwe gebruikers die zijn toegewezen aan de sjabloon. Als u Webex-gesprekken wilt uitschakelen voor een bestaande gebruiker, kunt u een van de onderstaande procedures volgen om de gebruiker bij te werken.


 
Zorg ervoor dat u al een van de bovenstaande procedures hebt voltooid om Webex-gesprekken uit te schakelen van de onboardsjabloon waaraan de gebruiker is toegewezen. Anders configureert een van de onderstaande procedures de gebruiker opnieuw met Webex-gesprekken ingeschakeld.

Als u flow-through provisioning gebruikt, kunt u het volgende doen:

  1. Open CommPilot en ga naar de gebruikersconfiguratie.

  2. Verwijder de geïntegreerde IM+P-service van de gebruiker en klik op OK.

  3. Voeg de geïntegreerde IM+P-service toe aan de gebruiker en klik op OK.

Anders kunt u de API gebruiken om de gebruiker bij te werken.

  1. Gebruik de Een BroadWorks-abonnee-API verwijderen om de gebruiker te verwijderen.

  2. Gebruik de Een BroadWorks-abonnee-API inrichten om de gebruiker toe te voegen.

Video of scherm delen uitschakelen in gesprekken

Partnerbeheerders kunnen configuratietags gebruiken om videogesprekken en/of scherm delen uit te schakelen in een gesprek vanuit de Webex-app (beide mediatypen zijn standaard ingeschakeld voor gesprekken).

Zie Videogesprekken uitschakelen en Scherm delen uitschakelen in de configuratiehandleiding van Webex voor Cisco BroadWorks voor meer informatie over de configuratie en opties.


 
Voor video kunt u ook configureren of media voor inkomende gesprekken standaard alleen video of audio zijn.

Busy Lamp Field (BLF)/melding voor gesprek opnemen

Busy Lamp Field (BLF)/melding voor gesprek opnemen maakt gebruik van de functies BLF en doorverbonden gesprek opnemen. Een BLF-gebruiker ontvangt een auditieve en visuele melding in de Webex-app wanneer een gebruiker uit de BLF-bewaakte lijst een binnenkomend gesprek ontvangt. De BLF-gebruiker kan het gesprek van de gecontroleerde gebruiker negeren of opnemen.

De BLF-/Call Pickup-melding helpt in situaties waarin een gebruiker gesprekken moet beantwoorden voor andere teamleden die op een andere locatie werken.

Gebruikers kunnen hun door BLF gecontroleerde lijst ook zien in het gedeelte Multi-gespreksvenster - Wachtlijst - (alleen Windows, Mac niet ondersteund) om de aanwezigheid van hun Webex- en niet-Webex-teamleden te zien. Webex-leden hebben een volledige Webex-aanwezigheid. Niet-Webex-leden moeten worden gesynchroniseerd met een telefoonlijst in Webex. Ze hebben alleen de status 'onbekend' en 'in-a-call' (de belstatus activeert het dialoogvenster voor gesprek opnemen).

Beperkingen van aanwezigheid voor niet-Webex-gebruikers:

  1. Aanwezigheid wordt niet ondersteund voor niet-CI Broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.

  2. CI-gebruikers zonder Webex-cloudrechten of computertype accounts (werkplekken) geven alleen aanwezigheid 'in gesprek' en 'onbekend' weer. Er is geen status actief, overgaan, enz.

  3. Niet-Webex-gebruikers uit de BLF-volglijst, die een gesprek hebben gestart voordat de Webex-client werd gestart of terwijl deze offline was, worden weergegeven met een 'onbekende' aanwezigheid.

  4. Als u uw verbinding verliest, worden alle niet-Webex-gespreksstatussen bij het opnieuw verbinden teruggezet op 'onbekend'.

  5. Als een niet-Webex-gebruiker van de BLF een gesprek heeft, wordt dit gesprek nog steeds weergegeven als 'in een gesprek'.

Vereisten

Zorg ervoor dat de volgende patches worden toegepast op BroadWorks. Installeer alleen de patches die van toepassing zijn op uw versie:

Voor R22:

  • AP.platform.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382362

  • AP.xsp.22.0.1123.ap382053

  • AP.xsp.22.0.1123.ap382362

  • AP.as.22.0.1123.ap383459

  • AP.as.22.0.1123.ap383520

Voor R23:

  • AP.platform.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382362

  • AP.as.23.0.1075.ap383459

  • AP.as.23.0.1075.ap383520

  • Als u XSP|ADP gebruikt:

    • AP.xsp.23.0.1075.ap382053

    • AP.xsp.23.0.1075.ap382362

  • Als u ADP gebruikt:

    • Xsi-Actions-23_2022.01_1.200.bwar

    • Xsi-Events-23_2022.01_1.201.bwar (of hoger)

Voor R24:

  • AP.as.24.0.944.ap382053

  • AP.as.24.0.944.ap382362

  • AP.as.24.0.944.ap383459

  • AP.as.24.0.944. ap383520

  • Xsi-Actions-24_2022.01_1.200.bwar

  • Xsi-Events-24_2022.01_1.201.bwar (of hoger)

Zorg ervoor dat de volgende configuratietags zijn ingeschakeld in de Webex-app:

  • <busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">

  • <display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>

  • <notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>(deze tag is optioneel)

U moet functie 101642 Verbeterd Xsi-mechanisme Voor Teamtelefonie activeren op de AS:

AS_CLI/System/ActivatableFeature> activate 101642

Inschakelen X-BroadWorks-Remote-Party-Info op de AS met de onderstaande CLI-opdracht omdat voor sommige SIP-gespreksstromen deze functie nodig is:

AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Zorg ervoor dat de volgende services zijn toegewezen aan gebruikers:

  • De service Doorverbonden gesprek aannemen toewijzen voor alle gebruikers

  • Busy Lamp Field instellen voor gebruikers


 
Elke verwijzing naar XSP omvat XSP of ADP.

Busy Lamp Field configureren op BroadWorks

Partnerbeheerders kunnen de volgende procedure gebruiken om Busy Lamp Field in te stellen voor een gebruiker.

  1. Meld u aan bij BroadWorks CommPilot.

  2. Ga voor een geselecteerde gebruiker naar Clienttoepassingen en configureer het Busy Lamp Field.

  3. Voeg de URL van de BLF-lijst toe die wordt gecontroleerd.

  4. Gebruik de zoekparameters om gebruikers te zoeken en toe te voegen aan de lijst Bewaakte gebruikers.

  5. Klik op OK.

Slido Integratieondersteuning

Webex voor Cisco BroadWorks ondersteunt integratie van de Webex-app met Slido.

Slido is een eenvoudig te gebruiken tool voor betrokkenheid van het publiek. Het helpt mensen om het meeste uit vergaderingen te halen door de kloof tussen sprekers en hun publiek te overbruggen. Wanneer Slido is geïntegreerd in uw Control Hub-organisatie, kunnen uw gebruikers de Slido app toevoegen aan hun vergaderingen in de Webex-app. Deze integratie biedt extra vraag en antwoord en enquêtefunctionaliteit voor de vergadering.

Zie SlidoIntegreren met Webex-appSlido voor meer informatie over het implementeren en gebruiken met de Webex-app.

Webex-beschikbaarheid: In een agendavergadering

Wanneer u een vergadering in uw Outlook-client hebt geaccepteerd die een afspraak, ad-hocvergadering of een niet-Webex-vergadering is, wordt uw Webex-beschikbaarheid weergegeven als 'In een agendavergadering'. Deze beschikbaarheid laat uw collega's weten dat u anders betrokken bent en dat een reactie kan worden vertraagd.

Deze functie inschakelen:

  1. ga naar het tabblad Algemeen van uw tabblad Instellingen in Windows of Voorkeuren op de Mac.

  2. Schakel het selectievakje Weergeven in een agendavergadering in.


 
Voor gebruikers met ingeschakelde Outlook-aanwezigheidsintegratie wordt 'In een agendavergadering' in Webex toegewezen aan 'Bezet' in Outlook.

Caveat

Om deze functie te laten werken, moet de Webex-app en de Outlook-client tegelijkertijd worden uitgevoerd.

We werken momenteel aan de ondersteuning van de optie 'Show as Working Elsewhere' in Outlook om een gebruiker niet weer te geven als 'In een agendavergadering' in Webex.

Als een gebruiker ervoor kiest om 'Weergeven wanneer in een agendavergadering' uit te schakelen terwijl hij of zij momenteel in een agendavergadering zit, wordt zijn of haar aanwezigheid pas bijgewerkt wanneer de vergadering is beëindigd. Hiervoor moet de client opnieuw worden gestart om op te halen.

Automatisch beantwoorden met toon

Met automatisch beantwoorden met toon kunnen gebruikers bellen vanuit een app van derden, zoals Contact Center, en wordt het gesprek automatisch gerouteerd via de Webex-app op hun bureaublad. Wanneer de Webex-app de andere partij belt, hoort de gebruiker een bepaalde toon met het advies dat het gesprek wordt verbonden.

Voor een Webex voor Cisco BroadWorks-gebruiker om deze functie te gebruiken:

  • De functie wordt alleen ondersteund op de weergave van de primaire lijn

  • De Webex-app moet de primaire lijnweergave zijn

  • De %ENABLE_AUTO_ANSWER_WXT%-tag moet zijn ingeschakeld

Als de gebruiker ook Gedeelde gespreksweergaven heeft (een bureautelefoon wordt bijvoorbeeld geconfigureerd als een van de weergaven van de secundaire lijn), wordt de functie nog steeds ondersteund op de primaire weergave zolang de weergaven van gedeelde gesprekken zijn geconfigureerd om geen inkomende gesprekken te ontvangen. Dit kan worden bereikt door een van de volgende drie voorwaarden te configureren in BroadWorks voor alle gedeelde gespreksweergaven:

  • Alle weergaven voor Click-to-Dial-gesprekken waarschuwen is uitgeschakeld in de configuratie voor weergave gedeeld gesprek. Dit is de aanbevolen aanpak

    of

  • Beëindiging toestaan op deze locatie moet zijn uitgeschakeld voor alle gedeelde gespreksweergaven of

    of

  • Locaties zijn uitgeschakeld voor alle weergaven van gedeelde gesprekken

Capaciteit verhogen

XSP|ADP-bedrijven

We raden u aan de capaciteitsplanner te gebruiken om te bepalen hoeveel extra XSP|ADP-resources u nodig hebt voor de voorgestelde toename van het aantal abonnees. Voor de speciale NPS of Webex voor Cisco BroadWorks-boerderijen hebt u de volgende schaalbaarheidsopties:

  • Schaalspecifieke boerderij: Voeg een of meer XSP|ADP-servers toe aan het bedrijf die extra capaciteit nodig hebben. Installeer en activeer dezelfde set toepassingen en configuraties als de bestaande knooppunten van de boerderij.

  • Specifieke boerderij toevoegen: Voeg een nieuwe, specifieke XSP|ADP-boerderij toe. U moet een nieuw cluster en nieuwe sjablonen maken in Partner Hub, zodat u nieuwe klanten kunt toevoegen op de nieuwe boerderij om de druk op de bestaande boerderij te verlichten.

  • Gespecialiseerde boerderij toevoegen: Als u knelpunten ondervindt voor een bepaalde service, wilt u mogelijk een afzonderlijke XSP|ADP-farm creëren voor dat doel, rekening houdend met de vereisten voor co-residency vermeld in dit document. Mogelijk moet u uw Control Hub-clusters en DNS-vermeldingen opnieuw configureren als u de URL wijzigt van de service met een nieuwe boerderij.

In alle gevallen is het uw verantwoordelijkheid om uw BroadWorks-omgeving te controleren en te bevoorraden. Als u Cisco-ondersteuning wilt inschakelen, kunt u contact opnemen met uw accountvertegenwoordiger, die professionele services kan regelen.

HTTP-servercertificaten beheren

U moet deze certificaten voor mTLS-geverifieerde webtoepassingen beheren op uw XSP|ADP's:

  • Ons certificaat voor de vertrouwensketen van de Webex-cloud

  • De certificaten van uw XSP|ADP HTTP-serverinterfaces

Vertrouwensketen

U downloadt het certificaat van de vertrouwensketen van Control Hub en installeert het op uw XSP|ADP's tijdens uw eerste configuratie. We verwachten dat u het certificaat bijwerkt voordat het verloopt en u informeert over hoe en wanneer u het kunt wijzigen.

Uw HTTP-serverinterfaces

De XSP|ADP moet een openbaar ondertekend servercertificaat presenteren aan Webex, zoals wordt beschreven in Certificaten bestellen. Er wordt een zelfondertekend certificaat gegenereerd voor de interface wanneer u de interface voor het eerst beveiligt. Dit certificaat is één jaar geldig vanaf die datum. U moet het zelfondertekende certificaat vervangen door een openbaar ondertekend certificaat. Het is uw verantwoordelijkheid om een nieuw certificaat aan te vragen voordat het verloopt.

Beperkt door partnermodus

Beperkt door de partnermodus is een Partner Hub-instelling die partnerbeheerders kunnen toewijzen aan specifieke klantorganisaties om de organisatie-instellingen te beperken die klantbeheerders kunnen bijwerken in Control Hub. Wanneer deze instelling is ingeschakeld voor een bepaalde klantorganisatie, hebben alle klantbeheerders van die organisatie, ongeacht hun rolrechten, geen toegang tot een set beperkte besturingselementen in Control Hub. Alleen een partnerbeheerder kan de beperkte instellingen bijwerken.


 
Beperkt door de partnermodus is een instelling op organisatieniveau in plaats van een rol. De instelling beperkt echter specifieke rolrechten voor klantbeheerders in de organisatie waarop de instelling wordt toegepast.

Toegang als klantbeheerder

Klantbeheerders ontvangen een melding wanneer de modus Beperkt door partner wordt toegepast. Nadat ze zich hebben aangemeld, zien ze een meldingsbanner boven aan het scherm, direct onder de Control Hub-koptekst. De banner informeert de klantbeheerder dat de beperkte modus is ingeschakeld en dat deze bepaalde gespreksinstellingen mogelijk niet kan bijwerken.

Voor een klantbeheerder in een organisatie waar de modus Beperkt door partner is ingeschakeld, wordt het toegangsniveau van Control Hub bepaald met de volgende formule:

(Toegang tot Control Hub) = (rechten van organisatierol) - (beperkt door beperkingen in de partnermodus)

Beperkingen

Wanneer de modus Beperkt door partner is ingeschakeld voor een klantorganisatie, hebben klantbeheerders in die organisatie geen toegang tot de volgende Control Hub-instellingen:

  • In de weergave Gebruikers zijn de volgende instellingen niet beschikbaar:

    • De knop Gebruikers beheren is grijs.

    • Gebruikers handmatig toevoegen of wijzigen: er is geen optie om gebruikers handmatig of via CSV toe te voegen of te wijzigen.

    • Gebruikers claimen: niet beschikbaar

    • Licenties automatisch toewijzen: niet beschikbaar

    • Adreslijstsynchronisatie -Kan instellingen voor directorysynchronisatie niet bewerken (deze instelling is alleen beschikbaar voor beheerders op partnerniveau).

    • Gebruikersgegevens: gebruikersinstellingen zoals voornaam, achternaam, weergavenaam en primair e-mailadres* kunnen worden bewerkt.

    • Pakket herstellen: er is geen optie om het pakkettype te herstellen.

    • Services bewerken: er is geen optie om de services te bewerken die zijn ingeschakeld voor een gebruiker (bijvoorbeeld Berichten, Vergaderingen, Bellen)

    • Status van services weergeven: kan de volledige status van hybride services of software-upgradekanaal niet zien

    • Primair werknummer: dit veld is alleen-lezen.

  • In de weergave Account zijn de volgende instellingen niet beschikbaar:

    • Bedrijfsnaam is alleen-lezen.

  • In de weergave Organisatie-instellingen zijn de volgende instellingen niet beschikbaar:

    • Domein: toegang is alleen-lezen.

    • E-mail: de instellingen voor E-mailuitnodiging beheerder onderdrukken en Landinstelling e-mailadres zijn alleen-lezen.

    • Verificatie: er is geen optie om de instellingen Verificatie en SSO te bewerken.

  • In het menu Bellen zijn de volgende instellingen niet beschikbaar:

    • Gespreksinstellingen: de instellingen voor gespreksprioriteit van de appopties zijn alleen-lezen.

    • Belgedrag: instellingen zijn alleen-lezen.

    • Locatie > PSTN: de opties Lokale gateway en Cisco PSTN zijn verborgen.

  • Onder SERVICES worden de serviceopties Migraties en Verbonden UC onderdrukt.

Beperkt door partnermodus inschakelen

Partnerbeheerders kunnen de onderstaande procedure gebruiken om: Beperkt door partnermodus voor een bepaalde klantorganisatie (de standaardinstelling is ingeschakeld).

  1. Meld u aan bij Partnerhub ( https://admin.webex.com) en selecteer Klanten.

  2. Selecteer de toepasselijke klantorganisatie.

  3. Schakel in de instellingenweergave aan de rechterkant de Beperkt door partnermodus toggle om de instelling in te schakelen.

    Als u de modus Beperkt door partner wilt uitschakelen, schakelt u de schakelaar uit.


 

Als de partner de beperkte beheermodus voor een klantbeheerder verwijdert, kan de klantbeheerder het volgende uitvoeren:

  • Webex voor groothandels toevoegen (met de knop)

  • Pakketten voor een gebruiker wijzigen

Partneranalyses

Dankzij verbeteringen in Control Hub kunnen partnerbeheerders eenvoudig pakketgegevens weergeven en bijwerken namens hun gebruikers. Deze functie biedt partners de mogelijkheid om een totaaloverzicht van alle klanten te krijgen en bevat de volgende details:

  • Totaal aantal gebruikers per pakket (Softphone, Basic, Standard, Premium)

  • Gebruiker per pakkettrend (dagelijks/wekelijks/maandelijks)

  • Klanten met het aantal toegewezen pakketten

Raadpleeg het Webex artikel voor volledige informatie over het gebruik van Partner Analytics Analyse voor Webex voor groothandel en Webex voor Broadworks-pakketten in Partner Hub .

API's voor factureringsrapport

Webex for Developers biedt openbare API's die kunnen worden gebruikt voor maandelijkse factureringsrapporten. Partnerbeheerders kunnen deze API's gebruiken om factureringsrapporten te maken, op te sommen, op te halen en te verwijderen. De volgende tabel bevat de API's, het type toegang dat vereist is en de rolvereisten.

API voor facturering

Doel

Type toegang

Rolvereiste voor API

(Beheerder vereist ten minste één van deze rollen)

Een BroadWorks-factureringsrapport maken

Wordt gebruikt om een factureringsrapport te genereren.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

BroadWorks-factureringsrapporten weergeven

Wordt gebruikt om de rapporten weer te geven die beschikbaar zijn om te bekijken.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks-factureringsrapport ophalen

Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks-factureringsrapport verwijderen

Wordt gebruikt om een gegenereerd rapport te verwijderen.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

Factureringsvelden

In de volgende tabel worden de velden weergegeven die in het gegenereerde rapport zijn opgenomen.

Veld

Beschrijving

resellerNaam

Partnernaam of organisatie-id van partner

billingId

Unieke facturerings-id of C-nummer van partner

spEnterprise-id

De door de serviceprovider geleverde unieke id voor de onderneming van de abonnee.

Intern

De status van de interne proefperiode van de klant (ja/nee)

userId

De gebruikers-id van de abonnee op BroadWorks

abonnee-id

Een unieke id voor de abonnee in kwestie in Webex

zelf geactiveerd

Ja/Nee

eersteStartdatum

Datum waarop de abonnee is ingericht.

factureringStartdatum

Datum waarop facturering begint in deze maand

Einddatum facturering

Datum waarop facturering deze maand eindigt

pakket

Het pakkettype dat in rekening wordt gebracht

hoeveelheid

Geprorateerde hoeveelheid voor facturatie.

  • 1: geeft een volledige maand aan


 
  • Nadat u een factureringsrapport voor een specifieke periode hebt gegenereerd, kunt u dat rapport niet opnieuw genereren, tenzij u eerst het bestaande rapport verwijdert.

  • Als u het pakkettype of de BroadWorks-gebruikers-id voor een bepaalde gebruiker wijzigt, worden in het rapport voor de maand waarin de wijziging heeft plaatsgevonden meerdere vermeldingen voor die gebruiker weergegeven met afzonderlijke geprorateerde vermeldingen voor en na de wijziging.

Problemen met Webex voor Cisco BroadWorks oplossen

Abonneren op de statuspagina van Webex

Controleer eerst https://status.webex.com wanneer u een onverwachte onderbreking van de service ervaart. Als u uw configuratie in Control Hub of BroadWorks niet hebt gewijzigd vóór de onderbreking, controleert u de statuspagina. Lees meer over het abonneren op status- en incidentmeldingen in het Webex-helpcentrum.

Analyse van Control Hub gebruiken

Webex houdt gebruiks- en kwaliteitsgegevens bij voor uw organisatie en de organisaties van uw klant. Lees meer over de Control Hub-analyse in het Webex-helpcentrum.

Netwerkproblemen

Klanten of gebruikers worden niet gemaakt in Control Hub met flowthrough-inrichting:

  • Kan de toepassingsserver de inrichtings-URL bereiken?

  • Zijn het inrichtingsaccount en het wachtwoord correct? Bestaat dat account in BroadWorks?

Clusters falen consequent in verbindingstests:


 

Er wordt verwacht dat de mTLS-verbinding met de verificatieservice mislukt wanneer u het eerste cluster in Partner Hub maakt, omdat u het cluster moet maken om toegang te krijgen tot de Webex-certificaatketen. Zonder dat kunt u geen vertrouwensanker maken voor de verificatieservice XSP|ADP's. De mTLS-verbinding testen vanuit Partner Hub is dus niet gelukt.

  • Zijn de XSP|ADP-interfaces openbaar toegankelijk?

  • Gebruikt u de juiste poorten? U kunt een poort invoeren in de interfacedefinitie op het cluster.

Validatie van interfaces mislukt

Xsi-acties en Xsi-events-interfaces:

  • Controleer of de interface-URL's juist zijn ingevoerd op het cluster in Partner Hub, inclusief de /v2.0/ aan het einde van de URL's.
  • Controleer of de firewall communicatie tussen Webex en deze interfaces mogelijk maakt.

  • Bekijk het advies voor interfaceconfiguratie in dit document.

Interface voor verificatieservice:

  • Controleer of de interface-URL's juist zijn ingevoerd op het cluster in Partner Hub, inclusief de /v2.0/ aan het einde van de URL's.
  • Controleer of de firewall communicatie tussen Webex en deze interfaces mogelijk maakt.

  • Bekijk het advies voor interfaceconfiguratie in dit document, met bijzondere aandacht voor:

    1. Zorg ervoor dat u RSA-sleutels hebt gedeeld met alle XSP|ADP's.
    2. Zorg ervoor dat u op alle XSP|ADP's de AuthService-URL voor de webcontainer hebt opgegeven.
    3. Als u de TLS-coderingsconfiguratie hebt bewerkt, controleert u of u de juiste naamgevingsconventie hebt gebruikt. Voor de XSP|ADP moet u de IANA-naamnotatie voor de TLS-cijfers invoeren. In een eerdere versie van dit document zijn de vereiste versleutelingssuites onjuist vermeld in de naamgevingsconventie van OpenSSL.
    4. Als u mTLS gebruikt met de verificatieservice, worden de Webex-clientcertificaten dan geladen in uw XSP|ADP/ADP-vertrouwensarchief? Is de app (of de interface) geconfigureerd om clientcertificaten te vereisen?

    5. Als u CI-tokenvalidatie gebruikt met de verificatieservice, is de app (of interface) dan geconfigureerd om geen clientcertificaten te vereisen?

Clientproblemen

Controleer of de client is verbonden met BroadWorks

  1. Meld u aan bij de Webex-app.

  2. Controleer of het pictogram Gespreksopties (een handset met een versnelling erboven) aanwezig is op de zijbalk.

    Als het pictogram niet aanwezig is, is de gebruiker mogelijk nog niet ingeschakeld voor de gespreksservice in Control Hub.

  3. Open het menu Instellingen/Voorkeuren en ga naar het gedeelte Telefoonservices. U ziet de status SSO-sessie Waarvoor U bent aangemeld.

    Als een andere telefoonservice, zoals Webex Calling, wordt weergegeven, gebruikt de gebruiker Webex niet voor Cisco BroadWorks.

Deze verificatie betekent:

  • De client heeft de vereiste Webex-microservices getransverseerd.

  • De gebruiker is geverifieerd.

  • De client heeft een langlevend JSON-webtoken ontvangen van uw BroadWorks-systeem.

  • De client heeft zijn apparaatprofiel opgehaald en geregistreerd bij BroadWorks.

Clientlogboeken

Alle clients van de Webex-app kunnen logboeken Verzenden naar Webex. Dit is de beste optie voor mobiele clients. U moet ook het e-mailadres van de gebruiker noteren en de geschatte tijd waarop het probleem is opgetreden als u hulp zoekt bij TAC. Zie Waar vind ik ondersteuning voor Webex voor meer informatie?

Als u handmatig logboeken moet verzamelen vanaf een Windows-pc, bevinden ze zich als volgt:

Windows-pc: C:\Users\{username}\AppData\Local\CiscoSpark

Mac:/Users/{username}/Library/Logs/SparkMacDesktop

Problemen met aanmelden gebruiker

mTLS-verificatie verkeerd geconfigureerd

Als alle gebruikers zijn getroffen, controleert u de mTLS-verbinding van Webex met uw verificatieservice-URL:

  • Controleer of de toepassing voor de verificatieservice of de interface die wordt gebruikt, is geconfigureerd voor mTLS.

  • Controleer of de Webex-certificaatketen is geïnstalleerd als vertrouwensanker.

  • Controleer of het servercertificaat op de interface/toepassing geldig is en ondertekend is door een bekende CA.

Bericht over licentieoverschrijding

Dit bericht kan voor een klant worden weergegeven in de klantweergave van Partnerhub. Dit bericht wordt weergegeven wanneer het licentiegebruik hoger is dan wat in de licentie is toegestaan. Het bericht kan worden genegeerd.

Handleiding voor probleemoplossing

Voor gedetailleerde informatie over het oplossen van problemen met Webex voor Cisco BroadWorks raadpleegt u de Handleiding voor het oplossen van problemen met Webex voor Cisco BroadWorks.

Ondersteuning

Ondersteuningsbeleid voor steady-state

De Dienstverlener is het eerste aanspreekpunt voor de eindklant (enterprise) support. Escaleer problemen die de SP niet kan oplossen naar TAC. Ondersteuning voor BroadWorks-serverversies volgt het BroadSoft-beleid van de huidige versie en twee eerdere grote versies (N-2). Lees meer op Beleid voor de levenscyclus van BroadSoft-producten sectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.

Escalatiebeleid

  • U (serviceprovider/partner) bent het eerste aanspreekpunt voor ondersteuning van eindklanten (enterprise).

  • Problemen die niet door de SP kunnen worden opgelost, worden geëscaleerd naar TAC.

BroadWorks-versies

Resources voor zelfondersteuning

  • Gebruikers kunnen ondersteuning vinden via het Webex-helpcentrum, waar er een Webex voor Cisco BroadWorks-specifieke pagina is met algemene help- en ondersteuningsonderwerpen voor de Webex-app.

  • De Webex-app kan worden aangepast met deze Help-URL en de URL van een probleemrapport.

  • Gebruikers van de Webex-app kunnen feedback of logboeken rechtstreeks vanaf de client verzenden. De logboeken gaan naar de Webex-cloud, waar ze kunnen worden geanalyseerd door Webex DevOps.

  • We hebben ook een Help Center-pagina die is toegewezen aan Help op beheerdersniveau voor Webex voor Cisco BroadWorks.

Informatie verzamelen om een serviceaanvraag in te dienen

Wanneer u fouten ziet in Control Hub, hebben ze mogelijk informatie bijgevoegd die TAC kan helpen uw probleem te onderzoeken. Als u bijvoorbeeld een traceer-id ziet voor een bepaalde fout of een foutcode, slaat u de tekst op om met ons te delen.

Probeer ten minste de volgende informatie op te nemen wanneer u een query indient of een case opent:

  • Organisatie-id van de klant en de organisatie-id van de partner (elke id is een tekenreeks van 32 hexadecimale tekens, gescheiden door koppeltekens)

  • TrackingID (ook een tekenreeks van 32 hexadecimale cijfers) als de interface of het foutbericht er een bevat

  • E-mailadres gebruiker (als een bepaalde gebruiker problemen ondervindt)

  • Clientversies (als het probleem symptomen heeft die door de client worden opgemerkt)

Webex voor BroadWorks-referentie

UC-One SaaS-vergelijking met Webex voor Cisco BroadWorks

Oplossing >

UC-One SaaS

Webex voor Cisco BroadWorks

Cloud

Cisco UC-One Cloud (GCP)

Webex-cloud (AWS)

Clients

UC-One: Mobiel, bureaublad

Receptionist, supervisor

Webex: Mobiel, Desktop, Web

Groot technologieverschil

Vergaderingen geleverd op Broadsoft Meet-technologie

Vergaderingen geleverd via Webex Meetings-technologie

Vroege veldproeven

Staging-omgeving, bètaclients

Productieomgeving, GA-klanten

Gebruikersidentiteit

BroadWorks-id diende als primaire id, tenzij de serviceprovider al SSO-integratie heeft.

 

Gebruikers-id en geheim in BroadWorks

E-mail-id in Cisco CI dient als primaire id

SSO-integratie in serviceprovider BroadWorks waarbij de gebruiker zich op dat moment verifieert met de BroadWorks-gebruikers-id en BroadWorks-geheim.

 

Gebruiker levert referenties via SSO met BroadWorks en geheim in BroadWorks

OF

Gebruikers-id en geheim in CI IdP

OF

Gebruikers-id in CI, ID en geheimen in IdP

Clientverificatie

Gebruikers leveren referenties via client

BroadWorks-tokens met een lange levensduur vereist bij gebruik van Webex-berichten

Gebruikers leveren referenties via de browser (aanmeldingspagina van Webex BIdP-proxy of CI)

Webex-toegangs- en vernieuwingstokens

Beheer / configuratie

Uw OSS/BSS-systemen en

Doorverkoopportaal

Uw OSS/BSS-systemen en Control Hub

Activering van partner/serviceprovider

Eenmalige installatie door Cisco Operations

Eenmalige installatie door Cisco Operations

Activering van klant/onderneming

Doorverkoopportaal

Control Hub

Automatisch gemaakt bij inschrijving eerste gebruiker

Activeringsopties voor de gebruiker

Zelfingeschreven

Externe IM&P instellen in BroadWorks

Geïntegreerde IM&P instellen in BroadWorks (doorgaans bedrijven)

XSP|ADP-serviceinterfaces

XSI-acties

 

XSI-gebeurtenissen

CTI (mTLS)

Verificatieservice (mTLS optioneel)

DMS

XSI-acties

XSI-acties (mTLS)

XSI-gebeurtenissen

CTI (mTLS)

Verificatieservice (TLS)

DMS

Webex installeren en aanmelden (Subscriber Perspective)

1

Download en installeer Webex. Zie Webex | De app downloaden voor meer informatie.

2

Webex uitvoeren.

Webex vraagt u naar uw e-mailadres.
3

Voer uw e-mailadres in en klik op Volgende.

4

Afhankelijk van de manier waarop uw organisatie in Webex is geconfigureerd, vindt een van de volgende handelingen plaats:

  1. Webex start een browser waarmee u de verificatie met uw identiteitsprovider kunt voltooien. Dit kan meervoudige verificatie (MFA) zijn.

  2. Webex start een browser waarin u uw BroadWorks-gebruikers-id en -wachtwoord kunt invoeren.

Webex wordt geladen nadat u bent geverifieerd met de IdP of BroadWorks.

Gegevensuitwisseling en -opslag

Deze secties bevatten details over gegevensuitwisseling en opslag met Webex. Alle gegevens worden zowel in transit als in rust versleuteld. Zie Beveiliging van de Webex-app voor meer informatie.

Onboarding serviceprovider

Wanneer u clusters en gebruikerssjablonen configureert in Webex Control Hub tijdens de onboarding van serviceproviders, wisselt u de volgende BroadWorks-gegevens uit die Webex opslaat:

  • URL Xsi-acties

  • URL van Xsi-Events

  • URL CTI-interface

  • URL verificatieservice

  • Referenties voor BroadWorks-inrichtingsadapter

Gebruikersvoorzieningen serviceprovider

Deze tabel bevat gebruikers- en bedrijfsgegevens die worden uitgewisseld als onderdeel van gebruikersvoorzieningen via de Webex-API's.

Gegevens verplaatsen naar Webex

Van

Door

Opgeslagen door Webex?

Gebruikers-id voor BroadWorks

BroadWorks, volgens API

Webex-API's

Ja

E-mail (indien SP verstrekt)

BroadWorks, volgens API

Webex-API's

Ja

E-mail (indien door gebruiker opgegeven)

Gebruiker

Portal voor gebruikersactivering

Ja

Voornaam

BroadWorks, volgens API

Webex-API's

Ja

Achternaam

BroadWorks, volgens API

Webex-API's

Ja

Primair telefoonnummer

BroadWorks, volgens API

Webex-API's

Ja

Mobiel telefoonnummer

BroadWorks, volgens API

Webex-API's

Ja

Primair toestel

BroadWorks, volgens API

Webex-API's

Ja

BroadWorks-serviceprovider-id en groeps-id

BroadWorks, volgens API

Webex-API's

Ja

Taal

BroadWorks, volgens API

Webex-API's

Ja

Tijdzone

BroadWorks, volgens API

Webex-API's

Ja

Gebruiker verwijderen

Webex voor Cisco BroadWorks API's ondersteunen zowel gedeeltelijke als volledige verwijdering van gebruikers. Deze tabel bevat alle gebruikersgegevens die zijn opgeslagen tijdens het inrichten en wat in elk scenario wordt verwijderd.

Gebruikersgegevens

Gedeeltelijke verwijdering

Volledige verwijdering

Gebruikers-id voor BroadWorks

Ja

Ja

E-mail

Nee

Ja

Voornaam

Nee

Ja

Achternaam

Nee

Ja

Primair telefoonnummer

Ja

Ja

Mobiel telefoonnummer

Ja

Ja

Extensie

Ja

Ja

BroadWorks-serviceprovider-id en groeps-id

Ja

Ja

Taal

Nee

Ja

Gebruikersaanmelding en configuratie ophalen

Webex-verificatie

Webex-verificatie verwijst naar aanmelding van gebruikers bij een Webex-app door een van de Webex-ondersteuningsmechanismen. ( BroadWorks-verificatie wordt afzonderlijk behandeld.) In deze tabel wordt het type gegevens weergegeven dat tussen de verschillende componenten van de verificatiestroom wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via de Webex-app

Webex

Beperkt toegangstoken en (onafhankelijke) IdP-URL

Webex

Gebruikersbrowser

Gebruikersgegevens

Gebruikersbrowser

Identiteitsprovider (die al gebruikersidentiteit heeft)

SAML-verklaring

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Tokens voor toegang en vernieuwing

Webex

Gebruikersbrowser

Tokens voor toegang en vernieuwing

Gebruikersbrowser

Webex-app

BroadWorks-verificatie

BroadWorks-verificatie verwijst naar aanmelding van gebruikers bij een Webex-app met hun BroadWorks-referenties. In deze tabel wordt het type gegevens weergegeven dat tussen de verschillende componenten van de verificatiestroom wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via de Webex-app

Webex

Token voor beperkte toegang en IdP-URL (Webex Bwks IdP-proxy)

Webex

Gebruikersbrowser

Brandinginformatie en BroadWorks-URL's

Webex

Gebruikersbrowser

BroadWorks-gebruikersreferenties

Gebruiker via browser (aanmeldingspagina met merknaam, bediend door Webex)

Webex

BroadWorks-gebruikersreferenties

Webex

BroadWorks

BroadWorks-gebruikersprofiel

BroadWorks

Webex

SAML-verklaring

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Tokens voor toegang en vernieuwing

Webex

Gebruikersbrowser

Tokens voor toegang en vernieuwing

Gebruikersbrowser

Webex-app

Melding van verlopen BroadWorks-wachtwoord tijdens aanmelden

Deze functie verbetert het aanmeldproces en bepaalt de aanmeldstroom op basis van:

Verbetering van aanmeldwaarschuwing en foutberichten:

  • Op dit moment krijgen de Wexbex voor BWKS-gebruikers die gebruikmaken van BroadWorks-verificatie en -aanmelding via de UAP geen melding dat hun wachtwoord bijna verloopt of dat ze zich niet kunnen aanmelden omdat het wachtwoord al is verlopen. Als het wachtwoord over 10 dagen of minder verloopt, ontvangt de gebruiker met deze functie een waarschuwing dat het wachtwoord bijna verloopt en wordt aangegeven hoeveel dagen er nog over zijn. De gebruiker wordt geadviseerd contact op te nemen met de partner of de koppeling Wachtwoord vergeten op het aanmeldscherm te volgen om het wachtwoord opnieuw in te stellen.
  • Als het wachtwoord is verlopen en de configuratie in BroadWorks 'enforcePasswordChangeOnExpiry' is ingesteld op waar, is de fout 'onjuiste gebruikersnaam en wachtwoord' gegooid, maar nu met deze functie is het foutbericht verbeterd: De aanmeldpoging is mislukt De combinatie van de gebruikersnaam en het wachtwoord komt niet overeen met onze gegevens of uw wachtwoord moet worden bijgewerkt. Probeer het opnieuw of neem contact op met uw beheerder om het wachtwoord bij te werken. Foutcode 100006

Aanmeldstroom beheren:

  • De partner kan de aanmelding beperken door een instelling 'w4bwks-password-expiry-fail-login' in of uit te schakelen. Als BroadWorks-wachtwoord is verlopen, wordt de configuratie in BroadWorks 'enforcePasswordChangeOnExpiry' ingesteld op onwaar en wordt de instelling 'w4bwks-password-expiry-fail-login' ingeschakeld. Vervolgens wordt een fout geslingerd die zegt dat het wachtwoord x dagen geleden is verlopen, terwijl als de instellingsservice is uitgeschakeld, inloggen is toegestaan. De instelling is standaard uitgeschakeld.

De koppeling Wachtwoord vergeten op de aanmeldpagina kan door de partner worden geconfigureerd als onderdeel van de functie Geavanceerde aanpassing. Partners zouden de koppeling doorgaans configureren om de gebruiker naar een partnerportal te navigeren voor wachtwoordbeheer en het opnieuw instellen van het wachtwoord.


 

Deze functie verbetert alleen de aanmeldingservaring van de gebruiker tijdens het aanmelden van de geactiveerde gebruiker wanneer het wachtwoord op het punt staat te verlopen of al is verlopen. De functie wordt niet verwerkt als een wachtwoord verloopt terwijl de gebruiker is aangemeld bij de Webex-app. Bij de volgende aanmeldpoging krijgt de gebruiker een melding voor het verlopen van het wachtwoord.

De instelling 'w4bwks-password-expiry-fail-login' wordt op verzoek van een partner ingeschakeld of uitgeschakeld door Cisco.

Clientconfiguratie ophalen

Deze tabel toont het type gegevens dat tussen de verschillende componenten wordt uitgewisseld tijdens het ophalen van clientconfiguraties.

Gegevens verplaatsen

Van

Doel

Registratie

Klant

Webex

Organisatie-instellingen, inclusief BroadWorks-URL's

Webex

Klant

JWT-token voor BroadWorks

BroadWorks via Webex

Klant

JWT-token voor BroadWorks

Klant

BroadWorks

Apparaattoken

BroadWorks

Klant

Apparaattoken

Klant

BroadWorks

Configuratiebestand

BroadWorks

Klant

Gebruik bij steady-state

In dit gedeelte worden de gegevens beschreven die tussen componenten worden verplaatst tijdens herverificatie na het verlopen van een token, via BroadWorks of Webex.

In deze tabel wordt de gegevensbeweging voor bellen weergegeven.

Gegevens verplaatsen

Van

Doel

SIP-signalering

Klant

BroadWorks

SRTP-media

Klant

BroadWorks

SIP-signalering

BroadWorks

Klant

SRTP-media

BroadWorks

Klant

In deze tabel wordt de gegevensbeweging voor berichten, aanwezigheid en vergaderingen weergegeven.

Gegevens verplaatsen

Van

Doel

HTTPS REST-berichten en aanwezigheid

Klant

Webex

HTTPS REST-berichten en aanwezigheid

Webex

Klant

SIP-signalering

Klant

Webex

SRTP-media

Klant

Webex

SIP-signalering

Webex

Klant

SRTP-media

Webex

Klant

De inrichtings-API gebruiken

Toegang voor ontwikkelaars

De API-specificatie is beschikbaar op https://developer.webex.com en een handleiding voor het gebruik is te vinden op https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

U moet zich aanmelden om de API specificatie te lezen ophttps://developer.webex.com/docs/api/v1/broadworks-subscribers .

Toepassingsverificatie en autorisatie

Uw toepassing wordt geïntegreerd met Webex als een Integratie. Met dit mechanisme kan de toepassing beheertaken uitvoeren (zoals het inrichten van abonnees) voor een beheerder binnen uw partnerorganisatie.

Webex-API's volgen de OAuth 2-standaard ( http://oauth.net/2/). Met OAuth 2 kunnen integraties van derden vernieuwings- en toegangstokens verkrijgen namens de door u gekozen partnerbeheerder voor het verifiëren van API-gesprekken.

U moet eerst uw integratie met Webex registreren. Na registratie moet uw toepassing deze OAuth 2.0-autorisatietoekenningsflow ondersteunen om de benodigde vernieuwings- en toegangstokens te verkrijgen.

Zie https://developer.webex.com/docs/integrations voor meer informatie over integraties en hoe u deze OAuth 2-autorisatieflow in uw toepassing kunt opbouwen.


 

Er zijn twee rollen vereist voor het implementeren van integraties - de ontwikkelaar en de autorisatiegebruiker - en deze kunnen worden bekleed door afzonderlijke personen/teams in uw omgeving.

  • De ontwikkelaar maakt de app en registreert deze op https://developer.webex.com om de vereiste OAuth ClientID/Secret te genereren met scopes die worden verwacht voor de toepassing. Als uw toepassing wordt gemaakt door een derde partij, kan deze de toepassing registreren (als u om toegang hebt gevraagd) of kan u deze met uw eigen toegang doen.

  • De gebruiker autoriseren is het account dat de toepassing gebruikt om de API-oproepen te autoriseren, om uw partnerorganisatie, de organisaties van uw klanten of hun abonnees te wijzigen. Dit account moet de rol Volledige beheerder of Volledige verkoopbeheerder hebben in uw partnerorganisatie. Deze rekening mag niet door een derde worden aangehouden.

Naam organisatie

De organisatienaam is afhankelijk van de inrichtingsmodus die u gebruikt:

  • Enterprise-modus: de organisatienaam komt exact overeen met spEnterprise-id.

  • Serviceprovidermodus: de organisatienaam is het gedeelte groep-id van de spEnterprise-id.

De organisatienaam bevat alle spaties, hoofdletters en speciale tekens die zijn opgegeven in de oorspronkelijke spEnterprise-id.

Softwarevereisten voor BroadWorks

Zie Lifecycle Management - BroadSoft Servers.

We verwachten dat de serviceprovider "patch current" is met de nieuwste BroadWorks-patches en Release Independent (RI)-apps. De lijst met patches hieronder is de minimale vereiste voor integratie met Webex.


 
Controleer de patchnotities voor deze softwarepatches. Sommige patches hebben mogelijk aanvullende CLI-vereisten.

Versie R22

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.22.0.1123.ap364260

AP.as.22.0.1123.ap365173

AP.as.22.0.1123.ap368517

Vereist voor adreslijstsynchronisatie

AP.as.22.0.1123.ap369763

AP.as.22.0.1123.ap372989

AP.as.22.0.1123.ap372757

AP.as.22.0.1123.ap372963

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.22.0.1123.ap373197

Vereiste patch voor toepassingsserver

AP.as.22.0.1123.ap378391

AP.as.22.0.1123.ap374793

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.22.0.1123.ap377718

Vereiste patch voor de functie Gespreksopname

AP.as.22.0.1123.ap377868

AP.as.22.0.1123.ap376508

Vereiste patch voor doorstroominrichting

AP.xsp.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Profielserver

AP.ps.22.0.1123.ap372989

AP.ps.22.0.1123.ap372757

AP.ps.22.0.1123.ap378391

AP.ps.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Platform

AP.platform.22.0.1123.ap353577

AP.platform.22.0.1123.ap354313

Vereist voor NPS-verificatieproxy

AP.platform.22.0.1123.ap365173

AP.platform.22.0.1123.ap367732

AP.platform.22.0.1123.ap369433

AP.platform.22.0.1123.ap369607

Vereist voor NPS-verificatieproxy

AP.platform.22.0.1123.ap372757

AP.platform.22.0.1123.ap376508

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.platform.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

XSP|ADP

AP.xsp.22.0.1123.ap354313

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap365173

AP.xsp.22.0.1123.ap368067

AP.xsp.22.0.1123.ap368601

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.xsp.22.0.1123.ap369607

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap370952

AP.xsp.22.0.1123.ap373008

AP.xsp.22.0.1123.ap372757

AP.xsp.22.0.1123.ap372433

AP.xsp.22.0.1123.ap372963

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.xsp.22.0.1123.ap378391

AP.xsp.22.0.1123.ap374677

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap375206

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap376508

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.xsp.22.0.1123.ap378585

Vereist voor Unified Call History

Overig

AP.xsa.22.0.1123.ap372757

AP.xs.22.0.1123.ap372757

AP.ums.22.0.1123.ap378391

AP.nfm.22.0.1123.ap378391

Versie R23

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.23.0.1075.ap368517

Vereist voor adreslijstsynchronisatie

AP.as.23.0.1075.ap369763

AP.as.23.0.1075.ap373197

App-server configureren

AP.as.23.0.1075.ap373271

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.23.0.1075.ap378391

AP.as.23.0.1075.ap376509

AP.as.23.0.1075.ap377718

Vereist voor gespreksopname

AP.as.23.0.1075.ap377868

AP.as.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Profielserver

AP.ps.23.0.1075.ap378391

Platform

AP.platform.23.0.1075.ap367732

AP.platform.23.0.1075.ap370952

AP.platform.23.0.1075.ap369607

Vereist voor NPS-verificatieproxy

AP.platform.23.0.1075.ap376509

AP.platform.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

XSP|ADP

AP.xsp.23.0.1075.ap368067

AP.xsp.23.0.1075.ap369607

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap370952

AP.xsp.23.0.1075.ap373008

AP.xsp.23.0.1075.ap373271

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.xsp.23.0.1075.ap378391

AP.xsp.23.0.1075.ap374677

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap375206

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap376509

AP.xsp.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Overig

Bij gebruik van ADP...

Xsi-Events-23_2021.05_1.251.bwar

Vereiste patch voor haakstatus (Presence) en Unified Call History

Versie R24

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.24.0.944.ap384177

Vereist voor Unified Messaging Server (UMS)

AP.as.24.0.944.ap375100

Vereist voor flowthrough-inrichting

AP.as.24.0.944.ap377718

Vereist voor gespreksopname

AP.as.24.0.944.ap377868

AP.as.24.0.944.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Overig

Xsi-Events-24_2021.05_1.251.bwar

Vereiste patch voor haakstatus (Presence) en Unified Call History

Inrichtings- en activeringsstromen voor gebruikers


 

Inrichting beschrijft het toevoegen van de gebruiker aan Webex. Activering omvat e-mailvalidatie en servicetoewijzing in Webex.

E-mailadressen van gebruikers moeten uniek zijn, omdat Webex het e-mailadres gebruikt om een gebruiker te identificeren. Als u vertrouwde e-mailadressen voor de gebruikers hebt, kunt u ervoor kiezen deze automatisch te activeren wanneer u ze automatisch inricht. Dit proces is 'automatische inrichting en automatische activering'.

Automatische gebruikersinrichting en automatische activering (vertrouwde e-mailstroom)

Voorwaarden

  • Uw inrichtingsadapter wijst naar Webex voor Cisco BroadWorks (waarvoor een uitgaande verbinding van AS naar Webex Provisioning Bridge is vereist).

  • U moet geldige bereikbare e-mailadressen van eindgebruikers hebben als alternatieve id's in BroadWorks.

  • Control Hub heeft een inrichtingsaccount in de configuratie van uw partnerorganisatie.

Stap

Beschrijving

1

U noteert en neemt bestellingen voor de service op bij uw klanten.

2

U verwerkt de klantorder en richt de klant in uw systemen in.

3

Het service-inrichtingssysteem activeert de inrichting van BroadWorks. Deze stap, in het kort, maakt de onderneming en de gebruikers. Vervolgens wijst het de benodigde services en nummers toe aan elke gebruiker. Een van die diensten is de externe IM&P.

4

Met deze inrichtingsstap wordt de automatische inrichting van de klantorganisatie en gebruikers in Webex geactiveerd. (De IM&P-servicetoewijzing zorgt ervoor dat de inrichtingsadapter de Webex-inrichtings-API belt).

5

Uw systemen moeten de Webex-provisioning-API gebruiken als u het pakket later voor de gebruiker moet aanpassen (om van de standaardinstelling te veranderen).

SSO-aanmeldstroom

SAML SSO-aanmeldstroom met directe BroadWorks-verificatie (delen van resources tussen verschillende bronnen)

Hier volgt de SAML SSO-aanmeldstroom voor de Webex-app bij gebruik van BroadWorks-verificatie en wanneer Resource delen met meerdere bronnen is ingeschakeld, zodat directe verificatie naar BroadWorks mogelijk is. De afbeelding toont client- en gebruikersevenementen aan de linkerkant met tekst op de pijlen die weergeeft wat de client voor autorisatie voorziet. Stap 1 en 5 zijn gebruikersevenementen. Aan de rechterkant van de afbeelding ziet u gebeurtenissen voor aanmeldservices, samen met wat er wordt teruggestuurd naar de client.

BroadWorks-registratie en servicedetectiestroom

Hieronder volgt de BroadWorks-servicedetectiestroom die onmiddellijk volgt uit de vorige Webex SAML SSO-aanmeldstroom. De client gebruikt het toegangstoken dat is verkregen bij de registratie bij Webex-apparaatbeheer om registratie aan te vragen bij de BroadWorks-implementatie.

Alternatieve aanmeldstromen

De bovenstaande afbeeldingen gaan ervan uit dat SAML SSO-aanmelding is geconfigureerd met BroadWorks-verificatie waarvoor directe BroadWorks-verificatie is ingeschakeld (Cross-Origin Resource Sharing). Hieronder vindt u enkele alternatieve SAML SSO-aanmeldstromen:

  • BroadWorks-verificatie zonder directe BroadWorks-verificatie (delen van resources tussen verschillende bronnen):

    • Het enige verschil is in stap 5 en 6 van de Webex-aanmeldstroom. In stap 5 worden de aanmeldingsgegevens gevalideerd door de IdP-proxy (in plaats van XSI) en wordt een SAML-verklaring teruggestuurd naar de client.

    • De stroom loopt door de resterende stappen in de twee diagrammen.

    • Het SSO-token wordt niet gebruikt in deze flow.

  • SAML SSO Webex-verificatie:

    • In stap 3 van de Webex-aanmeldstroom retourneert de service Common Identity de identiteitsprovider die wordt gebruikt door Webex-verificatie.

    • Op dit moment wordt een alternatieve SAML SSO-aanmeldstroom voor Webex gestart.

Gebruikersinteracties

Aanmelden

  1. De Webex-app lanceert een browser naar Cisco Common Identity (CI) zodat gebruikers hun e-mailadres kunnen invoeren.

  2. CI ontdekt dat de gekoppelde klantorganisatie de BroadWorks IDP-proxy (IDP) heeft geconfigureerd als hun SAML IDP. CI wordt omgeleid naar de IDP die de gebruiker een aanmeldpagina aanbiedt. (De serviceprovider kan deze aanmeldpagina aanmerken.)

  3. De gebruiker voert zijn of haar BroadWorks-referenties in.

  4. Broadworks verifieert de gebruiker via de IDP. Bij succes stuurt de IDP de browser terug naar CI met een SAML-succes om de verificatieflow te voltooien (niet weergegeven in diagram).

  5. Bij succesvolle verificatie verkrijgt de Webex-app toegangstokens van CI (niet weergegeven in diagram). De client gebruikt deze om een BroadWorks langlevende Jason Web Token (JWT) aan te vragen.

  6. De Webex-app ontdekt de gespreksconfiguratie van BroadWorks en andere services van Webex.

  7. De Webex-app wordt geregistreerd bij BroadWorks.

Aanmelden vanuit het perspectief van een gebruiker

Dit diagram is de typische aanmeldingsstroom, zoals gezien door de eindgebruiker of abonnee:

  1. U downloadt en installeert de Webex-app.

  2. Mogelijk hebt u de koppeling van uw serviceprovider ontvangen of kunt u de download vinden op de pagina Webex-downloads.

  3. U voert uw e-mailadres in op het aanmeldscherm van Webex. Klik op Volgende.

  4. U wordt meestal omgeleid naar een pagina met het merk Serviceprovider.

  5. Die pagina kan u verwelkomen via uw e-mailadres.

    Als er geen e-mailadres is of als het e-mailadres onjuist is, voert u in plaats daarvan uw BroadWorks-gebruikersnaam in.

  6. Voer uw BroadWorks-wachtwoord in.

  7. Als u zich hebt aangemeld, wordt Webex geopend.

Gespreksstroom: bedrijfstelefoonlijst

Gespreksstroom: PSTN-nummer

Presentatie en delen

Een ruimtevergadering starten

Interacties met de klant

Profiel ophalen uit DMS en SIP-register met AS

  1. De client belt XSI om een apparaatbeheertoken en de URL naar het DMS op te halen.

  2. De klant vraagt zijn apparaatprofiel aan bij DMS door het token van stap 1 voor te leggen.

  3. De client leest het apparaatprofiel en haalt de SIP-referenties, adressen en poorten op.

  4. Client verzendt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.

  5. SBC stuurt het SIP REGISTER naar het AS (SBC kan een zoekopdracht uitvoeren in de NS om een AS te vinden als SBC de SIP-gebruiker nog niet kent.)

Test- en laboratoriumrichtlijnen

De volgende richtlijnen zijn van toepassing op test- en laboratoriumorganisaties:

  • Serviceproviderpartners zijn beperkt tot maximaal 50 testgebruikers die in meerdere organisaties kunnen worden ingericht.

  • Gebruikers buiten de eerste 50 testgebruikers worden gefactureerd.

  • Om een nauwkeurige verwerking op uw factuur te garanderen, moeten alle testorganisaties 'test' opnemen in de naam van de BroadWorks-organisatie.

  • Interne testorganisaties moeten worden aangewezen in Webex Control Hub. Dit is om te voorkomen dat testgebruikers worden gefactureerd als werkelijke gebruikers.

Een organisatie aanwijzen als een testorganisatie

Een organisatie aanwijzen als testorganisatie:

  1. Meld u aan bij Partner Hub en selecteer Klanten.

  2. Selecteer de juiste klant.

  3. Schakel in de rechterbedieningsbalk de schakelaar Interne testorganisatie in.

Voicemail afspelen

Zorg ervoor dat u voor voicemail de Mediaserver configureert om een van de volgende codes te gebruiken:

  • mp3

  • wav: WAV-bestanden worden ondersteund in de volgende indelingen: PCM (ondersteund op alle platforms) en DVI-ADPCM (niet ondersteund op Android

Als u wav-bestanden gebruikt, voert u de volgende CLI-opdrachten uit om de toepassingsserver en de mediaserver te configureren:

  • AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV

  • MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw

Terminologie

ACL (ACL)
Lijst met toegangscontrole
ALG
Gateway toepassingslaag
API
Toepassingsprogrammeerinterface
APNS
Apple Push-notificatieservice
AS
Toepassingsserver
ATA, VORMEN, VORMEN
Analoge telefoonoplader, adapter die analoge telefonie converteert naar VoIP
BAM
Toepassingsbeheer van BroadSoft
Basisverificatie
Een verificatiemethode waarbij een account (gebruikersnaam) wordt gevalideerd met een gedeeld geheim (wachtwoord)
BMS, (VER)LEIDEN
BroadSoft-berichtenserver
BOSJE
Bidirectionele stromen via synchrone HTTP
BRAADSTUK
Basic Rate Interface BRI is een ISDN-toegangsmethode
Bundel
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (cfr. Pakket)
CA
Certificeringsinstantie
Provider
Een organisatie die telefonieverkeer afhandelt (cfr. Partner, serviceprovider, Value Added Reseller)
CAPTCHA
Volledig geautomatiseerde Public Turing-test om computers en mensen uit elkaar te houden
CCXML
Taal voor eXtensible Markup voor gespreksbeheer
CIF
Algemeen Tussenformaat
CLI, VASTBINDEN
Opdrachtregelinterface
CN
Algemene naam
CNPS, CNPS
Pushserver voor gespreksmeldingen. Een pushserver voor meldingen die wordt uitgevoerd op een XSP|ADP in uw omgeving, om gespreksmeldingen naar FCM en APNS te pushen. Zie NPS-proxy.
CPE
Gebouwapparatuur van de klant
CPR, AFLEIDEN
Aangepaste aanwezigheidsregel
CSS, CVS
Cascade-stijlblad
CSV
Door komma's gescheiden waarde
CTI
Integratie van computertelefonie
CUBE
Cisco Unified Border Element
DMZ
Gedemilitariseerde zone
DN
Telefoonlijstnummer
Niet storen
Niet storen
DNS
Domeinnaamsysteem
DPG
Bel peergroep
DSCP
Punt Gedifferentieerde Servicecode
DTAF
Archiefbestand van apparaattype
DTG
Bestemmings-trunk-groep
DTMF
Dubbele toon met meerdere frequenties
Eindgebruiker
De persoon die de services gebruikt, die gesprekken voert, deelneemt aan vergaderingen of berichten verzendt (cf. Abonnee)
Organisatie
Een verzameling van eindgebruikers (cfr. Organisatie)
FCM
Firebase-cloudberichten
SCHAAMTE
Convergentie van vaste mobiele apparaten
Doorstroominrichting
Gebruikers maken in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' toe te wijzen in BroadWorks.
FQDN
Volledig gekwalificeerde domeinnaam (FQDN)
Volledige doorstroominrichting
Gebruikers maken en verifiëren in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' toe te wijzen in BroadWorks en te bevestigen dat elke BroadWorks-gebruiker een uniek en geldig e-mailadres heeft.
FXO, FXO
Foreign Exchange Office is de poort die de analoge lijn ontvangt. Dit is de stekker op de telefoon of faxmachine of de stekkers op uw analoge telefoonsysteem. Het levert een on-hook/off-hook indicatie (lussluiting). Aangezien de FXO-poort is gekoppeld aan een apparaat, zoals een fax of een telefoon, wordt het apparaat vaak het 'FXO-apparaat' genoemd.
FXS, FXS
Foreign Exchange Subscriber is de poort die daadwerkelijk de analoge lijn aan de abonnee levert. Met andere woorden, het is de "plug in the wall" die een kiestoon, accustroom en belspanning levert.
GCM
Google Cloud-bericht
GCM
Galois/Counter-modus (coderingstechnologie)
VERSTOPT
Apparaat voor menselijke interface
HTTPS
Beveiligde contactdozen met hypertekstdoorschakelprotocol
IAD
Apparaat voor geïntegreerde toegang
IM&P
Instant Messaging en Aanwezigheid
IP-PSTN
Een serviceprovider die VoIP-naar-PSTN-services levert, uitwisselbaar met ITSP, of een algemene term voor 'openbare' telefonie met internetverbinding, gezamenlijk geleverd door grote telecomproviders (in plaats van door landen, zoals PSTN is)
ITSP, ITSP
Internettelefonieserviceprovider
IVR, IVR
Interactieve spraakrespons / Responder
JID
Het systeemeigen adres van een XMPP-entiteit wordt een Jabber-id of JID localpart@domain.part.example.com/resourcepart (@ . / zijn separatoren)
JSON
Java-scriptobjectnotatie
JOOD
Java Secure Socket Extension; de onderliggende technologie die veilige verbindingsfuncties biedt voor BroadWorks-servers
KEM
Toetsuitbreidingsmodule (hardware Cisco-telefoons)
LLT
Long-lived (of Long Life) Token; een zelfbeschrijvende, veilige vorm van toondertoken waarmee gebruikers langer geverifieerd kunnen blijven en niet gekoppeld zijn aan specifieke toepassingen.
MA, MA, MAMA
Berichtarchivering
MIB, MIB
Basis managementinformatie
MEVROUW
Mediaserver
mTLS
Wederzijdse verificatie tussen twee partijen met behulp van certificaatuitwisseling bij het tot stand brengen van een TLS-verbinding
MUG, MUG, MUG
Chat met meerdere gebruikers
NAT, NAT
Vertalingen van netwerkadressen
NPS
Pushserver voor meldingen; zie CNPS
NPS-proxy

Een service in Webex die korte autorisatietokens levert aan uw CNPS, zodat deze de gespreksmeldingen naar FCM en APN's en uiteindelijk naar Android- en iOS-apparaten met Webex kan pushen.

OCI, OCI
Clientinterface openen
Organisatie
Een bedrijf of organisatie die een verzameling eindgebruikers vertegenwoordigt (cfr. Onderneming)
OTG
Uitgaande trunkgroep
Pakket
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (cfr. bundel)
Partner
Een agentorganisatie die samenwerkt met Cisco om producten en services te distribueren naar andere organisaties (cf. Value Added Reseller, serviceprovider, provider)
PBX
Ruilen privé-filiaal
PEM
E-mail met verbeterde privacy
PLONS
Openbaar mobiel landnetwerk
PRI, SNOEIWERK
Primary Rate Interface (PRI) is een standaard voor telecommunicatie-interface die wordt gebruikt op een digitaal netwerk voor geïntegreerde diensten (ISDN)
PS
Profielserver
PSTN
Openbaar geschakeld telefoonnetwerk
QoS
Servicekwaliteit
Doorverkoopportaal
Een website waarop de beheerder van de reseller zijn UC-One SaaS-oplossing kan configureren. Het wordt soms BAM-portal, beheerportal of beheerportal genoemd.
RTCP
Real-time beheerprotocol
RTP
Protocol voor realtime vervoer
SBC, ZWAARD
Sessie Border Controller
SCÈNE, SCÈNE
Weergave van gedeelde oproep
SD (SD)
Standaarddefinitie
SDP
Protocol voor sessiebeschrijving
SP
Serviceprovider; Een organisatie die telefonie of gerelateerde diensten levert aan andere organisaties (cf. Vervoerder, Partner, Value Added Reseller)
SIP
Protocol voor het starten van een sessie
SLET
Short-lived (of Short Life) Token (ook wel BroadWorks SSO Token genoemd); een authenticated token voor eenmalig gebruik dat wordt gebruikt om veilige toegang tot webtoepassingen te krijgen.
SMB
Kleine tot middelgrote ondernemingen
SNMP
Eenvoudig netwerkbeheerprotocol
sRTCP
secure Realtime Transfer Control Protocol (VoIP-gespreksmedia)
sRTP
beveiligd Realtime-doorverbindprotocol (VoIP-gespreksmedia)
SSL
Laag met veilige contactdozen
Abonnee
De persoon die de services gebruikt, die gesprekken voert, deelneemt aan vergaderingen of berichten verzendt (cf. Eindgebruiker)
TCP
Transmissieregelprotocol
TDM
Tijdverdeling multiplexen
TLS
Transportlagenbeveiliging
ToS
Soort service
UAP, UAP
Portal voor gebruikersactivering
UC
Unified Communications
GEBRUIKERSINTERFACE
Gebruikersinterface
U Id
Unieke id
AFMETINGEN
Berichtenserver
URI
Uniforme resource-id
URL
Uniforme bronzoeker
USS
Server voor delen
UTC
Gecoördineerde wereldtijd
UVS
Videoserver
Value Added Reseller (VAR)
Een agentorganisatie die samenwerkt met Cisco om producten en services te distribueren naar andere organisaties (cf. Vervoerder, Partner, Serviceprovider)
VGA
Grafische matrix voor video
VoIP
Voice over Internet Protocol (IP)
VXML
Taal voor uitbreidbare spraak
WebDAV
Webgedistribueerde creatie en versioning
WebRTC
Realtime webcommunicatie
WRS
WebRTC-server
XMPP
Extensible Messaging and Presence Protocol
Bijlage

Services configureren (met mTLS voor de verificatieservice)

De onderstaande procedures vervangen de procedures in het onderwerp Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's. Voltooi deze procedures alleen als u mTLS gebruikt voor de verificatieservice in plaats van CI-tokenvalidatie. Deze procedures zijn verplicht als u meerdere Webex-organisaties op dezelfde XSP|ADP-server uitvoert. Anders zijn ze optioneel.


 
Als u niet meerdere Webex-organisaties op dezelfde XSP|ADP-server uitvoert, wordt CI Token Validation (met TLS) aanbevolen voor de verificatieservice. Raadpleeg Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's voor meer informatie over het configureren van de verificatieservice en andere services.

Xsi-interfaces

Installeer en configureer de Xsi-Actions- en Xsi-Events-toepassingen zoals beschreven in de Configuratiehandleiding voor Cisco BroadWorks Xtended Services Interface.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Voor alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moet dezelfde callControlApplicationName zijn gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker is geïntegreerd in Webex, maakt Webex een abonnement voor de gebruiker op de AS om telefoniegebeurtenissen te ontvangen voor aanwezigheid en gespreksgeschiedenis. Het abonnement is gekoppeld aan de callControlApplicationName en de AS gebruikt het om te weten naar welke Xsi-Events de telefonie-gebeurtenissen moeten worden verzonden.


 

Het wijzigen van de callControlApplicationName of het niet hebben van dezelfde naam op alle Xsi-Events-webapps zal invloed hebben op abonnementen en telefonie gebeurtenissen functionaliteit.

Verificatieservice configureren (met mTLS)

BroadWorks-tokens met een lange levensduur worden gegenereerd en gevalideerd door de verificatieservice die wordt gehost op uw XSP|ADP's.

Vereisten

  • Op de XSP|ADP-servers die de verificatieservice hosten, moet een mTLS-interface zijn geconfigureerd.

  • XSP|ADP's moeten dezelfde sleutels delen voor het coderen/decoderen van BroadWorks-tokens met een lange levensduur. Het kopiëren van deze sleutels naar elke XSP|ADP is een handmatig proces.

  • XSP|ADP's moeten worden gesynchroniseerd met NTP.

Configuratieoverzicht

De essentiële configuratie op uw XSP|ADP's omvat:

  • Implementeer de verificatieservice.

  • Configureer de tokenduur tot ten minste 60 dagen (laat de uitgever staan als BroadWorks).

  • RSA-sleutels genereren en delen met XSP|ADP's.

  • Geef de authService-URL op aan de webcontainer.

De verificatieservice implementeren op XSP|ADP

Op elke XSP|ADP die met Webex wordt gebruikt:

  1. Activeer de toepassing voor de verificatieservice op het pad /authService(je moet dit pad gebruiken):

    XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService

    (waarbij <version> is uw BroadWorks-versie).

  2. Implementeer de toepassing:

    XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authService

Duur token configureren

  1. Controleer de bestaande tokenconfiguratie (uren):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> get

  2. Stel de duur in op 60 dagen (max. 180 dagen):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> set tokenDurationInHours 1440

RSA-sleutels genereren en delen

  • U moet dezelfde openbare/privésleutelparen gebruiken voor tokencodering/decodering in alle instanties van de verificatieservice.

  • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet uitgeven.

Vanwege deze twee factoren moet u sleutels genereren op één XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's.


 

Als u met de toetsen gaat fietsen of de lengte van de toetsen wijzigt, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw starten.

  1. Selecteer één XSP|ADP om een sleutelpaar te genereren.

  2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen in de browser van de client:

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

    (Dit genereert een privaat/openbaar sleutelpaar op de XSP|ADP, als dat er nog niet was)

  3. De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:

    XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

  4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere .keys bestand indien nodig.

  5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

Geef de authService-URL aan de webcontainer

De webcontainer van de XSP|ADP heeft de authService-URL nodig zodat deze tokens kan valideren.

Op elk van de XSP|ADP's:

  1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het communicatiehulpprogramma BroadWorks:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

  2. Voeg de URL van de verificatieservice toe aan de container:

    XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

    Hiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.

  3. Controleer de parameter met get.

  4. Start de XSP|ADP opnieuw op.

TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)

De toepassingen Verificatieservice, Xsi-acties en Xsi-Events maken gebruik van HTTP-serverinterfaces. De TLS-configureerbaarheidsniveaus voor deze toepassingen zijn als volgt:

Meest algemeen = Systeem > Transport > HTTP > HTTP Server interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit CLI-context
Systeem (globaal)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze veilig zijn en of ze clientverificatie vereisen.

Apache tomcat vereist een certificaat voor elke veilige interface; het systeem genereert een zelfondertekend certificaat als dit nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2-protocol toevoegen aan de HTTP-serverinterface

De HTTP-interface die communiceert met de Webex-cloud moet zijn geconfigureerd voor TLSv1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren in de interface van de HTTP-server:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken in de HTTP-serverinterface

De vereiste cijfers configureren:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de interface van de HTTP-server.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 in de interface van de HTTP-server gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Trust configureren voor verificatieservice (met mTLS)

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om CombinedCertChain2023.txt op uw lokale computer.


     
    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze uploadt naar de XSP|ADP's. Alle bestanden zijn vereist.
  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt.

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE----- en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één tekstblok bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt.

  5. Meld u aan bij de XSP|ADP en ga naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoeren UpdateTrust om de parameters en opdrachtindeling weer te geven.

  6. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023

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

     

    Alle aliassen moeten een andere naam hebben. webexclientroot, webexclientroot2023, webexclientissuing en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang de vier ingangen uniek zijn.

  7. Bevestig dat de ankers zijn bijgewerkt:

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get

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

(Optie) mTLS configureren op het niveau van de HTTP-interface/poort

Het is mogelijk om mTLS te configureren op het niveau van de HTTP-interface/poort of per webtoepassing.

De manier waarop u mTLS inschakelt voor uw toepassing, hangt af van de toepassingen die u host op de XSP|ADP. Als u meerdere toepassingen host waarvoor mTLS nodig is, moet u mTLS inschakelen op de interface. Als u slechts één van de verschillende toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op HTTP-interface/poortniveau is mTLS vereist voor alle gehoste webtoepassingen die via deze interface/poort worden geopend.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/HttpServer> en voer de get opdracht om de raakvlakken te zien.

  3. Als u een interface wilt toevoegen en daar clientverificatie wilt vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true

    Zie de XSP|ADP CLI-documentatie voor meer informatie. In wezen de eerste true beveiligt de interface met TLS (servercertificaat wordt gemaakt indien nodig) en de tweede true dwingt de interface om clientcertificaatverificatie te vereisen (samen zijn het mTLS).

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/HttpServer> get

Interface Port Name Secure Client Auth Req Cluster Fqdn
         =======================================================
         192.0.2.7 443 XSP|ADP01.collab.example.net true false 
         192.0.2.7 444 XSP|ADP01.collab.example.net true true

In dit voorbeeld is mTLS (Client Auth Req = true) ingeschakeld op 192.0.2.7 poort 444. TLS is ingeschakeld op 192.0.2.7 poort 443.

(Optie) mTLS configureren voor specifieke webtoepassingen

Het is mogelijk om mTLS te configureren op het niveau van de HTTP-interface/poort of per webtoepassing.

De manier waarop u mTLS inschakelt voor uw toepassing, hangt af van de toepassingen die u host op de XSP|ADP. Als u meerdere toepassingen host waarvoor mTLS nodig is, moet u mTLS inschakelen op de interface. Als u slechts één van de verschillende toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op toepassingsniveau is mTLS vereist voor die toepassing, ongeacht de HTTP-serverinterfaceconfiguratie.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> en voer de get om te zien welke toepassingen worden uitgevoerd.

  3. Een toepassing toevoegen en hiervoor clientverificatie vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true

    Zie de XSP|ADP CLI-documentatie voor meer informatie. Daar worden de toepassingsnamen opgesomd. Het true in dit commando wordt mTLS ingeschakeld.

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add 192.0.2.7 443 AuthenticationService true

De voorbeeldopdracht voegt de AuthenticationService-toepassing toe aan 192.0.2.7:443 en vereist dat de toepassing certificaten van de client aanvraagt en verifieert.

Vraag na bij get:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> get

Interface Ip Port Application Name Client Auth Req
         ===================================================
         192.0.2.7 443 AuthenticationService      true          

Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver

Profielserver en XSP|ADP zijn verplicht voor apparaatbeheer. Ze moeten worden geconfigureerd volgens de instructies in de configuratiehandleiding voor BroadWorks-apparaatbeheer.

Hoe gaat u verder?

Voor configuratie kunt u opnieuw deelnemen aan de hoofddocumentstroom via CTI-interface en gerelateerde configuratie.

Aanvullende certificaatvereisten voor wederzijdse TLS-verificatie tegen AuthService

Webex communiceert met de verificatieservice via een wederzijdse TLS-geverifieerde verbinding. Dit betekent dat Webex een clientcertificaat presenteert en dat de XSP|ADP moet valideren. Als u dit certificaat wilt vertrouwen, gebruikt u de Webex CA-certificaatketen om een vertrouwensanker op XSP|ADP (of proxy) te maken. De certificaatketen kan worden gedownload via Partner Hub:

  1. Ga naar Instellingen > BroadWorks Calling.

  2. Klik op de koppeling voor het downloadcertificaat.


 

U kunt de certificaatketen ook ophalen van https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.

De exacte vereisten voor het implementeren van deze Webex CA-certificaatketen zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt samengevat waar de Webex CA-certificaatketen in deze drie gevallen moet worden geïmplementeerd.

Vereisten voor wederzijds TLS-certificaat voor TLS-bridge Proxy

  • Webex presenteert een door Webex CA ondertekend clientcertificaat aan de proxy.

  • De Webex CA-certificaatketen wordt geïmplementeerd in het proxyvertrouwensarchief, zodat de proxy het clientcertificaat vertrouwt.

  • Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de proxy geladen.

  • De proxy presenteert een openbaar ondertekend servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • De volmachthebber legt een intern ondertekend clientcertificaat voor aan de XSP|ADP’s.

    Dit certificaat moet het uitbreidingsveld Extended Key Usage van x509.v3 bevatten met het BroadWorks-OID-doel 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS-clientAuth. Bijv.:

    X509v3 extensions:

    X509v3 Extended Key Usage:

    1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client
                  Authentication 

     

    Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP’s presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

Vereisten voor wederzijds TLS-certificaat voor TLS-passthrough Proxy of XSP in DMZ

  • Webex presenteert een door Webex CA ondertekend clientcertificaat aan de XSP's.

  • De Webex CA-certificaatketen wordt geïmplementeerd in het vertrouwensarchief van de XSP's, zodat de XSP's het clientcertificaat vertrouwen.

  • Het openbaar ondertekende XSP-servercertificaat wordt ook in de XSP's geladen.

  • De XSP's presenteren openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP's heeft ondertekend.

Revisiegeschiedenis van document

De volgende tabel toont een geschiedenis van wijzigingen aan dit document in de afgelopen 12 maanden.

Datum

Versie

Beschrijving van de wijziging

24 februari 2024

2-110

  • Redactionele wijzigingen.

20 februari 2024

2-109

  • Het gedeelte Indicatie visuele spam toegevoegd onder Webex voor BroadWorks implementeren.

07 februari 2024

2-108

  • Een functie BroadWorks-melding voor het verlopen van een wachtwoord toegevoegd tijdens het aanmelden onder Webex for BroadWorks-referentie.

25 januari 2024

2-107

  • Redactionele wijzigingen.

23 januari 2024

2-106

  • Redactionele wijzigingen aangebracht in het gedeelte Gebruiker verplaatsen (met toestemming) naar Webex voor Cisco BroadWorks onder Webex beheren voor BroadWorks.

10 januari 2024

2-105

  • Redactionele wijzigingen.

20 december 2023

2-104

13 december 2023

2-103

  • Klantsjabloon is gewijzigd in 'Onboarding-sjabloon'. De oplossingshandleiding is bijgewerkt.

12 december 2023

2-102

  • Webex voor BroadWorks toevoegen aan het gedeelte Bestaande organisatie onder Webex voor BroadWorks beheren is bijgewerkt.

08 december 2023

2-101

  • Redactionele wijzigingen.

08 november 2023

2-100

  • Een opmerking toegevoegd in het gedeelte Webex voor BroadWorks toevoegen aan bestaande organisatie.

25 oktober 2023

2-99

  • R24 toegevoegd in het gedeelte Toepassingsserver configureren met inrichtingsservice-URL.

13 september 2023

2-98

  • Netwerkvereisten voor Webex voor Cisco Broadworks-koppelingen toegevoegd onder Aanbevolen documentabonnementen.

04 september 2023

2-97

  • Gedeelte Functies en beperkingen bijgewerkt onder Overzicht van Webex voor Cisco BroadWorks.

08 augustus 2023

2-96

  • Aantekeningen toegevoegd in Een BroadWorks-cluster bewerken of verwijderen in Partnerhub onder Webex beheren voor BroadWorks.

23 juni 2023

2-95

  • Het gedeelte Uw NPS voorbereiden op Webex voor Cisco BroadWorks is bijgewerkt onder Webex implementeren voor Cisco BroadWorks.

  • Het configureren van NPS voor het gebruik van Authentication Proxy connectionTimeout naar 3000 is bijgewerkt onder Webex voor Cisco BroadWorks implementeren.

30 mei 2023

2-94

  • Bijgewerkte sectie BroadWorks-softwarevereisten onder Webex voor Cisco BroadWorks-referentie.

26 mei 2023

2-93

  • Gedeelte Vertrouwensankers voor CTI-interface (R22 en hoger) bijgewerkt onder Webex implementeren voor Cisco BroadWorks.

  • Het gedeelte Vertrouwen configureren voor verificatieservice (met mTLS) is bijgewerkt onder Bijlage.

24 mei 2023

2-92

  • Het gedeelte Webex voor BroadWorks loskoppelen van bestaande organisatie is bijgewerkt onder Webex voor Cisco BroadWorks beheren.

  • Gedeelte Inbreken toegevoegd onder Webex voor Cisco BroadWorks implementeren.

10 mei 2023

2-91

  • Het gedeelte Busy Lamp Field/Call Pickup Notification is bijgewerkt onder Webex beheren voor Cisco BroadWorks.

09 mei 2023

2-90

  • Bijgewerkte sectie Land onder Uw omgeving voorbereiden.

04 mei 2023

2-89

  • Het gedeelte Uw klantsjablonen configureren is bijgewerkt onder Uw partnerorganisatie configureren in Partner Hub.

27 april 2023

2-88

  • Sectie Land toegevoegd onder Uw omgeving voorbereiden.

14 april 2023

2-87

  • Het gedeelte Ondersteuning voor groepscontactpersonen is bijgewerkt onder Bestellen en inrichten.

17 maart 2023

2-86

  • Het gedeelte Mobiel systeemeigen gesprek escaleren naar vergadering is toegevoegd onder Webex voor BroadWorks implementeren.

11 maart 2023

2-85

  • Bijgewerkte stappen in Verificatieservice configureren (met CI-tokenvalidatie) onder Webex voor Cisco BroadWorks implementeren.

10 maart 2023

2-84

  • Bijgewerkte sectie Xsi-interfaces.

07 maart 2023

2-83

  • Het gedeelte Ondersteuning voor groepscontactpersonen is toegevoegd onder Bestellen en inrichten.

28 februari 2023

2-82

  • Gedeelte Partner-SSO - OpenID Connect (OIDC) toegevoegd onder Webex voor Cisco BroadWorks implementeren.

15 februari 2023

2-81

  • Sectie Vertrouwensankers voor CTI-interface (R22 en hoger) bijgewerkt onder Webex implementeren voor Cisco BroadWorks en Vertrouwensservice configureren voor verificatieservice (met mTLS) onder Bijlage.

10 februari 2023

2-80

  • Toestelnummer bijgewerkt onder Overzicht van Webex voor Cisco BroadWorks.

Overzicht van Webex voor Cisco BroadWorks

Introductie van Webex voor Cisco BroadWorks

Revisiegeschiedenis van document

Dit gedeelte behandelt systeembeheerders bij Cisco-partnerorganisaties (serviceproviders) die Webex implementeren voor hun klantorganisaties of deze oplossing rechtstreeks aanbieden aan hun eigen abonnees.

Doel van de oplossing

  • Webex-cloudsamenwerkingsfuncties aanbieden aan kleine en middelgrote klanten die al gespreksservice hebben die wordt geleverd door BroadWorks-serviceproviders.

  • BroadWorks-gebaseerde gespreksservice aanbieden aan kleine en middelgrote Webex-klanten.

Context

We evolueren al onze samenwerkingsklanten naar een uniforme toepassing. Dit pad vermindert aannameproblemen, verbetert de interoperabiliteit en migratie en biedt voorspelbare gebruikerservaringen in ons hele samenwerkingsportfolio. Een deel van deze inspanning is het verplaatsen van de BroadWorks-gespreksmogelijkheden naar de Webex-app en uiteindelijk het verminderen van investeringen in de UC-One-clients.

Voordelen

  • Toekomstbestendigheid: tegen beëindiging van UC-One Collaborate, beweging van alle clients naar het Unified Client Framework (UCF)

  • Het beste van beide: Webex-functies voor berichten en vergaderingen inschakelen met behoud van BroadWorks-gesprekken op uw telefonienetwerk

Toepassingsgebied van de oplossing

  • Bestaande/nieuwe kleine tot middelgrote klanten (minder dan 250 abonnees) die een reeks samenwerkingsfuncties willen, hebben mogelijk al BroadWorks-gesprekken.

  • Bestaande kleine tot middelgrote Webex-klanten die BroadWorks Calling willen toevoegen.

  • Niet voor grotere ondernemingen (raadpleeg ons Enterprise-portfolio voor Webex).

  • Niet voor één gebruiker (evalueer Webex Online-aanbiedingen).

De functiesets in Webex voor Cisco BroadWorks zijn gericht op gebruiksscenario's voor kleine tot middelgrote bedrijven. De Webex voor Cisco BroadWorks-pakketten zijn ontworpen om de complexiteit voor kleine en middelgrote ondernemingen te verminderen en we evalueren voortdurend hun geschiktheid voor dit segment. We kunnen ervoor kiezen functies die anders beschikbaar zijn in de bedrijfspakketten te verbergen of te verwijderen.

Vereisten voor succes met Webex voor Cisco BroadWorks

#

Vereiste

Notities

1

Patchstroom BroadWorks R22 of hoger

2

XSP|ADP voor XSI, CTI, DMS en authService

Specifieke XSP|ADP voor Webex voor Cisco BroadWorks

3

Afzonderlijke XSP|ADP voor NPS kunnen worden gedeeld met andere oplossingen die NPS gebruiken.

Als u een bestaande implementatie voor samenwerken hebt, controleert u aanbevelingen voor XSP|ADP- en NPS-configuraties.

4

CI-tokenvalidatie (met TLS) geconfigureerd voor Webex-verbindingen met de verificatieservice.

5

mTLS is geconfigureerd voor Webex-verbindingen met de CTI-interface.

Voor andere toepassingen is geen mTLS vereist.

6

Gebruikers moeten bestaan in BroadWorks en hebben de volgende kenmerken nodig, afhankelijk van uw inrichtingsbeslissing:

  • Doorloop met vertrouwde e-mails: Het e-mailkenmerk van de BroadWorks-gebruiker moet een geldig e-mailadres bevatten dat uniek is voor die gebruiker. De gebruiker moet ook een primair nummer of toestel hebben.

  • Doorloop met niet-vertrouwde e-mails, zelfactivering of API-inrichting: Gebruiker heeft geen e-mailadres nodig, maar moet een primair nummer of toestel hebben.

Voor vertrouwde e-mails: We raden u aan hetzelfde e-mailadres ook in het kenmerk Alternatieve id in te voeren, zodat gebruikers zich met e-mailadres kunnen aanmelden bij BroadWorks.

Voor niet-vertrouwde e-mails: Afhankelijk van de e-mailinstellingen van de gebruiker kan het gebruik van niet-vertrouwde e-mails ertoe leiden dat de e-mail wordt verzonden naar de ongewenste of spammap van de gebruiker. De beheerder moet mogelijk de e-mailinstellingen van de gebruiker wijzigen om domeinen toe te staan

7

Webex voor Cisco BroadWorks DTAF-bestand voor de Webex-app

8

BW Business Lic of Std Enterprise of Prem Enterprise User Lic + Webex voor Cisco BroadWorks-abonnement

Als u een bestaande implementatie voor samenwerken hebt, hebt u geen UC-One Add-On Bundle, Collab Lic en Meet-me Conference Ports meer nodig.

Als u een bestaande UC-One SaaS-implementatie hebt, zijn er geen andere wijzigingen dan het accepteren van de voorwaarden van het Premium-pakket.

9

IP/poorten moeten toegankelijk zijn via de Webex-backend-services en de Webex-apps via openbaar internet.

Zie het gedeelte “Uw netwerk voorbereiden”.

10

TLS v1.2-configuratie op XSP|ADP's

11

Voor Flowthrough-inrichting moet de toepassingsserver verbinding maken met de BroadWorks-inrichtingsadapter.


 

We testen of ondersteunen geen uitgaande proxyconfiguratie. Als u een uitgaande proxy gebruikt, accepteert u de verantwoordelijkheid om deze te ondersteunen met Webex voor Cisco BroadWorks.

Zie het onderwerp “Uw netwerk voorbereiden”.

Over dit document

Het doel van dit document is u te helpen uw Webex for Cisco BroadWorks-oplossing te begrijpen, voor te bereiden, te implementeren en te beheren. De grote delen in het document weerspiegelen dit doel.

Deze gids bevat conceptueel en referentiemateriaal. We zijn van plan alle aspecten van de oplossing in dit ene document te behandelen.

De minimale set taken om de oplossing te implementeren zijn:

  1. Bereik uw accountteam om een Cisco-partner te worden. Het is noodzakelijk dat u de Cisco-aanrakingspunten onderzoekt om uzelf vertrouwd te maken (en getraind te worden). Wanneer u een Cisco-partner wordt, passen we de Webex voor Cisco BroadWorks-schakelaar toe op uw Webex-partnerorganisatie. (Zie Webex implementeren voor Cisco BroadWorks > Onboarding voor partners in dit document.)

  2. Configureer uw BroadWorks-systemen voor integratie met Webex. (Zie Webex implementeren voor Cisco BroadWorks > Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's in dit document.)

  3. Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)

  4. Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)

  5. Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)


 
  • Dit zijn stappen van hoog niveau, in de typische volgorde. Er zijn verschillende bijdragende taken die u niet kunt negeren.

  • Als u uw eigen toepassingen wilt maken om uw Webex voor Cisco BroadWorks-abonnees te beheren, leest u De inrichtings-API gebruiken in het gedeelte Referentie van deze handleiding.

Terminologie

We proberen het jargon en de letterwoorden in dit document te beperken en elke term uit te leggen wanneer deze voor het eerst wordt gebruikt. (Zie Webex voor Cisco BroadWorks-referentie > Terminologie als een term niet in de context wordt uitgelegd.)

Hoe het werkt

Webex voor Cisco BroadWorks is een aanbieding die BroadWorks-gesprekken integreert in Webex. Abonnees gebruiken één toepassing (de Webex-app) om gebruik te maken van functies die door beide platforms worden aangeboden:

  • Gebruikers bellen PSTN-nummers via uw BroadWorks-infrastructuur.

  • Gebruikers bellen met andere BroadWorks-nummers via uw BroadWorks-infrastructuur (audio-/videogesprekken door de nummers te selecteren die zijn gekoppeld aan de gebruikers of het toetsenblok om de nummers te introduceren).

  • Gebruikers kunnen ook een Webex VoIP-gesprek plaatsen via de Webex-infrastructuur door de optie 'Webex Call' te selecteren in de Webex-app. (Deze gesprekken zijn de Webex-app naar de Webex-app, niet de Webex-app naar PSTN).

  • Gebruikers kunnen Webex Meetings hosten en eraan deelnemen.

  • Gebruikers kunnen elkaar een voor een berichten sturen of in ruimten (permanente groepchat) en profiteren van functies als zoeken en bestanden delen (op Webex-infrastructuur).

  • Gebruikers kunnen aanwezigheid (status) delen. Ze kunnen aangepaste aanwezigheid of door de klant berekende aanwezigheid kiezen.

  • Nadat we u als partnerorganisatie hebben geïntegreerd in Control Hub, met de juiste rechten, kunt u de relatie tussen uw BroadWorks-exemplaar en Webex configureren.

  • U maakt klantorganisaties in Control Hub en richt gebruikers in deze organisaties in.

  • Elke abonnee in BroadWorks krijgt een Webex-identiteit op basis van zijn/haar e-mailadres (kenmerk e-mail-id in BroadWorks).

  • Gebruikers worden geverifieerd voor BroadWorks of voor Webex.

  • Clients krijgen langdurige tokens om ze te autoriseren voor services bij BroadWorks en Webex.

De Webex-app in het midden van deze oplossing; het is een brandbare toepassing die beschikbaar is op Mac/Windows-bureaubladen en Android/iOS-telefoons en -tablets.

Er is ook een webversie van de Webex-app die momenteel geen gespreksfuncties bevat.

De client maakt verbinding met de Webex-cloud om functies voor berichten, aanwezigheid en vergaderingen te leveren.

De client registreert zich bij uw BroadWorks-systemen voor gespreksfuncties.

De Webex-cloud werkt met uw BroadWorks-systemen om een naadloze gebruikersinrichting te garanderen.

Functies en beperkingen

Wij bieden verschillende pakketten met verschillende functies.

Softphone-pakket

Dit pakkettype gebruikt de Webex-app als een softphone only-client met belmogelijkheden, maar geen berichtmogelijkheden. Gebruikers met dit pakkettype kunnen deelnemen aan Webex-vergaderingen, maar kunnen geen vergaderingen zelf starten. Wanneer andere gebruikers (softphone of niet-softphone) in de telefoonlijst zoeken naar een softphone-gebruiker, bieden de zoekresultaten geen optie om een bericht te verzenden.

Softphone-gebruikers kunnen hun scherm delen tijdens een gesprek.

Basispakket

Het basispakket bevat functies voor bellen, chatten en vergaderen. Het omvat 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room). (** zie onderstaande Note voor uitzondering). In dit pakket kunnen de vergaderingen een maximale duur van 40 minuten hebben.

Pakket "Standaard"

Dit pakket omvat ook alles in het basispakket, zoals maximaal 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room).

Scherm delen binnen een PMR-vergadering is een rol die in eerste instantie alleen wordt uitgeoefend door de host van de vergadering, maar de host kan de rol van presentator overdragen aan een door hem of haar gekozen deelnemer aan de vergadering. Alleen de host kan de rol van presentator opnieuw opnemen zonder dat de huidige host deze aan hem of haar heeft doorgegeven.

"Premium"-pakket

Dit pakket omvat alles in het standaardpakket plus maximaal 300 deelnemers aan een vergadering in een 'unified space' en maximaal 1000 deelnemers in een persoonlijke vergaderruimte (PMR).

Scherm delen binnen een PMR-vergadering wordt ondersteund voor elke deelnemer aan de vergadering.

Pakketten vergelijken

Pakket

Oproepen

Berichten

Unified Space-vergaderingen

PMR Meetings

Softphone

Opgenomen

Niet inbegrepen

Geen

Geen

Eenvoudig

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Standaard

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Premium

Opgenomen

Opgenomen

300 deelnemers

1000 deelnemers


 
De limiet voor Unified Space-vergaderingen voor basisgebruikers is 100 deelnemers per Unified Space-vergadering, tenzij de ruimte ook gebruikers bevat waaraan de pakketten 'Standaard' of 'Premium' zijn toegewezen. In dat geval wordt de limiet verhoogd op basis van het gebruikerspakket van de host.

 

'Unified Space Meetings' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in een Webex-ruimte. Een gebruiker start bijvoorbeeld een vergadering vanuit de ruimte via de knoppen 'Vergaderen' of 'Plannen'.

'PMR-vergaderingen' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in de persoonlijke vergaderruimte (PMR) van een gebruiker. Deze vergaderingen gebruiken een speciale URL (bijvoorbeeld: cisco.webex.com/meet/roomOwnerUserID).

Berichten en vergaderingsfuncties

Raadpleeg de volgende tabel voor verschillen in ondersteuning van PMR-vergaderingsfuncties voor Basic-, Standard- en Premium-pakketten.

Tabel 1. Verschillen in functieondersteuning voor PMR-vergaderingen

Vergaderingsfunctie

Ondersteund met basispakket

Overgezet met standaardpakket

Ondersteund met Preminum-pakket

Opmerking

Vergaderduur

40 minuten of minder

Onbeperkt

Onbeperkt

Bureaublad delen

Ja

Ja

Ja

Basis: bureaublad delen door een PMR-vergaderingdeelnemer.

Standaard : bureaublad delen alleen door de host van de PMR-vergadering.

Premium: bureaublad delen door een deelnemer aan een PMR-vergadering.

Toepassingen delen

Ja

Ja

Ja

Basis: toepassingen delen door elke deelnemer aan een PMR-vergadering.

Standaard : toepassingen delen alleen door de host van de PMR-vergadering.

Premium: toepassingen delen door deelnemers aan een PMR-vergadering.

Chat met meerdere partijen

Ja

Ja

Ja

Whiteboarden

Ja

Ja

Ja

Wachtwoordbeveiliging

Ja

Ja

Ja

Web-app - geen downloaden of invoegtoepassingen (gastervaring)

Ja

Ja

Ja

Ondersteuning voor koppelen met Webex-apparaten

Ja

Ja

Ja

Vloerbeheer (Eén dempen / Alles verwijderen)

Ja

Ja

Ja

Koppeling voor blijvende vergaderingen

Ja

Ja

Ja

Toegang tot de Meetings-site

Ja

Ja

Ja

Deelnemen aan vergadering via VoIP

Ja

Ja

Ja

Vergrendeling

Ja

Ja

Ja

Bedieningselementen voor presentator

Nee

Nee

Ja

Extern bureaubladbeheer

Nee

Nee

Ja

Aantal deelnemers

100

100

1000

Opname lokaal opgeslagen in het systeem

Ja

Ja

Ja

Opnemen in de cloud

Nee

Nee

Ja

Opname - Cloudopslag

Nee

Nee

10 GB per locatie

Opnametranscripties

Nee

Nee

Ja

Vergaderingen plannen

Ja

Ja

Ja

Inhoud delen met externe integraties inschakelen

Nee

Nee

Ja

Basic— Inhoud delen door een deelnemer aan een PMR-vergadering.

Standaard: inhoud delen met alleen de host van de PMR-vergadering.

Premium: inhoud delen door een deelnemer aan een PMR-vergadering.

PMR-URL wijzigen toestaan

Nee

Nee

Ja

Basic— Gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL wijzigen vanuit Control Hub.

Standaard: de PMR-URL kan alleen worden gewijzigd vanuit Partner Hub door partner- en organisatiebeheerders.

Premium: gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL vanuit Partner Hub wijzigen.

Live streaming van vergaderingen (Bv. op Facebook, Youtube)

Nee

Nee

Ja

Andere gebruikers toestaan vergaderingen namens hen te plannen

Nee

Nee

Ja

Een alternatieve host toevoegen

Ja

Nee

Ja

App-integratie (bijv. Zendesk, Slack)

Afhankelijk van de integratie

Afhankelijk van de integratie

Ja

Zie het gedeelte App-integraties hieronder voor meer informatie over ondersteuning.

Integratie met Microsoft Office 365-agenda

Ja

Ja

Ja

Integratie met Google-agenda voor G Suite

Ja

Ja

Ja

Het Webex-helpcentrum publiceert de functies en documentatie voor gebruikers voor Webex op help.webex.com. Lees de volgende artikelen voor meer informatie over de functies:

Gespreksfuncties

De belervaring is vergelijkbaar met eerdere oplossingen die gebruikmaken van de BroadWorks-gespreksbeheermotor. Het verschil met UC-One Collaborate en UC-One SaaS is dat de Webex-app de primaire softclient is.

App-integraties

U kunt Webex voor Cisco BroadWorks integreren met de volgende toepassingen:

Ondersteuning voor Virtual Desktop Infrastructure (VDI)

Webex voor Cisco BroadWorks ondersteunt nu VDI-omgevingen (Virtual Desktop Infrastructure). Raadpleeg de Implementatiehandleiding voor Webex voor Virtual Desktop Infrastructure (VDI) voor meer informatie over de implementatie van VDI-infrastructuur.

IPv6-ondersteuning

Webex voor Cisco BroadWorks ondersteunt IPv6-adressering voor de Webex-app.

Toekomstige routekaart

Ga naar https://salesconnect.cisco.com/#/program/PAGE-16649 voor meer informatie over onze voornemens voor de toekomstige versies van Webex voor Cisco BroadWorks. De items van het stappenplan zijn in geen enkele hoedanigheid bindend. Cisco behoudt zich het recht voor om een of al deze items uit toekomstige releases te onthouden of te herzien.

Beperkingen

Inrichtingsbeperkingen

Tijdzone van Meetings-site

De tijdzone van de eerste abonnee voor elk pakket wordt de tijdzone voor de Webex Meetings-site die voor dat pakket is gemaakt.

Als er geen tijdzone is opgegeven in het inrichtingsverzoek voor de eerste gebruiker van elk pakket, wordt de tijdzone van de Webex Meetings-site voor dat pakket ingesteld op de regionale standaard van de organisatie van de abonnees.

Als uw klant een specifieke tijdzone van de Webex Meetings-site nodig heeft, geeft u de timezone parameter in de inrichtingsaanvraag voor:

  • de eerste abonnee die is ingericht voor het standaardpakket in de organisatie.

  • de eerste abonnee die is ingericht voor Premium-pakket in de organisatie.

  • de eerste abonnee die is ingericht voor het basispakket in de organisatie.

Algemene beperkingen

  • Geen gesprekken in de webversie van de Webex-client (dit is een clientbeperking, geen oplossingsbeperking.)

  • Webex beschikt mogelijk nog niet over alle besturingselementen voor de gebruikersinterface om bepaalde functies voor gespreksbeheer te ondersteunen die beschikbaar zijn via BroadWorks.

  • De Webex-client kan momenteel geen 'wit label' hebben.

  • Wanneer u klantorganisaties maakt met de door u gekozen inrichtingsmethode, worden deze automatisch gemaakt in dezelfde regio als uw partnerorganisatie. Dit gedrag is zo bepaald. We verwachten van multinationale partners dat ze in elke regio een partnerorganisatie creëren waar ze klantorganisaties beheren.

  • Rapportage over het gebruik van vergaderingen en berichten is beschikbaar via de klantorganisatie in Control Hub.

Bekende problemen en beperkingen

Zie Bekende problemen en beperkingen voor een actuele lijst met bekende problemen en beperkingen met het Webex voor Cisco BroadWorks-aanbod.

Berichtenlimieten

De volgende opslaglimieten voor gegevens (berichten en bestanden gecombineerd) zijn van toepassing op organisaties die Webex voor Cisco BroadWorks-services hebben aangeschaft via een serviceprovider. Deze limieten vertegenwoordigen de maximale opslag voor berichten en bestanden gecombineerd.

  • Basis: 2 GB per gebruiker gedurende 3 jaar

  • Standaard 5 GB per gebruiker gedurende 3 jaar

  • Premie: 10 GB per gebruiker gedurende 5 jaar

Voor elke klantorganisatie worden deze totalen per gebruiker samengevoegd om een geaggregeerd totaal voor die klant op te geven, op basis van het aantal gebruikers. Een bedrijf met vijf premium-gebruikers heeft bijvoorbeeld een totale limiet voor berichten en bestandsopslag van 50 GB. Een individuele gebruiker kan de limiet per gebruiker (10 GB) overschrijden op voorwaarde dat het bedrijf nog onder het geaggregeerde maximum (50 GB) zit.

Voor teamruimten die worden gemaakt, gelden de berichtlimieten voor het geaggregeerde totaal voor de klantorganisatie die eigenaar is van de teamruimte. U vindt informatie over de eigenaar van individuele teamruimten in het ruimtebeleid. Zie https://help.webex.com/en-us/baztm6/Webex-Space-Policy voor meer informatie over het bekijken van het ruimtebeleid voor een individuele teamruimte.

Aanvullende informatie

Raadpleeg https://help.webex.com/en-us/n8vw82eb/Webex-Capacities voor meer informatie over algemene berichtbeperkingen die van toepassing zijn op Webex-ruimten van het berichtenteam.

Beveiliging, gegevens en rollen

Webex-beveiliging

De Webex-client is een veilige toepassing die veilige verbindingen maakt met Webex en BroadWorks. De gegevens die in de Webex-cloud zijn opgeslagen en via de Webex-app aan de gebruiker zijn blootgesteld, worden zowel onderweg als in rust gecodeerd.

Meer informatie over gegevensuitwisseling vindt u in het deel Referentie van dit document.

Bijkomende lectuur

Locatie organisatiegegevens

We slaan uw Webex-gegevens op in het datacenter dat het meest overeenkomt met uw regio. Zie Gegevensresidentie in Webex in het Helpcentrum.

Rollen

Beheerder serviceprovider (u): Voor dagelijkse onderhoudsactiviteiten beheert u de lokale (bel)onderdelen van de oplossing met behulp van uw eigen systemen. U beheert de Webex-onderdelen van de oplossing via Partner Hub.

Zie Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM voor informatie over de rollen die beschikbaar zijn voor partners, de toegangsrechten die bij deze rollen horen en hoe u rollen kunt toewijzen.


 
De eerste gebruiker die is ingericht voor een nieuw partnerorganizaiton, wordt automatisch toegewezen aan de rollen Volledige beheerder en Volledige partnerbeheerder. Die beheerder kan het bovenstaande artikel gebruiken om extra rollen toe te wijzen.

Cisco Cloud Operations-team: Maakt uw 'partnerorganisatie' in Partner Hub, als deze niet bestaat, tijdens uw onboarding.

Zodra u uw Partner Hub-account hebt, configureert u de Webex-interfaces met uw eigen systemen. Vervolgens maakt u 'Onboarding-sjablonen' om de suites of pakketten weer te geven die via deze systemen worden aangeboden. Vervolgens richt u uw klanten of abonnees in.

#

Typische taak

SP

Cisco

1

Onboarding voor partners - De partnerorganisatie maken als deze nog niet bestaat en de benodigde functieschakelaars inschakelen

2

BroadWorks-configuratie in partnerorganisatie via Partner Hub (cluster)

3

Integratie-instellingen configureren in de partnerorganisatie via Partner Hub (aanbiedingssjablonen, branding)

4

BroadWorks-omgeving voorbereiden voor integratie (AS, XSP|ADP Patching, firewalls, XSP|ADP-configuratie, XSI, AuthService, CTI, NPS, DMS-toepassingen op XSP|ADP)

5

Inrichtingsintegratie of -proces ontwikkelen

6

GTM-materialen voorbereiden

7

Nieuwe gebruikers migreren of inrichten

Architectuur

Wat staat er in het diagram?

Clients

  • De Webex-app-client dient als de primaire toepassing in Webex voor Cisco BroadWorks-aanbiedingen. De client is beschikbaar op desktop-, mobiele en webplatforms.

    De client heeft systeemeigen chat-, presence- en meerpartijenaudio-/videovergaderingen die door de Webex-cloud worden geleverd. De Webex-client gebruikt uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken.

  • Cisco IP-telefoons en gerelateerde accessoires gebruiken ook uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken. We verwachten telefoons van derden te kunnen ondersteunen.

  • Activeringsportal voor gebruikers om zich aan te melden bij Webex met hun BroadWorks-aanmeldgegevens.

  • Partner Hub is een webinterface voor het beheren van uw Webex-organisatie en de organisaties van uw klanten. In Partner Hub kunt u de integratie tussen uw BroadWorks-infrastructuur en Webex configureren. U gebruikt ook Partner Hub om de clientconfiguratie en facturering te beheren.

Netwerk van serviceproviders

Het groene blok links op het diagram staat voor uw netwerk. Componenten die in uw netwerk worden gehost, bieden de volgende services en interfaces aan andere delen van de oplossing:

  • Openbare XSP|ADP, voor Webex voor Cisco BroadWorks: (De box staat voor een of meerdere XSP|ADP-boerderijen, mogelijk aan de voorkant door lastbalancers.)

    • Host de Xtended Services-interface (XSI-acties en XSI-gebeurtenissen), de Device Management-service (DMS), CTI-interface en de verificatieservice. Samen stellen deze toepassingen telefoons en Webex-clients in staat om zichzelf te verifiëren, hun gespreksconfiguratiebestanden te downloaden, gesprekken te starten en te ontvangen en elkaars haakstatus (telefonische aanwezigheid) en gespreksgeschiedenis te bekijken.

    • Publiceert directory naar Webex-clients.

  • Openbare XSP|ADP, met NPS:

    • Pushserver voor hostmeldingen: Een pushserver voor meldingen op een XSP|ADP in uw omgeving. Het werkt samen tussen uw toepassingsserver en onze NPS-proxy. De proxy levert korte tokens aan uw NPS om meldingen naar de cloudservices te autoriseren. Deze services (APNS & FCM) verzenden gespreksmeldingen naar Webex-clients op Apple iOS- en Google Android-apparaten.

  • Toepassingsserver:

    • Biedt gespreksbeheer en interfaces met andere BroadWorks-systemen (doorgaans)

    • Voor flowthrough-inrichting wordt het AS gebruikt door de partnerbeheerder om gebruikers in te richten in Webex

    • Hiermee wordt het gebruikersprofiel naar BroadWorks gepusht

  • OSS/BSS: Uw Operations Support System / Business SIP-services voor het beheer van uw BroadWorks-ondernemingen.

Webex Cloud

Het blauwe blok in het diagram staat voor de Webex-cloud. Webex-microservices ondersteunen het volledige spectrum van Webex-samenwerkingsmogelijkheden:

  • Cisco Common Identity (CI) is de identiteitsservice binnen Webex.

  • Webex voor Cisco BroadWorks staat voor de set microservices die de integratie tussen Webex en de gehoste BroadWorks-serviceprovider ondersteunen:

    • API's voor gebruikersinrichting

    • Configuratie van serviceprovider

    • Gebruikersaanmelding met BroadWorks-aanmeldgegevens

  • Webex-berichtenbox voor berichtengerelateerde microservices.

  • Webex Meetings-venster voor mediaverwerkingsservers en SBC's voor videovergaderingen met meerdere deelnemers (SIP & SRTP)

Webservices van derden

De volgende onderdelen van derden zijn weergegeven in het diagram:

  • APNS (Apple Push Notifications Service) pusht oproep- en berichtmeldingen naar Webex-toepassingen op Apple-apparaten.

  • FCM (FireBase Cloud Messaging) pusht meldingen voor gesprekken en berichten naar Webex-toepassingen op Android-apparaten.

XSP|ADP-architectuuroverwegingen

De rol van openbare XSP|ADP-servers in Webex voor Cisco BroadWorks

De openbare XSP|ADP in uw omgeving biedt de volgende interfaces/services aan Webex en clients:

  • Verificatieservice (AuthService), beveiligd door TLS, die reageert op Webex-verzoeken voor BroadWorks JWT (JSON Web Token) namens de gebruiker

  • CTI-interface, beveiligd door mTLS, waarop Webex zich abonneert voor gebeurtenissen uit de gespreksgeschiedenis en aanwezigheidsstatus van telefonie vanuit BroadWorks (haakstatus).

  • Xsi-acties en -gebeurtenissen-interfaces (eXtended Services Interface) voor gespreksbeheer voor abonnees, telefoonlijsten voor contactpersonen en gesprekslijsten en configuratie van de telefoonservice voor eindgebruikers

  • DM-service (Device Management) voor clients om hun configuratiebestanden voor gesprekken op te halen

Geef URL's op voor deze interfaces wanneer u Webex voor Cisco BroadWorks configureert. (Zie Uw BroadWorks-clusters configureren in Partnerhub in dit document.) Voor elk cluster kunt u slechts één URL voor elke interface opgeven. Als u meerdere interfaces hebt in uw BroadWorks-infrastructuur, kunt u meerdere clusters maken.

XSP|ADP-architectuur

XSP|ADP-architectuur: Optie 1
XSP|ADP-architectuur: Optie 2

We vereisen dat u een afzonderlijk, toegewezen XSP|ADP-exemplaar of -farm gebruikt om uw NPS-toepassing (Notification Push Server) te hosten. U kunt dezelfde NPS gebruiken met UC-One SaaS of UC-One Collaborate. Het is echter mogelijk dat u de andere toepassingen die vereist zijn voor Webex voor Cisco BroadWorks niet host op dezelfde XSP|ADP die de NPS-toepassing host.

We raden u aan een speciaal XSP|ADP-exemplaar/farm te gebruiken om de vereiste toepassingen voor Webex-integratie te hosten om de volgende redenen:

  • Als u bijvoorbeeld UC-One SaaS aanbiedt, raden we u aan een nieuwe XSP|ADP-farm te maken voor Webex voor Cisco BroadWorks. Op deze manier kunnen de twee diensten onafhankelijk werken terwijl u abonnees migreert.

  • Als u de Webex voor Cisco BroadWorks-toepassingen op een XSP|ADP-boerderij zoekt die voor andere doeleinden wordt gebruikt, is het uw verantwoordelijkheid om het gebruik te controleren, de daaruit voortvloeiende complexiteit te beheren en de verhoogde schaal te plannen.

  • De Cisco BroadWorks-systeemcapaciteitsplanner gaat uit van een specifieke XSP|ADP-farm en is mogelijk niet juist als u deze gebruikt voor collocatieberekeningen.

Tenzij anders vermeld, moet de speciale Webex voor Cisco BroadWorks XSP|ADP's de volgende toepassingen hosten:

  • Verificatieservice (TLS met CI-tokenvalidatie of mTLS)

  • CTI (mTLS)

  • XSI-acties (TLS)

  • XSI-gebeurtenissen (TLS)

  • DMS (TLS): optioneel. Het is niet verplicht om een afzonderlijk DMS-exemplaar of -bedrijf specifiek voor Webex voor Cisco BroadWorks te implementeren. U kunt hetzelfde DMS-exemplaar gebruiken dat u gebruikt voor UC-One SaaS of UC-One Collaborate.

  • Webview Gespreksinstellingen (TLS): optioneel. Webview voor gespreksinstellingen (CSW) is alleen vereist als u wilt dat Webex voor Cisco BroadWorks-gebruikers gespreksfuncties kunnen configureren in de Webex-app.

Webex vereist toegang tot CTI via een interface die is beveiligd door wederzijdse TLS-verificatie. Om deze vereiste te ondersteunen, raden we een van de volgende opties aan:

  • (Diagram gelabeld met Optie 1) Eén XSP|ADP-exemplaar of -bedrijf voor alle toepassingen, met twee interfaces die op elke server zijn geconfigureerd: een mTLS-interface voor CTI en een TLS-interface voor andere apps zoals de AuthService.

  • (Diagram gelabeld met Optie 2) Twee XSP|ADP-instanties of -farms, een met een mTLS-interface voor CTI, en de andere met een TLS-interface voor andere apps, zoals de AuthService.


 

XSP|ADP-hergebruik

Als u een bestaande XSP|ADP-boerderij hebt die voldoet aan een van de bovenstaande voorgestelde architecturen (optie 1 of 2) en deze lichtjes wordt geladen, is het mogelijk om uw bestaande XSP|ADP's opnieuw te gebruiken. U moet controleren of er geen tegenstrijdige configuratievereisten zijn tussen bestaande toepassingen en de nieuwe toepassingsvereisten voor Webex. De twee belangrijkste overwegingen zijn:

  • Als u meerdere Webex-partnerorganisaties op de XSP|ADP moet ondersteunen, betekent dit dat u mTLS moet gebruiken op de verificatieservice (CI Token Validation wordt alleen ondersteund voor één partnerorganisatie op een XSP|ADP). Als u mTLS gebruikt op de verificatieservice, betekent dit dat u niet tegelijkertijd clients kunt hebben die basisverificatie gebruiken op de verificatieservice. Deze situatie zou hergebruik van de XSP|ADP voorkomen.

  • Als de bestaande CTI-service is geconfigureerd voor gebruik door clients met de veilige poort (doorgaans 8012) maar zonder mTLS (d.w.z. clientverificatie), is dat in strijd met de Webex-vereiste om mTLS te hebben.

Omdat de XSP|ADP’s veel toepassingen hebben en het aantal permutaties van deze toepassingen groot is, kunnen er andere niet-geïdentificeerde conflicten zijn. Om deze reden moet elk mogelijk hergebruik van XSP|ADP's worden geverifieerd in een lab met de beoogde configuratie voordat wordt toegewezen aan het hergebruik.

NTP-synchronisatie configureren op XSP|ADP

De implementatie vereist tijdsynchronisatie voor alle XSP|ADP's die u met Webex gebruikt.

Installeer de ntp pakket nadat u het besturingssysteem hebt geïnstalleerd en voordat u de BroadWorks-software installeert. Vervolgens kunt u NTP configureren tijdens de installatie van de XSP|ADP-software. Zie de BroadWorks-handleiding voor softwarebeheer voor meer informatie.

Tijdens de interactieve installatie van de XSP|ADP-software krijgt u de optie om NTP te configureren. Ga verder als volgt:

  1. Wanneer het installatieprogramma hierom vraagt, Do you want to configure NTP?, voer in y.

  2. Wanneer het installatieprogramma hierom vraagt, Is this server going to be a NTP server?, voer in n.

  3. Wanneer het installatieprogramma hierom vraagt, What is the NTP address, hostname, or FQDN?, voer het adres van uw NTP-server of een openbare NTP-service in, bijvoorbeeld, pool.ntp.org.

Als uw XSP|ADP's een stille (niet-interactieve) installatie gebruiken, moet het installatieconfiguratiebestand de volgende Key=Value-paren bevatten:

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

XSP|ADP-identiteits- en beveiligingsvereisten

Achtergrond

De protocollen en coderingen van Cisco BroadWorks TLS-verbindingen kunnen op verschillende specificiteitsniveaus worden geconfigureerd. Deze niveaus variëren van de meest algemene (SSL-provider) tot de meest specifieke (individuele interface). Een meer specifieke instelling overschrijft altijd een meer algemene instelling. Als deze niet zijn opgegeven, worden SSL-instellingen op een lager niveau overgenomen van hogere niveaus.

Als er geen instellingen worden gewijzigd ten opzichte van de standaardinstellingen, worden de standaardinstellingen van de SSL-provider door alle niveaus overgenomen (JSSE Java Secure Sockets Extension).

Lijst met vereisten

  • De XSP|ADP moet zichzelf verifiëren bij clients met een door een certificeringsinstantie ondertekend certificaat waarin de algemene naam of alternatieve naam voor het onderwerp overeenkomt met het domeingedeelte van de XSI-interface.

  • De Xsi-interface moet het TLSv1.2-protocol ondersteunen.

  • De Xsi-interface moet een cijfersuite gebruiken die aan de volgende vereisten voldoet.

    • Diffie-Hellman Ephemeral (DHE) of Elliptic Curves Diffie-Hellman Ephemeral (ECDHE) sleuteluitwisseling

    • AES-code (Advanced Encryption Standard) met een minimale blokgrootte van 128 bits (bijv. AES-128 of AES-256)

    • GCM (Galois/Counter Mode) of CBC (Cipher Block Chaining) cipher mode

      • Indien een CBC-code gebruikt wordt, is enkel de SHA2-familie van hash-functies toegelaten voor sleutelafleiding (SHA256, SHA384, SHA512).

De volgende cijfers voldoen bijvoorbeeld aan de vereisten:

  • 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


 

De XSP|ADP CLI vereist de IANA-naamgevingsconventie voor versleutelingssuites, zoals hierboven weergegeven, niet de openSSL-conventie.

Ondersteunde TLS-cijfers voor de AuthService- en XSI-interfaces


 

Deze lijst kan worden gewijzigd naarmate onze cloudbeveiligingsvereisten evolueren. Volg de huidige aanbeveling voor Cisco-cloudbeveiliging voor cijferselectie, zoals beschreven in de lijst met vereisten in dit document.

  • 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

Parameters voor Xsi-gebeurtenisschaal

Mogelijk moet u de grootte van de Xsi-Events-wachtrij en het aantal thread verhogen om het volume aan gebeurtenissen af te handelen dat de Webex voor Cisco BroadWorks-oplossing vereist. U kunt de parameters als volgt verhogen tot de weergegeven minimumwaarden (verlaag ze niet als ze boven deze minimumwaarden liggen):

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

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

Meerdere XSP|ADP's

Randelement lastverdeling

Als u een load balancing-element op uw netwerkrand hebt, moet dit transparant omgaan met de verdeling van verkeer tussen uw meerdere XSP|ADP-servers en de Webex voor Cisco BroadWorks-cloud en -clients. In dit geval geeft u de URL van de load balancer op aan de Webex voor Cisco BroadWorks-configuratie.

Opmerkingen over deze architectuur:

  • Configureer DNS zodat de clients de load balancer kunnen vinden wanneer ze verbinding maken met de Xsi-interface (zie DNS-configuratie).

  • We raden u aan het randelement te configureren in de reverse SSL-proxymodus om punt-naar-punt-gegevenscodering te garanderen.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam. U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

Internetgerichte XSP|ADP-servers

Als u de Xsi-interfaces rechtstreeks blootstelt, gebruikt u DNS om het verkeer te distribueren naar de meerdere XSP|ADP-servers.

Opmerkingen over deze architectuur:

  • Er zijn twee records vereist om verbinding te maken met de XSP|ADP-servers:

    • Voor Webex-microservices: Round-robin A/AAAA-records zijn vereist om de meerdere XSP|ADP IP-adressen te bereiken. De reden hiervoor is dat de Webex-microservices geen SRV-zoekopdrachten kunnen uitvoeren. Zie Webex-cloudservices voor voorbeelden.

    • Voor de Webex-app: Een SRV-record dat wordt omgezet in A-records waarbij elk A-record wordt omgezet in één XSP|ADP. Zie de Webex-app voor voorbeelden.

      Gebruik geprioriteerde SRV-records om de XSI-service te richten op de meerdere XSP|ADP-adressen. Geef prioriteit aan uw SRV-records zodat de microservices altijd naar dezelfde A-record gaan (en het volgende IP-adres) en alleen naar de volgende A-record (en IP-adres) gaan als het eerste IP-adres niet beschikbaar is. GEBRUIK GEEN round-robin-benadering voor de Webex-app.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam.

  • U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

HTTP-omleidingen vermijden

Soms is DNS geconfigureerd om de XSP|ADP-URL op te lossen naar een HTTP-laadbalancer en is de laadbalancer geconfigureerd voor omleiding via een reverse proxy naar de XSP|ADP-servers.

Webex volgt geen omleiding wanneer u verbinding maakt met de URL's die u levert, dus deze configuratie werkt niet.

Bestellen en inrichten

Bestellen en inrichten is van toepassing op deze niveaus:

  • Inrichting van partner/serviceprovider:

    Elke geïntegreerde Webex voor Cisco BroadWorks-serviceprovider (of reseller) moet worden geconfigureerd als een partnerorganisatie in Webex en de nodige rechten krijgen. Cisco Operations biedt de beheerder van de partnerorganisatie toegang tot het beheren van Webex voor Cisco BroadWorks op Webex Partner Hub. De partnerbeheerder moet alle vereiste inrichtingsstappen uitvoeren voordat hij/zij een klant/bedrijfsorganisatie kan inrichten.

  • Bestellen en inrichten klant/onderneming:

    Elke BroadWorks Enterprise die is ingeschakeld voor Webex voor Cisco BroadWorks, activeert het maken van een gekoppelde Webex-klantorganisatie. Dit proces vindt automatisch plaats als onderdeel van de inrichting van de gebruiker/abonnee. Alle gebruikers/abonnees binnen een BroadWorks-onderneming zijn ingericht in dezelfde Webex-klantorganisatie.

    Hetzelfde gedrag is van toepassing als uw BroadWorks-systeem is geconfigureerd als serviceprovider met groepen. Wanneer u een abonnee inricht in een BroadWorks-groep, wordt er automatisch een klantorganisatie gemaakt in Webex die overeenkomt met de groep.

  • Bestellen en inrichten van gebruikers/abonnees:

    Webex voor Cisco BroadWorks ondersteunt momenteel de volgende modellen voor gebruikersinrichting:

    • Flowthrough-inrichting met vertrouwde e-mails

    • Flowthrough-inrichting zonder vertrouwde e-mails

    • Zelfinrichting gebruiker

    • API-inrichting

Flowthrough-inrichting met vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u kunt bevestigen dat BroadWorks e-mailadressen van abonnees heeft die geldig en uniek zijn voor Webex, maakt en activeert deze inrichtingsoptie automatisch Webex-accounts met deze e-mailadressen als gebruikers-id's.

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Flowthrough-inrichting met vertrouwde e-mails

Flowthrough-inrichting zonder vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u niet kunt vertrouwen op de e-mailadressen van abonnees die in handen zijn van BroadWorks, maakt deze inrichtingsoptie Webex-accounts, maar kan deze niet worden geactiveerd totdat abonnees hun e-mailadressen leveren en valideren. Op dat moment kan Webex de accounts met deze e-mailadressen activeren als gebruikers-id's.

Flowthrough-inrichting zonder vertrouwde e-mails

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Zelfinrichting gebruiker

Met deze optie is er geen flowthrough-inrichting van BroadWorks naar Webex. Nadat u de integratie tussen Webex en uw BroadWorks-systeem hebt geconfigureerd, krijgt u een of meer koppelingen die specifiek zijn voor het inrichten van gebruikers binnen uw Webex voor Cisco BroadWorks-partnerorganisatie.

Vervolgens ontwerpt u uw eigen communicatie (of delegeert u aan uw klanten) om de link naar abonnees te verspreiden. De abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun eigen Webex-accounts te maken en te activeren.

Zelfinrichting gebruiker

Omdat de accounts zijn ingericht binnen het bereik van uw partnerorganisatie, kunt u gebruikerspakketten handmatig aanpassen via Partner Hub of de API gebruiken om dit te doen.


 

Gebruikers moeten bestaan in het BroadWorks-systeem dat u met Webex integreert, of ze mogen geen accounts maken met die koppeling.

Serviceproviderinrichting door API's

Webex toont een reeks openbare API's waarmee u Webex voor Cisco BroadWorks gebruikers-/abonneevoorzieningen kunt maken in uw bestaande gebruikersbeheerworkflow/-tools.

Serviceproviderinrichting door API's - Vertrouwde e-mails
Serviceproviderinrichting door API's - Niet-vertrouwde e-mails

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Toestelnummer bellen

Met ondersteuning voor de functie voor toestelbellen kunnen Webex-gebruikers van Cisco Broadworks andere gebruikers bellen met een toestel dat vergelijkbaar is met het primaire telefoonnummer binnen dezelfde onderneming. Dit is vooral handig voor gebruikers die geen DID-nummers hebben.

Tijdens het inrichten wordt het toestelnummer van de gebruikers opgeslagen in de Webex-directory als het toestelnummer van de gebruiker. Voor BroadWorks-gesprekken wordt het toestelnummer weergegeven in de Webex-app in het toestelveld van alle gebieden met de gespreksinitiatiemethode en het profiel van de gebruiker. Webex voor Cisco BroadWorks ondersteunt alleen-toestelgesprekken tussen gebruikers binnen dezelfde groep en verschillende groepen van dezelfde onderneming met de combinatie van kiescode voor locatie en toestel. Bellen tussen twee bedrijven die alleen extensies gebruiken, wordt echter niet ondersteund.

Er kan een toestel worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'toestel'

      • De toestelparameter moet expliciet worden doorgegeven als onderdeel van de API-oproep. Voor bedrijven/groepen waarvoor LDC (Location Dialing Code) is geconfigureerd, moet de toestelparameter de combinatie LDC en 'toestelnummer' zijn.

    • Flowthrough- of zelfactiveringsinrichting

      • Toestel en LDC (indien van toepassing) worden automatisch opgehaald uit BroadWorks.

  • Gespreksgebruikers of -entiteiten met alleen BroadWorks

    • Automatisch gesynchroniseerd vanuit BroadWorks via adreslijstsynchronisatie met de combinatie van LDC (Location Dialing Code) en toestelnummer.

Tabel 2. Toestelnummers beheren op basis van de inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Toestelnummer beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

Toestelnummer moet worden doorgegeven als parameter

Doorstroomd

Toestel automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

BroadWorks-telefoonlijsten

Lijsten met bedrijven, groepen of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing

Voorwaarden

  1. De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.

  2. Patch waarbij kiescodes voor toestelnummers en locaties worden toegevoegd aan XSI en inrichtingsadapter februari 2022 voor versie 23 of hoger als onderdeel van:

    • 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. Schakel de koptekst X-BroadWorks-Remote-Party-Info in op het AS met de onderstaande CLI-opdracht voor deze SIP-gespreksstroom die vereist is voor ondersteuning van de functie voor toestelbellen.

    AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Prioriteit oproepopties in de app

Als onderdeel van de ondersteuning voor de functie Toestelbellen wordt De prioriteitsinstelling voor gespreksopties van de app ook op partnerniveau aangeboden voor alle Webex voor Cisco Broadworks-partners. Met deze instelling kan de partner de gespreksprioriteitsinstellingen van al zijn beheerde klanten beheren vanuit Partner Hub. De prioriteitsinstelling voor app-gespreksopties voor een klant kan ook op klantniveau worden gewijzigd vanuit Control Hub.

De prioriteitsinstelling voor app-gespreksopties bevat toestel als tweede optie in zowel Partner Hub als Control Hub wanneer een Webex voor Cisco Broadworks-gebruiker nieuw is ingericht met toestel via een van de bovengenoemde inrichtingsmethoden.

Voor alle bestaande ingerichte organisaties heeft de uitbreidingsoptie de verborgen status (standaard) in de prioriteitsinstelling voor app-gespreksopties. Er wordt geen toestel weergegeven in de optie voor audio-/videogesprekken van de gebruiker in de Webex-app.

Hieronder ziet u de opties om de optie Toestelgesprek zichtbaar te maken voor de bestaande klanten:

  1. Als een partner wil dat al zijn beheerde klantorganisaties een toestel krijgen als een van de gespreksopties, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Partnerhub. Hierdoor kunnen de beheerde klantorganisaties de instelling van hun partner overnemen.

  2. Als een partner een toestel wil aanbieden in gespreksopties voor een specifieke klantorganisatie, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Control Hub.

Ondersteuning voor groepscontactpersonen

Met deze functie wordt de Webex for BroadWorks DirSync-service verbeterd door de beperking voor het synchroniseren van maximaal 1500 contactpersonen uit de telefoonlijsten van de groep in BroadWorks te verwijderen en partners in staat te stellen maximaal 30K contactpersonen uit een enkele telefoonlijst van de groep te synchroniseren en deze gelijk te maken met de verhoging van 30K contactpersonen voor de Enterprise telefoonlijst, die afzonderlijk is vrijgegeven.

Er is een totale limiet van 200K voor alle externe contactpersonen per organisatie, die van toepassing is op de som van Enterprise- en Group-telefoonlijsten in één BroadWorks-onderneming. Een BroadWorks-onderneming met een bedrijfstelefoonlijst met 30K en ook 5 groepstelefoonlijsten met elk 30K worden ondersteund (180K totaal per organisatie). Als er echter 6 groepstelefoonlijsten zijn met elk 30K, wordt dit niet ondersteund (210K totaal).


 

Deze functie is beschikbaar op aanvraag. Neem contact op met uw accountteam om dit in te schakelen.

  • Voordat u de functie inschakelt, moet een vereiste migratie worden uitgevoerd om groepen in te richten en te koppelen voor alle bestaande ingerichte gebruikers.

  • Het Cisco-team voert een interne API uit om bestaande ingerichte gebruikers te migreren om ze aan de juiste groep te koppelen. OPMERKING: Dit kan tot een week duren om te verwerken.

  • Zodra de migratie is voltooid voor de partner en de functie is ingeschakeld, worden alle nieuw ingerichte gebruikers op de juiste manier 'gegroepeerd'.

Nadat de functie is ingeschakeld, begint de DirSync-service met het synchroniseren van contactpersonen uit de telefoonlijst van de BroadWorks-groep in de speciale opslag voor groepscontactpersonen in de Webex-contactservice.

Tijdens het inrichten moet de bedrijfsgroep van de gebruiker worden opgeslagen in de Webex-directory om aan te geven tot welke groep deze gebruiker behoort. Met de koppeling van de gebruiker aan een BroadWorks-groep in de Webex-directory kan de Webex-app contact zoeken in de opslag voor de contactservicegroep voor de specifieke groep van de gebruiker.

Voor deze functie moeten de Webex for BroadWorks-abonnees in Webex worden ingericht met de BroadWorks-bedrijfs-groeps-id.

De BroadWorks Enterprise Group Id kan worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Webex voor Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'spEnterpriseGroupId'

      • De BroadWorks Enterprise Group Id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek.

    • Flowthrough- of zelfactiveringsinrichting

      • BroadWorks-bedrijfs-groeps-id wordt automatisch opgehaald uit BroadWorks.

    • Gespreksgebruikers of -entiteiten met alleen BroadWorks

      • Niet van toepassing. Het is niet vereist om de BroadWorks Enterprise Group-id voor deze gebruikers te synchroniseren.

Tabel 3. Beheer van Enterprise Group ID op basis van inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Bedrijfs-groeps-id beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

BroadWorks-bedrijfs groep-id moet worden doorgegeven als parameter spEnterpriseGroupId

Doorstroomd

BroadWorks-bedrijfs groep-id wordt automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Niet van toepassing

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Niet van toepassing

BroadWorks-telefoonlijsten

Contactpersonen in de telefoonlijsten van de BroadWorks-groep

Synchroniseren met Directory

Groepscontacten worden opgeslagen in de Webex-contactservice die is gekoppeld aan de specifieke groep

Lijsten met BroadWorks-enterpsie of persional-telefoons

Contactpersonen in de lijsten met zakelijke of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing


 

Openbare API moet worden bijgewerkt VÓÓR de MIGRATIE. Migratie kan niet worden voltooid totdat DEZE API is voltooid. De BroadWorks Enterprise Group-id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek https://developer.webex.com/docs/api/changelog#2023-march

Nadat de functie is ingeschakeld en als gevolg van de volgende adreslijstsynchronisatie worden de bedrijfsgebruikersgroepen ook weergegeven in Control Hub. Het visualiseren van de groepen in Control Hub voor Webex voor BroadWorks is in dit stadium puur informatief. Partner- en klantbeheerders mogen geen wijzigingen aanbrengen aan groepen of groepslidmaatschap in Control Hub, omdat deze wijzigingen niet worden teruggekoppeld naar BroadWorks. Groepsbeheer in Control Hub is bedoeld voor gebruik door partners die de komende API's voor contactbeheer gaan gebruiken.

Migratie en toekomstbestendigheid

De progressie van Cisco van de BroadSoft Unified Communications Client is om van UC-One naar Webex te gaan. Er is een overeenkomstige progressie van de ondersteunende services weg van het netwerk van serviceproviders – behalve bellen – naar het Webex-cloudplatform.

Of u nu UC-One SaaS of BroadWorks Collaborate gebruikt, de voorkeursmigratiestrategie is het implementeren van nieuwe, speciale XSP|ADP's voor integratie met Webex voor Cisco BroadWorks. U kunt de twee services parallel uitvoeren terwijl u klanten migreert naar Webex en uiteindelijk de infrastructuur terugverdienen die is gebruikt voor de vorige oplossing.

Aanbevolen documentabonnementen

Webex Help Center-artikelen (op help.webex.com) hebben een optie Abonneren waarmee u een e-mailmelding kunt ontvangen wanneer dat artikel wordt bijgewerkt.

We raden u aan u te abonneren op elk van de volgende artikelen om ervoor te zorgen dat u geen kritieke updates mist die van invloed zijn op de netwerkverbinding. Om u in te schrijven, gaat u naar elk van de onderstaande links en klikt u in het artikel dat wordt gelanceerd op de knop Subscribe.

We raden u aan om u minimaal in te schrijven voor bovenstaande lijst. De meeste Webex-artikelen en -documenten die worden vermeld onder Aanvullende documenten hebben echter een optie Abonneren. Als deze optie moet worden weergegeven, moet het artikel worden weergegeven op help.webex.com.


 
Er is geen abonnementsoptie voor landingspagina's van documentatie.

Aanvullende documenten

Raadpleeg de volgende gerelateerde documentatie voor meer informatie over Webex voor Cisco BroadWorks:

Webex voor Cisco BroadWorks-documenten

Partnerbeheerders kunnen de volgende documenten en sites gebruiken om informatie te verkrijgen over Webex voor Cisco BroadWorks.

Webex voor Cisco BroadWorks-artikelen

Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:

Cisco BroadWorks-documenten

Partnerbeheerders kunnen verwijzen naar de Cisco BroadWorks-site op cisco.com voor technische documenten die beschrijven hoe het Cisco BroadWorks-gedeelte van de oplossing moet worden geïmplementeerd:

Webex Help-artikelen

De volgende Webex Help-sites kunnen worden gebruikt om Webex-artikelen te vinden waarmee klantbeheerders en eindgebruikers Webex-functies kunnen gebruiken.

  • Webex van serviceproviders: deze landingspagina bevat koppelingen met informatie over aan de slag gaan en veelgebruikte artikelen voor gebruikers van de Webex-app die Webex-services hebben gekocht bij een serviceprovider.

  • Webex-helpcentrum: gebruik de zoekfunctie op help.webex.com om te zoeken naar aanvullende Webex-artikelen waarin de Webex-app en de Webex Meetings-functionaliteit worden beschreven. U kunt zoeken naar gebruikers- of beheerdersartikelen.

Documentatie voor ontwikkelaars

Uw omgeving voorbereiden

Beslissingspunten

Overweging Vragen om te beantwoorden Resources

Architectuur en infrastructuur

Hoeveel XSP|ADP’s?

Hoe nemen ze mTLS in?

Cisco BroadWorks-systeemcapaciteitsplanner

Technische handleiding voor Cisco BroadWorks-systemen

XSP|ADP CLI-referentie

Dit document

Klant- en gebruikersvoorzieningen

Kunt u bevestigen dat u e-mails vertrouwt in BroadWorks?

Wilt u dat gebruikers e-mailadressen opgeven om hun eigen accounts te activeren?

Kunt u tools maken om onze API te gebruiken?

Openbare API-documenten op https://developer.webex.com

Dit document

Branding Welke kleur en logo wilt u gebruiken? Brandingartikel van de Webex-app
Sjablonen Wat zijn uw verschillende gebruiksscenario's voor klanten? Dit document
Abonneefuncties per klant/onderneming/groep Kies een pakket om het serviceniveau per sjabloon te definiëren. Basic, Standard, Premium of Softphone.

Dit document

Functie-/pakketmatrix

Gebruikersverificatie BroadWorks of Webex Dit document
Inrichtingsadapter (voor flowthrough-inrichtingsopties)

Gebruikt u al geïntegreerde IM&P, bijv. voor UC-One SaaS?

Bent u van plan meerdere sjablonen te gebruiken?

Is er een meer voorkomende usecase voorzien?

Dit document

CLI-referentie toepassingsserver

Architectuur en infrastructuur

  • Met welke schaal gaat u beginnen? Het is mogelijk om in de toekomst op te schalen, maar uw huidige gebruiksinschatting zou de infrastructuurplanning moeten stimuleren.

  • Werk samen met uw Cisco-accountmanager/verkoopvertegenwoordiger om uw XSP|ADP-infrastructuur te vergroten, volgens de Cisco BroadWorks System Capacity Planner en de Cisco BroadWorks System Engineering Guide.

  • Hoe maakt Webex wederzijdse TLS-verbindingen met uw XSP|ADP's? Rechtstreeks naar de XSP|ADP in een DMZ, of via TLS-proxy? Dit is van invloed op uw certificaatbeheer en de URL's die u gebruikt voor de interfaces. (We ondersteunen geen ongecodeerde TCP-verbindingen met de rand van uw netwerk).

Klant- en gebruikersvoorzieningen

Welke gebruikersinrichtingsmethode past het beste bij u?

  • Flowthrough Provisioning Met Vertrouwde E-mails: Door de service 'Geïntegreerde IM&P' toe te wijzen op BroadWorks, wordt de abonnee automatisch ingericht in Webex.

    Als u ook kunt bevestigen dat de e-mailadressen van abonnees in BroadWorks geldig en uniek zijn voor Webex, kunt u de variant 'vertrouwde e-mail' van flowthrough-inrichting gebruiken. Webex-abonneeaccounts worden zonder hun tussenkomst gemaakt en geactiveerd. Ze downloaden gewoon de client en melden zich aan.

    E-mailadres is een belangrijk gebruikerskenmerk in Webex. Daarom moet de serviceprovider een geldig e-mailadres voor de gebruiker opgeven om deze in te richten voor Webex-services. Dit moet het e-mail-id-kenmerk van de gebruiker zijn in BroadWorks. We raden u aan deze ook te kopiëren naar het kenmerk Alternatieve id.

  • Flowthrough-inrichting zonder vertrouwde e-mails: Als u de e-mailadressen van abonnees niet kunt vertrouwen, kunt u nog steeds de geïntegreerde IM&P-service in BroadWorks toewijzen om gebruikers in Webex in te richten.

    Met deze optie worden de accounts gemaakt wanneer u de service toewijst, maar moeten de abonnees hun e-mailadressen opgeven en valideren om de Webex-accounts te activeren.

  • Zelfinrichting gebruiker: Voor deze optie is geen IM&P-servicetoewijzing in BroadWorks vereist. U (of uw klanten) distribueert in plaats daarvan een inrichtingskoppeling en de koppelingen om de verschillende clients te downloaden, met uw branding en instructies.

    Abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun Webex-accounts te maken en te activeren. Vervolgens downloaden ze de client en melden zich aan en haalt Webex een aantal extra configuraties over hen op vanuit BroadWorks (inclusief hun primaire nummers).

  • SP-beheerde inrichting via API's: Webex stelt een reeks openbare API's bloot waarmee serviceproviders gebruikersvoorzieningen/abonneevoorzieningen kunnen bouwen in hun bestaande workflows.

Inrichtingsvereisten

In de volgende tabel worden de vereisten voor elke inrichtingsmethode samengevat. Naast deze vereisten moet uw implementatie voldoen aan de algemene systeemvereisten die in deze handleiding worden beschreven.

Inrichtingsmethode

Vereisten

Doorstroominrichting

(Vertrouwde of niet-vertrouwde e-mails)

De Webex-provisioning-API voegt bestaande BroadWorks-gebruikers automatisch toe aan Webex zodra de gebruiker aan de vereisten voldoet en u de geïntegreerde IM+P-service inschakelt.

Er zijn twee stromen (vertrouwde e-mails of niet-vertrouwde e-mails) die u toewijst via de onboardsjabloon op Webex.

Vereisten voor BroadWorks:

  • Gebruiker bestaat in BroadWorks met een primair nummer of toestel.

  • De gebruiker krijgt de geïntegreerde IM+P-service toegewezen, die verwijst naar de URL van de Webex-inrichtingsservice.

  • Alleen vertrouwde e-mails. De gebruiker heeft een e-mailadres geconfigureerd in BroadWorks. We raden u aan om het e-mailadres ook toe te voegen aan het veld Alternatieve id, omdat de gebruiker zich op die manier kan aanmelden met BroadWorks-referenties.

  • BroadWorks heeft verplichte patches geïnstalleerd voor flowthrough-inrichting. Zie Vereiste patches met flowthrough-inrichting (hieronder) voor de patchvereisten.

  • BroadWorks AS is rechtstreeks verbonden met de Webex-cloud of de proxy van de inrichtingsadapter is geconfigureerd met verbinding met de URL van de Webex-inrichtingsservice.

    Zie Toepassingsserver configureren met inrichtingsservice-URL om de URL van de Webex-inrichtingsservice op te halen.

    Zie Cisco BroadWorks Implement Provisioning Adapter Proxy FD om de Provisioning Adapter Proxy te configureren.

Webex-vereisten:

Het onboardsjabloon bevat de volgende instellingen:

  • De schakelaar BroadWorks-flow via inrichting inschakelen is ingeschakeld.

  • De naam en het wachtwoord van het inrichtingsaccount worden toegewezen met de beheerdersreferenties op systeemniveau van BroadWorks

  • Gebruikersverificatie is ingesteld op Trust BroadWorks-e-mails of Niet-vertrouwde e-mails.

Zelfinrichting gebruiker

Beheerder biedt een bestaande BroadWorks-gebruiker een koppeling naar de portal voor gebruikersactivering. De gebruiker moet zich met de BroadWorks-referenties aanmelden bij de portal en een geldig e-mailadres opgeven. Nadat het e-mailadres is gevalideerd, haalt Webex aanvullende gebruikersinformatie op om de inrichting te voltooien.

Vereisten voor BroadWorks:

  • Gebruiker moet bestaan in BroadWorks met een primair nummer of toestel

Webex-vereisten:

Het onboardsjabloon bevat de volgende instellingen:

  • De schakelaar Flow Through Provisioning inschakelen is uitgeschakeld.

  • Gebruikersverificatie is ingesteld op Niet-vertrouwde e-mails.

  • Gebruikers toestaan zichzelf te activeren is ingeschakeld.

SP-beheerde inrichting via API

(Vertrouwde of niet-vertrouwde e-mails)

Webex toont een reeks openbare API's waarmee u gebruikersvoorzieningen kunt bouwen in uw bestaande werkstromen en tools. Er zijn twee stromen:

  • Vertrouwde e-mails: de API voorziet de gebruiker en past het BroadWorks-e-mailadres toe als het Webex-e-mailadres.

  • Niet-vertrouwde e-mails: de API voorziet in de gebruiker, maar de gebruiker moet zich aanmelden bij de User Activation Portal en een geldig e-mailadres opgeven.

Vereisten voor BroadWorks:

  • Gebruiker moet bestaan in BroadWorks met een primair nummer of toestel.

Webex-vereisten:

  • In de onboardsjabloon is de gebruikersverificatie ingesteld op Trust BroadWorks e-mails of Niet-vertrouwde e-mails.

  • U moet uw aanvraag registreren en hiervoor toestemming vragen.

  • U moet een OAuth-token aanvragen met de scopes die zijn gemarkeerd in het gedeelte 'Verificatie' van de Webex for BroadWorks-ontwikkelaarshandleiding.

  • Er moet een beheerder of inrichtingsbeheerder worden toegewezen aan uw partnerorganisatie.

Ga naar BroadWorks-abonnees om de API's te gebruiken.

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Ondersteunde taallandinstellingen

Tijdens het inrichten wordt de taal die in beheergebruiker is toegewezen aan de eerste ingerichte beheergebruiker automatisch toegewezen als de standaardlandinstelling voor die klantorganisatie. Deze instelling bepaalt de standaardtaal die wordt gebruikt voor activeringsmails, vergaderingen en uitnodigingen voor vergaderingen onder die klantorganisatie.

Taallandinstellingen met vijf tekens in (ISO-639-1)_(ISO-3166)-indeling worden ondersteund. en_VS komt bijvoorbeeld overeen met English_UnitedStates. Als er slechts een taal met twee letters wordt aangevraagd (in ISO-639-1-indeling), genereert de service een landinstelling met vijf tekens door de aangevraagde taal te combineren met een landcode uit de sjabloon, d.w.z. "requestedLanguage_CountryCode", als er geen geldige landinstelling kan worden verkregen, wordt de standaard verstandige landinstelling gebruikt op basis van de vereiste taalcode.

De volgende tabel bevat de ondersteunde landinstellingen en de toewijzing waarmee een taalcode van twee letters wordt omgezet in een landinstelling met vijf tekens voor situaties waarin een landinstelling met vijf tekens niet beschikbaar is.

Tabel 1. Ondersteunde taallandcodes

Ondersteunde taallandinstellingen

(ISO-639-1)_(ISO-3166)

Als er alleen een taalcode met twee letters beschikbaar is...

Taalcode (ISO-639-1) **

Gebruik in plaats daarvan Standaard verstandige landinstelling (ISO-639-1)_(ISO-3166)

en_VS

en_AU

en_GB

en_CA

en

en_VS

fr_vr

fr_CA

vr

fr_vr

cs_CZ, CZ

cs

cs_CZ, CZ

da_DK

da's, da's

da_DK

de_de

de

de_de

hu_HU

(aan)laars

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_NEE

nb

nb_NEE

pl_VERV.

verv.

pl_VERV.

pt_PT

pt_BR

pt

pt_PT

ru_ru

ru

ru_ru

ro_RO

ro

ro_RO

zh_CN

zh_TW

zweer

zh_CN

sv_SE

sv

sv_SE

ar_SA

ar, teken, teken

ar_SA

tr_TR

staartstuk

tr_TR


 

De landinstellingen es_CO, id_ID, nb_NO en pt_PT worden niet ondersteund door Webex Meeting-sites. Voor deze landinstellingen zijn De Webex Meetings-sites alleen in het Engels. Engels is de standaardlandinstelling voor sites als er geen/ongeldige/niet-ondersteunde landinstelling vereist is voor de site. Dit taalveld is van toepassing bij het maken van een organisatie- en Webex Meetings-site. Als er geen taal wordt vermeld in een bericht of in de API van de abonnee, wordt de taal van de sjabloon gebruikt als standaardtaal.

Branding

Partnerbeheerders kunnen geavanceerde merkaanpassingen gebruiken om aan te passen hoe de Webex app eruitziet voor de klantorganisaties die de partner beheert. Partnerbeheerders kunnen de volgende instellingen aanpassen om ervoor te zorgen dat de Webex -app het merk en de identiteit van hun bedrijf weerspiegelt:

  • Bedrijfslogo's

  • Unieke kleurenschema's voor de lichte modus of de donkere modus

  • Aangepaste ondersteunings-URL's

Meer informatie over het aanpassen van branding vindt u in Geavanceerde branding-aanpassingen configureren.


 
  • Aanpassingen voor basisbranding worden afgeschaft. We raden u aan Advanced Branding te implementeren, dat een breder scala aan aanpassingen biedt.

  • Voor meer informatie over hoe branding wordt toegepast bij het koppelen aan een bestaande klantorganisatie, raadpleegt u Voorwaarden van organisatiebijlage in het gedeelte Webex voor BroadWorks toevoegen aan bestaande organisatie.

Onboardingssjablonen

Met onboardsjablonen kunt u de parameters definiëren waarmee klanten en gekoppelde abonnees automatisch worden ingericht in Webex voor Cisco BroadWorks. U kunt indien nodig meerdere onboardsjablonen configureren, maar wanneer u een klant onboardt, is deze aan slechts één sjabloon gekoppeld (u kunt niet meerdere sjablonen op één klant toepassen).

Enkele van de primaire sjabloonparameters worden hieronder weergegeven.

Pakket

  • U moet een standaardpakket selecteren wanneer u een sjabloon aanmaakt (zie Pakketten in het gedeelte Overzicht voor meer informatie). Alle gebruikers die zijn ingericht met die sjabloon, hetzij door middel van flowthrough- of self-provisioning, ontvangen het standaardpakket.

  • U hebt controle over de pakketselectie voor verschillende klanten door meerdere sjablonen te maken en telkens verschillende standaardpakketten te selecteren. U kunt vervolgens verschillende inrichtingskoppelingen of verschillende inrichtingsadapters per onderneming distribueren, afhankelijk van de door u gekozen gebruikersinrichtingsmethode voor deze sjablonen.

  • U kunt het pakket met specifieke abonnees wijzigen vanaf deze standaard met behulp van de inrichtings-API (zie Webex voor Cisco BroadWorks API-documentatie of via Partner Hub (zie Gebruikerspakket wijzigen in Partner Hub).

  • U kunt het pakket van een abonnee niet wijzigen vanuit BroadWorks. De toewijzing van de geïntegreerde IM&P-service is in- of uitgeschakeld. Als de abonnee deze service in BroadWorks wordt toegewezen, definieert de Partner Hub-sjabloon die is gekoppeld aan de inrichtings-URL van de onderneming van die abonnee het pakket.

Doorverkoper en ondernemingen of serviceprovider en groepen?

  • De manier waarop uw BroadWorks-systeem is geconfigureerd, heeft invloed op de flow via inrichting. Als u een reseller bent met Enterprises, moet u de Enterprise-modus inschakelen wanneer u een sjabloon maakt.

  • Als uw BroadWorks-systeem is geconfigureerd in de serviceprovidermodus, kunt u de Enterprise-modus uitschakelen in uw sjablonen.

  • Als u van plan bent klantorganisaties in te richten met beide BroadWorks-modi, moet u verschillende sjablonen gebruiken voor groepen en bedrijven.


 
Zorg ervoor dat u de BroadWorks-patches hebt toegepast die vereist zijn voor doorstroominrichting. Zie Vereiste patches met doorstroominrichting voor meer informatie.

Verificatiemodus

Bepaal hoe u wilt dat abonnees zich verifiëren wanneer ze zich aanmelden bij Webex. U kunt de modus toewijzen met de instelling Verificatiemodus in de onboardingsjabloon. In de volgende tabel worden enkele opties beschreven.


 
Deze instelling heeft geen invloed op het aanmelden bij de User Activation Portal. Gebruikers die zich aanmelden bij de portal, moeten hun BroadWorks-gebruikers-id en -wachtwoord invoeren, zoals geconfigureerd in BroadWorks, ongeacht hoe u de verificatiemodus configureert in de onboardsjabloon.
VerificatiemodusBroadWorksWebex
Primaire gebruikersidentiteitBroadWorks-gebruikers-idE-mailadres
Identiteitsprovider

BroadWorks.

  • Als u een directe verbinding met BroadWorks configureert, wordt de Webex-app rechtstreeks geverifieerd bij de BroadWorks-server.

    Als u een directe verbinding wilt configureren, moet het selectievakje Directe BroadWorks-verificatie inschakelen zijn ingeschakeld in de BroadWorks-clusterconfiguratie op Partner Hub (de instelling is standaard uitgeschakeld).

  • Anders wordt verificatie naar BroadWorks mogelijk gemaakt via een intermediaire service die door Webex wordt gehost.

Cisco Common Identity
Meervoudige verificatie?NeeVereist Customer IdP die meervoudige verificatie ondersteunt.

Validatiepad gebruikergegevens

  1. Browser wordt gestart waarbij de gebruiker e-mail levert om de eerste aanmeldstroom te starten en de verificatiemodus te detecteren.

  2. De browser wordt vervolgens omgeleid naar een door Webex gehoste BroadWorks-aanmeldpagina (deze pagina is brandable)

  3. Gebruiker levert BroadWorks gebruikers-id en wachtwoord op de aanmeldpagina.

  4. Gebruikersreferenties worden gevalideerd met BroadWorks.

  5. Bij succes wordt een autorisatiecode verkregen van Webex. Dit wordt gebruikt om de benodigde toegangstokens voor Webex-services te verkrijgen.

  1. Browser wordt gestart waarbij de gebruiker e-mail levert om de eerste aanmeldstroom te starten en de verificatiemodus te detecteren.

  2. De browser wordt omgeleid naar IdP (Cisco Common Identity of Customer IdP), waar ze een aanmeldportal krijgen.

  3. Gebruiker levert de juiste aanmeldgegevens op de aanmeldpagina

  4. Verificatie met meerdere factoren kan plaatsvinden als de Customer IdP dit ondersteunt.

  5. Bij succes wordt een autorisatiecode verkregen van Webex. Dit wordt gebruikt om de benodigde toegangstokens voor Webex-services te verkrijgen.


 
Zie SSO-aanmeldstroom voor een gedetailleerder overzicht van de SSO-aanmeldstroom met directe verificatie naar BroadWorks.

UTF-8-codering met BroadWorks-verificatie

Met BroadWorks-verificatie raden we u aan UTF-8-codering voor de verificatiekoptekst te configureren. UTF-8 lost een probleem op dat zich kan voordoen met wachtwoorden die speciale tekens gebruiken waarbij de webbrowser de tekens niet goed codeert. Met behulp van een UTF-8-gecodeerde, basis 64-gecodeerde header lost dit probleem op.

U kunt UTF-8-codering configureren door een van de volgende CLI-opdrachten uit te voeren op de XSP of ADP:

  • XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

  • ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

Land

U moet een land selecteren wanneer u een sjabloon maakt. Dit land wordt automatisch toegewezen als het organisatieland voor alle klanten die zijn ingericht met de sjabloon in Common Identity. Daarnaast bepaalt het land van de organisatie de standaard internationale inbelnummers voor Cisco PSTN in Webex Meeting-sites.

De standaard internationale inbelnummers van de site worden ingesteld op het eerste beschikbare inbelnummer dat is gedefinieerd in het telefoniedomein op basis van het land van de organisatie. Als het land van de organisatie niet wordt gevonden in het inbelnummer dat is gedefinieerd in het telefoniedomein, wordt het standaardnummer van die locatie gebruikt.

Tabel 2. In de volgende tabel wordt de standaardlandcode voor inbellen weergegeven op basis van elke locatie:

S-nr.

Locatie

Landcode

Landnaam

1

AMER

+1

ONS, CA

2

APAC

+65

Singapore

3

ANUS, SCHEREN

+61

Australië

4

EMEA

+44

VK

5

EURO

+49

Duitsland

Regelingen voor meerdere partners

Gaat u Webex voor Cisco BroadWorks sublicentie geven aan een andere serviceprovider? In dit geval heeft elke serviceprovider een afzonderlijke partnerorganisatie nodig in Webex Control Hub om hen in staat te stellen de oplossing voor hun klantenbestand in te richten.

Inrichtingsadapter en sjablonen

Wanneer u flowthrough provisioning gebruikt, wordt de inrichtings-URL die u invoert in BroadWorks afgeleid van de sjabloon in Control Hub. U kunt meerdere sjablonen en dus meerdere inrichtings-URL's hebben. Hiermee kunt u per onderneming selecteren welk pakket u op abonnees wilt toepassen wanneer ze de geïntegreerde IM&P-service krijgen.

U moet overwegen of u een inrichtings-URL op systeemniveau wilt instellen als een standaardinrichtingspad en welke sjabloon u daarvoor wilt gebruiken. Op deze manier hoeft u alleen de inrichtings-URL expliciet in te stellen voor bedrijven die een andere sjabloon nodig hebben.

Houd er ook rekening mee dat u mogelijk al een inrichtings-URL op systeemniveau gebruikt, bijvoorbeeld met UC-One SaaS. Als dat het geval is, kunt u ervoor kiezen om de URL op systeemniveau te behouden voor het inrichten van gebruikers op UC-One SaaS en deze te overschrijven voor bedrijven die overstappen naar Webex voor Cisco BroadWorks. U kunt ook de andere kant op gaan en de URL op systeemniveau instellen voor Webex voor BroadWorks en de bedrijven die u wilt behouden op UC-One SaaS opnieuw configureren.

De configuratiekeuzes met betrekking tot deze beslissing worden beschreven in Toepassingsserver configureren met inrichtingsservice-URL.

Proxy inrichtingsadapter

Voor extra beveiliging kunt u met de Provisioning Adapter Proxy een HTTP(S)-proxy gebruiken op het Application Delivery Platform voor flowthrough-inrichting tussen de AS en Webex. De proxyverbinding maakt een end-to-end TCP-tunnel die verkeer tussen de AS en Webex doorgeeft, waardoor de AS geen directe verbinding met het openbare internet hoeft te maken. Voor veilige verbindingen kan TLS worden gebruikt.

Voor deze functie moet u de proxy instellen op BroadWorks. Zie voor meer informatie Beschrijving van de proxyfunctie van de Cisco BroadWorks-inrichtingsadapter.

Minimumvereisten

Accounts

Alle abonnees die u inricht voor Webex moeten bestaan in het BroadWorks-systeem dat u integreert met Webex. U kunt indien nodig meerdere BroadWorks-systemen integreren.

Alle abonnees moeten BroadWorks-licenties en een primair nummer of toestel hebben.

Webex gebruikt e-mailadressen als primaire id's voor alle gebruikers. Als u flowthrough-inrichting gebruikt met vertrouwde e-mails, moeten uw gebruikers geldige adressen hebben in het e-mailkenmerk in BroadWorks.

Als uw sjabloon BroadWorks-verificatie gebruikt, kunt u e-mailadressen van abonnees kopiëren naar het kenmerk Alternatieve id in BroadWorks. Hierdoor kunnen gebruikers zich aanmelden bij Webex met hun e-mailadressen en hun BroadWorks-wachtwoorden.

Uw beheerders moeten hun Webex-accounts gebruiken om zich aan te melden bij Partner Hub.


 
Het wordt niet ondersteund om een BroadWorks-beheerder te integreren in Webex voor Cisco BroadWorks. U kunt BroadWorks-bellende gebruikers met een primair nummer en/of toestel alleen onboarden. Als u flowthrough-inrichting gebruikt, moeten gebruikers ook de geïntegreerde IM&P-service krijgen toegewezen.

Servers in uw netwerk- en softwarevereisten

  • De BroadWorks-instantie(s) moet(en) ten minste de volgende servers bevatten:

    • Toepassingsserver (AS) met BroadWorks-versie zoals hierboven

    • Netwerkserver (NS)

    • Profielserver (PS)

  • Openbare XSP|ADP-server(s) of Application Delivery Platform (ADP) die aan de volgende vereisten voldoen:

    • Verificatieservice (BWAuth)

    • XSI-acties en -gebeurtenissen-interfaces

    • DMS (webapplicatie voor apparaatbeheer)

    • CTI-interface (intergratie van computertelefonie)

    • TLS 1.2 met een geldig certificaat (niet zelfondertekend) en vereiste tussenproducten. Vereist systeembeheerder om het opzoeken van bedrijven te vergemakkelijken.

    • Wederzijdse TLS-verificatie (mTLS) voor verificatieservice (vereist dat de openbare Webex-clientcertificaatketen als vertrouwensankers is geïnstalleerd)

    • Wederzijdse TLS-verificatie (mTLS) voor CTI-interface (vereist dat de openbare Webex-clientcertificaatketen als vertrouwensankers is geïnstalleerd)

  • Een afzonderlijke XSP/ADP-server die fungeert als een pushserver voor gespreksmeldingen (een NPS in uw omgeving die wordt gebruikt om gespreksmeldingen naar Apple/Google te pushen). We noemen het hier 'CNPS' om het te onderscheiden van de service in Webex die pushmeldingen voor berichten en aanwezigheid levert).

    Deze server moet op R22 of hoger zijn.

  • We mandaat een afzonderlijke XSP/ADP-server voor CNPS omdat de onvoorspelbaarheid van de belasting van Webex voor BWKS-cloudverbindingen een negatieve invloed kan hebben op de prestaties van de NPS-server, met als gevolg toenemende latentie van meldingen. Zie de Cisco BroadWorks System Engineering Guide voor meer informatie over de XSP|ADP-schaal.

Webex-app-platforms

Fysieke telefoons en accessoires

Apparaatintegratie

Zie de Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks voor meer informatie over het onboarden en gebruiken van OS- en MPP-apparaten in de serviceruimte voor Webex voor Cisco BroadWorks.

Apparaatprofielen

Hieronder staan de DTAF-bestanden die u op uw toepassingsservers moet laden om de Webex-app als een belclient te ondersteunen. Het zijn dezelfde DTAF-bestanden als gebruikt voor UC-One SaaS, maar er is een nieuwe config-wxt.xml.template bestand dat wordt gebruikt voor de Webex-app.

Als u de nieuwste apparaatprofielen wilt downloaden, gaat u naar de site van het Application Delivery Platform Software Downloads om de nieuwste DTAF-bestanden op te halen. Deze downloads werken voor zowel ADP als XSP.

Clientnaam

Type apparaatprofiel en pakketnaam

Webex Mobile-sjabloon

Type identiteit/apparaatprofiel: Verbinding maken - mobiel

DTAF: ucone-mobile-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Sjabloon voor Webex-tablet

Type identiteit/apparaatprofiel: Verbinding maken - tablet

DTAF: ucone-tablet-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Webex Desktop-sjabloon

Type identiteit/apparaatprofiel: Bedrijfscommunicator - PC

DTAF: ucone-desktop-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Identificeer/apparaatprofiel

Alle Webex voor Cisco BroadWorks-gebruikers moeten een Identity/Device Profile hebben toegewezen in BroadWorks dat een van de bovenstaande apparaatprofielen gebruikt om te bellen met de Webex-app. Het profiel biedt de configuratie waarmee de gebruiker gesprekken kan plaatsen.

OAuth-aanmeldgegevens voor uw Webex voor Cisco BroadWorks verkrijgen

Dien een serviceverzoek in bij uw onboardingagent of bij Cisco TAC om Cisco OAuth in te richten voor uw Cisco Identity Provider Federation-account.

Gebruik de volgende titel van het verzoek voor de respectieve functies:

  1. XSP|ADP AuthService Configuration' voor het configureren van de service op XSP|ADP.

  2. 'NPS-configuratie voor verificatie proxy instellen' om NPS te configureren voor het gebruik van de verificatieproxy.

  3. CI-gebruikers-UUID synchroniseren' voor CI-gebruikers-UUID synchroniseren. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.

  4. Configureer BroadWorks om Cisco-facturering voor BroadWorks en Webex Voor BroadWorks-abonnementen in te schakelen.

Cisco geeft u een OAuth-client-id, een clientgeheim en een vernieuwingstoken die 60 dagen geldig is. Als het token verloopt voordat u het gebruikt, kunt u een andere aanvraag indienen.


 

Als u al de referenties van de Cisco OAuth-identiteitsprovider hebt verkregen, voltooit u een nieuw serviceverzoek om uw referenties bij te werken.

Bestellingscertificaten

Certificaatvereisten voor TLS-verificatie

Voor alle vereiste toepassingen hebt u beveiligingscertificaten nodig, ondertekend door een bekende certificeringsinstantie en geïmplementeerd op uw openbare XSP|ADP's. Deze worden gebruikt om TLS-certificaatverificatie te ondersteunen voor alle inkomende verbindingen met uw XSP|ADP-servers.

Deze certificaten moeten uw XSP|ADP openbare volledig gekwalificeerde domeinnaam bevatten als algemene naam of alternatieve naam van het onderwerp.

De exacte vereisten voor het implementeren van deze servercertificaten zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt samengevat waar het door de CA ondertekende openbare servercertificaat in deze drie gevallen moet worden geladen:

De openbaar ondersteunde certificeringsinstanties die door de Webex-app worden ondersteund voor verificatie, worden weergegeven in Ondersteunde certificeringsinstanties voor hybride Webex-services.

Vereisten voor TLS-certificaat voor TLS-bridge Proxy

  • Het openbaar ondertekende servercertificaat wordt in de proxy geladen.

  • De proxy presenteert dit openbaar ondertekende servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • Een intern door een certificeringsinstantie ondertekend certificaat kan op de XSP|ADP worden geladen.

  • De XSP|ADP legt dit intern ondertekende servercertificaat voor aan de proxy.

  • De proxy vertrouwt de interne CA die het XSP|ADP-servercertificaat heeft ondertekend.

TLS-certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ

  • Het openbaar ondertekende servercertificaat wordt geladen in de XSP|ADP's.

  • De XSP|ADP's presenteren openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP|ADP's heeft ondertekend.

Aanvullende certificaatvereisten voor wederzijdse TLS-verificatie via de CTI-interface

Wanneer u verbinding maakt met de CTI-interface, presenteert Webex een clientcertificaat als onderdeel van wederzijdse TLS-verificatie. Het CA-/kettingcertificaat van het Webex-clientcertificaat kan worden gedownload via Control Hub.

Het certificaat downloaden:

Meld u aan bij Partner Hub en ga naar Instellingen > BroadWorks Calling en klik op de koppeling voor het downloaden van het certificaat.

De exacte vereisten voor het implementeren van deze Webex CA-certificaatketen zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

Het volgende diagram geeft een samenvatting van de certificaatvereisten in deze drie gevallen:

mTLS-certificaatuitwisseling voor CTI via verschillende Edge-configuraties

(Optie) Certificaatvereisten voor TLS-bridge Proxy

  • Webex presenteert een openbaar ondertekend clientcertificaat aan de proxy.

  • De proxy vertrouwt de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de vertrouwensopslag van de proxy. Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de proxy geladen.

  • De proxy presenteert het openbaar ondertekende servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • De volmachthebber legt een intern ondertekend clientcertificaat voor aan de XSP|ADP’s.

    Dit certificaat moet het uitbreidingsveld Extended Key Usage van x509.v3 bevatten met het BroadWorks-OID-doel 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS-clientAuth. Bijv.:

    X509v3 extensions:
        X509v3 Extended Key Usage:
            1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication

    De CN van het interne certificaat moet bwcticlient.webex.com.


     
    • Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

    • Openbare certificeringsinstanties zijn mogelijk niet bereid om certificaten te ondertekenen met het vereiste bedrijfseigen BroadWorks-OID. In het geval van een overbruggingsproxy moet u mogelijk een interne CA gebruiken om het clientcertificaat dat de proxy aanbiedt aan de XSP|ADP te ondertekenen.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP’s presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

  • De ClientIdentity van de toepassingsserver bevat de CN van het intern ondertekende clientcertificaat dat door de proxy wordt voorgelegd aan de XSP|ADP.

(Optie) Certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ

  • Webex presenteert een door een interne CA ondertekend Cisco-clientcertificaat aan de XSP|ADP's.

  • De XSP|ADP's vertrouwen de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de vertrouwensopslag van de proxy. Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de XSP|ADP's geladen.

  • De XSP|ADP's presenteren de openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP|ADP's heeft ondertekend.

  • De Application Server ClientIdentity bevat de algemene naam van het door Cisco ondertekende clientcertificaat dat door Webex wordt aangeboden aan de XSP|ADP.

Uw netwerk voorbereiden

Zie voor meer informatie over verbindingen die worden gebruikt door Webex voor Cisco BroadWorks: Netwerkvereisten voor Webex voor Cisco BroadWorks. Dit artikel bevat de lijst met IP-adressen, poorten en protocollen die vereist zijn om de ingress- en egress-regels van uw firewall te configureren.

Netwerkvereisten voor Webex-services

De voorgaande firewalltabellen met ingress- en exress-regels documenteren alleen de verbindingen die specifiek zijn voor Webex voor Cisco BroadWorks. Zie Netwerkvereisten voor Webex-services voor algemene informatie over verbindingen tussen de Webex-app en de Webex-cloud. Dit artikel is algemeen voor Webex, maar in de volgende tabel worden de verschillende gedeelten van het artikel aangegeven en wordt aangegeven hoe relevant elk gedeelte is voor Webex voor Cisco BroadWorks.

Tabel 3. Netwerkvereisten voor verbindingen met de Webex-app (algemeen)

Deel van artikel over netwerkvereisten

Relevantie van informatie

Overzicht van door Webex ondersteunde apparaattypen en protocollen

Informatief

Transportprotocollen en versleutelingscodes voor cloudgeregistreerde Webex-apps en -apparaten

Informatief

Webex-services - Poortnummers en protocollen

Moet gelezen worden

IP-subnetten voor Webex-mediaservices

Moet gelezen worden

Domeinen en URL's die toegankelijk moeten zijn voor Webex-services

Moet gelezen worden

Aanvullende URL's voor hybride Webex-services

Optioneel

Proxyfuncties

Optioneel

802.1X: netwerktoegangsbeheer op basis van poorten

Optioneel

Netwerkvereisten voor SIP-gebaseerde Webex-services

Optioneel

Netwerkvereisten voor Webex Edge Audio

Optioneel

Een overzicht van andere hybride Webex-services en documentatie

Optioneel

Webex-services voor FedRAMP-klanten

N.v.t.

Aanvullende informatie

Zie Firewall-whitepaper van de Webex-app (PDF) voor meer informatie.

Ondersteuning voor redundantie van BroadWorks

De Webex-cloudservices en de Webex-clientapps die toegang moeten krijgen tot het netwerk van de partner ondersteunen volledig de Broadworks XSP|ADP-redundantie die door de partner wordt geboden. Wanneer een XSP|ADP of site niet beschikbaar is voor gepland onderhoud of ongeplande reden, kunnen de Webex-services en -apps doorschakelen naar een andere XSP|ADP of site die door de partner wordt geleverd om een verzoek te voltooien.

Netwerktopologie

De Broadworks XSP|ADP's kunnen rechtstreeks op het internet worden geïmplementeerd of kunnen zich in een DMZ bevinden met een load balancing-element zoals de F5 BIG-IP. Om geo-redundantie te bieden, kunnen de XSP|ADP's worden geïmplementeerd in twee (of meer) datacenters, elk met een load balancer, elk met een openbaar IP-adres. Als de XSP|ADP's zich achter een load balancer bevinden, zien de Webex-microservices en -app alleen het IP-adres van de load balancer en lijkt Broadworks slechts één XSP|ADP te hebben, zelfs als er meerdere XSP|ADP's achter zitten.

In het onderstaande voorbeeld worden de XSP|ADP's geïmplementeerd op twee sites, Site A en Site B. Op elke site zijn er twee XSP|ADP's, voorafgegaan door een lastbalancer. Site A heeft XSP|ADP1 en XSP|ADP2 voor LB1, en Site B heeft XSP|ADP3 en XSP|ADP4 voor LB2. Alleen de lastbalancers worden op het openbare netwerk weergegeven en de XSP|ADP's bevinden zich in de privénetwerken van DMZ.

Webex-cloudservices

DNS-configuratie

De microservices van Webex Cloud moeten de Broadworks XSP|ADP-server(s) kunnen vinden om verbinding te maken met de Xsi-interfaces, de verificatieservice en CTI.

Webex Cloud-microservices voeren DNS A/AAAA-zoekopdrachten uit voor de geconfigureerde XSP|ADP-hostnaam en maken verbinding met het geretourneerde IP-adres. Dit kan een load balancing edge-element zijn, of de XSP|ADP-server zelf. Als er meerdere IP-adressen worden geretourneerd, wordt het eerste IP in de lijst geselecteerd. SRV-zoekopdrachten worden momenteel niet ondersteund.

Voorbeeld: De DNS van de partner A Record voor ontdekking van Round-Robin gebalanceerde internet-gerichte XSP|ADP-server/load balancers.

Recordtype

Naam

Doel

Doel

A

webex-cloud-xsp.example.com

198.51.100.48

Verwijst naar LB1 (Site A)

A

webex-cloud-xsp.example.com

198.51.100.49

Verwijst naar LB2 (Site B)


 

Elke verwijzing naar XSP omvat XSP of ADP.

Failover

Wanneer de Webex-microservices een verzoek naar de XSP|ADP/Load Balancer verzenden en het verzoek mislukt, kunnen er verschillende dingen gebeuren:

  • Als de fout te wijten is aan een netwerkfout (bv.: TCP, SSL) markeren de Webex-microservices het IP als geblokkeerd en voeren ze onmiddellijk een route door naar het volgende IP.

  • Als er een foutcode (HTTP 5xx) wordt geretourneerd, markeren de Webex-microservices het IP als geblokkeerd en voeren ze onmiddellijk een route door naar het volgende IP.

  • Als er binnen 2 seconden geen HTTP-reactie wordt ontvangen, time-out van het verzoek en de Webex-microservices markeren het IP als geblokkeerd en voeren een route door naar het volgende IP.

Elk verzoek wordt 3 keer geprobeerd voordat een storing wordt teruggekoppeld naar de microservice.

Wanneer een IP in de geblokkeerde lijst staat, wordt het niet opgenomen in de lijst met adressen die moet worden geprobeerd bij het verzenden van een aanvraag naar een XSP|ADP. Na een vooraf bepaalde tijdsperiode verloopt een geblokkeerd IP en gaat het terug naar de lijst om te proberen wanneer een ander verzoek wordt gedaan.

Als alle IP-adressen zijn geblokkeerd, probeert de microservice de aanvraag nog steeds te verzenden door willekeurig een IP-adres te selecteren in de geblokkeerde lijst. Als dit is gelukt, wordt dat IP-adres verwijderd uit de geblokkeerde lijst.

Status

De status van de verbinding van de Webex-cloudservices met de XSP|ADP's of load balancers is te zien in Control Hub. Onder een BroadWorks-gesprekscluster wordt een verbindingsstatus weergegeven voor elk van deze interfaces:

  • XSI-acties

  • XSI-gebeurtenissen

  • Verificatieservice

De verbindingsstatus wordt bijgewerkt wanneer de pagina wordt geladen of tijdens invoerupdates. De verbindingsstatussen kunnen zijn:

  • Groen: Wanneer de interface kan worden bereikt op een van de IP's in Een recordzoekopdracht.

  • Rood: Wanneer alle IP's in de A-recordzoekopdracht niet bereikbaar zijn en de interface niet beschikbaar is.

De volgende services gebruiken de microservices om verbinding te maken met de XSP|ADP's en worden beïnvloed door de beschikbaarheid van de XSP|ADP-interface:

  • Aanmelden bij Webex-app

  • Token voor Webex-app vernieuwen

  • Niet-vertrouwde e-mail/zelfactivering

  • Gezondheidscontrole van Broadworks-service

Webex-app

DNS-configuratie

De Webex-app heeft toegang tot de services Xtended Services Interface (XSI-acties en XSI-gebeurtenissen) en Device Management Service (DMS) op de XSP|ADP.

Om de XSI-service te vinden, voert de Webex-app DNS SRV-zoekopdrachten uit voor _xsi-client._tcp.<webex app xsi domain>. De SRV verwijst naar de geconfigureerde URL voor de XSP|ADP-hosts of load balancers voor de XSI-service. Als SRV-zoekopdrachten niet beschikbaar zijn, keert de Webex-app terug naar A/AAAA-zoekopdrachten.

De SRV kan overschakelen op meerdere A/AAAA-doelen. Elke A/AAAA-record moet echter alleen naar één IP-adres worden toegewezen. Als er meerdere XSP|ADP's in een DMZ achter het load balancer/edge-apparaat zijn, moet de load balancer worden geconfigureerd om de sessiepersistentie te behouden en alle verzoeken van dezelfde sessie naar dezelfde XSP|ADP te routeren. We machtigen deze configuratie omdat de XSI-event heartbeats van de client naar dezelfde XSP|ADP moeten gaan die wordt gebruikt om het gebeurteniskanaal op te zetten.


 

In voorbeeld 1 bestaat de A/AAAA-record voor webex-app-XSP|ADP.example.com niet en hoeft deze niet te worden gebruikt. Als uw DNS vereist dat één A/AAAA-record moet worden gedefinieerd, mag slechts 1 IP-adres worden geretourneerd. De SRV moet echter nog steeds worden gedefinieerd voor de Webex-app.

Als de Webex-app de A/AAAA-naam gebruikt die wordt omgezet naar meer dan één IP-adres, of als het load balancer/edge-element geen sessiepersistentie handhaaft, verzendt de client uiteindelijk heartbeats naar een XSP|ADP waar het geen gebeurteniskanaal tot stand heeft gebracht. Dit resulteert in het afbreken van het kanaal en ook in aanzienlijk meer intern verkeer, wat de prestaties van uw XSP|ADP-cluster belemmert.

Omdat de Webex-cloud en de Webex-app verschillende vereisten hebben voor het opzoeken van A/AAAA-opnamen, moet u een afzonderlijke FQDN gebruiken voor toegang tot uw XSP|ADP's voor de Webex-cloud en de Webex-app. Zoals in de voorbeelden wordt weergegeven, gebruikt Webex Cloud Een record webex-cloud-xsp.example.com en de Webex-app gebruikt SRV _xsi-client._tcp.webex-app-xsp.example.com.

Voorbeeld 1: meerdere XSP|ADP's, elk achter afzonderlijke lastbalancers

In dit voorbeeld wijst de SRV naar A-records met elk Een record die naar een andere lastbalancer op een andere locatie wijzen. De Webex-app gebruikt altijd het eerste IP-adres in de lijst en gaat alleen naar de volgende record als de eerste is uitgeschakeld.

Hieronder vindt u een voorbeeld van SRV-records.

Recordtype

Opnemen

Doel

Doel

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc1.example.com

Clientdetectie van Xsi-interface

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc2.example.com

Clientdetectie van Xsi-interface

A

xsp-dc1.example.com

198.51.100.48

Verwijst naar LB1 (site A)

A

xsp-dc2.example.com

198.51.100.49

Punten naar LB2 (site B)

Voorbeeld 2: meerdere XSP|ADP's achter één lastbalancer (met TLS-brug)

Voor het eerste verzoek selecteert de load balancer een willekeurige XSP|ADP. XSP|ADP retourneert een cookie dat de Webex-app in toekomstige verzoeken bevat. Voor toekomstige verzoeken gebruikt de load balancer de cookie om de verbinding naar de juiste XSP|ADP te routeren, zodat het gebeurteniskanaal niet wordt verbroken.

Recordtype

Opnemen

Doel

Doel

SRV

_xsi-client._tcp.webex-app-xsp.example.com

LB.example.com

Lastbalancer

A

LB.voorbeeld.com

198.51.100.83

IP-adres van load balancer (XSP|ADP's bevinden zich achter load balancer)

URL DMS

Tijdens het aanmeldproces haalt de Webex-app ook de DMS-URL op om het configuratiebestand te downloaden. De host in de URL wordt geparseerd en de Webex-app voert DNS A/AAAA-zoekopdrachten uit van de host om verbinding te maken met de XSP|ADP die de DMS-service host.

Voorbeeld: DNS Een record voor het ontdekken van Round-Robin gebalanceerde internet-gerichte XSP|ADP-server/load balancers door de Webex-app om configuratiebestanden te downloaden via DMS:

Recordtype

Naam

Doel

Doel

A

xsp-dms.example.com

198.51.100.48

Verwijst naar LB1 (site A)

A

xsp-dms.example.com

198.51.100.49

Punten naar LB2 (site B)


 
Elke verwijzing naar XSP omvat XSP of ADP.
Hoe de Webex-app XSP|ADP-adressen vindt

De client probeert de XSP|ADP-knooppunten te vinden met behulp van de volgende DNS-flow:

  1. De client haalt aanvankelijk URL's voor Xsi-acties/Xsi-Events op uit de Webex-cloud (u hebt deze ingevoerd bij het maken van het gekoppelde BroadWorks-gesprekscluster). De Xsi-hostnaam/het Xsi-domein wordt geparseerd vanaf de URL en de client voert de SRV-zoekopdracht als volgt uit:

    1. De client voert een SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">

    2. Als de SRV-zoekopdracht een of meer A/AAAA-doelen retourneert:

      1. De client zoekt A/AAAA op voor deze doelen en slaat de geretourneerde IP-adressen in de cache.

      2. De client maakt verbinding met een van de doelen (en dus de A/AAAA-record met één IP-adres) op basis van de SRV-prioriteit, vervolgens het gewicht (of willekeurig als ze allemaal gelijk zijn).

    3. Als de SRV-zoekopdracht geen doelen retourneert:

      De client zoekt A/AAAA op van de Xsi-hoofdparameter en probeert vervolgens verbinding te maken met het geretourneerde IP-adres. Dit kan een load balancing edge-element zijn, of de XSP|ADP-server zelf.

      Zoals vermeld, moet de A/AAAA-record om dezelfde redenen worden omgezet naar één IP-adres.

  2. (Optioneel) U kunt vervolgens aangepaste XSI-acties/XSI-gebeurtenissen opgeven in de apparaatconfiguratie voor de Webex-app, met behulp van de volgende tags:

    <protocols>
    	<xsi>
    		<paths>
    			<root>%XSI_ROOT_WXT%</root>
    			<actions>%XSI_ACTIONS_PATH_WXT%</actions>
    			<events>%XSI_EVENTS_PATH_WXT%</events>
    		</paths>
    	</xsi>
    </protocols>
    1. Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.

    2. Als deze bestaan, vergelijkt de client met het oorspronkelijke XSI-adres dat hij heeft ontvangen via de BroadWorks-clusterconfiguratie.

    3. Als er een verschil wordt gedetecteerd, initialiseert de client de XSI-acties/ XSI Events-verbinding opnieuw. De eerste stap hierin is om hetzelfde DNS-opzoekproces uit te voeren dat wordt vermeld onder stap 1. Dit keer wordt een zoekopdracht aangevraagd voor de waarde in de parameter %XSI_ROOT_WXT% vanuit het configuratiebestand.


       
      Zorg ervoor dat u de bijbehorende SRV-records maakt als u deze tag gebruikt om de Xsi-interfaces te wijzigen.
Failover

Tijdens het aanmelden voert de Webex-app een DNS SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">, stelt een lijst met hosts op en maakt verbinding met een van de hosts op basis van de SRV-prioriteit en vervolgens het gewicht. Deze verbonden host wordt de geselecteerde host voor alle toekomstige aanvragen. Er wordt vervolgens een gebeurteniskanaal geopend voor de geselecteerde host en er wordt regelmatig een hartslag verzonden om het kanaal te verifiëren. Alle aanvragen die na de eerste worden verzonden, bevatten een cookie dat wordt geretourneerd in de HTTP-respons. Daarom is het belangrijk dat de load balancer de sessiepersistentie (affiniteit) behoudt en altijd aanvragen naar dezelfde backend XSP|ADP-server verzendt.

Als een verzoek of een heartbeat-verzoek aan een host mislukt, kunnen er verschillende dingen gebeuren:

  • Als de fout het gevolg is van een netwerkfout (bijv. TCP, SSL) gaat de route van de Webex-app onmiddellijk door naar de volgende host in de lijst.

  • Als er een foutcode (HTTP 5xx) wordt geretourneerd, markeert de Webex-app dat IP-adres als geblokkeerd en leidt deze door naar de volgende host in de lijst.

  • Als er niet binnen een bepaalde periode een reactie wordt ontvangen, wordt het verzoek als mislukt beschouwd vanwege een time-out en worden de volgende verzoeken naar de volgende host verzonden. Het time-outverzoek wordt echter als mislukt beschouwd. Sommige verzoeken worden opnieuw geprobeerd na een fout (met toenemende tijd voor opnieuw proberen). De verzoeken om het veronderstelde niet-vitale niet opnieuw te proberen.

Wanneer een nieuwe host is geprobeerd, wordt deze de nieuwe geselecteerde host als de host aanwezig is in de lijst. Nadat de laatste host in de lijst is geprobeerd, rolt de Webex-app over naar de eerste.

In het geval van heartbeat, als er twee opeenvolgende mislukte verzoeken zijn, initialiseert de Webex-app het gebeurteniskanaal opnieuw.

Houd er rekening mee dat de Webex-app geen fail-back uitvoert en dat DNS-servicedetectie slechts één keer wordt uitgevoerd bij het aanmelden.

Tijdens het aanmelden probeert de Webex-app het configuratiebestand te downloaden via de XSP|ADP/Dms-interface. Het voert een A/AAAA-recordzoekopdracht uit van de host in de opgehaalde DMS-URL en maakt verbinding met het eerste IP. Eerst wordt geprobeerd het verzoek om het configuratiebestand te downloaden te verzenden met een SSO-token. Als dit om welke reden dan ook mislukt, wordt het opnieuw geprobeerd, maar wel met de gebruikersnaam en het wachtwoord van het apparaat.

Webex voor BroadWorks implementeren

Implementatieoverzicht

De volgende diagrammen geven de typische volgorde van uw implementatietaken weer voor de verschillende gebruikersinrichtingsmodi. Veel van de taken zijn gemeenschappelijk voor alle inrichtingsmodi.

Shows the order of tasks required for deploying Webex for BroadWorks with flow-through provisioning and trusted emails
Taken vereist voor het implementeren van doorstroominrichting
Shows the order of tasks required for deploying Webex for BroadWorks with flow-through provisioning without emails
Taken vereist voor het implementeren van flowthrough-inrichting zonder vertrouwde e-mails
Shows the order of tasks required for deploying Webex for BroadWorks with self-activation
Taken vereist voor het implementeren van zelfinrichting van gebruikers

Onboarding van partners voor Webex voor Cisco BroadWorks

Elke Webex voor Cisco BroadWorks-serviceprovider of -reseller moet worden ingesteld als een partnerorganisatie voor Webex voor Cisco BroadWorks. Als u een bestaande Webex-partnerorganisatie hebt, kan dit worden gebruikt.

Om de noodzakelijke onboarding te voltooien, moet u uw Webex Cisco BroadWorks-papierwerk uitvoeren en moeten nieuwe partners de online overeenkomst voor indirecte kanaalpartners (ICPA) accepteren. Wanneer deze stappen zijn voltooid, maakt Cisco Compliance een nieuwe partnerorganisatie in Partner Hub (indien nodig) en verzendt een e-mail met verificatiegegevens naar de beheerder van uw administratie. Tegelijkertijd zal uw Partner Activation en/of Customer Success Program Manager contact met u opnemen om uw onboarding te starten.

Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's

We vereisen dat de NPS-toepassing op een andere XSP|ADP wordt uitgevoerd. Vereisten voor die XSP|ADP worden beschreven in Gespreksmeldingen configureren vanuit uw netwerk.

U hebt de volgende toepassingen/services nodig op uw XSP|ADP's.

Service/toepassing

Verificatie vereist

Doel van de dienst/toepassing

Xsi-gebeurtenissen

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, servicemeldingen

Xsi-acties

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, acties

Apparaatbeheer

TLS (server verifieert zichzelf bij clients)

Configuratie voor bellen downloaden

Verificatieservice

TLS (server verifieert zichzelf bij clients)

Gebruikersverificatie

Integratie van computertelefonie

mTLS (client en server verifiëren elkaar)

Telefonieaanwezigheid

Webview-toepassing voor gespreksinstellingen

TLS (server verifieert zichzelf bij clients)

Stelt gespreksinstellingen van gebruikers bloot in de selfcare-portal in de Webex-app

In dit gedeelte wordt beschreven hoe u de vereiste configuraties voor TLS en mTLS op deze interfaces kunt toepassen, maar u moet de bestaande documentatie raadplegen om de toepassingen op uw XSP|ADP's te laten installeren.

Vereisten co-residentie

  • De verificatieservice moet co-resident zijn met Xsi-toepassingen, omdat deze interfaces langdurige tokens voor serviceautorisatie moeten accepteren. De verificatieservice is vereist om deze tokens te valideren.

  • De verificatieservice en Xsi kunnen indien nodig op dezelfde poort worden uitgevoerd.

  • U kunt de andere services/toepassingen scheiden zoals vereist voor uw weegschaal (bijvoorbeeld dedicated device management XSP|ADP farm).

  • U kunt de Xsi-, CTI-, Authenticatieservice- en DMS-toepassingen co-lokaliseren.

  • Installeer geen andere toepassingen of services op de XSP|ADP's die worden gebruikt voor de integratie van BroadWorks met Webex.

  • Zoek de NPS-toepassing niet samen met andere toepassingen.

Xsi-interfaces

Installeer en configureer de Xsi-Actions- en Xsi-Events-toepassingen zoals beschreven in de Configuratiehandleiding voor Cisco BroadWorks Xtended Services Interface.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Voor alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moet dezelfde callControlApplicationName zijn gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker is geïntegreerd in Webex, maakt Webex een abonnement voor de gebruiker op de AS om telefoniegebeurtenissen te ontvangen voor aanwezigheid en gespreksgeschiedenis. Het abonnement is gekoppeld aan de callControlApplicationName en de AS gebruikt het om te weten naar welke Xsi-Events de telefonie-gebeurtenissen moeten worden verzonden.


 

Het wijzigen van de callControlApplicationName of het niet hebben van dezelfde naam op alle Xsi-Events-webapps zal invloed hebben op abonnementen en telefonie gebeurtenissen functionaliteit.

Verificatieservice configureren (met CI-tokenvalidatie)

Gebruik deze procedure om de verificatieservice te configureren voor het gebruik van CI-tokenvalidatie met TLS. Deze verificatiemethode wordt aanbevolen als u R22 of hoger gebruikt en uw systeem deze ondersteunt.


 

Wederzijdse TLS (mTLS) wordt ook ondersteund als een alternatieve verificatiemethode voor de verificatieservice. Als u meerdere Webex-organisaties op dezelfde XSP|ADP-server hebt uitgevoerd, moet u mTLS-verificatie gebruiken omdat CI-tokenvalidatie niet meerdere verbindingen met dezelfde XSP|ADP-verificatieservice ondersteunt.

Als u mTLS-verificatie wilt configureren voor de verificatieservice in plaats van CI-tokenvalidatie, raadpleegt u de bijlage voor Services configureren (met mTLS voor de verificatieservice).


 
Als u momenteel mTLS gebruikt voor de verificatieservice, is het niet verplicht om opnieuw te configureren voor het gebruik van CI-tokenvalidatie met TLS.
  1. Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.

  2. Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw versie:


     
    Elke verwijzing naar XSP omvat XSP of ADP.
  3. Installeer de AuthenticationService toepassing op elke XSP|ADP-service.

    1. Voer de volgende opdracht uit om de AuthenticationService-toepassing op de XSP|ADP te activeren op het contextpad /authService.

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
    2. Voer deze opdracht uit om de AuthenticationService te implementeren op de XSP|ADP:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
  4. Vanaf Broadworks build 2022.10 worden de certificerende autoriteiten die met Java komen niet meer automatisch opgenomen in de BroadWorks-vertrouwensopslag wanneer wordt overgeschakeld naar een nieuwe versie van java. De AuthenticationService opent een TLS-verbinding met Webex om het toegangstoken op te halen en moet het volgende in de truststore hebben om de IDBroker- en Webex-URL te valideren:

    • IdenTrust commercieel hoofd-CA 1

    • GoDaddy Root Certification Authority - G2

    Controleer of deze certificaten aanwezig zijn onder de volgende CLI

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

    Als dit niet aanwezig is, voert u de volgende opdracht uit om de standaard Java-trusts te importeren:

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

    U kunt deze certificaten ook handmatig toevoegen als vertrouwensankers met de volgende opdracht:

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

    Als de ADP is geüpgraded vanaf een vorige release, worden de certificeringsinstanties van de oude release automatisch geïmporteerd naar de nieuwe release en blijven ze geïmporteerd totdat ze handmatig worden verwijderd.


     

    De toepassing AuthenticationService is vrijgesteld van de instelling validatePeerIdentity onder ADP_CLI/System/SSLCommonSettings/GeneralSettings en valideert altijd de peer Identity. Zie de Cisco Broadworks X509 Certificate Validation FD voor meer informatie over deze instelling.

  5. Configureer de identiteitsproviders door de volgende opdrachten uit te voeren op elke XSP|ADP-server:

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

    • set clientId client-Id-From-Step1

    • set enabled true

    • set clientSecret client-Secret-From-Step1

    • set ciResponseBodyMaxSizeInBytes 65536

    • set issuerName <URL> —Voor de URL voer de URL van de IssuerName in die van toepassing is op uw CI-cluster. Zie volgende tabel.

    • set issuerUrl <URL> —Voor de URL voer de IssuerUrl in die van toepassing is op uw CI-cluster. Zie de volgende tabel.

    • set tokenInfoUrl <IdPProxy URL> —Voer de IdP-proxy-URL in die van toepassing is op uw Teams-cluster. Zie de tweede tabel die volgt.

    Tabel 1. Naam en URL van uitgever instellen
    Als CI-cluster is...Naam en URL van uitgever instellen op...

    US-A

    https://idbroker.webex.com/idb

    EU

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

    US-B

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


     
    Als u uw CI-cluster niet kent, kunt u de informatie verkrijgen via de klantgegevens in de helpdeskweergave van Control Hub.
    Tabel 2. TokenInfoURL instellen
    Als het Teams-cluster...TokenInfoURL instellen op... (IdP proxy-URL)

    ACHM, WATERPIJP

    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

    AASAPPEL

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


     
    • Als u uw Teams-cluster niet kent, kunt u de informatie verkrijgen via de klantgegevens in de helpdeskweergave van Control Hub.

    • Voor tests kunt u controleren of de tokenInfoURL geldig is door de " idp/authenticate" gedeelte van de URL met " ping".

  6. Geef de Webex-rechten op die aanwezig moeten zijn in het gebruikersprofiel in Webex door de volgende opdracht uit te voeren:

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

  7. Configureer identiteitsproviders voor Cisco Federation met de volgende opdrachten op elke XSP|ADP-server:

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

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

    • set refreshPeriodInMinutes 60

    • set refreshToken refresh-Token-From-Step1

  8. Voer de volgende opdracht uit om te valideren dat uw FLS-configuratie werkt. Met deze opdracht keert u de lijst met identiteitsproviders terug:

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

  9. Configureer Tokenbeheer met de volgende opdrachten op elke XSP|ADP-server:

    • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

    • set tokenIssuer BroadWorks

    • set tokenDurationInHours 720

  10. RSA-sleutels genereren en delen. U moet sleutels genereren op één XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's. Dit is te wijten aan de volgende factoren:

    • U moet dezelfde openbare/privésleutelparen gebruiken voor tokencodering/decodering in alle instanties van de verificatieservice.

    • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet uitgeven.


     
    Als u met de toetsen gaat fietsen of de lengte van de toetsen wijzigt, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw starten.
    1. Selecteer één XSP|ADP om een sleutelpaar te genereren.

    2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen in de browser van de client:

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

      (Dit genereert een privaat/openbaar sleutelpaar op de XSP|ADP, als dat er nog niet was)

    3. De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:

      XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere .keys bestand indien nodig.

    5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

  11. Geef de authService-URL op aan de webcontainer. De webcontainer van de XSP|ADP heeft de authService-URL nodig zodat deze tokens kan valideren. Op elk van de XSP|ADP's:

    1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het communicatiehulpprogramma BroadWorks:

      XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

    2. Voeg de URL van de verificatieservice toe aan de container:

      XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

      Hiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.

    3. Controleer de parameter met get.

    4. Start de XSP|ADP opnieuw op.

Clientverificatievereiste voor verificatieservice verwijderen (alleen R24)

Als u de verificatieservice met CI-tokenvalidatie op R24 hebt geconfigureerd, moet u ook de clientverificatievereiste voor de verificatieservice verwijderen. Voer de volgende CLI-opdracht uit:

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

TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)

De toepassingen Verificatieservice, Xsi-acties en Xsi-Events maken gebruik van HTTP-serverinterfaces. De TLS-configureerbaarheidsniveaus voor deze toepassingen zijn als volgt:

Meest algemeen = Systeem > Transport > HTTP > HTTP Server interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit CLI-context
Systeem (globaal)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze veilig zijn en of ze clientverificatie vereisen.

Apache tomcat vereist een certificaat voor elke veilige interface; het systeem genereert een zelfondertekend certificaat als dit nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2-protocol toevoegen aan de HTTP-serverinterface

De HTTP-interface die communiceert met de Webex-cloud moet zijn geconfigureerd voor TLSv1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren in de interface van de HTTP-server:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken in de HTTP-serverinterface

De vereiste cijfers configureren:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de interface van de HTTP-server.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 in de interface van de HTTP-server gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver

Profielserver en XSP|ADP zijn verplicht voor apparaatbeheer. Ze moeten worden geconfigureerd volgens de instructies in de configuratiehandleiding voor BroadWorks-apparaatbeheer.

CTI-interface en gerelateerde configuratie

De configuratievolgorde 'maximaal' wordt hieronder weergegeven. Het volgen van deze bestelling is niet verplicht.

  1. Toepassingsserver configureren voor CTI-abonnementen

  2. XSP|ADP's configureren voor mTLS geverifieerde CTI-abonnementen

  3. Inkomende poorten openen voor veilige CTI-interface

  4. Abonneer uw Webex-organisatie op BroadWorks CTI-gebeurtenissen

Toepassingsserver configureren voor CTI-abonnementen

Werk de ClientIdentity op de toepassingsserver bij met de algemene naam (CN) van het Webex voor Cisco BroadWorks CTI-clientcertificaat.

Voeg voor elke toepassingsserver die u met Webex gebruikt de certificaatidentiteit als volgt toe aan de ClientIdentity:

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


 

De algemene naam van het Webex voor Cisco BroadWorks-clientcertificaat is bwcticlient.webex.com.

TLS en cijfers configureren op de CTI-interface

De configureerbaarheidsniveaus voor de XSP|ADP CTI-interface zijn als volgt:

Meest algemeen = Systeem > Transport > CTI Interfaces > CTI interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit

CLI-context

Systeem (globaal)

(R22 en hoger)

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

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

Transportprotocollen voor dit systeem

(R22 en hoger)

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

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

Alle CTI-interfaces op dit systeem

(R22 en hoger)

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

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

Een specifieke CTI-interface op dit systeem

(R22 en hoger)

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

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


 

Bij een nieuwe installatie worden de volgende versleutelingen standaard op systeemniveau geïnstalleerd. Als er niets is geconfigureerd op het interfaceniveau (bijvoorbeeld op de CTI-interface of HTTP-interface), is deze coderingslijst van toepassing. Houd er rekening mee dat deze lijst in de loop der tijd kan veranderen:

  • TLS_ECDHE_RSA_MET_AES_128_GCM_SHA256

  • TLS_ECDHE_ECDSA_MET_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_MET_AES_128_CBC_SHA256

  • TLS_ECDHE_ECDSA_MET_AES_128_CBC_SHA256

  • TLS_DHE_DSS_MET_AES_128_GCM_SHA256

  • TLS_DHE_RSA_MET_AES_128_GCM_SHA256

  • TLS_DHE_RSA_MET_AES_128_CBC_SHA256

  • TLS_DHE_DSS_MET_AES_128_CBC_SHA256

  • TLS_ECDH_RSA_MET_AES_128_GCM_SHA256

  • TLS_ECDH_ECDSA_MET_AES_128_GCM_SHA256

  • TLS_ECDH_RSA_MET_AES_128_CBC_SHA256

  • TLS_ECDH_ECDSA_MET_AES_128_CBC_SHA256

CTI TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze een servercertificaat vereisen en of ze clientverificatie vereisen.

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

TLS 1.2-protocol toevoegen aan de CTI-interface

De XSP|ADP CTI-interface die communiceert met de Webex-cloud moet worden geconfigureerd voor TLS v1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren op de CTI-interface:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken op de CTI-interface

De vereiste cijfers configureren voor de CTI-interface:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Voer de get opdracht om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> <cipherName> om een code toe te voegen aan de CTI-interface.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 naar de CTI-interface gebruikt u: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Vertrouwensankers voor CTI-interface (R22 en hoger)

Bij deze procedure wordt ervan uitgegaan dat de XSP|ADP's ofwel naar het internet gericht zijn ofwel naar het internet gericht zijn via pass-through proxy. De certificaatconfiguratie is anders voor een brugproxy (zie TLS-certificaatvereisten voor TLS-brugproxy).

Ga als volgt te werk voor elke XSP|ADP in uw infrastructuur die CTI-gebeurtenissen publiceert in Webex:

  1. Aanmelden bij Partnerhub .

  2. Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om CombinedCertChain2023.txt op uw lokale computer.


     

    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze uploadt naar de XSP|ADP's. Alle bestanden zijn vereist.

  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE----- en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één tekstblok bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt

  5. Meld u aan bij de XSP|ADP en ga naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Optioneel) Uitvoeren help updateTrust om de parameters en opdrachtindeling weer te geven.

  7. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 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


     

    Alle aliassen moeten een andere naam hebben. webexclientroot2023 en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang alle ingangen uniek zijn.

  8. Bevestig dat de ankers zijn bijgewerkt:

    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. Clients toestaan te verifiëren met certificaten:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

CTI-interface toevoegen en mTLS inschakelen

  1. Voeg de CTI SSL-interface toe.

    De CLI-context is afhankelijk van uw BroadWorks-versie. De opdracht maakt een zelfondertekend servercertificaat in de interface en dwingt de interface om een clientcertificaat te vereisen.

    • Op BroadWorks R22 en R23:

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

  2. Vervang het servercertificaat en de sleutel op de CTI-interfaces van XSP|ADP. U hebt hiervoor het IP-adres van de CTI-interface nodig; u kunt dit lezen uit de volgende context:

    • Op BroadWorks R22 en R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Voer vervolgens de volgende opdrachten uit om het zelfondertekende certificaat van de interface te vervangen door uw eigen certificaat en privésleutel:

      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. Start de XSP|ADP opnieuw op.

Toegang tot BroadWorks CTI-gebeurtenissen inschakelen in Webex

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters configureert in Partner Hub. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters configureert in Partner Hub. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

  • Geef het CTI-adres op waarmee Webex zich kan abonneren op BroadWorks CTI Events.

  • CTI-abonnementen zijn per abonnee en worden alleen ingesteld en onderhouden terwijl die abonnee is ingericht voor Webex voor Cisco BroadWorks.

Webweergave Gespreksinstellingen

Call Settings Webview (CSWV) is een toepassing die wordt gehost op XSP|ADP zodat gebruikers hun BroadWorks-gespreksinstellingen kunnen wijzigen via een webview die ze in de softclient zien. Zie de Handleiding voor webview-oplossingen voor Cisco BroadWorks-gespreksinstellingen.

Webex maakt gebruik van deze functie om gebruikers toegang te geven tot algemene BroadWorks-gespreksinstellingen die niet eigen zijn aan de Webex-app.

Als u wilt dat uw Webex voor Cisco BroadWorks-abonnees toegang hebben tot gespreksinstellingen die verder gaan dan de standaardinstellingen die beschikbaar zijn in de Webex-app, moet u de functie Webview voor gespreksinstellingen implementeren.

De webview Gespreksinstellingen heeft twee onderdelen:

  • Webview-toepassing voor gespreksinstellingen, gehost op een Cisco BroadWorks XSP|ADP.

  • De Webex-app, die de gespreksinstellingen in een Webview weergeeft.

Gebruikerservaring

  • Windows-gebruikers: Klik op Gespreksinstellingen en klik vervolgens op Gespreksvoorkeuren openen > Geavanceerde gespreksinstellingen.

  • Mac-gebruikers: Klik op profielfoto en vervolgens op Voorkeuren > Geavanceerde gespreksinstellingen.

CSWV implementeren op BroadWorks

Webview Gespreksinstellingen installeren op XSP|ADP's

CSWV-toepassing moet zich op dezelfde XSP|ADP('s) bevinden als de host van de Xsi-Actions-interface in uw omgeving. Het is een onbeheerde toepassing op XSP|ADP, dus u moet een webarchiefbestand installeren en implementeren.

  1. Meld u aan bij cisco.com en zoek naar 'BWCallSettingsWeb' in het gedeelte software downloaden.

  2. Zoek en download de meest recente versie van het bestand.

    Bijvoorbeeld: BWCallSettingsWeb_1.8.2_1.war( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) was op het moment van schrijven het meest recent.

  3. Installeer, activeer en implementeer het webarchief volgens de configuratiehandleiding voor Cisco BroadWorks Xtended Service Platform voor uw XSP|ADP-versie. (Versie R24 is https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).

    1. Kopieer het .war-bestand naar een tijdelijke locatie op de XSP|ADP, zoals /tmp/.

    2. Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:

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

      De BroadWorks-softwaremanager valideert en installeert het bestand.

    3. [Optioneel] Verwijderen /tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist).

    4. Activeer de toepassing:

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      De naam en versie zijn verplicht voor elke toepassing, maar voor CSWV moet u ook een contextPath opgeven omdat het een onbeheerde toepassing is. U kunt alle waarden gebruiken die niet door een andere toepassing worden gebruikt, bijvoorbeeld: /callsettings.

    5. Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

  4. U kunt nu de URL voor gespreksinstellingen die u voor clients opgeeft, als volgt voorspellen:

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

    Opmerkingen:

    • U moet de trailing slash op deze URL opgeven wanneer u deze invoert in het clientconfiguratiebestand.

    • De XSP|ADP-FQDN moet overeenkomen met de FQDN voor Xsi-acties, omdat CSWV Xsi-acties moet gebruiken en CORS niet wordt ondersteund.

  5. Herhaal deze procedure voor andere XSP|ADP's in uw Webex voor Cisco BroadWorks-omgeving (indien nodig).

De toepassing Gespreksinstellingen Webview is nu actief op de XSP|ADP's.

Configureer de Webex-app om de webview met gespreksinstellingen te gebruiken

Zie de Webex voor Cisco BroadWorks-configuratiehandleiding voor meer informatie over clientconfiguratie.

Er is een aangepaste tag in het configuratiebestand van de Webex-app die u kunt gebruiken om de CSWV-URL in te stellen. Deze URL toont de gespreksinstellingen aan de gebruikers via de toepassingsinterface.

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

Configureer in de configuratiesjabloon van de Webex-app op BroadWorks de CSWV-URL in de tag %WEB_CALL_SETTINGS_URL_WXT%.

Als u de URL niet expliciet opgeeft, is de standaard leeg en is de pagina met gespreksinstellingen niet zichtbaar voor de gebruikers.

  1. Zorg ervoor dat u over de nieuwste configuratiesjablonen voor de Webex-app beschikt (zie Apparaatprofielen).

  2. Het doel voor webgespreksinstellingen instellen op csw:

    %WEB_CALL_SETTINGS_TARGET_WXT% csw

  3. Stel de URL voor webgespreksinstellingen voor uw omgeving in, bijvoorbeeld:

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

    U hebt deze waarde afgeleid bij het implementeren van de CSWV-toepassing.

  4. Het resulterende clientconfiguratiebestand moet als volgt worden ingevoerd:

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

     
    Elke verwijzing naar XSP omvat XSP of ADP.

Pushmeldingen voor gesprekken configureren in Webex voor Cisco BroadWorks

In dit document gebruiken we de term Call Notifications Push Server (CNPS) om een door XSP gehoste of door ADP gehoste toepassing te beschrijven die in uw omgeving wordt uitgevoerd. Uw CNPS werkt met uw BroadWorks-systeem om op de hoogte te zijn van binnenkomende gesprekken naar uw gebruikers en pusht meldingen van deze gesprekken naar de meldingsservices van Google Firebase Cloud Messaging (FCM) of Apple Push Notification Service (APN's).

Deze services melden de mobiele apparaten van Webex voor Cisco BroadWorks-abonnees dat ze inkomende gesprekken hebben op Webex.

Zie de functiebeschrijving van de pushserver voor meldingen voor meer informatie over NPS.

Een vergelijkbaar mechanisme in Webex werkt met Webex-berichten- en aanwezigheidsservices om meldingen naar de Google- (FCM) of Apple-meldingsservices (APNS) te pushen. Deze services brengen de mobiele Webex-gebruikers op hun beurt op de hoogte van inkomende berichten of aanwezigheidswijzigingen.


 

In dit gedeelte wordt beschreven hoe u NPS configureert voor de verificatieproxy wanneer de NPS nog geen andere apps ondersteunt. Als u een gedeelde NPS moet migreren om NPS-proxy te gebruiken, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruikenhttps://help.webex.com/nl5rir2/.

Overzicht van NPS-proxy

Voor compatibiliteit met Webex voor Cisco BroadWorks moet uw CNPS worden gepatcht ter ondersteuning van de NPS-proxyfunctie, Pushserver voor VoIP in UCaaS.

De functie implementeert een nieuw ontwerp in de pushserver voor meldingen om het beveiligingsprobleem van het delen van privésleutels voor pushmeldingscertificaten met serviceproviders voor mobiele clients op te lossen. In plaats van pushmeldingscertificaten en -sleutels te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een kortstondig pushmeldingstoken te verkrijgen van Webex voor Cisco BroadWorks-backend en gebruikt dit token voor verificatie met de Apple APN's en Google FCM-services.

De functie verbetert ook de mogelijkheid van de Notification Push Server om meldingen naar Android-apparaten te pushen via de nieuwe Google Firebase Cloud Messaging (FCM) HTTPv1 API.

APNS-overwegingen

Apple zal het op HTTP/1 gebaseerde binaire protocol over de Apple Push Notification-dienst na 31 maart 2021 niet langer ondersteunen. We raden u aan uw XSP|ADP te configureren om de op HTTP/2 gebaseerde interface voor APN's te gebruiken. Voor deze update moet uw XSP|ADP die de NPS host R22 of hoger uitvoeren.

Bereid uw NPS voor op Webex voor Cisco BroadWorks

1

Installeer en configureer een specifieke XSP (minimumversie R22) of Application Delivery Platform (ADP).

2

Installeer de NPS-verificatieproxypatches:

3

Activeer de toepassing Pushserver voor meldingen.

4

(Voor Android-meldingen) Schakel de FCM v1-API in op de NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.

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

6

Voeg een techsupport van de NPS XSP/ADP toe.

7

Op elke AS-server wordt het namedefs-bestand in /usr/local/broadworks/bw_base/conf moet worden geconfigureerd met SRV en A-records voor XSP/ADP-zoekopdrachten (Notification Push Server). Als er meerdere XSP/ADP zijn, voegt u voor elke zoekopdracht een vermelding toe.

Voorbeeld: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN EEN versie van 10.193.78.149


 

Na het instellen is een van de volgende opties vereist om de wijzigingen op te halen:

  1. Een restartbw wordt voorgevormd in een onderhoudsperiode.

  2. Via de Cisco BroadWorks CLI:

    R24 en ouder

    AS_CLI/ASDiagnostic/DNS> opnieuw laden

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> opnieuw laden

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> opnieuw laden

De volgende stappen

Als u een NPS opnieuw wilt installeren, gaat u naar NPS configureren om de verificatieproxy te gebruiken

Als u een bestaande Android-implementatie wilt migreren naar FCMv1, gaat u naar NPS migreren naar FCMv1

Configureer NPS om de verificatieproxy te gebruiken

Deze taak is van toepassing op een nieuwe installatie van NPS die is toegewezen aan Webex voor Cisco BroadWorks.

Als u de verificatieproxy wilt configureren op een NPS die met andere mobiele apps wordt gedeeld, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken ( https://help.webex.com/nl5rir2).

1

Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.

2

Maak het clientaccount aan op de 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: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get


 

De CiscoCI-uitgeverUrl moet ALTIJD een US CI-cluster zijn, ongeacht uw locatie. De standaardwaarde moet zijn:

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

Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):

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

(Voor Android-meldingen) Voeg de Android-toepassings-id toe aan de context van de FCM-toepassingen op de NPS.

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

5

(Voor Apple iOS-meldingen) Voeg de toepassings-id toe aan de context van de APNS-toepassingen en zorg ervoor dat u de verificatiesleutel weglaat. Stel deze in op leeg.

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

6

Configureer de volgende NPS-URL's:

XSP|ADP CLI-context

Parameter

Waarde

  • XSP|ADP_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|ADP_CLI/Applications/NotificationPushServer

    /APNS/Production>

url

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

7

Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:

XSP|ADP CLI-context

Parameter

Waarde

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen:

  1. Uitvoeren AS_CLI/System/PushNotification> get en controleer de waarde van enforceAllowedApplicationList. Als het true, moet u deze subtaak voltooien. Anders slaat u de rest van de deeltaak 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

Start de XSP|ADP opnieuw: bwrestart

10

Test gespreksmeldingen door gesprekken te voeren van een BroadWorks-abonnee naar twee mobiele Webex-gebruikers. Controleer of de gespreksmelding wordt weergegeven op iOS- en Android-apparaten.

NPS migreren naar FCMv1

Dit onderwerp bevat optionele procedures die u in Google FCM-console kunt gebruiken wanneer u een bestaande NPS-implementatie hebt die u naar FCMv1 moet migreren. Er zijn drie procedures:

UC-One-clients migreren naar FCMv1

Gebruik de onderstaande stappen in Google FCM-console om UC-One-clients te migreren naar Google FCM HTTPv1.


 

Als branding wordt toegepast op de client, moet de client de afzender-id hebben. Zie in de FCM-console Projectinstellingen > Cloud Messaging. De instelling wordt weergegeven in de aanmeldtabel voor het project.

Zie de Connect Mobile Branding Guide op 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? voor meer informatie. Raadpleeg de gcm_defaultSenderId parameter, die zich bevindt in het bestand Branding Kit, Resource folder, branding.xml met de onderstaande syntaxis:

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

  1. Meld u aan bij FCM-beheerder SDK op http://console.firebase.google.com.

  2. Selecteer de juiste Android-toepassing.

  3. Noteer de project-ID op het tabblad Algemeen

  4. Ga naar het tabblad Serviceaccounts om een serviceaccount te configureren. U kunt een nieuw serviceaccount maken of een bestaand serviceaccount configureren.

    Een nieuw serviceaccount maken:

    1. Klik op de blauwe knop om een nieuw serviceaccount aan te maken

    2. Klik op de blauwe knop om een nieuwe privésleutel te genereren

    3. Sleutel downloaden naar een veilige locatie

    Een bestaand serviceaccount hergebruiken:

    1. Klik op de blauwe tekst om bestaande serviceaccounts weer te geven.

    2. Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.

    3. Klik aan de rechterkant op het hamburgermenu en maak een nieuwe privésleutel aan.

    4. Download het json-bestand dat de sleutel bevat en sla het op naar een veilige locatie.

  5. Kopieer het json-bestand naar de XSP|ADP.

  6. Configureer de project-ID en:

    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. Configureer de toepassing:

    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. FCMv1 inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

SaaS-clients migreren naar FCMv1

Gebruik de onderstaande stappen op Google FCM Console als u SaaS-clients wilt migreren naar FCMv1.


 
Zorg ervoor dat u de procedure 'NPS configureren om verificatieproxy te gebruiken' al hebt voltooid.
  1. FCM uitschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

  3. FCM inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

ADP-server bijwerken

Gebruik de onderstaande stappen in Google FCM-console als u de NPS migreert om een ADP-server te gebruiken.

  1. Haal het JSON-bestand op van de Google Cloud-console:

    1. Ga op de Google Cloud Console naar de pagina Service Accounts.

    2. Klik op Selecteer een project, kies uw project en klik op Openen.

    3. Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.

    4. Selecteer een type Sleutel en klik op Aanmaken

      Het bestand wordt gedownload.

  2. FCM toevoegen aan de ADP-server:

    1. Importeer het JSON-bestand naar de ADP-server met de /bw/install opdracht.

    2. Meld u aan bij de ADP CLI en voeg project- en API-sleutel toe:

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

    3. Voeg vervolgens de toepassing en de sleutel toe:

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

    4. Controleer de configuratie:

      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

Uw partnerorganisatie configureren in Partner Hub

Uw BroadWorks-clusters configureren

[eenmaal per cluster]

Dit gebeurt om de volgende redenen:

  • Webex-cloud inschakelen om uw gebruikers te verifiëren met BroadWorks (via de door XSP|ADP gehoste verificatieservice).

  • Webex-apps inschakelen om de Xsi-interface te gebruiken voor gespreksbeheer.

  • Webex inschakelen om te luisteren naar door BroadWorks gepubliceerde CTI-gebeurtenissen (telefonische aanwezigheid en gespreksgeschiedenis).


 

De clusterwizard valideert de interfaces automatisch wanneer u ze toevoegt. U kunt de cluster blijven bewerken als een van de interfaces niet is gevalideerd, maar u kunt een cluster niet opslaan als er ongeldige invoer zijn.

We voorkomen dit omdat een onjuist geconfigureerde cluster problemen kan veroorzaken die moeilijk op te lossen zijn.

Wat u moet doen:

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Cluster toevoegen.

    Hiermee start u een wizard waarin u uw XSP|ADP-interfaces (URL's) levert. U kunt een poort toevoegen aan de interface-URL als u een niet-standaardpoort gebruikt.

  4. Geef dit cluster een naam en klik op Volgende.

    Het clusterconcept hier is slechts een verzameling van interfaces, meestal samengebracht op een XSP|ADP-server of -farm, waarmee Webex informatie van uw toepassingsserver (AS) kan lezen. U hebt mogelijk één XSP|ADP per AS-cluster of meerdere XSP|ADP's per cluster of meerdere AS-clusters per XSP|ADP. Schaalvereisten voor uw BroadWorks-systeem vallen hier buiten het bereik.

  5. (Optioneel) Een BroadWorks-gebruiker invoeren Accountnaam en Wachtwoord dat u weet dat u zich in het BroadWorks-systeem bevindt waarmee u verbinding maakt met Webex en klik vervolgens op Volgende.

    De validatietests kunnen dit account gebruiken om de verbindingen met de interfaces in het cluster te valideren.

  6. Voeg uw URL's voor XSI-acties en XSI-gebeurtenissen toe.

  7. Optioneel. Werk de DAS-URL bij met de URL van de apparaatactiveringsservice.

  8. Optioneel. Schakel het selectievakje Directe BroadWorks-verificatie inschakelen in als u wilt dat aanmeldingen bij BroadWorks rechtstreeks naar BroadWorks worden verzonden. Anders wordt verificatie naar BroadWorks via de Webex-gehoste IdP-proxyservice geproxy.

    Dit selectievakje is van invloed op deze aanmeldsituaties:

    • Aanmelding bij de gebruikersactiveringsportal: gebruikers moeten hun BroadWorks-aanmeldgegevens invoeren wanneer ze zich bij de portal aanmelden. De bovenstaande instelling bepaalt of de aanmelding rechtstreeks is naar BroadWorks of via de IdP-proxy.

    • Clientaanmelding: als BroadWorks-verificatie is geconfigureerd in de onboardsjabloon, bepaalt de bovenstaande instelling of de clientaanmelding bij de Webex-app rechtstreeks is naar BroadWorks of wordt geproxy via de IdP-proxy.

  9. Klik op Volgende.

  10. Ga als volgt te werk op de pagina CTI-interface:

    1. Voeg de CTI-URL en poort toe voor de CTI-interface waarmee u verbinding wilt maken.

    2. Optioneel. Schakel de schakelaar Gespreksgeschiedenis in en voer vervolgens uw BroadWorks-gebruikers-id in. Als deze optie is geselecteerd, worden BroadWorks-gespreksgeschiedenisgebeurtenissen gesynchroniseerd met de Webex-cloud. Gebruikers kunnen hun gespreksgeschiedenis bekijken in de Webex-app.

    3. Optioneel. Schakel de schakelaar Niet storen (NST) in en voer vervolgens uw BroadWorks-gebruikers-id in. Met deze optie worden NST-gebeurtenissen tussen Webex en BroadWorks gesynchroniseerd, zodat de functie op beide platforms hetzelfde werkt.

    4. Klik op Volgende.

  11. Voeg de URL van uw verificatieservice toe.

  12. Selecteer Verificatieservice met CI-tokenvalidatie.

    Voor deze optie is niet vereist dat mTLS de verbinding beschermt tegen Webex, omdat de verificatieservice het gebruikerstoken correct valideert met de Webex-identiteitsservice voordat het langlevende token aan de gebruiker wordt verstrekt.

  13. Controleer uw gegevens op het laatste scherm en klik op Maken. U zou een bericht met succes moeten zien.

    Partner Hub geeft de URL's door aan verschillende Webex-microservices die de verbindingen met de geleverde interfaces testen.

  14. Klik op Clusters weergeven en u moet uw nieuwe cluster zien en zien of de validatie is gelukt.

  15. De knop Aanmaken kan worden uitgeschakeld in het laatste (preview)scherm van de wizard. Als u de sjabloon niet kunt opslaan, geeft dit een probleem aan met een van de integraties die u zojuist hebt geconfigureerd.

    Deze controle hebben we doorgevoerd om fouten bij volgende taken te voorkomen. U kunt de wizard opnieuw doorlopen terwijl u uw implementatie configureert. Dit kan wijzigingen aan uw infrastructuur vereisen (bijv. XSP|ADP, load balancer of firewall), zoals beschreven in deze handleiding, voordat u de sjabloon kunt opslaan.

De verbindingen met uw BroadWorks-interfaces controleren

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Clusters weergeven.

  4. Partner Hub initieert verbindingstests van de verschillende microservices naar de interfaces in de clusters.

    Nadat de tests zijn voltooid, wordt op de pagina Clusterlijst het statusbericht weergegeven naast elk cluster.

    U moet groene succesberichten zien. Als u een rood foutbericht ziet, klikt u op de betreffende clusternaam om te zien welke instelling het probleem veroorzaakt.

  5. Optioneel. Selecteer een cluster als u bestaande instellingen voor dat cluster wilt zien, zoals XSI-acties, XSI-gebeurtenissen, DAS-URL en de instellingen van de CTI-interface.

Uw integratiesjablonen configureren

Onboardsjablonen zijn de manier waarop u gedeelde configuratie toepast op een of meer klanten terwijl u ze integreert via de inrichtingsmethoden. U moet elke sjabloon koppelen aan een cluster (dat u in het vorige gedeelte hebt gemaakt).

U kunt zoveel sjablonen maken als u nodig hebt, maar er kan slechts één sjabloon aan een klant worden gekoppeld.

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Sjabloon toevoegen.

    Hiermee start u een wizard waarin u de configuratie kunt leveren voor klanten die deze sjabloon gebruiken.

  4. Gebruik de vervolgkeuzelijst Cluster om het cluster te kiezen dat u met deze sjabloon wilt gebruiken.

  5. Voer een sjabloonnaam in en klik op Volgende.

  6. Configureer uw inrichtingsmodus met de volgende aanbevolen instellingen:

    Tabel 3. Aanbevolen inrichtingsinstellingen voor verschillende inrichtingsmodi

    Naam van instelling

    Flowthrough-inrichting met vertrouwde e-mails

    Flowthrough-inrichting zonder e-mails

    Zelfinrichting van de gebruiker

    BroadWorks-flow via inrichting inschakelen (inclusief inrichtingsaccountgegevens indien Ingeschakeld**)

    Aan

    Geef de accountnaam en het wachtwoord voor inrichting op volgens de BroadWorks-configuratie.

    Aan

    Geef de accountnaam en het wachtwoord voor inrichting op volgens de BroadWorks-configuratie.

    Uit

    Automatisch nieuwe organisaties maken in Control Hub

    Aan

    Aan

    Aan

    E-mailadres serviceprovider

    Selecteer een e-mailadres in de vervolgkeuzelijst (u kunt enkele tekens typen om het adres te vinden als het een lange lijst is).

    Dit e-mailadres identificeert de beheerder binnen uw partnerorganisatie aan wie gedelegeerde beheerderstoegang wordt verleend tot alle nieuwe klantorganisaties die met de onboardsjabloon zijn gemaakt.

    Land

    Kies welk land u voor deze sjabloon gebruikt.

    Het land dat u kiest, komt overeen met klantorganisaties die met deze sjabloon zijn gemaakt voor een bepaalde regio. Momenteel zou de regio (EMEAR) of (Noord-Amerika en de rest van de wereld) kunnen zijn. Zie de land-naar-regio toewijzingen in deze spreadsheet.

    Het land van de organisatie bepaalt de standaard internationale inbelnummers voor Cisco PSTN in Webex Meeting-sites. Raadpleeg het gedeelte Land van de Help-pagina voor meer informatie.

    BroadWorks-enterprisemodus actief

    Schakel dit in als de klanten die u met deze sjabloon inricht ondernemingen in BroadWorks zijn.

    Als het groepen zijn, laat deze schakelaar dan uit.

    Als u een mix van bedrijven en groepen in uw BroadWorks hebt, moet u verschillende sjablonen maken voor deze verschillende cases.

    Opmerkingen uit de tabel:

    • † Deze switch zorgt ervoor dat er een nieuwe klantorganisatie wordt gemaakt als het e-maildomein van een abonnee niet overeenkomt met een bestaande Webex-organisatie.

      Dit moet altijd zijn ingeschakeld, tenzij u een handmatig bestel- en uitvoeringsproces gebruikt (via Cisco Commerce Workspace) om klantorganisaties in Webex te maken (voordat u begint met het inrichten van gebruikers in die organisaties). Deze optie wordt vaak het model 'Hybride inrichting' genoemd en valt buiten het bereik van dit document.

    • ** 'Inrichtingsaccount' verwijst naar het BroadWorks-beheerdersaccount op systeemniveau. Op BroadWorks hebt u een beheerdersaccount met de volgende kenmerken nodig: Beheerderstype=Inrichting, Alleen-lezen=Uit.

  7. Selecteer het standaardservicepakket voor klanten met deze sjabloon (zie Pakketten in het gedeelte Overzicht); Basis, Standaard, Premium of Softphone.

    U kunt deze instelling voor individuele gebruikers overschrijven via Partner Hub.

  8. Optioneel. Schakel Gratis bellen via Cisco Webex uitschakelen in als u Webex-gesprekken wilt uitschakelen.

  9. Selecteer een van de volgende opties voor Configuratie voor deelnemen aan vergadering:

    • Cisco-inbelnummers (PSTN)

    • Door de partner verstrekte inbelnummers (BYoPSTN): als u deze optie selecteert, raadpleegt u de Bring Your Own PSTN Solution Guide for Webex for Cisco BroadWorks voor gedetailleerde informatie over het configureren van deze optie.

  10. Klik op Volgende.

  11. Er zijn twee benaderingen voor het inrichten van abonnees met betrekking tot hoe hun identiteiten worden geverifieerd - met behulp van vertrouwde e-mails of niet-vertrouwde e-mails.

    In de workflow voor vertrouwde e-mail geven gebruikers e-mailadressen door aan de partner die ze toevoegt in BroadWorks. Als partner bent u verantwoordelijk voor het inrichten van het e-mailadres als onderdeel van de doorstroommethode of de API-methode.


     

    Het wordt sterk aanbevolen om de vertrouwde inrichtingsmethode te gebruiken, omdat deze ervoor zorgt dat alle abonnees volledig door u als partner worden ingericht en er geen actie is vereist van de eindgebruikers.

    In het geval van niet-vertrouwde e-mail moeten gebruikers hun e-mails verifiëren voordat ze deze inrichten, of kunnen gebruikers zichzelf activeren.

    In het niet-vertrouwde geval zijn er verschillende inrichtingsmodi op basis van de verificatie-instellingen in de onderstaande tabel:

    Tabel 4. Aanbevolen verificatie-instellingen voor gebruikers voor niet-vertrouwde inrichtingsmodi

    Naam van instelling

    Flowthrough-inrichting zonder e-mails

    Zelfinrichting van de gebruiker

    Beheerder eerst inrichten

    Aanbevolen*

    Niet van toepassing

    Gebruikers toestaan zichzelf te activeren

    Niet van toepassing

    Vereist

    • Opmerkingen uit de tabel:

    • * Elke klantorganisatie in Webex moet ten minste één gebruiker met een beheerdersrol hebben. De eerste gebruiker aan wie u geïntegreerde IM&P in BroadWorks toewijst, neemt de rol van klantbeheerder als er een nieuwe klantorganisatie is gemaakt in Webex. Als serviceprovider wilt u mogelijk controle hebben over wie de rol krijgt. Als u deze instelling controleert, wordt het voltooien van de activering van gebruikers geblokkeerd totdat de eerste gebruiker die u hebt ingericht, is geactiveerd. Als u deze instelling uitschakelt, wordt de eerste gebruiker die in de nieuwe organisatie actief wordt, de klantbeheerder.

  12. Klik op Volgende.

  13. Selecteer de standaard verificatiemodus (BroadWorks-verificatie of Webex-verificatie) om u aan te melden bij Webex.


     
    Deze instelling heeft geen invloed op het aanmelden van gebruikers bij de User Activation Portal. Gebruikers moeten hun BroadWorks-gebruikers-id en -wachtwoord gebruiken wanneer ze zich aanmelden bij de portal, ongeacht hoe de onboardsjabloon is geconfigureerd.

     
    Deze instelling wordt alleen toegepast op nieuw gemaakte klantorganisaties. Als partnerbeheerders een nieuwe verificatie-instelling proberen toe te passen op bestaande klantorganisaties, zijn de bestaande instellingen van toepassing zodat bestaande gebruikers geen toegang verliezen. Als u de verificatiemodus voor bestaande klantorganisaties wilt wijzigen, moet u een ticket openen met Cisco TAC.

    (Zie Verificatiemodus in het gedeelte Uw omgeving voorbereiden).

  14. Klik op Volgende.

  15. Voor Voorkeuren configureert u het volgende:

    1. Kies of u de e-mailadressen van gebruikers vooraf wilt invullen op de aanmeldpagina.

      U moet deze optie alleen gebruiken als u BroadWorks-verificatie hebt geselecteerd en de e-mailadressen van de gebruikers ook in het kenmerk Alternatieve id in BroadWorks hebt geplaatst. Anders moeten ze hun BroadWorks-gebruikersnaam gebruiken. De aanmeldpagina biedt een optie om de gebruiker te wijzigen, indien nodig, maar dit kan leiden tot aanmeldproblemen.

    2. Als u adreslijstsynchronisatie wilt inschakelen, stelt u de schakelaar Telefoonlijstsynchronisatie inschakelen voor alle nieuwe klantorganisaties in op Aan.

      Met deze optie kan Webex BroadWorks-contactpersonen in de klantorganisatie lezen, zodat gebruikers deze kunnen vinden en bellen vanuit de Webex-app.

    3. Voer een partnerbeheerder in.

      Deze naam wordt gebruikt in het geautomatiseerde e-mailbericht van Webex, waarin gebruikers worden uitgenodigd om hun e-mailadres te valideren.

    4. Zorg ervoor dat de schakelaar E-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties is ingeschakeld (de standaardinstelling is ingeschakeld).

    5. Klik op Volgende.

  16. Controleer uw gegevens op het laatste scherm. U kunt op de navigatieknoppen boven aan de wizard klikken om terug te gaan en eventuele details te wijzigen. Klik op Maken.

    U zou een bericht met succes moeten zien.

  17. Klik op Sjablonen weergeven en u moet uw nieuwe sjabloon met andere sjablonen in de lijst zien.

  18. Klik op de sjabloonnaam om de sjabloon indien nodig te wijzigen of te verwijderen.

    U hoeft de gegevens van het inrichtingsaccount niet opnieuw in te voeren. De velden Leeg wachtwoord/Wachtwoordbevestiging zijn er om de referenties te wijzigen als dat nodig is, maar laat ze leeg om de waarden te behouden die u aan de wizard hebt opgegeven.

  19. Voeg meer sjablonen toe als u verschillende gedeelde configuraties hebt die u aan klanten wilt aanbieden.


     

    Houd de pagina Sjablonen weergeven open, omdat u mogelijk sjabloongegevens nodig hebt voor een volgende taak.

Toepassingsserver configureren met inrichtingsservice-URL


 

Deze taak is alleen vereist voor flow door inrichting.

Patch Application Server (alleen R22, R23 en R24)

  1. Als u dit nog niet hebt gedaan, past u de volgende patch toe die van toepassing is op uw versie:.


     
    Zie BroadWorks-softwarevereisten in het gedeelte Referentie voor een volledige lijst met BroadWorks-patches die de vereiste vormen voor de implementatie van Webex voor Cisco BroadWorks.
  2. Wijzigen in de Maintenance/ContainerOptions context.

  3. De parameter voor de inrichtings-URL inschakelen:

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

De inrichtings-URL('s) ophalen in Partner Hub

Raadpleeg de Beheerhandleiding Cisco BroadWorks Application Server Command Line Interface voor meer informatie (Interface > Berichten en service > Geïntegreerde IM&P) over de AS-opdrachten.

  1. Meld u aan bij Partner Hub en ga naar Instellingen > BroadWorks-gesprekken.

  2. Klik op Sjablonen weergeven.

  3. Selecteer de sjabloon die u gebruikt om de abonnees van deze onderneming/groep in te richten in Webex.

    De sjabloondetails worden weergegeven in een flyout-deelvenster aan de rechterkant. Als u nog geen sjabloon hebt gemaakt, moet u dit doen voordat u de inrichtings-URL kunt krijgen.

  4. Kopieer de URL van de inrichtingsadapter.

Herhaal dit voor andere sjablonen als u er meer hebt dan één.

(Optie) Systeembrede inrichtingsparameters configureren op toepassingsserver


 

Mogelijk wilt u het systeembrede inrichtings- en servicedomein niet instellen als u UC-One SaaS gebruikt. Zie Beslissingspunten in het gedeelte Uw omgeving voorbereiden.

  1. Meld u aan bij de toepassingsserver en configureer de interface voor berichten.

    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. De geïntegreerde IMP-interface activeren:

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

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


 

U moet de volledig gekwalificeerde naam invoeren voor de provisioningURL parameter, zoals deze is gegeven in Control Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in de /etc/hosts bestand op het AS.

(Optie) Inrichtingsparameters per onderneming configureren op toepassingsserver

  1. Open in de BroadWorks-gebruikersinterface de onderneming die u wilt configureren en ga naar Services > Geïntegreerde IM&P.

  2. Selecteer Servicedomein gebruiken en voer een dummywaarde in (Webex negeert deze parameter. U kunt dit gebruiken example.com).

  3. Selecteer Messaging Server gebruiken.

  4. Plak in het veld URL de inrichtings-URL die u van uw sjabloon hebt gekopieerd in Partner Hub.


     

    U moet de volledig gekwalificeerde naam invoeren voor de provisioningURL parameter, zoals deze is gegeven in Partner Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in de /etc/hosts bestand op het AS.

  5. Voer in het veld Gebruikersnaam een naam in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.

  6. Voer een wachtwoord in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.

  7. Voor Standaard gebruikersidentiteit voor IM&P-id selecteert u Primair.

  8. Klik op Toepassen.

  9. Herhaal dit voor andere bedrijven die u wilt configureren voor flow door inrichting.

Inrichtingsgegevens gebruiker

Zie Gebruikersvoorzieningen voor serviceproviders voor informatie over de gebruikersgegevens die worden uitgewisseld tussen BroadWorks en Webex tijdens het inrichten van gebruikers.

Controle-API voorafgaand aan inrichting van partner

De API Pre-Provisioning Check helpt beheerders en verkoopteams door te controleren op fouten voordat u een klant of abonnee inricht voor een pakket. Gebruikers of integraties die zijn geautoriseerd door een gebruiker met de rol Volledige partnerbeheerder kunnen deze API gebruiken om ervoor te zorgen dat er geen conflicten of fouten zijn met de pakketinrichting voor een bepaalde klant of abonnee.

De API controleert of er conflicten zijn tussen deze klant/abonnee en bestaande klanten/abonnees op Webex. De API kan bijvoorbeeld fouten veroorzaken als de abonnee al is ingericht voor een andere klant of partner, als het e-mailadres al bestaat voor een andere abonnee of als er conflicten zijn tussen de inrichtingsparameters en wat er al bestaat in Webex. Dit geeft u de mogelijkheid om deze fouten op te lossen voordat u inricht, waardoor de kans op een succesvolle inrichting groter wordt.

Zie voor meer informatie over de API: Ontwikkelaarshandleiding van Webex voor groothandels

Als u de API wilt gebruiken, gaat u naar: Een Wholesale Subscriber-inrichting vooraf controleren


 

Als u toegang wilt krijgen tot een inrichtingsdocument voor groothandels voor abonnees, moet u zich aanmelden bij de https://developer.webex.com/-portal.

Partner SSO - SAML

Hiermee kunnen partnerbeheerders SAML SSO configureren voor nieuw gemaakte klantorganisaties. Partners kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren, evenals op hun eigen werknemers.


 
De onderstaande stappen voor Partner-SSO zijn alleen van toepassing op nieuw gemaakte klantorganisaties. Als partnerbeheerders proberen Partner SSO toe te voegen aan een bestaande klantorganisatie, blijft de bestaande verificatiemethode behouden om te voorkomen dat bestaande gebruikers de toegang verliezen. Als u partner-SSO wilt toevoegen aan een bestaande organisatie, moet u een ticket openen met Cisco TAC.
  1. Controleer of de provider van de externe identiteitsprovider voldoet aan de vereisten die worden vermeld in het gedeelte Vereisten voor identiteitsproviders van Integratie van eenmalige aanmelding in Control Hub.

  2. Open een serviceaanvraag met Cisco TAC. TAC moet een vertrouwensrelatie opbouwen tussen de externe identiteitsprovider en de Cisco Common Identity-service. .


     
    Als uw IdP de passEmailInRequest in te schakelen, zorg ervoor dat u deze vereiste in het serviceverzoek opneemt. Raadpleeg uw IdP als u niet zeker weet of deze functie vereist is.
  3. Upload het CI-metagegevensbestand dat TAC aan uw identiteitsprovider heeft geleverd.

  4. Configureer een integratiesjabloon. Selecteer Partnerverificatie voor de instelling Verificatiemodus. Voer voor de entiteits-id van de IDP-provider de entiteits-id in vanuit de XML-metagegevens van de SAML van de externe identiteitsprovider.

  5. Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.

  6. Precies dat de gebruiker kan inloggen.

Partner-SSO - OpenID Connect (OIDC)

Hiermee kunnen partnerbeheerders OIDC SSO configureren voor nieuw gemaakte klantorganisaties. Partners kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren, evenals op hun eigen werknemers.


 

De onderstaande stappen om Partner SSO OIDC in te stellen, zijn alleen van toepassing op nieuw gemaakte klantorganisaties. Als partnerbeheerders proberen het standaard verificatietype te wijzigen in Partner SSO OIDC in een bestaande tempel, zijn de wijzigingen niet van toepassing op de klantorganisaties die al zijn geïntegreerd met de sjabloon. Als u partner-SSO wilt toevoegen aan een bestaande klantorganisatie, moet u een ticket openen met Cisco TAC.

  1. Open een serviceaanvraag met Cisco TAC met de details van de OpenID Connect-id-provider. Hieronder staan verplichte en optionele IDP-kenmerken. TAC moet de id-provider instellen op de CI en de omleidings-URI opgeven die moet worden geconfigureerd op de id-provider.

    Kenmerk

    Vereist

    Beschrijving

    Naam IDP

    Ja

    Unieke maar hoofdlettergevoelige naam voor OIDC IdP-configuratie, kan bestaan uit letters, cijfers, koppeltekens, onderstrepingstekens, tildes en stippen en de maximale lengte is 128 tekens.

    OAuth-client-id

    Ja

    Wordt gebruikt om OIDC IdP-verificatie aan te vragen.

    OAuth-clientgeheim

    Ja

    Wordt gebruikt om OIDC IdP-verificatie aan te vragen.

    Lijst met scopes

    Ja

    Lijst met scopes die worden gebruikt om OIDC IdP-verificatie aan te vragen, opgesplitst per ruimte, bijvoorbeeld 'openid e-mailprofiel' Moet openid en e-mail bevatten.

    Autorisatieeindpunt

    Ja als DiscoveryEndpoint niet is verstrekt

    URL van het OAuth 2.0-verificatie-eindpunt van de IdP.

    tokenEindpunt

    Ja als DiscoveryEndpoint niet is verstrekt

    URL van het OAuth 2.0-tokeneindpunt van de IdP.

    Eindpunt van detectie

    Nee

    URL van het Discovery-eindpunt van de IdP voor detectie van OpenID-eindpunten.

    userInfoEindpunt

    Nee

    URL van het UserInfo-eindpunt van de IdP.

    Eindpunt sleutelset

    Nee

    URL van het eindpunt van de JSON-websleutelset van de IdP.


     

    Naast de bovenstaande IDP-attributen moet de id van de partnerorganisatie worden opgegeven in het TAC-verzoek.

  2. Configureer de omleidings-URI op de OpenID connect-id-provider.

  3. Configureer een integratiesjabloon. Voor de instelling Verificatiemodus selecteert u Partnerverificatie met OpenID Connect en voert u de IDP-naam in die tijdens de installatie van de IDP is opgegeven als de entiteits-id van OpenID Connect IDP.

  4. Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.

  5. Zeer dat de gebruiker zich kan aanmelden met de SSO-verificatieflow.

Gesprekscorrelatie-id inschakelen

Als u Webex voor Cisco BroadWorks wilt uitvoeren, moet u de gesprekscorrelatie-id inschakelen. Deze instelling is vereist voor veel gespreksfuncties, waaronder gespreksopname, groepsgesprek opnemen, directie en directie-assistent.

Gebruik de CLI om de functie in te schakelen op alle AS- en XSP|ADP-interfaces.

  • Voer de volgende opdrachten uit op AS-interfaces. Hierdoor kan het AS de X-BroadWorks-Correlation-Info SIP-koptekst:

    AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true

    AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true

  • Het enableCallCorrelationID parameter die is gekoppeld aan de toepassing Xsi-Actions wordt gebruikt om de opname van informatie over gesprekscorrelatie in Xsi-Actions-logboeken te beheren. Het wordt aanbevolen om enableCallCorrelationID ingeschakeld met de volgende opdracht op XSP|ADP-interfaces:

    XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true

Zie voor meer informatie over de gesprekscorrelatie-id de functiebeschrijving Cisco BroadWorks-gesprekscorrelatie-id.

Synchroniseren met Directory

Telefoonlijstsynchronisatie zorgt ervoor dat Webex voor Cisco BroadWorks-gebruikers de Webex-telefoonlijst kunnen gebruiken om elke belentiteit te bellen vanaf de BroadWorks-server. Wanneer deze functie is ingeschakeld, wordt de volledige telefoonlijst van de BroadWorks-server gesynchroniseerd met de Webex-telefoonlijst. Gebruikers kunnen toegang krijgen tot de telefoonlijst vanuit de Webex-app en een gesprek plaatsen naar elke belentiteit vanaf de BroadWorks-server.

Als u adreslijstsynchronisatie wilt inschakelen, gaat u naar Adreslijstsynchronisatie in Webex voor Cisco BroadWorks.


 
Webex voor Cisco BroadWorks-flowthrough-inrichting voegt berichtengebruikers en bijbehorende gespreksinformatie van de BroadWorks-server toe aan het Webex-platform. Telefoonlijsten, niet-berichtengebruikers en niet-gebruikersentiteiten zijn echter niet opgenomen (bijvoorbeeld een conferentieruimte-telefoon, faxapparaat of nummer van de Hunt-groep). Als u adreslijstsynchronisatie inschakelt, wordt gegarandeerd dat alle bellende entiteiten worden toegevoegd aan het Webex-platform.

Uniforme gespreksgeschiedenis

Wanneer Unified Call History is ingeschakeld, worden BroadWorks-gespreksgebeurtenissen gesynchroniseerd met de Webex-cloud en worden ze onderdeel van de Webex Unified Call- en Meetings-geschiedenis die wordt weergegeven in de Webex-app. Gebruikers kunnen hun eigen gedetailleerde gespreksgeschiedenis en vergaderingsgeschiedenis bekijken vanuit de Webex-app.

Unified Call History kan worden ingeschakeld door beheerders op partnerniveau in Partner Hub op clusterbasis. Wanneer deze functie is ingeschakeld, synchroniseert de BroadWorks-implementatie de volgende gespreksgebeurtenissen met de Webex-cloud:

  • Gespreksgeschiedenisgebeurtenissen: deze gebeurtenissen worden gebruikt om een gedetailleerde Unified-gespreksgeschiedenis op te bouwen

  • Hookstatusgebeurtenissen: Unified Call History bevat hookstatusoptimalisaties die de hoeveelheid netwerkbandbreedte voor Telephony Presence-updates verlagen

Vereisten voor Unified Call History

Voordat u Unified Call History kunt configureren, moet u ervoor zorgen dat u uw systeem hebt gepatcht. Deze functie is afhankelijk van de volgende BroadWorks-patches die worden geïnstalleerd:

Voor R22:

Voor R23:

Voor R24:


 
Voor de volledige lijst met BroadWorks-patches die u moet installeren als voorwaarde om Webex voor Cisco BroadWorks uit te voeren, raadpleegt u BroadWorks-softwarevereisten in het gedeelte Referentie.

Naast het patchen van uw systeem, wordt het clientconfiguratiebestand ( config-wxt.xml) moet de volgende tagset hebben: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>

Als u Hunt-groep, Call Center en andere omleidingsinformatie in de Unified-gespreksgeschiedenis wilt hebben, moeten de volgende Broadworks-patches zijn geïnstalleerd en actief zijn:

Voor R23:

  • AP.as.23.0.1075.ap383346

  • AP.as.23.0.1075.ap383994

Voor R24:

  • AP.as.24.0.944.ap383346

  • AP.as.24.0.944.ap383994

Als u informatie over de directie-assistent in de Unified-gespreksgeschiedenis wilt hebben, moeten de volgende Broadworks-patches zijn geïnstalleerd en actief zijn:

Voor R24:

  • AP.as.24.0.944.ap380052

  • AP.as.24.0.944.ap384239

  • ADP met Xsi-Events-24_2022.06 of hoger

Naast de Broadworks-patches moet adreslijstsynchronisatie ook zijn ingeschakeld voor de Unified-gespreksgeschiedenis van Executive-Assistant.


 

Wanneer u Gespreksgeschiedenis of NST-synchronisatie inschakelt, verzendt Webex CTI-abonnementsvernieuwingsaanvragen voor alle gebruikers onder het cluster. Afhankelijk van het aantal gebruikers kan dit tot enkele uren duren. Het wordt aanbevolen geen onderhoudsactiviteiten van Broadworks uit te voeren tijdens dezelfde onderhoudsperiode.

Gespreksgeschiedenis inschakelen (nieuw cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een nieuw cluster, raadpleegt u de stappen voor het toevoegen van een cluster in Uw partnerorganisatie configureren in Partner Hub.

Gespreksgeschiedenis inschakelen (bestaand cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een bestaand cluster, volgt u de volgende stappen:

  1. Meld u aan bij Partnerhub op admin.webex.com.

  2. Ga naar Instellingen en selecteer een bestaand cluster.

  3. Controleer of de clusterverbinding goed is. In het rechterdeelvenster moet een groen vinkje worden weergegeven met Connection established.

    Als dit niet wordt weergegeven, voert u onder Connnections controleren (optioneel) de BroadWorks-gebruikers-id en het BroadWorks-wachtwoord in en klikt u op Controleren om te controleren of de verbinding goed is.

  4. Schakel het selectievakje Gespreksgeschiedenis inschakelen in.

  5. Klik op Opslaan.

Interacties van functies

De volgende functieinteracties bestaan voor Unified Call History:

  • Unified Call History wordt niet ondersteund voor gebruikers die zijn geconfigureerd in BroadWorks met routelijsten of directe routes. Wanneer deze situatie bestaat, worden gebeurtenissen voor gespreksgeschiedenis en haakstatus niet naar de Webex-app verzonden.

  • Unified Call History wordt niet ondersteund bij toestelbellen. Gesprekken die zijn geplaatst via toestelbellen worden mogelijk niet correct weergegeven in de gespreksgeschiedenis.

Gespreksgeschiedenis weergeven in de Webex-app

Eindgebruikers kunnen hun Unified Call History openen en bekijken vanuit de Webex-app. Voor meer informatie raadpleegt u: Webex | Gespreks- en vergadergeschiedenis weergeven.

Unified Call History uitschakelen

Nadat u Unified Call History hebt ingeschakeld op een cluster, kunt u de functie niet zelf uitschakelen. Als u de functie wilt uitschakelen, neemt u contact op met het Cisco Technical Assistance Center (TAC).

Indicatie Visuele Spam

De Webex-app ondersteunt een visuele indicatie van spamgesprekken in de gesprekstoast wanneer het gesprek wordt weergegeven aan de gebelde en in de Unified Call History-records wanneer BroadWorks wordt bijgewerkt om de beller-id te valideren via het STIR/SHAKEN-framework. Deze functie hebben:

  1. Schakel Unified Call History in zoals beschreven in het vorige gedeelte.
  2. De volgende patches moeten geïnstalleerd en actief zijn:
    • AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
    • of minimaal AS-25_Rel_2022.12
  3. De functie moet geactiveerd worden via de AS CLI:
    • AS_CLI/System/ActivatableFeature> 104112 activeren
    • AS_CLI/System/StirShaken> enableVerification true instellen
  4. Broadworks moet worden geconfigureerd voor het ondertekenen, labelen en verifiëren van STIR-SHAKEN zoals beschreven in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification

Wanneer BroadWorks correct is geconfigureerd, wordt een nieuwe koptekst X-Cisco-CallerId-Disposition toegevoegd in INVITE-verzoeken die naar Cisco-clients worden verzonden en wordt een nieuwe veldbellerIdDisposition toegevoegd aan de bestaande gespreksgeschiedenisgebeurtenissen die via de CTI-interface naar de Webex-cloud worden verzonden. Webex-apparaten gebruiken deze informatie om een visuele spamindicatie te geven in de gesprekspresentatie en de Unified Call History van de gebelde.

Belleridentificatie en omleiding van gesprekken

Identificatie beller

Wanneer de Webex-app een gesprek ontvangt, wordt geprobeerd te identificeren wie de beller is en wordt deze informatie weergegeven in de melding voor een binnenkomend gesprek, in het gespreksvenster en nadat het gesprek is voltooid, in de gespreksgeschiedenis en voicemail.

De Webex-app probeert de beller-id te vinden door het inkomende telefoonnummer te koppelen aan de telefoonnummers van contactpersonen die in verschillende bronnen zijn gevonden. De Webex-app gebruikt de volgende bronnen in deze volgorde. Zodra het vindt het in een bron zal het niet proberen om ergens anders te zoeken.


 

Als er meerdere exemplaren van een nummer in één bron worden gevonden, wordt niet geprobeerd er een te kiezen. In dit geval wordt er geen beller-id weergegeven.

  • Webex Common Identity (CI) die gebruikers van uw organisatie bevat.

  • Persoonlijke contactpersonen en contactpersonen binnen de organisatie. Persoonlijke contactpersonen zijn zichtbaar op het tabblad Contactpersonen.

  • Lokaal adresboek. In Windows - Outlook-toepassing, in Mac - Mac-contactpersonen, in iOS - iPhone-contactpersonen, in Android - Android-contactpersonen.

Als er geen overeenkomst is gevonden met het inkomende telefoonnummer, gebruikt de app de weergavenaam in de SIP FROM-koptekst, indien beschikbaar. Anders wordt het gebruikersnaamgedeelte van de SIP-URI uit de koptekst SIP From als laatste redmiddel gebruikt.

Voor extern gespreksbeheer (d.w.z. Deskphone Control Mode) wordt XSI-informatie gebruikt, waarbij de BWKS-id of het toestel wordt gebruikt, geëxtraheerd uit informatie van externe partijen in de XSI-gebeurtenis. Als informatie van externe partijen niet beschikbaar is, wordt P-Asserted Identity (PAI) (indien geconfigureerd) gebruikt.

Gesprekken omleiden

Als een gesprek is omgeleid of doorgeschakeld, probeert de app te laten zien wie de beller is en hoe deze is doorgeschakeld in de gespreksmelding en de gespreksgeschiedenis.

  • Gesprek doorgeschakeld: Hier wordt het nummer weergegeven dat het gesprek heeft doorgeschakeld.

  • Hunt-groep: Hier wordt de naam weergegeven van de Hunt-groep die het gesprek heeft doorgeschakeld.

  • Callcenterwachtrij: Hier wordt de naam weergegeven van de wachtrij die het gesprek heeft doorgeschakeld.

  • Directie-assistent: Hier wordt de naam van de directeur weergegeven waarvoor het gesprek binnenkomt.

Uitzonderingen:

  • Voor interne gesprekken in de gesprekswachtrij, waarbij een agent een interne partij terugbelt, ziet de externe partij niet de naam van de gesprekswachtrij, maar de naam van de agent die deze belt.

Gesprek elders beantwoord:

Voor Hunt-groepen of gesprekswachtrijen die zijn ingesteld met gelijktijdige routering, zien agenten een gesprek dat elders in de gespreksgeschiedenis wordt beantwoord als een andere agent het gesprek opneemt. Voor Hunt-groepen of gesprekswachtrijen met opeenvolgende routering of in een overloop worden gesprekken weergegeven als gemiste oproep in de gespreksgeschiedenis als ze door een andere agent worden beantwoord.

Weergave van gedeelde lijn

Met de weergave van gedeelde lijn kunnen lijnen van andere gebruikers worden ingesteld als gedeelde lijnen op het apparaat voor eindgebruikers. De configuratie van de gedeelde lijn voor de Webex-app is vergelijkbaar met de configuratie van de gedeelde lijn voor bureautelefoons. Met deze specifieke functie kunt u weergaven voor gedeelde lijnen toewijzen aan de Webex-app van de eindgebruiker.

Deze functie biedt gebruikers de voordelen om gesprekken op het toestelnummer van een andere gebruiker rechtstreeks vanuit de Webex-app af te handelen.

  • U kunt de weergave van gedeelde lijn alleen instellen voor de bureaubladversie van een Webex-app.

  • U kunt maximaal 10 lijnen toevoegen, inclusief de primaire lijn Webex-app .

  • U kunt een workspace-lijn niet toewijzen als gedeelde lijn.

  • Een gebruiker kan niet tegelijkertijd met gedeelde lijnen worden ingericht met de service Executive Assistant.

  • De primaire lijnpoort van een gebruiker mag niet worden gewijzigd in een gedeelde lijn.

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

Pleister 1: Eigenaarsmarkering in apparaatlijst ter ondersteuning van gedeelde lijnen van Webex-client

R23 zonder ADP:

  • AP.as.23.0.1075.ap384179

  • AP.xsp.23.0.1075.ap384179

R23 met ADP:

  • AP.as.23.0.1075.ap384179

  • Xsi-Actions-23_2022.10

R24:

  • ALS: AP.as.24.0.944.ap384179

  • Xsi-Actions-24_2022.10

R25:

  • ALS: RI versie Rel_2022.10_1.310

  • Xsi-Actions-25_2022.10

Pleister 2: Patches voor het verhogen van het aantal poorten op apparaatprofieltypen (in dit geval voor de desktopclient: Business Communicator).

  • RI versie Rel_2022.10_1.310

Niet storen (NS)-synchronisatie

Synchronisatie Niet storen (NST) brengt de NST-instellingen op één lijn tussen Webex en BroadWorks door de NST-status tussen de twee platforms te synchroniseren. Als een gebruiker bijvoorbeeld Niet storen inschakelt vanuit de Webex-app, wordt die status gesynchroniseerd met BroadWorks-gespreksapparaten. Als gevolg daarvan gaat de bij BroadWorks geregistreerde bureautelefoon van de gebruiker niet over wanneer iemand deze probeert te bellen. Als een gebruiker NST instelt vanaf een bureautelefoon, wordt de status ook gesynchroniseerd met de Webex-app. Zonder deze functie worden NST-updates van het ene platform niet herkend door het andere platform.

NST-synchronisatie wordt toegepast op clusterniveau BroadWorks en kan door een partnerbeheerder worden ingeschakeld in Partnerhub.

Voorwaarden

Zorg ervoor dat de volgende patches worden toegepast op de AS en XSP|ADP. Pas alleen de patches toe voor uw BroadWorks-versie.

Voor versie 22:

  • AS-pleister: AP.as.22.0.1123.ap382615, AP.as.22.0.1123.ap382838

  • XSP|ADP-pleister: AP.xsp.22.0.1123.ap382615, AP.xsp.22.0.1123.ap382838

Voor versie 23:

  • AS-pleister: AP.as.23.0.1075.ap382615, AP.as.23.0.1075.ap382838

  • XSP|ADP-pleister: AP.xsp.23.0.1075.ap382615, AP.xsp.23.0.1075.ap382838

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

Voor versie 24:

  • AS-pleister: AP.as.24.0.944.ap382615, AP.as.24.0.944.ap382838

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

Nadat u de patches hebt aangebracht, activeert u functie 25433 op de AS:

AS_CLI/System/ActivatableFeature> activate 25433

Synchronisatie van apparaatfunctietoetsen configureren in BroadWorks. Zorg ervoor dat de telefoon SIP SUBSCRIBE/NOTIFY ondersteunt voor het gebeurtenispakket 'as-feature-event'. Zie Functietoetssynchronisatie voor Cisco BroadWorks-apparaten voor meer informatie.

NST-synchronisatie inschakelen (bestaand cluster)

  1. Aanmelden bij Partner Hub

  2. Klik op Instellingen.

  3. Klik op Cluster weergeven en selecteer het juiste BroadWorks-cluster.

  4. Schakel de schakelaar Niet storen (NST) in.

  5. Voer uw BroadWorks-gebruikers-id in en klik op Enable.

    Het systeem valideert dat het BroadWorks-cluster de juiste patches heeft om NST-synchronisatie te ondersteunen. Als de validatie mislukt, wordt de knop Opslaan uitgeschakeld.

  6. Als de validatie slaagt, klik dan op Save.


 
  • Zodra NST synchroniseren is ingeschakeld, vernieuwt Webex alle gebruikersabonnementen om het gebeurtenispakket Niet storen op te nemen. Afhankelijk van het aantal gebruikers kan het enkele uren duren voordat dit proces is voltooid.

  • NST-synchronisatie inschakelen is een eenrichtingsschakelaar. Zodra de functie is ingeschakeld, kunt u deze niet zelf uitschakelen.

NST-synchronisatie inschakelen (nieuw cluster)

U kunt de functie ook inschakelen tijdens het maken van het cluster. Zie 'Uw BroadWorks-clusters configureren' in Uw partnerorganisatie configureren in Partner Hub voor meer informatie.

NST-synchronisatie uitschakelen

U kunt NST-synchronisatie niet zelf uitschakelen. Als u de functie wilt uitschakelen, maakt u een BEMS-engineeringcase met de volgende informatie:

  • Gezin: Spark-service

  • Product: Bellen in Webex (Webex voor BroadWorks)

  • Onderdeel: WxBW- Inrichting

  • In het BEMS-geval moet worden vermeld dat Niet storen synchroniseren moet worden uitgeschakeld voor een partner. De case moet partnerId en BroadWorks clusterId bevatten.

Usecases

NST instellen en wissen in relatie tot werkstatus

Gespreksopname

Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopname.

Tabel 6. Opnamemodi

Opnamemodi

Beschrijving

Bedieningselementen/indicatoren die worden weergegeven in de Webex-app

Altijd

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker is niet in staat om te beginnen met of stoppen met opnemen.

  • Visuele indicator dat de opname bezig is

Altijd met onderbreken/hervatten

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker kan een opname onderbreken en hervatten.

  • Visuele indicator dat de opname bezig is

  • Knop Opname onderbreken

  • Knop Opname hervatten

OnDemand

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht, maar de opname wordt verwijderd tenzij de gebruiker op Opname starten drukt.

Als de gebruiker een opname start, blijft de volledige opname van de gespreksinstellingen behouden. Nadat de gebruiker de opname heeft gestart, kan de gebruiker de opname ook onderbreken en hervatten

  • Knop Opname starten

  • Knop Opname onderbreken

  • Knop Opname hervatten

OnDemand met door gebruiker geïnitieerde start

De opname wordt niet gestart tenzij de gebruiker de optie Opname starten selecteert in de Webex-app. De gebruiker heeft de optie om meerdere keren te starten en stoppen met opnemen tijdens een gesprek.

  • Knop Opname starten

  • Knop Opname stoppen

  • Knop Opname onderbreken

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

De Call Correlation Identifier (Correlatie-id gesprek) moet zijn ingeschakeld. Zie Gesprekscorrelatie-id inschakelen voor meer informatie.

De volgende configuratietag moet zijn ingeschakeld om deze functie te kunnen gebruiken: %ENABLE_CALL_RECORDING_WXT%.

Deze functie vereist een integratie met een gespreksopnameplatform van derden.

Als u gespreksopname op BroadWorks wilt configureren, gaat u naar de Cisco BroadWorks-interfacehandleiding voor gespreksopname.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van de opnamefunctie gaat u naar de help.webex.com artikel Webex | Uw gesprekken opnemen.

Als u een opname opnieuw wilt afspelen, moeten gebruikers of beheerders naar hun gespreksopnameplatform van derden gaan.

Groep gesprek parkeren en ophalen

Webex voor Cisco BroadWorks ondersteunt Groep gesprek parkeren en ophalen. Deze functie biedt gebruikers binnen een groep een manier om gesprekken te parkeren, die vervolgens door andere gebruikers in de groep kunnen worden opgehaald. Winkelmedewerkers in een winkelinstelling kunnen de functie bijvoorbeeld gebruiken om een gesprek te parkeren dat vervolgens kan worden opgehaald door iemand in een andere afdeling.

Werking van functies

Zodra de functie is geconfigureerd

  • Tijdens een gesprek klikt een gebruiker op de optie Parkeren in de Webex-app om het gesprek te parkeren op een toestel dat het systeem automatisch selecteert. Het systeem geeft het toestelnummer voor de gebruiker voor een periode van 10 seconden weer.

  • Een andere gebruiker in de groep klikt op de optie Gesprek ophalen in de Webex-app. De gebruiker voert vervolgens het toestelnummer van het geparkeerde gesprek in om het gesprek voort te zetten.

Vereisten

Zorg voor het volgende om deze functie te laten werken:

  • Het clientconfiguratiebestand moet de volgende tags hebben ingesteld:

    <call-park enabled="%ENABLE_CALL_PARK_WXT%"
            timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
  • De Call Correlatie-id moet zijn ingeschakeld op de AS en XSP|ADP. Zie Gesprekscorrelatie-id inschakelen voor meer informatie.

  • Uw SBC moet zijn geconfigureerd om de ' x-broadworks-correlation-in' SIP-kenmerk van en naar de toepassingsserver.

Configuratie

Zie 'Groep voor geparkeerde gesprekken toevoegen' in de Beheerhandleiding voor de webinterface van de Cisco BroadWorks-toepassingsservergroep - deel 2 voor meer informatie over het configureren van Groepsgesprek parkeren op BroadWorks. U moet een groep maken en gebruikers aan de groep toevoegen.

Meer informatie over het configureren van de gesprekscorrelatie-id in BroadWorks vindt u in Functiebeschrijving Cisco BroadWorks-gesprekscorrelatie-id.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van Groepsgesprek parkeren raadpleegt u Webex | Parkeren en Gesprekken ophalen.

Gesprek parkeren/doorverbonden gesprek parkeren

Normaal of doorverbonden gesprek parkeren wordt niet ondersteund in de gebruikersinterface van de Webex-app, maar ingerichte gebruikers kunnen de functie implementeren met behulp van functietoegangscodes:

  • Voer *68 in om een gesprek te parkeren

  • Voer *88 in om een gesprek op te halen

Inbreken

Inbrekersservice wordt vaak gebruikt in callcenteromgevingen of andere situaties waar directe hulp of interventie nodig kan zijn.

Wanneer een inbrekersservice is ingeschakeld, kan een aangewezen gebruiker of supervisor een actief gesprek invoeren door een specifieke opdracht te starten of door een speciale knop of toetscombinatie te gebruiken op hun telefoon of communicatieapparaat. Zodra de aanvraag voor inbreken is ingediend, brengt het systeem een verbinding tot stand met het lopende gesprek, zodat de bevoegde persoon het gesprek kan beluisteren of als actieve deelnemer aan het gesprek kan deelnemen.

Inbreken kan handig zijn in verschillende scenario's. In een callcenterinstelling kunnen supervisors of trainers vertegenwoordigers van de klantenservice controleren en coachen door hun gesprekken in realtime te beluisteren. Indien nodig kunnen ze ingrijpen om advies te geven of het gesprek overnemen als de vertegenwoordiger het moeilijk heeft. In noodsituaties of bij kritische gesprekken kan bevoegd personeel snel deelnemen aan lopende gesprekken om hulp te bieden of belangrijke beslissingen te nemen.

In de Webex-app voor inbreken krijgen we een melding dat het gesprek wordt omgezet in een conferentie. Er is geen extra informatie in de NOTIFY (call-info of conference-info) wat het type conferentie is, zodat we het op een andere manier kunnen behandelen.

Bij het inbreken wordt een drierichtingsgesprek tot stand gebracht tussen de partijen. De volgende termen worden geïntroduceerd:

  • Verantwoordelijke: Een supervisor is een persoon die toezicht houdt op en leiding geeft aan een team van klantenserviceagenten of callcentervertegenwoordigers. In het kader van het inbreken van gesprekken heeft een supervisor doorgaans de mogelijkheid om lopende gesprekken van klanten te controleren en tussenbeide te komen. Zij kunnen gespreksbewakingstools of -software gebruiken om gesprekken te beluisteren, agenten te begeleiden en kwaliteitscontrole te garanderen. De rol van de supervisor kan bestaan uit het trainen van agenten, het aanpakken van klantproblemen en het optimaliseren van de prestaties van het team.

  • Klant: Een klant verwijst naar een persoon of entiteit die contact opneemt met een bedrijf of organisatie om producten, diensten of ondersteuning te verkrijgen. In de context van gesprek inbreken is een klant iemand die een telefoongesprek voert of ontvangt met een agent van de klantenservice. Klanten kunnen tijdens het gesprek hulp, informatie of een oplossing zoeken voor hun vragen of problemen. Met de functie voor het inbreken van gesprekken kunnen supervisors of geautoriseerd personeel deelnemen aan het lopende gesprek tussen de klant en de agent.

  • Agent: Een agent, ook wel een vertegenwoordiger van de klantenservice of een callcenteragent genoemd, is een persoon die verantwoordelijk is voor het afhandelen van klantinteracties en het bieden van ondersteuning of hulp via de telefoon of andere communicatiekanalen. Agenten zijn opgeleid om vragen van klanten te beantwoorden, problemen op te lossen, transacties te verwerken en een positieve klantervaring te bieden. In de context van gesprek inbreken is een agent de persoon die rechtstreeks met de klant spreekt tijdens het telefoongesprek. De agent kan indien nodig begeleiding of feedback van de supervisor ontvangen via inbellen.

Mobiel systeemeigen gesprek escaleren naar vergadering

De Mobile Native Call Escalate to Meeting heeft twee unieke functies:

  • Nieuwe pushmelding

    Mobiele gebruikers in een native gesprek kunnen nu overschakelen naar de Webex-app door op de Nieuwe pushmelding te tikken. Wanneer u een systeemeigen gespreksscherm start, verschijnt er een Nieuwe pushmelding op het scherm en tikt u rechtstreeks op het scherm in gesprek van de Webex-app.

    U ziet de Webex-melding tijdens een telefoongesprek als u Webex Go gebruikt of als uw mobiele netwerkoperator (MNO) gesprekssignalering heeft met Cisco-gespreksbeheer voor uw mobiele telefoongesprekken.

  • Mobiel gesprek verplaatsen naar vergadering

    Wanneer u in gesprek bent met iemand, wilt u dat gesprek mogelijk verplaatsen naar een vergadering om gebruik te maken van enkele geavanceerde vergaderingsfuncties, zoals video, delen of whiteboards. Of nodig andere mensen uit in de discussie en ga naar een vergadering.

Vereisten voor BroadWorks

  • Activeerbare functie 25239

  • R23 met 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 met ADP:

    • AS-patch AP.as.23.0.1075.ap383064

    • ADP met Xsi-Actions-23, CommPilot-23 versie > 2022.05_1.303 en NPS versie > 2022.08_1.350

  • R24:

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

    • ADP met Xsi-Actions-24, CommPilot-24 versie > 2022.05_1.303 en NPS versie > 2022.08_1.350

  • R25:

    • AS RI versie Rel_2022.08_1.354

    • ADP met Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 en NPS-versie > 2022.08_1.350

Configuratie voor URI-bellen ter ondersteuning van het verplaatsen van een gesprek naar een vergadering

NS UrlDialing-beleid

Regel definiëren voor (.*)webex.com om te routeren via 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-routering NE voor I-SBC

Voorbeeldconfiguratie

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-routeringsprofiel

Het exemplaar van het URL-belbeleid is toegevoegd aan het/de juiste routeringsprofiel(en)

NS_CLI/Policy/Profile> get profile MyInst
 Profile:  Webex
                  Policy              Instance
    ==========================================
 …
              UrlDialing          WebexMeetings

ALS gebruik NS-route voor NetworkURL-gesprek

Schakel het AS in om de NS-route in de hybride AS-modus te respecteren

AS_CLI/Interface/IMS> set queryNSForNetworkURL true

E911-noodoproepen

Webex voor Cisco BroadWorks ondersteunt E911-noodoproepen. Met deze functie worden noodoproepen gerouteerd naar een PSAP (Public Safety Answering Point), dat vervolgens de hulpdiensten naar de locatie van de beller kan leiden. Als u deze functie wilt gebruiken, moet u Webex voor Cisco BroadWorks integreren met een E911-provider voor noodoproepen.

Gebruik de volgende Webex-artikelen om ondersteuning voor E911-noodoproepservices te configureren:

  • E911-noodoproepen in Webex voor BroadWorks: gebruik dit artikel om E911-noodoproepen in Webex voor Cisco BroadWorks te configureren met een van de volgende ondersteunde E911-providers:

    • Gegarandeerd

    • Binnen het systeem

    • RedSky

  • Disclaimer voor noodoproepen: als u een locatieservice hebt, kunt u het venster Disclaimer voor noodoproepen in de Webex-app zo configureren dat gebruikers hun locatie kunnen bijwerken wanneer ze zich aanmelden.

Clients aanpassen en inrichten

Gebruikers downloaden en installeren hun algemene Webex-apps voor desktop of mobiel (zie Webex-app-platforms voor downloadkoppelingen). Zodra de gebruiker zich heeft geverifieerd, wordt de client geregistreerd bij de Webex-cloud voor berichten en vergaderingen, worden de merkgegevens opgehaald, wordt de informatie over de BroadWorks-service ontdekt en wordt de belconfiguratie gedownload van de BroadWorks-toepassingsserver (via DMS op XSP|ADP).

U configureert de gespreksparameters voor Webex-apps in BroadWorks (zoals normaal). U configureert parameters voor branding, berichten en vergaderingen voor de clients in Control Hub. U kunt een configuratiebestand niet rechtstreeks wijzigen.

Deze twee sets configuraties kunnen overlappen. In dat geval vervangt de Webex-configuratie de BroadWorks-configuratie.

Configuratiesjablonen voor Webex-apps toevoegen aan de BroadWorks-toepassingsserver

Webex-apps worden geconfigureerd met DTAF-bestanden. De clients downloaden een XML-configuratiebestand van de toepassingsserver via de service Apparaatbeheer op de XSP|ADP.

  1. Haal de vereiste DTAF-bestanden op (zie Apparaatprofielen in het gedeelte Uw omgeving voorbereiden).

  2. Controleer of u de juiste tagsets hebt in BroadWorks System > Resources > Device Management Tagsets.

  3. Voor elke client die u inricht:

    1. Download en pak het DTAF zip-bestand voor de specifieke client uit.

    2. DTAF-bestanden importeren naar BroadWorks op System > Resources > Identity/Device Profile Types

    3. Open het nieuw toegevoegde apparaatprofiel voor bewerken en:

      • Voer de XSP|ADP farm FQDN en het Device Access Protocol in.

      • Schakel het selectievakje Support Remote Party Info in. Deze ondersteuning is vereist om bureaublad delen te laten werken.


         
        U kunt de ondersteuning voor Remote Party ook inschakelen door de volgende CLI-opdracht uit te voeren op de toepassingsserver: AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
    4. Pas de sjablonen aan volgens uw omgeving (zie onderstaande tabel).

    5. Sla het bestand op.

  4. Klik op Bestanden en verificatie en selecteer vervolgens de optie om alle systeembestanden opnieuw op te bouwen.

Naam

Beschrijving

Prioriteit codec

Prioriteitsvolgorde configureren voor de audio- en videocodecs voor VoIP-gesprekken

TCP, UDP en TLS

Configureer de protocollen die worden gebruikt voor SIP-signalering en media

RTP-audio- en videopoorten

Poortbereiken configureren voor RTP-audio en -video

SIP-opties

Configureer verschillende opties met betrekking tot SIP (SIP INFO, rport gebruiken, SIP-proxydetectie, vernieuwingsintervallen voor registratie en abonnement, enz.)

Branding voor Webex-app aanpassen


 

De portal voor gebruikersactivering gebruikt hetzelfde logo dat u toevoegt voor Client Branding.

Probleemrapportage en Help-URL's aanpassen

Als u deze opties wilt aanpassen, kunnen administators de procedure 'Feedback en Help-site-URL's toevoegen' volgen, die u in beide bovenstaande brandingartikelen kunt vinden.

Uw testorganisatie configureren voor Webex voor Cisco BroadWorks

Voordat u begint

Met Flowthrough-inrichting

U moet alle XSP|ADP-services en de partnerorganisatie in Control Hub configureren voordat u deze taak kunt uitvoeren.

1

Service toewijzen in BroadWorks:

  1. Maak een testonderneming onder uw serviceprovideronderneming in BroadWorks of maak een testgroep onder uw serviceprovider (afhankelijk van uw BroadWorks-configuratie).

  2. Configureer de IM&P-service voor die onderneming om naar de sjabloon te verwijzen die u test (haal de URL van de inrichtingsadapter en de referenties op in de Control Hub-onboardsjabloon).

  3. Maak testabonnees in die onderneming/groep.

  4. Geef de gebruikers unieke e-mailadressen in het e-mailveld in BroadWorks. Kopieer deze ook naar het kenmerk Alternatieve id.

  5. Wijs de geïntegreerde IM&P-service toe aan deze abonnees.


     

    Hierdoor worden de klantorganisatie en de eerste gebruikers gemaakt, wat enkele minuten duurt. Wacht even voordat u zich probeert aan te melden bij uw nieuwe gebruikers.

2

Klantorganisatie en gebruikers verifiëren in Control Hub:

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Klanten en controleer of uw nieuwe klantorganisatie in de lijst staat (de naam volgt de groepsnaam of de bedrijfsnaam, vanuit BroadWorks).

  3. Open de klantorganisatie en controleer of de abonnees gebruikers in die organisatie zijn.

  4. Controleer of de eerste abonnee aan wie u de geïntegreerde IM&P-service hebt toegewezen, de klantbeheerder van die organisatie is geworden.

Gebruikerstests

1

Download de Webex-app op twee verschillende machines.

2

Meld u aan als testgebruikers op de twee machines.

3

Voer testgesprekken.

Webex voor BroadWorks beheren

Klantorganisaties inrichten

In het huidige model richten we de klantorganisatie automatisch in wanneer u de eerste gebruiker integreert via een van de methoden die in dit document worden beschreven. Inrichting vindt slechts één keer plaats voor elke klant.

Gebruikers inrichten

U kunt gebruikers op de volgende manieren inrichten:

  • API's gebruiken om Webex-accounts te maken

  • Geïntegreerde IM&P (flowthrough provisioning) toewijzen met vertrouwde e-mails om Webex-accounts te maken

  • Wijs geïntegreerde IM&P (flowthrough provisioning) toe zonder vertrouwde e-mails. Gebruikers verstrekken en valideren e-mailadressen om Webex-accounts te maken

  • Gebruikers toestaan zichzelf te activeren (u stuurt ze een koppeling, ze maken Webex-accounts)

API's voor openbare inrichting

Webex stelt openbare API's bloot zodat serviceproviders Webex voor Cisco BroadWorks-abonneevoorzieningen kunnen integreren in hun bestaande inrichtingswerkstromen. De specificatie voor deze API's is beschikbaar op developer.webex.com. Als u wilt ontwikkelen met deze API's, neemt u contact op met uw Cisco-vertegenwoordiger om Webex voor Cisco BroadWorks op te halen.


 

Groothandels worden geweigerd door deze API's.

Doorstroominrichting

Op BroadWorks kunt u gebruikers inrichten met de optie Geïntegreerde IM&P inschakelen. Door deze actie voert de BroadWorks-inrichtingsadapter een API-oproep uit om de gebruiker in te richten op Webex. Onze provisioning-API is achterwaarts compatibel met de UC-One SaaS API. BroadWorks AS vereist geen codewijziging, alleen een configuratiewijziging naar het API-eindpunt voor de inrichtingsadapter.


 

Het inrichten van abonnees op Webex kan aanzienlijk duren (enkele minuten voor de eerste gebruiker binnen een onderneming). Webex voert de inrichting uit als een achtergrondtaak. Als de flowthrough-inrichting is geslaagd, geeft dit aan dat de inrichting is gestart. Het duidt niet op voltooiing.

Als u wilt bevestigen dat gebruikers en de klantorganisatie volledig zijn ingericht op Webex, moet u zich aanmelden bij Partner Hub en in uw lijst met klanten kijken.

BroadWorks-trunking-gebruikers kunnen Webex voor BroadWorks hebben via een gedeelde gespreksweergave (SCA). De trunking-gebruiker moet de verificatieservice hebben toegewezen. Zoals beschreven in de BroadWorks-handleiding voor trunking-oplossingen (Trunking Solution Guide) 8, kan de verificatie van de SCA Webex-weergave worden gescheiden van de algemene trunkverificatie. Webex voor BroadWorks kan niet worden ingericht voor trunking-gebruikers waaraan de functies Routelijst of Directe route zijn toegewezen.


 
De locatie van sjablonen is verplaatst van BroadWorks-gesprekken in de organisatie-instellingen naar het gedeelte Klantenlijst en wordt nu de onboardingsjabloon genoemd.

Zelfactivering van de gebruiker

BroadWorks-gebruikers inrichten in Webex zonder de geïntegreerde IM&P-service toe te wijzen:

  1. Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.

  2. Klik op Sjablonen weergeven.

  3. Selecteer de inrichtingssjabloon voor onboarding die u wilt toepassen op deze gebruiker.

    Vergeet niet dat elke sjabloon is gekoppeld aan een cluster en uw partnerorganisatie. Als de gebruiker zich niet in het BroadWorks-systeem bevindt dat aan deze sjabloon is gekoppeld, kan de gebruiker de koppeling niet zelf activeren.

  4. Kopieer de inrichtingskoppeling en verzend deze naar de gebruiker.

    U kunt ook de downloadkoppeling voor de software opnemen en de gebruiker eraan herinneren dat hij of zij zijn of haar e-mailadres moet opgeven en valideren om zijn of haar Webex-account te activeren.

  5. U kunt de activeringsstatus van de gebruiker op de geselecteerde sjabloon controleren.

Zie Gebruikersvoorzieningen en activeringsstromen voor meer informatie.

Inrichting met niet-vertrouwde e-mails

Partner Hub biedt een reeks besturingselementen in de weergave Gebruikersstatus waarmee Webex voor Cisco BroadWorks-serviceproviderbeheerders de gebruikersstatus kunnen controleren en fouten kunnen oplossen bij het inrichten van niet-vertrouwde e-mails. Zie Gebruikersvoorzieningen met niet-vertrouwde e-mails verifiëren voor meerinformatie.

Webex-gebruikers verplaatsen naar Webex voor Cisco BroadWorks

Als u bestaande Webex-gebruikers wilt verplaatsen naar Webex voor Cisco BroadWorks, raadpleegt u de onderstaande tabel om te bepalen welke procedure moet worden gevolgd.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfaanmelding (bv. gratis account, proefaccount)

  1. Inrichtingsgebruikers: als de Webex voor BroadWorks-organisatie niet bestaat (zonder dat er gebruikers zijn ingericht), volgt u de normale inrichting om de eerste gebruiker in te richten als beheerdersgebruiker en maakt u de organisatie. Hiermee wordt het Webex-gebruikersaccount automatisch verplaatst voor de eerste gebruiker. Gebruik de onderstaande procedure voor volgende gebruikers.

  2. Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks: als de Webex voor BroadWorks-organisatie bestaat (eerste gebruiker is ingericht), verkrijgt u toestemming van de gebruiker en verplaatst u volgende gebruikers.

Klantorganisatie

Webex voor BroadWorks toevoegen aan bestaande organisatie: de bijlage bij de organisatie (voor de eerste gebruiker) voegt ook Webex voor BroadWorks toe aan volgende gebruikers, zolang deze zijn toegewezen aan de juiste organisatie.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfaanmelding (bv. gratis account, proefaccount)

Als Webex voor BroadWorks-organisatie niet bestaat (er zijn geen gebruikers ingericht):

  • Inrichtingsgebruikers: volg de normale inrichting om de eerste gebruiker als een beheerdersgebruiker toe te voegen. Hiermee wordt het account voor de eerste gebruiker automatisch verplaatst en wordt de Webex for BroadWorks-organisatie gemaakt. Toestemming van de gebruiker is vereist om susbsequente gebruikers te verplaatsen (gebruik de onderstaande procedure).

Als Webex voor BroadWorks-organisatie bestaat (er is ten minste één gebruiker ingericht):

Klantorganisatie

Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks

Gebruik deze procedure om een bestaande Webex-gebruiker die zich in een consumentenorganisatie bevindt of een zelfaanmeldingsaccount heeft (gratis account of proefaccount) te verplaatsen naar Webex voor Cisco BroadWorks. Houd er rekening mee dat de Webex voor Cisco BroadWorks-organisatie moet bestaan (met de eerste gebruiker ingericht). In dit geval kunt u een van de volgende opties gebruiken om gebruikers te verplaatsen:

  • Gebruiker verplaatsen (met vertrouwde e-mail): gebruikt inrichting met vertrouwde e-mails

  • Gebruiker verplaatsen (met niet-vertrouwde e-mail): gebruikt inrichting met niet-vertrouwde e-mails

  • Zelfactivering


 
Als de Webex voor Cisco BroadWorks-organisatie nog niet is gemaakt (er zijn geen gebruikers ingericht), volgt u de normale inrichtingsprocessen (Inrichtingsgebruikers) om de organisatie te maken en de eerste gebruiker toe te voegen als een beheergebruiker. Nadat de eerste gebruiker is ingericht in de organisatie, volgt u de op toestemming gebaseerde methoden in deze procedure om volgende gebruikers te verplaatsen.

Gebruiker verplaatsen (met vertrouwd e-mailadres)

Als de onboardsjabloon vertrouwde e-mails gebruikt, kan de partnerbeheerder volgende gebruikers met dit proces verplaatsen:

  1. De beheerder voegt de gebruiker toe.

    • De gebruiker wordt gepusht naar de BroadWorks-inrichtingsbrug.

    • De CI-zoekopdracht bepaalt dat deze gebruiker een ander Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  2. De gebruiker opent de e-mail en klikt op Account activeren. De gebruiker wordt omgeleid naar de Webex-consumentenportal.

  3. Gebruiker meldt zich aan bij Webex.

  4. De gebruiker klikt op Verwijderen om het oude Webex-account te verwijderen.

    • Het oude Webex-account is verwijderd.

    • De gebruiker is ingericht in Webex voor Cisco BroadWorks met hetzelfde e-mailadres.

    • De gebruiker wordt omgeleid naar de pagina Downloaden.

Gebruiker verplaatsen (met niet-vertrouwde e-mail)

Als de onboardsjabloon niet-vertrouwde e-mails gebruikt, moet het e-mailadres van de gebruiker eerst worden gevalideerd. De beheerder kan dit proces volgen om volgende gebruikers te verplaatsen:

  1. De beheerder voegt de gebruiker toe.

    • De gebruiker wordt automatisch naar de BroadWorks-inrichtingsbrug gepusht.

    • Er wordt een tekst met een activeringskoppeling naar de gebruiker verzonden.

  2. De gebruiker klikt op de activeringskoppeling en voert het e-mailadres in.

    • De CI-zoekopdracht bepaalt dat deze gebruiker een ander Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op Nu deelnemen.

    • Het e-mailadres is gevalideerd.

    • De gebruiker wordt omgeleid om zich aan te melden bij de Webex-consumentenportal.

  4. Gebruiker meldt zich aan bij Webex.

  5. De gebruiker moet op Verwijderen klikken om het oude Webex-account te verwijderen.

    • Het oude Webex-account is verwijderd.

    • De gebruiker is ingericht in Webex voor Cisco BroadWorks met hetzelfde e-mailadres.

    • De gebruiker wordt omgeleid naar de pagina Downloaden.

Zelfactiveringsstroom

Als de gebruiker een bestaand BroadWorks-account heeft, kan hij of zij het zelfactiveringsproces gebruiken om zijn of haar account te verplaatsen.

  1. De gebruiker meldt zich aan bij de URL van de gebruikerstoegang met BroadWorks-aanmeldgegevens.

  2. De gebruiker voert zijn/haar e-mailadres in.

    • De gebruiker wordt gepusht naar de BroadWorks-inrichtingsbrug.

    • Er wordt een geautomatiseerd e-mailadres naar het e-mailadres van de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op de koppeling Nu deelnemen, waarmee het e-mailadres wordt gevalideerd.

    • CI zoekt gebruiker heeft een bestaand Webex-account. Gebruikers moeten het oude account verwijderen voordat ze kunnen doorgaan.

    • Gebruiker wordt omgeleid om zich aan te melden bij Webex.

  4. De gebruiker meldt zich aan bij de Consumentenportal.

  5. De gebruiker klikt op Account verwijderen.

    • Het oude Webex-account wordt verwijderd.

    • De gebruiker heeft een nieuw Webex voor Cisco BroadWorks-account met hetzelfde e-mailadres ingericht.

Webex voor BroadWorks toevoegen aan bestaande organisatie

Als u een partnerbeheerder bent die Webex voor BroadWorks-services toevoegt aan een bestaande Webex-klantorganisatie die nog niet is gekoppeld aan een door een partner beheerde BroadWorks-onderneming, MOET de beheerder van de klantorganisatie beheerderstoegang voor het inrichtingsverzoek goedkeuren om te slagen.

De goedkeuring van de organisatiebeheerder is vereist als een van de volgende situaties waar is:

  • De bestaande klantorganisatie heeft 100 gebruikers of meer

  • De organisatie heeft een geverifieerd e-maildomein

  • Het organisatiedomein is geclaimd

Als geen van de bovenstaande criteria waar is, kan een Automatic Attach optreden.


 
In een scenario met automatische bijlage wordt een Webex voor BroadWorks-abonnement toegevoegd aan een bestaande klantorganisatie zonder melding aan de bestaande organisatiebeheerder of eindgebruiker. In de meeste gevallen krijgt uw partnerorganisatie inrichtingsbeheerdersrechten. Als de klantorganisatie echter geen licenties heeft of alleen licenties heeft opgeschort/geannuleerd, wordt u een volledige beheerder gemaakt.

Met toegang tot de inrichtingsbeheerder hebt u beperkte zichtbaarheid in Control Hub voor de gebruikers in de bestaande organisatie. Het wordt aanbevolen dat u contact opneemt met de klantbeheerder en volledige beheerderstoegang tot de organisatie aanvraagt.

Partnerbeheerders kunnen de volgende procedure voltooien om BroadWorks-gespreksservices toe te voegen aan een bestaande Webex-organisatie:


 
Zorg ervoor dat de e-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties (de schakelaar is standaard ingeschakeld).
1

De partnerbeheerder richt Webex voor Cisco BroadWorks in voor de klant. Zie Inrichting van klantorganisaties voor hulp. Nu gebeurt het volgende:

  • Organisatiebijlage mislukt met een 2017 fout (Kan abonnee niet inrichten in een bestaande Webex-organisatie). (Er wordt geen fout ontvangen tijdens een automatische bijlage.)

  • Er wordt een e-mailmelding gegenereerd en verzonden naar de beheerders van de klantorganisatie (maximaal vijf beheerders). In de e-mailmelding wordt het e-mailadres van de partnerbeheerder gemarkeerd (zoals geconfigureerd in de sjabloon voor onboarding in Partner Hub) en wordt de organisatiebeheerder gevraagd de partnerbeheerder goed te keuren als externe beheerder. De klantorganisatiebeheerder moet het verzoek goedkeuren en de partnerbeheerder volledige beheerder toegang geven tot de klantorganisatie.


 

Stel dat de klantbeheerder geen e-mail ontvangt. In dat geval kan de klantbeheerder de partnerbeheerder (opgegeven in de sjabloon) handmatig toevoegen als de externe beheerder van de klantorganisatie vanuit de Control Hub. Probeer de gebruiker vervolgens opnieuw in te richten, waardoor de Webex voor Cisco BroadWorks-klantvoorziening wordt geactiveerd.

2

Met volledige beheerderstoegang kan de partnerbeheerder het proces voor het inrichten van de klant voltooien. Vanaf stap 1 hierboven moet u de inrichting van de klant opnieuw proberen. Nu u een externe Full Admin bent, mag u de fout 2017 echter niet waarnemen.

Zodra de inrichting van gespreksservices is voltooid, is de bestaande klantorganisatie zichtbaar als klant onder de partnerorganisatie van Webex voor BroadWorks.


 
De naam van de bijgevoegde organisatie verandert niet in de bedrijfsnaam van BroadWorks. De naam van de bijgevoegde organisatie blijft behouden zoals die was voorafgaand aan het bijvoegproces.

Voorwaarden van organisatiebijlage

  • Het e-mailadres van de eerste BroadWorks-abonnee die is ingericht, moet overeenkomen met het e-mailadres van een bestaande gebruiker in de beoogde klantorganisatie. Anders wordt een nieuwe klantorganisatie gemaakt.

  • De eerste gebruiker van de bestaande organisatie die is ingericht voor Webex voor BroadWorks, is niet ingericht als beheerdersgebruiker. Instellingen en rechten van de bestaande organisatie worden behouden.

  • De bestaande verificatie-instellingen van de organisatie hebben voorrang op wat is geconfigureerd op de Webex for BroadWorks-inrichtingssjabloon. Als gevolg hiervan verandert er niets aan de manier waarop bestaande gebruikers zich aanmelden.

    • Als de bestaande klantorganisatie echter basisbranding heeft ingeschakeld, hebben de geavanceerde branding-instellingen van de partner voorrang nadat de bijvoeging plaatsvindt. Als de klant wil dat de basisbranding intact blijft, moet de partner de klantorganisatie configureren om de branding in de instellingen voor geavanceerde branding te overschrijven.

  • De naam van de bestaande organisatie wordt niet gewijzigd.

  • Er is geen wijziging in de vlaggen voor e-mailonderdrukking in de instellingen van de bestaande organisatie. Dit kan van invloed zijn op nieuw ingerichte gebruikers. Afhankelijk van hoe de vlag is ingesteld, ontvangen nieuwe gebruikers al dan niet een e-mail met een code die moet worden ingevoerd om de activering te voltooien.

  • De beperkte beheermodus (ingesteld door de schakelaar voor beperkte partnermodus) is uitgeschakeld voor de bijgevoegde organisatie.

  • Zorg ervoor dat u het bevestigingsproces voor de organisatie voltooit (bestaande gebruikers verplaatsen en de organisatie-id bijwerken) voordat u nieuwe gebruikers inricht in de Webex voor Cisco BroadWorks-organisatie.

  • Een BroadWorks-onderneming kan slechts aan één Webex-organisatie worden gekoppeld. U kunt abonnees van één BroadWorks-onderneming niet inrichten in afzonderlijke Webex-organisaties.

Externe beheerder toevoegen

Zie het artikel Aanvraag externe beheerder goedkeuren voor de stappen die klantorganisatiebeheerders kunnen volgen om de partnerbeheerder toe te voegen als externe beheerder op help.webex.com.


 
De klantbeheerder moet de externe beheerder de volledige beheerdersrechten en -rechten geven.

 
Het e-mailadres dat de beheerder van de klantorganisatie als externe beheerder toevoegt, moet overeenkomen met het e-mailadres van de partnerbeheerder zoals is geconfigureerd in de sjabloon voor onboarding op Partner Hub.

Nadat u de e-mail van het onboardsjabloon op Partnerhub hebt toegevoegd als volledige beheerder, moeten eventuele extra partnerbeheerders ook worden toegevoegd als externe beheerder met volledige beheerdersrechten.

Webex voor BroadWorks loskoppelen van bestaande organisatie

Volg deze stappen om Webex voor BroadWorks los te koppelen van een bestaande Webex-organisatie. Als u bijvoorbeeld per ongeluk Webex voor BroadWorks aan een bestaande organisatie hebt gekoppeld en de bijlage wilt verwijderen.


 

Als u in Standaardstroom Webex voor BroadWorks loskoppelt van een bestaande Webex-organisatie (alleen standaardstroom), worden alle bijbehorende abonneegegevens verwijderd en wordt het Webex voor BroadWorks-abonnement van de klant gedeactiveerd. U verliest ook de toegang tot de klantorganisatie als dit het enige gekoppelde abonnement is. In de hybride stroom worden de klantabonnementen niet gewijzigd.

  1. Als u geen toegang hebt tot de klantinstellingen in Control Hub, laat de klantbeheerder u externe beheerder dan toegang verlenen door het verzoek van externe beheerder goed te keuren.

  2. Verwijder alle Webex voor BroadWorks-werkplekken uit de organisatie. Gebruik de API Een BroadWorks-werkplek verwijderen.

  3. Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de API Een BroadWorks-abonnee verwijderen.

  4. Verwijder in behandeling zijnde Webex voor BroadWorks-gebruikers uit de organisatie. Als gebruikers bijvoorbeeld zijn ingericht via de niet-vertrouwde e-mailstroom en er nog geen geldige e-mails zijn ingevoerd, blijven de gebruikers in behandeling. Volg Gebruikersvoorzieningen verifiëren met niet-vertrouwde e-mails om de gebruikers te verwijderen.

  5. Verwijder de configuratie van BroadWorks Calling voor deze klant. Open het Control Hub-exemplaar van de klant en klik op Hybrid onder het gedeelte BroadWorks Calling om alle configuraties te verwijderen.

Als u na de onthechting Webex voor BroadWorks aan de klant wilt koppelen, volgt u de inrichtingsprocessen om deze aan een bestaande klant te koppelen.


 
Een alternatieve optie om abonnees te verwijderen als u de API Een BroadWorks-abonnee verwijderen niet wilt gebruiken, is om naar BroadWorks CommPilot te gaan en de geïntegreerde IM&P-service voor de betrokken gebruikers te verwijderen.

Gebruikers en organisaties beheren

Als u gebruikers in Webex voor Cisco BroadWorks wilt beheren, moet u bedenken dat de gebruiker zowel in BroadWorks als in Webex bestaat. Belattributen en de BroadWorks-identiteit van de gebruiker worden in BroadWorks gehouden. Een afzonderlijke e-mailidentiteit voor de gebruiker en de licenties voor Webex-functies worden in Webex bewaard.

Gebruikersvoorzieningen verifiëren met niet-vertrouwde e-mails

Als u Webex voor BroadWorks-gebruikers inricht via doorstroominrichting met niet-vertrouwde e-mails, moeten gebruikers zichzelf inrichten door hun e-mailadres in de portal voor gebruikersactivering in te voeren. Als er een fout optreedt, kan de gebruiker de optie Opnieuw proberen gebruiken die in de portal wordt weergegeven om een nieuwe poging te doen. Als de gebruiker de fout opnieuw ondervindt, kan de beheerder de onderstaande stappen in Partner Hub gebruiken om de status te controleren en de gebruiker te onboarden, de gebruiker te verwijderen of configuratiewijzigingen toe te passen.

1

Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.

2

Klik op Sjablonen weergeven. Selecteer de juiste onboardsjabloon die u wilt toepassen op deze gebruiker.

3

Controleer onder Gebruikersverificatie of de volgende instellingen zijn ingesteld om ervoor te zorgen dat doorstroominrichting met niet-vertrouwde e-mails correct is geconfigureerd:

  • De optie Niet-vertrouwde e-mails moet zijn ingeschakeld
  • Het veld Koppeling delen moet naar de activeringskoppeling verwijzen. Als alles is geconfigureerd, kunnen gebruikers proberen zichzelf in te richten via de User Activation Portal.
4

Nadat de gebruiker is ingericht, klikt u in het gedeelte Gebruikersverificatie op Gebruikersstatus weergeven om de inrichtingsstatus te controleren.

In de weergave Gebruikersstatus wordt de lijst met gebruikers weergegeven, samen met details zoals de BroadWorks-id, het geselecteerde pakkettype en de huidige status. Deze weergave geeft aan of de gebruiker is ingericht of dat er een vereiste in behandeling is.
5

Voor gebruikers met fouten of vereisten in behandeling, klikt u op de drie stippen aan de rechterkant en kiest u een van de volgende beheeropties:

  • Activering opnieuw proberen: klik op deze optie om opnieuw te proberen de gebruiker te onboarden. Voer in het pop-upvenster een geldig e-mailadres in en klik op Onboard.
  • Gebruiker verwijderen: deze optie is mogelijk van toepassing als u de configuratie moet wijzigen om onboarding toe te staan. Nadat u de gebruiker hebt verwijderd en uw wijzigingen hebt aangebracht, kan de gebruiker opnieuw proberen te onboarden.
  • Pakkettype wijzigen: wijzig de instelling van het ene pakket naar het andere:
  • Fouttekst kopiëren: klik op deze optie om de fouttekst te kopiëren.

Aanvullende weergaveopties

De volgende extra opties zijn beschikbaar wanneer u de lijst met gebruikers bekijkt:

  • Exporteren: klik op deze knop als u de gebruikerslijst wilt exporteren naar een CSV-bestand.

  • Ingerichte gebruikers uitsluiten: schakel deze schakelaar in als u alleen gebruikers met vereisten of fouten in behandeling wilt weergeven.

Gebruikers-id of e-mailadres wijzigen

Wijzigingen gebruikers-id en e-mailadres

E-mail-id en alternatieve id zijn de BroadWorks-gebruikerskenmerken die worden gebruikt met Webex voor Cisco BroadWorks. De BroadWorks-gebruikers-id is nog steeds de primaire id van de gebruiker in BroadWorks. In de volgende tabel worden de doelstellingen van deze verschillende kenmerken beschreven en wordt beschreven wat u moet doen als u ze moet wijzigen:

Kenmerk in BroadWorksOvereenkomstig kenmerk in WebexDoelNotities
BroadWorks-gebruikers-idGeenPrimaire idU kunt deze id niet wijzigen en de gebruiker nog steeds aan hetzelfde account in Webex koppelen. U kunt de gebruiker verwijderen en opnieuw maken als dit onjuist is.
E-mail-idGebruikers-id

Verplicht voor doorstroominrichting (maken van Webex-gebruikers-id) wanneer u aangeeft dat u e-mail vertrouwt

Niet vereist in BroadWorks als u niet beweert dat u e-mails kunt vertrouwen

Niet vereist in BroadWorks als u abonnees toestaat zichzelf te activeren

Er is een handmatig proces om dit op beide plaatsen te wijzigen als de gebruiker het verkeerde e-mailadres heeft gekregen:

  1. Het e-mailadres van de gebruiker wijzigen in Control Hub

  2. E-mail-id-kenmerk wijzigen in BroadWorks

Wijzig de BroadWorks-gebruikers-id niet. Dit wordt niet ondersteund.

Alternatieve idGeenHiermee schakelt u het authn van de gebruiker in, via e-mail en wachtwoord, met de BroadWorks-gebruikers-idMoet hetzelfde zijn als de e-mail-id. Als U het e-mailadres niet in het kenmerk Alternatieve id kunt plaatsen, moeten gebruikers hun BroadWorks-gebruikers-id invoeren bij de verificatie.

Gebruikerspakket wijzigen in Partner Hub

1

Meld u aan bij Partner Hub en klik op Klanten.

2

Zoek en selecteer de klantorganisatie waar de gebruiker is gehuisvest.

De overzichtspagina van de organisatie wordt geopend in een deelvenster aan de rechterkant van het scherm.

3

Klik op Klant weergeven.

De klantorganisatie wordt geopend in Control Hub en toont de pagina Overzicht.
4

Klik op Users, zoek en klik op de getroffen gebruiker.

5

Klik in de Services van de gebruiker op Webex voor BroadWorks-pakketten (abonnementen).

Het deelvenster Pakketten van de gebruiker wordt geopend en u kunt zien welk pakket momenteel aan de gebruiker is toegewezen.

6

Kijk in het tabblad Profiel in het gedeelte Pakket en klik op het pijltje (>) om de weergave uit te vouwen.

7

Selecteer het gewenste pakket voor deze gebruiker (Basic, Standard, Premium of Softphone) en klik op Save.

Control Hub toont een bericht dat de gebruiker bijwerkt.

8

U kunt de gebruikersgegevens en het tabblad Control Hub sluiten.


 
Standaard- en Premium-pakketten hebben verschillende vergadersites die bij elk pakket horen. Wanneer een abonnee met beheerdersrechten met een van deze twee pakketten naar het andere pakket gaat, wordt de abonnee weergegeven met twee vergadersites in Control Hub. De vergaderingsmogelijkheden en vergaderingssite van de abonnee komen overeen met het huidige pakket. De vergadersite van het vorige pakket en alle eerder gemaakte inhoud op die site, zoals opnamen, blijven toegankelijk voor de sitebeheerder van de vergadering.

 
Het kan twee tot drie uur duren voordat nieuwe PMR-instellingen die het gevolg zijn van een pakketwijziging, worden bijgewerkt.

Gebruikers verwijderen

Er zijn verschillende methoden die beheerders kunnen gebruiken om een gebruiker te verwijderen uit Webex voor Cisco BroadWorks:


 
Als de gebruiker die u gaat verwijderen beheerdersrechten heeft, wijst u een nieuwe beheerder toe voordat u de gebruiker verwijdert. Er is geen automatische overdracht van de beheerdersrol als de laatste beheerder wordt verwijderd.

Webex voor Cisco BroadWorks API

Partnerbeheerders kunnen de Webex for Cisco BroadWorks API gebruiken om gebruikers te verwijderen:

  1. Voer de Remove a BroadWorks Subscriber API-aanvraag uit op https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Met deze aanvraag wordt het Webex for Cisco BroadWorks-abonnement verwijderd. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt behandeld als een gratis Webex-gebruiker.

  2. Voer het API-verzoek Een persoon verwijderen uit op https://developer.webex.com/docs/api/v1/people/delete-a-person om de gebruiker volledig te verwijderen.

Doorstroominrichting

Partnerbeheerders kunnen doorstroominrichting gebruiken om gebruikers te verwijderen:

  1. Op de BroadWorks-server verwijdert u de geïntegreerde IM+P-service van de gebruiker. U kunt de service voor de gebruiker uitschakelen via de pagina User – Integrated IM&P op BroadWorks. Zie 'Geïntegreerde IM&P configureren' in de Beheerhandleiding voor de webinterface van de Cisco BroadWorks-toepassingsservergroep – deel 2 voor een gedetailleerde procedure.

    Nadat de service is uitgeschakeld, verwijdert doorstroominrichting de Webex voor Cisco BroadWorks-susbscription van de gebruiker. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt behandeld als een gratis Webex-gebruiker.

  2. Zoek en selecteer de gebruiker in Control Hub.

  3. Ga naar Actions en selecteer Delete User.

Control Hub (klantbeheerders)

Klantbeheerders kunnen Control Hub gebruiken om gebruikers uit hun organisatie te verwijderen. Zie Een gebruiker uit uw organisatie verwijderen in Webex Control Hub op https://help.webex.com/0qse04/ voor meer informatie.

Organisatie verwijderen

Volg deze procedure om een Webex voor Cisco BroadWorks-organisatie uit het systeem te verwijderen.
1

Gebruik de People API's om alle gebruikers uit de organisatie te verwijderen:

  1. Voer de API Personen weergeven uit om een lijst met gebruikers op te halen.

  2. Voer de API Een persoon verwijderen uit om de gebruikers te verwijderen.


 
Met de Een BroadWorks-abonnee-API verwijderen worden Webex voor Cisco BroadWorks-rechten van een gebruiker verwijderd, maar wordt de gebruiker niet verwijderd.
2

Als adreslijstsynchronisatie is ingeschakeld, schakelt u deze uit. Dit kan via Partner Hub of via de openbare API.

Adreslijstsynchronisatie uitschakelen via Partner Hub:

  1. Meld u aan bij Partner Hub en klik op Instellingen.

  2. Klik onder BroadWorks Calling op Sjablonen weergeven en selecteer de juiste sjabloon.

  3. Klik op de knop Toon statuslijst klantsynchronisatie in het zijpaneel.

  4. Voor de juiste klant klikt u op de drie stippen helemaal rechts en selecteert u Synchronisatie uitschakelen.

Als u adreslijstsynchronisatie via API wilt uitschakelen, gebruikt u Adreslijstsynchronisatie voor een BroadWorks Enterprise-API bijwerken en schakelt u de instelling enableDirSync uit.

Alle gebruikers met betrekking tot BroadWorks-adreslijstsynchronisatie voor deze organisatie worden verwijderd. Houd er rekening mee dat het verwijderen van gebruikers (met behulp van een van beide methoden) enige tijd kan duren, afhankelijk van de hoeveelheid gebruikers.

3

Nadat alle gebruikers zijn verwijderd, gebruikt u de API Een organisatie verwijderen om de organisatie te verwijderen.

Vrijgavebeheer

Bedieningselementen voor releasebeheer in Partner Hub maken het eenvoudig voor Webex voor Cisco BroadWorks-serviceproviders om releases te beheren door hen de mogelijkheid te geven de releasecadans te beheren waarmee de Webex-apps van gebruikers upgraden naar de nieuwste software.

De Webex-app maakt standaard gebruik van automatische upgrades (door Cisco beheerde maandelijkse versies). Met deze functie kunnen partnerbeheerders echter:

  • Aangepaste releaseschema's configureren met uitstel van de standaardreleaseschema's van Cisco

  • Configureer één releaseschema en trapsgewijs die planning naar alle klantorganisaties die ze beheren

  • Verschillende releaseschema's toewijzen aan verschillende klantorganisaties

Zie het Webex-artikel Aanpassingen voor releasebeheer voor meer informatie over releasebeheer, waaronder informatie over het configureren en toepassen van aangepaste releaseplanningen.

Het systeem opnieuw configureren

U kunt het systeem als volgt opnieuw configureren:

  • Een BroadWorks-cluster toevoegen in Partner Hub

  • Een BroadWorks-cluster bewerken of verwijderen in Partnerhub

  • Een onboardingsjabloon toevoegen in Partner Hub

  • Een onboardsjabloon bewerken of verwijderen in Partner Hub

Een BroadWorks-cluster bewerken of verwijderen in Partnerhub

U kunt een BroadWorks-cluster bewerken of verwijderen in Partnerhub.

1

Meld u aan bij Partner Hub met uw partnerbeheergegevens op https://admin.webex.com.

2

Ga naar Instellingen en zoek het gedeelte BroadWorks-gesprekken.

3

Klik op Clusters weergeven.

4

Klik op het cluster dat u wilt bewerken of verwijderen.

De clusterdetails worden weergegeven in een flyout-venster aan de rechterkant.
5

U hebt de volgende opties:

  • Wijzig de gegevens die u moet wijzigen en klik op Opslaan.
  • Klik op Verwijderen om het cluster te verwijderen en bevestig.

     

    Als er veel klanten (>50) in het BroadWorks-cluster zijn, worden bewerkingen zoals het bijwerken van XSI-acties, XSI-gebeurtenissen, DAS-URL, XSP|ADP-URL of NST-synchronisatie niet ondersteund. In dergelijke gevallen wordt het aanbevolen contact op te nemen met een Cisco TAC-ondersteuningsmedewerker voor ondersteuning.

    Als een sjabloon is gekoppeld aan het cluster, kunt u een cluster niet verwijderen. Verwijder de gekoppelde sjablonen voordat u het cluster verwijdert. Zie Een onboardsjabloon bewerken of verwijderen in Partnerhub.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Een onboardsjabloon bewerken of verwijderen in Partner Hub

U kunt sjablonen voor onboarding bewerken of verwijderen in Partner Hub.

1

Meld u aan bij Partner Hub met uw partnerbeheergegevens op https://admin.webex.com.

2

Ga naar Instellingen en zoek het gedeelte BroadWorks-gesprekken.

3

Klik op Sjablonen weergeven.

4

Klik op de sjabloon die u wilt bewerken of verwijderen.

5

U hebt de volgende opties:

  • Bewerk de gegevens die u moet wijzigen en klik op Opslaan.
  • Klik op Verwijderen om de sjabloon te verwijderen en bevestig.

Instelling

Waarden

Notities

Accountnaam/wachtwoord inrichten

Door gebruiker geleverde tekenreeksen

U hoeft de inrichtingsaccountgegevens niet opnieuw in te voeren bij het bewerken van een sjabloon. De velden Leeg wachtwoord/Wachtwoordbevestiging zijn er om de referenties te wijzigen als dat nodig is, maar laat ze leeg om de waarden te behouden die u oorspronkelijk hebt opgegeven.

E-mailadres van de gebruiker vooraf invullen op de aanmeldpagina

Aan/uit

Het kan tot 7 uur duren voordat een wijziging in deze instelling van kracht wordt. Dat wil zeggen, nadat u deze hebt ingeschakeld, moeten gebruikers mogelijk nog steeds hun e-mailadres invoeren op het aanmeldscherm.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Webex Assistant

Webex-assistent Meetings is een intelligente, interactieve virtuele vergaderingassistent die vergaderingen doorzoekbaar, actiebaar en productiever maakt. U kunt de Webex Assistant vragen actie-items op te volgen, belangrijke beslissingen te nemen en belangrijke momenten tijdens een vergadering of gebeurtenis te markeren.

Webex Assistant voor vergaderingen is gratis beschikbaar voor vergadersites met het Premium- en Standard-pakket en voor persoonlijke vergaderruimten. Support omvat zowel nieuwe als bestaande sites.

Webex Assistant voor vergaderingen inschakelen

Webex Assistant is standaard ingeschakeld voor zowel Standard- als Premium-pakket Broadworks-klanten.

Partnerbeheerders en klantorganisatiebeheerders kunnen de functie voor klantorganisaties uitschakelen via Control Hub.

Beperkingen

De volgende beperkingen bestaan voor Webex voor Cisco BroadWorks:

  • De ondersteuning is beperkt tot vergadersites met het Premium- en Standard-pakket en alleen persoonlijke vergaderruimten.

  • Transcripties voor ondertiteling worden alleen ondersteund in het Engels, Spaans, Frans en Duits.

  • Inhoud delen via e-mail is alleen toegankelijk voor gebruikers binnen uw organisatie

  • Vergaderingsinhoud is niet toegankelijk voor gebruikers buiten uw organisatie. Vergaderingsinhoud is ook niet toegankelijk wanneer deze wordt gedeeld tussen gebruikers van verschillende pakketten binnen dezelfde organisatie.

  • Met het Premium-pakket zijn transcripties na de vergadering beschikbaar, ongeacht of Webex Assistant is in- of uitgeschakeld. Als er echter lokale opname is geselecteerd, worden er geen transcripties of markeringen na de vergadering vastgelegd.

  • Met het standaardpakket is de optie Vergadering opnemen in de cloud niet beschikbaar en zijn transcripties na de vergadering dus niet beschikbaar, ongeacht of Webex Assistant is in- of uitgeschakeld. Als lokale opname is geselecteerd, worden zelfs transcripties of markeringen na de vergadering niet vastgelegd.

Aanvullende Informatie Over Webex Assistant

Zie Webex Assistant gebruiken in Webex Meetings en Events voor gebruikersinformatie over het gebruik van de functie.

Webex-gesprekken uitschakelen

Gratis bellen via Webex is standaard ingeschakeld zodat gebruikers gratis gesprekken kunnen voeren naar elk apparaat waarvoor Webex is ingeschakeld. Als u echter wilt dat alle gesprekken de BroadWorks-infrastructuur gebruiken, kunt u Webex-gesprekken binnen een onboardsjabloon uitschakelen. Hiermee schakelt u die optie uit voor de klantorganisaties die de sjabloon gebruiken.

Functieondersteuning

Wanneer Webex Calling is uitgeschakeld, zijn de volgende voorwaarden van toepassing op Webex voor Cisco BroadWorks-gebruikers:

  • Gebruikers zien Bellen met Webex niet meer als een selecteerbare gespreksoptie in de Webex-app.

  • Gebruikers kunnen geen gratis Webex-gesprekken plaatsen of ontvangen naar niet-Webex voor Cisco BroadWorks-gebruikers. Dit omvat gesprekken die zijn gestart vanuit een Webex-teamruimte, gespreksgeschiedenis, contactpersonen door de URI of het e-mailadres van de andere gebruiker in te voeren in de zoekbalk.

  • Scherm delen werkt binnen een BroadWorks-gesprek.

  • Webex-vergaderingen en telefonische aanwezigheid werken nog steeds, zelfs als Webex-gesprekken zijn uitgeschakeld.

Webex-gesprekken uitschakelen (nieuwe onboardsjabloon)

Tijdens het configureren van een nieuwe onboardsjabloon kunt u configureren of Webex-gesprekken worden in- of uitgeschakeld door het selectievakje Gratis bellen via Cisco Webex uitschakelen in de wizard Een nieuwe sjabloon toevoegen in te schakelen of uit te schakelen. Deze instelling wordt opgehaald voor gebruikers in klantorganisaties die u aan de sjabloon toewijst.

Zie Uw partnerorganisatie configureren in Partner Hub voor meer informatie over het configureren van een nieuwe integratiesjabloon.

Webex-gesprekken uitschakelen (bestaande onboardsjabloon)

Volg deze procedure om Webex-gesprekken uit te schakelen van een bestaande integratiesjabloon. Hiermee wordt de functie uitgeschakeld voor alle nieuwe gebruikers in klantorganisaties die deze sjabloon gebruiken.

  1. Meld u aan bij Partnerhub op admin.webex.com.

  2. Kies Instellingen.

  3. Klik op Sjabloon weergeven en kies de juiste onboardingsjabloon.

  4. Klik op Cisco Webex Free Calling uitschakelen.

  5. Klik op Opslaan.

Webex-gesprekken uitschakelen (bestaande gebruiker)

Als u deze functie uitschakelt op een onboardsjabloon, wordt de instelling alleen gewijzigd voor nieuwe gebruikers die zijn toegewezen aan de sjabloon. Als u Webex-gesprekken wilt uitschakelen voor een bestaande gebruiker, kunt u een van de onderstaande procedures volgen om de gebruiker bij te werken.


 
Zorg ervoor dat u al een van de bovenstaande procedures hebt voltooid om Webex-gesprekken uit te schakelen van de onboardsjabloon waaraan de gebruiker is toegewezen. Anders configureert een van de onderstaande procedures de gebruiker opnieuw met Webex-gesprekken ingeschakeld.

Als u flow-through provisioning gebruikt, kunt u het volgende doen:

  1. Open CommPilot en ga naar de gebruikersconfiguratie.

  2. Verwijder de geïntegreerde IM+P-service van de gebruiker en klik op OK.

  3. Voeg de geïntegreerde IM+P-service toe aan de gebruiker en klik op OK.

Anders kunt u de API gebruiken om de gebruiker bij te werken.

  1. Gebruik de Een BroadWorks-abonnee-API verwijderen om de gebruiker te verwijderen.

  2. Gebruik de Een BroadWorks-abonnee-API inrichten om de gebruiker toe te voegen.

Video of scherm delen uitschakelen in gesprekken

Partnerbeheerders kunnen configuratietags gebruiken om videogesprekken en/of scherm delen uit te schakelen in een gesprek vanuit de Webex-app (beide mediatypen zijn standaard ingeschakeld voor gesprekken).

Zie Videogesprekken uitschakelen en Scherm delen uitschakelen in de configuratiehandleiding van Webex voor Cisco BroadWorks voor meer informatie over de configuratie en opties.


 
Voor video kunt u ook configureren of media voor inkomende gesprekken standaard alleen video of audio zijn.

Busy Lamp Field (BLF)/melding voor gesprek opnemen

Busy Lamp Field (BLF)/melding voor gesprek opnemen maakt gebruik van de functies BLF en doorverbonden gesprek opnemen. Een BLF-gebruiker ontvangt een auditieve en visuele melding in de Webex-app wanneer een gebruiker uit de BLF-bewaakte lijst een binnenkomend gesprek ontvangt. De BLF-gebruiker kan het gesprek van de gecontroleerde gebruiker negeren of opnemen.

De BLF-/Call Pickup-melding helpt in situaties waarin een gebruiker gesprekken moet beantwoorden voor andere teamleden die op een andere locatie werken.

Gebruikers kunnen hun door BLF gecontroleerde lijst ook zien in het gedeelte Multi-gespreksvenster - Wachtlijst - (alleen Windows, Mac niet ondersteund) om de aanwezigheid van hun Webex- en niet-Webex-teamleden te zien. Webex-leden hebben een volledige Webex-aanwezigheid. Niet-Webex-leden moeten worden gesynchroniseerd met een telefoonlijst in Webex. Ze hebben alleen de status 'onbekend' en 'in-a-call' (de belstatus activeert het dialoogvenster voor gesprek opnemen).

Beperkingen van aanwezigheid voor niet-Webex-gebruikers:

  1. Aanwezigheid wordt niet ondersteund voor niet-CI Broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.

  2. CI-gebruikers zonder Webex-cloudrechten of computertype accounts (werkplekken) geven alleen aanwezigheid 'in gesprek' en 'onbekend' weer. Er is geen status actief, overgaan, enz.

  3. Niet-Webex-gebruikers uit de BLF-volglijst, die een gesprek hebben gestart voordat de Webex-client werd gestart of terwijl deze offline was, worden weergegeven met een 'onbekende' aanwezigheid.

  4. Als u uw verbinding verliest, worden alle niet-Webex-gespreksstatussen bij het opnieuw verbinden teruggezet op 'onbekend'.

  5. Als een niet-Webex-gebruiker van de BLF een gesprek heeft, wordt dit gesprek nog steeds weergegeven als 'in een gesprek'.

Vereisten

Zorg ervoor dat de volgende patches worden toegepast op BroadWorks. Installeer alleen de patches die van toepassing zijn op uw versie:

Voor R22:

  • AP.platform.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382362

  • AP.xsp.22.0.1123.ap382053

  • AP.xsp.22.0.1123.ap382362

  • AP.as.22.0.1123.ap383459

  • AP.as.22.0.1123.ap383520

Voor R23:

  • AP.platform.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382362

  • AP.as.23.0.1075.ap383459

  • AP.as.23.0.1075.ap383520

  • Als u XSP|ADP gebruikt:

    • AP.xsp.23.0.1075.ap382053

    • AP.xsp.23.0.1075.ap382362

  • Als u ADP gebruikt:

    • Xsi-Actions-23_2022.01_1.200.bwar

    • Xsi-Events-23_2022.01_1.201.bwar (of hoger)

Voor R24:

  • AP.as.24.0.944.ap382053

  • AP.as.24.0.944.ap382362

  • AP.as.24.0.944.ap383459

  • AP.as.24.0.944. ap383520

  • Xsi-Actions-24_2022.01_1.200.bwar

  • Xsi-Events-24_2022.01_1.201.bwar (of hoger)

Zorg ervoor dat de volgende configuratietags zijn ingeschakeld in de Webex-app:

  • <busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">

  • <display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>

  • <notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>(deze tag is optioneel)

U moet functie 101642 Verbeterd Xsi-mechanisme Voor Teamtelefonie activeren op de AS:

AS_CLI/System/ActivatableFeature> activate 101642

Inschakelen X-BroadWorks-Remote-Party-Info op de AS met de onderstaande CLI-opdracht omdat voor sommige SIP-gespreksstromen deze functie nodig is:

AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Zorg ervoor dat de volgende services zijn toegewezen aan gebruikers:

  • De service Doorverbonden gesprek aannemen toewijzen voor alle gebruikers

  • Busy Lamp Field instellen voor gebruikers


 
Elke verwijzing naar XSP omvat XSP of ADP.

Busy Lamp Field configureren op BroadWorks

Partnerbeheerders kunnen de volgende procedure gebruiken om Busy Lamp Field in te stellen voor een gebruiker.

  1. Meld u aan bij BroadWorks CommPilot.

  2. Ga voor een geselecteerde gebruiker naar Clienttoepassingen en configureer het Busy Lamp Field.

  3. Voeg de URL van de BLF-lijst toe die wordt gecontroleerd.

  4. Gebruik de zoekparameters om gebruikers te zoeken en toe te voegen aan de lijst Bewaakte gebruikers.

  5. Klik op OK.

Slido Integratieondersteuning

Webex voor Cisco BroadWorks ondersteunt integratie van de Webex-app met Slido.

Slido is een eenvoudig te gebruiken tool voor betrokkenheid van het publiek. Het helpt mensen om het meeste uit vergaderingen te halen door de kloof tussen sprekers en hun publiek te overbruggen. Wanneer Slido is geïntegreerd in uw Control Hub-organisatie, kunnen uw gebruikers de Slido app toevoegen aan hun vergaderingen in de Webex-app. Deze integratie biedt extra vraag en antwoord en enquêtefunctionaliteit voor de vergadering.

Zie SlidoIntegreren met Webex-appSlido voor meer informatie over het implementeren en gebruiken met de Webex-app.

Webex-beschikbaarheid: In een agendavergadering

Wanneer u een vergadering in uw Outlook-client hebt geaccepteerd die een afspraak, ad-hocvergadering of een niet-Webex-vergadering is, wordt uw Webex-beschikbaarheid weergegeven als 'In een agendavergadering'. Deze beschikbaarheid laat uw collega's weten dat u anders betrokken bent en dat een reactie kan worden vertraagd.

Deze functie inschakelen:

  1. ga naar het tabblad Algemeen van uw tabblad Instellingen in Windows of Voorkeuren op de Mac.

  2. Schakel het selectievakje Weergeven in een agendavergadering in.


 
Voor gebruikers met ingeschakelde Outlook-aanwezigheidsintegratie wordt 'In een agendavergadering' in Webex toegewezen aan 'Bezet' in Outlook.

Caveat

Om deze functie te laten werken, moet de Webex-app en de Outlook-client tegelijkertijd worden uitgevoerd.

We werken momenteel aan de ondersteuning van de optie 'Show as Working Elsewhere' in Outlook om een gebruiker niet weer te geven als 'In een agendavergadering' in Webex.

Als een gebruiker ervoor kiest om 'Weergeven wanneer in een agendavergadering' uit te schakelen terwijl hij of zij momenteel in een agendavergadering zit, wordt zijn of haar aanwezigheid pas bijgewerkt wanneer de vergadering is beëindigd. Hiervoor moet de client opnieuw worden gestart om op te halen.

Automatisch beantwoorden met toon

Met automatisch beantwoorden met toon kunnen gebruikers bellen vanuit een app van derden, zoals Contact Center, en wordt het gesprek automatisch gerouteerd via de Webex-app op hun bureaublad. Wanneer de Webex-app de andere partij belt, hoort de gebruiker een bepaalde toon met het advies dat het gesprek wordt verbonden.

Voor een Webex voor Cisco BroadWorks-gebruiker om deze functie te gebruiken:

  • De functie wordt alleen ondersteund op de weergave van de primaire lijn

  • De Webex-app moet de primaire lijnweergave zijn

  • De %ENABLE_AUTO_ANSWER_WXT%-tag moet zijn ingeschakeld

Als de gebruiker ook Gedeelde gespreksweergaven heeft (een bureautelefoon wordt bijvoorbeeld geconfigureerd als een van de weergaven van de secundaire lijn), wordt de functie nog steeds ondersteund op de primaire weergave zolang de weergaven van gedeelde gesprekken zijn geconfigureerd om geen inkomende gesprekken te ontvangen. Dit kan worden bereikt door een van de volgende drie voorwaarden te configureren in BroadWorks voor alle gedeelde gespreksweergaven:

  • Alle weergaven voor Click-to-Dial-gesprekken waarschuwen is uitgeschakeld in de configuratie voor weergave gedeeld gesprek. Dit is de aanbevolen aanpak

    of

  • Beëindiging toestaan op deze locatie moet zijn uitgeschakeld voor alle gedeelde gespreksweergaven of

    of

  • Locaties zijn uitgeschakeld voor alle weergaven van gedeelde gesprekken

Capaciteit verhogen

XSP|ADP-bedrijven

We raden u aan de capaciteitsplanner te gebruiken om te bepalen hoeveel extra XSP|ADP-resources u nodig hebt voor de voorgestelde toename van het aantal abonnees. Voor de speciale NPS of Webex voor Cisco BroadWorks-boerderijen hebt u de volgende schaalbaarheidsopties:

  • Schaalspecifieke boerderij: Voeg een of meer XSP|ADP-servers toe aan het bedrijf die extra capaciteit nodig hebben. Installeer en activeer dezelfde set toepassingen en configuraties als de bestaande knooppunten van de boerderij.

  • Specifieke boerderij toevoegen: Voeg een nieuwe, specifieke XSP|ADP-boerderij toe. U moet een nieuw cluster en nieuwe sjablonen maken in Partner Hub, zodat u nieuwe klanten kunt toevoegen op de nieuwe boerderij om de druk op de bestaande boerderij te verlichten.

  • Gespecialiseerde boerderij toevoegen: Als u knelpunten ondervindt voor een bepaalde service, wilt u mogelijk een afzonderlijke XSP|ADP-farm creëren voor dat doel, rekening houdend met de vereisten voor co-residency vermeld in dit document. Mogelijk moet u uw Control Hub-clusters en DNS-vermeldingen opnieuw configureren als u de URL wijzigt van de service met een nieuwe boerderij.

In alle gevallen is het uw verantwoordelijkheid om uw BroadWorks-omgeving te controleren en te bevoorraden. Als u Cisco-ondersteuning wilt inschakelen, kunt u contact opnemen met uw accountvertegenwoordiger, die professionele services kan regelen.

HTTP-servercertificaten beheren

U moet deze certificaten voor mTLS-geverifieerde webtoepassingen beheren op uw XSP|ADP's:

  • Ons certificaat voor de vertrouwensketen van de Webex-cloud

  • De certificaten van uw XSP|ADP HTTP-serverinterfaces

Vertrouwensketen

U downloadt het certificaat van de vertrouwensketen van Control Hub en installeert het op uw XSP|ADP's tijdens uw eerste configuratie. We verwachten dat u het certificaat bijwerkt voordat het verloopt en u informeert over hoe en wanneer u het kunt wijzigen.

Uw HTTP-serverinterfaces

De XSP|ADP moet een openbaar ondertekend servercertificaat presenteren aan Webex, zoals wordt beschreven in Certificaten bestellen. Er wordt een zelfondertekend certificaat gegenereerd voor de interface wanneer u de interface voor het eerst beveiligt. Dit certificaat is één jaar geldig vanaf die datum. U moet het zelfondertekende certificaat vervangen door een openbaar ondertekend certificaat. Het is uw verantwoordelijkheid om een nieuw certificaat aan te vragen voordat het verloopt.

Beperkt door partnermodus

Beperkt door de partnermodus is een Partner Hub-instelling die partnerbeheerders kunnen toewijzen aan specifieke klantorganisaties om de organisatie-instellingen te beperken die klantbeheerders kunnen bijwerken in Control Hub. Wanneer deze instelling is ingeschakeld voor een bepaalde klantorganisatie, hebben alle klantbeheerders van die organisatie, ongeacht hun rolrechten, geen toegang tot een set beperkte besturingselementen in Control Hub. Alleen een partnerbeheerder kan de beperkte instellingen bijwerken.


 
Beperkt door de partnermodus is een instelling op organisatieniveau in plaats van een rol. De instelling beperkt echter specifieke rolrechten voor klantbeheerders in de organisatie waarop de instelling wordt toegepast.

Toegang als klantbeheerder

Klantbeheerders ontvangen een melding wanneer de modus Beperkt door partner wordt toegepast. Nadat ze zich hebben aangemeld, zien ze een meldingsbanner boven aan het scherm, direct onder de Control Hub-koptekst. De banner informeert de klantbeheerder dat de beperkte modus is ingeschakeld en dat deze bepaalde gespreksinstellingen mogelijk niet kan bijwerken.

Voor een klantbeheerder in een organisatie waar de modus Beperkt door partner is ingeschakeld, wordt het toegangsniveau van Control Hub bepaald met de volgende formule:

(Toegang tot Control Hub) = (rechten van organisatierol) - (beperkt door beperkingen in de partnermodus)

Beperkingen

Wanneer de modus Beperkt door partner is ingeschakeld voor een klantorganisatie, hebben klantbeheerders in die organisatie geen toegang tot de volgende Control Hub-instellingen:

  • In de weergave Gebruikers zijn de volgende instellingen niet beschikbaar:

    • De knop Gebruikers beheren is grijs.

    • Gebruikers handmatig toevoegen of wijzigen: er is geen optie om gebruikers handmatig of via CSV toe te voegen of te wijzigen.

    • Gebruikers claimen: niet beschikbaar

    • Licenties automatisch toewijzen: niet beschikbaar

    • Adreslijstsynchronisatie -Kan instellingen voor directorysynchronisatie niet bewerken (deze instelling is alleen beschikbaar voor beheerders op partnerniveau).

    • Gebruikersgegevens: gebruikersinstellingen zoals voornaam, achternaam, weergavenaam en primair e-mailadres* kunnen worden bewerkt.

    • Pakket herstellen: er is geen optie om het pakkettype te herstellen.

    • Services bewerken: er is geen optie om de services te bewerken die zijn ingeschakeld voor een gebruiker (bijvoorbeeld Berichten, Vergaderingen, Bellen)

    • Status van services weergeven: kan de volledige status van hybride services of software-upgradekanaal niet zien

    • Primair werknummer: dit veld is alleen-lezen.

  • In de weergave Account zijn de volgende instellingen niet beschikbaar:

    • Bedrijfsnaam is alleen-lezen.

  • In de weergave Organisatie-instellingen zijn de volgende instellingen niet beschikbaar:

    • Domein: toegang is alleen-lezen.

    • E-mail: de instellingen voor E-mailuitnodiging beheerder onderdrukken en Landinstelling e-mailadres zijn alleen-lezen.

    • Verificatie: er is geen optie om de instellingen Verificatie en SSO te bewerken.

  • In het menu Bellen zijn de volgende instellingen niet beschikbaar:

    • Gespreksinstellingen: de instellingen voor gespreksprioriteit van de appopties zijn alleen-lezen.

    • Belgedrag: instellingen zijn alleen-lezen.

    • Locatie > PSTN: de opties Lokale gateway en Cisco PSTN zijn verborgen.

  • Onder SERVICES worden de serviceopties Migraties en Verbonden UC onderdrukt.

Beperkt door partnermodus inschakelen

Partnerbeheerders kunnen de onderstaande procedure gebruiken om: Beperkt door partnermodus voor een bepaalde klantorganisatie (de standaardinstelling is ingeschakeld).

  1. Meld u aan bij Partnerhub ( https://admin.webex.com) en selecteer Klanten.

  2. Selecteer de toepasselijke klantorganisatie.

  3. Schakel in de instellingenweergave aan de rechterkant de Beperkt door partnermodus toggle om de instelling in te schakelen.

    Als u de modus Beperkt door partner wilt uitschakelen, schakelt u de schakelaar uit.


 

Als de partner de beperkte beheermodus voor een klantbeheerder verwijdert, kan de klantbeheerder het volgende uitvoeren:

  • Webex voor groothandels toevoegen (met de knop)

  • Pakketten voor een gebruiker wijzigen

Partneranalyses

Dankzij verbeteringen in Control Hub kunnen partnerbeheerders eenvoudig pakketgegevens weergeven en bijwerken namens hun gebruikers. Deze functie biedt partners de mogelijkheid om een totaaloverzicht van alle klanten te krijgen en bevat de volgende details:

  • Totaal aantal gebruikers per pakket (Softphone, Basic, Standard, Premium)

  • Gebruiker per pakkettrend (dagelijks/wekelijks/maandelijks)

  • Klanten met het aantal toegewezen pakketten

Raadpleeg het Webex artikel voor volledige informatie over het gebruik van Partner Analytics Analyse voor Webex voor groothandel en Webex voor Broadworks-pakketten in Partner Hub .

API's voor factureringsrapport

Webex for Developers biedt openbare API's die kunnen worden gebruikt voor maandelijkse factureringsrapporten. Partnerbeheerders kunnen deze API's gebruiken om factureringsrapporten te maken, op te sommen, op te halen en te verwijderen. De volgende tabel bevat de API's, het type toegang dat vereist is en de rolvereisten.

API voor facturering

Doel

Type toegang

Rolvereiste voor API

(Beheerder vereist ten minste één van deze rollen)

Een BroadWorks-factureringsrapport maken

Wordt gebruikt om een factureringsrapport te genereren.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

BroadWorks-factureringsrapporten weergeven

Wordt gebruikt om de rapporten weer te geven die beschikbaar zijn om te bekijken.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks-factureringsrapport ophalen

Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks-factureringsrapport verwijderen

Wordt gebruikt om een gegenereerd rapport te verwijderen.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

Factureringsvelden

In de volgende tabel worden de velden weergegeven die in het gegenereerde rapport zijn opgenomen.

Veld

Beschrijving

resellerNaam

Partnernaam of organisatie-id van partner

billingId

Unieke facturerings-id of C-nummer van partner

spEnterprise-id

De door de serviceprovider geleverde unieke id voor de onderneming van de abonnee.

Intern

De status van de interne proefperiode van de klant (ja/nee)

userId

De gebruikers-id van de abonnee op BroadWorks

abonnee-id

Een unieke id voor de abonnee in kwestie in Webex

zelf geactiveerd

Ja/Nee

eersteStartdatum

Datum waarop de abonnee is ingericht.

factureringStartdatum

Datum waarop facturering begint in deze maand

Einddatum facturering

Datum waarop facturering deze maand eindigt

pakket

Het pakkettype dat in rekening wordt gebracht

hoeveelheid

Geprorateerde hoeveelheid voor facturatie.

  • 1: geeft een volledige maand aan


 
  • Nadat u een factureringsrapport voor een specifieke periode hebt gegenereerd, kunt u dat rapport niet opnieuw genereren, tenzij u eerst het bestaande rapport verwijdert.

  • Als u het pakkettype of de BroadWorks-gebruikers-id voor een bepaalde gebruiker wijzigt, worden in het rapport voor de maand waarin de wijziging heeft plaatsgevonden meerdere vermeldingen voor die gebruiker weergegeven met afzonderlijke geprorateerde vermeldingen voor en na de wijziging.

Problemen met Webex voor Cisco BroadWorks oplossen

Abonneren op de statuspagina van Webex

Controleer eerst https://status.webex.com wanneer u een onverwachte onderbreking van de service ervaart. Als u uw configuratie in Control Hub of BroadWorks niet hebt gewijzigd vóór de onderbreking, controleert u de statuspagina. Lees meer over het abonneren op status- en incidentmeldingen in het Webex-helpcentrum.

Analyse van Control Hub gebruiken

Webex houdt gebruiks- en kwaliteitsgegevens bij voor uw organisatie en de organisaties van uw klant. Lees meer over de Control Hub-analyse in het Webex-helpcentrum.

Netwerkproblemen

Klanten of gebruikers worden niet gemaakt in Control Hub met flowthrough-inrichting:

  • Kan de toepassingsserver de inrichtings-URL bereiken?

  • Zijn het inrichtingsaccount en het wachtwoord correct? Bestaat dat account in BroadWorks?

Clusters falen consequent in verbindingstests:


 

Er wordt verwacht dat de mTLS-verbinding met de verificatieservice mislukt wanneer u het eerste cluster in Partner Hub maakt, omdat u het cluster moet maken om toegang te krijgen tot de Webex-certificaatketen. Zonder dat kunt u geen vertrouwensanker maken voor de verificatieservice XSP|ADP's. De mTLS-verbinding testen vanuit Partner Hub is dus niet gelukt.

  • Zijn de XSP|ADP-interfaces openbaar toegankelijk?

  • Gebruikt u de juiste poorten? U kunt een poort invoeren in de interfacedefinitie op het cluster.

Validatie van interfaces mislukt

Xsi-acties en Xsi-events-interfaces:

  • Controleer of de interface-URL's juist zijn ingevoerd op het cluster in Partner Hub, inclusief de /v2.0/ aan het einde van de URL's.
  • Controleer of de firewall communicatie tussen Webex en deze interfaces mogelijk maakt.

  • Bekijk het advies voor interfaceconfiguratie in dit document.

Interface voor verificatieservice:

  • Controleer of de interface-URL's juist zijn ingevoerd op het cluster in Partner Hub, inclusief de /v2.0/ aan het einde van de URL's.
  • Controleer of de firewall communicatie tussen Webex en deze interfaces mogelijk maakt.

  • Bekijk het advies voor interfaceconfiguratie in dit document, met bijzondere aandacht voor:

    1. Zorg ervoor dat u RSA-sleutels hebt gedeeld met alle XSP|ADP's.
    2. Zorg ervoor dat u op alle XSP|ADP's de AuthService-URL voor de webcontainer hebt opgegeven.
    3. Als u de TLS-coderingsconfiguratie hebt bewerkt, controleert u of u de juiste naamgevingsconventie hebt gebruikt. Voor de XSP|ADP moet u de IANA-naamnotatie voor de TLS-cijfers invoeren. In een eerdere versie van dit document zijn de vereiste versleutelingssuites onjuist vermeld in de naamgevingsconventie van OpenSSL.
    4. Als u mTLS gebruikt met de verificatieservice, worden de Webex-clientcertificaten dan geladen in uw XSP|ADP/ADP-vertrouwensarchief? Is de app (of de interface) geconfigureerd om clientcertificaten te vereisen?

    5. Als u CI-tokenvalidatie gebruikt met de verificatieservice, is de app (of interface) dan geconfigureerd om geen clientcertificaten te vereisen?

Clientproblemen

Controleer of de client is verbonden met BroadWorks

  1. Meld u aan bij de Webex-app.

  2. Controleer of het pictogram Gespreksopties (een handset met een versnelling erboven) aanwezig is op de zijbalk.

    Als het pictogram niet aanwezig is, is de gebruiker mogelijk nog niet ingeschakeld voor de gespreksservice in Control Hub.

  3. Open het menu Instellingen/Voorkeuren en ga naar het gedeelte Telefoonservices. U ziet de status SSO-sessie Waarvoor U bent aangemeld.

    Als een andere telefoonservice, zoals Webex Calling, wordt weergegeven, gebruikt de gebruiker Webex niet voor Cisco BroadWorks.

Deze verificatie betekent:

  • De client heeft de vereiste Webex-microservices getransverseerd.

  • De gebruiker is geverifieerd.

  • De client heeft een langlevend JSON-webtoken ontvangen van uw BroadWorks-systeem.

  • De client heeft zijn apparaatprofiel opgehaald en geregistreerd bij BroadWorks.

Clientlogboeken

Alle clients van de Webex-app kunnen logboeken Verzenden naar Webex. Dit is de beste optie voor mobiele clients. U moet ook het e-mailadres van de gebruiker noteren en de geschatte tijd waarop het probleem is opgetreden als u hulp zoekt bij TAC. Zie Waar vind ik ondersteuning voor Webex voor meer informatie?

Als u handmatig logboeken moet verzamelen vanaf een Windows-pc, bevinden ze zich als volgt:

Windows-pc: C:\Users\{username}\AppData\Local\CiscoSpark

Mac:/Users/{username}/Library/Logs/SparkMacDesktop

Problemen met aanmelden gebruiker

mTLS-verificatie verkeerd geconfigureerd

Als alle gebruikers zijn getroffen, controleert u de mTLS-verbinding van Webex met uw verificatieservice-URL:

  • Controleer of de toepassing voor de verificatieservice of de interface die wordt gebruikt, is geconfigureerd voor mTLS.

  • Controleer of de Webex-certificaatketen is geïnstalleerd als vertrouwensanker.

  • Controleer of het servercertificaat op de interface/toepassing geldig is en ondertekend is door een bekende CA.

Bericht over licentieoverschrijding

Dit bericht kan voor een klant worden weergegeven in de klantweergave van Partnerhub. Dit bericht wordt weergegeven wanneer het licentiegebruik hoger is dan wat in de licentie is toegestaan. Het bericht kan worden genegeerd.

Handleiding voor probleemoplossing

Voor gedetailleerde informatie over het oplossen van problemen met Webex voor Cisco BroadWorks raadpleegt u de Handleiding voor het oplossen van problemen met Webex voor Cisco BroadWorks.

Ondersteuning

Ondersteuningsbeleid voor steady-state

De Dienstverlener is het eerste aanspreekpunt voor de eindklant (enterprise) support. Escaleer problemen die de SP niet kan oplossen naar TAC. Ondersteuning voor BroadWorks-serverversies volgt het BroadSoft-beleid van de huidige versie en twee eerdere grote versies (N-2). Lees meer op Beleid voor de levenscyclus van BroadSoft-producten sectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.

Escalatiebeleid

  • U (serviceprovider/partner) bent het eerste aanspreekpunt voor ondersteuning van eindklanten (enterprise).

  • Problemen die niet door de SP kunnen worden opgelost, worden geëscaleerd naar TAC.

BroadWorks-versies

Resources voor zelfondersteuning

  • Gebruikers kunnen ondersteuning vinden via het Webex-helpcentrum, waar er een Webex voor Cisco BroadWorks-specifieke pagina is met algemene help- en ondersteuningsonderwerpen voor de Webex-app.

  • De Webex-app kan worden aangepast met deze Help-URL en de URL van een probleemrapport.

  • Gebruikers van de Webex-app kunnen feedback of logboeken rechtstreeks vanaf de client verzenden. De logboeken gaan naar de Webex-cloud, waar ze kunnen worden geanalyseerd door Webex DevOps.

  • We hebben ook een Help Center-pagina die is toegewezen aan Help op beheerdersniveau voor Webex voor Cisco BroadWorks.

Informatie verzamelen om een serviceaanvraag in te dienen

Wanneer u fouten ziet in Control Hub, hebben ze mogelijk informatie bijgevoegd die TAC kan helpen uw probleem te onderzoeken. Als u bijvoorbeeld een traceer-id ziet voor een bepaalde fout of een foutcode, slaat u de tekst op om met ons te delen.

Probeer ten minste de volgende informatie op te nemen wanneer u een query indient of een case opent:

  • Organisatie-id van de klant en de organisatie-id van de partner (elke id is een tekenreeks van 32 hexadecimale tekens, gescheiden door koppeltekens)

  • TrackingID (ook een tekenreeks van 32 hexadecimale cijfers) als de interface of het foutbericht er een bevat

  • E-mailadres gebruiker (als een bepaalde gebruiker problemen ondervindt)

  • Clientversies (als het probleem symptomen heeft die door de client worden opgemerkt)

Webex voor BroadWorks-referentie

UC-One SaaS-vergelijking met Webex voor Cisco BroadWorks

Oplossing >

UC-One SaaS

Webex voor Cisco BroadWorks

Cloud

Cisco UC-One Cloud (GCP)

Webex-cloud (AWS)

Clients

UC-One: Mobiel, bureaublad

Receptionist, supervisor

Webex: Mobiel, Desktop, Web

Groot technologieverschil

Vergaderingen geleverd op Broadsoft Meet-technologie

Vergaderingen geleverd via Webex Meetings-technologie

Vroege veldproeven

Staging-omgeving, bètaclients

Productieomgeving, GA-klanten

Gebruikersidentiteit

BroadWorks-id diende als primaire id, tenzij de serviceprovider al SSO-integratie heeft.

 

Gebruikers-id en geheim in BroadWorks

E-mail-id in Cisco CI dient als primaire id

SSO-integratie in serviceprovider BroadWorks waarbij de gebruiker zich op dat moment verifieert met de BroadWorks-gebruikers-id en BroadWorks-geheim.

 

Gebruiker levert referenties via SSO met BroadWorks en geheim in BroadWorks

OF

Gebruikers-id en geheim in CI IdP

OF

Gebruikers-id in CI, ID en geheimen in IdP

Clientverificatie

Gebruikers leveren referenties via client

BroadWorks-tokens met een lange levensduur vereist bij gebruik van Webex-berichten

Gebruikers leveren referenties via de browser (aanmeldingspagina van Webex BIdP-proxy of CI)

Webex-toegangs- en vernieuwingstokens

Beheer / configuratie

Uw OSS/BSS-systemen en

Doorverkoopportaal

Uw OSS/BSS-systemen en Control Hub

Activering van partner/serviceprovider

Eenmalige installatie door Cisco Operations

Eenmalige installatie door Cisco Operations

Activering van klant/onderneming

Doorverkoopportaal

Control Hub

Automatisch gemaakt bij inschrijving eerste gebruiker

Activeringsopties voor de gebruiker

Zelfingeschreven

Externe IM&P instellen in BroadWorks

Geïntegreerde IM&P instellen in BroadWorks (doorgaans bedrijven)

XSP|ADP-serviceinterfaces

XSI-acties

 

XSI-gebeurtenissen

CTI (mTLS)

Verificatieservice (mTLS optioneel)

DMS

XSI-acties

XSI-acties (mTLS)

XSI-gebeurtenissen

CTI (mTLS)

Verificatieservice (TLS)

DMS

Webex installeren en aanmelden (Subscriber Perspective)

1

Download en installeer Webex. Zie Webex | De app downloaden voor meer informatie.

2

Webex uitvoeren.

Webex vraagt u naar uw e-mailadres.
3

Voer uw e-mailadres in en klik op Volgende.

4

Afhankelijk van de manier waarop uw organisatie in Webex is geconfigureerd, vindt een van de volgende handelingen plaats:

  1. Webex start een browser waarmee u de verificatie met uw identiteitsprovider kunt voltooien. Dit kan meervoudige verificatie (MFA) zijn.

  2. Webex start een browser waarin u uw BroadWorks-gebruikers-id en -wachtwoord kunt invoeren.

Webex wordt geladen nadat u bent geverifieerd met de IdP of BroadWorks.

Gegevensuitwisseling en -opslag

Deze secties bevatten details over gegevensuitwisseling en opslag met Webex. Alle gegevens worden zowel in transit als in rust versleuteld. Zie Beveiliging van de Webex-app voor meer informatie.

Onboarding serviceprovider

Wanneer u clusters en gebruikerssjablonen configureert in Webex Control Hub tijdens de onboarding van serviceproviders, wisselt u de volgende BroadWorks-gegevens uit die Webex opslaat:

  • URL Xsi-acties

  • URL van Xsi-Events

  • URL CTI-interface

  • URL verificatieservice

  • Referenties voor BroadWorks-inrichtingsadapter

Gebruikersvoorzieningen serviceprovider

Deze tabel bevat gebruikers- en bedrijfsgegevens die worden uitgewisseld als onderdeel van gebruikersvoorzieningen via de Webex-API's.

Gegevens verplaatsen naar Webex

Van

Door

Opgeslagen door Webex?

Gebruikers-id voor BroadWorks

BroadWorks, volgens API

Webex-API's

Ja

E-mail (indien SP verstrekt)

BroadWorks, volgens API

Webex-API's

Ja

E-mail (indien door gebruiker opgegeven)

Gebruiker

Portal voor gebruikersactivering

Ja

Voornaam

BroadWorks, volgens API

Webex-API's

Ja

Achternaam

BroadWorks, volgens API

Webex-API's

Ja

Primair telefoonnummer

BroadWorks, volgens API

Webex-API's

Ja

Mobiel telefoonnummer

BroadWorks, volgens API

Webex-API's

Ja

Primair toestel

BroadWorks, volgens API

Webex-API's

Ja

BroadWorks-serviceprovider-id en groeps-id

BroadWorks, volgens API

Webex-API's

Ja

Taal

BroadWorks, volgens API

Webex-API's

Ja

Tijdzone

BroadWorks, volgens API

Webex-API's

Ja

Gebruiker verwijderen

Webex voor Cisco BroadWorks API's ondersteunen zowel gedeeltelijke als volledige verwijdering van gebruikers. Deze tabel bevat alle gebruikersgegevens die zijn opgeslagen tijdens het inrichten en wat in elk scenario wordt verwijderd.

Gebruikersgegevens

Gedeeltelijke verwijdering

Volledige verwijdering

Gebruikers-id voor BroadWorks

Ja

Ja

E-mail

Nee

Ja

Voornaam

Nee

Ja

Achternaam

Nee

Ja

Primair telefoonnummer

Ja

Ja

Mobiel telefoonnummer

Ja

Ja

Extensie

Ja

Ja

BroadWorks-serviceprovider-id en groeps-id

Ja

Ja

Taal

Nee

Ja

Gebruikersaanmelding en configuratie ophalen

Webex-verificatie

Webex-verificatie verwijst naar aanmelding van gebruikers bij een Webex-app door een van de Webex-ondersteuningsmechanismen. ( BroadWorks-verificatie wordt afzonderlijk behandeld.) In deze tabel wordt het type gegevens weergegeven dat tussen de verschillende componenten van de verificatiestroom wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via de Webex-app

Webex

Beperkt toegangstoken en (onafhankelijke) IdP-URL

Webex

Gebruikersbrowser

Gebruikersgegevens

Gebruikersbrowser

Identiteitsprovider (die al gebruikersidentiteit heeft)

SAML-verklaring

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Tokens voor toegang en vernieuwing

Webex

Gebruikersbrowser

Tokens voor toegang en vernieuwing

Gebruikersbrowser

Webex-app

BroadWorks-verificatie

BroadWorks-verificatie verwijst naar aanmelding van gebruikers bij een Webex-app met hun BroadWorks-referenties. In deze tabel wordt het type gegevens weergegeven dat tussen de verschillende componenten van de verificatiestroom wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via de Webex-app

Webex

Token voor beperkte toegang en IdP-URL (Webex Bwks IdP-proxy)

Webex

Gebruikersbrowser

Brandinginformatie en BroadWorks-URL's

Webex

Gebruikersbrowser

BroadWorks-gebruikersreferenties

Gebruiker via browser (aanmeldingspagina met merknaam, bediend door Webex)

Webex

BroadWorks-gebruikersreferenties

Webex

BroadWorks

BroadWorks-gebruikersprofiel

BroadWorks

Webex

SAML-verklaring

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Tokens voor toegang en vernieuwing

Webex

Gebruikersbrowser

Tokens voor toegang en vernieuwing

Gebruikersbrowser

Webex-app

Melding van verlopen BroadWorks-wachtwoord tijdens aanmelden

Deze functie verbetert het aanmeldproces en bepaalt de aanmeldstroom op basis van:

Verbetering van aanmeldwaarschuwing en foutberichten:

  • Op dit moment krijgen de Wexbex voor BWKS-gebruikers die gebruikmaken van BroadWorks-verificatie en -aanmelding via de UAP geen melding dat hun wachtwoord bijna verloopt of dat ze zich niet kunnen aanmelden omdat het wachtwoord al is verlopen. Als het wachtwoord over 10 dagen of minder verloopt, ontvangt de gebruiker met deze functie een waarschuwing dat het wachtwoord bijna verloopt en wordt aangegeven hoeveel dagen er nog over zijn. De gebruiker wordt geadviseerd contact op te nemen met de partner of de koppeling Wachtwoord vergeten op het aanmeldscherm te volgen om het wachtwoord opnieuw in te stellen.
  • Als het wachtwoord is verlopen en de configuratie in BroadWorks 'enforcePasswordChangeOnExpiry' is ingesteld op waar, is de fout 'onjuiste gebruikersnaam en wachtwoord' gegooid, maar nu met deze functie is het foutbericht verbeterd: De aanmeldpoging is mislukt De combinatie van de gebruikersnaam en het wachtwoord komt niet overeen met onze gegevens of uw wachtwoord moet worden bijgewerkt. Probeer het opnieuw of neem contact op met uw beheerder om het wachtwoord bij te werken. Foutcode 100006

Aanmeldstroom beheren:

  • De partner kan de aanmelding beperken door een instelling 'w4bwks-password-expiry-fail-login' in te schakelen. Deze instelling 'kan door Cisco worden ingeschakeld op verzoek van een partner. Als BroadWorks-wachtwoord is verlopen, wordt de configuratie in BroadWorks 'enforcePasswordChangeOnExpiry' ingesteld op onwaar en wordt de instelling 'w4bwks-password-expiry-fail-login' ingeschakeld. Vervolgens wordt een fout geslingerd die zegt dat het wachtwoord x dagen geleden is verlopen, terwijl als de instellingsservice is uitgeschakeld, inloggen is toegestaan. De instelling is standaard uitgeschakeld.

De koppeling Wachtwoord vergeten op de aanmeldpagina kan door de partner worden geconfigureerd als onderdeel van de functie Geavanceerde aanpassing. Partners zouden de koppeling doorgaans configureren om de gebruiker naar een partnerportal te navigeren voor wachtwoordbeheer en het opnieuw instellen van het wachtwoord.


 

Deze functie verbetert alleen de aanmeldingservaring van de gebruiker tijdens het aanmelden van de geactiveerde gebruiker wanneer het wachtwoord op het punt staat te verlopen of al is verlopen. De functie wordt niet verwerkt als een wachtwoord verloopt terwijl de gebruiker is aangemeld bij de Webex-app. Bij de volgende aanmeldpoging krijgt de gebruiker een melding voor het verlopen van het wachtwoord.

Clientconfiguratie ophalen

Deze tabel toont het type gegevens dat tussen de verschillende componenten wordt uitgewisseld tijdens het ophalen van clientconfiguraties.

Gegevens verplaatsen

Van

Doel

Registratie

Klant

Webex

Organisatie-instellingen, inclusief BroadWorks-URL's

Webex

Klant

JWT-token voor BroadWorks

BroadWorks via Webex

Klant

JWT-token voor BroadWorks

Klant

BroadWorks

Apparaattoken

BroadWorks

Klant

Apparaattoken

Klant

BroadWorks

Configuratiebestand

BroadWorks

Klant

Gebruik bij steady-state

In dit gedeelte worden de gegevens beschreven die tussen componenten worden verplaatst tijdens herverificatie na het verlopen van een token, via BroadWorks of Webex.

In deze tabel wordt de gegevensbeweging voor bellen weergegeven.

Gegevens verplaatsen

Van

Doel

SIP-signalering

Klant

BroadWorks

SRTP-media

Klant

BroadWorks

SIP-signalering

BroadWorks

Klant

SRTP-media

BroadWorks

Klant

In deze tabel wordt de gegevensbeweging voor berichten, aanwezigheid en vergaderingen weergegeven.

Gegevens verplaatsen

Van

Doel

HTTPS REST-berichten en aanwezigheid

Klant

Webex

HTTPS REST-berichten en aanwezigheid

Webex

Klant

SIP-signalering

Klant

Webex

SRTP-media

Klant

Webex

SIP-signalering

Webex

Klant

SRTP-media

Webex

Klant

De inrichtings-API gebruiken

Toegang voor ontwikkelaars

De API-specificatie is beschikbaar op https://developer.webex.com en een handleiding voor het gebruik is te vinden op https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

U moet zich aanmelden om de API specificatie te lezen ophttps://developer.webex.com/docs/api/v1/broadworks-subscribers .

Toepassingsverificatie en autorisatie

Uw toepassing wordt geïntegreerd met Webex als een Integratie. Met dit mechanisme kan de toepassing beheertaken uitvoeren (zoals het inrichten van abonnees) voor een beheerder binnen uw partnerorganisatie.

Webex-API's volgen de OAuth 2-standaard ( http://oauth.net/2/). Met OAuth 2 kunnen integraties van derden vernieuwings- en toegangstokens verkrijgen namens de door u gekozen partnerbeheerder voor het verifiëren van API-gesprekken.

U moet eerst uw integratie met Webex registreren. Na registratie moet uw toepassing deze OAuth 2.0-autorisatietoekenningsflow ondersteunen om de benodigde vernieuwings- en toegangstokens te verkrijgen.

Zie https://developer.webex.com/docs/integrations voor meer informatie over integraties en hoe u deze OAuth 2-autorisatieflow in uw toepassing kunt opbouwen.


 

Er zijn twee rollen vereist voor het implementeren van integraties - de ontwikkelaar en de autorisatiegebruiker - en deze kunnen worden bekleed door afzonderlijke personen/teams in uw omgeving.

  • De ontwikkelaar maakt de app en registreert deze op https://developer.webex.com om de vereiste OAuth ClientID/Secret te genereren met scopes die worden verwacht voor de toepassing. Als uw toepassing wordt gemaakt door een derde partij, kan deze de toepassing registreren (als u om toegang hebt gevraagd) of kan u deze met uw eigen toegang doen.

  • De gebruiker autoriseren is het account dat de toepassing gebruikt om de API-oproepen te autoriseren, om uw partnerorganisatie, de organisaties van uw klanten of hun abonnees te wijzigen. Dit account moet de rol Volledige beheerder of Volledige verkoopbeheerder hebben in uw partnerorganisatie. Deze rekening mag niet door een derde worden aangehouden.

Naam organisatie

De organisatienaam is afhankelijk van de inrichtingsmodus die u gebruikt:

  • Enterprise-modus: de organisatienaam komt exact overeen met spEnterprise-id.

  • Serviceprovidermodus: de organisatienaam is het gedeelte groep-id van de spEnterprise-id.

De organisatienaam bevat alle spaties, hoofdletters en speciale tekens die zijn opgegeven in de oorspronkelijke spEnterprise-id.

Softwarevereisten voor BroadWorks

Zie Lifecycle Management - BroadSoft Servers.

We verwachten dat de serviceprovider "patch current" is met de nieuwste BroadWorks-patches en Release Independent (RI)-apps. De lijst met patches hieronder is de minimale vereiste voor integratie met Webex.


 
Controleer de patchnotities voor deze softwarepatches. Sommige patches hebben mogelijk aanvullende CLI-vereisten.

Versie R22

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.22.0.1123.ap364260

AP.as.22.0.1123.ap365173

AP.as.22.0.1123.ap368517

Vereist voor adreslijstsynchronisatie

AP.as.22.0.1123.ap369763

AP.as.22.0.1123.ap372989

AP.as.22.0.1123.ap372757

AP.as.22.0.1123.ap372963

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.22.0.1123.ap373197

Vereiste patch voor toepassingsserver

AP.as.22.0.1123.ap378391

AP.as.22.0.1123.ap374793

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.22.0.1123.ap377718

Vereiste patch voor de functie Gespreksopname

AP.as.22.0.1123.ap377868

AP.as.22.0.1123.ap376508

Vereiste patch voor doorstroominrichting

AP.xsp.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Profielserver

AP.ps.22.0.1123.ap372989

AP.ps.22.0.1123.ap372757

AP.ps.22.0.1123.ap378391

AP.ps.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Platform

AP.platform.22.0.1123.ap353577

AP.platform.22.0.1123.ap354313

Vereist voor NPS-verificatieproxy

AP.platform.22.0.1123.ap365173

AP.platform.22.0.1123.ap367732

AP.platform.22.0.1123.ap369433

AP.platform.22.0.1123.ap369607

Vereist voor NPS-verificatieproxy

AP.platform.22.0.1123.ap372757

AP.platform.22.0.1123.ap376508

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.platform.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

XSP|ADP

AP.xsp.22.0.1123.ap354313

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap365173

AP.xsp.22.0.1123.ap368067

AP.xsp.22.0.1123.ap368601

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.xsp.22.0.1123.ap369607

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap370952

AP.xsp.22.0.1123.ap373008

AP.xsp.22.0.1123.ap372757

AP.xsp.22.0.1123.ap372433

AP.xsp.22.0.1123.ap372963

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.xsp.22.0.1123.ap378391

AP.xsp.22.0.1123.ap374677

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap375206

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap376508

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.xsp.22.0.1123.ap378585

Vereist voor Unified Call History

Overig

AP.xsa.22.0.1123.ap372757

AP.xs.22.0.1123.ap372757

AP.ums.22.0.1123.ap378391

AP.nfm.22.0.1123.ap378391

Versie R23

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.23.0.1075.ap368517

Vereist voor adreslijstsynchronisatie

AP.as.23.0.1075.ap369763

AP.as.23.0.1075.ap373197

App-server configureren

AP.as.23.0.1075.ap373271

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.23.0.1075.ap378391

AP.as.23.0.1075.ap376509

AP.as.23.0.1075.ap377718

Vereist voor gespreksopname

AP.as.23.0.1075.ap377868

AP.as.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Profielserver

AP.ps.23.0.1075.ap378391

Platform

AP.platform.23.0.1075.ap367732

AP.platform.23.0.1075.ap370952

AP.platform.23.0.1075.ap369607

Vereist voor NPS-verificatieproxy

AP.platform.23.0.1075.ap376509

AP.platform.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

XSP|ADP

AP.xsp.23.0.1075.ap368067

AP.xsp.23.0.1075.ap369607

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap370952

AP.xsp.23.0.1075.ap373008

AP.xsp.23.0.1075.ap373271

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.xsp.23.0.1075.ap378391

AP.xsp.23.0.1075.ap374677

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap375206

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap376509

AP.xsp.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Overig

Bij gebruik van ADP...

Xsi-Events-23_2021.05_1.251.bwar

Vereiste patch voor haakstatus (Presence) en Unified Call History

Versie R24

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.24.0.944.ap384177

Vereist voor Unified Messaging Server (UMS)

AP.as.24.0.944.ap375100

Vereist voor flowthrough-inrichting

AP.as.24.0.944.ap377718

Vereist voor gespreksopname

AP.as.24.0.944.ap377868

AP.as.24.0.944.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Overig

Xsi-Events-24_2021.05_1.251.bwar

Vereiste patch voor haakstatus (Presence) en Unified Call History

Inrichtings- en activeringsstromen voor gebruikers


 

Inrichting beschrijft het toevoegen van de gebruiker aan Webex. Activering omvat e-mailvalidatie en servicetoewijzing in Webex.

E-mailadressen van gebruikers moeten uniek zijn, omdat Webex het e-mailadres gebruikt om een gebruiker te identificeren. Als u vertrouwde e-mailadressen voor de gebruikers hebt, kunt u ervoor kiezen deze automatisch te activeren wanneer u ze automatisch inricht. Dit proces is 'automatische inrichting en automatische activering'.

Automatische gebruikersinrichting en automatische activering (vertrouwde e-mailstroom)

Voorwaarden

  • Uw inrichtingsadapter wijst naar Webex voor Cisco BroadWorks (waarvoor een uitgaande verbinding van AS naar Webex Provisioning Bridge is vereist).

  • U moet geldige bereikbare e-mailadressen van eindgebruikers hebben als alternatieve id's in BroadWorks.

  • Control Hub heeft een inrichtingsaccount in de configuratie van uw partnerorganisatie.

Stap

Beschrijving

1

U noteert en neemt bestellingen voor de service op bij uw klanten.

2

U verwerkt de klantorder en richt de klant in uw systemen in.

3

Het service-inrichtingssysteem activeert de inrichting van BroadWorks. Deze stap, in het kort, maakt de onderneming en de gebruikers. Vervolgens wijst het de benodigde services en nummers toe aan elke gebruiker. Een van die diensten is de externe IM&P.

4

Met deze inrichtingsstap wordt de automatische inrichting van de klantorganisatie en gebruikers in Webex geactiveerd. (De IM&P-servicetoewijzing zorgt ervoor dat de inrichtingsadapter de Webex-inrichtings-API belt).

5

Uw systemen moeten de Webex-provisioning-API gebruiken als u het pakket later voor de gebruiker moet aanpassen (om van de standaardinstelling te veranderen).

SSO-aanmeldstroom

SAML SSO-aanmeldstroom met directe BroadWorks-verificatie (delen van resources tussen verschillende bronnen)

Hier volgt de SAML SSO-aanmeldstroom voor de Webex-app bij gebruik van BroadWorks-verificatie en wanneer Resource delen met meerdere bronnen is ingeschakeld, zodat directe verificatie naar BroadWorks mogelijk is. De afbeelding toont client- en gebruikersevenementen aan de linkerkant met tekst op de pijlen die weergeeft wat de client voor autorisatie voorziet. Stap 1 en 5 zijn gebruikersevenementen. Aan de rechterkant van de afbeelding ziet u gebeurtenissen voor aanmeldservices, samen met wat er wordt teruggestuurd naar de client.

BroadWorks-registratie en servicedetectiestroom

Hieronder volgt de BroadWorks-servicedetectiestroom die onmiddellijk volgt uit de vorige Webex SAML SSO-aanmeldstroom. De client gebruikt het toegangstoken dat is verkregen bij de registratie bij Webex-apparaatbeheer om registratie aan te vragen bij de BroadWorks-implementatie.

Alternatieve aanmeldstromen

De bovenstaande afbeeldingen gaan ervan uit dat SAML SSO-aanmelding is geconfigureerd met BroadWorks-verificatie waarvoor directe BroadWorks-verificatie is ingeschakeld (Cross-Origin Resource Sharing). Hieronder vindt u enkele alternatieve SAML SSO-aanmeldstromen:

  • BroadWorks-verificatie zonder directe BroadWorks-verificatie (delen van resources tussen verschillende bronnen):

    • Het enige verschil is in stap 5 en 6 van de Webex-aanmeldstroom. In stap 5 worden de aanmeldingsgegevens gevalideerd door de IdP-proxy (in plaats van XSI) en wordt een SAML-verklaring teruggestuurd naar de client.

    • De stroom loopt door de resterende stappen in de twee diagrammen.

    • Het SSO-token wordt niet gebruikt in deze flow.

  • SAML SSO Webex-verificatie:

    • In stap 3 van de Webex-aanmeldstroom retourneert de service Common Identity de identiteitsprovider die wordt gebruikt door Webex-verificatie.

    • Op dit moment wordt een alternatieve SAML SSO-aanmeldstroom voor Webex gestart.

Gebruikersinteracties

Aanmelden

  1. De Webex-app lanceert een browser naar Cisco Common Identity (CI) zodat gebruikers hun e-mailadres kunnen invoeren.

  2. CI ontdekt dat de gekoppelde klantorganisatie de BroadWorks IDP-proxy (IDP) heeft geconfigureerd als hun SAML IDP. CI wordt omgeleid naar de IDP die de gebruiker een aanmeldpagina aanbiedt. (De serviceprovider kan deze aanmeldpagina aanmerken.)

  3. De gebruiker voert zijn of haar BroadWorks-referenties in.

  4. Broadworks verifieert de gebruiker via de IDP. Bij succes stuurt de IDP de browser terug naar CI met een SAML-succes om de verificatieflow te voltooien (niet weergegeven in diagram).

  5. Bij succesvolle verificatie verkrijgt de Webex-app toegangstokens van CI (niet weergegeven in diagram). De client gebruikt deze om een BroadWorks langlevende Jason Web Token (JWT) aan te vragen.

  6. De Webex-app ontdekt de gespreksconfiguratie van BroadWorks en andere services van Webex.

  7. De Webex-app wordt geregistreerd bij BroadWorks.

Aanmelden vanuit het perspectief van een gebruiker

Dit diagram is de typische aanmeldingsstroom, zoals gezien door de eindgebruiker of abonnee:

  1. U downloadt en installeert de Webex-app.

  2. Mogelijk hebt u de koppeling van uw serviceprovider ontvangen of kunt u de download vinden op de pagina Webex-downloads.

  3. U voert uw e-mailadres in op het aanmeldscherm van Webex. Klik op Volgende.

  4. U wordt meestal omgeleid naar een pagina met het merk Serviceprovider.

  5. Die pagina kan u verwelkomen via uw e-mailadres.

    Als er geen e-mailadres is of als het e-mailadres onjuist is, voert u in plaats daarvan uw BroadWorks-gebruikersnaam in.

  6. Voer uw BroadWorks-wachtwoord in.

  7. Als u zich hebt aangemeld, wordt Webex geopend.

Gespreksstroom: bedrijfstelefoonlijst

Gespreksstroom: PSTN-nummer

Presentatie en delen

Een ruimtevergadering starten

Interacties met de klant

Profiel ophalen uit DMS en SIP-register met AS

  1. De client belt XSI om een apparaatbeheertoken en de URL naar het DMS op te halen.

  2. De klant vraagt zijn apparaatprofiel aan bij DMS door het token van stap 1 voor te leggen.

  3. De client leest het apparaatprofiel en haalt de SIP-referenties, adressen en poorten op.

  4. Client verzendt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.

  5. SBC stuurt het SIP REGISTER naar het AS (SBC kan een zoekopdracht uitvoeren in de NS om een AS te vinden als SBC de SIP-gebruiker nog niet kent.)

Test- en laboratoriumrichtlijnen

De volgende richtlijnen zijn van toepassing op test- en laboratoriumorganisaties:

  • Serviceproviderpartners zijn beperkt tot maximaal 50 testgebruikers die in meerdere organisaties kunnen worden ingericht.

  • Gebruikers buiten de eerste 50 testgebruikers worden gefactureerd.

  • Om een nauwkeurige verwerking op uw factuur te garanderen, moeten alle testorganisaties 'test' opnemen in de naam van de BroadWorks-organisatie.

  • Interne testorganisaties moeten worden aangewezen in Webex Control Hub. Dit is om te voorkomen dat testgebruikers worden gefactureerd als werkelijke gebruikers.

Een organisatie aanwijzen als een testorganisatie

Een organisatie aanwijzen als testorganisatie:

  1. Meld u aan bij Partner Hub en selecteer Klanten.

  2. Selecteer de juiste klant.

  3. Schakel in de rechterbedieningsbalk de schakelaar Interne testorganisatie in.

Voicemail afspelen

Zorg ervoor dat u voor voicemail de Mediaserver configureert om een van de volgende codes te gebruiken:

  • mp3

  • wav: WAV-bestanden worden ondersteund in de volgende indelingen: PCM (ondersteund op alle platforms) en DVI-ADPCM (niet ondersteund op Android

Als u wav-bestanden gebruikt, voert u de volgende CLI-opdrachten uit om de toepassingsserver en de mediaserver te configureren:

  • AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV

  • MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw

Terminologie

ACL (ACL)
Lijst met toegangscontrole
ALG
Gateway toepassingslaag
API
Toepassingsprogrammeerinterface
APNS
Apple Push-notificatieservice
AS
Toepassingsserver
ATA, VORMEN, VORMEN
Analoge telefoonoplader, adapter die analoge telefonie converteert naar VoIP
BAM
Toepassingsbeheer van BroadSoft
Basisverificatie
Een verificatiemethode waarbij een account (gebruikersnaam) wordt gevalideerd met een gedeeld geheim (wachtwoord)
BMS, (VER)LEIDEN
BroadSoft-berichtenserver
BOSJE
Bidirectionele stromen via synchrone HTTP
BRAADSTUK
Basic Rate Interface BRI is een ISDN-toegangsmethode
Bundel
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (cfr. Pakket)
CA
Certificeringsinstantie
Provider
Een organisatie die telefonieverkeer afhandelt (cfr. Partner, serviceprovider, Value Added Reseller)
CAPTCHA
Volledig geautomatiseerde Public Turing-test om computers en mensen uit elkaar te houden
CCXML
Taal voor eXtensible Markup voor gespreksbeheer
CIF
Algemeen Tussenformaat
CLI, VASTBINDEN
Opdrachtregelinterface
CN
Algemene naam
CNPS, CNPS
Pushserver voor gespreksmeldingen. Een pushserver voor meldingen die wordt uitgevoerd op een XSP|ADP in uw omgeving, om gespreksmeldingen naar FCM en APNS te pushen. Zie NPS-proxy.
CPE
Gebouwapparatuur van de klant
CPR, AFLEIDEN
Aangepaste aanwezigheidsregel
CSS, CVS
Cascade-stijlblad
CSV
Door komma's gescheiden waarde
CTI
Integratie van computertelefonie
CUBE
Cisco Unified Border Element
DMZ
Gedemilitariseerde zone
DN
Telefoonlijstnummer
Niet storen
Niet storen
DNS
Domeinnaamsysteem
DPG
Bel peergroep
DSCP
Punt Gedifferentieerde Servicecode
DTAF
Archiefbestand van apparaattype
DTG
Bestemmings-trunk-groep
DTMF
Dubbele toon met meerdere frequenties
Eindgebruiker
De persoon die de services gebruikt, die gesprekken voert, deelneemt aan vergaderingen of berichten verzendt (cf. Abonnee)
Organisatie
Een verzameling van eindgebruikers (cfr. Organisatie)
FCM
Firebase-cloudberichten
SCHAAMTE
Convergentie van vaste mobiele apparaten
Doorstroominrichting
Gebruikers maken in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' toe te wijzen in BroadWorks.
FQDN
Volledig gekwalificeerde domeinnaam (FQDN)
Volledige doorstroominrichting
Gebruikers maken en verifiëren in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' toe te wijzen in BroadWorks en te bevestigen dat elke BroadWorks-gebruiker een uniek en geldig e-mailadres heeft.
FXO, FXO
Foreign Exchange Office is de poort die de analoge lijn ontvangt. Dit is de stekker op de telefoon of faxmachine of de stekkers op uw analoge telefoonsysteem. Het levert een on-hook/off-hook indicatie (lussluiting). Aangezien de FXO-poort is gekoppeld aan een apparaat, zoals een fax of een telefoon, wordt het apparaat vaak het 'FXO-apparaat' genoemd.
FXS, FXS
Foreign Exchange Subscriber is de poort die daadwerkelijk de analoge lijn aan de abonnee levert. Met andere woorden, het is de "plug in the wall" die een kiestoon, accustroom en belspanning levert.
GCM
Google Cloud-bericht
GCM
Galois/Counter-modus (coderingstechnologie)
VERSTOPT
Apparaat voor menselijke interface
HTTPS
Beveiligde contactdozen met hypertekstdoorschakelprotocol
IAD
Apparaat voor geïntegreerde toegang
IM&P
Instant Messaging en Aanwezigheid
IP-PSTN
Een serviceprovider die VoIP-naar-PSTN-services levert, uitwisselbaar met ITSP, of een algemene term voor 'openbare' telefonie met internetverbinding, gezamenlijk geleverd door grote telecomproviders (in plaats van door landen, zoals PSTN is)
ITSP, ITSP
Internettelefonieserviceprovider
IVR, IVR
Interactieve spraakrespons / Responder
JID
Het systeemeigen adres van een XMPP-entiteit wordt een Jabber-id of JID localpart@domain.part.example.com/resourcepart (@ . / zijn separatoren)
JSON
Java-scriptobjectnotatie
JOOD
Java Secure Socket Extension; de onderliggende technologie die veilige verbindingsfuncties biedt voor BroadWorks-servers
KEM
Toetsuitbreidingsmodule (hardware Cisco-telefoons)
LLT
Long-lived (of Long Life) Token; een zelfbeschrijvende, veilige vorm van toondertoken waarmee gebruikers langer geverifieerd kunnen blijven en niet gekoppeld zijn aan specifieke toepassingen.
MA, MA, MAMA
Berichtarchivering
MIB, MIB
Basis managementinformatie
MEVROUW
Mediaserver
mTLS
Wederzijdse verificatie tussen twee partijen met behulp van certificaatuitwisseling bij het tot stand brengen van een TLS-verbinding
MUG, MUG, MUG
Chat met meerdere gebruikers
NAT, NAT
Vertalingen van netwerkadressen
NPS
Pushserver voor meldingen; zie CNPS
NPS-proxy

Een service in Webex die korte autorisatietokens levert aan uw CNPS, zodat deze de gespreksmeldingen naar FCM en APN's en uiteindelijk naar Android- en iOS-apparaten met Webex kan pushen.

OCI, OCI
Clientinterface openen
Organisatie
Een bedrijf of organisatie die een verzameling eindgebruikers vertegenwoordigt (cfr. Onderneming)
OTG
Uitgaande trunkgroep
Pakket
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (cfr. bundel)
Partner
Een agentorganisatie die samenwerkt met Cisco om producten en services te distribueren naar andere organisaties (cf. Value Added Reseller, serviceprovider, provider)
PBX
Ruilen privé-filiaal
PEM
E-mail met verbeterde privacy
PLONS
Openbaar mobiel landnetwerk
PRI, SNOEIWERK
Primary Rate Interface (PRI) is een standaard voor telecommunicatie-interface die wordt gebruikt op een digitaal netwerk voor geïntegreerde diensten (ISDN)
PS
Profielserver
PSTN
Openbaar geschakeld telefoonnetwerk
QoS
Servicekwaliteit
Doorverkoopportaal
Een website waarop de beheerder van de reseller zijn UC-One SaaS-oplossing kan configureren. Het wordt soms BAM-portal, beheerportal of beheerportal genoemd.
RTCP
Real-time beheerprotocol
RTP
Protocol voor realtime vervoer
SBC, ZWAARD
Sessie Border Controller
SCÈNE, SCÈNE
Weergave van gedeelde oproep
SD (SD)
Standaarddefinitie
SDP
Protocol voor sessiebeschrijving
SP
Serviceprovider; Een organisatie die telefonie of gerelateerde diensten levert aan andere organisaties (cf. Vervoerder, Partner, Value Added Reseller)
SIP
Protocol voor het starten van een sessie
SLET
Short-lived (of Short Life) Token (ook wel BroadWorks SSO Token genoemd); een authenticated token voor eenmalig gebruik dat wordt gebruikt om veilige toegang tot webtoepassingen te krijgen.
SMB
Kleine tot middelgrote ondernemingen
SNMP
Eenvoudig netwerkbeheerprotocol
sRTCP
secure Realtime Transfer Control Protocol (VoIP-gespreksmedia)
sRTP
beveiligd Realtime-doorverbindprotocol (VoIP-gespreksmedia)
SSL
Laag met veilige contactdozen
Abonnee
De persoon die de services gebruikt, die gesprekken voert, deelneemt aan vergaderingen of berichten verzendt (cf. Eindgebruiker)
TCP
Transmissieregelprotocol
TDM
Tijdverdeling multiplexen
TLS
Transportlagenbeveiliging
ToS
Soort service
UAP, UAP
Portal voor gebruikersactivering
UC
Unified Communications
GEBRUIKERSINTERFACE
Gebruikersinterface
U Id
Unieke id
AFMETINGEN
Berichtenserver
URI
Uniforme resource-id
URL
Uniforme bronzoeker
USS
Server voor delen
UTC
Gecoördineerde wereldtijd
UVS
Videoserver
Value Added Reseller (VAR)
Een agentorganisatie die samenwerkt met Cisco om producten en services te distribueren naar andere organisaties (cf. Vervoerder, Partner, Serviceprovider)
VGA
Grafische matrix voor video
VoIP
Voice over Internet Protocol (IP)
VXML
Taal voor uitbreidbare spraak
WebDAV
Webgedistribueerde creatie en versioning
WebRTC
Realtime webcommunicatie
WRS
WebRTC-server
XMPP
Extensible Messaging and Presence Protocol
Overzicht van Webex voor Cisco BroadWorks

Introductie van Webex voor Cisco BroadWorks

Geschiedenis van documentrevisie

Dit gedeelte is gericht op systeembeheerders van Cisco-partnerorganisaties (serviceproviders) die Webex implementeren voor de organisaties van hun klanten of deze oplossing rechtstreeks aan hun eigen abonnees aanbieden.

Oplossingsdoel

  • Om Webex-cloudsamenwerkingsfuncties te bieden aan kleine en middelgrote klanten die al een belservice hebben geleverd door BroadWorks-serviceproviders.

  • De op BroadWorks gebaseerde belservice aanbieden aan kleine en gemiddelde Webex-klanten.

Context

We zijn aan het veranderen van al onze samenwerkingsklanten naar een gemeenschappelijke toepassing. Dit pad vermindert aannameproblemen, verbetert de interoperabiliteit en migratie en zorgt voor een voorspelbare gebruikerservaring in ons hele samenwerkingportfolio. Onderdeel van deze inspanningen is om de belmogelijkheden van BroadWorks naar de Webex-app te verplaatsen en uiteindelijk de investering in de UC-One-clients te verlagen.

Voordelen

  • Future proofing: tegen End-of-life van UC-One Collaborate, beweging van alle klanten naar het Unified Client Framework (UCF)

  • Het beste van beide: De functies voor Webex-berichten en -vergadering inschakelen terwijl BroadWorks wordt behouden voor bellen op uw telefonienetwerk

Oplossingsbereik

  • Bestaande / nieuwe kleine tot middelgrote klanten (minder dan 250 abonnees) die een reeks samenwerkingsfuncties willen, kunnen al BroadWorks bellen.

  • Bestaande kleine tot middelgrote Webex-klanten die Bellen via BroadWorks willen toevoegen.

  • Geen grotere ondernemingen (Bekijk ons Enterprise-portfolio voor Webex).

  • Niet één gebruiker (evalueren Webex Online aanbiedingen).

De functiesets in Webex voor Cisco BroadWorks zijn gericht op kleine naar gemiddelde bedrijfsgebruiks cases. De Webex voor Cisco BroadWorks-pakketten zijn ontworpen om de complexiteit van SMBs te verminderen en we evalueren voortdurend hun bruikbaarheid voor dit segment. Mogelijk kunnen we ervoor kiezen om functies die anders beschikbaar zijn in de Bedrijfspakketten te verbergen of te verwijderen.

Vereisten voor succes met Webex for Cisco BroadWorks

#

Vereiste

Aantekeningen

1

Patch Current BroadWorks R22 of hoger

2

XSP|ADP voor XSI, CTI, DMS en authService

Speciale XSP|ADP voor Webex voor Cisco BroadWorks

3

Afzonderlijke XSP|ADP voor NPS, kan worden gedeeld met andere oplossingen die NPS gebruiken.

Als u een bestaande collaboratieve implementatie hebt, bekijk dan de aanbevelingen voor XSP|ADP- en NPS-configuraties.

4

CI-tokenvalidatie (met TLS) geconfigureerd voor Webex-verbindingen met de verificatieservice.

5

mTLS geconfigureerd voor Webex-verbindingen met de CTI-interface.

Andere toepassingen vereisen geen mTLS.

6

Gebruikers moeten bestaan in BroadWorks en hebben de volgende kenmerken nodig, afhankelijk van uw provisioningsbeslissing:

  • Doorstromen met vertrouwde e-mails: Het e-mailkenmerk van de BroadWorks-gebruiker moet een geldig e-mailadres bevatten, uniek voor die gebruiker. Gebruiker moet ook een primair nummer of extensie hebben.

  • U kunt doorstromen met niet-vertrouwde e-mails, selfactivering of API-provisioning: Gebruiker heeft geen e-mailadres nodig, maar moet een primair nummer of extensie hebben.

Voor vertrouwde e-mails: We raden u aan hetzelfde e-mailadres ook in het kenmerk Alternatieve id te gebruiken, zodat gebruikers zich met hun e-mailadres kunnen aanmelden bij BroadWorks.

Voor niet-vertrouwde e-mails: Afhankelijk van de e-mailinstellingen van de gebruiker kan het gebruik van niet-vertrouwde e-mails ertoe leiden dat de e-mail wordt verzonden naar de map Met ongewenste mail of spam van de gebruiker. De beheerder moet mogelijk de e-mailinstellingen van de gebruiker wijzigen om domeinen toe te staan

7

Webex voor Cisco BroadWorks DTAF-bestand voor Webex-app

8

BW Business Lic of Std Enterprise of Prem Enterprise-gebruiker Lic + Webex voor Cisco BroadWorks-abonnement

Als u een bestaande samenwerkingsimplementatie hebt, hebt u de UC-One Add-On Bundle, Collab Lic en Meet-me-conferentiepoorten niet meer nodig.

Als u een bestaande UC-One SaaS-implementatie hebt, zijn er geen andere wijzigingen dan het accepteren van premium pakketvoorwaarden.

9

IP/poorten moeten toegankelijk zijn via de Webex backend-services en de Webex-apps via openbaar internet.

Zie het gedeelte 'Uw netwerk voorbereiden'.

10

TLS v1.2 Configuratie op XSP|ADP's

11

Voor Flowthrough-provisioning moet de toepassingsserver verbinding maken met de BroadWorks-provisioningadapter.

We testen of ondersteunen de uitgaande proxyconfiguratie niet. Als u een uitgaande proxy gebruikt, accepteert u de verantwoordelijkheid voor de ondersteuning ervan met Webex voor Cisco BroadWorks.

Zie het onderwerp 'Uw netwerk voorbereiden'.

Over dit document

Het doel van dit document is om u te helpen uw Webex-oplossing voor Cisco BroadWorks te begrijpen, voor te bereiden en te implementeren en te beheren. De belangrijkste gedeelten in het document geven dit doel weer.

Deze handleiding bevat conceptuele en referentiemateriaal. Wij zullen alle aspecten van de oplossing in dit document behandelen.

De minimale set taken om de oplossing te implementeren is:

Diagram of five of the minimum set of tasks to deploy the solution
  1. Bereik uw accountteam om een Cisco-partner te worden. Het is noodzakelijk dat u de Cisco touch points verkent om uzelf te vertrouwd te maken (en opgeleid te worden). Wanneer u een Cisco-partner wordt, passen we de schakelaar Webex voor Cisco BroadWorks toe aan uw Webex-partnerorganisatie. (Zie Webex inzetten voor Cisco BroadWorks > Partner Onboarding in dit document.)

  2. Configureer uw BroadWorks-systemen voor integratie met Webex. (Zie Webex implementeren voor Cisco BroadWorks > Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's in dit document.)

  3. Gebruik Partner Hub om Webex te verbinden met BroadWorks. (Zie Webex inzetten voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)

  4. Gebruik Partner Hub om gebruikersvoorzieningen sjablonen voor te bereiden. (Zie Webex inzetten voor Cisco BroadWorks > Uw inwerksjablonen configureren in dit document.)

  5. Een klant testen en aan boord krijgen door minstens één gebruiker te leveren. (Zie Webex inzetten voor Cisco BroadWorks > Uw testorganisatie configureren.)

  • Dit zijn stappen van hoog niveau, in de gebruikelijke volgorde. Er zijn verschillende bijdragende taken die u niet kunt negeren.

  • Als u uw eigen applicaties wilt aanmaken om uw Webex voor Cisco BroadWorks-abonnees te beheren, leest u Using the Provisioning API in het gedeelte Reference van deze gids.

Terminologie

We proberen het jargon en de acroniemen die in dit document worden gebruikt te beperken en om elke term uit te leggen wanneer ze voor het eerst worden gebruikt. (Zie Webex for Cisco BroadWorks Reference > Terminology als een term niet in de context wordt uitgelegd.)

Hoe werkt het

Webex voor Cisco BroadWorks is een aanbod dat Bellen via BroadWorks integreert in Webex. Abonnees gebruiken één toepassing (de Webex-app) om te profiteren van de functies van beide platforms:

  • Gebruikers bellen PSTN via uw BroadWorks-infrastructuur.

  • Gebruikers bellen andere BroadWorks-nummers met behulp van uw BroadWorks-infrastructuur (audio-/video-oproepen door de nummers te selecteren die aan de gebruikers of het toetsenblok zijn gekoppeld om de nummers te introduceren).

  • Gebruikers kunnen, als alternatief, een Webex VOIP Call maken via de Webex Infrastructure door de optie “Webex Call” te selecteren op de Webex app. (Deze oproepen zijn Webex app naar Webex app, niet Webex app naar PSTN).

  • Gebruikers kunnen hosten en deelnemen aan Webex Meetings.

  • Gebruikers kunnen elkaar een-op-een berichten sturen of in ruimten (permanente groepschat) en profiteren van functies als zoeken en bestanden delen (in een Webex-infrastructuur).

  • Gebruikers kunnen aanwezigheid (status) delen. Ze kunnen aangepaste aanwezigheid of op klanten berekende aanwezigheid kiezen.

  • Nadat we u hebben geïntegreerde als een partnerorganisatie in Control Hub, met de juiste rechten, kunt u de relatie tussen uw BroadWorks-instantie en Webex configureren.

  • U maakt klantorganisaties in Control Hub en provisioneert gebruikers in die organisaties.

  • Elke abonnee in BroadWorks krijgt een Webex-identiteit op basis van zijn of haar e-mailadres (kenmerk E-mail-id in BroadWorks).

  • Gebruikers verifiëren tegen BroadWorks of tegen Webex.

  • Clients krijgen lange tokens om deze te machtigen voor services bij BroadWorks en Webex.

Overview of Webex for BroadWorks

De Webex-app is het midden van deze oplossing; het is een merktoepassing die beschikbaar is op de Mac/Windows-desktops en android/iOS mobiele en tablets.

Er is ook een webversie van de Webex-app die momenteel geen belfuncties bevat.

De client maakt verbinding met de Webex-cloud om berichten, aanwezigheids- en vergaderingsfuncties te leveren.

De client wordt geregistreerd bij uw BroadWorks-systemen voor belfuncties.

De Webex-cloud werkt met uw BroadWorks-systemen om een naadloze gebruikersvoorzieningen ervaring te garanderen.

Overview of Webex for BroadWorks

Functies en beperkingen

We bieden verschillende pakketten met verschillende functies.

Softphone-pakket

Dit pakkettype gebruikt de Webex-app als een softphone-client met gespreksmogelijkheid, maar geen berichtmogelijkheden. Gebruikers met dit pakkettype kunnen deelnemen aan Webex-vergaderingen, maar kunnen geen vergaderingen zelf starten. Wanneer andere gebruikers (softphone of niet-softphone) in de telefoonlijst zoeken naar een softphonegebruiker, bieden de zoekresultaten geen optie om een bericht te verzenden.

Softphonegebruikers kunnen hun scherm delen tijdens een gesprek.

Basispakket

Het basispakket omvat functies voor bellen, berichten verzenden en vergaderen. Het omvat 100 deelnemers aan vergaderingen. (** zie onderstaande opmerking voor uitzondering). In dit pakket kunnen de vergaderingen maximaal 40 minuten duren.

Standaardpakket

Dit pakket bevat ook alles in het Basic pakket plus extra vergaderfuncties zoals Closed Captions, Real Time Transcriptie van 5 hoofdtalen, Cisco AI Assistant en polling & Q&A van Slido.

Premium-pakket

Dit pakket bevat alles in het standaardpakket plus tot 300 deelnemers aan een 'Unified Space'-vergadering en tot 1000 deelnemers in een Personal Meeting Room (PMR), cloudopname van vergaderingen en geavanceerde berichtenfuncties waaronder de Cisco AI Assistant.

'Unified Space Meetings' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in een Webex-ruimte. Een gebruiker start bijvoorbeeld een vergadering vanuit de ruimte via de knoppen 'Meet' of 'Schedule'.

Pakketten vergelijken

Pakket

Oproepen

Berichten

Verenigde Ruimtevaartorganisatie

PMR Meetings

Softphone

Opgenomen

Niet opgenomen

Geen

Geen

Basis

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Standaard

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Premium

Opgenomen

Opgenomen

300 deelnemers

1000 deelnemers

'PMR Meetings' verwijst naar een Webex Meeting (gepland of niet-gepland) die plaatsvindt in de Personal Meeting Room (PMR) van een gebruiker. Deze vergaderingen gebruiken een speciale URL (bijvoorbeeld: cisco.webex.com/meet/roomOwnerUserID).

Functies voor chatten en vergaderen

Raadpleeg de volgende tabel voor ondersteuningsverschillen in functies voor PMR-vergaderingen voor Basic-, Standard- en Premium-pakketten.

Table 1. Feature Support Differences for PMR Meetings

Vergaderfunctie

Ondersteund met basispakket

Geleverd met standaardpakket

Ondersteund met Een nummerpakket

Opmerking

Vergaderduur

40 Minuten of minder

24 Uren

24 Uren

Bureaublad delen

Ja

Ja

Ja

Toepassingen delen

Ja

Ja

Ja

Chat met meerdere partijen

Ja

Ja

Ja

Whiteboarding

Ja

Ja

Ja

Wachtwoordbeveiliging

Ja

Ja

Ja

Web-app - geen downloaden of invoegingen (Gastervaring)

Ja

Ja

Ja

Ondersteuning voor koppelen met Webex-apparaten

Ja

Ja

Ja

Vloerbeheer (Eén dempen/Alles dempen)

Ja

Ja

Ja

Koppeling Persistente vergaderingen

Ja

Ja

Ja

Vergaderingssite-toegang

Ja

Ja

Ja

Deelnemen aan vergadering via VoIP

Ja

Ja

Ja

Vergrendeling

Ja

Ja

Ja

Besturingselementen voor presentator

Nee

Nee

Ja

Extern bureaubladbeheer

Ja

Ja

Ja

Aantal deelnemers

100

100

1000

Opname lokaal opgeslagen in het systeem

Ja

Ja

Ja

Opnemen in de cloud

Nee

Nee

Ja

Opnemen - Cloud-opslag

Nee

Nee

10GB per site

Opnametranscripties

Nee

Nee

Ja

Vergadering plannen

Ja

Ja

Ja

De functie Inhoud delen met externe integraties inschakelen

Nee

Nee

Ja

Wijziging van PMR url toestaan

Ja

Ja

Ja

Vergaderingen live streamen (bijv. op Facebook, Youtube)

Nee

Nee

Ja

Andere gebruikers in staat laten om namens hen vergaderingen te plannen

Nee

Nee

Ja

Een alternatieve host toevoegen

Ja

Ja

Ja

App-integratie (bijv. Zendesk, Slack)

Hangt af van de integratie

Hangt af van de integratie

Ja

Zie het deel App Integrations hieronder voor meer informatie over ondersteuning.

Integratie met Microsoft Office 365 Agenda

Ja

Ja

Ja

Integratie met Google Agenda's voor G Suite

Ja

Ja

Ja

Het Webex Help Center publiceert de functies en gebruikersgerichte documentatie voor Webex op help.webex.com. Lees de volgende artikelen voor meer informatie over de functies:

Gespreksfuncties

De gesprekservaring is vergelijkbaar met eerdere oplossingen die gebruikmaken van de BroadWorks-gespreksbeheermachine. Het verschil met UC-One Collaborate en UC-One SaaS is dat de Webex-app de primaire softclient is.

App-integraties

U kunt Webex voor Cisco BroadWorks integreren in de volgende toepassingen:

Ondersteuning voor Virtual Desktop Infrastructure (VDI)

Webex voor Cisco BroadWorks ondersteunt nu VDI-omgevingen (Virtual Desktop Infrastructure). Voor meer informatie over het inzetten van VDI-infrastructuur, zie Implementatiegids voor Webex voor Virtual Desktop Infrastructure (VDI).

IPv6-ondersteuning

Webex voor Cisco BroadWorks ondersteunt IPv6 adressering voor de Webex-app.

Pro-pakket voor Control Hub

Pro-pakket voor de invoegservice van Control Hub biedt uw beheerders, informatiebeveiligings professionals en nalevings functionarissen met geavanceerde functionaliteit in beveiliging, naleving en analyses die kunnen integreren met uw software.

Deze aanvullende diensten zijn alleen beschikbaar voor Standard- en Premium-pakketten.

Voor meer informatie, zie de Helppagina van Pro Pack voor Control Hub.

Toekomstige roadmap

Voor meer informatie over onze intenties voor de toekomstige versies van Webex voor Cisco BroadWorks, ga naar https://salesconnect.cisco.com/#/program/PAGE-16649. De roadmap-items zijn in geen enkele capaciteit binden. Cisco behoudt zich het recht voor om deze items in toekomstige releases achter te houden of te herzien.

Beperkingen

Beperkingen voor inrichting

Tijdzone van vergaderingssite

De tijdzone van de eerste abonnee voor elk pakket wordt de tijdzone voor de Webex Meetings-site die voor dat pakket is gemaakt.

Als er geen tijdzone is opgegeven in het inrichtingsverzoek voor de eerste gebruiker van elk pakket, wordt de tijdzone van de Webex Meetings-site voor dat pakket ingesteld op de regionale standaard van de organisatie van abonnees.

Als uw klant een specifieke tijdszone Webex Meetings site nodig heeft, geeft u de timezone parameter in het inrichtingsverzoek voor:

  • de eerste abonnee die is ingericht voor Standaard-pakket in de organisatie.

  • de eerste abonnee die is ingericht voor Premium-pakket in de organisatie.

  • de eerste abonnee voorzien voor Basic pakket in de organisatie.

Algemene beperkingen

  • Webex voor Intune wordt niet ondersteund voor Webex voor Cisco BroadWorks-implementaties.

  • Geen inbellen in de webversie van de Webex-client (Dit is een clientbeperking, geen oplossingsbeperking.)

  • Webex heeft mogelijk nog niet alle bedieningselementen voor gebruikersinterface's om bepaalde gespreksbeheerfuncties te ondersteunen die beschikbaar zijn in BroadWorks.

  • De Webex-client kan momenteel niet “White Labeled” zijn.

  • Wanneer u klantorganisaties maakt via uw gekozen inrichtingsmethode, worden deze automatisch gemaakt in dezelfde regio als uw partnerorganisatie. Dit gedrag is zo bepaald. We verwachten dat multinationale partners een partnerorganisatie maken in elke regio waar ze organisaties van klanten beheren.

  • Rapportage over vergaderingen en het gebruik van berichten is beschikbaar via de klantorganisatie in Control Hub.

Bekende problemen en beperkingen

Voor een actuele lijst met bekende problemen en beperkingen met het Webex voor Cisco BroadWorks-aanbod, zie Bekende problemen en beperkingen.

Limieten voor berichten

De volgende opslaglimieten voor gegevens (berichten en bestanden gecombineerd) zijn van toepassing op organisaties die Webex hebben gekocht voor Cisco BroadWorks-services via serviceprovider. Deze limieten vertegenwoordigen de maximale opslag voor berichten en bestanden bij elkaar.

  • Basis: 2 GB per gebruiker voor 3 jaren

  • Standaard 5 GB per gebruiker voor 3 jaren

  • Premium: 10 GB per gebruiker voor 5 jaren

Voor de organisatie van elke klant worden deze totaalen per gebruiker samengevoegd om een totaal aan totaal voor die klant op basis van het aantal gebruikers te verstrekken. Zo heeft een bedrijf met vijf premium gebruikers een totale limiet voor de opslag van berichten en bestanden van 50 GB. Een individuele gebruiker kan de limiet per gebruiker (10 GB) overschrijden op voorwaarde dat het bedrijf nog steeds onder het geaggregeerde maximum (50 GB) ligt.

Voor teamruimten die worden gemaakt, zijn de berichtlimieten van toepassing op het totaal van de klantorganisatie die eigenaar is van de teamruimte. In het Ruimtebeleid kunt u informatie vinden over de eigenaar van individuele teamruimten. Voor informatie over hoe u het ruimtebeleid voor een individuele teamruimte kunt bekijken, zie https://help.webex.com/nl/baztm6/Webex-ruimtebeleid.

Aanvullende informatie

Voor meer informatie over algemene berichtenlimieten die gelden voor Webex-berichtenteamruimten, verwijzen we naar https://help.webex.com/nl/n8Categorie: Volkswagen82eb/webex-capaciteiten.

Beveiliging, gegevens en rollen

Webex-beveiliging

De Webex-client is een veilige toepassing die beveiligde verbindingen met Webex en BroadWorks maakt. De gegevens die in de Webex-cloud worden opgeslagen en open staan voor de gebruiker via de Webex-app-interface, worden zowel tijdens de overdracht als in de rest gecodeerd.

Meer details over gegevensuitwisselingin de sectie Referentie van dit document.

Aanvullende lezen

Gegevens-residentie van organisatie

We slaan uw Webex-gegevens op in het datacenter dat het meest overeenkomt met uw regio. Zie Data Residency in Webexin het Help Center.

Rollen

Serviceproviderbeheerder (u): Voor dagelijkse onderhoudsactiviteiten beheert u de onderdelen van de oplossing op locatie (bellen) met uw eigen systemen. U beheert de Webex-onderdelen van de oplossing via partnerhub.

Voor informatie over de rollen die beschikbaar zijn voor partners, de toegangsprivileges die deze rollen begeleiden en hoe rollen toe te wijzen, zie Partner Administrator Rollen voor Webex voor BroadWorks en Wholesale RTM.

De eerste gebruiker die is toegewezen aan een nieuwe partner organizaiton wordt automatisch toegewezen aan de rollen Full Administrator en Full Partner Administrator. Die beheerder kan het bovenstaande artikel gebruiken om extra rollen toe te wijzen.

Het Cisco-cloudbewerkingsteam: Maakt uw 'partnerorganisatie' in Partnerhub, als deze niet bestaat, tijdens uw onboarding.

Zodra u uw partnerhubaccount hebt, configureert u de Webex-interfaces op uw eigen systemen. Vervolgens maakt u “Inwerksjablonen” aan om de suites of pakketten te vertegenwoordigen die via deze systemen worden bediend. U kunt vervolgens uw klanten of abonnees inrichten.

#

Gebruikelijke taak

SP

Cisco

1

Partner onboarding - De partner organisatie maken als deze niet bestaat en het inschakelen van de nodige functie schakelaars

2

BroadWorks-configuratie in partner organisatie via Partner Hub (cluster)

3

Integratie-instellingen in partner organisatie configureren via Partner Hub (aanbodsjablonen, branding)

4

BroadWorks-omgeving voorbereiden voor integratie (AS, XSP|ADP Patching, firewalls, XSP|ADP configuratie, XSI, AuthService, CTI, NPS, DMS-toepassingen op XSP|ADP)

5

Provisioningintegratie of -proces ontwikkelen

6

GTM-materialen voorbereiden

7

Nieuwe gebruikers migreren of inrichten

Architectuur

Overzicht van Webex voor BroadWorks

Wat staat er in het overzicht?

Clients

  • De Webex App-client wordt gebruikt als de primaire toepassing in Webex voor Cisco BroadWorks-aanbiedingen. De client is beschikbaar voor desktop-, mobiele en webplatforms.

    De client heeft eigen berichten, aanwezigheidsberichten en audio-/videovergaderingen met meerdere deelnemers die worden geleverd door de Webex-cloud. De Webex-client maakt gebruik van uw BroadWorks-infrastructuur voor SIP PSTN gesprekken.

  • Cisco IP-telefoons en gerelateerde accessoires maken ook gebruik van uw BroadWorks-infrastructuur voor SIP- PSTN gesprekken. We verwachten ondersteuning te kunnen bieden voor telefoons van derden.

  • Gebruikers activeren Portal voor gebruikers om zich aan te melden bij Webex met behulp van hun BroadWorks-aanmeldgegevens.

  • Partner Hub is een webinterface voor het beheren van uw Webex-organisatie en van de organisaties van uw klanten. Partner Hub is waar u de integratie tussen uw BroadWorks-infrastructuur en Webex configureert. U kunt ook partnerhub gebruiken om de clientconfiguratie en facturering te beheren.

serviceprovider netwerk

Het groene blok links van het diagram staat voor uw netwerk. Onderdelen die in uw netwerk worden gehost, bieden de volgende services en interfaces aan andere delen van de oplossing:

  • XSP|ADP, voor Webex voor Cisco BroadWorks: (De doos staat voor één of meerdere XSP|ADP boerderijen, mogelijk fronted door load balancers.)

    • Host de Xtended Services Interface (XSI-Actions & XSI-Events), device beheerservice (DMS), de CTI-interface en de verificatieservice. Deze toepassingen maken het mogelijk voor telefoons en Webex-clients om zich te legitimeren, configuratiebestanden voor gesprekken te downloaden, oproepen uit te voeren en te ontvangen en elkaars hook-status (telefonische aanwezigheid) en gespreksgeschiedenis.

    • Directory naar Webex-clients publiceert.

  • Publiek gerichte XSP|ADP, met NPS:

    • host gespreksmeldingen pushserver: Een Notification Push Server op een XSP|ADP in uw omgeving. Dit is een interface tussen uw toepassingsserver en onze NPS-proxy. De proxy levert op korte termijn tokens aan uw NPS om meldingen aan de cloudservices te autoreren. Deze services (APNS & FCM) verzenden oproepmeldingen naar Webex-clients op Apple iOS- en Google Android-apparaten.

  • Toepassingsserver:

    • Biedt gespreksbeheer en interfaces voor andere BroadWorks-systemen (over het algemeen)

    • Voor flowthrough-provisioning wordt as door een partnerbeheerder gebruikt om gebruikers in Webex in te stellen

    • De gebruikersprofiel naar BroadWorks wordt pushen

  • OSS/BSS: Uw Operations Support System/Business SIP-services voor het beheren van uw BroadWorks-ondernemingen.

Webex Cloud

Het blauwe blok in het diagram staat voor de Webex-cloud. Webex-microservices ondersteunen het volledigespectrum van de Webex-samenwerkingsfuncties:

  • Cisco Common Identity (CI) is de identiteitsservice binnen Webex.

  • Webex voor Cisco BroadWorks vertegenwoordigt de set microservices die de integratie tussen Webex en serviceprovider Hosted BroadWorks ondersteunen:

    • Gebruikersvoorzieningen API's

    • serviceprovider configureren

    • Gebruikers aanmelden met BroadWorks-aanmeldgegevens

  • Webex Messaging-box voor microservices met betrekking tot berichten.

  • Webex Meetings-vak voor mediaverwerkingsservers en SCS voor videovergaderingen met meerdere deelnemers (SIP & SRTP)

Webservices van derden

De volgende onderdelen van derden zijn in het diagram weergegeven:

  • APNS (Apple Push Notifications Service) pusht oproep- en berichtmeldingen naar Webex-toepassingen op Apple-apparaten.

  • FCM (FireBase Cloud Messaging) pusht oproep- en berichtmeldingen naar Webex-toepassingen op Android-apparaten.

XSP|ADP Architectuur Overwegingen

De rol van publiek gerichte XSP|ADP-servers in Webex voor Cisco BroadWorks

De public facing XSP|ADP in uw omgeving biedt de volgende interfaces/diensten aan Webex en klanten:

  • Verificatieservice (AuthService), beveiligd door TLS, die reageert op Webex-aanvragen voor BroadWorks JWT (JSON-web token) namens gebruikers

  • CTI-interface, beveiligd door mTLS, waarbij Webex zich abonneert voor gespreksgeschiedenis gebeurtenissen en de aanwezigheidsstatus van telefonie van BroadWorks (hook-status).

  • Xsi-interfaces voor acties en gebeurtenissen (eXtended Services Interface) voor gespreksbeheer van abonnees, telefoonlijstdirecties van contactpersonen en gesprekslijsten en configuratie van telefoonservices voor eindgebruikers

  • DM (Device Management)-service voor clients om de configuratiebestanden voor bellen op te halen

URL's voor deze interfaces leveren wanneer u Webex configureert voor Cisco BroadWorks. (Zie Configure your BroadWorks Clusters in Partner Hub in dit document.) Voor elk cluster kunt u slechts één URL opgeven voor elke interface. Als u meerdere interfaces in uw BroadWorks-infrastructuur hebt, kunt u meerdere clusters maken.

XSP|ADP-architectuur

Diagram of XSP|ADP Architecture: Option 1
XSP|ADP-architectuur: Optie 1

Diagram of XSP|ADP Architecture: Option 2
XSP|ADP-architectuur: Optie 2

We vereisen dat u een aparte, speciale XSP|ADP instantie of farm gebruikt om uw NPS (Notification Push Server) applicatie te hosten. U kunt dezelfde NPS gebruiken met UC-One SaaS of UC-One Collaborate. Het is echter mogelijk dat u de andere applicaties die nodig zijn voor Webex voor Cisco BroadWorks niet hosten op dezelfde XSP|ADP die de NPS-applicatie host.

We raden u aan om een speciale XSP|ADP instantie/boerderij te gebruiken om de vereiste applicaties voor Webex-integratie te hosten om de volgende redenen

  • Als u bijvoorbeeld UC-One SaaS aanbiedt, raden we aan om een nieuwe XSP|ADP-boerderij voor Webex te maken voor Cisco BroadWorks. Op deze manier kunnen de twee services zelfstandig werken terwijl u abonnees migreert.

  • Als u de Webex voor Cisco BroadWorks-toepassingen samenlokaliseert op een XSP|ADP-boerderij die voor andere doeleinden wordt gebruikt, is het uw verantwoordelijkheid om het gebruik te controleren, de resulterende complexiteit te beheren en de verhoogde schaal te plannen.

  • De Cisco BroadWorks systeemcapaciteitsplannergaat uit van een speciale XSP|ADP boerderij en is mogelijk niet nauwkeurig als u het gebruikt voor collocatie berekeningen.

Tenzij anders vermeld, moet de speciale Webex voor Cisco BroadWorks XSP|ADP's de volgende applicaties hosten:

  • AuthService (TLS met validatie van CI-token of mTLS)

  • CTI (mTLS)

  • XSI-acties (TLS)

  • XSI-Events (TLS)

  • DMS (TLS)—Optioneel. Het is niet verplicht om een aparte DMS instance of farm specifiek voor Webex in te zetten voor Cisco BroadWorks. U kunt dezelfde DMS-instantie gebruiken die u gebruikt voor UC-One SaaS of UC-One Collaborate.

  • Call Settings Webview (TLS)—Optioneel. Oproepinstellingen Webview (CSW) is alleen vereist als u wilt dat Webex voor Cisco BroadWorks-gebruikers de oproepfuncties in de Webex-app kunnen configureren.

Webex vereist toegang tot CTI via een interface die is beveiligd door gemeenschappelijke TLS cti. Als u deze vereiste wilt ondersteunen, raden we een van de volgende opties aan:

  • (Diagram met de naam Optie 1) Eén XSP|ADP-instantie of -farm voor alle toepassingen, met twee interfaces geconfigureerd op elke server: een mTLS-interface voor CTI en een TLS-interface voor andere apps zoals de AuthService.

  • (Diagram met de naam Optie 2) Twee XSP|ADP-instanties of -bedrijven, één met een mTLS-interface voor CTI, en de andere met een TLS-interface voor andere apps, zoals de AuthService.

XSP|ADP Hergebruik

Als u een bestaande XSP|ADP-boerderij hebt die voldoet aan een van de voorgestelde architecturen hierboven (optie 1 of 2) en die licht geladen is, dan is het mogelijk om uw bestaande XSP|ADP's te hergebruiken. U moet controleren of er geen tegenstrijdige configuratievereisten zijn tussen bestaande applicaties en de nieuwe applicatievereisten voor Webex. De twee belangrijkste overwegingen zijn:

  • Als u meerdere webex-partnerorganisaties op de XSP|ADP moet ondersteunen, dan betekent dit dat u mTLS moet gebruiken op de Auth Service (CI Token Validation wordt alleen ondersteund voor één partnerorganisatie op een XSP|ADP). Als u mTLS op de verificatieservice gebruikt, betekent dit dat u geen clients kunt hebben die tegelijkertijd basisverificatie op de verificatieservice gebruiken. Deze situatie zou hergebruik van de XSP|ADP voorkomen.

  • Als de bestaande CTI-dienst geconfigureerd is om te worden gebruikt door klanten met de beveiligde poort (meestal 8012) maar zonder mTLS (d.w.z. clientverificatie), dan zal dat in strijd zijn met de webex-vereiste om mTLS te hebben.

Omdat de XSP|ADP’s veel toepassingen hebben en het aantal permutaties van deze toepassingen groot is, kunnen er andere niet-geïdentificeerde conflicten zijn. Om deze reden moet elk potentieel hergebruik van XSP|ADP's in een laboratorium met de beoogde configuratie worden geverifieerd voordat het hergebruik wordt toegestaan.

NTP-synchronisatie configureren op XSP|ADP

De implementatie vereist tijdsynchronisatie voor alle XSP|ADP's die u met Webex gebruikt.

Installeer de ntp pakket nadat u het besturingssysteem hebt geïnstalleerd en voordat u de BroadWorks-software installeert. Vervolgens kunt u NTP configureren tijdens de XSP|ADP software installatie. Zie de BroadWorks Software Management Guide voor meer informatie.

Tijdens de interactieve installatie van de XSP|ADP software krijgt u de mogelijkheid om NTP te configureren. Ga als volgt te werk:

  1. Wanneer het installatieprogramma u vraagt, Do you want to configure NTP?Voer y.

  2. Wanneer het installatieprogramma u vraagt, Is this server going to be a NTP server?Voer n.

  3. Wanneer het installatieprogramma u vraagt, What is the NTP address, hostname, or FQDN?, geef het adres op van uw NTP-server of een openbare NTP-service, bijvoorbeeld, pool.ntp.org.

Als uw XSP|ADP's stille (niet-interactieve) installatie gebruiken, moet het installatieconfiguratiebestand de volgende Key=Value paren bevatten:

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

XSP|ADP Identiteits- en beveiligingsvereisten

Achtergrond

De protocollen en versleutelingen van Cisco BroadWorks TLS-verbindingen kunnen worden geconfigureerd op verschillende specificiteitsniveaus. Deze niveaus variëren van de meest algemene (SSL-provider) tot de meest specifieke (afzonderlijke interface). Een specifiekere instelling overschrijven altijd een algemenere instelling. Als deze niet zijn gespecificeerd, worden SSL-instellingen op een lager niveau overgenomen van 'hogere' niveaus.

Als de instellingen niet worden gewijzigd van de standaardinstellingen, worden de standaardinstellingen van de SSL-provider overgenomen door alle niveaus (JSSE Java Secure Sockets Extension).

Lijst met vereisten

  • De XSP|ADP moet zich authenticeren aan klanten met behulp van een CA-ondertekend certificaat waarin de Common Name of Subject Alternate Name overeenkomt met het domeingedeelte van de XSI-interface.

  • De Xsi-interface moet het TLSv1.2-protocol ondersteunen.

  • De Xsi-interface moet een codesuite gebruiken die aan de volgende vereisten voldoet.

    • Diffie-Hellman Epmingeral (DHE) of Elliptic Curves Diffie-Hellman Epmingeral (ECDHE) sleutel-exchange

    • AES (Advanced Encryption Standard) cipher met een minimale blokgrootte van 128 bits (bijv. AES-128 of AES-256)

    • GCM (Galois/Counter Mode) of CBC (Code Block Chaining) codemodus

      • Als een CBC-sleutel wordt gebruikt, is alleen de SHA2-familie van hash-functies toegestaan voor sleutelafleiding (SHA256, SHA384, SHA512).

De volgende versleutelingen voldoen bijvoorbeeld aan de vereisten:

  • 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

De XSP|ADP CLI vereist de IANA naamgevingsconventie voor cipher suites, zoals hierboven weergegeven, niet de openSSL conventie.

Ondersteunde TLS-versleutelingen voor de interfaces AuthService en XSI

Deze lijst kan worden gewijzigd zodra onze vereisten voor cloudbeveiliging ontwikkelen. Volg de huidige aanbeveling voor De cloudbeveiliging van Cisco voor codeselectie, zoals beschreven in de vereistenlijst in dit document.

  • 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 Events-schaalparameters

Mogelijk moet u de grootte van de Xsi-Events-wachtrij en het aantal threads verhogen om het volume gebeurtenissen af te handelen dat de Webex-oplossing voor Cisco BroadWorks vereist. U kunt de parameters als volgt vergroten tot de minimumwaarden (ze niet verlagen als ze boven deze minimumwaarden liggen):

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

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

Meerdere XSP|ADP's

Edge-element voor load balancing

Als u een load balancing element op uw netwerk edge, moet het transparant omgaan met de distributie van verkeer tussen uw meerdere XSP|ADP servers en de Webex voor Cisco BroadWorks cloud en clients. In dit geval geeft u de URL van de load-balancer op bij de Webex voor Cisco BroadWorks-configuratie.

Diagram van Load Balancing Edge Element met meerdere XSP|ADP's

Aantekeningen over deze architectuur:

  • Configureer DNS zodat de clients de lastbalancer kunnen vinden bij het verbinden met de Xsi-interface (zie DNS-configuratie).

  • We raden u aan het edge-element in de reverse SSL-proxymodus te configureren om point-to-pointgegevenscodering te garanderen.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het domein XSP|ADP hebben, bijvoorbeeld your-XSP|ADP.example.com, in de Subject Alternate Name. Ze moeten hun eigen FQDN’s hebben, bijvoorbeeld XSP|ADP01.example.com, in de Common Name. U kunt jokercertificaten gebruiken, maar deze worden niet aanbevolen.

XSP|ADP-servers voor internetdoeleinden

Als u de Xsi-interfaces direct blootstelt, gebruik dan DNS om het verkeer te distribueren naar de meerdere XSP|ADP-servers.

Diagram van Internet-Facing XSP|ADP Servers

Aantekeningen over deze architectuur:

  • Er zijn twee records nodig om verbinding te maken met de XSP|ADP-servers:

    • Voor Webex microservices: Round-robin A/AAAA records zijn vereist om de meerdere XSP|ADP IP adressen te targeten. Dit komt omdat de Webex-microservices geen SRV-lookups kunnen doen. Voor voorbeelden, zie Webex Cloud-diensten.

    • Voor de Webex-app: Een SRV-record dat oplost naar A-records, waarbij elk A-record oplost naar een enkele XSP|ADP. Voor voorbeelden, zie Webex-app.

      Gebruik geprioriteerde SRV-records om de XSI-service te richten voor de meerdere XSP|ADP-adressen. Geef prioriteit aan uw SRV-records zodat de microservices altijd naar dezelfde A-record (en het daaropvolgende IP-adres) gaan en alleen naar de volgende A-record (en het IP-adres) gaan als het eerste IP-adres omlaag is. Gebruik GEEN round-robin aanpak voor de Webex App.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het domein XSP|ADP hebben, bijvoorbeeld your-XSP|ADP.example.com, in de Subject Alternate Name. Ze moeten hun eigen FQDN’s hebben, bijvoorbeeld XSP|ADP01.example.com, in de Common Name.

  • U kunt jokercertificaten gebruiken, maar deze worden niet aanbevolen.

Http-omleidingen voorkomen

Soms is DNS geconfigureerd om de XSP|ADP URL op te lossen naar een HTTP load balancer, en de load balancer is geconfigureerd om door middel van een reverse proxy naar de XSP|ADP servers te leiden.

Webex volgt geen redirect bij het verbinden met de URL’s die je aanlevert, dus deze configuratie werkt niet.

Diagram van mislukte HTTP-redirect bij het verbinden met de door u geleverde URL's.

Bestellen en inrichten

Bestelling en inrichting zijn van toepassing op deze niveaus:

  • Voorziening Partner/Dienstverlener:

    Elke geïntegreerde Webex voor Cisco BroadWorks serviceprovider (of reseller) moet worden geconfigureerd als partnerorganisatie in Webex en de benodigde rechten krijgen. Cisco Operations biedt de beheerder van de partnerorganisatie toegang tot het beheren van Webex voor Cisco BroadWorks op Webex Partner Hub. De partnerbeheerder moet alle vereiste provisioningsstappen uitvoeren voordat hij of zij een klant-/enterprise-organisatie kan inrichten.

  • Bestelling en levering door klant/onderneming:

    Elke BroadWorks Enterprise ingeschakeld voor Webex voor Cisco BroadWorks leidt tot het maken van een gekoppelde Webex-klantorganisatie. Dit proces vindt automatisch plaats als onderdeel van de inrichting van gebruikers/abonnees. Alle gebruikers/abonnees binnen een BroadWorks-onderneming worden ingericht in dezelfde Webex-klantorganisatie.

    Hetzelfde gedrag is van toepassing als uw BroadWorks-systeem is geconfigureerd als een serviceprovider met Groepen. Als u een abonnee in een BroadWorks-groep inrichten, wordt er automatisch een klantorganisatie die correspondeert met de groep in Webex gemaakt.

  • Bestelling en levering door gebruiker/abonnee:

    Webex voor Cisco BroadWorks ondersteunt momenteel de volgende modellen voor gebruikers provisioning:

    • Doorstromen door de inrichting met vertrouwde e-mails

    • Doorstromen zonder vertrouwde e-mails

    • Zelfvoorzieningen voor gebruikers

    • API-provisioning

Doorstroomvoorziening met vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een URL voor Webex-provisioning te gebruiken en de service vervolgens toe te wijzen aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u kunt melden dat BroadWorks e-mailadressen van abonnees heeft die geldig zijn en uniek zijn voor Webex, worden met deze provisioningoptie automatisch Webex-accounts met die e-mailadressen als gebruikers-ip's gemaakt en geactiveerd.

U kunt het abonneepakket wijzigen via Partner hub of u kunt uw eigen toepassing schrijven om de provisioning-API te gebruiken om abonneepakketten te wijzigen.

 A diagram of Flowthrough Provisioning with Trusted Emails
Doorstroomvoorziening met vertrouwde e-mails

Doorstromen zonder vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een URL voor Webex-provisioning te gebruiken en de service vervolgens toe te wijzen aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u niet kunt vertrouwen op de e-mailadressen van abonnees die door BroadWorks worden gehouden, maakt deze provisioningoptie Webex-accounts, maar kan deze niet worden geactiveerd totdat abonnees hun e-mailadressen hebben verstuurd en gevalideerd. Vanaf dat moment kan Webex de accounts met die e-mailadressen als gebruikers-ip-adressen activeren.

Diagram displaying Flowthrough Provisioning Without Trusted Emails
Doorstroomvoorziening zonder vertrouwde e-mails

U kunt het abonneepakket wijzigen via Partner hub of u kunt uw eigen toepassing schrijven om de provisioning-API te gebruiken om abonneepakketten te wijzigen.

Zelfvoorzieningen voor gebruikers

Met deze optie is er geen doorstroom-provisioning van BroadWorks naar Webex. Nadat u de integratie tussen Webex en uw BroadWorks-systeem hebt geconfigureerd, krijgt u een of meer koppelingen die specifiek zijn voor gebruikers in uw Webex-partnerorganisatie van Cisco BroadWorks.

Vervolgens ontwerpt u uw eigen communicatie (of gedelegeerde aan uw klanten) om de koppeling te distribueren aan abonnees. De abonnees volgen de koppeling. Vervolgens kunnen ze hun e-mailadressen toevoegen en valideren om hun eigen Webex-accounts te maken en activeren.

Diagram of User Self-Provisioning
Zelfvoorziening gebruiker

Aangezien de accounts binnen het bereik van uw partnerorganisatie vallen, kunt u gebruikerspakketten handmatig aanpassen via Partner Hub of u kunt de API gebruiken om dat te doen.

Gebruikers moeten bestaan in het BroadWorks-systeem dat u met Webex integreert, of het is hen niet toegestaan accounts met die koppeling te maken.

serviceprovider provisioning door API's

Webex biedt een set openbare API's waarmee u Webex kunt bouwen voor de gebruiker/abonnee van Cisco BroadWorks in uw bestaande workflow/tools voor gebruikersbeheer.

Diagram displaying Service Provider Provisioning by APIs - Trusted Emails
Serviceprovider Provisioning door API's - Vertrouwde e-mails
Diagram displaying the Service Provider Provisioning by APIs - Untrusted Emails
Serviceprovider Provisioning door API's - Niet-vertrouwde e-mails

Vereiste patches met doorstroomvoorzieningen

Als u flow-through provisioning gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-release:

Voor R22:

  1. Installeren Sjabloon: Navigatie Digimon22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true van het CLI in Maintenance/ContainerOptions.

    Voor meer informatie, zie de patch notes https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeren Sjabloon: Navigatie Digimon23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true van het CLI in Maintenance/ContainerOptions.

    Voor meer informatie, zie de patch notes https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeren Sjabloon: Navigatie Digimon24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true van het CLI in Maintenance/ContainerOptions.

    Voor meer informatie, zie de patch notes https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.

Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers meer inrichten met UC-One Collaborate-services. Nieuw in te stellen gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Uitbreiding kiezen

Ondersteuning voor Extension Dialing-functies stelt Webex voor Cisco Broadworks-gebruikers in staat om andere gebruikers te bellen met een extensie die vergelijkbaar is met het primaire telefoonnummer binnen dezelfde onderneming. Dit is vooral nuttig voor gebruikers die geen DID-nummers hebben.

Tijdens de provisioning wordt de extensie van de gebruikers opgeslagen in de Webex directory als extensie van de gebruiker. Voor BroadWorks-oproepen verschijnt de extensie op de Webex-app in het extensie-veld van alle zones van de oproepinitiatiemethode en het gebruikersprofiel. Webex voor Cisco BroadWorks ondersteunt alleen extensiegesprekken tussen gebruikers binnen dezelfde groep en verschillende groepen van dezelfde onderneming met de combinatie van locatiecodes en extensies. Oproepen tussen twee ondernemingen die alleen extensies gebruiken, wordt echter niet ondersteund.

Een uitbreiding kan worden voorzien voor de Cisco BroadWorks gebruikers via de volgende methoden:

  • Cisco BroadWorks-gebruikers

    • Openbare API-voorziening als ‘uitbreiding

      • De uitbreidingsparameter moet expliciet worden doorgegeven als onderdeel van de API-call. Voor bedrijven/groepen die Location Dialing Code (LDC) hebben geconfigureerd, moet de extensieparameter de combinatie van LDC en 'extensienummer zijn.

    • Doorstroomvoorziening of zelfactiveringsvoorziening

      • Extensie en LDC (indien van toepassing) worden automatisch opgehaald uit BroadWorks.

  • Alleen BroadWorks Oproepende gebruikers of entiteiten

    • Automatisch gesynchroniseerd van BroadWorks door Directory Sync met behulp van de combinatie van Location Dialing Code (LDC) en extensie nummer.

Table 2. Managing of Extension numbers based on provisioning method

BroadWorks-belrecords

Beschrijving

Voorzieningsmethode

Extensies beheren

Webex voor gebruikers van Cisco BroadWorks

Gebruikers zijn ingeschakeld voor Webex for Cisco BroadWorks

Publieke API

Extensie moet worden doorgegeven als parameter

Doorstroming

Extensie automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Oproepen van gebruikers die niet aan boord zijn van Webex

Synchroniseren met Directory

Extensie gesynchroniseerd door Directory sync

Entiteiten die niet bellen via een gebruiker

Bijvoorbeeld een telefoon conferentieruimte faxapparaat, Hunt-groepsnummer

Synchroniseren met Directory

Extensie gesynchroniseerd door Directory sync

BroadWorks-telefoonlijsten

Bedrijfs-, groep- of persoonlijke telefoonlijsten

Synchroniseren met Directory

Niet van toepassing

Voorwaarden

  1. De clientversie die nodig is om deze functie te ondersteunen is 42.11 of hoger.

  2. Patch waar uitbreiding- en locatiecodes worden toegevoegd aan XSI en Provisioning Adapter februari 2022 voor versie 23 of hoger als onderdeel van:

    • 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. Activeer de koptekst X-BroadWorks-Remote-Party-Info op de AS met het onderstaande CLI-commando voor deze SIP-oproepstroom die vereist is voor ondersteuning van de uitbreidingsfunctie.

    AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Prioriteit App-oproepopties

Als onderdeel van de ondersteuning van de Extension Dialing-functie, wordt De prioriteiteninstelling van de app-oproepopties ook op partnerniveau aangeboden voor alle Webex voor Cisco Broadworks-partners. Met deze instelling kan de partner de prioriteitsinstellingen van al zijn beheerde klanten beheren vanuit Partner Hub. De prioriteitsinstelling voor de belopties van de app voor een klant kan ook op klantniveau worden gewijzigd via Control Hub.

De prioriteitsinstelling voor belopties van de app bevat uitbreiding als tweede optie in zowel Partner Hub als Control Hub wanneer een Webex voor Cisco Broadworks-gebruiker nieuw is voorzien met uitbreiding via een van de bovengenoemde voorzieningsmethoden.

Voor alle bestaande provisioned Orgs, zal de extensie optie in de verborgen staat (standaard) zijn in de prioriteitsinstelling voor oproepopties van de app. Dit zal geen extensie tonen in de audio-/video-oproepoptie van de gebruiker in de Webex-app.

Hieronder volgen de opties om de optie Extension Call zichtbaar te maken voor de bestaande klanten:

  1. Als een partner wil dat al zijn beheerde klantenorganisaties een extensie krijgen als een van de callopties, wordt het aanbevolen dat de Partner Admin de extensie verplaatst van verborgen naar beschikbaar in Partner Hub. Hierdoor kunnen de organisaties van de beheerde klant de instelling van hun partner erven.

  2. Als een Partner een extensie wil voorzien in oproepopties voor een specifieke klantorganisatie, wordt het aanbevolen dat de Partner Admin de extensie verplaatst van verborgen naar beschikbaar in Control Hub.

Ondersteuning voor contactpersonen groep

Deze functie verbetert de Webex voor BroadWorks DirSync-service door de beperking voor het synchroniseren tot 1500 contactpersonen uit de telefoonlijsten van de groep op BroadWorks te verwijderen en door partners toe te staan om tot 30K-contactpersonen te synchroniseren van een enkele telefoonlijst van de groep en deze op gelijke hoogte te brengen met de 30K-contactpersonen toename voor Enterprise-telefoonlijst, die afzonderlijk werd vrijgegeven.

Er is een algemene limiet van 200K voor alle externe contacten per organisatie, die van toepassing zou zijn op de som van de telefoonlijsten van Enterprise en Group in één BroadWorks-onderneming. Zo zal een BroadWorks-onderneming met een telefoonlijst van Enterprise met 30K en ook 5 telefoonlijsten van Groep met elk 30K ondersteund worden (180K-totaal per organisatie). Als er echter 6 groepstelefoonlijsten zijn met elk 30K, wordt dit niet ondersteund (210K totaal).

Deze functie is op aanvraag beschikbaar. Neem contact op met uw accountteam om dit te laten activeren.

  • Voordat u de functie inschakelt, moet een vereiste migratie worden uitgevoerd naar provisie en geassocieerde groepen voor alle bestaande provisioned gebruikers.

  • Het Cisco-team zal een interne API uitvoeren om bestaande gebruikers te migreren om ze aan de juiste groep te koppelen. OPMERKING: Dit kan tot een week duren om te verwerken.

  • Zodra de migratie voor de partner is voltooid en de functie is ingeschakeld, worden alle nieuw voorziene gebruikers op passende wijze 'gegroepeerd'.

Nadat de functie is ingeschakeld, begint de DirSync-service met het synchroniseren van de telefoonlijstcontacten van de BroadWorks Group in de speciale contactopslag per groep in de Webex-contactservice.

Tijdens de voorziening moet de ondernemingsgroep van de gebruiker worden opgeslagen in de Webex-directory om aan te geven tot welke groep deze gebruiker behoort. De koppeling van de gebruiker met een BroadWorks-groep in de Webex Directory laat de Webex-app toe om contact te zoeken in de opslag van de Contact Service-groep voor de specifieke groep van de gebruiker.

De functie vereist dat de Webex voor BroadWorks abonnees in Webex worden voorzien van de BroadWorks enterprise Group Id.

De BroadWorks enterprise Group Id kan worden verstrekt voor de Cisco BroadWorks gebruikers via de volgende methoden:

  • Webex voor gebruikers van Cisco BroadWorks

    • Openbare API-voorziening als ‘spEnterpriseGroupId’

      • De BroadWorks enterprise Group Id moet expliciet worden doorgegeven in spEnterpriseGroupId-parameter van de API-call.

    • Doorstroomvoorziening of zelfactiveringsvoorziening

      • BroadWorks enterprise Group Id wordt automatisch opgehaald uit BroadWorks.

    • Alleen BroadWorks Oproepende gebruikers of entiteiten

      • Niet van toepassing. Het is niet nodig om BroadWorks enterprise Group Id voor deze gebruikers te synchroniseren.

Table 3. Managing of Enterprise Group ID based on provisioning method

BroadWorks-belrecords

Beschrijving

Voorzieningsmethode

ID bedrijfsgroep beheren

Webex voor gebruikers van Cisco BroadWorks

Gebruikers zijn ingeschakeld voor Webex for Cisco BroadWorks

Publieke API

BroadWorks enterprise Group Id moet worden doorgegeven als parameter spEnterpriseGroupId

Doorstroming

BroadWorks enterprise Group Id wordt automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Oproepen van gebruikers die niet aan boord zijn van Webex

Synchroniseren met Directory

Niet van toepassing

Entiteiten die niet bellen via een gebruiker

Bijvoorbeeld een telefoon conferentieruimte faxapparaat, Hunt-groepsnummer

Synchroniseren met Directory

Niet van toepassing

BroadWorks-telefoonlijsten

Contactpersonen in de telefoonlijsten van de BroadWorks-groep

Synchroniseren met Directory

Groepscontacten worden opgeslagen in Webex Contact Service gekoppeld aan de specifieke groep

BroadWorks Enterpsie of Persional telefoonlijsten

Contactpersonen in de lijsten met zakelijke of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing

Publieke API moet worden bijgewerkt VÓÓR de MIGRATIE. Migratie kan niet worden voltooid totdat DEZE API is voltooid De BroadWorks enterprise Group Id moet expliciet worden doorgegeven in spEnterpriseGroupId-parameter van de API-call https://developer.webex.com/docs/api/changelog#2023-maart

Nadat de functie is ingeschakeld en als gevolg van de volgende synchronisatie van de directory, worden de bedrijfsgebruikersgroepen ook weergegeven in Control Hub. Het visualiseren van de groepen in Control Hub voor Webex voor BroadWorks is in dit stadium louter informatief. Partner- en klantenbeheerders mogen geen wijzigingen aanbrengen aan groepen of groepslidmaatschap in Control Hub, aangezien deze wijzigingen niet worden teruggekoppeld naar BroadWorks. Group Management in Control Hub is bedoeld voor gebruik door partners die de komende Contact Management API's zullen overnemen.

Migratie en toekomstige proofing

Het Cisco-doel van de BroadSoft Unified Communications-client is om van UC-One naar Webex over te gaan. Er bestaat een overeenkomend binnen het netwerk van de ondersteuningsservices buiten serviceprovider netwerk – behalve bellen – in de richting van het Webex-cloudplatform.

Of u nu UC-One SaaS of BroadWorks Collaborate gebruikt, de voorkeursstrategie voor migratie is het implementeren van nieuwe, speciale XSP|ADP's voor integratie met Webex voor Cisco BroadWorks. U kunt de twee services gelijktijdig uitvoeren terwijl u klanten migreert naar Webex. Uiteindelijk kunt u de infrastructuur die voor de vorige oplossing is gebruikt, opnieuw maken.

Aanbevolen abonnementen voor documenten

Webex Help Center artikelen (op help.webex.com) hebben een Subscribe optie waarmee u een e-mailbericht ontvangt wanneer dat artikel wordt bijgewerkt.

We raden u aan zich te abonneren op elk van de volgende artikelen om ervoor te zorgen dat u geen kritische updates mist die van invloed zijn op de netwerkconnectiviteit. Om u te abonneren, ga naar elk van de onderstaande links en klik in het artikel dat wordt gelanceerd op de Subscribe Knop.

We raden je aan om je in te schrijven op bovenstaande lijst. Echter, de meeste van de Webex artikelen en documenten vermeld onder Aanvullende documentenhebben een Subscribe optie. Om deze optie te verschijnen, moet het artikel verschijnen op help.webex.com.

Er is geen abonnementsoptie voor bestemmingspagina's voor documentatie.

Aanvullende documenten

Raadpleeg de volgende gerelateerde documentatie voor meer informatie over Webex voor Cisco BroadWorks:

Webex voor Cisco BroadWorks-documenten

Partnerbeheerders kunnen de volgende documenten en sites gebruiken om informatie te verkrijgen over Webex voor Cisco BroadWorks.

Webex voor Cisco BroadWorks artikelen

Partnerbeheerders kunnen de volgende optionele sites gebruiken om meer te weten te komen over Webex voor Cisco BroadWorks:

Cisco BroadWorks-documenten

Partnerbeheerders kunnen de Cisco BroadWorks-site op cisco.com raadplegen voor technische documenten die beschrijven hoe u het Cisco BroadWorks-onderdeel van de oplossing kunt implementeren:

Webex Help artikelen

De volgende Webex Help-sites kunnen worden gebruikt om Webex-artikelen te vinden die klantbeheerders en eindgebruikers helpen om Webex-functies te gebruiken.

  • Webex van serviceproviders—Deze landingspagina bevat links met informatie over aan de slag en veelgebruikte artikelen voor gebruikers van de Webex-app die Webex-diensten van een serviceprovider hebben gekocht.

  • Webex Helpcentrum—Gebruik de zoekfunctie op help.webex.com om te zoeken naar aanvullende Webex-artikelen die de functionaliteit van Webex App en Webex Meetings beschrijven. U kunt zoeken naar gebruikers- of beheerartikelen.

Documentatie voor ontwikkelaars

Uw omgeving voorbereiden

Beslissingspunten

Overweging Vragen die moeten worden beantwoord Resources

Architectuur en infrastructuur

Hoeveel XSP|ADP's?

Hoe nemen ze mTLS?

Cisco BroadWorks-planner voor systeemcapaciteit

Handleiding voor Cisco BroadWorks System Engineering

XSP|ADP CLI-referentie

Dit document

Klant- en gebruikersvoorzieningen

Kunt u melden dat u e-mails in BroadWorks vertrouwt?

Wilt u dat gebruikers e-mailadressen verstrekken om hun eigen accounts te activeren?

Kunt u hulpprogramma's maken om onze API te gebruiken?

Openbare API-documenten op https://developer.webex.com

Dit document

Branding Welke kleur en logo wilt u gebruiken? Merkartikel over Webex-app
Sjablonen Wat zijn de verschillende gebruiks cases van uw klant? Dit document
Abonneefuncties per klant/onderneming/groep Kies pakket om het serviceniveau per sjabloon te definiëren. Basis, Standaard, Premium of Softphone.

Dit document

Functie-/pakketmatrix

Gebruikersverificatie BroadWorks of Webex Dit document
Inrichtingsadapter (voor stroomdoorstroom inrichtingsopties)

Gebruikt u al Geïntegreerde IM&P, bijvoorbeeld voor UC-One SaaS?

Wilt u meerdere sjablonen gebruiken?

Is er een vaker verwachte gebruiks case?

Dit document

CLI-referentie voor toepassingsserver

Architectuur en infrastructuur

  • Met wat voor schaal wilt u beginnen? Het is mogelijk om in de toekomst op te schalen, maar uw huidige gebruiksraming zou de infrastructuurplanning moeten kosten.

  • Werk samen met uw Cisco account manager / vertegenwoordiger om uw XSP|ADP infrastructuur te vergroten, volgens de Cisco BroadWorks systeemcapaciteitsplanneren de Cisco BroadWorks Systeemtechnische handleiding.

  • Hoe maakt Webex Mutual TLS verbindingen met uw XSP|ADP's? Rechtstreeks naar de XSP|ADP in een DMZ, of via TLS proxy? Dit is van invloed op certificaatbeheer url's en de URL's die u gebruikt voor de interfaces. (Wij ondersteunen geen niet-versleutelde TCP-verbindingen met de rand van uw netwerk).

Klant- en gebruikersvoorzieningen

Welke gebruikersvoorzieningen methode is het beste voor u?

  • Doorstroomvoorziening met vertrouwde e-mails: Door de service 'Geïntegreerde IM&P' toe te wijzen aan BroadWorks, wordt de abonnee automatisch ingericht in Webex.

    Als u ook kunt melden dat de e-mailadressen van abonnees in BroadWorks geldig zijn en uniek zijn voor Webex, kunt u de variant 'vertrouwd e-mailadres' van flowthrough-provisioning gebruiken. Webex-accounts van abonnees worden gemaakt en geactiveerd zonder hun tussenkomst; ze downloaden de client en melden zich aan.

    E-mailadres is een belangrijk gebruikerskenmerk in Webex. De gebruiker serviceprovider daarom een geldig e-mailadres voor de gebruiker verstrekken om deze voor Webex-services in te richten. Dit moet zich in het kenmerk E-mail-id van de gebruiker in BroadWorks hebben. We raden u aan deze ook te kopiëren naar het kenmerk Alternatieve id.

  • Doorstroomvoorziening zonder vertrouwde e-mails: Als u de e-mailadressen van abonnees niet kunt vertrouwen, kunt u nog steeds de geïntegreerde IM&P-service in BroadWorks toewijzen om gebruikers in Webex in te stellen.

    Met deze optie worden de accounts gemaakt wanneer u de service toewijst, maar de abonnees moeten hun e-mailadressen wel leveren en valideren om de Webex-accounts te activeren.

  • Zelfvoorziening gebruiker: Deze optie vereist geen toewijzing van IM&P-service in BroadWorks. U (of uw klanten) distribueert in plaats daarvan een inrichtingskoppeling en de koppelingen om de verschillende clients te downloaden met uw branding en instructies.

    Abonnees volgen de koppeling, leveren en valideren vervolgens hun e-mailadressen om hun Webex-accounts te maken en te activeren. Vervolgens downloaden ze de client en melden zich aan, waarna Webex extra configuratie over deze client op haalt bij BroadWorks (waaronder hun primaire nummers).

  • SP Controlled Provisioning via API’s: Webex maakt een aantal openbare API's beschikbaar waarmee serviceproviders gebruikers-/abonnee-provisioning kunnen inrichten in hun bestaande workflows.

Voorzieningsvereisten

De volgende tabel geeft een overzicht van de vereisten voor elke voorzieningsmethode. Naast deze vereisten moet uw implementatie voldoen aan de algemene systeemvereisten die in deze handleiding worden beschreven.

Voorzieningsmethode

Vereisten

Flowthrough-provisioning

(vertrouwde of niet-vertrouwde e-mails)

De Webex provisioning API voegt bestaande BroadWorks-gebruikers automatisch toe aan Webex zodra de gebruiker aan de vereisten voldoet en u de Integrated IM+P service aan op.

Er zijn twee stromen (vertrouwde e-mails of niet-vertrouwde e-mails) die je via de Onboarding template op Webex toekent.

BroadWorks vereisten:

  • Gebruiker bestaat op BroadWorks met een primair nummer of extensie.

  • Gebruiker krijgt de Integrated IM+P service, die verwijst naar de Webex provisioning service URL.

  • Alleen vertrouwde e-mails. De gebruiker heeft een e-mailadres geconfigureerd op BroadWorks. We raden u aan om ook de e-mail toe te voegen aan de Alternate ID veld, omdat dit de gebruiker in staat stelt om in te loggen met BroadWorks-referenties.

  • BroadWorks heeft verplichte patches geïnstalleerd voor flowthrough provisioning. Zie Vereiste pleisters met doorstroomvoorziening (hieronder) voor de pleistervereisten.

  • De BroadWorks AS is rechtstreeks verbonden met de Webex cloud of de Provisioning Adapter Proxy is geconfigureerd met verbinding met de Webex provisioning service URL.

    Zie Applicatieserver configureren met Provisioning Service URLom de Webex provisioning service URL te krijgen.

    Zie Cisco BroadWorks implementeert Provisioning Adapter Proxy FDom de Provisioning Adapter Proxy te configureren.

Webex-eisen:

Het sjabloon Onboarding bevat de volgende instellingen:

  • Enable BroadWorks Flow Through Provisioning toggle is aan.

  • De naam en het wachtwoord van de provisioning-account worden toegewezen aan de hand van de BroadWorks-beheerdersreferenties op systeemniveau

  • User Verification is ingesteld op Trust BroadWorks emails of Untrusted Emails.

Zelfvoorzieningen voor gebruikers

Admin biedt een bestaande BroadWorks-gebruiker een link naar het User Activation Portal. De gebruiker moet inloggen op het portaal met behulp van BroadWorks-inloggegevens en een geldig e-mailadres opgeven. Nadat de e-mail is gevalideerd, haalt Webex aanvullende gebruikersinformatie op om de provisioning te voltooien.

BroadWorks vereisten:

  • Gebruiker moet bestaan op BroadWorks met een primair nummer of extensie

Webex-eisen:

Het sjabloon Onboarding bevat de volgende instellingen:

  • Enable Flow Through Provisioning toggle is uit.

  • User Verification is ingesteld op Untrusted Emails.

  • Allow users to self activate wordt gecontroleerd.

SP-gecontroleerde provisioning via API

(vertrouwde of niet-vertrouwde e-mails)

Webex stelt een reeks openbare API's bloot die u in staat stellen om gebruikersprovisioning op te bouwen in uw bestaande workflows en tools. Er zijn twee stromen:

  • Vertrouwde e-mails – De API voorziet de gebruiker en past de BroadWorks e-mail toe als de Webex e-mail.

  • Onvertrouwde e-mails - De API voorziet de gebruiker, maar de gebruiker moet inloggen op het User Activation Portal en een geldig e-mailadres opgeven.

BroadWorks-vereisten:

  • Gebruiker moet bestaan op BroadWorks met een primair nummer of extensie.

Webex-vereisten:

  • In de sjabloon Onboarding is de gebruikersverificatie ingesteld op een van beide Trust BroadWorks emails of Untrusted Emails.

  • U moet uw aanvraag registreren en hiervoor toestemming vragen.

  • U moet aanvragen op OAuth token met de scopes die zijn gemarkeerd in de sectie “Authentication” van de Webex voor BroadWorks Developer Guide.

  • Moet een admin of provisioning admin opdragen in uw partnerorg.

Om de API's te gebruiken, ga naar BroadWorks-abonnees.

Vereiste patches met doorstroomvoorzieningen

Als u flow-through provisioning gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-release:

Voor R22:

  1. Installeren Sjabloon: Navigatie Digimon22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true van het CLI in Maintenance/ContainerOptions.

    Voor meer informatie, zie de patch notes https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeren Sjabloon: Navigatie Digimon23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true van het CLI in Maintenance/ContainerOptions.

    Voor meer informatie, zie de patch notes https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeren Sjabloon: Navigatie Digimon24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true van het CLI in Maintenance/ContainerOptions.

    Voor meer informatie, zie de patch notes https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.

Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers meer inrichten met UC-One Collaborate-services. Nieuw in te stellen gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Ondersteunde taalregio's

Wanneer u provisioning uitvoert, kent het systeem automatisch de taal van uw eerste provisioned administratiegebruiker in BroadWorks toe als de standaardlocatie voor uw klantorganisatie. Deze instelling bepaalt de standaardtaal in activerings-e-mails, vergaderingen en vergaderingen-uitnodigingen onder die klantorganisatie.

U kunt taallocales met vijf tekens gebruiken in (ISO-639-1)_(ISO-3166) formaat. Bijvoorbeeld, en_US komt overeen met English_UnitedStates. Als u slechts een tweeletterige taal (ISO-639-1 formaat) aanvraagt, combineert de service deze met een landcode uit het sjabloon en creëert een locale met vijf tekens. Bijvoorbeeld "requestedLanguage_CountryCode". Als het systeem op deze manier geen geldige locale kan genereren, gebruikt het de standaard locale op basis van de gewenste taalcode.

De volgende tabel toont ondersteunde locales en hoe tweeletterige taalcodes converteren naar vijfletterige locales.

Table 1. Supported language locale codes

Ondersteunde taalregio's

(ISO-639-1)_(ISO-3166)

Als er slechts een tweeletterige taalcode beschikbaar is...

Taalcode (ISO-639-1) **

Gebruik in plaats daarvan de standaard sensible locale (ISO-639-1)_(ISO-3166)

en_US

nl_AU

en_GB

nl_CA

en

en_US

fr_FR

fr_CA

vr

fr_FR

cs_CZ

Categorie: CS

cs_CZ

da_DA

da

da_DA

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_NEE

nb

nb_NEE

pl_PL

De Raad van Bestuur

pl_PL

pt_PT

pt_BR

pt

pt_PT

ru_RU

ru

ru_RU

ro_RO

Categorie: Professioneel worstelaar

ro_RO

zn_CN

zh_TW

zh

zn_CN

sv_SE

Sv.

sv_SE

ar_SA

ar

ar_SA

tr_TR

tr.

tr_TR

Webex Meetings ondersteunt de locales es_CO, id_ID, nb_NO en pt_PT op uw site niet. Wanneer u deze locales probeert te gebruiken, wordt uw Webex Meetings site alleen in het Engels weergegeven. Als u geen taal opgeeft, een ongeldige taal invoert of een niet-ondersteunde optie kiest, wordt Engels de standaardtaal voor uw site. Je werkt met dit taalveld wanneer je een organisatie creëert en je Webex Meetings site instelt. Als u geen taal opgeeft in uw post- of abonnee-API, gebruikt het systeem de taal uit uw sjabloon als standaard.

Branding

Partnerbeheerders kunnen aanpassingen in Geavanceerde branding gebruiken om aan te passen hoe de Webex-app eruitziet voor de klantorganisaties die de partner beheert. Partnerbeheerders kunnen de volgende instellingen aanpassen om ervoor te zorgen dat de Webex-app een weerspiegeling is van het merk en de identiteit van hun bedrijf:

  • Bedrijfslogo's

  • Unieke kleurschema's voor de lichte modus of donkere modus

  • Aangepaste ondersteunings-URL's

Voor meer informatie over het aanpassen van branding, zie Geavanceerde merkaanpassingen configureren.

  • Basic Branding-aanpassingen worden momenteel verouderd. We raden u aan om Advanced Branding te implementeren, die een breder scala aan aanpassingen biedt.

Inwerksjablonen

Met inwerksjablonen kunt u de parameters definiëren waarmee klanten en bijbehorende abonnees automatisch worden voorzien op Webex voor Cisco BroadWorks. U kunt indien nodig meerdere Onboarding-sjablonen configureren, maar wanneer u een klant inschakelt, wordt deze gekoppeld aan slechts één sjabloon (u kunt niet meerdere sjablonen toepassen op één klant).

Hieronder worden enkele primaire sjabloonparameters vermeld.

Pakket
  • Wanneer je een template aanmaakt, moet je een standaardpakket selecteren (zie Pakketten in de sectie Overzicht voor details). Alle gebruikers aan wie die sjabloon is ingericht, ontvangen het standaardpakket, ongeacht of ze doorstromen of zelf provisioning.

  • U kunt de pakketselectie voor verschillende klanten beheren door meerdere sjablonen te maken en verschillende standaardpakketten in elk te selecteren. U kunt vervolgens verschillende provisioningskoppelingen of verschillende adapters voor inrichting per onderneming distribueren, afhankelijk van uw gekozen gebruikersvoorzieningenmethode voor deze sjablonen.

  • U kunt het pakket van specifieke abonnees van deze standaard wijzigen, met behulp van de provisioning API (zie Webex voor Cisco BroadWorks API-documentatieof via Partner Hub (zie Gebruikerspakket wijzigen in Partner Hub).

  • U kunt het pakket van een abonnee niet wijzigen vanuit BroadWorks. De toewijzing van de geïntegreerde IM&P-service is aan of uit; als de abonnee deze service in BroadWorks heeft toegewezen, wordt het pakket definiëren in de Partner Hub-sjabloon die is gekoppeld aan de inrichtings-URL van de abonnee.

Reseller en ondernemingen of serviceprovider en groepen?
  • De manier waarop uw BroadWorks-systeem is geconfigureerd, heeft een invloed op de flow through provisioning. Als u een reseller bij Enterprise bent, moet u de Enterprise-modus inschakelen wanneer u een sjabloon maakt.

  • Als uw BroadWorks-systeem is geconfigureerd in serviceprovider modus, kunt u de Enterprise-modus uitschakelen in uw sjablonen.

  • Als u van plan bent om organisaties van klanten in te stellen met behulp van beide BroadWorks-modi, moet u verschillende sjablonen voor groepen en ondernemingen gebruiken.

Zorg dat u de BroadWorks-patches hebt toegepast die vereist zijn voor flow-through provisioning. Voor meer informatie, zie Vereiste patches met doorstroomvoorziening.

Zorg dat u de BroadWorks-patches hebt toegepast die vereist zijn voor flow-through provisioning. Zie Vereiste patches met doorstroomvoorziening voor meer informatie.

Meerdere partners

Gaat u Webex for Cisco BroadWorks sublicenties leveren aan een andere serviceprovider? In dat geval heeft elke serviceprovider in die organisatie een afzonderlijke partnerorganisatie nodig Webex Control Hub hen in staat te stellen de oplossing voor hun klanten in te stellen.

Inrichtingsadapter en -sjablonen

Als u flowthrough provisioning gebruikt, wordt de inrichtings-URL die u in BroadWorks int, afgeleid van de sjabloon in Control Hub. U kunt meerdere sjablonen hebben en daarom meerdere provisioning-URL's. Hiermee kunt u op enterprise-by-enterprise-basis selecteren welk pakket moet worden toegepast op abonnees wanneer ze de geïntegreerde IM&P-service krijgen.

U moet na denken of u een provisioning-URL op systeemniveau wilt instellen als een standaard inrichtingspad en welke sjabloon u voor dat pad wilt gebruiken. Zo hoeft u alleen expliciet de inrichtings-URL in te stellen voor ondernemingen die een ander sjabloon nodig hebben.

Houd er ook rekening mee dat u mogelijk al een provisioning-URL op systeemniveau gebruikt, bijvoorbeeld met UC-One SaaS. Als dat het geval is, kunt u ervoor kiezen om de systeemniveau-URL te behouden voor de provisioning van gebruikers op UC-One SaaS, en override voor die bedrijven die verhuizen naar Webex voor Cisco BroadWorks. U kunt ook de andere weg op gaan en de URL op systeemniveau instellen voor Webex for BroadWorks en de ondernemingen die u op UC-One SaaS wilt behouden opnieuw configureren.

De configuratiekeuzes met betrekking tot deze beslissing worden in detail beschreven in Applicatieserver configureren met Provisioning Service URL.

Provisioning Adapter Proxy

Voor extra beveiliging kunt u met de Provisioning Adapter Proxy een HTTP(S) proxy gebruiken op het Application Delivery Platform voor flowthrough provisioning tussen de AS en Webex. De proxyverbinding creëert een end-to-end TCP-tunnel die het verkeer tussen de AS en Webex doorgeeft, waardoor de noodzaak voor de AS om rechtstreeks verbinding te maken met het openbare internet wordt ontkend. Voor veilige verbindingen kan TLS gebruikt worden.

Deze functie vereist dat u de proxy op BroadWorks instelt. Voor meer informatie, zie Cisco BroadWorks Provisioning Adapter Proxy Functiebeschrijving.

Minimumeisen

Accounts

Alle abonnees die u voor Webex inrichten, moeten in het BroadWorks-systeem bestaan dat u integreert met Webex. U kunt meerdere BroadWorks-systemen integreren indien nodig.

Alle abonnees moeten beschikken over BroadWorks-licenties en een primair nummer of extensie.

Webex gebruikt e-mailadressen als primaire id's voor alle gebruikers. Als u flowthrough provisioning met vertrouwde e-mails gebruikt, moeten uw gebruikers geldige adressen in het e-mailkenmerk in BroadWorks hebben.

Als uw sjabloon BroadWorks-verificatie gebruikt, kunt u e-mailadressen van abonnees kopiëren naar het kenmerk Alternatieve id in BroadWorks. Hierdoor kunnen gebruikers zich bij Webex aanmelden met hun e-mailadres en hun BroadWorks-wachtwoord.

Uw beheerders moeten hun Webex-accounts gebruiken om zich aan te melden bij Partner Hub.

Het wordt niet ondersteund om een BroadWorks-beheerder aan boord te krijgen van Webex voor Cisco BroadWorks. U kunt alleen gebruikers aan boord van BroadWorks bellen die een primair nummer en/of extensie hebben. Als u flowthrough provisioning gebruikt, moeten gebruikers ook de Integrated IM&P-service toegewezen krijgen.

Servers in uw netwerk- en softwarevereisten

  • De BroadWorks-instantie(s) moet/moeten ten minste de volgende servers bevatten:

    • Application Server (AS) met broadworks-versie zoals hierboven

    • Netwerkserver (NS)

    • Profielserver (PS)

  • Public-facing XSP|ADP Server(s) of Application Delivery Platform (ADP) voldoen aan de volgende vereisten:

    • Verificatieservice (BWAuth)

    • Interfaces XSI-acties en gebeurtenissen

    • DMS (apparaatbeheer-webtoepassing)

    • CTI-interface (computertelefonie- intergration)

    • TLS 1.2 met een geldig certificaat (niet zelfondertekend) en eventueel vereiste tussenproducten. Vereist Beheer op systeemniveau om bedrijfszoekactie mogelijk te maken.

    • Gemeenschappelijke TLS-verificatie (mTLS) voor de verificatieservice (de openbare Webex-clientcertificaatketen is geïnstalleerd als vertrouwensankers)

    • Gemeenschappelijke TLS-verificatie (mTLS) voor CTI-interface (vereist de openbare Webex-clientcertificaatketen geïnstalleerd als vertrouwensankers)

  • Een afzonderlijke XSP/ADP-server die optreedt als een 'pushserver voor gespreksmeldingen' (een NPS in uw omgeving die wordt gebruikt om oproepmeldingen naar Apple/Google te pushen. We noemen het hier 'CNPS' om het te onderscheiden van de service in Webex die pushmeldingen voor berichten en aanwezigheid levert).

    Deze server moet op R22 of later staan.

  • We verplichten een afzonderlijke XSP/ADP-server voor CNPS omdat de niet-voorspelbaarheid van de belasting van Webex voor BWKS-cloudverbindingen een negatieve invloed kan hebben op de prestaties van de NPS-server, doordat de meldingslatentie wordt verhogen. Bekijk de Cisco BroadWorks System Engineering Guidevoor meer op XSP|ADP schaal.

Webex-appplatforms

Fysieke telefoons en accessoires

Apparaatintegratie

Zie voor meer informatie over hoe u Room OS- en MPP-apparaten voor Webex voor Cisco BroadWorks in te voeren en te onderhouden. Apparaatintegratiegids voor Webex voor Cisco BroadWorks.

Apparaatprofielen

Hieronder volgen de DTAF-bestanden die u op uw applicatieservers moet laden om de Webex-app als bellende client te ondersteunen. Ze zijn dezelfde DTAF-bestanden als voor UC-One SaaS, maar er is een nieuwe config-wxt.xml.template bestand dat wordt gebruikt voor de Webex App.

Ga naar het Application Delivery Platform om de nieuwste apparaatprofielen te downloaden Software-downloadssite om de nieuwste DTAF-bestanden te krijgen. Deze downloads werken voor zowel ADP als XSP.

Clientnaam

Apparaatprofieltype en pakketnaam

Sjabloon Mobiel Webex

Identiteits-/apparaatprofieltype: Connect - Mobiel

DTAF: ucone-mobile-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Sjabloon van Webex-tablet

Identiteits-/apparaatprofieltype: Verbinden - tablet

DTAF: ucone-tablet-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Webex-sjabloon voor bureaublad

Identiteits-/apparaatprofieltype: Business Communicator - PC

DTAF: ucone-desktop-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Identificeer/apparaatprofiel

Alle Webex-gebruikers van Cisco BroadWorks moeten een Identity/Device Profile toegewezen in BroadWorks dat een van de bovenstaande apparaatprofielen gebruikt om gesprekken te voeren met de Webex-app. Het profiel biedt de configuratie die de gebruiker in staat stelt om oproepen te plaatsen.

OAuth-referenties voor uw Webex voor Cisco BroadWorks verkrijgen

Stel een serviceaanvraag in bij uw onboarding agent of bij Cisco TAC om Cisco OAuth te leveren voor uw Cisco Identity Provider Federation-account.

Gebruik de volgende aanvraagtitel voor de respectieve functies:

  1. XSP|ADP AuthService Configuration' om de service op XSP|ADP te configureren.

  2. 'NPS-configuratie voor Auth-proxy-instelling' om NPS te configureren om authenticatieproxy te gebruiken.

  3. CI-gebruiker UUID-synchronisatie' voor CI-gebruiker UUID-synchronisatie. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.

  4. Configureer BroadWorks om Cisco-facturering voor BroadWorks- en Webex-abonnementen Voor BroadWorks-abonnementen mogelijk te maken.

Cisco geeft u een OAuth client ID, een client secret en een refresh token dat geldig is voor 60 dagen. Als het token vervalt voordat u het gebruikt, kunt u een andere aanvraag indienen.

Als u al de inloggegevens van Cisco OAuth Identity Provider hebt verkregen, vult u een nieuwe serviceaanvraag in om uw inloggegevens bij te werken.

Bestelcertificaten

Certificaatvereisten voor TLS-authenticatie

U hebt beveiligingscertificaten nodig, ondertekend door een bekende certificaatautoriteit en geïmplementeerd op uw Public facing XSP|ADP's, voor alle vereiste toepassingen. U gebruikt deze om TLS-certificaatverificatie te ondersteunen voor alle inkomende verbindingen met uw XSP|ADP-servers.

Deze certificaten moeten uw XSP|ADP publieke volledig gekwalificeerde domeinnaam als Subject Common Name of Subject Alternate Name bevatten.

De specifieke vereisten voor het inzetten van servercertificaten variëren op basis van de implementatiemethode van uw openbare XSP|ADP's.

  • Via een TLS-overbruggingsproxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

Dit diagram vat samen waar u het door de CA ondertekende publieke servercertificaat in deze drie gevallen moet laden:

Diagram summarizing where the CA-signed public server certificate needs to be loaded for TLS-bridge Proxy, TLS-passthrough Proxy or XSP|ADP in DMZ

Voor meer informatie over openbaar ondersteunde CA's die de Webex-app ondersteunt voor authenticatie, zie Ondersteunde certificaatautoriteiten voor Webex Hybrid Services.

TLS-certificaatvereisten voor TLS-bridge proxy
  • Het openbaar ondertekende servercertificaat wordt geladen in de proxy.

  • De proxy toont dit openbaar ondertekende servercertificaat voor Webex.

  • Webex vertrouwt de openbare ca die het servercertificaat van de proxy heeft ondertekend.

  • Een intern CA ondertekend certificaat kan op de XSP|ADP geladen worden.

  • De XSP|ADP presenteert dit intern ondertekend servercertificaat aan de proxy.

  • De proxy vertrouwt de interne CA die het XSP|ADP servercertificaat heeft ondertekend.

TLS-certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ
  • Het openbaar ondertekende servercertificaat wordt in de XSP|ADP's geladen.

  • De XSP|ADP's presenteren publiek ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de publieke CA die de servercertificaten van XSP|ADP's heeft ondertekend.

Aanvullende certificaatvereisten voor wederzijdse TLS-authenticatie via CTI-interface

Wanneer verbinding wordt gemaakt met de CTI-interface, toont Webex een clientcertificaat als onderdeel van gemeenschappelijke TLS-verificatie. Het Webex client certificaat CA/chain certificaat is te downloaden via Control Hub.

Het certificaat downloaden:

Aanmelden bij Partnerhub.

Klik op de Services kaart.

Ga naar Additional links, en klik op de Download Webex CA certificate .

De specifieke vereisten voor het inzetten van een Webex CA-certificaatketen variëren afhankelijk van de implementatiemethode van uw XSP|ADP's.

  • Via een TLS-overbruggingsproxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

Dit schema geeft een samenvatting van de certificaatvereisten in deze drie gevallen:

Diagram of mTLS Certificate Exchange for CTI via Different Edge Configurations
mTLS certificaat uitwisseling voor CTI over verschillende Edge configuraties
(Optie) Certificaatvereisten voor TLS-bridge proxy
  • Webex toont een openbaar ondertekend clientcertificaat voor de proxy.

  • De proxy vertrouwt de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de trust store van de proxy. Laad het openbaar ondertekende XSP|ADP servercertificaat in de proxy.

  • De proxy toont het openbaar ondertekende servercertificaat voor Webex.

  • Webex vertrouwt de openbare ca die het servercertificaat van de proxy heeft ondertekend.

  • De proxy overhandigt een intern ondertekend cliëntcertificaat aan de XSP|ADP’s.

    Voor dit certificaat moet het x509.v3-verlengingsveld Uitgebreid sleutelgebruik worden ingevuld met de BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS clientAuth-functie. Bijvoorbeeld:

    X509v3 extensions:
        X509v3 Extended Key Usage:
            1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication

    De CN van het interne certificaat moet zijn bwcticlient.webex.com.

    • Er is geen ondersteuning voor SAN-certificaten, bij het genereren van interne cliëntcertificaten voor de proxy. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

    • Publieke certificaatautoriteiten zijn misschien niet bereid om certificaten te ondertekenen die de gepatenteerde BroadWorks OID vereisen. Als er een overbruggingsproxy is, moet je een interne CA gebruiken om het cliëntcertificaat dat de proxy aan de XSP|ADP voorlegt te ondertekenen.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP's presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

  • De ClientIdentity van de Application Server bevat de CN van het intern ondertekend cliëntcertificaat dat door de volmachthebber aan de XSP|ADP wordt voorgelegd.

(Optie) Certificaatvereisten voor TLS-passthrough-proxy of XSP|ADP in DMZ
  • Webex overhandigt een intern CA-ondertekend klantcertificaat van Cisco aan de XSP|ADP's.

  • De XSP|ADP's vertrouwen de interne CA van Cisco die het klantcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de trust store van de proxy. U kunt ook het openbaar ondertekende XSP|ADP servercertificaat in de XSP|ADP's laden.

  • De XSP|ADP's presenteren de publiek ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de publieke CA die de servercertificaten van XSP|ADP's heeft ondertekend.

  • De Application Server ClientIdentity bevat de CN van het door Cisco ondertekende client certificaat dat door Webex aan de XSP|ADP wordt aangeboden.

Uw netwerk voorbereiden

Voor meer informatie over verbindingen die door Webex worden gebruikt voor Cisco BroadWorks, zie: Netwerkvereisten voor Webex voor Cisco BroadWorks. Dit artikel bevat een lijst met IP-adressen, -poorten en -protocollen die nodig zijn om de regels van uw firewall in- en uitgangen te configureren.

Netwerkvereisten voor Webex-services

De firewalltabellen Voorafgaande aan en uitgaat van regels documenteren alleen de verbindingen die specifiek zijn voor Webex voor Cisco BroadWorks. Voor algemene informatie over verbindingen tussen de Webex-app en de Webex-cloud, zie Netwerkvereisten voor Webex-diensten. Dit artikel is algemeen voor Webex, maar de volgende tabel identificeert de verschillende gedeelten van het artikel en hoe relevant elk gedeelte is voor Webex voor Cisco BroadWorks.

Table 2. Network Requirements for Webex App Connections (Generic)

Gedeelte van het artikel Netwerkvereisten

Betekenis van informatie

Overzicht van door Webex ondersteunde apparaattypes en protocollen

Informatie

Transportprotocollen en encryptiesciphers voor cloud-geregistreerde Webex-apps en -apparaten

Informatie

Webex-diensten – Poortnummers en -protocollen

Moet lezen

IP-subnetten voor Webex-mediadiensten

Moet lezen

Domeinen en URL's die toegankelijk moeten zijn voor Webex Services

Moet lezen

Extra URL's voor Webex Hybrid Services

Optioneel

Proxy-functies

Optioneel

802.1X – Netwerktoegangscontrole op basis van poort

Optioneel

Netwerkvereisten voor op SIP gebaseerde Webex-diensten

Optioneel

Netwerkvereisten voor Webex Edge Audio

Optioneel

Een samenvatting van andere Webex Hybrid Services en documentatie

Optioneel

Webex-services voor FedRAMP-klanten

N.v.t.

Aanvullende informatie

Voor meer informatie, zie Webex App Firewall Whitepaper (PDF).

Ondersteuning voor redundantie van BroadWorks

De Webex Cloud Services en de Webex Client Apps die toegang moeten hebben tot het netwerk van de partner, ondersteunen volledig de Broadworks XSP|ADP redundantie die door de partner wordt geleverd. Wanneer een XSP|ADP of site niet beschikbaar is voor gepland onderhoud of niet-geplande reden, kunnen de Webex-diensten en -apps overgaan naar een andere XSP|ADP of site die door de partner wordt aangeboden om een aanvraag te voltooien.

Netwerktopologie

De Broadworks XSP|ADP's kunnen rechtstreeks op het internet worden ingezet, of kunnen zich in een DMZ bevinden die voorafgegaan wordt door een load balancing element zoals de F5 BIG-IP. Om geo-redundantie te bieden, kunnen de XSP|ADP's worden ingezet in twee (of meer) datacenters, elk kan worden fronted door een load balancer, elk met een openbaar IP-adres. Als de XSP|ADP's achter een load balancer zitten, zien de Webex microservices en App alleen het IP-adres van de load balancer en lijkt Broadworks slechts één XSP|ADP te hebben, zelfs als er meerdere XSP|ADP's achter zitten.

In het onderstaande voorbeeld worden de XSP|ADP's ingezet op twee sites, Site A en Site B. Er zijn twee XSP|ADP's voorafgegaan door een Load Balancer op elke site. Locatie A heeft XSP|ADP1 en XSP|ADP2 voorgeschoteld door LB1, en locatie B heeft XSP|ADP3 en XSP|ADP4 voorgeschoteld door LB2. Alleen de Load Balancers worden blootgesteld op het publieke netwerk, en de XSP|ADP's bevinden zich in de DMZ private netwerken.

Diagram of Broadworks XSP|ADPs deployed at two sites, Site A and Site B.
Webex Cloud-services
DNS-configuratie

De Webex Cloud microservices moeten de Broadworks XSP|ADP server(s) kunnen vinden om verbinding te maken met de Xsi interfaces, authenticatie service en CTI.

Webex Cloud microservices zal DNS A/AAAA opzoeken van de geconfigureerde XSP|ADP hostnaam uitvoeren en verbinden met het geretourneerde IP-adres. Dit kan een load balancing edge element zijn, of het kan de XSP|ADP server zelf zijn. Als er meerdere IP-adressen worden geretourneerd, wordt het eerste IP-adres in de lijst geselecteerd. SRV zoeken wordt momenteel niet ondersteund.

Voorbeeld: De partner DNS A Record voor de ontdekking van Round-Robin gebalanceerde internet-facing XSP|ADP server / Load Balancers.

Opnametype

Naam

Target

Purpose

A

webex-cloud-xsp.example.com

198.51.100.48

Punten naar LB1 (Site A)

A

webex-cloud-xsp.example.com

198.51.100.49

Punten naar LB2 (Site B)

Elke verwijzing naar XSP omvat XSP of ADP.

Failover

Wanneer de Webex microservices een verzoek sturen naar de XSP|ADP/Load Balancer en het verzoek faalt, kunnen er verschillende dingen gebeuren:

  • Als de fout is veroorzaakt door een netwerkfout (bijvoorbeeld: TCP, SSL). De Webex-microservices markeren het IP als geblokkeerd en voeren onmiddellijk een route door naar het volgende IP.

  • Als een foutcode (HTTP 5xx) wordt teruggestuurd, markeren de Webex-microservices het IP als geblokkeerd en voeren onmiddellijk een route uit naar het volgende IP.

  • Als er binnen 2 seconden geen HTTP-antwoord wordt ontvangen, markeren de verzoektijden en de Webex-microservices het IP als geblokkeerd en voeren een route uit naar het volgende IP.

Elk verzoek wordt 3 keer geprobeerd voordat een storing wordt gemeld aan de microservice.

Wanneer een IP in de geblokkeerde lijst staat, wordt het niet opgenomen in de lijst met adressen die u moet proberen wanneer u een verzoek naar een XSP|ADP stuurt. Na een vooraf bepaalde periode verloopt een geblokkeerd IP-adres en wordt het weergegeven in de lijst om het te proberen wanneer een andere aanvraag wordt gedaan.

Als alle IP-adressen zijn geblokkeerd, probeert de microservice de aanvraag nog steeds te verzenden door willekeurig een IP-adres in de geblokkeerde lijst te selecteren. Als dat gelukt is, wordt dat IP-adres verwijderd uit de geblokkeerde lijst.

Status

De status van de connectiviteit van de Webex Cloud-diensten met de XSP|ADP's of Load Balancers is te zien in Control Hub. Onder een BroadWorks Calling-cluster wordt voor elk van deze interfaces een verbindingsstatus weergegeven:

  • XSI-acties

  • XSI-gebeurtenissen

  • Verificatieservice

De verbindingsstatus wordt bijgewerkt wanneer de pagina wordt geladen of wanneer invoerupdates worden bijgewerkt. De verbindingsstatussen kunnen als volgende zijn:

  • Groene: Wanneer de interface bereikt kan worden op een van de IP's in de A-recordzoekactie.

  • Rode: Wanneer alle IP's in de A-opnamezoekactie onbereikbaar zijn en de interface niet beschikbaar is.

DNS Configuration for Webex Cloud Services interface window displaying connection status

De volgende services gebruiken de microservices om verbinding te maken met de XSP|ADP's en worden beïnvloed door de beschikbaarheid van de XSP|ADP-interface:

  • Aanmelden bij Webex-app

  • Token voor Webex-app vernieuwen

  • Niet-vertrouwde e-mail/zelfactivering

  • Statuscontrole Broadworks-service

Webex-app
DNS-configuratie

De Webex-app heeft toegang tot de Xtended Services Interface (XSI-Actions & XSI-Events) en de Device Management Service (DMS)-diensten op de XSP|ADP.

Om de XSI-service te vinden, voert de Webex-app DNS SRV-lookup uit voor _xsi-client._tcp.<webex app xsi domain>. De SRV verwijst naar de geconfigureerde URL voor de XSP|ADP hosts of load balancers voor de XSI service. Als SRV-lookup niet beschikbaar is, valt de Webex-app terug naar A/AAAA-lookup.

De SRV kan meerdere A/AAAA-doelen oplossen. Elke A/AAAA-record moet echter alleen op één IP-adres worden geprojecteerd. Als er meerdere XSP|ADP's in een DMZ achter de lastbalancer/edge-apparaat zitten, is het vereist dat de lastbalancer geconfigureerd wordt om de duur van de sessie te behouden om alle verzoeken van dezelfde sessie naar dezelfde XSP|ADP te leiden. We gelasten deze configuratie omdat de XSI-event hartslagen van de client naar dezelfde XSP|ADP moeten gaan die wordt gebruikt om het event kanaal te creëren.

In Voorbeeld 1 bestaat de A/AAAA-record voor webex-app-XSP|ADP.example.com niet en hoeft dat niet te doen. Als uw DNS vereist dat één A/AAAA-record moet worden gedefinieerd, dan moet alleen 1 IP-adres worden geretourneerd. Voor de Webex App moet toch de SRV gedefinieerd worden.

Als de Webex-app de A/AAAA-naam gebruikt die tot meer dan één IP-adres overgaat, of als het load balancer/edge-element de sessie niet volhoudt, stuurt de client uiteindelijk hartslagen naar een XSP|ADP waar hij geen evenementenkanaal heeft opgezet. Dit zorgt ervoor dat het kanaal wordt afgebroken, en ook in aanzienlijk meer intern verkeer, wat uw XSP|ADP clusterprestaties schaadt.

Omdat de Webex Cloud en Webex App verschillende vereisten hebben in A/AAAA record lookup, moet u een aparte FQDN gebruiken voor de Webex Cloud en Webex App om toegang te krijgen tot uw XSP|ADP's. Zoals in de voorbeelden te zien is, gebruikt Webex Cloud Een record webex-cloud-xsp.example.com, en Webex App gebruikt SRV _xsi-client._tcp.webex-app-xsp.example.com.

Voorbeeld 1—Meerdere XSP|ADP’s, elk achter afzonderlijke lastbalancers

In dit voorbeeld wijst de SRV op meerdere A-records waarbij elke A-record wijst op een andere lastbalancer op een andere locatie. De Webex App zal altijd het eerste IP-adres in de lijst gebruiken en zal pas naar de volgende record gaan als de eerste is uitgeschakeld.

Hieronder vindt u een voorbeeld SRV records.

Opnametype

Opnemen

Target

Purpose

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc1.example.com

Clientdetectie van de Xsi-interface

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc2.example.com

Clientdetectie van de Xsi-interface

A

xsp-dc1.example.com

198.51.100.48

Punten naar LB1 (site A)

A

xsp-dc2.example.com

198.51.100.49

Punten naar LB2 (site B)

Voorbeeld 2—Meerdere XSP|ADP’s achter een enkele lastbalancer (met TLS-brug)

Voor de initiële aanvraag selecteert de lastbalancer een willekeurige XSP|ADP. Dat XSP|ADP een cookie retourneert die de Webex App in toekomstige verzoeken bevat. Voor toekomstige verzoeken gebruikt de load balancer het cookie om de verbinding naar de juiste XSP|ADP te routeren, zodat het eventkanaal niet breekt.

Opnametype

Opnemen

Target

Purpose

SRV

_xsi-client._tcp.webex-app-xsp.example.com

LB.example.com

Lastbalancer

A

LB.voorbeeld.com

198.51.100.83

IP-adres van lastbalancer (XSP|ADP's staan achter lastbalancer)

DMS-URL

Tijdens het aanmeldproces haalt de Webex-app ook de DMS-URL op om het configuratiebestand te downloaden. De host in de URL zal ontleden en de Webex App zal DNS A/AAAA opzoeken van de host uitvoeren om verbinding te maken met de XSP|ADP die de DMS-service host.

Voorbeeld: DNS A Record voor ontdekking van Round-Robin gebalanceerde internet-facing XSP|ADP server / Load Balancers door Webex App om configuratiebestanden te downloaden via DMS:

Opnametype

Naam

Target

Purpose

A

xsp-dms.example.com

198.51.100.48

Punten naar LB1 (site A)

A

xsp-dms.example.com

198.51.100.49

Punten naar LB2 (site B)

Elke verwijzing naar XSP omvat XSP of ADP.Elke verwijzing naar XSP omvat XSP of ADP.

Hoe de Webex-app XSP|ADP-adressen vindt

De client probeert de XSP|ADP nodes te vinden met behulp van de volgende DNS flow:

  1. De client haalt aanvankelijk Xsi-Acties/Xsi-Events-URL's op uit Webex Cloud (u hebt deze ingevoerd bij het maken van de gekoppelde BroadWorks-callingcluster). De Xsi-hostnaam/het domein wordt aan de URL geparseerd en de client voert SRV volgende zoekactie uit:

    1. Klant voert een SRV-opzoeking uit voor _xsi-client._tcp.<xsi-domein>

    2. Als de SRV-opzoeking een of meer A/AAAA-doelen oplevert:

      1. De client doet een A/AAAA-zoekactie naar de teruggebrachte IP-adressen en caches van de klant.

      2. De client maakt verbinding met een van de doelen (en daarom het A/AAAA-record met één IP-adres) op basis van de SRV-prioriteit. Vervolgens wordt het gewicht (of willekeurig, als ze allemaal gelijk zijn) gebruikt.

    3. Als de SRV niet richt, worden geen richt richten retourneren:

      De client doet een A/AAAA-opzoekactie naar de hoofdparameter van Xsi en probeert vervolgens verbinding te maken met het geretourneerde IP-adres. Dit kan een load balancing edge element zijn, of het kan de XSP|ADP server zelf zijn.

      Zoals vermeld, moet het A/AAAA-record om dezelfde redenen naar één IP-adres verdwijnen.

  2. (Optioneel) Vervolgens kunt u aangepaste XSI-Acties/XSI-Events-gegevens verstrekken in de apparaatconfiguratie voor de Webex-app, met behulp van de volgende tags:

    <protocols>
    	<xsi>
    		<paths>
    			<root>%XSI_ROOT_WXT%</root>
    			<actions>%XSI_ACTIONS_PATH_WXT%</actions>
    			<events>%XSI_EVENTS_PATH_WXT%</events>
    		</paths>
    	</xsi>
    </protocols>

    1. Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.

    2. Als deze bestaan, wordt de client vergeleken met het oorspronkelijke XSI-adres dat het heeft ontvangen via de broadWorks-clusterconfiguratie.

    3. Als er verschil wordt gedetecteerd, wordt de XSI-acties/XSI Events-verbinding van de client opnieuw initialiseren. De eerste stap in dit proces is om hetzelfde DNS-opzoekproces uit te voeren zoals vermeld onder stap 1 – dit keer wordt een opzoeking gevraagd voor de waarde in de parameter %XSI_ROOT_WXT% uit zijn configuratiebestand.

      Zorg dat u de bijbehorende records SRV maken als u deze tag gebruikt om de Xsi-interfaces te wijzigen.

Failover

Tijdens het aanmelden voert de Webex-app een DNS SRV-lookup uit voor _xsi-client._tcp.<xsi-domein>, maakt een lijst van hosts op en maakt verbinding met een van de hosts op basis van de SRV-prioriteit en vervolgens gewicht. De verbonden host wordt de geselecteerde host voor alle toekomstige aanvragen. Vervolgens wordt er een gebeurteniskanaal geopend voor de geselecteerde host en wordt er regelmatig een hartslag verzonden om het kanaal te verifiëren. Alle verzoeken die na de eerste worden verzonden, bevatten een cookie die wordt geretourneerd in het HTTP-antwoord, daarom is het belangrijk dat de load balancer de sessie persistentie (affiniteit) houdt en altijd verzoeken stuurt naar dezelfde backend XSP|ADP-server.

Als een aanvraag of een hartslagverzoek van een host mislukt, kan er een aantal dingen gebeuren:

  • Als de fout is veroorzaakt door een netwerkfout (bijvoorbeeld: TCP, SSL). De route van de Webex-app gaat direct naar de volgende host in de lijst.

  • Als een foutcode (HTTP 5xx) wordt geretourneerd, markeert de Webex-app dat IP-adres als geblokkeerd en gaat de route naar de volgende host op de lijst.

  • Als een antwoord niet binnen een bepaalde tijd wordt ontvangen, wordt de aanvraag als mislukt beschouwd vanwege een time-out en de volgende aanvragen worden verzonden naar de volgende host. De time-outaanvraag wordt echter beschouwd als mislukt. Sommige aanvragen worden opnieuw proberen na de fout (met verhogen van de tijd voor opnieuw proberen). Er wordt geen nieuwe aanvraag ingediend naar de verzoeken die uitgaan van de veronderstelde niet-essentiële functies.

Wanneer een nieuwe host wordt geprobeerd, wordt deze de nieuwe geselecteerde host als de host in de lijst aanwezig is. Nadat de laatste host in de lijst is geprobeerd, wordt de Webex-app over gezet naar de eerste.

Als er twee opeenvolgende mislukte aanvragen zijn, wordt het gebeurteniskanaal opnieuw initialiseren door de Webex-app.

De Webex-app voert geen failback uit en DNS-servicedetectie wordt slechts eenmaal bij de aanmelding uitgevoerd.

Tijdens het aanmelden probeert de Webex-app het configuratiebestand te downloaden via de XSP|ADP/Dms-interface. Hiermee wordt een A/AAAA-recordzoeking uitgevoerd van de host in de opgehaalde DMS-URL en wordt verbinding gemaakt met het eerste IP. Het zal eerst proberen om het verzoek te downloaden van het configuratiebestand met behulp van SSO token. Als dit om de een of andere reden mislukt, wordt het opnieuw geprobeerd, maar met de gebruikersnaam en het wachtwoord van het apparaat.

Webex voor BroadWorks implementeren

Overzicht implementatie

De volgende schema's vertegenwoordigen de typische volgorde van uw implementatietaken voor de verschillende gebruikers provisioningmodi. Veel van de taken zijn gebruikelijk bij alle inrichtingsmodi.

Shows the order of tasks required for deploying Webex for BroadWorks with flow-through provisioning and trusted emails
Taken die nodig zijn voor de implementatie van doorstroomvoorzieningen
Shows the order of tasks required for deploying Webex for BroadWorks with flow-through provisioning without emails
Taken die nodig zijn voor het implementeren van flowthrough provisioning zonder vertrouwde e-mails
Shows the order of tasks required for deploying Webex for BroadWorks with self-activation
Taken die nodig zijn voor het inzetten van zelfvoorziening door de gebruiker

Partner onboarding voor Webex voor Cisco BroadWorks

Elke Webex voor Cisco BroadWorks serviceprovider reseller moet worden ingesteld als een partnerorganisatie voor Webex voor Cisco BroadWorks. Als u een bestaande Webex-partnerorganisatie hebt, kan deze worden gebruikt.

Om de nodige onboarding te voltooien, moet u uw Webex Cisco BroadWorks-versie uitvoeren en moeten nieuwe partners de online Indirect Channel Partner Agreement (ICPA) accepteren. Wanneer deze stappen zijn voltooid, maakt Cisco Compliance een nieuwe partner organisatie in Partner Hub (indien nodig) en verzendt een e-mail met verificatiegegevens naar de Beheerder van opname in uw organisatie. Tegelijkertijd neemt uw partneractivering en/of Customer Success Program Manager contact met u op om uw onboarding te starten.

Webex Partners in één regio kunnen klantorganisaties creëren in elke regio die wij de diensten aanbieden. Voor hulp raadpleegt u: Data residentie in Webex.

Services configureren op uw Webex voor Cisco BroadWorks XSP|ADPs

We eisen dat de NPS-toepassing op een andere XSP|ADP wordt uitgevoerd. De vereisten voor die XSP|ADP worden beschreven in Configure Call Notifications from your Network.

U hebt de volgende toepassingen / diensten nodig op uw XSP|ADP's.

Service/toepassing

Verificatie vereist

Service-/toepassingsdoel

Xsi-Events

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, servicemeldingen

Xsi-acties

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, acties

Apparaatbeheer

TLS (server verifieert zichzelf bij clients)

Calling-configuratie downloaden

Verificatieservice

TLS (server verifieert zichzelf bij clients)

Gebruikersverificatie

Integratie van computertelefonie

mTLS (client en server verifiëren elkaar)

Telefonische aanwezigheid

Gespreksinstellingen Webview-toepassing

TLS (server verifieert zichzelf bij clients)

Stelt instellingen voor gebruikersoproepen bekend in de selfcare-portal in de Webex-app

In dit hoofdstuk wordt beschreven hoe u de vereiste configuraties voor TLS en mTLS op deze interfaces kunt toepassen, maar u moet de bestaande documentatie raadplegen om de applicaties op uw XSP|ADP's te installeren.

Vereisten voor co-residentie

  • Authenticatie Service moet co-resident zijn met Xsi-toepassingen, omdat deze interfaces tokens met lange levensduur moeten accepteren voor serviceautorisatie. De verificatieservice is vereist om deze tokens te valideren.

  • De verificatieservice en Xsi kunnen indien nodig op dezelfde poort worden uitgevoerd.

  • U kunt de andere diensten/applicaties scheiden zoals vereist voor uw schaal (bijvoorbeeld dedicated device management XSP|ADP farm).

  • U kunt de Xsi-, CTI-, verificatieservice en DMS-toepassingen co-lokaliseren.

  • Installeer geen andere toepassingen of diensten op de XSP|ADP's die worden gebruikt voor de integratie van BroadWorks met Webex.

  • Zoek de NPS-toepassing niet samen met andere toepassingen.

Xsi-interfaces

Installeer en configureer de Xsi-Actions en Xsi-Events toepassingen zoals beschreven in Cisco BroadWorks Xtended Services Interface Configuratiegids.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moeten dezelfde callControlApplicationName hebben zoals gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker wordt ingeschakeld bij Webex, maakt Webex een abonnement voor de gebruiker op het AS om telefonieevenementen voor aanwezigheid en oproepgeschiedenis te ontvangen. Het abonnement is gekoppeld aan de callControlApplicationName en het AS gebruikt het om te weten naar welke Xsi-Events de telefonie events moeten sturen.

Het wijzigen van de callControlApplicationName, of het niet hebben van dezelfde naam op alle Xsi-Events webapps zal gevolgen hebben voor abonnementen en telefonie events functionaliteit.

Verificatieservice configureren (met ci-tokenvalidatie)

Gebruik deze procedure om de verificatieservice te configureren om de CI-tokenvalidatie met TLS te gebruiken. Deze authenticatiemethode wordt aanbevolen als u R22 of hoger gebruikt en uw systeem dit ondersteunt.

Gemeenschappelijke TLS (mTLS) wordt ook ondersteund als alternatieve verificatiemethode voor de verificatieservice. Als u meerdere Webex-organisaties hebt die op dezelfde XSP|ADP-server draaien, moet u mTLS-authenticatie gebruiken omdat CI Token Validation niet meerdere verbindingen met dezelfde XSP|ADP Auth Service ondersteunt.

Om mTLS-authenticatie voor de Auth-service in plaats van CI-token-validatie te configureren, raadpleegt u de Bijlagevoor Services configureren (met mTLS voor de Auth-service).

Als u momenteel mTLS voor de verificatieservice gebruikt, is het niet verplicht dat u opnieuw configureert om de CI-tokenvalidatie met TLS te gebruiken.

  1. OAuth-referenties voor uw Webex voor Cisco BroadWorks verkrijgen.

  2. Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw release:

    Elke verwijzing naar XSP omvat XSP of ADP.

  3. Installeer de AuthenticationService toepassing op elke XSP|ADP service.

    1. Voer het volgende commando uit om de AuthenticationService-applicatie op de XSP|ADP te activeren naar het /authService-contextpad.

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
    2. Voer dit commando uit om de AuthenticationService op de XSP|ADP te implementeren:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
  4. Beginnend met Broadworks build 2022.10 worden de certificaatautoriteiten die met Java komen niet meer automatisch opgenomen in de BroadWorks truststore bij het overschakelen naar een nieuwe versie van java. De AuthenticationService opent een TLS-verbinding met Webex om het toegangstoken op te halen, en moet het volgende hebben in de truststore om de IDBroker en Webex URL te valideren:

    • IdenTrust Commerciële Root CA 1

    • Go Daddy Root certificaatautoriteit - G2

    Verifieer of deze certificaten aanwezig zijn onder volgende CLI

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

    Indien niet aanwezig, voer dan het volgende commando uit om de standaard Java-trusts te importeren:

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

    U kunt deze certificaten ook handmatig toevoegen als vertrouwensankers met het volgende commando:

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

    Als de ADP is geüpgraded van een vorige release, dan worden de certificaatautoriteiten van de oude release automatisch geïmporteerd naar de nieuwe release en blijven geïmporteerd totdat ze handmatig worden verwijderd.

    De AuthenticationService-applicatie is vrijgesteld van de validatePeerIdentity-instelling onder ADP_CLI/System/SSLCommonSettings/GeneralSettings, en valideert altijd de peer Identity. Bekijk de Categorie: Cisco Broadworks509Certificaat Validatie FDvoor meer informatie over deze instelling.

  5. Configureer de Identity Providers door de volgende commando's uit te voeren op elke XSP|ADP server:

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

    • set clientId client-Id-From-Step1

    • set enabled true

    • set clientSecret client-Secret-From-Step1

    • set ciResponseBodyMaxSizeInBytes 65536

    • set issuerName <URL>—Voor de URL, voer de URL van de uitgiftenaam in die van toepassing is op uw CI-cluster. Zie volgende tabel.

    • set issuerUrl <URL>—Voor de URL, voer de VerlenerUrl in die van toepassing is op uw CI-cluster. Zie onderstaande tabel.

    • set tokenInfoUrl <IdPProxy URL>—Voer de IdP-proxy-URL in die van toepassing is op uw Teams-cluster. Zie de tweede tabel die volgt.

    Table 1. Set issuerName and issuerURL
    Als het CI-cluster is...Stel issuerName en issuerURL in...

    VS-A

    https://idbroker.webex.com/idb

    EU

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

    VS-B

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

    Ca

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

    CATEGORIE: SG

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

    INCH

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

    CATEGORIE: AE

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

    AU

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

    Als je je niet kent CI Cluster, u kunt de informatie verkrijgen uit de klantgegevens in de Help Desk-weergave van Control Hub.

    Table 2. Set tokenInfoURL
    Als het Teamcluster is...TokenInfoURL instellen op...(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

    CATEGORIE: ADXB

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

    CATEGORIE: ASYD

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

    • Als je je niet kent Teams Cluster, u kunt de informatie verkrijgen van de klantgegevens in de Help Desk-weergave van Control Hub.

    • Voor het testen kunt u controleren of de tokenInfoURL geldig is door het vervangen van de "idp/authenticate" gedeelte van de URL met "ping".

  6. Specificeer de Webex-machtiging die aanwezig moet zijn in gebruikersprofiel Webex door de volgende opdracht uit te voeren:

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

  7. Configureer Identity Providers voor Cisco Federation met behulp van de volgende commando's op elke XSP|ADP-server:

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

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

    • set refreshPeriodInMinutes 60

    • set refreshToken refresh-Token-From-Step1

  8. Voer de volgende opdracht uit om te controleren of uw FLS-configuratie werkt. Met deze opdracht wordt de lijst met identiteitsproviders retourneren:

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

  9. Configureer Token Management met de volgende commando's op elke XSP|ADP-server:

    • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

    • set tokenIssuer BroadWorks

    • set tokenDurationInHours 720

  10. RSA-sleutels genereren en delen. U moet sleutels genereren op een XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's. De volgende factoren zijn van invloed op het volgende:

    • U moet dezelfde openbare/privésleutelparen gebruiken voor de codering/decodering van het token in alle exemplaren van de verificatieservice.

    • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet verlenen.

    Als u sleutels fietst of de lengte van de sleutel verandert, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw opstarten.

    1. Selecteer één XSP|ADP om te gebruiken voor het genereren van een sleutelpaar.

    2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen uit de browser van de client:

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

      (Dit genereert een private / publieke sleutelpaar op de XSP|ADP, als er nog niet een was)

    3. De locatie voor het opslaan van de sleutel kan niet worden geconfigureerd. Exporteert u de sleutels:

      XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP's, overschrijven van een oudere .keys bestand indien nodig.

    5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

  11. Geef de authService-URL aan de webcontainer door. De webcontainer van XSP|ADP heeft de authService URL nodig, zodat het tokens kan valideren. Op elk van de XSP|ADP's:

    1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het BroadWorks Communications Utility:

      XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1:80/authService

    2. Voeg de URL van de verificatieservice toe aan de container:

      XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService

      Hiermee kan Webex de verificatieservice gebruiken om de tokens die als aanmeldgegevens worden gepresenteerd, te valideren.

    3. Controleer de parameter met get.

    4. Herstart de XSP|ADP.

Client Authentication Requirement voor Auth Service verwijderen (alleen R24)

Als u de verificatiedienst hebt geconfigureerd met CI-token-validatie op R24, moet u ook de vereiste cliëntauthenticatie voor de verificatiedienst verwijderen. Voer het volgende CLI-commando uit:

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

TLS en Versleutelingen configureren op de HTTP-interfaces (voor XSI en de verificatieservice)

De verificatieservice, Xsi-Acties en Xsi-Events-toepassingen maken gebruik van HTTP-serverinterfaces. De niveaus van TLS-configuratie voor deze toepassingen zijn als volgt:

Algemeen = System > Transport > HTTP > HTTP Server-interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen zijn:

Specificiteit CLI-context
Systeem (algemeen)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP-server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get gebruiken en de resultaten te lezen. U moet de interfaces (IP-adressen) en, voor elk, bekijken of ze beveiligd zijn en of clientverificatie vereist is.

Het gaat om een certificaat voor elke beveiligde interface. genereert het systeem een zelf-ondertekend certificaat indien dat nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

Results displayed after entering the get command, showing interfaces (IP addresses) and, for each, whether they are secure and whether they require client authentication.

TLS toevoegen 1.2 Protocol aan de HTTP-serverinterface

De HTTP-interface die interageert met de Webex Cloud moet geconfigureerd worden voor TLSv1.2. De cloud onderhandelen niet over eerdere versies van het TLS-protocol.

Om het TLSv1.2-protocol op de HTTP-serverinterface te configureren:

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al worden gebruikt in deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS kan gebruiken 1.2 bij communicatie met de cloud.

TLS-versleutelingsconfiguratie bewerken op de HTTP-serverinterface

De vereiste versleutelingen configureren:

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke versleutelingen al worden gebruikt in deze interface. Er moet minstens één van de door Cisco aanbevolen suites zijn (zie XSP|ADP Identiteits- en beveiligingsvereisten in het hoofdstuk Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de HTTP-serverinterface.

    De XSP|ADP CLI vereist de IANA standaard cipher suite naam, niet de openSSL cipher suite naam. Bijvoorbeeld, om de openSSL-versleuteling toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 naar de HTTP-serverinterface gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Zie https://ciphersuite.info/om de suite met beide namen te vinden.

Apparaatbeheer configureren op XSP|ADP, Application Server en Profile Server

Profile Server en XSP|ADP zijn verplicht voor Device Management. Ze moeten worden geconfigureerd volgens de instructies in de BroadWorks configuratiegids voor apparaatbeheer.

CTI-interface en gerelateerde configuratie

Diagram of CTI Interface and Related Configuration for step 1, setup, and step 2, steady state

De 'inmost to outmost' configuratieorder wordt hieronder vermeld. Het volgen van deze bestelling is niet verplicht.

  1. Toepassingsserver configureren voor CTI-abonnementen

  2. XSP|ADP's configureren voor mTLS Authenticated CTI-abonnementen

  3. Inkomende poorten voor de beveiligde CTI-interface openen

  4. Abonneer uw Webex-organisatie op BroadWorks CTI Events

Toepassingsserver configureren voor CTI-abonnementen

Werk de ClientIdentity on Application Server bij met de algemene naam (CN) van het CTI-clientcertificaat van Webex voor Cisco BroadWorks.

Voeg de certificaatidentiteit als volgt toe voor elke toepassingsserver die u met Webex gebruikt:

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

De algemene naam van het Cisco BroadWorks-clientcertificaat van Webex is bwcticlient.webex.com.

TLS en Versleutelingen configureren op de CTI-interface

De configuratieniveaus voor de XSP|ADP CTI-interface zijn als volgt:

Algemeen = System > Transport > CTI-interfaces > CTI-interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen zijn:

Specificiteit

CLI-context

Systeem (algemeen)

(R22 en hoger)

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

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

Transportprotocollen voor dit systeem

(R22 en hoger)

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

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

Alle CTI-interfaces op dit systeem

(R22 en hoger)

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

XSP|ADP_CLI/Interface/CTI/SSLCommonInstellingen/Protocollen>

Een specifieke CTI-interface op dit systeem

(R22 en hoger)

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

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

Bij een nieuwe installatie worden de volgende ciphers standaard op systeemniveau geïnstalleerd. Als er niets is geconfigureerd op het interfaceniveau (bijvoorbeeld op de CTI-interface of HTTP-interface), is deze cipher-lijst van toepassing. Merk op dat deze lijst na verloop van tijd kan veranderen:

  • 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

CTI TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Voer de get gebruiken en de resultaten te lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze een servercertificaat nodig hebben en of clientverificatie is vereist.

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

TLS toevoegen 1.2 Protocol bij de CTI-interface

De XSP|ADP CTI-interface die interageert met de Webex Cloud moet geconfigureerd worden voor TLS v1.2. De cloud onderhandelen niet over eerdere versies van het TLS-protocol.

Om het TLSv1.2-protocol op de CTI-interface te configureren:

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> om te zien welke protocollen al worden gebruikt in deze interface.

  3. Voer de opdracht in add <interfaceIp> TLSv1.2 om ervoor te zorgen dat de interface TLS kan gebruiken 1.2 bij communicatie met de cloud.

TLS-ciphers-configuratie bewerken op de CTI-interface

De vereiste versleutelingen configureren via de CTI-interface:

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Voer de get opdracht om te zien welke versleutelingen al worden gebruikt in deze interface. Er moet minstens één van de door Cisco aanbevolen suites zijn (zie XSP|ADP Identiteits- en beveiligingsvereisten in het hoofdstuk Overzicht).

  3. Voer de opdracht in add <interfaceIp> <cipherName> om een code aan de CTI-interface toe te voegen.

    De XSP|ADP CLI vereist de IANA standaard cipher suite naam, niet de openSSL cipher suite naam. Bijvoorbeeld, om de openSSL-versleuteling toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 naar de CTI-interface gebruikt u: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Zie https://ciphersuite.info/om de suite met beide namen te vinden.

Vertrouwensankers voor CTI-interface (R22 en hoger)

Deze procedure gaat ervan uit dat de XSP|ADP's ofwel internetgericht zijn of via pass-through proxy naar het internet gericht zijn. De certificaatconfiguratie is anders voor een overbruggingsproxy (zie TLS-certificaatvereisten voor TLS-bridge-proxy).

Doe voor elke XSP|ADP in uw infrastructuur die CTI-evenementen aan Webex publiceert het volgende:

  1. Meld u aan bij Partner Hub.

  2. Ga naar Services > Additional links en klik op Download Webex CA Certificate om te krijgen CombinedCertChain2023.txt op uw lokale computer.

    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze naar de XSP|ADP's uploadt. Alle bestanden zijn verplicht.

  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste blok tekst, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----, en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één blok tekst bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt

  5. Meld u aan bij de XSP|ADP en navigeer naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Optioneel) Uitvoeren help updateTrust om de parameters en opdrachtindeling te zien.

  7. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 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

    Alle aliassen moeten een andere naam hebben. webexclientroot2023en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen aliassen gebruiken zolang alle items uniek zijn.

  8. Bevestig dat de ankers zijn bijgewerkt:

    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. Clients toestaan zich te verifiëren met certificaten:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

CTI-interface toevoegen en mTLS inschakelen

  1. Voeg de CTI SSL-interface toe.

    De CLI-context is afhankelijk van uw BroadWorks-versie. De opdracht maakt een zelf-ondertekend servercertificaat in de interface en dwingt de interface af om een clientcertificaat te vereisen.

    • Op BroadWorks R22 en R23:

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

  2. Vervang het servercertificaat en de sleutel op de CTI-interfaces van de XSP|ADP. U hebt hiervoor het IP-adres van de CTI-interface nodig; kunt u het lezen vanuit de volgende context:

    • Op BroadWorks R22 en R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Voer vervolgens de volgende opdrachten uit om het zelf-ondertekende certificaat van de interface te vervangen door uw eigen certificaat en privésleutel:

      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. Herstart de XSP|ADP.

Toegang tot BroadWorks CTI Events inschakelen op Webex

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters in Partner Hub configureert. Zie Uw partnerorganisatie configureren in Partner Hubvoor gedetailleerde instructies.

  • Geef het CTI-adres op waarmee Webex zich kan abonneren op BroadWorks CTI Events.

  • CTI-abonnementen worden op basis van abonneeabonnementen alleen vastgesteld en behouden, zolang deze abonnee is ingericht voor Webex voor Cisco BroadWorks.

Webview gespreksinstellingen

Call Settings Webview (CSWV) is een applicatie die wordt gehost op XSP|ADP om gebruikers in staat te stellen hun BroadWorks-oproepinstellingen te wijzigen via een webview die ze in de soft client zien. Bekijk de Cisco BroadWorks Call Settings Webview Solution Guide.

Webex maakt gebruik van deze functie om gebruikers toegang te bieden tot gemeenschappelijke BroadWorks-oproepinstellingen die niet eigen zijn aan de Webex-app.

Als u wilt dat uw Webex voor Cisco BroadWorks-abonnees toegang heeft tot gespreksinstellingen buiten de standaardinstellingen in de Webex-app, moet u de Webview-functie Gespreksinstellingen implementeren.

Gespreksinstellingen Webview bestaat uit twee componenten:

  • Oproep Instellingen Webview-applicatie, gehost op een Cisco BroadWorks XSP|ADP.

  • De Webex-app, die de oproepinstellingen in een webview weergeeft.

Gebruikerservaring

  • Windows-gebruikers: Klik op Call Settings en klik vervolgens op Open Call Preferences > Advanced Call Settings.

  • Mac-gebruikers: Klik op de profielfoto en vervolgens Preferences > Advanced Call Settings.

CSWV implementeren op BroadWorks

Webview voor oproepinstellingen installeren op XSP|ADP's

CSWV-applicatie moet op dezelfde XSP|ADP(s) staan die de Xsi-Actions-interface in uw omgeving host. Het is een onbeheerde toepassing op XSP|ADP, dus je moet een webarchiefbestand installeren en implementeren.

  1. Meld u aan bij cisco.com en zoek naar "BWCallSettingsWeb" in de sectie software downloaden.

  2. Zoek naar de meest recente versie van het bestand en download deze.

    Bijvoorbeeld: BWCallSettingsWeb_1.8.2_1.war ( https://software.cisco.com/download/home/286326302/type/286326345/vrijgave/RI.2022.04) was de meest recente op het moment van schrijven.

  3. Installeer, activeer en implementeer het webarchief volgens de Cisco BroadWorks Xtended Service Platform Configuration Guide voor uw XSP|ADP-versie. (R)24versie is https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).

    1. Kopieer het .war bestand naar een tijdelijke locatie op de XSP|ADP, zoals /tmp/.

    2. Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:

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

      De BroadWorks-softwaremanager valideert en installeert het bestand.

    3. [Optioneel] Verwijderen /tmp/BWCallSettingsWeb_1.7.5_1.war (dit bestand is niet meer vereist).

    4. Activeer de toepassing:

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      De naam en versie zijn verplicht voor elke toepassing, maar voor CSWV moet je ook een contextPath voorzien omdat het een onbeheerde toepassing is. U kunt elke waarde gebruiken die niet door een andere toepassing wordt gebruikt, bijvoorbeeld /callsettings.

    5. Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

  4. U kunt de URL voor gespreksinstellingen die u opgeeft voor clients nu als volgt voorspellen:

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

    Opmerkingen:

    • U moet de slash voor trailing op deze URL opgeven wanneer u deze betreedt in het configuratiebestand van de client.

    • De XSP|ADP-FQDN moet overeenkomen met de Xsi-Actions FQDN, omdat CSWV Xsi-Actions moet gebruiken en CORS niet wordt ondersteund.

    • Zorg ervoor dat u de <XSP|ADP-FQDN> naar de HttpAlias op elke ADP of XSP hosting CSWV: ADP_CLI/Interface/Http/HttpAlias>

  5. Herhaal deze procedure voor andere XSP|ADP's in uw Webex voor Cisco BroadWorks omgeving (indien nodig).

De toepassing Call Settings Webview is nu actief op de XSP|ADP's.

Configureer de Webex-app om Call Settings Webview te gebruiken

Voor meer informatie over de configuratie van de klant, zie Webex voor Cisco BroadWorks configuratiegids.

Er is een aangepaste tag in het Configuratiebestand van de Webex-app dat u kunt gebruiken om de CSWV-URL in te stellen. Deze URL toont de oproepinstellingen aan de gebruikers via de applicatie-interface.

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

Configureer in de configuratiesjabloon van de Webex-app op BroadWorks de CSWV-URL in de tag %WEB_CALL_SETTINGS_URL_WXT%.

Als u de URL niet expliciet opgeeft, is de standaard leeg en is de oproepinstellingenpagina niet zichtbaar voor de gebruikers.

  1. Zorg ervoor dat je over de nieuwste configuratiesjablonen beschikt voor de Webex-app (zie Device Profiles).

  2. Doel voor Webgespreksinstellingen instellen op csw:

    %WEB_CALL_SETTINGS_TARGET_WXT% csw

  3. Stel de URL van de instellingen voor weboproepen in voor uw omgeving, bijvoorbeeld:

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

    Deze waarde heb je afgeleid bij het inzetten van de CSWV-toepassing.

  4. Het hieruit voortkomende configuratiebestand van de client moet als volgt een vermelding hebben:

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

    Elke verwijzing naar XSP omvat XSP of ADP.

Pushmeldingen voor oproepen configureren in Webex voor BroadWorks

In dit document gebruiken we de term Call Notifications Push Server (CNPS) om een XSP-gehost of ADP-gehost applicatie te beschrijven die in uw omgeving draait. Uw CNPS werkt met uw BroadWorks-systeem om op de hoogte te zijn van inkomende gesprekken naar uw gebruikers en pusht meldingen van gebruikers naar Google Firebase Cloud Messaging (FCM) of Meldingsservices van Apple Push Notification service (APN's).

Deze services melden de mobiele apparaten van Webex voor Cisco BroadWorks-abonnees dat ze inkomende gesprekken hebben op Webex.

Voor meer informatie over NPS, zie de Notificatie Push Server Functiebeschrijving.

Een vergelijkbaar mechanisme in Webex werkt met Webex-berichtenservices en -aanwezigheidsservices om meldingen via Google (FCM) of Apple(APNS) te verzenden. Deze services informeren de mobiele Webex-gebruikers op de hoogte van inkomende berichten of aanwezigheidswijzigingen.

In dit gedeelte wordt beschreven hoe u NPS kunt configureren voor proxy-authenticatie wanneer de NPS nog geen andere apps ondersteunt. Als u een gedeelde NPS moet migreren om NPS-proxy te gebruiken, zie Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken.

Overzicht NPS-proxy

Voor compatibiliteit met Webex voor Cisco BroadWorks moet uw CNPS worden gepatcht om de NPS-proxy-functie, Push Server for VoIP in UCaaS, te ondersteunen.

De functie implementeert een nieuw ontwerp in de Push-server voor meldingen om het beveiligingsprobleem van het delen van pushmeldingcertificaat privésleutels met serviceproviders voor mobiele clients op te lossen. In plaats van pushmeldingscertificaten en -sleutels te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een pushmelding token voor korte gegevens te verkrijgen van Webex voor Cisco BroadWorks backend en gebruikt deze token voor verificatie met de Apple APN's en Google FCM-services.

De functie verbetert ook de mogelijkheid van de Notification Push Server om meldingen naar Android-apparaten te sturen via de nieuwe Google Firebase Cloud Messaging (FCM) HTTPv1 API.

APNS-overwegingen

Apple zal het op HTTP/1 gebaseerde binaire protocol op de Apple Push Notification-service na maart 31, 2021 niet langer ondersteunen. We raden u aan om uw XSP|ADP zo te configureren dat u de op HTTP/2 gebaseerde interface voor APN's gebruikt. Deze update vereist dat uw XSP|ADP die de NPS host, R22 of hoger draait.

Bereid uw NPS voor op Webex voor Cisco BroadWorks

1

Installeer en configureer een specifieke XSP (minimale versie R22), of Application Delivery Platform (ADP).

2

Installeer de NPS-verificatieproxypatches:

3

Activeer de pushservertoepassing voor meldingen.

4

(Voor Android-meldingen) Schakel de FCM v1 API in op de NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.

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

Dit is exclusief voor Release 22 en eerdere versies; het is niet beschikbaar in Release 23 en bovenstaande versies, die alleen HTTP/2 ondersteunen.

6

Voeg een technische ondersteuning vanuit de NPS XSP/ADP toe.

7

Op elke AS-server:

  • Stel de Push-URL in, Voorbeeld: AS_CLI/System/NotificationPushServer> URL instellen https://qaxsps.broadsoft.com/nps

  • Het namedefs-bestand in /usr/local/broadworks/bw_base/conf moet worden geconfigureerd met SRV- en A-records voor het opzoeken van Notification Push Server (XSP/ADP). Als er meerdere XSP/ADP zijn, voeg dan een item voor elk toe zoals vereist.

Voorbeeld voor meerdere ADP/XSP:

_pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 ADP1-qaxsps.broadsoft.com

_pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 ADP2-qaxsps.broadsoft.com

ADP1-qaxsps.broadsoft.com IN A 10.193.78.149

ADP2-qaxsps.broadsoft.com IN A 10.193.78.150

Eenmaal ingesteld, is een van de volgende vereist om de wijzigingen op te halen:

  1. Een herstartbw wordt voorgevormd in een onderhoudsvenster.

  2. Via de Cisco BroadWorks CLI:

    R24 en ouder

    AS_CLI/ASDiagnostic/DNS> herladen

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> herladen

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> herladen

De volgende stappen

Voor verse installaties van een NPS, ga naar Configureer NPS om authenticatieproxy te gebruiken

Een bestaande Android-implementatie migreren naar FCMv1, ga naar Migreer NPS naar FCMv1

Configureer NPS om authenticatieproxy te gebruiken

Deze taak is van toepassing op een nieuwe installatie van NPS, toegewezen aan Webex voor Cisco BroadWorks.

Als u de authenticatieproxy wilt configureren op een NPS die wordt gedeeld met andere mobiele apps, zie Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken.

1

OAuth-referenties voor uw Webex voor Cisco BroadWorks verkrijgen.

2

Maak de clientaccount in de 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: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Voer uit om te controleren of de waarden die u hebt ingevoerd, overeenkomen met wat u hebt gekregen XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

De CiscoCI issuerUrl moet ALTIJD een US CI-cluster zijn, ongeacht uw locatie en de standaard moet zijn:

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

3

Voer de NPS-proxy-URL in en stel het interval voor het vernieuwen van de token (30 minuten aanbevolen):

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

Om de snelheid van de DNS-resolutie te verbeteren, raden we u aan om in plaats van de huidige FQDN nps.uc-one.broadsoft.com de juiste FQDN te gebruiken op basis van uw regio.

Regionale FQDN's:

Oosten van de Verenigde Staten:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-a.wbx2.com/nps/

US West:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-r.wbx2.com/nps/

Europa:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

Saoedi-Arabië:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-d.wbx2.com/nps/

Australië:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-m.wbx2.com/nps/

Als de time-out van pushmeldingen te wijten aan een vertraging in de DNS-resolutie, verhoogt u de timeout-waarde in het bestand "/etc/resolv.conf" op de BroadWorks-server.

4

(Voor Android-meldingen) Voeg de Id van de Android-toepassing toe aan de context van FCM-toepassingen op de NPS.

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

5

(Voor Apple iOS-meldingen) Voeg de toepassings-id toe aan de context van APNS-toepassingen, zodat u de Auth-sleutel weglaten en deze leeg laat.

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

6

Configureer de volgende NPS-URL's:

XSP|ADP CLI Context

Parameter

Waarde

  • XSP|ADP_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|ADP_CLI/Applications/NotificationPushServer/APNS/Production>

url

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

7

Configureer de volgende NPS-verbindingsparameters voor de aanbevolen waarden die worden weergegeven:

XSP|ADP CLI Context

Parameter

Waarde

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Controleer of de toepassingsserver een toepassings-id heeft, omdat u de Webex-apps mogelijk aan de lijst met toegestane toepassingen moet toevoegen:

  1. Uitvoeren AS_CLI/System/PushNotification> get en controleer de waarde van enforceAllowedApplicationList. Als het true, moet u deze subtaak voltooien. Anders slaat u de rest van de subtaak 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

Herstart de XSP|ADP: bwrestart

10

Test gespreksmeldingen door een BroadWorks-abonnee te bellen naar twee mobiele Webex-gebruikers. Controleer of de oproepmelding verschijnt op iOS- en Android-apparaten.

Migreer NPS naar FCMv1

Dit onderwerp bevat optionele procedures die u kunt gebruiken in Google FCM Console wanneer u een bestaande NPS-implementatie hebt die u naar FCMv moet migreren1. Er zijn drie procedures:

UC-One-clients migreren naar FCMv1

Gebruik de onderstaande stappen in Google FCM Console om UC-One-clients te migreren naar Google FCM HTTPv1.

Als branding is toegepast op de client, moet de client de afzender-id hebben. In de FCM Console, zie Project Settings > Cloud Messaging. De instelling wordt weergegeven in de tabel aanmeldgegevens van Project.

Voor meer informatie, zie de Handleiding voor mobiele branding verbinden. Raadpleeg de gcm_defaultSenderId parameter, die zich bevindt in de brandingkit, resourcemap, branding.xml-bestand met de onderstaande syntaxis:

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

  1. Log in op FCM Admin SDK op http://console.firebase.google.com.

  2. Selecteer de juiste Android-toepassing.

  3. Op het tabblad General tabblad, registreer het project-ID

  4. Ga naar het tabblad Service accounts om een service account te configureren. U kunt een nieuw service account maken of een bestaand account configureren.

    Een nieuwe serviceaccount maken:

    1. Klik op de blauwe knop voor het maken van een nieuw serviceaccount

    2. Klik op de blauwe knop om een nieuwe privésleutel te genereren

    3. Sleutel downloaden naar een veilige locatie

    Een bestaand serviceaccount opnieuw gebruiken:

    1. Klik op de blauwe tekst om de bestaande serviceaccounts weer te krijgen.

    2. Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.

    3. Aan de rechterkant klikt u op het menu menu van het menu en maakt u een nieuwe privésleutel.

    4. Download het JSON-bestand dat de sleutel bevat en sla het op een veilige locatie op.

  5. Kopieer het json-bestand naar de XSP|ADP.

  6. Configureer de project-id en:

    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. Configureer de toepassing:

    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. FCMv inschakelen1:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw op te starten.

SaaS-clients naar FCMv migreren1

Gebruik de onderstaande stappen op Google FCM Console als u SaaS-clients naar FCMv wilt migreren1.

Zorg ervoor dat u de procedure 'NPS configureren voor het gebruik van de verificatieproxy' al hebt voltooid.

  1. FCM uitschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw op te starten.

  3. FCM inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw op te starten.

ADP-server bijwerken

Gebruik de onderstaande stappen in Google FCM Console als u de NPS migreert om een ADP-server te gebruiken.

  1. Haal het JSON-bestand op via de Google Cloud Console:

    1. Ga op de Google Cloud Console naar de Service Accounts .

    2. Klik op Select a project, kies uw project en klik op Open.

    3. Zoek de rij van het service-account waarvoor u een sleutel wilt aanmaken, klik op de More verticale knop, klik dan op Create key.

    4. Selecteer een Key typ en klik op Create

      De bestandsdownloads.

  2. FCM toevoegen aan de ADP-server:

    1. Importeer het JSON-bestand naar de ADP-server met behulp van de /bw/install Opdracht.

    2. Meld u aan bij de ADP CLI en voeg project- en API-sleutel toe:

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

    3. Voeg daarna de toepassing en het sleutel toe:

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

    4. Controleer de configuratie:

      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

Uw partnerorganisatie configureren in Partner Hub

Uw BroadWorks-clusters configureren

[eenmaal per cluster]

Dit gebeurt om de volgende redenen:

  • Om Webex cloud in staat te stellen uw gebruikers te authenticeren tegen BroadWorks (via XSP|ADP-gehoste authenticatiedienst).

  • Webex-apps inschakelen om de Xsi-interface voor gespreksbeheer te gebruiken.

  • Webex in staat stellen te luisteren naar CTI-gebeurtenissen die zijn gepubliceerd door BroadWorks (telefonie-aanwezigheid en gespreksgeschiedenis).

De clusterwizard valideert automatisch de interfaces zodra u deze toevoegt. U kunt de cluster blijven bewerken als een van de interfaces niet met succes valideren, maar u kunt een cluster niet opslaan als er ongeldige items zijn.

We voorkomen dit omdat een verkeerd geconfigureerde cluster problemen kan veroorzaken die moeilijk kunnen worden opgelost.

Wat u moet doen:

  1. Meld u aan bij Partner Hub op admin.webex.com.

  2. Openen Services pagina van het zijmenu, en vind Additional links kaart.

    Als de admin gebruiker geen zicht heeft op de Additional links kaart, het is aan te raden om een case te openen met Cisco TAC.

  3. Klik op Add Cluster.

    Dit opent een wizard waar u uw XSP|ADP interfaces (URL's) levert. U kunt een poort toevoegen aan de interface-URL als u een niet-standaardpoort gebruikt.

  4. Geef deze cluster een naam en klik Next.

    Het clusterconcept hier is gewoon een verzameling van interfaces, meestal samengebracht op een XSP|ADP-server of boerderij, die Webex in staat stellen om informatie van uw Application Server (AS) te lezen. U kunt één XSP|ADP per AS-cluster, of meerdere XSP|ADPs per cluster, of meerdere AS-clusters per XSP|ADP. De schaalvereisten voor uw BroadWorks-systeem vallen hier niet onder het bereik.

  5. (Optioneel) Voer een BroadWorks-gebruiker in Account Name en Password dat u weet dat zich binnen het BroadWorks-systeem bevindt dat u met Webex verbindt, klik dan op Next.

    Met de validatietests kan dit account worden gebruikt om de verbindingen met de interfaces in het cluster te valideren.

  6. Voeg uw XSI Actions en XSI Events URL's.

  7. Optioneel. Update de DAS URL met de URL van de Device Activation Service.

  8. Optioneel. Controleer de Enable direct BroadWorks authentication Selecteer dit keuzevakje als u wilt dat aanmeldingen bij BroadWorks direct bij BroadWorks zijn. Anders wordt authenticatie voor BroadWorks via de Webex-gehoste IdP-proxyservice verlengd.

    Dit selectievakje heeft betrekking op de volgende aanmeldingssituaties:

    • Gebruikers moeten hun BroadWorks-inloggegevens invoeren wanneer ze inloggen op het portaal. De bovenstaande instelling bepaalt of de aanmelding rechtstreeks bij BroadWorks is of via de IdP-proxy is.

    • Client Login—Als BroadWorks Authentication is geconfigureerd in de Onboarding-sjabloon, de bovenstaande instelling bepaalt of client-login bij de Webex-app rechtstreeks naar BroadWorks is of via de IdP-proxy wordt geïmpliceerd.

  9. Klik op Next.

  10. Selecteer in het deelvenster CTI Interface pagina, doe het volgende:

    1. Voeg de CTI URL en Port voor de CTI-interface waarmee je verbinding wilt maken.

    2. Optioneel. Schakel de Call History schakel in en voer vervolgens uw BroadWorks-gebruikers-ID in. Wanneer deze optie is geselecteerd, worden BroadWorks-oproepgeschiedenis-gebeurtenissen gesynchroniseerd met de Webex-cloud. Gebruikers kunnen hun gespreksgeschiedenis weergeven in de Webex-app.

    3. Optioneel. Schakel de Do not disturb (DND) sync schakel in en voer vervolgens uw BroadWorks-gebruikers-ID in. Deze optie synchroniseert DND-gebeurtenissen tussen Webex en BroadWorks, zodat de functie hetzelfde werkt op beide platforms.

    4. Optioneel. Schakel de Personal Assistant Status Sync schakel in en voer vervolgens uw BroadWorks-gebruikers-ID in. Deze optie synchroniseert de aanwezigheidsstatus van de persoonlijke assistent tussen de BroadWorks Calling-apparaten en de Webex-app.

    5. Klik op Next.

  11. Voeg uw Authentication Service URL invoeren.

  12. Selecteren Auth Service with CI token validation.

    Voor deze optie is niet vereist dat mTLS de verbinding vanuit Webex be beschermt, omdat de verificatieservice het gebruikers token correct valideert met de Webex-identiteitsservice voordat deze de lange token naar de gebruiker uit problemen geeft.

  13. Bekijk uw items op het laatste scherm en klik vervolgens op Create. Als het goed is, krijgt u een bericht met geslaagd.

    Partner Hub geeft de URL's door aan verschillende Webex-microservices die de verbindingen naar de opgegeven interfaces testen.

  14. Klik op View Clusters en je moet je nieuwe cluster zien en zien of de validatie geslaagd is.

  15. Het bericht Create knop kan worden uitgeschakeld op het laatste (preview) scherm van de wizard. Als u de sjabloon niet kunt opslaan, geeft deze een probleem aan met een van de integraties die u zojuist hebt geconfigureerd.

    We hebben deze controle geïmplementeerd om fouten in volgende taken te voorkomen. U kunt de wizard opnieuw doorlopen terwijl u uw implementatie configureert. Dit kan wijzigingen in uw infrastructuur vereisen (bijv. XSP|ADP, load balancer of firewall) zoals beschreven in deze handleiding, voordat u het sjabloon kunt opslaan.

De verbindingen naar uw BroadWorks-interfaces controleren

  1. Meld u aan bij Partner Hub (admin.webex.com) met de aanmeldgegevens van uw partnerbeheerder.

  2. Openen Services pagina van het zijmenu, en vind BroadWorks Calling kaart.

  3. Klik op View Broadworks Calling.

  4. Partner Hub start verbindingstests vanaf de verschillende microservices in de richting van de interfaces in de clusters.

    Nadat de tests zijn voltooid, wordt op de pagina Clusterlijst de statusmelding weergegeven naast elke cluster.

    U zou groene Success-berichten moeten zien. Als u een rood foutbericht ziet, klikt u op de naam van het betreffende cluster om te zien welke instelling het probleem veroorzaakt.

  5. Optioneel. Selecteer een cluster als u bestaande instellingen voor dat cluster wilt zien, zoals XSI-Actions, XSI-Events, DAS URL en de instellingen voor de CTI-interface.

Configureer uw Onboarding-sjablonen

Inwerksjablonen zijn de manier waarop u een gedeelde configuratie toepast op een of meer klanten terwijl u ze inschakelt via de leveringsmethoden. U moet elke sjabloon koppelen aan een cluster (dat u in het vorige gedeelte hebt gemaakt).

U kunt zoveel sjablonen maken als u nodig hebt, maar er kan maar één sjabloon aan een klant worden gekoppeld.

  1. Meld u aan bij de Partnerhuben selecteer Customers.

  2. Klik op de Onboarding templates knop om de bestaande sjablonen te bekijken.

  3. Klik op Create Template.

  4. Op het tabblad Template Details venster, voeg de naam van het sjabloon, land of regio en standaard e-mailtaal toe.

  5. Klik op het vervolgkeuzemenu voor de CCW Subscription ID, zoek de opgegeven abonnementen voor de partner, en selecteer het toepasselijke abonnement.

    Dit veld wordt alleen getoond voor partners die zijn gemigreerd van Webex voor BroadWorks naar Webex.

  6. Op het tabblad Service Setting Gebruik het vervolgkeuzemenu Cluster om het cluster te kiezen dat u met dit sjabloon wilt gebruiken.

  7. Voer een Template Name, klik dan op Next.

  8. Configureer uw inrichtingsmodus aan de hand van deze aanbevolen instellingen:

    Table 3. Recommended Provisioning Settings for Different Provisioning Modes

    Naam van instelling

    Doorstromen door de inrichting met vertrouwde e-mails

    Doorstromen zonder e-mails

    Zelfvoorzieningen voor gebruikers

    Enable BroadWorks Flow Through Provisioning (voeg de referenties van de provisioning-rekening toe indien Op**)

    Aan

    Levering van de voorziening Account Name en Password volgens de configuratie van BroadWorks.

    Aan

    Levering van de voorziening Account Name en Password volgens de configuratie van BroadWorks.

    Uit

    Automatically Create New Organizations in Control Hub

    Op

    Op

    Op

    Service Provider Email Address

    Selecteer een e-mailadres in de vervolgkeuzelijst (u kunt bepaalde tekens typen) om het adres te vinden voor een lange lijst.

    Dit e-mailadres identificeert de beheerder binnen uw partnerorganisatie die gedelegeerde beheerderstoegang krijgt tot nieuwe klantorganisaties die zijn aangemaakt met het sjabloon Onboarding.

    Country

    Kies welk land u voor deze sjabloon gebruikt.

    Het land dat u kiest, komt overeen met klantorganisaties die met dit sjabloon zijn gemaakt in een bepaalde regio. De regio kan momenteel (EMEAR) of (Noord-Amerika en de rest van de wereld) zijn. Bekijk de mappings van land naar regio in deze spreadsheet.

    Het land van de organisatie bepaalt de standaard globale call-in nummers voor Cisco PSTN in Webex Meeting Sites. Raadpleeg de sectie Land van helppaginavoor meer informatie.

    BroadWorks Enterprise Mode Active

    Schakel dit in als de klanten die u met deze sjabloon inrichten ondernemingen zijn in BroadWorks.

    Als het groepen zijn, laat u deze switch uit.

    Als u een combinatie van ondernemingen en groepen hebt in uw BroadWorks, moet u verschillende sjablonen voor deze verschillende gevallen maken.

    Aantekeningen uit de tabel:

    • † met deze schakelaar wordt ervoor zorgen dat er een nieuwe klantorganisatie wordt gemaakt als het e-maildomein van een abonnee niet overeen komt met een bestaande Webex-organisatie.

      Dit dient altijd in te staan, tenzij u een handmatig bestel- en uitvoeringsproces (via Cisco Commerce Workspace) gebruikt om klantorganisaties in Webex te maken (voordat u begint met het inrichten van gebruikers in die organisaties). Deze optie wordt vaak het model 'Hybride provisioning' genoemd en valt buiten het bereik van dit document.

    • ** "Provisioning account" verwijst naar het beheeraccount op systeemniveau van BroadWorks. Op BroadWorks heb je een admin account nodig met deze attributen: Administrator Type=Provisioning, alleen-lezen=Off.

  9. Selecteer het standaarddienstenpakket voor klanten met behulp van dit sjabloon (zie Pakketten in het gedeelte Overzicht); ofwel Basic, Standard, Premium of Softphone.

    U kunt deze instelling overschrijven voor individuele gebruikers via Partner Hub.

  10. Optioneel. Controleren Disable Cisco Webex Free Calling als u Webex-oproepen wilt uitschakelen,.

  11. Voor Meeting Join Configuration, kies een van de volgende opties:

    • Cisco Call-in Numbers (PSTN)

    • Partner-provided Call-in Numbers (BYoPSTN)—Als u deze optie selecteert, raadpleeg dan de Bring Your Own PSTN Solution Guide for Webex for Cisco BroadWorks voor gedetailleerde informatie over het configureren van deze optie.

  12. Klik op Next.

  13. Er zijn twee benaderingen voor het verstrekken van abonnees met betrekking tot hoe hun identiteit wordt geverifieerd - met behulp van vertrouwde e-mails of niet-vertrouwde e-mails.

    In de Trusted Email workflow geven gebruikers e-mailadressen aan de partner die ze in BroadWorks toevoegt. U als partner bent verantwoordelijk voor het verstrekken van het e-mailadres als onderdeel van de doorstroom of API methode.

    Het wordt ten zeerste aanbevolen om de Trusted provisioning methode te gebruiken, omdat het ervoor zorgt dat alle abonnees volledig worden voorzien door u als partner en er geen actie vereist is van de eindgebruikers.

    In het Onvertrouwde e-mailgeval moeten gebruikers hun e-mails verifiëren voordat ze worden geleverd, of kunnen gebruikers zichzelf activeren.

    In het onvertrouwde geval zijn er verschillende voorzieningsmodi gebaseerd op de verificatie-instellingen in de onderstaande tabel:

    Table 4. Recommended User Verification Settings for Untrusted Provisioning Modes

    Naam van instelling

    Doorstromen zonder e-mails

    Zelfvoorzieningen voor gebruikers

    Provisiebeheerder eerst

    Aanbevolen*

    Niet van toepassing

    Gebruikers toestaan zichzelf te activeren

    Niet van toepassing

    Vereist

    • Aantekeningen uit de tabel:

    • * Elke klantenorganisatie in Webex moet minstens één gebruiker hebben met een beheerdersrol. De eerste gebruiker aan wie u Integrated IM&P in BroadWorks toewijst, neemt de rol van customer administrator als er een nieuwe klantenorganisatie wordt aangemaakt in Webex. Als dienstverlener wilt u misschien controle hebben over wie de rol krijgt. Als u deze instelling selecteert, worden gebruikers verhinderd de activering te voltooien totdat de eerste gebruiker die u hebt ingesteld, is geactiveerd. Als u deze instelling uitvinkt, wordt de klantbeheerder de eerste gebruiker die actief wordt in de nieuwe organisatie.

  14. Klik op Next.

  15. Selecteer de standaard authenticatiemodus (ofwel BroadWorks Authentication of Webex Authentication) voor gebruiker login op Webex.

    Deze instelling heeft geen invloed op het inloggen van de gebruiker op het User Activation Portal. Gebruikers moeten hun BroadWorks gebruikers-ID en wachtwoord gebruiken bij het inloggen op het portaal, ongeacht hoe de Onboarding template is geconfigureerd.

    Deze instelling wordt alleen toegepast op nieuwe klantenorganisaties. Als partnerbeheerders een nieuwe verificatie-instelling proberen toe te passen op bestaande klantorganisaties, zijn de bestaande instellingen van toepassing zodat bestaande gebruikers de toegang niet verliezen. Als u de verificatiemodus voor bestaande organisaties van klanten wilt wijzigen, moet u een ticket openen bij Cisco TAC.

    (Zie Authenticatiemodus in de sectie Voorbereiding van uw omgeving).

  16. Klik op Next.

  17. Voor Preferences, configureer het volgende:

    1. Kies of u wilt Prefill user email addresses in login page.

      Gebruik deze optie alleen als u hebt geselecteerd BroadWorks Authentication en hebben ook de e-mailadressen van de gebruikers in het attribuut Alternate ID in BroadWorks geplaatst. Anders moeten ze hun BroadWorks-gebruikersnaam gebruiken. De aanmeldpagina geeft een optie om de gebruiker te wijzigen, indien nodig, maar dit kan tot aanmeldproblemen leiden.

    2. Als u de synchronisatie van mappen wilt inschakelen, stelt u de Enable phone directory sync for all new customer organizations Schakelen naar Aan.

      Met deze optie kan Webex BroadWorks-contactpersonen in de klantorganisatie lezen, zodat gebruikers deze kunnen vinden en bellen in de Webex-app.

    3. Voer een Partner Admin.

      Deze naam wordt gebruikt in de geautomatiseerde e-mailbericht Webex waarmee gebruikers worden uitgenodigd hun e-mailadres te valideren.

    4. Zorg ervoor dat de knop E-mails voor admin-uitnodiging toestaan bij het koppelen aan bestaande organisaties Aan staat (de standaardinstelling is Aan).

    5. Klik op Next.

  18. Bekijk uw vermeldingen op het uiteindelijke scherm. U kunt boven aan de wizard op de navigatiebedieningselementen klikken om terug te gaan en gegevens te wijzigen. Klik op Create.

    Als het goed is, krijgt u een bericht met geslaagd.

  19. Klik op View Templates en je moet je nieuwe sjabloon zien opgelijst met andere sjablonen.

  20. Klik op de sjabloonnaam om de sjabloon indien nodig aan te passen of te verwijderen.

    U hoeft de gegevens van het inrichtingsaccount niet opnieuw in te voeren. De lege velden voor wachtwoord-/wachtwoord bevestigen zijn er om de referenties te wijzigen als u dat wilt, maar laat deze leeg om de waarden die u aan de wizard hebt gegeven, te behouden.

  21. Voeg meer sjablonen toe als u verschillende gedeelde configuraties hebt die u aan klanten wilt aanbieden.

    Bewaar de View Templates pagina geopend, omdat u mogelijk sjabloondetails nodig hebt voor een volgende taak.

Configureer de toepassingsserver met de URL voor inrichtingsservice

Deze taak is alleen vereist voor flow through provisioning.

Patch Application Server (alleen R22, R23 en R24)

  1. Als u dit nog niet hebt gedaan, breng dan de volgende pleister aan die van toepassing is op uw vrijlating:

    Voor een volledige lijst van BroadWorks-patches die de vereiste vormen voor de implementatie van Webex voor Cisco BroadWorks, Zie BroadWorks-softwarevereisten in de sectie Referentie.

  2. Wijzigen in de Maintenance/ContainerOptions Context.

  3. Schakel de parameter voor inrichtings-URL in:

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

Haal de inrichtings-URL(s) op bij Partner Hub

Raadpleeg de Cisco BroadWorks Application Server Command Line Interface Administration Guide voor details (Interface > Messaging and Service > Integrated IM&P) van de AS-commando's.

  1. Meld je aan bij Partner Hub en ga naar Customers > Onboarding templates.

  2. Klik op View Templates.

  3. Selecteer de sjabloon die u gebruikt om de abonnees van deze onderneming/groep in Webex in te stellen.

    De sjabloondetails worden weergegeven in een deelvenster met flyout rechts. Als u nog geen sjabloon hebt gemaakt, moet u dit doen voordat u de inrichtings-URL kunt krijgen.

  4. Kopieer de URL Provisioning Adapter.

Herhaal dit voor andere sjablonen als u er meer dan één hebt.

(Optie) Configureer systeembrede provisioningsparameters op de toepassingsserver

Mogelijk wilt u geen systeembrede provisioning en servicedomein instellen wanneer u UC-One SaaS gebruikt. Zie Beslissingspunten in het gedeelte Voorbereiden van uw omgeving.

  1. Meld u aan bij de toepassingsserver en configureer de chatinterface.

    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. Activeer de geïntegreerde IMP-interface:

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

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

U moet de volledige naam invoeren voor de provisioningURL parameter in, zoals deze werd gegeven in Control Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in het tabblad /etc/hosts bestand op het AS.

(Optie) Configureer Per-Enterprise Provisioningsparameters op de toepassingsserver

  1. Open in BroadWorks UI de onderneming die u wilt configureren en ga naar Services > Integrated IM&P.

  2. Selecteer Use service domain en voer een dummy waarde in (Webex negeert deze parameter. U kunt example.com).

  3. Selecteer Gebruik Messaging Server.

  4. Plak in het veld URL de provisioning-URL die je uit je template hebt gekopieerd in Partner Hub.

    U moet de volledige naam invoeren voor de provisioningURL -parameter, zoals deze is opgegeven in Partner Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in het tabblad /etc/hosts bestand op het AS.

  5. Voer in het veld Username een naam in voor de beheerder van de provisioning. Dit moet overeenkomen met de waarde in de sjabloon in Partner hub.

  6. Geef een wachtwoord op voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner hub.

  7. Selecteer voor Default User Identity for IM&P ID Primary.

  8. Klik op Toepassen.

  9. Herhaal dit voor andere ondernemingen die u wilt configureren voor flow through provisioning.

Gegevens voorziening gebruiker

Voor informatie over de gebruikersgegevens die tijdens de provisioning tussen BroadWorks en Webex worden uitgewisseld, zie Gebruikersvoorziening serviceprovider.

Pre-provisioning check API

De pre-provisioning check API helpt partners en verkoopteams potentiële fouten of conflicten te identificeren alvorens een klant of abonnee (gebruiker) voor een pakket te voorzien. Alleen gebruikers of integraties die zijn geautoriseerd door een gebruiker met de volledige beheerdersrol van de partner, hebben toegang tot deze API.

De API voert verschillende validatiecontroles uit, zoals:

  • Of de abonnee al is toegewezen aan een andere klant of partner.

  • Als het e-mailadres al in gebruik is door een andere abonnee.

  • Conflicten tussen de gevraagde voorzieningsparameters en bestaande Webex-records.

Dit helpt u problemen vroeg op te vangen en op te lossen, zodat de voorziening soepel verloopt zonder onverwachte fouten.

Voor meer informatie over de voorcontrole van de provisioning van klanten en de voorcontrole van de abonnementsprovisioning, zie ontwikkelaar.webex.comportaal.

Partner SSO configureren met OpenID Connect (OIDC) (aanbevolen)

Partnerbeheerders kunnen OIDC SSO configureren voor nieuw gecreëerde klantorganisaties. Ze kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren en op hun eigen werknemers.

De volgende SSO OIDC-stappen van de partner zijn alleen van toepassing op nieuw gecreëerde klantenorganisaties. Als partnerbeheerders proberen om het standaard authenticatietype te wijzigen naar partner SSO OIDC in een bestaand sjabloon, zijn de wijzigingen niet van toepassing op de klantorganisaties die al zijn ingeschakeld met behulp van het sjabloon.

  1. Open een serviceaanvraag bij Cisco TAC met de details van de OpenID Connect IDP.

    De volgende tabel toont de verplichte en optionele POP-attributen. TAC stelt de IDP in op de CI en geeft u de redirect-URI die op de IDP moet worden geconfigureerd.

    Kenmerk

    Vereist

    Beschrijving

    POP-naam

    Ja

    Unieke, hoofdletterongevoelige naam. Het kan letters, cijfers, koppeltekens, underscores, tildes en stippen omvatten. Max. lengte: 128 tekens.

    OAuth client ID

    Ja

    Gebruikt om OIDC IdP-authenticatie aan te vragen.

    Geheim van de cliënt

    Ja

    Gebruikt om OIDC IdP-authenticatie aan te vragen.

    Lijst van toepassingsgebieden

    Ja

    Gebruikt om OIDC IdP-authenticatie aan te vragen. Door spaties gescheiden lijst van scopes (bijvoorbeeld openid e-mailprofiel) moet openid en e-mail bevatten.

    Autorisatieeindpunt

    Ja als discoveryEndpoint niet wordt verstrekt

    URL van het OAuth 2.0 autorisatieeindpunt van de IdP.

    tokenEindpunt

    Ja als discoveryEndpoint niet wordt verstrekt

    URL van het OAuth 2.0 token eindpunt van de IdP.

    Eindpunt van ontdekking

    Nee

    URL van het IdP-eindpunt voor de ontdekking van OpenID-eindpunten.

    gebruikerInfoEndpoint

    Nee

    URL van het UserInfo-eindpunt van IdP.

    Sleutel ingesteld eindpunt

    Nee

    URL van het JSON-websleutel ingestelde eindpunt van de IdP.

    Naast de bovenstaande IDP-attributen moet u een partner organisatie-ID opgeven in het TAC-verzoek.

  2. Configureer de redirect-URI op de OpenID connect IDP.

  3. Configureer een inwerksjabloon.

    Voor de Authentication Mode instelling, selecteer Partner authentication with OpenID Connect

    Voor OpenID Connect IDP Entity ID, voer de IDP-naam in die tijdens de IDP-instelling wordt verstrekt.

    Add a new template screen displaying options for the Authentication Mode setting, with the option selected for Partner Authentication With OpenID Connect

Zodra u de configuratie hebt voltooid, kunt u handmatig controleren of de Partner IdP Entity ID correct is ingesteld.

  1. Betrek een klant die de template gebruikt en maak een nieuwe gebruiker aan in de klantorganisatie.

  2. Dat de gebruiker zich kan aanmelden met behulp van de SSO-authenticatiestroom.

Partner SSO configureren met SAML

Partnerbeheerders kunnen SAML SSO configureren voor nieuw gecreëerde klantorganisaties. Ze kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren en op hun eigen werknemers.

De volgende SSO-stappen van de partner zijn alleen van toepassing op nieuw gecreëerde klantenorganisaties. Als partnerbeheerders proberen Partner SSO toe te voegen aan een bestaande klantenorganisatie, behoudt het systeem de bestaande authenticatiemethode om te voorkomen dat bestaande gebruikers toegang verliezen.

1

Controleer of de derde-partij Identity Provider (IdP) voldoet aan de vereisten vermeld in de Vereisten voor identiteitsaanbiederssectie van Single Sign-On-integratie in Control Hub.

2

Open een serviceaanvraag bij Cisco TAC. TAC moet een vertrouwensrelatie tot stand brengen tussen de derde partij IdP en de Cisco Common Identity service.

Als uw IdP het inschakelen van de passEmailInRequest functie, zorg ervoor dat u deze vereiste opneemt in de serviceaanvraag. Controleer met uw IdP als u niet zeker weet of deze functie vereist is.

.

3

Upload het CI-metadata-bestand dat TAC heeft verstrekt naar uw IdP.

4

Configureer een inwerksjabloon:

  • Voor de Authentication Mode instelling, selecteer Partner Authentication.

  • Voer de IDP Entity ID. U kunt de EntityID vinden uit de SAML metadata XML van de derde partij IdP.

Voeg een nieuwe sjabloonschermopties toe; bevat standaard opties voor authenticatie: Broadworks-authenticatie, Webex-authenticatie en partner-authenticatie

Zodra u de configuratie hebt voltooid, kunt u handmatig controleren of de Partner IdP Entity ID correct is ingesteld.

  1. Betrek een klant die de template gebruikt en maak een nieuwe gebruiker aan in de klantorganisatie.

  2. Controleer of de gebruiker zich kan aanmelden.

    Aanmelding van de gebruiker moet worden doorgestuurd naar de aanmeldingspagina van de partner IdP, en de gebruiker moet met succes kunnen aanmelden met geldige inloggegevens.

Activeer BroadWorks IdP in Control Hub

Nadat u de configuratie hebt voltooid en hebt geverifieerd dat de partner IdP correct is ingesteld, kunt u deze activeren in Control Hub.

Voordat u begint

Configureren en verifiërende partner IdP voor single sign-on integratie.

1

Aanmelden bij Besturingshub.

2

Ga naar Security > Authentication > Activate SSO.

3

Selecteren Broadworks en klik op Activate.

De IdP verschijnt in de Identity provider Virtuele vergaderingen.

Correlatie-id voor gesprek inschakelen

Als u Webex voor Cisco BroadWorks wilt uitvoeren, is het vereist dat u de gespreks correlatie-id inschakelen. Deze instelling is vereist voor veel belfuncties, waaronder Gespreksopname, Groepsgesprek opnemen, Leidinggevende en Leidinggevende assistent.

Gebruik de CLI om de functie in te schakelen op alle AS- en XSP|ADP-interfaces.

  • Voer de volgende commando's uit op AS-interfaces. Hierdoor kan de AS de X-BroadWorks-Correlation-Info SIP-koptekst:

    AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true

    AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true

  • Het bericht enableCallCorrelationID parameter geassocieerd met de Xsi-Actions-toepassing wordt gebruikt om de opname van call-correlatieinformatie in Xsi-Actions-logboeken te controleren. Het wordt aanbevolen om enableCallCorrelationID ingeschakeld met het volgende commando op XSP|ADP-interfaces:

    XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true

Voor meer informatie over de Call Correlation Identifier, zie Cisco BroadWorks Call Correlation Identifier Functiebeschrijving.

Synchroniseren met Directory

Directorysynchronisatie zorgt ervoor dat webex voor Cisco BroadWorks-gebruikers de Webex-directory kan gebruiken om elke belentiteit vanaf de BroadWorks-server te bellen. Als deze functie is ingeschakeld, wordt de volledige adressenlijst voor bellen vanaf de BroadWorks-server gesynchroniseerd met de Webex-map. Gebruikers kunnen de directory vanuit de Webex-app openen en een oproep plaatsen naar elke belentiteit vanaf de BroadWorks-server.

Om Directory Sync aan te zetten, ga naar Directory Sync in Webex voor Cisco BroadWorks.

Webex voor Cisco BroadWorks flowthrough provisioning voegt berichtengebruikers en bijbehorende oproepinformatie van de BroadWorks-server toe aan het Webex-platform. Telefoonlijsten, niet-berichtengebruikers en niet-gebruikersentiteiten zijn echter niet inbegrepen (bijvoorbeeld een telefoon-, faxapparaat- of jachtgroepnummer). Als u directorysynchronisatie inwerkt, worden alle belbedrijven aan het Webex-platform toegevoegd.

Uniforme gespreksgeschiedenis

Wanneer Unified Call History is ingeschakeld, synchroniseren BroadWorks-oproepgebeurtenissen met de Webex-cloud en worden ze onderdeel van de Webex Unified Call and Meetings History die wordt weergegeven op de Webex-app. Gebruikers kunnen hun eigen gedetailleerde gespreksgeschiedenis en vergaderingsgeschiedenis bekijken vanuit de Webex-app.

Unified Call History kan cluster-per-cluster worden ingeschakeld door beheerders op partnerniveau in Partner hub. Wanneer deze functie is ingeschakeld, synchroniseert de BroadWorks-implementatie de volgende gespreksgebeurtenissen met de Webex-cloud:

  • Gespreksgeschiedenisgebeurtenissen: deze gebeurtenissen worden gebruikt om een gedetailleerde Unified Call History te bouwen

  • Hook Status-gebeurtenissen: Unified Call History bevat hook-statusoptimalisaties die de hoeveelheid netwerkbandbreedte voor updates van Telephony Presence verlagen

Vereisten voor Unified Call History

Voordat u Unified Call History configureert, moet u ervoor zorgen dat u uw systeem hebt gepatcht. Deze functie is afhankelijk van de volgende BroadWorks patches die worden geïnstalleerd. Als uw systeem op een Release Independent (RI) versie staat, zijn de vereisten al opgenomen.

Voor R22:

Voor R23:

Voor R24:

Voor de volledige lijst met BroadWorks-patches die u moet installeren als voorwaarde voor het uitvoeren van Webex voor Cisco BroadWorks, zie Vereisten voor BroadWorks-software.

Het configuratiebestand voor de client () naast het patchen van uw systeemconfig-wxt.xml) moet de volgende tag hebben ingesteld: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>

Om Hunt Group, Call Center en andere redirection-informatie in Unified Call History te hebben, moeten de volgende BroadWorks-patches geïnstalleerd en actief zijn:

Voor R23:

  • AP.as.23.0.1075.ap383346

  • AP.as.23.0.1075.ap383994

Voor R24:

  • AP.as.24.0.944.ap383346

  • AP.as.24.0.944.ap383994

Om Executive-Assistant-informatie in Unified Call History te hebben, moeten de volgende BroadWorks-patches geïnstalleerd en actief zijn:

Voor R24:

  • AP.as.24.0.944.ap380052

  • AP.as.24.0.944.ap384239

  • ADP draait Xsi-Events-24_2022.06 of hoger

Naast de BroadWorks-patches moet ook Directory Sync worden ingeschakeld voor de Executive-Assistant Unified Call History.

Wanneer u Call History of DND Sync inschakelt, stuurt Webex CTI-abonnementsvernieuwingsverzoeken voor alle gebruikers onder de cluster. Afhankelijk van het aantal gebruikers kan dit tot enkele uren duren. Het wordt aanbevolen om geen enkele onderhoudsactiviteit van BroadWorks uit te voeren tijdens hetzelfde onderhoudsvenster.

Gespreksgeschiedenis inschakelen (nieuw cluster)

Zie de stappen voor het toevoegen van een cluster om Call History op een nieuw cluster in te schakelen Uw partnerorganisatie configureren in Partner Hub.

Gespreksgeschiedenis inschakelen (bestaand cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een bestaande cluster, volgt u de volgende stappen:

  1. Meld u aan bij Partner Hub op admin.webex.com.

  2. Ga naar Services.

  3. Klik op View Broadworks Calling en selecteer de juiste BroadWorks cluster.

  4. Controleer of de clusterverbinding goed is. Het rechter paneel moet een groen vinkje met Connection established.

    Als dit niet verschijnt, onder Check Connnections (Optional)Voer BroadWorks User Id en BroadWorks Password en klik op Check om te controleren of de verbinding goed is.

  5. Controleer de Enable call history in.

  6. Klik op Save.

Functieinteracties

De volgende functieinteracties bestaan voor Unified Call History:

  • Unified Call History wordt niet ondersteund voor gebruikers die zijn geconfigureerd in BroadWorks met Route Lists of Direct Routes. Wanneer deze situatie bestaat, worden gebeurtenissen met betrekking tot oproepgeschiedenis en haakstatus niet naar de Webex-app verzonden.

  • Unified Call History wordt niet ondersteund met extension dialing. Oproepen die worden geplaatst met bellen via een extensie, worden mogelijk niet correct weergegeven in de Gespreksgeschiedenis.

Gespreksgeschiedenis weergeven in de Webex-app

Eindgebruikers kunnen hun Unified Call History openen en weergeven vanuit de Webex-app. Voor meer informatie raadpleegt u: Webex | Gesprek- en vergadergeschiedenis bekijken.

Unified Call History uitschakelen

Zodra u Unified Call History inschakelt op een cluster, kunt u de functie niet alleen uitschakelen. Als u de functie moet uitschakelen, neem dan contact op met Cisco Technical Assistance Center (TAC).

Visuele spamindicatie

De Webex-app ondersteunt een visuele indicatie van spamoproepen in de gesprekstoast wanneer de oproep wordt gepresenteerd aan de callee en in de Unified Call History-records wanneer BroadWorks wordt bijgewerkt om de Caller ID-validatie uit te voeren via het STIR/SHAKEN-kader. Om deze functie te hebben:

  1. Schakel Unified Call History in zoals beschreven in de vorige sectie.
  2. De volgende patches moeten geïnstalleerd en actief zijn:
    • AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
    • of minimaal AS-25_Rel_2022.12
  3. De functie moet worden geactiveerd via de AS CLI:
    • AS_CLI/Systeem/ActivatableFeature> activeren 104112
    • AS_CLI/System/StirShaken> enableVerification true instellen
  4. BroadWorks moet worden geconfigureerd om STIR-SHAKEN-ondertekening, tagging en verificatie uit te voeren zoals beschreven in Cisco BroadWorks STIR-SHAKEN ondertekenen, tagging en verificatie

Wanneer BroadWorks goed is geconfigureerd, zal een nieuwe header X-Cisco-CallerId-Disposition worden toegevoegd in INVITE-verzoeken die naar Cisco-clients worden verzonden en zal een nieuwe field callerIdDisposition worden toegevoegd aan de bestaande Call History Events die via de CTI-interface naar Webex Cloud worden verzonden. Webex-apparaten gebruiken deze informatie om een visuele spamindicatie te geven in de gesprekspresentatie en de Unified Call History van de callee.

Persoonlijke assistent-statussynchronisatie

De functie Personal Assistant (PA) Status Sync synchroniseert de aanwezigheidsstatus van de persoonlijke assistent tussen de BroadWorks Calling-apparaten en de Webex-app.

De PA-service biedt de gebruiker de mogelijkheid om de bellers te informeren waarom de gebelde partij niet beschikbaar is, optioneel met informatie over wanneer de gebelde partij terugkeert en of er een medewerker is om de oproep af te handelen. Met de PA-functie kunnen gebruikers in de Webex-apps de aanwezigheid van de gebruiker zien, samen met de PA-status en de ingestelde duur.

Voorwaarden

Zorg ervoor dat de volgende patches worden aangebracht op de AS en XSP|ADP. Pas alleen de patches toe voor uw BroadWorks-versie.

Pleister voor RI en afgifte 24:

  • AP.as.24.0.944.ap385558

XSI Event Package for Personal Assistant Status Synchronization functie introduceert een nieuw PersonalAssistantSync event package waarmee XSI clients kunnen synchroniseren met Cisco BroadWorks Personal Assistant aanwezigheidswijzigingen. Voor meer informatie, zie XSI Event Package voor Personal Assistant Status Synchronization Feature.

Naast het patchen van uw systeem, moet het client config bestand (config-wxt.xml) de volgende tag ingesteld hebben: <personal-assistant enabled="%PERSONAL_ASSISTANT_ENABLED_WXT%"/>

Persoonlijke assistent-statussynchronisatie inschakelen (nieuw instrumentenbord)

Om Personal Assistant Status Sync in te schakelen op een nieuw cluster, zie je de stappen om een cluster toe te voegen in Uw partnerorganisatie configureren in Partner Hub.

Als er meer dan 50 klanten in een BroadWorks-cluster zijn, worden bewerkingen zoals het bijwerken van XSI-acties, XSI-evenementen, DAS-URL, XSP|ADP-URL, Personal Assistant of DND-synchronisatie niet ondersteund. In dergelijke gevallen is het raadzaam om contact op te nemen met een Cisco TAC support engineer voor hulp om dit aan te zetten.

Persoonlijke assistent-statussynchronisatie inschakelen (bestaand instrumentenbord)

  1. Meld u aan bij Partner Hub met uw partner admin credentials op https://admin.webex.com.

  2. Klik op Services.

  3. Klik op View Broadworks Calling en selecteer de juiste BroadWorks cluster.

  4. Voer uw naam en e-mailadres in onder CTI Interface Schakel de knop Personal Assistant Status Sync in.
  5. Voer uw BroadWorks gebruikers-ID in en klik op Enable.

    Het systeem valideert dat de BroadWorks-cluster de juiste patches heeft om PA Sync te ondersteunen. Als de validatie mislukt, wordt de Save knop is uitgeschakeld.

  6. Als de validatie geslaagd is, klik dan op Save.

    Het inschakelen van PA Status Sync is een one-way toggle. Zodra de functie is ingeschakeld, kunt u het niet op uw eigen.

Webex Partner Hub pagina met CTI-interface en authenticatie service opties

Persoonlijke assistent-statussynchronisatie uitschakelen

Zodra u de PA Sync-status inschakelt op een van de BroadWorks-clusters, kunt u deze functie niet op uw eigen. Als u moet uitschakelen, neem dan contact op met Cisco Technical Assistance Center (TAC).

Identificatie van de beller en omleiding van de oproep

Identificatie beller

Wanneer de Webex-app een oproep ontvangt, zal ze proberen te identificeren wie de beller is en deze informatie weergeven in de inkomende oproepmelding, in het oproepvenster en nadat de oproep is voltooid, in de oproepgeschiedenis en voicemail.

De Webex-app zal proberen om de beller-ID te vinden door het inkomende telefoonnummer te koppelen aan de telefoonnummers van contacten in verschillende bronnen. De Webex App zal in deze volgorde gebruik maken van de volgende bronnen. Als het eenmaal in één bron is gevonden, zal het niet proberen om ergens anders te zoeken.

Als het meerdere instanties van een nummer in één bron vindt, zal het niet proberen om er een te kiezen, in dit geval zal het geen beller-ID tonen.

  • Webex Common Identity (CI) die uw organisatiegebruikers bevat.

  • Persoonlijke en organisatorische contacten. Persoonlijke contacten zijn zichtbaar onder het tabblad Contacten.

  • Lokaal adresboek. In Windows - Outlook-applicatie, in Mac - Mac-contacten, in iOS - iPhone-contacten, in Android - Android-contacten.

Als er geen overeenkomst met het binnenkomende telefoonnummer wordt gevonden, gebruikt de app de displaynaam in de SIP FROM-header indien beschikbaar. Anders zal het de gebruikersnaam deel van de SIP URI uit de SIP From header als laatste redmiddel gebruiken.

Voor remote call control (d.w.z. Deskphone Control Mode) wordt XSI-informatie gebruikt, waarbij BWKS ID of extensie wordt gebruikt, geëxtraheerd uit remote-party-info in de XSI-gebeurtenis. Als remote-party-info niet beschikbaar is, wordt P-Asserted Identity (PAI) (indien geconfigureerd) gebruikt.

Oproep omleiding

In het geval dat een oproep werd doorgestuurd of doorgestuurd, zal de app proberen te tonen wie de beller is en hoe hij werd doorgestuurd in de oproepmelding en oproepgeschiedenis.

  • Oproep doorgestuurd: Toont het nummer dat de oproep heeft doorgestuurd.

  • Hunt-groep: Toont de naam van de jachtgroep die de oproep heeft doorgestuurd.

  • Wachtrij callcenter: Toont de naam van de wachtrij die de oproep heeft doorgestuurd.

  • Uitvoerend assistent: Toont de naam van de executive waarvoor het gesprek binnenkomt.

Uitzonderingen:

  • Voor interne oproepen in de wachtrij, wanneer een agent een interne partij terugbelt, zal de externe partij niet de naam van de wachtrij zien, maar de naam van de agent die hen belt.

Oproep elders beantwoord:

Voor Hunt Groups of Call Queues die zijn ingesteld met gelijktijdige routering, zullen agenten een oproep die elders in de gespreksgeschiedenis wordt beantwoord zien als een andere agent de oproep opneemt. Voor Hunt Groups of Call Queues met sequentiële routering, of in een overflow, worden oproepen weergegeven als gemiste oproep in de gespreksgeschiedenis indien beantwoord door een andere agent.

Selecteer Beller-ID

Overzicht

Met de functie "Select Caller ID" kunnen gebruikers overschakelen tussen verschillende Calling Line ID's voor externe oproepen. Als de beheerder dit aanstaat, kunnen gebruikers kiezen uit de volgende opties voor hun Calling Line Identity:

  • Gebruikersnummer ("Gebruik telefoonnummer van gebruiker voor Callline Identity")

  • Configureerbare CLID ("Gebruik configureerbare CLID voor Calling Line Identity")

  • CLID van de groep ("Telefoonnummer van de groep/afdeling gebruiken voor Callline Identity")

Functies

Gebruikers hebben twee methoden om hun Caller ID te wijzigen zoals voorzien door de beheerder:

  1. Feature Access Codes (FAC): Specifieke codes voor elk van de drie opties van de beller-ID.

  2. Webex App Interface: Een gebruiksvriendelijke weergave binnen de Webex desktop- en mobiele apps die de beschikbare Caller ID-opties weergeven die door de beheerder zijn ingeschakeld, zodat gebruikers hun favoriete ID kunnen selecteren.

Select Caller ID

Aanvullende functies

  • De Webex-apps zullen ook opties bevatten voor Call Center wachtrijen DNIS.

  • Gebruikers van mobiele apps hebben Dual Persona-opties beschikbaar voor gebruikers van Mobility.

Randvoorwaarden

Op de BroadWorks-server moet aan de volgende voorwaarden worden voldaan om de gebruiker in staat te stellen zijn keuze van extern CLID-beleid te controleren:

  • Om de systeemvlag 'EnableUserSelectionOfExternalCLIDPolicy' in te schakelen

    Voer het CLI-commando uit:

    AS_CLI/SubscriberMgmt/Policy/CallProcessing/CallingLineId> set defaultEnableUserSelectionOfCLIDPolicy true.

  • Om 'EnableUserConfigurableCLIDModification' in te schakelen

    Voer het CLI-commando uit:

    AS_CLI/SubscriberMgmt/Policy/CallProcessing/CallingLineId> set defaultEnableUserConfigurableCLIDModification true.

    Dit maakt het mogelijk Allow User Selection of External CLID Policy en Allow User Configurable CLID Modification.

  • Gebruikersniveau Call Processing Policy Calling Line ID scope is ingesteld op "User Calling Line Id Policy" voor deze gebruiker.

  • De vlag 'Gebruikersniveau Call Processing Policies' (Gebruikersselectie van extern CLID-beleid toestaan) is ingeschakeld voor de gebruiker.

  • Als er geen nummer is gedefinieerd voor de opties "Gebruik configureerbare CLID voor Calling Line Identity" of "Gebruik telefoonnummer groep/afdeling voor Calling Line Identity", hebben de FAC's of de app geen effect. Deze instelling moet door de beheerder worden geconfigureerd voordat de gebruiker wordt geselecteerd.

Zie voor meer informatie, Gebruikersselectie van optie externe oproeplijn-IDgids met beschrijving van de functie.

Sjabloon: Navigatie BroadWorks

Deze functie vereist twee specifieke BroadWorks-patches om correct te functioneren:

Zie hoofdstuk 8 Onafhankelijk vrijgeven en informatie over servicepatches.

Webex-app-configuratie

Deze tag moet worden ingeschakeld in de desktop-, tablet- en mobiele configuraties:

<config>
<services>
<calls>
<caller-id>
<outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%">

Gedeelde lijn uiterlijk

Met de weergave van gedeelde lijn kunnen lijnen van andere gebruikers worden ingesteld als gedeelde lijnen op het apparaat voor eindgebruikers. De gedeelde lijnconfiguratie voor de Webex App is vergelijkbaar met de gedeelde lijnconfiguratie voor bureautelefoons. Met deze specifieke functie kunt u gedeelde regelverschijningen toewijzen aan de Webex-app van de eindgebruiker.

Deze functie biedt de gebruikers de mogelijkheid om oproepen op de extensie van andere gebruikers direct vanuit de Webex-app af te handelen.

  • U kunt de weergave van gedeelde regels alleen configureren voor de desktopversie van een Webex-app.

  • U kunt maximaal 10 lijnen, inclusief de primaire lijn, toevoegen aan Webex App.

  • U kunt een workspace-lijn niet toewijzen als gedeelde lijn.

  • Een gebruiker kan niet worden voorzien van een Executive-Assistant-service op hetzelfde moment als het hebben van gedeelde lijnen.

  • De primaire lijnpoort van een gebruiker mag niet worden gewijzigd naar een gedeelde lijn.

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

Pleister 1: Eigenschapvlag in apparatenlijst ter ondersteuning van gedeelde lijnen voor Webex-client

R23 zonder ADP:

  • AP.as.23.0.1075.ap384179

  • AP.xsp.23.0.1075.ap384179

R23 met ADP:

  • AP.as.23.0.1075.ap384179

  • Xsi-acties-23_2022.10

R24:

  • AS: AP.as.24.0.944.ap384179

  • Xsi-acties-24_2022.10

R25:

  • AS: RI vrijgave Rel_2022.10_1.310

  • Xsi-acties-25_2022.10

Pleister 2: Patches voor het verhogen van de poort rekenen op apparaatprofieltypes. Voorbeeld: Voor de desktop client: Systeem>Type identiteit/apparaatprofiel wijzigen> Bedrijfscommunicator - PC: Profiel, Standaardopties, Aantal poorten:

  • ALS 'Unlimited' is ingeschakeld, is geen wijziging vereist
  • ALS 'Limited To' <10 is, wijzig dan de waarde = 10 en sla op om alle beschikbare lijnen te gebruiken
  • RI vrijgave Rel_2022.10_1.310

Zie hoofdstuk 6.1 voor meer informatie over de configuratie van de klant.44 'Primair Profiel' uit de Webex voor Cisco BroadWorks configuratiegids.

Niet storen-synchronisatie

Do Not Disturb (DND) Sync brengt de DND-instellingen uit tussen Webex en BroadWorks door de DND-status tussen de twee platforms te synchroniseren. Als een gebruiker bijvoorbeeld DND inschakelt vanuit de Webex-app, synchroniseert die status naar BroadWorks-oproepapparaten. Als gevolg daarvan belt de BroadWorks-geregistreerde bureautelefoon van de gebruiker niet wanneer iemand probeert het te bellen. Als een gebruiker DND instelt vanaf een bureautelefoon, wordt de status gesynchroniseerd met de Webex-app. Zonder deze functie worden DND-updates van het ene platform niet herkend door het andere platform.

DND Sync wordt toegepast op het clusterniveau van BroadWorks en kan worden ingeschakeld in Partner Hub door een partnerbeheerder.

Als er veel klanten (>50) in de BroadWorks-cluster zijn, wordt DND-synchronisatie niet ondersteund. In dergelijke gevallen is het raadzaam om contact op te nemen met een Cisco TAC support engineer voor hulp.

Voorwaarden

Zorg ervoor dat de volgende patches worden aangebracht op de AS en XSP|ADP. Pas alleen de patches toe voor uw BroadWorks-versie.

Voor vrijgave 23:

<gefragmenteerd>

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

Voor vrijgave 24:

<gefragmenteerd>

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

Nadat u de patches hebt aangebracht, activeert u de functie 25433 op de AS:

AS_CLI/System/ActivatableFeature> activate 25433

Als er veel klanten (>50) in de BroadWorks-cluster zijn, worden bewerkingen zoals het bijwerken van XSI-acties, XSI-evenementen, DAS URL, XSP|ADP URL of DND-synchronisatie niet ondersteund. In dergelijke gevallen is het raadzaam om contact op te nemen met een Cisco TAC support engineer voor hulp.

Configureer Device Feature Key Synchronization op BroadWorks. Zorg ervoor dat de telefoon SIP SUBSCRIBE/NOTIFY ondersteunt voor het evenementenpakket “as-feature-event”. Voor meer informatie, zie Cisco BroadWorks-apparaatfunctie sleutelsynchronisatie.

DND-synchronisatie inschakelen (Bestaand cluster)

  1. Aanmelden bij Partner Hub

  2. Klik op Services.

  3. Klik op View Broadworks Calling en selecteer de juiste BroadWorks cluster.

  4. Schakel de Do not disturb (DND) sync omschakelen.

  5. Voer uw BroadWorks gebruikers-ID in en klik op Enable.

    Het systeem valideert dat de BroadWorks cluster de juiste patches heeft om DND Sync te ondersteunen. Als de validatie mislukt, wordt de Save knop wordt uitgeschakeld.

  6. Als de validatie geslaagd is, klik dan op Save.

  • Zodra DND Sync is ingeschakeld, vernieuwt Webex alle gebruikersabonnementen om het Niet storen evenementenpakket op te nemen. Afhankelijk van het aantal gebruikers kan dit proces enkele uren duren.

  • Het inschakelen van DND Sync is een one-way toggle. Zodra de functie is ingeschakeld, kunt u het niet op uw eigen.

DND-synchronisatie inschakelen (nieuw instrumentenbord)

U kunt de functie ook inschakelen tijdens het aanmaken van een cluster. Voor meer informatie, zie “Configure Your BroadWorks Clusters” in Uw partnerorganisatie configureren in Partner Hub.

Stille uren

In Webex voor BroadWorks-implementaties maakt de functie 'Quiet Hours' gebruik van de functie 'Do Not Disturb (DND) Sync' om ervoor te zorgen dat de instellingen voor quiet hours worden gesynchroniseerd over alle apparaten. Om stille uren goed te synchroniseren op desktop- en mobiele apparaten, moet u ervoor zorgen dat 'DND Sync' is ingeschakeld op het account van de gebruiker.

DND-synchronisatie uitschakelen

U kunt DND-synchronisatie niet alleen uitschakelen. Om de DND-functie uit te schakelen, maakt u een TAC-case aan met de titel "Disable Do Not Disturb Sync" en geeft u partnerId en BroadWorks clusternaam.

Gebruiks cases

A diagram of Setting and Clearing DND in Relation to Work Status. Where, DND is not set, DND is set from Webex App status, or DND set from Desk phone or user portal.
DND instellen en opruimen met betrekking tot werkstatus

Gespreksopname

Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopnamen.

Table 5. Recording Modes

Opnamemodi

Beschrijving

Besturingselementen/indicatoren die op de Webex-app worden weergegeven

Altijd

Opname wordt automatisch gestart zodra de oproep tot stand is gekomen. De gebruiker is niet in staat om te beginnen met of stoppen met opnemen.

  • Visuele indicator die bezig is met opnemen

Altijd met onderbreken/hervatten

Opname wordt automatisch gestart zodra de oproep tot stand is gekomen. De gebruiker kan de opname pauzeren en hervatten.

  • Visuele indicator die bezig is met opnemen

  • Pause Recording knop

  • Resume Recording knop

Ondemand

De opname wordt automatisch gestart wanneer de oproep wordt ingesteld, maar de opname wordt verwijderd tenzij de gebruiker op Start Recording.

Als de gebruiker begint met opnemen, wordt de volledige opname van de oproepinstelling behouden. Na het starten van de opname kan de gebruiker de opname ook pauzeren en hervatten

  • Start Recording knop

  • Pause Recording knop

  • Resume Recording knop

OnDemand met door gebruiker geïnitieerde start

De opname wordt niet gestart tenzij de gebruiker de Start Recording optie op de Webex App. De gebruiker heeft de mogelijkheid om de opname meerdere keren te starten en te stoppen tijdens een gesprek.

  • Start Recording knop

  • Stop Recording knop

  • Pause Recording knop

Vereisten

Om deze functie op Webex te implementeren voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren. Als uw systeem op een Release Independent (RI) versie staat, zijn de vereisten al opgenomen.

De Call Correlation Identifier moet ingeschakeld zijn. Voor meer informatie, zie Aanroepcorrelatieidentifier inschakelen.

De volgende configuratietag moet zijn ingeschakeld om deze functie te kunnen gebruiken: %ENABLE_CALL_RECORDING_WXT%.

Deze functie vereist een integratie met een gespreksopnameplatform van een derde partij.

Om de oproepopname op BroadWorks te configureren, gaat u naar de Cisco BroadWorks Call Recording Interface Guide.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van de opnamefunctie, zie Webex | Neem uw gesprekken op.

Als gebruikers of beheerders een opname willen afspelen, moeten ze naar het gespreksopnameplatform van een derde partij gaan.

Voicemail inschakelen voor Microsoft Teams-integratie

U kunt voicemail voor Microsoft Teams-gebruikers inschakelen in de Webex for BroadWorks-oplossing. Deze integratie stelt gebruikers in staat om hun voicemails rechtstreeks via Microsoft Teams op te halen, wat de algemene gebruikerservaring verbetert.

Stappen om voicemail in te schakelen

Om Voicemail voor BroadWorks in te schakelen, moet u op organisatieniveau de schakelaar broadworks-voicemail-enabled-spark-541886: true inschakelen.

Om deze functie in te schakelen, neemt u contact op met Cisco Technical Assistance Center (TAC).

Gebruikerservaring

Zodra de integratie is opgezet, kunnen gebruikers:

  • Voicemails rechtstreeks ophalen in de Microsoft Teams-applicatie.
  • Ontvang meldingen voor nieuwe voicemails.
  • Voicemail-instellingen beheren vanaf de Webex-interface.

Vereisten

Om het ophalen van voicemail in de integratie van Microsoft Teams met het Webex for BroadWorks-aanbod te ondersteunen, zijn aanvullende netwerkwijzigingen vereist. BroadWorks-partners moeten Cross-Origin Resource Sharing (CORS) inschakelen voor de volgende URL's op hun BroadWorks-platform:

  • https://jabber-integration-a.wbx2.com

  • https://jabber-integration-r.wbx2.com

  • https://jabber-integration-k.wbx2.com

  • https://msteams-calling.webex.com

Zorg ervoor dat de voicemail van BroadWorks is geconfigureerd volgens de instellingen die zijn beschreven in Voicemail afspelen.

Voor meer details over de configuratiestappen, zie hoofdstuk 8.5.1.2van de Configuratiegids voor het BW-applicatieplatform, die versie vereist 2024.05op de ADP.

Groep gesprek parkeren en ophalen

Webex voor Cisco BroadWorks ondersteunt Groep gesprek parkeren en ophalen. Met deze functie kunnen gebruikers binnen een groep gesprekken parkeren, die vervolgens door andere gebruikers in de groep kunnen worden opgehaald. Winkels in een store-instelling kunnen bijvoorbeeld gebruikmaken van de functie om een gesprek te parkeren dat vervolgens kan worden opgehaald door iemand anders van een andere afdeling.

Functiebewerking

Zodra de functie is geconfigureerd

  • Tijdens een gesprek klikt een gebruiker op de Park optie op hun Webex-app om de oproep te parkeren op een extensie die het systeem automatisch selecteert. Het systeem geeft de extensie aan de gebruiker gedurende een periode van 10 seconden.

  • Een andere gebruiker in de groep klikt op de Retrieve call optie op hun Webex-app. De gebruiker voert dan de verlenging van de geparkeerde oproep in om de oproep voort te zetten.

Vereisten

Zorg ervoor dat deze functie werkt:

  • Het configuratiebestand voor de client moet de volgende tags hebben ingesteld:

    <call-park enabled="%ENABLE_CALL_PARK_WXT%"
            timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
  • De Call Correlation Identifier moet ingeschakeld zijn op de AS en XSP|ADP. Voor meer informatie, zie Aanroepcorrelatieidentifier inschakelen.

  • Uw SBC moet worden geconfigureerd om de ' door te gevenx-broadworks-correlation-inSIP-kenmerk van en naar de toepassingsserver.

Configuratie

Voor informatie over het configureren van Group Call Park op BroadWorks, zie “Add Call Park Group” in de Cisco BroadWorks Application Server Group Web Interface Administration Guide – Deel 2. U moet een groep maken en gebruikers aan de groep toevoegen.

Voor informatie over het configureren van de Call Correlation Identifier op BroadWorks, zie Cisco BroadWorks Call Correlation Identifier Functiebeschrijving.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van Group Call Park, zie Webex | Parkeer en haal oproepen op.

gesprek parkeren/geleide gesprek parkeren

Een standaard of een specifiek geparkeerd gesprek wordt niet ondersteund in de gebruikersinterface van de Webex-app, maar gebruikers die zijn ingericht, kunnen de functie wel implementeren met functietoegangscodes:

  • Enter *68 om een oproep te parkeren

  • Enter *88 om een oproep op te halen

Binnenschip

De binnenvaartservice wordt vaak gebruikt in callcenteromgevingen of in andere situaties waar onmiddellijke hulp of interventie nodig kan zijn.

Wanneer een binnenvaartservice is ingeschakeld, kan een aangewezen gebruiker of supervisor een actief gesprek voeren door een specifiek commando te initiëren of door een speciale knop of toetsencombinatie op zijn telefoon of communicatieapparaat te gebruiken. Zodra het inruilverzoek is ingediend, maakt het systeem een verbinding met de lopende oproep, zodat de bevoegde persoon het gesprek kan beluisteren of als actieve deelnemer kan deelnemen aan de oproep.

Binnenvaartservice kan nuttig zijn in verschillende scenario's. In een callcenter kunnen supervisors of trainers vertegenwoordigers van de klantenservice monitoren en coachen door in real-time naar hun gesprekken te luisteren. Indien nodig kunnen ze ingrijpen om advies te geven of het gesprek over te nemen als de vertegenwoordiger moeite heeft. In noodsituaties of kritische gesprekken kan bevoegd personeel snel deelnemen aan lopende gesprekken om hulp te bieden of belangrijke beslissingen te nemen.

Diagram of barge-in process illustrating relationship between agent, customer and supervisor

In de Webex-app voor Barge in krijgen we een melding dat de oproep wordt omgezet in een conferentie. Er staat geen extra informatie in de NOTIFY (call-info of conference-info) wat het type conferentie is, dus we kunnen het op een andere manier behandelen.

Bij een binnenvaart wordt tussen de partijen een drie-weg-oproep tot stand gebracht. De volgende termen worden ingevoegd:

  • Supervisor: Een supervisor is een persoon die toezicht houdt op en leiding geeft aan een team van medewerkers van de klantenservice of vertegenwoordigers van het callcenter. In het kader van een call barge-in heeft een supervisor doorgaans de mogelijkheid om lopende oproepen van klanten op te volgen en in te grijpen. Zij kunnen tools of software voor oproepbewaking gebruiken om gesprekken te beluisteren, agenten te begeleiden en de kwaliteitscontrole te waarborgen. De rol van de supervisor kan bestaan uit het trainen van agenten, het aanpakken van problemen van klanten en het optimaliseren van de prestaties van het team.

  • Klant: Een klant verwijst naar een persoon of entiteit die met een bedrijf of organisatie samenwerkt om producten, diensten of ondersteuning te verkrijgen. In het kader van een call barge-in is een klant iemand die een telefoongesprek voert of ontvangt met een medewerker van de klantenservice. Klanten kunnen tijdens het gesprek hulp, informatie of oplossingen vragen voor hun vragen of problemen. Met de functie ‘call barge-in’ kunnen supervisors of bevoegd personeel deelnemen aan het lopende gesprek tussen de klant en de agent.

  • Agent: Een agent, ook bekend als een klantenservicevertegenwoordiger of callcenteragent, is een persoon die verantwoordelijk is voor het afhandelen van klantinteracties en het verlenen van ondersteuning of bijstand via de telefoon of andere communicatiekanalen. Agenten zijn opgeleid om vragen van klanten aan te pakken, problemen op te lossen, transacties te verwerken en een positieve klantervaring te leveren. In het kader van een call barge-in is een agent de persoon die rechtstreeks met de klant spreekt tijdens het telefoongesprek. De agent kan indien nodig begeleiding of feedback krijgen van de supervisor door middel van een call barge-in.

Voor alle door de klant geïnitieerde verzoeken zoals CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, enz., als <Webex Client> (kies de juiste naam in plaats van de Webex-client, als dit niet gepast is) als een Shared Call Appearance-apparaat wordt aangeboden, moet de configuratie 'Alert all appearances for Click-to-Dial calls' worden ingeschakeld in de Shared Call Appearance-instelling zodat de klant een oproep kan ontvangen, tenzij de locatie expliciet wordt opgegeven door de klant die het verzoek initieert.

SIP call transfer naar Webex Meeting

De SIP call transfer naar Webex Meeting wordt geleverd met twee unieke functies:

  • Nieuwe pushmelding (mobiel)

    Gebruikers met een native call kunnen nu overschakelen naar de Webex App door te tikken op de Nieuwe pushmelding. Wanneer u een native oproepscherm start, verschijnt er een nieuwe pushmelding op het scherm en tikken op de melding brengt u rechtstreeks naar het oproepscherm van de Webex App.

    U ziet de Webex-melding tijdens een mobiel telefoongesprek als u Webex Go gebruikt of uw mobiele netwerkoperator (MNO) heeft oproepsignalering met behulp van Cisco call control voor uw mobiele telefoongesprekken.

  • Oproep naar vergadering verplaatsen

    Als u midden in een gesprek met iemand zit, kunt u dat gesprek verplaatsen naar een vergadering om gebruik te maken van een aantal geavanceerde vergaderfuncties zoals video, delen of whiteboarding. Of nodig andere mensen uit in het gesprek en ga naar een vergadering.

BroadWorks vereisten

  • Activerbare functie 25239

  • R23 met XSP|ADP:

    • AS-pleister AP.as.23.0.1075.ap383064

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

    • Patch AP.platform.23.0.1075.ap383064

  • R23 met ADP:

    • AS-pleister AP.as.23.0.1075.ap383064

    • ADP met Xsi-Actions-23, CommPilot-versie 23 > 2022.05_1.303 en NPS-versie > 2022.08_1.350

  • R24:

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

    • ADP met Xsi-Actions-24, CommPilot-versie 24 > 2022.05_1.303 en NPS-versie > 2022.08_1.350

  • R25:

    • AS RI release Rel_2022.08_1.354

    • ADP met Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 en NPS-versie > 2022.08_1.350

URI-kiezer configureren

Schakel BroadWorks in om een REFER-gegenereerde SIP-UITNODIGING te routeren naar een URI voor een Webex-bijeenkomst. Voorbeeld: sip:<digits>+<meetingID>@<site>.webex.com.

Voordat u begint

  • Deze configuratie maakt routing alleen mogelijk.

  • Voor het invullen van een oproep is een SBC/CUBE met internetaansluiting vereist.

  • Configuratie is vereist op Application Server (AS) en Network Server (NS).

1

Applicatieserver (AS) configureren.

  1. URL-kiezer inschakelen (Verplicht): AS_CLI/System/CallP/DNS> set enableNameLookupForURLDialing true.

  2. Controleer of: enableNameLookupForURLDialing = Y.

Met deze configuratie kan AS SIP URI-oproepen verwerken en INVITEs genereren na REFER.

2

Netwerkserver (NS) configureren.

  1. URL-kiembeleid inschakelen: NS_CLI/Policy/UrlDialing> add DefaultInst true callTypes all.

  2. Voeg URL-kiembeleid toe aan routeringsprofiel: NS_CLI/Policy/Profile> add routing UrlDialing DefaultInst.

    Dit is nodig om 404 Not Found (usrnf) te vermijden.

  3. SIP URI-domein-matching inschakelen: NS_CLI/Policy/UrlDialing> set DefaultInst enableSipURIMatchingRules true .

  4. Routeringsregel toevoegen voor Webex-domein: NS_CLI/Policy/UrlDialing/Rules> add DefaultInst *@<webex-site>.webex.com <RoutingNE_to_Internet_SBC> 1 99.

    Voorbeeld: NS_CLI/Policy/UrlDialing/Rules> add DefaultInst *@digiceloffice-200.webex.com Internet_SBC 1 99

    Dit leidt Webex meeting INVITEs naar de SBC.

  5. Controleer het element van het netwerk voor internetroutering.

    Routering-NE moet wijzen op een SBC/CUBE gericht op het internet. NS mag geen SIP-verkeer rechtstreeks naar het internet sturen.

3

Valideer de routetest: NS_CLI> vtri <calling-number> <meeting-URI>@<webex-site>.webex.com.

U kunt één van de volgende resultaten verwachten:

  • Geen 404 fout

  • RoutingNE geselecteerd

  • Contact teruggestuurd

Best practices, beperkingen en probleemoplossing

Best practices

Om ervoor te zorgen dat de Webex Cloud de vergadering-ID en de bedrijfscontext correct identificeert, moet u de CUBE configureren om de oorspronkelijke Request-URI (R-URI) te behouden.

Voorbeeldconfiguratie:

dial-peer voice 1000 voip
 description *** Webex Edge Deployment ***
 session protocol sipv2
 session target dns:<REGIONAL_SESSION_TARGET>
 voice-class sip requri-passing
 dtmf-relay rtp-nte
 codec g711ulaw
 no vad

De belangrijkste functionele elementen zijn:

  • Voice-klasse sip requri-passeren: Dit commando is verplicht. Het zorgt ervoor dat de originele R-URI (met het bedrijfsdomein en de vergader-ID) bewaard blijft in de uitgaande INVITE. Zonder dit kan de Webex Cloud het gesprek niet associëren met de juiste vergadering.

  • Doelstellingen van de regionale sessie: Het doel van de sessie moet wijzen op de juiste regionale Webex Cloud ingress. Dit moet worden geconfigureerd op basis van de geografische regio van de klant. Bijvoorbeeld EMEA: dns:ecccp.euro.pub.webex.com. Partners moeten de juiste regionale FQDN voor hun specifieke implementatiecluster controleren via de Control Hub.

Bij multi-tenant implementaties is het cruciaal om ervoor te zorgen dat de R-URI ongewijzigd blijft. Als de R-URI wordt gewijzigd door de CUBE, kan de oproep niet worden doorgestuurd naar de geplande vergadering.

Partners zijn verantwoordelijk om ervoor te zorgen dat hun specifieke CUBE-versie en dial-peer logica niet in strijd zijn met dit commando. Zorg er altijd voor dat het bedrijfsdomein en de vergadercontext correct in kaart worden gebracht in de Control Hub om aan het verkeer te voldoen.

Bekende beperkingen

Hier zijn enkele bekende beperkingen:

  • BroadWorks AS heeft geen directe internettoegang.

  • SBC/CUBE configuratie is nog steeds vereist.

  • Ondersteuning voor Desktop REFER-escalatie wordt gevalideerd.

Problemen oplossen bij oproepen

Als de oproep mislukt, voert u de volgende stappen uit:

  1. Vastleggen ALS XS-logboeken.

  2. Vastleggen van NS routing logs.

  3. Controleer de internetverbinding van SBC.

  4. Logboeken delen met Cisco TAC.

E911 Noodoproep

Webex voor Cisco BroadWorks ondersteunt E-nooddiensten911 bellen. Met deze functie worden noodoproepen doorgestuurd naar een Public Safety Answering Point (PSAP), die vervolgens de hulpdiensten naar de locatie van de beller kan leiden. Om deze functie te gebruiken, moet u Webex voor Cisco BroadWorks integreren met een E911-noodoproepprovider.

Gebruik de volgende Webex-artikelen om ondersteuning voor E911 noodoproepdiensten te configureren:

  • Categorie: E911Noodoproep in Webex voor BroadWorks—Gebruik dit artikel om E te configureren911noodoproep in Webex voor Cisco BroadWorks met behulp van een van de volgende ondersteunde E911aanbieders:

    • Gegarandeerd

    • Binnen het systeem

    • RedSky

  • Disclaimer noodoproep—Als u een locatieservice hebt, kunt u het venster Disclaimer voor nooddiensten in de Webex-app zo instellen dat gebruikers hun locatie kunnen bijwerken wanneer ze zich aanmelden.

Klanten aanpassen en voorzien

Gebruikers downloaden en installeren hun generieke Webex-app, voor desktop of mobiel (voor downloadlinks, zie Categorie: Webex-app). Zodra de gebruiker zich authenticeert, registreert de client zich tegen de Webex Cloud voor Messaging en Meetings, haalt zijn branding-informatie op, ontdekt zijn BroadWorks service-informatie en downloadt zijn oproepconfiguratie van BroadWorks Application Server (via DMS op XSP|ADP).

U configureert de oproepparameters voor Webex App in BroadWorks (zoals gebruikelijk). U configureert branding, messaging en meeting parameters voor de clients in de Control Hub. U wijzigt een configuratiebestand niet direct.

Deze twee sets configuraties kunnen overlappen, in het geval dat de Webex-configuratie de BroadWorks-configuratie overtroekt.

Voeg Webex App configuratiesjablonen toe aan BroadWorks Application Server

Webex App is geconfigureerd met DTAF-bestanden. De clients downloaden een configuratie XML bestand van de Application Server, via de Device Management service op de XSP|ADP.

De R22.0-sjabloonbestanden worden niet meer ondersteund en worden uit het DTAF-archief verwijderd. De sjablonen met het label R23.0 worden hernoemd naar R24.0, aangezien BroadWorks R24.0 de oudste versie is die momenteel wordt ondersteund. Deze R24.0-sjablonen zijn bedoeld voor gebruik op alle ondersteunde versies van de applicatieserver, inclusief R24.0, R25.0 en R26.0.

1

Download de zip-bestanden van de gewenste Webex App (Desktop, Mobile, of Tablet) vanaf Software-downloadsplaats.

Voor meer informatie over het type apparaatprofiel en de naam van het pakket, zie Apparaatprofielen in de sectie Uw omgeving voorbereiden.

2

Controleer of je de juiste tagsets in hebt BroadWorks System > Resources > Device Management > Tag Sets.

3

DTAF-bestanden importeren en bijwerken.

Het DTAF-pakket dat wordt gedownload van de Cisco Software Download-site is een containerarchief. U moet dit archief lokaal uitpakken om toegang te krijgen tot de specifieke .DTAF.zip bestanden die nodig zijn om te importeren in de BroadWorks Application Server.

  1. Zoek het gedownloade DTAF zip bestand (bijvoorbeeld ucone-mobile-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip) en pak de inhoud uit naar een lokale map op uw computer.

  2. Navigeer naar de uitgepakte map. Zoek het laatste DTAF-bestand voor uw klant (bijvoorbeeld Business_Communicator_-_PC(R24.0).DTAF.zip).

  3. Log in op de CommPilot interface als systeembeheerder en ga naar System > Resources > Identity/Device Profile Types > Import.

  4. Klik in de sectie Apparaattype Bestand uploaden op Bladeren, selecteer het .DTAF.zip-bestand en klik op OK om het bestand te importeren.

  5. (Optioneel): Als u een bestaand apparaattype bijwerkt, moet u het selectievakje Apparaattype File Update selecteren. Deze actie overschrijft bestaande sjablonen met de nieuwste configuraties in de nieuwe DTAF.

4

Configureer apparaatprofielen voor elke klant die u levert.

  1. Open het nieuw toegevoegde apparaatprofiel om te bewerken.

  2. Voer het XSP|ADP farm FQDN en Device Access Protocol in.

  3. Vink het selectievakje Support Remote Party Info aan. Deze ondersteuning is vereist om bureaublad delen te werken.

    U kunt ook ondersteuning voor externe partijen inschakelen met de volgende CLI-opdracht op de toepassingsserver: AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true.

  4. Pas de sjablonen aan volgens uw omgeving. Zie de volgende tabel voor meer informatie.

  5. Sla het profiel op.

5

Klik op Files and Authentication en selecteer vervolgens de optie om alle systeembestanden opnieuw te bouwen.

Naam

Beschrijving

Codecprioriteit

De prioriteitorder configureren voor de audio- en videocodecs voor het VoIP gesprekken

TCP, UDP en TLS

Configureer de protocollen die worden gebruikt voor SIP-signalering en media

RTP-audio- en videopoorten

Poortbereiken configureren voor RTP-audio en -video

SIP-opties

Configureer verschillende opties met betrekking tot SIP (SIP INFO, gebruik rport, SIP proxy discovery, refresh intervals voor registratie en abonnement, etc.)

Aanpassen van branding voor Webex App

  • Partneraanpassingen—Partnerbeheerders kunnen geavanceerde merkaanpassingen toepassen die van toepassing zijn op de partnerorganisatie en/of klanten die de partner beheert. Zie Geavanceerde merkaanpassingen configureren.

  • Klantaanpassingen—Als de partner klanten toestaat om hun eigen merkaanpassingen toe te passen, kunnen klantbeheerders de procedures volgen op Voeg uw bedrijfsbranding toe aan Webex.

Het User Activation Portal gebruikt hetzelfde logo dat u toevoegt voor client Branding.

Probleemrapportage en help-URL's aanpassen

Om deze opties aan te passen, kunnen beheerders de procedure "Add Feedback and Help Site URLs" volgen, die te vinden is in beide voorgaande branding artikelen.

Uw testorganisatie configureren voor Webex voor Cisco BroadWorks

Voordat u begint

Met Flowthrough-provisioning

U moet alle XSP|ADP-services en de partnerorganisatie in Control Hub configureren voordat u deze taak kunt uitvoeren.

1

Service toewijzen in BroadWorks:

  1. Maak een testonderneming aan onder uw serviceprovider-onderneming in BroadWorks, of maak een testgroep aan onder uw serviceprovider (afhankelijk van uw BroadWorks-instelling).

  2. Configureer de IM&P-service voor die onderneming, om te wijzen op de sjabloon die u aan het testen bent (haal de URL en referenties van de provisioning-adapter op uit de sjabloon Onboarding van de Control Hub).

  3. Maak test abonnees in die onderneming/groep.

  4. Geef de gebruikers unieke e-mailadressen in het e-mailveld in BroadWorks. Kopieer deze ook naar het kenmerk Alternatieve id.

  5. Wijs de geïntegreerde IM&P-service toe aan die abonnees.

    Hierdoor worden de klantorganisatie en de eerste gebruikers gemaakt. Dit duurt een paar minuten. Wacht even voordat u probeert aan te melden met uw nieuwe gebruikers.

2

Klantorganisatie en gebruikers verifiëren in Control Hub:

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Customers en controleer of uw nieuwe klantorganisatie in de lijst staat (naam volgt de groepsnaam of bedrijfsnaam, van BroadWorks).

  3. Open de klantorganisatie en controleer of de abonnees gebruikers in die organisatie zijn.

  4. Controleer of de eerste abonnee aan wie u de geïntegreerde IM&P-service hebt toegewezen, de klantbeheerder van die organisatie is geworden.

Gebruikers testen

1

Download de Webex-app op twee verschillende machines.

2

Meld u aan als uw testgebruikers op de twee machines.

3

Testgesprekken voeren.

Webex voor BroadWorks beheren

Organisaties voor klant inrichten

In het huidige model provisioneren we automatisch de klantorganisatie wanneer u de eerste gebruiker onboardt via een van de methoden die in dit document worden beschreven. De inrichting vindt slechts eenmaal voor elke klant plaats.

Gebruikers inrichten

U kunt gebruikers op de volgende manieren inrichten:

  • API's gebruiken om Webex-accounts te maken

  • Geïntegreerde IM&P (flowthrough-provisioning) toewijzen met vertrouwde e-mails om Webex-accounts te maken

  • Geïntegreerde IM&P toewijzen (flowthrough provisioning) zonder vertrouwde e-mails. Gebruikers leveren en valideren e-mailadressen om Webex-accounts te maken

  • Gebruikers toestaan zichzelf te activeren (u stuurt ze een koppeling, ze maken Webex-accounts)

Openbare inrichtings-API's

Webex maakt openbare API's beschikbaar om serviceproviders toe te staan de Webex voor Cisco BroadWorks-abonnee-provisioning te integreren in hun bestaande provisioningworkflows. De specificatie voor deze API's is beschikbaar op developer.webex.com. Als u deze API's wilt ontwikkelen, neem dan contact op met uw Cisco-vertegenwoordiger om Webex voor Cisco BroadWorks aan te vragen.

Groothandelsklanten zullen door deze API's worden afgewezen.

Flowthrough-provisioning

Op BroadWorks kunt u gebruikers voorzien van de Enable Integrated IM&P optie. Met deze actie wordt de BroadWorks-provisioningadapter in staat API-aanroep gebruikers in te stellen op Webex. Onze inrichtings-API is achterwaarts compatibel met de UC-One SaaS API. BroadWorks AS vereist geen codewijziging, alleen een configuratiewijziging in het API-eindpunt voor de provisioningadapter.

Het beschikbaar stellen van abonnees in Webex kan aanzienlijk duren (enkele minuten voor de eerste gebruiker binnen een onderneming). Webex voert de inrichting uit als achtergrondtaak. Dus als de provisioning is geslaagd, wordt aangegeven dat de provisioning is gestart. Het geeft niet aan dat het is voltooid.

Om te bevestigen dat gebruikers en de klantorganisatie volledig zijn ingericht op Webex, moet u zich aanmelden bij Partner Hub en in uw klantenlijst zoeken.

Gebruikers van BroadWorks-trunking kunnen Webex voor BroadWorks hebben via een shared call appearance (SCA). De gebruiker van de trunking moet de authenticatiedienst hebben toegewezen. Zoals beschreven in de sectie BroadWorks Trunking Solution Guide 8, maakt dit het mogelijk om de authenticatie van het uiterlijk van de SCA Webex te scheiden van de gewone trunk-authenticatie. Webex voor BroadWorks kan niet worden voorzien voor trunking-gebruikers met de Routelijst of Direct Route-functies toegewezen.

De locatie van sjablonen is verplaatst van BroadWorks Calling in Org-instellingen naar de sectie Klantenlijst en wordt nu de sjabloon Onboarding genoemd.

Zelfactivering gebruikers

BroadWorks-gebruikers in Webex inrichten zonder de geïntegreerde IM&P-service toe te wijzen:

  1. Meld u aan bij Partner Hub en zoek de Customer List .

  2. Klik op View Templates.

  3. Selecteer het sjabloon voor de provisioning Onboarding dat u op deze gebruiker wilt toepassen.

    Vergeet niet dat elke sjabloon is gekoppeld aan een cluster en uw partnerorganisatie. Als de gebruiker niet in het BroadWorks-systeem is gekoppeld aan deze sjabloon, kan de gebruiker niet zelf activeren met de koppeling.

  4. Kopieer de inrichtingskoppeling en verzend deze naar de gebruiker.

    Mogelijk wilt u ook de downloadkoppeling voor software opnemen en de gebruiker eraan herinneren dat deze zijn/haar e-mailadres moet leveren en valideren om zijn/haar Webex-account te activeren.

  5. U kunt de activeringsstatus van de gebruiker controleren op de geselecteerde sjabloon.

Zie Provisioning en activeringsstromen van gebruikers voor meer informatie.

Inrichten met niet-vertrouwde e-mails

Partner Hub biedt een aantal besturingselementen in de weergave Gebruikersstatus waarmee Webex voor Cisco BroadWorks Service Provider-beheerders de gebruikersstatus kan beoordelen en fouten kan oplossen bij het leveren van niet-vertrouwde e-mails. Voor meer informatie, zie Gebruikersvoorziening verifiëren met niet-vertrouwde e-mails.

Webex-gebruikers verplaatsen naar Webex voor Cisco BroadWorks

Om bestaande Webex-gebruikers te verplaatsen naar Webex voor Cisco BroadWorks, raadpleegt u onderstaande tabel om te bepalen welke procedure u moet volgen.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfregistratie (bijvoorbeeld gratis account, proefaccount)

Als Webex voor BroadWorks organisatie niet bestaat (er zijn geen gebruikers voorzien):

  • Provisiegebruikers—Volg de normale provisioning om de eerste gebruiker als admin-gebruiker toe te voegen. Dit verplaatst de account voor de eerste gebruiker automatisch en creëert de Webex voor BroadWorks organisatie. Toestemming van de gebruiker is vereist om volgende gebruikers te verplaatsen (gebruik de volgende procedure).

Als Webex voor BroadWorks-organisatie bestaat (er is minstens één gebruiker voorzien):

Klantorganisatie

Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks

Gebruik deze procedure om een bestaande Webex-gebruiker die zich in een consumentenorganisatie bevindt of een zelfregistratie-account heeft (gratis account of proefaccount) te verplaatsen naar Webex voor Cisco BroadWorks. Merk op dat de Webex voor Cisco BroadWorks organisatie moet bestaan (met de eerste gebruiker provisioned). In dit geval kunt u een van deze opties gebruiken om gebruikers te verplaatsen:

  • Gebruiker verplaatsen (met vertrouwde e-mail)—Gebruikt provisioning met vertrouwde e-mails

  • Gebruiker verplaatsen (met niet-vertrouwde e-mail)—Gebruikt provisioning met niet-vertrouwde e-mails

  • Zelfactivering

Als de Webex voor Cisco BroadWorks organisatie nog niet is aangemaakt (er zijn geen gebruikers voorzien), volg dan de normale voorzieningsprocessen ( Provisiegebruikers) om de organisatie te creëren en de eerste gebruiker als beheergebruiker toe te voegen. Nadat de eerste gebruiker in de organisatie is opgenomen, volgt u de op toestemming gebaseerde methoden in deze procedure om de volgende gebruikers te verplaatsen.

Gebruiker verplaatsen (met vertrouwd e-mailadres)

Als de sjabloon Onboarding gebruik maakt van vertrouwde e-mails, kan de partnerbeheerder volgende gebruikers verplaatsen met dit proces:

  1. Administrator voegt de gebruiker toe.

    • De gebruiker wordt naar de BroadWorks Provisioning Bridge pushed.

    • Met de CI-opzoeking wordt bepaald dat deze gebruiker een andere Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  2. Gebruiker opent de e-mail en klikt op Activate Account. De gebruiker wordt omgeleid naar de Webex-consumentenportal.

  3. Gebruiker meldt zich aan bij Webex.

  4. Gebruiker klikt Delete om de oude Webex-rekening te verwijderen.

    • Oude Webex-account wordt verwijderd.

    • Gebruiker is via hetzelfde e-mailadres ingericht voor Webex voor Cisco BroadWorks.

    • Gebruiker wordt doorgestuurd naar de downloadpagina.

Gebruiker verplaatsen (met niet-vertrouwde e-mail)

Als de sjabloon Onboarding Untrusted Emails gebruikt, moet het e-mailadres van de gebruiker eerst worden gevalideerd. De beheerder kan dit proces volgen om volgende gebruikers te verplaatsen:

  1. Administrator voegt de gebruiker toe.

    • De gebruiker wordt automatisch naar de BroadWorks Provisioning Bridge pushen.

    • Er wordt een tekst met een activeringskoppeling naar de gebruiker verzonden.

  2. De gebruiker klikt op activering en voert zijn/haar e-mailadres in.

    • Met de CI-opzoeking wordt bepaald dat deze gebruiker een andere Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  3. Gebruiker opent de e-mail en klikt op Join Now.

    • Het e-mailadres is gevalideerd.

    • Gebruiker wordt omgeleid om zich aan te melden bij de Webex-consumentenportal.

  4. Gebruiker meldt zich aan bij Webex.

  5. Gebruiker moet klikken Delete om de oude Webex-rekening te verwijderen.

    • Oude Webex-account wordt verwijderd.

    • Gebruiker is via hetzelfde e-mailadres ingericht voor Webex voor Cisco BroadWorks.

    • Gebruiker wordt doorgestuurd naar de downloadpagina.

Zelfactiveringsverflow

Als de gebruiker een bestaand BroadWorks-account heeft, kan deze het zelfactiveringsproces gebruiken om het account te verplaatsen.

  1. De gebruiker meldt zich aan bij de URL van de gebruikerstoegangsportal met BroadWorks-aanmeldgegevens.

  2. Gebruiker voert zijn/haar e-mailadres in.

    • Gebruiker wordt naar broadWorks Provisioning Bridge pushed.

    • Er wordt een geautomatiseerde e-mail naar het e-mailadres van de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op de Join Now link, die het e-mailadres valideert.

    • CI vindt gebruiker heeft bestaand Webex-account. Gebruikers moeten het oude account verwijderen voordat ze kunnen doorgaan.

    • Gebruiker wordt omgeleid om zich aan te melden bij Webex.

  4. De gebruiker meldt zich aan bij de consumentenportal.

  5. De gebruiker klikt Delete Account.

    • Het oude Webex-account wordt verwijderd.

    • De gebruiker krijgt een nieuw Webex-account voor Cisco BroadWorks met hetzelfde e-mailadres.

Webex voor BroadWorks koppelen aan bestaande organisatie

Als u een partnerbeheerder bent die Webex voor BroadWorks-diensten toevoegt aan een bestaande Webex-klantenorganisatie, die nog niet is gekoppeld aan een door een partner beheerde BroadWorks-onderneming, MOET de beheerder van de klantenorganisatie de toegang van de beheerder goedkeuren om de aanvraag tot levering te laten slagen.

De goedkeuring van de organisatiebeheerder is nodig als een van de volgende zaken waar is:

  • De bestaande klantenorganisatie heeft 100 gebruikers of meer

  • De organisatie heeft een geverifieerd e-maildomein

  • Het organisatiedomein wordt geclaimd

Als geen van de bovenstaande criteria waar is, kan een automatische koppeling plaatsvinden.

In een Automatic Attachment scenario, wordt een Webex for BroadWorks abonnement toegevoegd aan een bestaande klantenorganisatie zonder enige kennisgeving aan de bestaande org administrator of eindgebruiker. In de meeste gevallen krijgt uw partnerorganisatie Provisioning Admin-rechten. Als de klantorganisatie echter geen licenties heeft of alleen geschorste/geannuleerde licenties heeft, dan wordt u een volledige beheerder gemaakt.

Met toegang tot Provisioning Admin hebt u een beperkte zichtbaarheid in Control Hub voor de gebruikers in de bestaande organisatie. Het wordt aanbevolen om contact op te nemen met de beheerder van de klant en om Volledige Beheerderstoegang tot de organisatie aan te vragen.

Partnerbeheerders kunnen de volgende procedure voltooien om BroadWorks-belservices toe te voegen aan een bestaande Webex-organisatie:

Zorg ervoor dat de Allow admin-invite emails when attaching to existing orgs (de schakelaar staat standaard aan).

1

De partnerbeheerder bepalingen Webex voor Cisco BroadWorks voor de klant. Voor hulp, zie Klantenorganisaties voorziening. Nu gebeurt het volgende:

  • Organisatiebijlage mislukt met een 2017 fout (Kan abonnee niet inrichten in een bestaande Webex-organisatie). (Er wordt geen fout ontvangen tijdens een automatische bijlage.)

  • Er wordt een e-mailmelding gegenereerd en verzonden naar de org-beheerders van de klant (maximaal vijf beheerders). De e-mailmelding benadrukt de e-mail van de partnerbeheerder (zoals geconfigureerd in de sjabloon Onboarding in Partner Hub) en vraagt de org-beheerder om de partnerbeheerder als externe beheerder goed te keuren. De beheerder van de klantenorganisatie moet het verzoek goedkeuren en de partnerbeheerder volledige beheerder toegang geven tot de klantenorganisatie.

Stel dat de beheerder van de klant geen e-mail ontvangt. In dat geval kan de klantbeheerder de partnerbeheerder (gespecificeerd in de template) handmatig toevoegen als externe beheerder van de klantorganisatie vanuit de Control Hub. Probeer dan opnieuw de provisioning van de gebruiker, die de Webex voor Cisco BroadWorks klantenvoorziening zal activeren.

2

Met toegang tot de volledige beheerder kan de partnerbeheerder het proces van provisioning van de klant voltooien. U moet de levering van de klant opnieuw proberen vanaf Stap 1 hierboven. Nu echter, als externe Full Admin, moet u de fout niet observeren 2017.

Zodra de levering van oproepdiensten is voltooid, zal de bestaande klantenorganisatie als klant zichtbaar zijn onder de Webex voor BroadWorks Partner Org.

De naam van de bijgevoegde organisatie verandert niet in de naam van de BroadWorks-onderneming. De naam van de bijgevoegde org zal behouden blijven zoals deze was voorafgaand aan het bijgevoegde proces.

Voorwaarden voor Org Attachment

  • Het e-mailadres van de eerste BroadWorks-abonnee moet overeenkomen met het e-mailadres van een bestaande gebruiker in de beoogde klantorganisatie. Anders wordt er een nieuwe klantorganisatie aangemaakt.

  • De eerste gebruiker uit de bestaande org die voorzien wordt voor Webex voor BroadWorks wordt niet voorzien als admin user. Instellingen en rechten van de bestaande organisatie worden behouden.

  • De bestaande authenticatie-instellingen van de organisatie hebben voorrang op wat is geconfigureerd op de Webex voor BroadWorks provisioning template. Hierdoor is er geen verandering in de manier waarop bestaande gebruikers inloggen.

    • Als de bestaande klantenorganisatie echter basisbranding heeft ingeschakeld, zullen na de attach de geavanceerde branding-instellingen van de partner voorrang hebben. Als de klant wil dat de basisbranding intact blijft, moet de partner de klantorganisatie configureren om branding te omzeilen in de Advanced Branding-instellingen.

  • De naam van de bestaande organisatie verandert niet.

  • Er is geen verandering in de vlag voor het onderdrukken van e-mails in de instellingen van de bestaande organisatie. Dit kan gevolgen hebben voor nieuwe gebruikers. Afhankelijk van hoe de vlag is ingesteld, kunnen nieuwe gebruikers al dan niet een e-mail ontvangen met een code die moet worden ingevoerd om de activering te voltooien.

  • Restricted Admin Mode (ingesteld door de Restricted by Partner Mode-schakelaar) wordt uitgeschakeld voor de bijgevoegde org.

  • Zorg ervoor dat u het bevestigingsproces van de organisatie voltooit (bestaande gebruikers verplaatsen en de organisatie-ID bijwerken), voordat u nieuwe gebruikers verstrekt in de Webex voor Cisco BroadWorks-organisatie.

  • Een BroadWorks-onderneming kan worden geassocieerd met slechts één Webex-organziatie. U kunt abonnees van een enkele BroadWorks-onderneming niet in afzonderlijke Webex-organisaties voorzien.

Externe beheerder toevoegen

Voor de stappen die de beheerders van de klantenorganisatie kunnen volgen om de partnerbeheerder als externe beheerder toe te voegen, zie de Aanvraag externe beheerder goedkeurenartikel over help.webex.com.

De klantenbeheerder moet de externe beheerder de Volledige beheerdersrechten en -privileges geven.

Het e-mailadres dat de beheerder van de organisatie van de klant als externe beheerder toevoegt, moet overeenkomen met het e-mailadres van de beheerder van de partner zoals geconfigureerd in de sjabloon Onboarding op Partner Hub.

Na het toevoegen van de e-mail uit de Onboarding template op Partner Hub als een Full Administrator, zullen eventuele extra partner admins ook moeten worden toegevoegd als een externe admin met Full Administrator rechten.

Webex voor BroadWorks loskoppelen van bestaande organisatie

Volg deze stappen om Webex voor BroadWorks los te koppelen van een bestaande Webex-organisatie. Bijvoorbeeld, als u Webex voor BroadWorks per ongeluk aan een bestaande organisatie hebt gekoppeld en de bijlage wilt verwijderen.

In Standard flow zal het loskoppelen van Webex voor BroadWorks van een bestaande Webex-organisatie (alleen standaardflow) alle bijbehorende abonneegegevens verwijderen en het Webex voor BroadWorks-abonnement van de klant deactiveren. U zult ook de toegang tot de klantorganisatie verliezen als dit het enige bijbehorende abonnement is. In Hybrid flow worden de abonnementen van klanten niet gewijzigd.

  1. Als u geen toegang hebt tot de klantinstellingen in Control Hub, laat de klantbeheerder u dan externe beheerderstoegang verlenen door: Aanvraag externe beheerder goedkeuren.

  2. Verwijder alle Webex voor BroadWorks-werkruimten uit de organisatie. Gebruik de Verwijder een BroadWorks-werkruimteAPI.

  3. Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de Verwijder een BroadWorks-abonneeAPI.

  4. Hangende Webex voor BroadWorks-gebruikers uit de organisatie verwijderen. Als gebruikers bijvoorbeeld via de onvertrouwde e-mailstroom werden voorzien en geldige e-mails nog niet werden ingevoerd, blijven de gebruikers in een wachtende toestand achter. Volgen Gebruikersvoorziening verifiëren met niet-vertrouwde e-mailsom gebruikers te verwijderen.

  5. Verwijder de BroadWorks Calling configuratie voor deze klant. Open de Control Hub-instantie van de klant, klik op Hybrid, onder BroadWorks Calling Verwijder alle configuraties.

Als u na voltooiing van het detachement Webex voor BroadWorks aan de klant wilt koppelen, volg dan de bevoorradingsprocessen om aan een bestaande klant te koppelen.

Een alternatieve optie om abonnees te verwijderen als u niet de Remove a BroadWorks Subscriber API moet in BroadWorks CommPilot gaan en de Integrated IM&P service voor de getroffen gebruikers.

Gebruikers en organisaties beheren

Vergeet niet dat de gebruiker zowel in BroadWorks als In Webex bestaat om gebruikers in Webex voor Cisco BroadWorks te beheren. De belkenmerken en de BroadWorks-identiteit van de gebruiker worden gehouden in BroadWorks. Webex biedt een afzonderlijke e-mailidentiteit en de licenties voor Webex-functies.

Inrichten van gebruikers verifiëren voor niet-vertrouwde e-mailadressen

Als u Webex voor BroadWorks-gebruikers inrichten met flow-through provisioning met niet-vertrouwde e-mails, moeten gebruikers zichzelf inrichten door hun e-mailadres in te geven in de gebruikersactiveringsportal. Als de gebruiker een fout tegenkomt, kan hij de Try again optie die in het portaal wordt weergegeven om nog een poging te doen. Als de gebruiker de fout opnieuw toekent, kan de beheerder de onderstaande stappen in Partner Hub gebruiken om de status te controleren en de gebruiker te laten onboarden, de gebruiker te verwijderen of configuratiewijzigingen toe te passen.

1

Meld u aan bij Partner Hub en zoek de Customer List .

2

Klik op View Templates. Selecteer de juiste Onboarding template die u op deze gebruiker wilt toepassen.

3

Voer uw naam en e-mailadres in onder User Verification, controleer of de volgende instellingen zijn ingesteld om ervoor te zorgen dat flow-through provisioning met niet-vertrouwde e-mails correct is geconfigureerd:

  • Het bericht Untrusted Emails optie moet gecontroleerd worden
  • Het bericht Share Link veld moet verwijzen naar de Activatielink. Als alles is geconfigureerd, kunnen gebruikers zelf inrichten via de gebruikersactiveringsportal.
4

Nadat de gebruiker provisioning heeft plaatsgevonden, in de User Verification gedeelte op Show User Status om de bevoorradingsstatus te controleren.

Het bericht User Status view toont de lijst van gebruikers samen met details zoals de BroadWorks ID, het geselecteerde pakkettype en de huidige status, die aangeeft of de gebruiker is voorzien, of dat er een vereiste is.
5

Voor gebruikers met fouten of vereisten in behandeling klikt u op de drie punten rechts en kiest u een van de volgende beheeropties:

  • Retry Activation—Klik op deze optie om de gebruiker opnieuw bij te werken. Voer in het pop-upvenster een geldig e-mailadres in en klik op Onboard.
  • Delete User—Deze optie kan geschikt zijn als u de configuratie moet wijzigen om onboarding mogelijk te maken. Nadat u de gebruiker hebt verwijderd en uw wijzigingen hebt aangebracht, kan de gebruiker opnieuw proberen te onboarding.
  • Change Package Type—Verander de instelling van het ene pakket naar het andere:
  • Copy Error Text—Klik op deze optie om de fouttekst te kopiëren.
User status page displaying user information, with options to retry activation, change package type, or delete the user

Aanvullende weergaveopties

De volgende aanvullende opties zijn beschikbaar wanneer u een lijst met gebruikers we bekijken:

  • Export—Klik op deze knop als u de gebruikerslijst naar een CSV-bestand wilt exporteren.

  • Exclude provisioned users—Schakel deze optie in als u alleen gebruikers wilt zien met hangende vereisten of fouten.

Gebruikers-id of e-mailadres wijzigen

Wijzigingen gebruikers-id en e-mailadres

E-mail-id en alternatieve id zijn de broadWorks-gebruikerskenmerken die worden gebruikt met Webex voor Cisco BroadWorks. De BroadWorks-gebruikers-id is nog steeds de primaire id van de gebruiker in BroadWorks. De volgende tabel beschrijft de doelen van deze verschillende kenmerken en wat u moet doen als u deze moet wijzigen:

Kenmerk in BroadWorks Bijbehorend kenmerk in Webex Purpose Aantekeningen
BroadWorks-gebruikers-id Geen Primaire id U kunt deze identificatiecode niet wijzigen en de gebruiker nog steeds koppelen aan hetzelfde account in Webex. U kunt de gebruiker verwijderen en opnieuw aanmaken als het fout is.
E-mail-id Gebruikers-id

Verplicht voor flow-through provisioning (het maken van Webex-gebruikers-id) als u bevestigt dat u e-mail vertrouwt

Niet vereist in BroadWorks als u niet beweert dat u e-mails kunt vertrouwen

Niet vereist in BroadWorks als u abonnees toestaat om zelf te activeren

Er is een handmatig proces om dit op beide plaatsen te wijzigen als de gebruiker wordt voorzien van het verkeerde e-mailadres:

  1. Wijzig het e-mailadres van de gebruiker via de Control Hub of de openbare API

  2. Voeg de nieuwe e-mail-ID toe als een alternatief gebruikers-ID in BroadWorks

Wijzig de BroadWorks-gebruikers-ID niet. Dit wordt niet ondersteund.

Alternatieve id Geen Hiermee wordt de authn van de gebruiker via e-mail en wachtwoord in staat stelt BroadWorks-gebruikers-id in Het moet hetzelfde zijn als het e-mailadres. Als u de e-mail niet in het attribuut Alternate ID kunt plaatsen, moeten gebruikers hun BroadWorks-gebruikers-ID invoeren bij het authenticeren.

Gebruikerspakket wijzigen in Partner Hub

1

Meld u aan bij Partner Hub en klik op Customers.

2

Zoek naar en selecteer de klantorganisatie waar de gebruiker is thuis.

De pagina organisatieoverzicht wordt geopend in een deelvenster aan de rechterkant van het scherm.

3

Klik op View Customer.

De klantorganisatie wordt geopend in Control Hub en toont de pagina Overzicht.
4

Klik op Users, zoek en klik vervolgens op de getroffen gebruiker.

5

In de gebruiker ServicesKlik Webex for BroadWorks Packages (Subscriptions).

Het deelvenster Pakketten van de gebruiker wordt geopend en u kunt zien welk pakket momenteel aan de gebruiker is toegewezen.

6

Op het tabblad Profile tab, kijk in de Package sectie en klik op de pijl (>) om het uitzicht uit te breiden.

7

Selecteer het gewenste pakket voor deze gebruiker (Basic, Standard, Premium of Softphone) en klik op Save.

In Control Hub wordt een bericht weergegeven dat de gebruiker wordt bijgewerkt.

8

U kunt de gebruikersgegevens en het tabblad Control Hub sluiten.

Standaard- en Premium-pakketten hebben afzonderlijke vergadersites die zijn gekoppeld aan elk pakket. Als een abonnee met beheerdersrechten met een van deze twee pakketten naar het andere pakket verplaatst, verschijnt de abonnee met twee vergadersites in Control Hub. De vergaderingsmogelijkheden van de abonnee en de vergadersite zijn afgestemd op het huidige pakket. De vergaderingssite van het vorige pakket en eerder gemaakte inhoud op die site, zoals opnamen, blijven toegankelijk voor de sitebeheerder van de vergadering.

Het kan twee tot drie uur duren voordat de PMR bij te werken die het resultaat zijn van een wijziging in een pakket.

Gebruikers verwijderen

Er zijn verschillende methoden die beheerders kunnen gebruiken om een gebruiker te verwijderen uit Webex voor Cisco BroadWorks:

Als de gebruiker die u gaat verwijderen beheerdersrechten heeft, wijs dan een nieuwe beheerder toe voordat u de gebruiker verwijdert. Er is geen automatische overdracht van de beheerdersrol indien de laatste beheerder verwijderd wordt.

Webex voor Cisco BroadWorks API

Partnerbeheerders kunnen de Webex-api voor Cisco BroadWorks API gebruiken om gebruikers te verwijderen:

  1. Voer de Verwijder een BroadWorks-abonneeAPI-aanvraag op https://developer.webex.com/docs/api/v1/broadworks-abonnees/verwijder-een-broadworks-abonnee. Met dit verzoek wordt het Webex-abonnement voor Cisco BroadWorks verwijderd. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt beschouwd als een gratis Webex-gebruiker.

  2. Voer de Een persoon verwijderenAPI-aanvraag op https://developer.webex.com/docs/api/v1/mensen/een-persoon-verwijderenom de gebruiker volledig te verwijderen.

Flow-through Provisioning

Partnerbeheerders kunnen flow-through provisioning gebruiken om gebruikers te verwijderen:

  1. Verwijder op de BroadWorks-server de geïntegreerde IM+P-service van de gebruiker. U kunt de service voor de gebruiker uitschakelen via de User – Integrated IM&P pagina over BroadWorks. Zie "Geïntegreerde IM&P configureren" in de Cisco BroadWorks Application Server Group Web Interface Administration Guide – Deel 2 voor een gedetailleerde procedure.

    Nadat de service is uitgeschakeld, verwijdert doorstroomvoorziening het Webex voor Cisco BroadWorks-abonnement van de gebruiker. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt beschouwd als een gratis Webex-gebruiker.

  2. Zoek de gebruiker in Control Hub en selecteer deze.

  3. Ga naar Actions en selecteer Delete User.
Control Hub (klantbeheerders)

Klantbeheerders kunnen Control Hub gebruiken om gebruikers uit hun organisatie te verwijderen. Voor meer informatie, zie Een gebruiker uit uw organisatie verwijderen in Webex Control Hubbij https://help.webex.com/0Categorie: Qse04/.

Organisatie verwijderen

Volg deze procedure om een Webex voor Cisco BroadWorks organisatie uit het systeem te verwijderen.
1

Gebruik de Personen-API's om alle gebruikers uit de organisatie te verwijderen:

  1. Voer de Personen oplijstenAPI om een lijst van gebruikers te verkrijgen.

  2. Voer de Een persoon verwijderenAPI om de gebruikers te verwijderen.

De Remove a BroadWorks Subscriber API verwijdert Webex voor Cisco BroadWorks-rechten van een gebruiker, maar verwijdert de gebruiker niet.

2

Schakel deze uit als Directory Sync is ingeschakeld. Dit kan via Partner Hub of via de publieke API.

Om Directory Sync via Partner Hub uit te schakelen:

  1. Meld u aan bij Partner Hub en kies Customers, Onboarding Templates.

  2. Selecteer de klant, klik op de Service settings.

  3. Op het tabblad Preference sectie uitschakelen Directory Sync.

Om Directory Sync via API uit te schakelen, gebruikt u de Update Directory Sync voor een BroadWorks EnterpriseAPI en schakel de enableDirSync instelling.

Alle gebruikers die gerelateerd zijn aan BroadWorks Directory Sync voor deze organisatie zullen worden verwijderd. Merk op dat het verwijderen van gebruikers (met behulp van beide methoden) enige tijd kan duren, afhankelijk van de hoeveelheid gebruikers.

3

Nadat alle gebruikers zijn verwijderd, gebruik je de Een organisatie verwijderenAPI om de organisatie te verwijderen.

Een abonnement opzeggen van Control Hub

Omdat de API privé is, hebben klanten er geen toegang toe. In plaats daarvan laten de volgende stappen zien hoe klanten hun eigen abonnement bij Control Hub kunnen opzeggen:

  1. De Partner Admin kan navigeren naar de pagina "Hybride" Services op de Control Hub van de Klant.

  2. Zoek de "BroadWorks Calling"-kaart.

  3. Zodra alle gebruikers van Webex zijn verwijderd voor BroadWorks voor die Klant, moet de Partner een knop zien om "Configuratie wissen" (d.w.z. hun customer_config-item in BPB verwijderen).

Releasebeheer

Met de bedieningselementen voor releasebeheer in de Partner Hub kan Webex voor Cisco BroadWorks-serviceproviders gemakkelijk releases beheren door ze de mogelijkheid te geven de releases te beheren door de Webex-apps van gebruikers te upgraden naar de nieuwste software.

Standaard maakt de Webex-app gebruik van Automatische upgrades (Cisco-gecontroleerde maandelijkse releases). Met deze functie kunnen partnerbeheerders echter:

  • Configureer aangepaste releaseschema's met uitstel van het standaard releaseschema van Cisco

  • Configureer een single release schema en cascade dat schema naar alle klantorganisaties die ze beheren

  • Verschillende releaseschema's toewijzen aan verschillende klantorganisaties

Zie het Webex-artikel voor meer informatie over Release Management, inclusief informatie over het configureren en toepassen van aangepaste releaseschema's. Aanpassingen voor releasebeheer.

Het systeem opnieuw configureren

U kunt het systeem als volgt opnieuw configureren:

  • Een BroadWorks-cluster toevoegen in Partner Hub

  • Een BroadWorks-cluster bewerken of verwijderen in Partner Hub

  • Een inwerksjabloon toevoegen in Partner Hub

  • Een inwerksjabloon bewerken of verwijderen in Partner Hub

Een BroadWorks-cluster bewerken of verwijderen in Partner Hub

Een BroadWorks-cluster bewerken of verwijderen in Partner Hub.

1

Aanmelden bij Partnerhub.

2

Klik op Services.

3

Selecteer in het deelvenster BroadWorks Calling kaart, klik View Broadworks Calling.

4

Klik op View Clusters.

5

Klik op het cluster dat u wilt bewerken of verwijderen.

6

U hebt de volgende opties:

  • Wijzig de details die u moet wijzigen en klik op Save.
  • Klik op Delete om het cluster te verwijderen.

    Als er veel klanten (>50) in de BroadWorks-cluster zijn, worden bewerkingen zoals het bijwerken van XSI-acties, XSI-evenementen, DAS URL, XSP|ADP URL of DND-synchronisatie niet ondersteund. In dergelijke gevallen Is het raadzaam om contact op te nemen met een Cisco TAC support engineer voor hulp.

    Als een sjabloon aan de cluster is gekoppeld, kunt u een cluster niet verwijderen. Verwijder de gekoppelde sjablonen voordat u de cluster verwijdert. Zie Een inwerksjabloon bewerken of verwijderen in Partner Hub.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Een inwerksjabloon bewerken of verwijderen in Partner Hub

U kunt inwerksjablonen bewerken of verwijderen in Partner Hub.

1

Aanmelden bij Partnerhub.

2

Klik op Services.

3

Selecteer in het deelvenster BroadWorks Calling kaart, klik View Broadworks Calling.

4

Klik op de sjabloon die u wilt bewerken of verwijderen.

5

U hebt de volgende opties:

  • Bewerk alle details die u moet wijzigen en klik vervolgens op Save.
  • Klik op Delete om het sjabloon te verwijderen, bevestig dan.

Instelling

Waarden

Aantekeningen

Naam/wachtwoord inrichtingsaccount

Door gebruiker geleverde tekenreeksen

U hoeft de gegevens van de provisioning-account niet opnieuw in te voeren bij het bewerken van een sjabloon. De velden voor leeg wachtwoord/wachtwoord bevestigen zijn er om de referenties te wijzigen als u dat wilt, maar laat deze leeg om de waarden te behouden die u oorspronkelijk hebt opgegeven.

E-mailadres van de gebruiker vooraf invullen op de aanmeldpagina

Aan/uit

Het kan tot 7 uren duren voordat een wijziging in deze instelling van kracht wordt. Nadat u het hebt ingeschakeld, kunnen gebruikers nog steeds hun e-mailadressen op het aanmeldscherm moeten invoeren.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Webex-assistent

Webex-assistent Meetings is een intelligente, interactieve virtuele vergaderingassistent die vergaderingen doorzoekbaar, actiebaar en productiever maakt. U kunt Webex-assistent vragen om actie-items op te nemen, belangrijke beslissingen te nemen en tijdens een vergadering of gebeurtenis belangrijke momenten te markeren.

Webex Assistant for Meetings is gratis beschikbaar voor Premium- en Standard-vergaderlocaties en Personal Meeting Rooms. Support omvat zowel nieuwe als bestaande sites.

Webex-assistent inschakelen voor vergaderingen

Webex Assistant is standaard ingeschakeld voor zowel Standard- als Premium-pakket Broadworks-klanten.

Partnerbeheerders en beheerders van klantenorganisaties kunnen de functie voor klantenorganisaties uitschakelen via Besturingshub.

Beperkingen

De volgende beperkingen gelden voor Webex voor Cisco BroadWorks:

  • De ondersteuning is beperkt tot Premium- en Standard-vergaderlocaties en Persoonlijke vergaderzalen.

  • Transcripties met ondertiteling worden alleen in het Engels, Spaans, Frans en Duits ondersteund.

  • Het delen van content via e-mail is alleen toegankelijk voor gebruikers binnen uw organisatie

  • Vergaderinhoud is niet toegankelijk voor gebruikers buiten uw organisatie. Vergaderinhoud is ook niet toegankelijk wanneer deze wordt gedeeld tussen gebruikers van verschillende pakketten binnen dezelfde organisatie.

  • Met het Premium pakket zijn post-meeting transcripties beschikbaar of Webex Assistant is ingeschakeld of uitgeschakeld. Als er echter lokale opname is geselecteerd, worden transcripts of hoogtepunten na de vergadering niet vastgelegd.

  • Met het standaardpakket is Record meeting on cloud-optie niet beschikbaar en dus zijn post-meeting transcripties niet beschikbaar of Webex Assistant is ingeschakeld of uitgeschakeld. Echter, als lokale opname is geselecteerd, zelfs dan worden post-meeting transcripts of highlights niet vastgelegd.

Aanvullende Informatie Over Webex Assistant

Voor gebruikersinformatie over het gebruik van de functie, zie Webex-assistent gebruiken in Webex-vergaderingen en -evenementen.

Webex-gesprekken uitschakelen

Gratis Webex-bellen is standaard ingeschakeld zodat gebruikers gratis bellen naar elk Webex-apparaat. Als u echter wilt dat alle oproepen gebruik maken van de BroadWorks-infrastructuur, kunt u Webex-oproepen uitschakelen binnen een Onboarding-sjabloon, waardoor die optie wordt uitgeschakeld voor de klantorganisaties die de sjabloon gebruiken.

Functieondersteuning

Wanneer Webex Calling is uitgeschakeld, gelden de volgende voorwaarden voor Webex voor Cisco BroadWorks-gebruikers:

  • Gebruikers zien niet meer Call with Webex als inschakelbare oproepoptie op de Webex App.

  • Gebruikers kunnen geen gratis Webex-oproepen plaatsen of ontvangen naar niet-Webex voor gebruikers van Cisco BroadWorks. Dit omvat oproepen vanuit een Webex-teamruimte, oproepgeschiedenis, contactpersonen, door het invoeren van de URI of het e-mailadres van de andere gebruiker in de zoekbalk.

  • Schermdelen werkt binnen een BroadWorks-oproep.

  • Webex-vergaderingen en telefonie-aanwezigheid werken nog steeds, zelfs als Webex-oproepen uitgeschakeld zijn.

Webex-oproepen uitschakelen (nieuwe inwerksjabloon)

Tijdens het configureren van een nieuwe Onboarding-sjabloon, kunt u instellen of Webex-oproepen in- of uitgeschakeld zijn door de Disable Cisco Webex Free Calling aankruisvakje binnen de Add a new template tovenaar. Deze instelling wordt opgehaald voor gebruikers in klantorganisaties die u aan de sjabloon toewijst.

Voor meer informatie over het configureren van een nieuwe Onboarding template, zie Uw partnerorganisatie configureren in Partner Hub.

Webex-oproepen uitschakelen (bestaande inwerksjabloon)

Volg deze procedure om Webex-oproepen uit te schakelen van een bestaande Onboarding-sjabloon. Dit zal de functie uitschakelen voor alle nieuwe gebruikers in klantorganisaties die dit sjabloon gebruiken.

  1. Meld u aan bij Partner Hub op admin.webex.com.

  2. Kiezen Settings.

  3. Klik op View Template en kies de gepaste Onboarding template.

  4. Klik op Disable Cisco Webex Free Calling.

  5. Klik op Save.

Webex-oproepen uitschakelen (bestaande gebruiker)

Door deze functie uit te schakelen op een sjabloon Onboarding verandert de instelling alleen voor nieuwe gebruikers die aan de sjabloon zijn toegewezen. Om Webex Calls voor een bestaande gebruiker uit te schakelen, kunt u een van de onderstaande procedures volgen om de gebruiker bij te werken.

Zorg ervoor dat u een van de bovenstaande procedures al hebt voltooid om Webex-oproepen uit te schakelen van de sjabloon Onboarding waaraan de gebruiker is toegewezen. Anders zal een van de onderstaande procedures de gebruiker opnieuw configureren met Webex Calls ingeschakeld.

Als u doorstroomvoorzieningen gebruikt, kunt u het volgende doen:

  1. Open CommPilot en ga naar de gebruikersconfiguratie.

  2. Verwijder de Integrated IM+P service van de gebruiker en klik op OK.

  3. Voeg de Integrated IM+P service naar de gebruiker en klik op OK.

Anders kunt u de API gebruiken om de gebruiker bij te werken.

  1. Gebruik de Verwijder een BroadWorks Subscriber APIom de gebruiker te verwijderen.

  2. Gebruik de Verschaffing van een BroadWorks Subscriber APIde gebruiker toe te voegen.

Video- of schermdelen binnen gesprekken uitschakelen

Partnerbeheerders kunnen configuratielabels gebruiken om videogesprekken en/of schermdelen binnen een gesprek vanuit de Webex-app uit te schakelen (standaard zijn beide mediatypen ingeschakeld voor gesprekken).

Voor volledige configuratiedetails en opties, zie Videogesprekken uitschakelenen Schermdelen uitschakelenin de Webex voor Cisco BroadWorks configuratiegids.

Voor video kunt u ook instellen of inkomende oproepmedia standaard alleen video of audio zijn.

Melding bij bezig lampveld/afhaling oproep

Busy Lamp Field (BLF) / Call Pickup Notification maakt gebruik van de functies BLF en Directed Call Pickup. Een BLF-gebruiker ontvangt een audio- en visuele melding op de Webex App wanneer een gebruiker uit de BLF-bewaakte lijst een binnenkomende oproep ontvangt. De BLF-gebruiker kan Ignore of Pick up het gesprek van de bewaakte gebruiker.

BLF / Call Pickup Notification helpt in situaties waarin een gebruiker oproepen moet beantwoorden voor andere teamleden die mogelijk op een andere locatie werken.

Gebruikers kunnen ook hun BLF bewaakte lijst zien in het Multi-Call Window - Watchlist sectie - (alleen Windows, Mac niet ondersteund) om de aanwezigheid van hun Webex en niet-Webex teamleden te zien. Zie voor hulp bij het inschakelen van multi-call: Venster met meerdere oproepen

Webex-leden zullen een volledige Webex-aanwezigheid hebben. Niet-Webex-leden moeten directory gesynchroniseerd zijn in Webex, en ze zullen alleen "onbekende" en "in-a-call" staten hebben (rinkelende staat zal de call pickup dialoog activeren).

Beperkingen van aanwezigheid voor niet-Webex-gebruikers:

  1. Aanwezigheid wordt niet ondersteund voor niet-CI-broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.

  2. CI-gebruikers zonder Webex-cloudrecht of machinetype van accounts (workspaces) tonen enkel ‘in-call’ en ‘onbekende’ aanwezigheid. Er is geen actieve status, rinkelen, etc.

  3. Niet-Webex-gebruikers uit de BLF-watchlist, die een oproep hebben gestart voordat de Webex-client werd opgestart of terwijl deze offline was, worden getoond met een ‘onbekende’ aanwezigheid.

  4. Het verliezen van uw verbinding betekent dat alle niet-Webex-in-call staten zullen worden teruggezet op ‘onbekend’ bij het opnieuw verbinden.

  5. Indien een niet-Webex-gebruiker uit de BLF een call houdt, wordt deze nog steeds weergegeven als ‘in a call’.

Vereisten

Zorg ervoor dat de volgende patches worden aangebracht op BroadWorks. Installeer alleen de patches die van toepassing zijn op uw release:

Voor R22:

  • AP.platform.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382362

  • AP.xsp.22.0.1123.ap382053

  • AP.xsp.22.0.1123.ap382362

  • AP.as.22.0.1123.ap383459

  • AP.as.22.0.1123.ap383520

Voor R23:

  • AP.platform.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382362

  • AP.as.23.0.1075.ap383459

  • AP.as.23.0.1075.ap383520

  • Als u XSP|ADP gebruikt:

    • AP.xsp.23.0.1075.ap382053

    • AP.xsp.23.0.1075.ap382362

  • Als u ADP gebruikt:

    • Xsi-acties-23_2022.01_1.200.bwar

    • Xsi-Events-23_2022.01_1.201.bwar (of hoger)

Voor R24:

  • AP.as.24.0.944.ap382053

  • AP.as.24.0.944.ap382362

  • AP.as.24.0.944.ap383459

  • AP.as.24.0.944. ap383520

  • Xsi-acties-24_2022.01_1.200.bwar

  • Xsi-Events-24_2022.01_1.201.bwar (of hoger)

Zorg ervoor dat de volgende configuratie tags zijn ingeschakeld op de Webex App:

  • <busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">

  • <display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>

  • <notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/> (deze tag is optioneel)

U moet de functie 101642 Enhanced Xsi Mechanism For Team Telephony activeren op de AS:

AS_CLI/System/ActivatableFeature> activate 101642

Inschakelen X-BroadWorks-Remote-Party-Info op de AS met behulp van het onderstaande CLI-commando, aangezien sommige SIP-oproepstromen deze functie vereisen:

AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Zorg ervoor dat de volgende diensten aan gebruikers worden toegewezen:

  • Wijs de Directed Call Pickup-service toe voor alle gebruikers

  • Stel het veld Bezet Lamp in voor gebruikers

Elke verwijzing naar XSP omvat XSP of ADP.

Bezig lampveld instellen op BroadWorks

Partnerbeheerders kunnen de volgende procedure gebruiken om het veld Bezet Lamp voor een gebruiker in te stellen.

  1. Meld je aan bij BroadWorks CommPilot.

  2. Ga voor een geselecteerde gebruiker naar Client Applications en configureer het veld Bezet Lamp.

  3. Voeg de URL toe van de BLF-lijst die opgevolgd zal worden.

  4. Gebruik de zoekparameters om gebruikers te vinden en toe te voegen aan de Monitored Users .

  5. Klik op OK.

Ondersteuning voor integratie van Slido

Webex voor Cisco BroadWorks ondersteunt de integratie van Webex App met Slido.

Slido is een gebruiksvriendelijke tool voor publieksbetrokkenheid. Het helpt mensen om meeste uit vergaderingen te halen door het gat tussen sprekers en hun publiek te vullen. Wanneer Slido is geïntegreerd in uw Control Hub-organisatie, kunnen uw gebruikers de Slido-app toevoegen aan hun vergaderingen in de Webex-app. Deze integratie voegt extra functionaliteit vraag en antwoord enquête toe aan de vergadering.

Voor meer informatie over het inzetten en gebruiken van Slido met de Webex-app, zie Slido integreren met de Webex-app.

Automatisch antwoord met toon

Met automatisch antwoord met toon, kunnen gebruikers een oproep doen vanuit een app van derden, zoals Contact Center, en de oproep wordt automatisch doorgestuurd via de Webex App op hun desktop. Wanneer de Webex App de andere partij belt, hoort de gebruiker een bepaalde toon en adviseert hij of zij dat de oproep verbinding maakt.

Voor een Webex for Cisco BroadWorks-gebruiker om deze functie te gebruiken:

  • De functie wordt alleen ondersteund op de primaire regel

  • De Webex-app moet het primaire lijnuiterlijk zijn

  • Het bericht %ENABLE_AUTO_ANSWER_WXT% tag moet ingeschakeld zijn

Als de gebruiker ook Shared Call Appearances heeft (bijvoorbeeld een bureautelefoon is geconfigureerd als een van de secundaire lijnappearances), wordt de functie nog steeds ondersteund op de primaire verschijning, zolang de shared call appearances zodanig zijn geconfigureerd dat ze geen inkomende oproepen ontvangen. Dit kan worden bereikt door een van de volgende drie voorwaarden te configureren op BroadWorks voor alle gedeelde oproepen:

  • Alert all appearances for Click-to-Dial calls is uitgeschakeld in de configuratie voor gedeelde oproepweergave - dit is de aanbevolen aanpak

    of

  • Allow Termination to this location moet uitgeschakeld zijn voor alle gedeelde oproepverschijningen of

    of

  • Locaties zijn uitgeschakeld voor alle gedeelde oproepen

Capaciteit verhogen

XSP|ADP Boerderijen

We raden u aan om de capaciteitsplanner te gebruiken om te bepalen hoeveel extra XSP|ADP-middelen u nodig hebt voor de voorgestelde verhoging van het aantal abonnees. Voor een van de speciale NPS of een speciaal Webex voor Cisco BroadWorks-team hebt u de volgende schaalbaarheidsopties:

  • Schaal specifiek bedrijf: Voeg een of meer XSP|ADP servers toe aan de boerderij die extra capaciteit nodig heeft. Installeer en activeer dezelfde set toepassingen en configuraties als de bestaande knooppunten van de server.

  • Specifieke boerderij toevoegen: Voeg een nieuwe, speciale XSP|ADP boerderij toe. U moet een nieuwe cluster en nieuwe sjablonen maken in Partner hub. Zo kunt u nieuwe klanten gaan toevoegen aan de nieuwe e-mail, zodat de bestaande versie wordt gedeeld.

  • Gespecialiseerde boerderij toevoegen: Als u problemen ondervindt voor een bepaalde dienst, wilt u misschien een aparte XSP|ADP-boerderij creëren voor dat doel, rekening houdend met de co-residency vereisten vermeld in dit document. Mogelijk moet u uw Control Hub-clusters en DNS-vermeldingen opnieuw configureren als u de URL wijzigt van de service met een nieuwe naam.

In alle gevallen is het controleren en opnieuw controleren van uw BroadWorks-omgeving uw verantwoordelijkheid. Als u Cisco-ondersteuning wenst in te zetten, kunt u contact opnemen met uw accountvertegenwoordiger, die professionele diensten kan regelen.

HTTP-servercertificaten beheren

U moet deze certificaten beheren voor mTLS geauthenticeerde webapplicaties op uw XSP|ADP's:

  • Onze keten van vertrouwenscertificaat van Webex Cloud

  • Certificaten van uw XSP|ADP HTTP server interfaces

Vertrouwensketen

U downloadt het certificaat van vertrouwensketen van Control Hub en installeert het op uw XSP|ADP's tijdens uw eerste configuratie. We verwachten het certificaat bij te werken voordat het verloopt en informeren u over hoe en wanneer het moet worden gewijzigd.

Uw HTTP-serverinterfaces

De XSP|ADP moet een publiek ondertekend servercertificaat voorleggen aan Webex, zoals beschreven in Order Certificates. Er wordt een zelf-ondertekend certificaat gegenereerd voor de interface wanneer u de interface voor het eerst beveiligt. Dit certificaat is geldig voor één jaar na die datum. U moet het zelf-ondertekende certificaat vervangen door een openbaar ondertekend certificaat. Het is uw verantwoordelijkheid om een nieuw certificaat aan te vragen voordat het verloopt.

Algemene instellingen voor groothandel

Beperkt door Partner Mode is een Partner Hub-instelling die partnerbeheerders kunnen toewijzen aan specifieke klantorganisaties om de organisatie-instellingen te beperken die klantbeheerders kunnen bijwerken in Control Hub. Wanneer deze instelling is ingeschakeld voor een bepaalde klantorganisatie, kunnen alle klantbeheerders van die organisatie, ongeacht hun functierechten, geen toegang krijgen tot een reeks beperkte controles in Control Hub. Alleen een partnerbeheerder kan de beperkte instellingen bijwerken.

Beperkt door partnermodus is een instelling op organisatieniveau in plaats van een rol. De instelling beperkt echter specifieke rolrechten voor klantenbeheerders in de organisatie waarop de instelling wordt toegepast.

Beperken op partnermodus

Klantbeheerders ontvangen een melding wanneer Restricted-by-Partner Mode wordt toegepast. Na het inloggen zien ze een meldingsbanner bovenaan het scherm, direct onder de header van de Control Hub. De banner informeert de beheerder van de klant dat Restricted Mode is ingeschakeld en dat hij sommige oproepinstellingen mogelijk niet kan bijwerken.

Voor een klantbeheerder in een organisatie waar Restricted by Partner Mode is ingeschakeld, wordt het toegangsniveau van de Control Hub bepaald met de volgende formule:

(Toegang Control Hub) = (Rechten Organisatierol) - (Beperkt door beperkingen partnermodus)

Klantbeheerders worden geconfronteerd met verschillende beperkingen, ongeacht de Restricted-by-Partner-modus. Deze beperkingen zijn onder meer:

  • Oproepinstellingen: De instellingen 'App Options Call Priority' in het menu Calling zijn alleen-lezen.
  • Locatie instellen: Het instellen van een oproep na het aanmaken van een locatie zal worden verborgen.
  • PSTN-beheer en oproepregistratie: Deze opties worden grijs weergegeven voor de locatie.
  • Telefoonnummerbeheer: In het menu Bellen is het telefoonnummerbeheer uitgeschakeld en zijn de instellingen 'App Opties Call Priority' en de oproepopnames alleen-lezen.

Beperkingen

Wanneer Restricted-by-Partner Mode is ingeschakeld voor een klantorganisatie, kunnen de klantbeheerders in die organisatie de volgende instellingen van de Control Hub niet gebruiken:

  • Op het tabblad Users view, de volgende instellingen zijn niet beschikbaar:

    • Manage Users De knop is grijs.

    • Manually Add or Modify Users—Geen optie om gebruikers toe te voegen of te wijzigen, hetzij handmatig of via CSV.

    • Claim Users—niet beschikbaar

    • Auto-assign Licenses—niet beschikbaar

    • Directory Synchronization—Kan de synchronisatie-instellingen van de map niet bewerken (deze instelling is alleen beschikbaar voor beheerders op partnerniveau).

    • User details—Gebruikersinstellingen zoals Voornaam, Achternaam, Weergavenaam en Primaire e-mail* zijn bewerkbaar.

    • Reset Package—Geen optie om het pakkettype te resetten.

    • Services bewerken—Geen optie om de services te bewerken die zijn ingeschakeld voor een gebruiker (bijv. Messages, Meetings, Calling)

    • Status Services bekijken—Kan de volledige status van Hybrid Services of Software Upgrade Channel

    • Primary Work Number—Dit veld is alleen-lezen.

  • Op het tabblad Account view, de volgende instelling is niet beschikbaar:

    • Company Name is alleen-lezen.

  • Op het tabblad Security view, de volgende instelling is niet beschikbaar:

    • Authentication—Geen optie om authenticatie- en SSO-instellingen te bewerken.

  • Op het tabblad Organization Settings view, de volgende instellingen zijn niet beschikbaar:

    • Domain—Toegang is alleen-lezen.

    • Email—De Suppress Admin Invite Email en Email Locale Selection instellingen zijn alleen-lezen.

  • Op het tabblad Calling menu, de volgende instellingen zijn niet beschikbaar:

    • Call Settings—De App Options Call Priority instellingen zijn alleen-lezen.

    • Calling Behavior—Instellingen zijn alleen-lezen.

    • Location > PSTN—De opties Local Gateway en Cisco PSTN zijn verborgen.

  • Voer uw naam en e-mailadres in onder SERVICESDe Migrations en Connected UC service opties worden onderdrukt.

Beperkt door partnermodus inschakelen

Partnerbeheerders kunnen de onderstaande procedure gebruiken om Allow restricted by partner mode voor een bepaalde klantorganisatie (de standaardinstelling is ingeschakeld).

  1. Meld u aan bij Partner Hub ( https://admin.webex.com) en selecteer Customers.

  2. Selecteer de toepasselijke klantorganisatie.

  3. Op het tabblad Wholesale general settings sectie, schakel de Allow restrict by partner mode toggle om de instelling aan te zetten.

    Als u wilt draaien Allow restrict by partner mode uit, schakel de schakelaar uit.

Als de partner de beperkte beheerdersmodus voor een klantbeheerder verwijdert, kan de klantbeheerder het volgende uitvoeren:

  • Webex voor Wholesale-gebruikers toevoegen (met de knop)

  • Pakketten voor een gebruiker wijzigen

Tijdzones voor groothandelsvoorziening

Voor meer informatie over de lijst van ondersteunde tijdzones voor Wholesale Provisioning, zie Lijst van ondersteunde tijdzones voor groothandelsvoorziening.

Partner Analytics

Verbeteringen in Control Hub maken het partnerbeheerders gemakkelijk pakketinformatie namens hun gebruikers te bekijken en bij te werken. Deze functie biedt partners de mogelijkheid een geaggregeerde weergave bij alle klanten te krijgen en bevat de volgende details:

  • Totaal aantal gebruikers per pakket (Softphone, Basis, Standaard, Premium)

  • Trend gebruiker per pakket (dagelijks/wekelijks/maandelijks)

  • Klanten met het aantal toegewezen pakketten

Voor meer informatie over het gebruik van Partner Analytics, zie het Webex-artikel Analytics voor Webex voor Wholesale en Webex voor Broadworks pakketten in Partner Hub.

API's facturatierapport

Webex for Developers biedt publieke API's die kunnen worden gebruikt voor maandelijkse factureringsrapporten. Partnerbeheerders kunnen deze API's gebruiken om facturatierapporten te maken, te lijsten, te krijgen en te verwijderen. De volgende tabel geeft een overzicht van de API’s, het type toegang dat vereist is en de rolvereisten.

Facturatie-API

Purpose

Type toegang

Rolvereiste voor API

(Beheerder vereist minstens één van deze rollen)

Maak een BroadWorks Billing Report

Wordt gebruikt om een facturatierapport te genereren.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

Lijst facturatierapporten van BroadWorks

Gebruikt om een lijst te maken van de rapporten die beschikbaar zijn om te bekijken.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Krijg een BroadWorks Billing Report

Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks Billing Report verwijderen

Wordt gebruikt om een gegenereerd rapport te verwijderen.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

Facturatievelden

De volgende tabel geeft een overzicht van de velden in het gegenereerde rapport.

Veld

Beschrijving

resellerNaam

Naam partner of organisatie-ID partner

billingId

Uniek factuurnummer of C-nummer van de partner

spEnterpriseId

De door de dienstverlener verstrekte unieke identificatiecode voor de onderneming van de abonnee.

Intern

De interne teststatus van de klant (ja/nee)

gebruikerID

De userID van de abonnee op BroadWorks

abonneeId

Een unieke identificatiecode voor de betrokken abonnee in Webex

zelfGeactiveerd

Ja/Nee

eersteStartdatum

Datum waarop de abonnee werd voorzien.

billingStartDate

Datum waarop de facturering in deze maand begint

billingEndDate

Datum waarop facturering eindigt in deze maand

pakket

Het pakkettype dat wordt opgeladen

hoeveelheid

Geprorateerde hoeveelheid voor facturatie.

  • 1—geeft een volledige maand aan

  • Zodra u een facturatierapport voor een bepaalde periode hebt gegenereerd, kunt u dat rapport niet opnieuw genereren tenzij u het bestaande rapport eerst verwijdert.

  • Als u het pakkettype of BroadWorks userID voor een bepaalde gebruiker wijzigt, toont het rapport voor de maand waarin de wijziging plaatsvond meerdere boekingen voor die gebruiker met afzonderlijke geprorateerde boekingen voor en na de wijziging.

Problemen met Webex voor Cisco BroadWorks oplossen

Abonneren op de pagina Webex-status

Eerste controle https://status.webex.comwanneer u een onverwachte onderbreking van de dienstverlening ervaart. Als u uw configuratie in Control Hub of BroadWorks niet hebt gewijzigd vóór de onderbreking, controleert u de statuspagina. Lees meer over het aanmelden voor status- en incidentmeldingen op Webex Helpcentrum.

Control Hub-analyses gebruiken

Webex houdt gebruiks- en kwaliteitsgegevens bij van uw organisatie en van de organisaties van uw klant. Lees meer over de Beheer Hub Analytics op Webex Help Center.

Netwerkproblemen

Klanten of gebruikers worden niet aangemaakt in de Control Hub met flowthrough provisioning:

  • Kan de toepassingsserver de inrichtings-URL bereiken?

  • Zijn de inrichtingsaccount en het wachtwoord juist, bestaat die account in BroadWorks?

Clusters mislukken consistent met verbindingstests:

De mTLS-verbinding met de authenticatieservice zal naar verwachting mislukken wanneer u de eerste cluster in Partner Hub aanmaakt, omdat u de cluster moet aanmaken om toegang te krijgen tot de Webex-certificaatketen. Zonder dat kunt u geen vertrouwensanker maken op de authenticatiedienst XSP|ADP's, dus de test mTLS-verbinding van Partner Hub is niet succesvol.

  • Zijn de XSP|ADP interfaces openbaar toegankelijk?

  • Gebruikt u de juiste poorten? U kunt een poort invoeren in de interfacedefinitie van het cluster.

Interfaces die mislukken bij validatie

Xsi-Acties en Xsi-Events-interfaces:

  • Controleer of de interface-URL's juist zijn ingevoerd in het cluster in Partner Hub, waaronder de /v2.0 aan het einde van de URL's.

  • Controleer de firewall om communicatie tussen Webex en deze interfaces mogelijk te maken.

  • Bekijk het advies voor interfaceconfiguratie in dit document.

Verificatieservice-interface:

  • Controleer of de interface-URL's juist zijn ingevoerd in het cluster in Partner Hub, waaronder de /v2.0 aan het einde van de URL's.

  • Controleer de firewall om communicatie tussen Webex en deze interfaces mogelijk te maken.

  • Bekijk in dit document het advies over interfaceconfiguratie, met speciale aandacht voor:

    1. Zorg ervoor dat je RSA-sleutels gedeeld hebt over alle XSP|ADP's.

    2. Zorg ervoor dat u AuthService URL aan de webcontainer op alle XSP|ADP's hebt verstrekt.

    3. Als u de TLS-codeconfiguratie hebt bewerkt, controleert u of u de juiste naamgevingsconventsie hebt gebruikt. De XSP|ADP vereist dat u het IANA-naamformaat voor de TLS-cijfers invoert. Een eerdere versie van dit document bevat onjuist de vereiste versleutelingssuites in de OpenSSL-naamgevingsconventie.

    4. Als u mTLS met Authentication Service gebruikt, worden de Webex client certificaten geladen in uw XSP|ADP/ADP trust store? Is de app (of de interface) geconfigureerd om clientcertificaten te vereisen?

    5. Als u CI-token validatie gebruikt met de verificatiedienst, is de app (of interface) dan geconfigureerd om geen cliëntcertificaten te vereisen?

Problemen met client

Controleer of de client is verbonden met BroadWorks

  1. Meld je aan bij de Webex-app.

  2. Controleer of het pictogram Belopties (een handset met een apparaat erboven) op de zijbalk staat.

    Als het pictogram niet aanwezig is, is het mogelijk dat de gebruiker nog niet is ingeschakeld voor de oproepdienst in de Control Hub.

  3. Open de Settings/Preferences menu en ga naar de Phone Services . U moet de status zien SSO Session You're signed in.

    Als een andere telefoondienst, zoals Webex Calling, wordt getoond, gebruikt de gebruiker Webex niet voor Cisco BroadWorks.

Deze verificatie betekent:

  • De klant heeft met succes de vereiste microservices van Webex getransforceerd.

  • De gebruiker heeft zich geverifieerd.

  • De client is uitgegeven een lang-goed JSON-web token door uw BroadWorks-systeem.

  • De client heeft het apparaatprofiel opgehaald en heeft zich geregistreerd bij BroadWorks.

Clientlogboeken

Alle Webex App-clients kunnen Logs Verzenden naar Webex. Dit is de beste optie voor mobiele clients. U moet ook het e-mailadres van de gebruiker registreren en het geschatte tijdstip waarop het probleem zich voordeed als u hulp zoekt van TAC. Voor meer informatie, zie Waar vind ik ondersteuning voor Webex?

Als u handmatig logbestanden van een Windows-pc moet verzamelen, vindt u deze als volgt:

Windows-pc: C:\Users\{username}\AppData\Local\CiscoSpark

Mac: /Users/{username}/Library/Logs/SparkMacDesktop

current_log.txt bevat ook de BWC-gerelateerde logboeken.

Problemen met aanmelden gebruiker

MTLS-auth onjuist geconfigureerd

Als dit voor alle gebruikers van invloed is, controleert u de mTLS-verbinding van Webex naar de URL van uw verificatieservice:

  • Controleer of de verificatieservicetoepassing of de interface die wordt gebruikt, zijn geconfigureerd voor mTLS.

  • Controleer of de Webex-certificaatketen is geïnstalleerd als een vertrouwensankers.

  • Controleer of het servercertificaat in de interface/toepassing geldig is en is ondertekend door een bekende CA.

Bericht over licentie-uitval

Dit bericht kan voor een klant worden weergegeven in de klantenweergave van Partner Hub. Dit bericht wordt weergegeven als het licentiegebruik de licentie overschrijdt die de licentie toestaat. Het bericht kan worden genegeerd.

Handleiding voor probleemoplossing

Voor gedetailleerde informatie over het oplossen van problemen met Webex voor Cisco BroadWorks, zie de Webex voor Cisco BroadWorks Handleiding voor het oplossen van problemen.

Ondersteuning

Stabiele status ondersteuningsbeleid

De serviceprovider is het eerste contactpunt voor de ondersteuning voor de eindklant (enterprise) Escaleren van problemen die de SP niet kan oplossen naar TAC. Ondersteuning voor de versie van de BroadWorks-server volgt het BroadSoft-beleid van de huidige versie en twee eerdere grote versies (N-2). Lees meer op BroadSoft producten lifecycle beleidsectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.

Escalatiebeleid

  • U (serviceprovider/Partner) is het eerste contactpunt voor ondersteuning voor eindgebruikers (enterprise)

  • Problemen die niet door de SP kunnen worden opgelost, worden naar TAC geëscaleerd.

BroadWorks-versies

Zelfondersteuningsresources

  • Gebruikers kunnen ondersteuning vinden via het Webex Helpcentrum, waar er een Webex voor Cisco BroadWorks-specifieke pagina is met algemene onderwerpen over de Webex-app en ondersteuning.

  • De Webex-app kan worden aangepast met deze Help-URL en een URL voor probleemrapport.

  • Gebruikers van de Webex-app kunnen feedback of logboeken rechtstreeks vanaf de client verzenden. De logboeken gaan naar de Webex-cloud, waar ze kunnen worden geanalyseerd door Webex DevOps.

  • We hebben ook een Helpcentrum-pagina toegewezen aan Help op beheerdersniveau voor Webex voor Cisco BroadWorks.

Informatie verzamelen voor het indienen van een serviceverzoek

Als u fouten ziet in Control Hub, hebben deze mogelijk bijgevoegde informatie die TAC kan helpen uw probleem te onderzoeken. Als u bijvoorbeeld een traceer-id voor een bepaalde fout of een foutcode ziet, sla dan de tekst op die u met ons wilt delen.

Probeer ten minste de volgende informatie op te nemen wanneer u een query indient of een case opent:

  • ID klantorganisatie en ID partnerorganisatie (elk ID is een reeks 32 zescijferige cijfers, gescheiden door koppeltekens)

  • TrackingID (ook een 32 hex-cijferige tekenreeks) als de interface of foutmelding een

  • E-mailadres gebruiker (als een bepaalde gebruiker problemen ondervindt)

  • Clientversies (als het probleem symptomen heeft opgemerkt via de client)

Webex voor BroadWorks-referentie

UC-One SaaS-vergelijking met Webex voor Cisco BroadWorks

Oplossing >

UC-One SaaS

Webex voor Cisco BroadWorks

Cloud

Cisco UC-One Cloud (GCP)

Webex Cloud (AWS)

Clients

UC-One: Mobiel, desktop

Receptionist, Supervisor

Webex: Vergaderen Mobiel, desktop, web

Groot technologisch verschil

Vergaderingen geleverd op Broadsoft Meet Technology

Vergaderingen geleverd op Webex Meetings-technologie

Vroege proefversies van velden

Faseringsomgeving, bèta-clients

Productieomgeving, GA-clients

Gebruikersidentiteit

BroadWorks-id kan worden gebruikt als primaire id, tenzij serviceprovider al SSO-integratie heeft gebruikt.

 

Gebruikers-id en geheim in BroadWorks

E-mail-id in Cisco CI dient als primaire id

SSO in serviceprovider BroadWorks waarbij de gebruiker zich verifieert met de gebruikers-id van BroadWorks en broadWorks-geheim op tijd.

 

Gebruiker levert aanmeldgegevens via SSO BroadWorks en geheim in BroadWorks

OF

Gebruikers-id en geheim in CI IdP

OF

Gebruikers-id in CI, id en geheimen in IdP

Clientverificatie

Gebruikers geven aanmeldgegevens op via client

BroadWorks lange- of lange tokens vereist bij gebruik van Webex-berichten

Gebruikers geven referenties via de browser op (aanmeldpagina van Webex BIdP-proxy of CI)

Toegangstokens voor Webex en verversen

Beheer/configuratie

Uw OSS/BSS-systemen en

Resellerportal

Uw OSS/BSS-systemen en Control Hub

Partner/serviceprovider activeren

Eén keer ingesteld door Cisco Operations

Eén keer ingesteld door Cisco Operations

Klant/zakelijk activeren

Resellerportal

Control Hub

Automatisch gemaakt bij eerste gebruikersinschrijving

Activeringsopties voor gebruikers

Zelf ingeschreven

Externe IM&P instellen in BroadWorks

Geïntegreerde IM&P instellen in BroadWorks (meestal ondernemingen)

XSP|ADP service interfaces

XSI-acties

 

XSI-Gebeurtenissen

CTI (mTLS)

AuthService (mTLS optioneel)

DMS

XSI-acties

XSI-Acties (mTLS)

XSI-Gebeurtenissen

CTI (mTLS)

AuthService (TLS)

DMS

Webex installeren en aanmelden (abonnee perspectief)

1

Download en installeer Webex. Voor meer informatie, zie Webex | Download de app.

2

Voer Webex uit.

Webex vraagt u om uw e-mailadres.
3

Voer uw e-mailadres in en klik op Next.

4

Een van de volgende dingen gebeurt, afhankelijk van de manier waarop uw organisatie is geconfigureerd in Webex:

  1. Webex start een browser op voor u om de verificatie te voltooien bij uw identiteitsprovider. Dit kan multi-bepalende verificatie (MFA) zijn.

  2. Webex start een browser voor u om uw BroadWorks-Gebruikers-id en wachtwoord in te voeren.

Webex wordt geladen nadat u zich hebt geverifieerd tegen de IdP of BroadWorks.

Gegevens exchange en opslag

Deze gedeelten bieden details over de gegevens exchange en opslag met Webex. Alle gegevens worden zowel tijdens de overdracht als in de rest gecodeerd. Voor meer informatie, zie Webex-app-beveiliging.

serviceprovider onboarding

Wanneer u clusters en gebruikerssjablonen configureert in Webex Control Hub tijdens serviceprovider onboarding, wisselt u de volgende BroadWorks-gegevens uit die Webex op slaat:

  • URL Xsi-acties

  • Xsi-Events URL

  • URL CTI-interface

  • URL verificatieservice

  • BroadWorks-provisioning-adaptorreferenties

serviceprovider voor gebruikers

Deze tabel bevat gebruikers- en bedrijfsgegevens die worden uitgewisseld als onderdeel van gebruikersvoorzieningen via de Webex-API's.

Gegevens die naar Webex gaan

Van

Door

Opgeslagen door Webex?

BroadWorks UserID

BroadWorks, op API

Webex-API's

Ja

E-mail (indien SP opgegeven)

BroadWorks, op API

Webex-API's

Ja

E-mail (indien door gebruiker verstrekt)

Gebruiker

Portal voor gebruikersactivering

Ja

Voornaam

BroadWorks, op API

Webex-API's

Ja

Achternaam

BroadWorks, op API

Webex-API's

Ja

Primair telefoonnummer

BroadWorks, op API

Webex-API's

Ja

Mobiel telefoonnummer

BroadWorks, op API

Webex-API's

Ja

Primair toestel

BroadWorks, op API

Webex-API's

Ja

BroadWorks serviceprovider ID & groeps-id

BroadWorks, op API

Webex-API's

Ja

Taal

BroadWorks, op API

Webex-API's

Ja

Tijdzone

BroadWorks, op API

Webex-API's

Ja

Gebruikers verwijderen

Webex voor Cisco BroadWorks-API's ondersteunen zowel gedeeltelijke verwijdering van als volledige verwijdering van gebruikers. Deze tabel bevat alle gebruikersgegevens die tijdens de inrichting worden opgeslagen en wat in elk scenario wordt verwijderd.

Gebruikersgegevens

Gedeeltelijk verwijderen

Volledige verwijdering

BroadWorks UserID

Ja

Ja

E-mailadres

Nee

Ja

Voornaam

Nee

Ja

Achternaam

Nee

Ja

Primair telefoonnummer

Ja

Ja

Mobiel telefoonnummer

Ja

Ja

Extensie

Ja

Ja

BroadWorks serviceprovider ID & groeps-id

Ja

Ja

Taal

Nee

Ja

Gebruiker aanmelden en configuratie ophalen

Webex-verificatie

Webex authentication verwijst naar gebruikersaanmelding bij een Webex-app door een van de Webex-ondersteuningsauthenticatiemechanismen. ( BroadWorks authentication wordt afzonderlijk gedekt.) In deze tabel wordt het type gegevens geïllustreerd dat wordt uitgewisseld tussen de verschillende componenten in de verificatiestroom.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via Webex-app

Webex

Beperkte toegang token en (onafhankelijke) IdP-URL

Webex

Gebruikersbrowser

Gebruikersgegevens

Gebruikersbrowser

Identiteitsprovider (die al gebruikersidentiteit heeft)

SAML-bevestiging

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Toegang tot en vernieuwen tokens

Webex

Gebruikersbrowser

Toegang tot en vernieuwen tokens

Gebruikersbrowser

Webex-app

BroadWorks-verificatie

BroadWorks authentication verwijst naar gebruikersaanmelding bij een Webex-app met behulp van hun BroadWorks-inloggegevens. In deze tabel wordt het type gegevens geïllustreerd dat wordt uitgewisseld tussen de verschillende componenten in de verificatiestroom.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via Webex-app

Webex

Beperkte toegang token en IdP-URL (Webex Bwks IdP-proxy)

Webex

Gebruikersbrowser

Brandinggegevens en BroadWorks-URL's

Webex

Gebruikersbrowser

BroadWorks-gebruikersgegevens

Gebruiker via browser (aanmeldingspagina met branding die door Webex wordt gebruikt)

Webex

BroadWorks-gebruikersgegevens

Webex

BroadWorks

BroadWorks-gebruikersprofiel

BroadWorks

Webex

SAML-bevestiging

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Toegang tot en vernieuwen tokens

Webex

Gebruikersbrowser

Toegang tot en vernieuwen tokens

Gebruikersbrowser

Webex-app

BroadWorks Password Expiration Notification Tijdens Login

Deze functie verbetert het aanmeldproces en regelt de aanmeldstroom op basis van:

Waarschuwing voor aanmelden en verbetering van foutmeldingen:

  • Op dit moment krijgen de Wexbex voor BWKS-gebruikers die BroadWorks-authenticatie gebruiken en inloggen via het UAP geen melding dat hun wachtwoord op het punt staat te vervallen of dat ze niet kunnen inloggen omdat het wachtwoord al is verlopen. Als het wachtwoord in 10 dagen of minder zal verlopen, krijgt de gebruiker een waarschuwing dat het wachtwoord zal verlopen met vermelding van hoeveel dagen er nog over zijn, en wordt de gebruiker geadviseerd contact op te nemen met de partner of de link Wachtwoord vergeten op het aanmeldscherm te volgen om zijn wachtwoord opnieuw in te stellen.
  • Als het wachtwoord is verlopen en de configuratie in BroadWorks ‘enforcePasswordChangeOnExpiry’ is ingesteld op waar dan is fout ‘incorrect username and password’ gegooid, maar nu met deze functie wordt de foutmelding verbeterd: De aanmeldpoging is mislukt. De combinatie van de Gebruikers-ID en het verstrekte wachtwoord komt niet overeen met onze gegevens of uw wachtwoord moet worden bijgewerkt. Probeer het opnieuw of neem contact op met uw beheerder om het wachtwoord bij te werken. Foutcode 100006

Aanmeldingsstroom instellen:

  • De partner kan de login beperken door een instelling “w4bwks-password-expiry-fail-login” in te schakelen. Deze instelling "kan door Cisco worden ingeschakeld op verzoek van een partner. Als het wachtwoord van BroadWorks is verlopen, is de configuratie in BroadWorks ‘enforcePasswordChangeOnExpiry’ op onwaar gezet en is de instelling ‘w4bwks-password-expiry-fail-login’ geactiveerd, dan wordt er een fout gegooid waarbij het wachtwoord x dagen geleden is verlopen, terwijl als de instelling uitgeschakeld is, inloggen toegestaan is. Standaard is de instelling uitgeschakeld.

De link Wachtwoord vergeten op de aanmeldpagina kan door de partner worden geconfigureerd als onderdeel van Custom Branding: Geavanceerde aanpassing. Partners moeten de link configureren om gebruikers door te verwijzen naar het partnerportaal voor wachtwoordbeheer en reset.

Deze functie verbetert de login-ervaring van de gebruiker tijdens het inloggen van de geactiveerde gebruiker alleen wanneer het wachtwoord op het punt staat te vervallen of al is verlopen. De functie werkt niet als een wachtwoord verloopt terwijl de gebruiker is ingelogd in de Webex-app. De gebruiker krijgt een melding voor het vervallen van het wachtwoord bij de volgende inlogpoging.

Clientconfiguratie ophalen

In deze tabel wordt bij het ophalen van clientconfiguraties weer wat het type gegevens is dat tussen de verschillende componenten wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

Registratie

Client

Webex

Organisatie-instellingen, inclusief BroadWorks-URL's

Webex

Client

BroadWorks JWT-token

BroadWorks via Webex

Client

BroadWorks JWT-token

Client

BroadWorks

Apparaat token

BroadWorks

Client

Apparaat token

Client

BroadWorks

Configuratiebestand

BroadWorks

Client

Stabiele statusgebruik

In dit gedeelte worden de gegevens beschreven die zich tussen componenten verplaatsen tijdens de herverificatie na het verlopen van het token, via BroadWorks of Webex.

Deze tabel toont gegevensbeweging voor bellen.

Gegevens verplaatsen

Van

Doel

SIP-signalering

Client

BroadWorks

SRTP-media

Client

BroadWorks

SIP-signalering

BroadWorks

Client

SRTP-media

BroadWorks

Client

In deze tabel worden de gegevensbeweging voor berichten, aanwezigheid en vergaderingen vermeld.

Gegevens verplaatsen

Van

Doel

HTTPS REST-berichten en -aanwezigheid

Client

Webex

HTTPS REST-berichten en -aanwezigheid

Webex

Client

SIP-signalering

Client

Webex

SRTP-media

Client

Webex

SIP-signalering

Webex

Client

SRTP-media

Webex

Client

De Provisioning API gebruiken

Toegang voor ontwikkelaars

De API-specificatie is beschikbaar op https://developer.webex.comen een gids om het te gebruiken is op https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

U moet zich aanmelden om de API-specificatie te lezen op https://developer.webex.com/docs/api/v1/broadworks-abonnees.

Toepassingsverificatie en -autorisatie

Uw applicatie integreert met Webex als een Integration. Met dit mechanisme kan de toepassing beheertaken (zoals abonnee-provisioning) uitvoeren voor een beheerder binnen uw partnerorganisatie.

Webex API's volgen de OAuth 2standaard ( http://oauth.net/2/). Met OAuth 2 kunnen integraties van derden vernieuwingen en toegang krijgen tot tokens namens de door u gekozen partnerbeheerder voor het verifiëren van API-oproepen.

U moet uw integratie met Webex eerst registreren. Na registratie moet uw aanvraag deze OAuth 2.0 autorisatiesubsidiestroom ondersteunen om de nodige vernieuwings- en toegangscodes te verkrijgen.

Voor meer informatie over integraties en hoe deze OAuth te bouwen 2autorisatiestroom in uw toepassing, zie https://developer.webex.com/docs/integrations.

Er zijn twee vereiste rollen om integraties te implementeren - de ontwikkelaar en de autoriserende gebruiker - en ze kunnen door afzonderlijke mensen/teams in uw omgeving worden vervuld.

  • De ontwikkelaar maakt de app en registreert deze op https://developer.webex.com om de vereiste OAuth ClientID/Secret te genereren met verwachte scopes voor de toepassing. Als uw toepassing door een derde partij wordt gemaakt, kan deze de toepassing registreren (als u toegang hebt aangevraagd). U kunt dit ook zelf doen.

  • De autoriserende gebruiker is het account dat de applicatie gebruikt om zijn API-oproepen te autoriseren, om uw partnerorganisatie, de organisaties van uw klanten of hun abonnees te wijzigen. Voor dit account moet de rol Volledige beheerder of Volledige verkoopbeheerder zijn in uw partnerorganisatie. Deze account mag niet worden gehouden door een derde partij.

Naam organisatie

De organisatienaam hangt af van welke provisioningmodus u gebruikt:

  • Enterprise mode—De Organization Name is een exacte match van spEnterpriseId.

  • Serviceprovider-modus—De organisatienaam is het groupID-gedeelte van de spEnterpriseId.

De organisatienaam bevat alle witruimte, hoofdletters en speciale tekens die in de originele spEnterpriseId zijn gespecificeerd.

BroadWorks-softwarevereisten

Zie Levenscyclusbeheer - BroadSoft Servers.

We verwachten dat de Service Provider "patch current" is met de nieuwste BroadWorks patches en Release Independent (RI) apps. De volgende lijst met patches is de minimale vereiste voor integratie met Webex.

Controleer de patchnotities voor deze softwarepatches. Sommige patches kunnen aanvullende CLI-vereisten hebben.

Versie R22

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.22.0.1123.ap364260

AP.as.22.0.1123.ap365173

AP.as.22.0.1123.ap368517

Vereist voor Directory Sync

AP.as.22.0.1123.ap369763

AP.as.22.0.1123.ap372989

AP.as.22.0.1123.ap372757

AP.as.22.0.1123.ap372963

Vereist om te upgraden van V1 naar V2 Push Notifications

AP.as.22.0.1123.ap373197

Vereiste patch voor applicatieserver

AP.as.22.0.1123.ap378391

AP.as.22.0.1123.ap374793

Vereist om te upgraden van V1 naar V2 Push Notifications

AP.as.22.0.1123.ap377718

Vereiste patch voor functie Call Recording

AP.as.22.0.1123.ap377868

AP.as.22.0.1123.ap376508

Vereiste pleister voor doorstroomvoorziening

AP.xsp.22.0.1123.ap378585

Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis

Profielserver

AP.ps.22.0.1123.ap372989

AP.ps.22.0.1123.ap372757

AP.ps.22.0.1123.ap378391

AP.ps.22.0.1123.ap378585

Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis

Platform

AP.platform.22.0.1123.ap353577

AP.platform.22.0.1123.ap354313

Vereist voor NPS-authenticatieproxy

AP.platform.22.0.1123.ap365173

AP.platform.22.0.1123.ap367732

AP.platform.22.0.1123.ap369433

AP.platform.22.0.1123.ap369607

Vereist voor NPS-authenticatieproxy

AP.platform.22.0.1123.ap372757

AP.platform.22.0.1123.ap376508

Vereist voor de Auth-service met CI-token validatie

AP.platform.22.0.1123.ap378585

Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis

GEBRUIKER: XSP|ADP

AP.xsp.22.0.1123.ap354313

Vereist voor NPS-authenticatieproxy

AP.xsp.22.0.1123.ap365173

AP.xsp.22.0.1123.ap368067

AP.xsp.22.0.1123.ap368601

Vereist voor de Auth-service met CI-token validatie

AP.xsp.22.0.1123.ap369607

Vereist voor NPS-authenticatieproxy

AP.xsp.22.0.1123.ap370952

AP.xsp.22.0.1123.ap373008

AP.xsp.22.0.1123.ap372757

AP.xsp.22.0.1123.ap372433

AP.xsp.22.0.1123.ap372963

Vereist om te upgraden van V1 naar V2 Push Notifications

AP.xsp.22.0.1123.ap378391

AP.xsp.22.0.1123.ap374677

Vereist voor NPS-authenticatieproxy

AP.xsp.22.0.1123.ap375206

Vereist voor NPS-authenticatieproxy

AP.xsp.22.0.1123.ap376508

Vereist voor de Auth-service met CI-token validatie

AP.xsp.22.0.1123.ap378585

Vereist voor Unified Call History

Overig

AP.xsa.22.0.1123.ap372757

AP.xs.22.0.1123.ap372757

AP.ums.22.0.1123.ap378391

AP.nfm.22.0.1123.ap378391

Versie R23

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.23.0.1075.ap368517

Vereist voor Directory Sync

AP.as.23.0.1075.ap369763

AP.as.23.0.1075.ap373197

Configuratie-app-server

AP.as.23.0.1075.ap373271

Vereist om te upgraden van V1 naar V2 Push Notifications

AP.as.23.0.1075.ap378391

AP.as.23.0.1075.ap376509

AP.as.23.0.1075.ap377718

Vereist voor oproepregistratie

AP.as.23.0.1075.ap377868

AP.as.23.0.1075.ap378585

Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis

Profielserver

AP.ps.23.0.1075.ap378391

Platform

AP.platform.23.0.1075.ap367732

AP.platform.23.0.1075.ap370952

AP.platform.23.0.1075.ap369607

Vereist voor NPS-authenticatieproxy

AP.platform.23.0.1075.ap376509

AP.platform.23.0.1075.ap378585

Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis

GEBRUIKER: XSP|ADP

AP.xsp.23.0.1075.ap368067

AP.xsp.23.0.1075.ap369607

Vereist voor NPS-authenticatieproxy

AP.xsp.23.0.1075.ap370952

AP.xsp.23.0.1075.ap373008

AP.xsp.23.0.1075.ap373271

Vereist om te upgraden van V1 naar V2 Push Notifications

AP.xsp.23.0.1075.ap378391

AP.xsp.23.0.1075.ap374677

Vereist voor NPS-authenticatieproxy

AP.xsp.23.0.1075.ap375206

Vereist voor NPS-authenticatieproxy

AP.xsp.23.0.1075.ap376509

AP.xsp.23.0.1075.ap378585

Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis

Overig

Als u ADP gebruikt...

Xsi-gebeurtenissen-23_2021.05_1.251.bwar

Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis

Versie R24

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.24.0.944.ap384177

Vereist voor Unified Messaging Server (UMS)

AP.as.24.0.944.ap375100

Vereist voor doorstroomvoorziening

AP.as.24.0.944.ap377718

Vereist voor oproepregistratie

AP.as.24.0.944.ap377868

AP.as.24.0.944.ap378585

Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis

Overig

Xsi-gebeurtenissen-24_2021.05_1.251.bwar

Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis

Gebruikersvoorzieningen en activeringsstromen

Provisioning beschrijft het toevoegen van de gebruiker aan Webex. Activation inclusief e-mailvalidatie en servicetoewijzing in Webex.

E-mailadressen van gebruikers moeten uniek zijn omdat Webex het e-mailadres gebruikt om een gebruiker te identificeren. Als u vertrouwde e-mailadressen voor de gebruikers hebt, kunt u ervoor kiezen om deze automatisch te activeren wanneer u ze automatisch inrichten. Dit proces is 'automatische provisioning en automatische activering'.

Geautomatiseerde gebruikersvoorzieningen en automatische activering (vertrouwde e-mailstroom)

Diagram of Automated User Provisioning and Automatic Activation Trusted Email Flow

Voorwaarden

  • Uw inrichtingsadapter wijst naar Webex voor Cisco BroadWorks (wat een uitgaande verbinding van AS naar Webex Provisioning Bridge vereist).

  • U moet geldige, bereikbare e-mailadressen voor eindgebruikers als alternatieve ip-adressen in BroadWorks hebben.

  • Control Hub heeft een inrichtingsaccount in de configuratie van uw partnerorganisatie.

Stap

Beschrijving

1

U offertet en neemt bestellingen voor de service over aan uw klanten.

2

U verwerkt de bestelling van de klant en provisiont de klant in uw systemen.

3

Het service provisioning-systeem activeert de inrichting van BroadWorks. Met deze stap maakt u, samenvattend, het bedrijf en de gebruikers. Vervolgens worden de benodigde services en nummers toegewezen aan elke gebruiker. Een van deze services is de externe chatservice.

4

Deze provisioningsstap leidt tot de automatische inrichting van de klantorganisatie en gebruikers in Webex. (Met de servicetoewijzing via IM&P wordt de Webex-inrichtings-API aangeroepen door de inrichtingsadapter voor Webex.

5

Uw systemen moeten de Webex-inrichtings-API gebruiken als u het pakket later voor de gebruiker moet aanpassen (om de standaard-API te wijzigen).

SSO aanmeldingsgegevens

Diagram of SAML SSO Login Flow with Direct BroadWorks Authentication (Cross-Origin Resource Sharing)
SAML SSO Login Flow met Direct BroadWorks Authenticatie (Cross-Origin Resource Sharing)

Hierna volgt de SAML SSO aanmelding voor de Webex-app bij gebruik van BroadWorks-verificatie en wanneer Cross-Origin Resource Sharing is ingeschakeld, waardoor directe verificatie bij BroadWorks mogelijk is. Op de afbeelding worden de client- en gebruikersgebeurtenissen links weergegeven met tekst op de pijlen die staan voor wat de client voor autorisatie levert. Stappen 1 en 5 zijn gebruikersevenementen. Rechts op de afbeelding wordt de gebeurtenissen van de aanmeldservice vertegenwoordigd naast de gebeurtenissen die naar de client worden geretourneerd.

Diagram of Webex SSO login flow (with Broadworks authentication and cross-origin resource sharing)
BroadWorks registratie en service Discovery Flow

Hierna volgt de BroadWorks-servicedetectieflow die direct volgt van de voorafgaande Webex SAML SSO aanmeldingsflow. De client maakt gebruik van het toegangs token dat is verkregen bij het registreren bij Webex-apparaatbeheer om registratie bij de BroadWorks-implementatie aan te vragen.

Diagram of Broadworls registration and service discovery flow

Alternatieve manier van aanmelden

De bovenstaande afbeeldingen gaan ervan uit dat SAML SSO Login is geconfigureerd met BroadWorks-verificatie met directe BroadWorks-verificatie ingeschakeld (Cross-Origin Resource Sharing). Hieronder vindt u enkele alternatieve SAML SSO aanmeldingsstromen:

  • BroadWorks-verificatie zonder directe BroadWorks-verificatie (Cross-Origin Resource Sharing):

    • Het enige verschil zit in stap 5 en 6 van de Webex Login Flow. In stap 5 worden de inloggegevens gevalideerd door de IdP-proxy (in plaats van XSI) en wordt een SAML-bewering teruggestuurd naar de client.

    • De flow gaat door de resterende stappen in de twee diagrammen die van toepassing zijn.

    • Het SSO token wordt niet gebruikt in deze stroom.

  • SAML SSO Webex-verificatie:

    • In stap 3 van de Webex Login Flow retourneert de Common Identity-service de Identity Provider gebruikt door Webex-authenticatie.

    • Op dit moment wordt een alternatieve SAML SSO aanmeldingsflow voor Webex aangeroepen.

Gebruikersinteracties

Aanmelden

Diagram of user sign in and authentication flow
  1. De Webex-app start een browser op via Cisco Common Identity (CI) om gebruikers toe te staan hun e-mailadres in te voeren.

  2. CI detecteert dat de gekoppelde klanten organisatie de BroadWorks IDP-proxy (IDP) heeft geconfigureerd als de SAML IDP. CI verwijst naar de IDP die de gebruiker een aanmeldingspagina presenteert. (De Dienstverlener kan deze aanmeldpagina markeren.)

  3. De gebruiker voert zijn of haar BroadWorks-aanmeldgegevens in.

  4. Broadworks verifieert de gebruiker via de IDP. Als de verificatie is geslaagd, leidt de IDP de browser terug naar CI met een SAML-succes om de verificatiestroom te voltooien (niet weergegeven in diagram).

  5. Bij succesvolle verificatie verkrijgt de Webex-app toegangstokens van CI (niet weergegeven in diagram). De client gebruikt deze om een broadWorks-token voor lange duur aan te vragen voor Jason Web Token (JWT).

  6. De Webex-app detecteert de belconfiguratie via BroadWorks en andere services van Webex.

  7. De Webex-app wordt geregistreerd bij BroadWorks.

Aanmelden vanuit een gebruikers perspectief

Dit diagram is de gebruikelijke aanmeldingsstroom, zoals gezien door de eindgebruiker of abonnee:

Diagram of the typical sign-in flow, consisting of eight steps as seen by the end user or subscriber:
  1. U downloadt en installeert de Webex-app.

  2. Mogelijk hebt u de koppeling ontvangen van uw serviceprovider of vindt u de download op de Webex-downloadpagina.

  3. U voert uw e-mailadres in op het aanmeldingsscherm van Webex. Klik op Next.

  4. Gewoonlijk wordt u omgeleid naar een serviceprovider-merkpagina.

  5. Deze pagina kan u welkom heten met uw e-mailadres.

    Als er geen e-mailadres is of als het e-mailadres verkeerd is, voert u uw BroadWorks-gebruikersnaam in.

  6. Voer uw BroadWorks-wachtwoord in.

  7. Als u zich met succes hebt aangemeld, wordt Webex geopend.

gespreksverloop- Bedrijfslijst

Diagram of a call flow for corporate directory

gespreksverloop: PSTN nummer

Diagram of a call flow for PSTN number

Presentatie en delen

Diagram of a call flow for presentation and sharing

Een vergadering in een ruimte starten

Diagram of the call flow for start a space meeting

Interacties met klanten

Profiel ophalen uit DMS en SIP Register met AS

  1. Client belt XSI om een token voor apparaatbeheer en de URL naar de DMS te krijgen.

  2. De klant vraagt zijn apparaatprofiel aan in DMS door het token van stap 1 te presenteren.

  3. De client leest het apparaatprofiel en haalt de SIP-aanmeldgegevens, -adressen en -poorten op.

  4. Klant stuurt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.

  5. SBC verstuurt het SIP-register naar AS (SBC voert mogelijk een zoek opnieuw uit in het NS om een AS te vinden als SBC de SIP-gebruiker nog niet kent.)

Test- en labrichtlijnen

De volgende richtlijnen zijn van toepassing op test- en laborganisaties:

  • De partners van de serviceprovider zijn beperkt tot een maximum aan 50 testgebruikers die over meerdere organisaties kunnen worden geleverd.

  • Alle gebruikers die verder gaan dan de eerste 50 testgebruikers worden gefactureerd.

  • Om een nauwkeurige verwerking op uw factuur te garanderen, moeten alle testbedrijven 'test' opnemen in de BroadWorks Org-naam.

  • Interne testorganisaties moeten worden aangewezen binnen Webex Control Hub. Dit is om te voorkomen dat testgebruikers in rekening worden brengen als daadwerkelijke gebruikers.

Test and Lab Guidelines 1 WN4BW

Een organisatie aan ontwerpen als een testorganisatie

Een organisatie aanwijzen als testorganisatie:

  1. Meld je aan bij Partner Hub en selecteer Customers.

  2. Selecteer de juiste klant.

  3. Schakel in de rechter bedieningsbalk de Internal Test Organization omschakelen.

Test and Lab Guidelines 2 WN4BW

Voicemail afspelen

Zorg ervoor dat u voor voicemail de mediaserver configureert voor gebruik van een van de volgende codes:

  • Franse parlement3

  • wav- WAV-bestanden worden ondersteund in de volgende indelingen: PCM (ondersteund op alle platformen) en DVI-ADPCM (niet ondersteund in Android

Als u wav-bestanden gebruikt, voert u de volgende CLI-opdrachten uit om de toepassingsserver te configureren en opnieuw mediaserver:

  • AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV

  • MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw

Terminologie

ACL
Toegangsbeheerlijst
ALG
Gateway voor toepassingslaag
API
Application Programming-interface
APNS
Apple pushmeldingenservice
AS
Toepassingsserver
ATA
Analoge telefoonadapter, adapter die analoge telefonie converteert naar VoIP
BAM
BroadSoft-toepassingsmanager
Basisverificatie
Een verificatiemethode waarbij een account (gebruikersnaam) wordt gevalideerd door een gedeeld geheim (wachtwoord)
BMS
BroadSoft-berichtenserver
BOSCH
Tweerichtings-streams over synchrone HTTP
BRI
Basic Rate InterfaceBRI is een TOEGANGsmethode voor ISDN
Bundel
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (zie Pakket)
CA
Certificeringsinstantie
Provider
Een organisatie die het telefoonverkeer verzorgt (cfr. Partner, Service Provider, Value Added Reseller)
CAPTCHA
Volledig geautomatiseerde openbare turingtest om te vertellen dat computers en mensen elkaar
CCXML
Gespreksbeheer eXtensible Markup Language
CIF
Algemene tussenliggende indeling
CLI
Opdrachtregelinterface
CN
Algemene naam
CNPS
Pushserver voor gespreksmeldingen. Een Notification Push Server die draait op een XSP|ADP in uw omgeving, om oproepmeldingen naar FCM en APNS te pushen. Zie NPS-proxy.
CPE
Apparatuur ter plaatse
CPR
Regel voor aangepaste aanwezigheid
CSS
Stijlblad trapsgewijze stijl
CSV
Door komma's gescheiden waarde
CTI
Integratie van computertelefonie
CUBE
Cisco Unified Border Element
DMZ
Gedemilitariseerde zone
DN
Telefoonlijstnummer
DND
Niet storen
DNS
Domeinnaamsysteem
DPG
Bel peergroep
DSCP
Gedifferentieerd servicecodepunt
DTAF
Archiefbestand apparaattype
DTG
Bestemmings-trunk-groep
DTMF
Dual-tone met meerdere frequenties
Eindgebruiker
De persoon die de diensten gebruikt, dat wil zeggen telefoneren, deelnemen aan vergaderingen of berichten verzenden (cfr. Abonnee)
Organisatie
Een verzameling eindgebruikers (cfr. Organisatie)
FCM
Firebase Cloud Messaging
FMC
Mobile Convergence is opgelost.
Flow-through provisioning
Gebruikers maken in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' in BroadWorks toe te wijzen.
FQDN
Volledig gekwalificeerde domeinnaam (FQDN)
Volledige doorstroom-through provisioning
Aanmaken en verifiëren van gebruikers in de Webex identity store door de dienst “Integrated IM&P” in BroadWorks toe te kennen en te stellen dat elke BroadWorks gebruiker een uniek en geldig e-mailadres heeft.
ERO
Vreemde Exchange Office is de poort die de analoge lijn ontvangt. Dit is de plug-in op de telefoon, het faxapparaat of de plug-ins op uw analoge telefoonsysteem. Het levert een on-hook/off-hook-indicatie (herhaling van loop). Aangezien de USBO-poort is verbonden met een apparaat, zoals een fax of een telefoon, wordt het apparaat vaak het 'USBO-apparaat' genoemd.
ERE OPS
Een vreemde Exchange-abonnee is de poort die eigenlijk de analoge lijn overdeert aan de abonnee. Met andere woorden, het is de 'plug-in-the-wall' die een kiestoon, batterijstroom en belvoltage levert.
GCM
Bericht voor Google Cloud
GCM
Galois/Counter Mode (coderingstechnologie)
HID
Human Interface-apparaat
HTTPS
Beveiligde sockets van het Hypertext Transfer Protocol
IAD
Geïntegreerd toegangsapparaat
IM&P
Chatten en aanwezigheid
IP-PSTN
Een serviceprovider die VoIP levert aan PSTN-services, door elkaar te verbinden met ITSP, of een algemene term voor 'openbare' telefonie via internet, die gezamenlijk wordt geleverd door grote telecommsproviders (in plaats van door landen, PSTN is)
ITSP
Internettelefonie serviceprovider
IVR
IVR (Interactive Voice Response)/Responder
JID
Het oorspronkelijke adres van een XMPP-entiteit wordt een Jabber Identifier of JID localpart@domain.part.example.com/resourcepart (@ . / are separators) genoemd
JSON
Notatie Java-scriptobject
JSSE
Java Secure Socket-extensie; de onderliggende technologie die beveiligde verbindingsfuncties biedt voor BroadWorks-servers
KEM
Key Extension Module (hardware Cisco-telefoons)
LLT
Lange termijn (of lange levensduur) token; een zelfbeschreven, veilige vorm van token voor loggen waarmee gebruikers langer geverifieerd kunnen blijven en niet zijn gekoppeld aan specifieke toepassingen.
MA
Berichtarchivering
MIB
Beheerinformatiebasis
MS
Mediaserver
mTLS
Gemeenschappelijke verificatie tussen twee partijen, met behulp van Certificaat exchange, bij het tot stand brengen van een TLS-verbinding
MUC
Chat met meerdere gebruikers
NAT
Netwerkadresvertalingen
NPS
Pushserver voor meldingen; zie CNPS
NPS-proxy

Een service in Webex die op korte termijn autorisatietokens levert aan uw CNPS, waardoor deze de oproepmeldingen naar FCM- en APN's kan pushen en uiteindelijk naar Android- en iOS-apparaten met Webex.

OCI
Clientinterface openen
Organisatie
Een bedrijf of organisatie die een verzameling eindgebruikers vertegenwoordigt (cf. Onderneming)
OTG
Groep met uitgaande trunks
Pakket
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (zie Bundel)
Partner
Een agentorganisatie die met Cisco samenwerkt om producten en diensten aan andere organisaties te distribueren (zie Value Added Reseller, Service Provider, Carrier)
PBX
Private Branch Exchange
PEM
Verbeterde privacymail
PLMN
Openbaar mobiel netwerk land
PRI
Primary Rate Interface (PRI) is een telecommunicatie-interface standaard gebruikt op een Integrated Services Digital Network (ISDN)
PS
Profielserver
PSTN
Public Switched Telephone-netwerk
QoS
Servicekwaliteit
Resellerportal
Een website waarmee de beheerder van de reseller zijn UC-One SaaS-oplossing kan configureren. Het wordt ook wel PORTAL-portal, beheerportal of beheerportal genoemd.
RTCP
Realtime beheerprotocol
RTP
Realtime transportprotocol
SBC
Border Controller voor sessie
SCA
Weergave van gedeelde oproep
SD
Standaarddefinitie
SDP
Sessieomschrijvingsprotocol
SP
Dienstverlener; Een organisatie die telefonie of aanverwante diensten levert aan andere organisaties (cf. Carrier, Partner, Value Added Reseller)
SIP
SIP (Session Initiation Protocol)
SLT
Korte of korte levensduur token (ook wel BroadWorks SSO token genoemd); een geverifieerd token voor eenmalig gebruik dat wordt gebruikt om veilige toegang te krijgen tot webtoepassingen.
SMB
Klein tot Middelgroot bedrijf
SNMP
Eenvoudig Network Management-protocol
sRTCP
secure Realtime Transfer Control Protocol (VoIP gespreksmedia)
sRTP
secure Realtime Transfer Protocol (VoIP media)
SSL
Secure Sockets-laag
Abonnee
De persoon die de diensten gebruikt, dat wil zeggen telefoneren, deelnemen aan vergaderingen of berichten versturen (cfr. Eindgebruiker)
TCP
Transmission Control Protocol
TDM
Meervoudige indeling van tijdsdeling
TLS
Beveiliging van de transportlaag
Tos
Type of Service
UAP
Portal voor gebruikersactivering
UC
Unified Communications
UI
Gebruikersinterface
UID
Unieke id
UMS
Chatserver
URI
Uniform Resource Identifier
URL
Uniform Resource Locator
USS
Server delen
UTC
Gecoördineerde wereldtijd-11
MANEEN
Videoserver
Value Added Reseller (VAR)
Een agentorganisatie die met Cisco samenwerkt om producten en diensten aan andere organisaties te distribueren (cf. Carrier, Partner, Service Provider)
VGA
Array van videoafbeeldingen
VoIP
Voice over Internet Protocol (IP)
VXML
Spraakuitvouwbare markuptaal
Webdav
Web Distributed Authoring en Versioning
WebRTC
Realtime webcommunicatie
WRS
WebRTC-server
XMPP
Extensible Messaging and Presence-protocol
Bijlage

Services configureren (met mTLS voor de auth-service)

De volgende procedures vervangen de procedures in het onderwerp Services configureren op uw Webex voor Cisco BroadWorks XSP|ADPs. Voltooi deze procedures alleen als u mTLS gebruikt voor de verificatiedienst in plaats van CI-token validatie. Deze procedures zijn verplicht als u meerdere Webex-organisaties op dezelfde XSP|ADP-server draait. Anders zijn ze optioneel.

Als u niet meerdere Webex-organisaties op dezelfde XSP|ADP-server draait, wordt CI Token Validation (met TLS) aanbevolen voor de Auth-service. Verwijzen naar Services configureren op uw Webex voor Cisco BroadWorks XSP|ADPsvoor meer informatie over het configureren van de authenticatiedienst en andere diensten.

Xsi-interfaces

Installeer en configureer de Xsi-Actions en Xsi-Events toepassingen zoals beschreven in Cisco BroadWorks Xtended Services Interface Configuratiegids.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moeten dezelfde callControlApplicationName hebben zoals gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker wordt ingeschakeld bij Webex, maakt Webex een abonnement voor de gebruiker op het AS om telefonieevenementen voor aanwezigheid en oproepgeschiedenis te ontvangen. Het abonnement is gekoppeld aan de callControlApplicationName en het AS gebruikt het om te weten naar welke Xsi-Events de telefonie events moeten sturen.

Het wijzigen van de callControlApplicationName, of het niet hebben van dezelfde naam op alle Xsi-Events webapps zal gevolgen hebben voor abonnementen en telefonie events functionaliteit.

Verificatieservice configureren (met mTLS)

BroadWorks langlevende tokens worden gegenereerd en gevalideerd door de verificatiedienst die wordt gehost op uw XSP|ADP's.

Vereisten

  • De XSP|ADP-servers die de verificatiedienst hosten, moeten een mTLS-interface hebben geconfigureerd.

  • XSP|ADP's moeten dezelfde sleutels delen voor het versleutelen/decoderen van BroadWorks langlevende tokens. Het kopiëren van deze sleutels naar elke XSP|ADP is een handmatig proces.

  • XSP|ADP’s moeten gesynchroniseerd worden met NTP.

Configuratieoverzicht

De essentiële configuratie op uw XSP|ADP's omvat:

  • Implementeer de verificatieservice.

  • Stel de duur van de token in op minstens 60 dagen (de uitgever verlaten als BroadWorks).

  • Genereer en deel RSA-sleutels over XSP|ADP's.

  • Geef de authService-URL aan de webcontainer door.

Implementeer de authenticatiedienst op XSP|ADP

Op elke XSP|ADP gebruikt met Webex:

  1. Activeer de verificatieservicetoepassing op het pad. /authService (u moet dit pad gebruiken):

    XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService

    (waarbij <version> is uw BroadWorks-versie).

  2. Implementeer de toepassing:

    XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authService

Duur van token configureren

  1. Controleer de bestaande tokenconfiguratie (uren):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> get

  2. Stel de duur in op 60 dagen (max is 180 dagen):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> set tokenDurationInHours 1440

RSA-sleutels genereren en delen

  • U moet dezelfde openbare/privésleutelparen gebruiken voor de codering/decodering van het token in alle exemplaren van de verificatieservice.

  • Het sleutelpaar wordt gegenereerd door de verificatiedienst wanneer het voor het eerst nodig is om een token uit te geven.

Vanwege deze twee factoren moet u sleutels genereren op een XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's.

Als u sleutels fietst of de lengte van de sleutel verandert, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw opstarten.

  1. Selecteer één XSP|ADP om te gebruiken voor het genereren van een sleutelpaar.

  2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen uit de browser van de client:

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

    (Dit genereert een private / publieke sleutelpaar op de XSP|ADP, als er nog niet een was)

  3. De locatie van de sleutelwinkel is niet configureerbaar. Exporteert u de sleutels:

    XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

  4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP's, overschrijven van een oudere .keys bestand indien nodig.

  5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

Geef de authService-URL aan de webcontainer door

De webcontainer van XSP|ADP heeft de authService URL nodig, zodat het tokens kan valideren.

Op elk van de XSP|ADP's:

  1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het BroadWorks Communications Utility:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1:80/authService

  2. Voeg de URL van de verificatieservice toe aan de container:

    XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService

    Hiermee kan Webex de verificatieservice gebruiken om de tokens die als aanmeldgegevens worden gepresenteerd, te valideren.

  3. Controleer de parameter met get.

  4. Herstart de XSP|ADP.

TLS en Versleutelingen configureren op de HTTP-interfaces (voor XSI en de verificatieservice)

De verificatieservice, Xsi-Acties en Xsi-Events-toepassingen maken gebruik van HTTP-serverinterfaces. De niveaus van TLS-configuratie voor deze toepassingen zijn als volgt:

Algemeen = System > Transport > HTTP > HTTP Server-interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen zijn:

Specificiteit CLI-context
Systeem (algemeen)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP-server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get gebruiken en de resultaten te lezen. U moet de interfaces (IP-adressen) en, voor elk, bekijken of ze beveiligd zijn en of clientverificatie vereist is.

Het gaat om een certificaat voor elke beveiligde interface. genereert het systeem een zelf-ondertekend certificaat indien dat nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

Results displayed after entering the get command, showing interfaces (IP addresses) and, for each, whether they are secure and whether they require client authentication.

TLS toevoegen 1.2 Protocol aan de HTTP-serverinterface

De HTTP-interface die interageert met de Webex Cloud moet geconfigureerd worden voor TLSv1.2. De cloud onderhandelen niet over eerdere versies van het TLS-protocol.

Om het TLSv1.2-protocol op de HTTP-serverinterface te configureren:

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al worden gebruikt in deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS kan gebruiken 1.2 bij communicatie met de cloud.

TLS-versleutelingsconfiguratie bewerken op de HTTP-serverinterface

De vereiste versleutelingen configureren:

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke versleutelingen al worden gebruikt in deze interface. Er moet minstens één van de door Cisco aanbevolen suites zijn (zie XSP|ADP Identiteits- en beveiligingsvereisten in het hoofdstuk Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de HTTP-serverinterface.

    De XSP|ADP CLI vereist de IANA standaard cipher suite naam, niet de openSSL cipher suite naam. Bijvoorbeeld, om de openSSL-versleuteling toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 naar de HTTP-serverinterface gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Zie https://ciphersuite.info/om de suite met beide namen te vinden.

Vertrouwen voor verificatieservice configureren (met mTLS)

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Settings > BroadWorks Calling en klik op Download Webex CA Certificate om te krijgen CombinedCertChain2023.txt op uw lokale computer.

    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze naar de XSP|ADP's uploadt. Alle bestanden zijn verplicht.
  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt.

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste blok tekst, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----, en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één blok tekst bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijvoorbeeld, /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt.

  5. Meld u aan bij de XSP|ADP en navigeer naar /XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoeren UpdateTrust om de parameters en opdrachtindeling te zien.

  6. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023

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

    Alle aliassen moeten een andere naam hebben. webexclientroot, webexclientroot2023, webexclientissuingen webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen aliassen gebruiken zolang alle vier ingangen uniek zijn.

  7. Bevestig dat de ankers zijn bijgewerkt:

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get

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

(Optie) MTLS configureren op http-interface/poortniveau

Het is mogelijk om mTLS te configureren op HTTP-interface/poortniveau of op een per-webapplicatie basis.

De manier waarop u mTLS inschakelt voor uw applicatie hangt af van de applicaties die u op de XSP|ADP host. Als u meerdere toepassingen hosten die mTLS vereisen, moet u mTLS inschakelen op de interface. Als u slechts een van de toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op HTTP-interface/poortniveau is mTLS vereist voor alle gehoste webapplicaties die via deze interface/poort worden benaderd.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/HttpServer> en voer de get gebruiken om de interfaces te bekijken.

  3. Om daar een interface toe te voegen en de clientverificatie te vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true

    Zie de XSP|ADP CLI documentatie voor meer informatie. In principe de eerste true beveiligt de interface met TLS (servercertificaat wordt gemaakt indien vereist) en de tweede true dwingt de interface af om verificatie van clientcertificaten te vereisen (samen zijn ze mTLS).

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/HttpServer> get

Interface Port Name Secure Client Auth Req Cluster Fqdn
         =======================================================
         192.0.2.7 443 XSP|ADP01.collab.example.net true false 
         192.0.2.7 444 XSP|ADP01.collab.example.net true true

In dit voorbeeld is mTLS (Client Auth Req = true) ingeschakeld op 192.0.2.7 poort 444. TLS is ingeschakeld op 192.0.2.7 poort 443.

(Optie) MTLS configureren voor specifieke webtoepassingen

Het is mogelijk om mTLS te configureren op HTTP-interface/poortniveau of op een per-webapplicatie basis.

De manier waarop u mTLS inschakelt voor uw applicatie hangt af van de applicaties die u op de XSP|ADP host. Als u meerdere toepassingen hosten die mTLS vereisen, moet u mTLS inschakelen op de interface. Als u slechts een van de toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Wanneer u mTLS configureert op toepassingsniveau, is mTLS vereist voor die toepassing, ongeacht de configuratie van de HTTP-serverinterface.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> en voer de get gebruiken om te zien welke toepassingen worden uitgevoerd.

  3. Een toepassing toevoegen en de clientverificatie vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true

    Zie de XSP|ADP CLI documentatie voor meer informatie. De toepassingsnamen worden daar geemigreerd. Het bericht true in deze opdracht schakelt u mTLS in.

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add 192.0.2.7 443 AuthenticationService true

Het voorbeeldcommando voegt de AuthenticationService-applicatie toe aan 192.0.2.7:443 en vereist dat deze certificaten van de client opvraagt en authenticeert.

Controleren met get:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> get

Interface Ip Port Application Name Client Auth Req
         ===================================================
         192.0.2.7 443 AuthenticationService      true          

Apparaatbeheer configureren op XSP|ADP, Application Server en Profile Server

Profile Server en XSP|ADP zijn verplicht voor Device Management. Ze moeten worden geconfigureerd volgens de instructies in de BroadWorks configuratiegids voor apparaatbeheer.

Waar te gaan naar volgende

Voor de configuratie kunt u de hoofddocumentstroom opnieuw samenvoegen op CTI-interface en bijbehorende configuratie.

Aanvullende certificaatvereisten voor wederzijdse TLS-authenticatie tegen AuthService

Webex werkt met de verificatieservice via gemeenschappelijke TLS geverifieerde verbinding. Dit betekent dat Webex een klantencertificaat voorlegt en dat de XSP|ADP moet valideren. Om dit certificaat te vertrouwen, gebruikt u de Webex CA-certificaatketen om een vertrouwensanker op XSP|ADP (of proxy) aan te maken. De certificaatketen kan worden gedownload via Partner Hub:

  1. Meld u aan bij Partner Hub op admin.webex.com.
  2. Ga naar Services > Additional links.

  3. Klik op de koppeling Certificaat downloaden.

U kunt ook de certificaatketen krijgen van https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.

De exacte vereisten voor het inzetten van deze Webex CA certificaat keten is afhankelijk van hoe uw publiek gerichte XSP|ADP's worden ingezet:

  • Via een TLS-bebridgingsproxy

  • Via een pass-through proxy van TLS

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt een samenvatting weergegeven waarin de Webex CA-certificaatketen in deze drie gevallen moet worden geïmplementeerd.

Diagram summarizing where the Webex CA certificate chain must be deployed in three cases.

Gemeenschappelijke TLS-certificaatvereisten voor TLS-bridgeproxy

  • Webex toont een door Webex CA ondertekend clientcertificaat naar de proxy.

  • De Certificaatketen van Webex CA is geïmplementeerd in de trust store van de proxy, zodat de proxy het clientcertificaat vertrouwt.

  • Het openbaar ondertekende XSP|ADP servercertificaat wordt ook in de proxy geladen.

  • De proxy toont een openbaar ondertekend servercertificaat voor Webex.

  • Webex vertrouwt de openbare ca die het servercertificaat van de proxy heeft ondertekend.

  • De proxy overhandigt een intern ondertekend cliëntcertificaat aan de XSP|ADP’s.

    Voor dit certificaat moet het x509.v3-verlengingsveld Uitgebreid sleutelgebruik worden ingevuld met de BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS clientAuth-functie. Bijvoorbeeld.:

    X509v3 extensions:

    X509v3 Extended Key Usage:

    1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client
                  Authentication 

    Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP's presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

Gemeenschappelijke TLS-certificaatvereisten voor TLS-passthrough Proxy of XSP in DMZ

  • Webex toont een door Webex CA ondertekend clientcertificaat voor de XSP's.

  • De Webex CA-certificaatketen wordt geïmplementeerd op de trust store van de XSP's, zodat de XSP's het clientcertificaat vertrouwen.

  • Het openbaar ondertekende XSP-servercertificaat wordt ook geladen in de XSP's.

  • De XSP's presenteren openbaar ondertekende servercertificaten voor Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP's heeft ondertekend.

Revisiegeschiedenis van document

De volgende tabel geeft een overzicht van de wijzigingen in dit document in de afgelopen 12 maanden.

Datum

Beschrijving van de wijziging

juli 06, 2026

Bijgewerkte SIP call transfer naar Webex Meeting sectie met nieuwe Configure URI dialing steps.

juni 24, 2026

Bijgewerkte Add Webex App configuration templates to BroadWorks Application Server sectie met stappen Import DITA files.

mei 06, 2026

Een sectie Activate BroadWorks IdP in Control Hub toegevoegd.

februari 17, 2026

Australische FQDN's toegevoegd in de sectie Configure NPS to use authentication proxy.

februari 06, 2026

Saoedi-Arabië FQDN's toegevoegd in de sectie Configure NPS to use authentication proxy.

september 26, 2025

De sectie Algemene beperkingen bijgewerkt om Webex voor Intune-beperking op te nemen.

juni 04, 2025

De sectie Beperkingen bijgewerkt om de navigatiewijziging van de Control Hub voor 'Authenticatie'-instellingen op te nemen, die van 'Organization Settings' naar 'Security' verhuisde.

mei 20, 2025

De sectie DND Sync uitschakelen bijgewerkt met de details voor het aanmaken van een TAC-case om de functie uit te schakelen.

april 29, 2025

Het navigatiepad bijgewerkt toen BroadWorks Calling-instellingen verhuisden van Organization-instellingen naar Services in Partner Hub.

april 23, 2025

Een notitie toegevoegd in de Client Logs onder de sectie Troubleshooting.

januari 13, 2025

Sectie Aanbevolen en Beperkingen bijgewerkt.

december 03, 2024

Redactionele wijzigingen.

oktober 04, 2024

Toegevoegd Quiet Hours sectie.

september 10, 2024

Bijgewerkte sectie Test- en laboratoriumrichtlijnen.

augustus 09, 2024

De sectie 'Select Caller ID' toegevoegd.

augustus 01, 2024

De sectie 'Voicemail inschakelen voor Microsoft Teams-integratie' toegevoegd.

juni 25, 2024

Bijgewerkt Barge-in sectie onder Deploy Webex voor BroadWorks.

juni 14, 2024

Toegevoegd Flexible External Caller ID Selection sectie onder Features and Limitations en Canceling a Subscription from Control Hub sectie onder Managing Webex for BroadWorks.

mei 13, 2024

Redactionele wijzigingen.

mei 10, 2024

Pro Pack For Control Hub toegevoegd onder de sectie Kenmerken en beperkingen.

mei 6, 2024

Bijgewerkte Partner SSO - SAML sectie, geen behoefte om contact op te nemen met TAC voor Identity Provider.

mei 2, 2024

Redactionele wijzigingen.

april 10, 2024

Bijgewerkte patchinformatie 2 in de sectie Shared-Line Appearance.

Maart 27, 2024

Bijgewerkt Busy Lamp Field / Call Pickup en Partner SSO - OpenID Connect sectie.

Maart 22, 2024

Bijgewerkte voorwaarden in de sectie Niet storen (DND) synchronisatie.

Maart 07, 2024

Bijgewerkt Control Login flow sectie in User Login en Configuration Retrieval.

februari 24, 2024

Redactionele wijzigingen.

februari 20, 2024

Sectie Visual Spam Indication toegevoegd onder Deploy Webex for BroadWorks.

februari 07, 2024

Toegevoegd een functie BroadWorks Password Expiration Notification Tijdens Login onder Webex voor BroadWorks Reference.

januari 25, 2024

Redactionele wijzigingen.

januari 23, 2024

Redactionele wijzigingen aangebracht in de sectie Move User (with Consent) to Webex for Cisco BroadWorks onder Managing Webex for BroadWorks.

januari 10, 2024

Redactionele wijzigingen.

Overzicht van Webex voor Cisco BroadWorks

Introductie van Webex voor Cisco BroadWorks

Revisiegeschiedenis van document

Dit gedeelte behandelt systeembeheerders bij Cisco-partnerorganisaties (serviceproviders) die Webex implementeren voor hun klantorganisaties of deze oplossing rechtstreeks aanbieden aan hun eigen abonnees.

Doel van de oplossing

  • Webex-cloudsamenwerkingsfuncties aanbieden aan kleine en middelgrote klanten die al gespreksservice hebben die wordt geleverd door BroadWorks-serviceproviders.

  • BroadWorks-gebaseerde gespreksservice aanbieden aan kleine en middelgrote Webex-klanten.

Context

We evolueren al onze samenwerkingsklanten naar een uniforme toepassing. Dit pad vermindert aannameproblemen, verbetert de interoperabiliteit en migratie en biedt voorspelbare gebruikerservaringen in ons hele samenwerkingsportfolio. Een deel van deze inspanning is het verplaatsen van de BroadWorks-gespreksmogelijkheden naar de Webex-app en uiteindelijk het verminderen van investeringen in de UC-One-clients.

Voordelen

  • Toekomstbestendigheid: tegen beëindiging van UC-One Collaborate, beweging van alle clients naar het Unified Client Framework (UCF)

  • Het beste van beide: Webex-functies voor berichten en vergaderingen inschakelen met behoud van BroadWorks-gesprekken op uw telefonienetwerk

Toepassingsgebied van de oplossing

  • Bestaande/nieuwe kleine tot middelgrote klanten (minder dan 250 abonnees) die een reeks samenwerkingsfuncties willen, hebben mogelijk al BroadWorks-gesprekken.

  • Bestaande kleine tot middelgrote Webex-klanten die BroadWorks Calling willen toevoegen.

  • Niet voor grotere ondernemingen (raadpleeg ons Enterprise-portfolio voor Webex).

  • Niet voor één gebruiker (evalueer Webex Online-aanbiedingen).

De functiesets in Webex voor Cisco BroadWorks zijn gericht op gebruiksscenario's voor kleine tot middelgrote bedrijven. De Webex voor Cisco BroadWorks-pakketten zijn ontworpen om de complexiteit voor kleine en middelgrote ondernemingen te verminderen en we evalueren voortdurend hun geschiktheid voor dit segment. We kunnen ervoor kiezen functies die anders beschikbaar zijn in de bedrijfspakketten te verbergen of te verwijderen.

Vereisten voor succes met Webex voor Cisco BroadWorks

#

Vereiste

Notities

1

Patchstroom BroadWorks R22 of hoger

2

XSP|ADP voor XSI, CTI, DMS en authService

Specifieke XSP|ADP voor Webex voor Cisco BroadWorks

3

Afzonderlijke XSP|ADP voor NPS kunnen worden gedeeld met andere oplossingen die NPS gebruiken.

Als u een bestaande implementatie voor samenwerken hebt, controleert u aanbevelingen voor XSP|ADP- en NPS-configuraties.

4

CI-tokenvalidatie (met TLS) geconfigureerd voor Webex-verbindingen met de verificatieservice.

5

mTLS is geconfigureerd voor Webex-verbindingen met de CTI-interface.

Voor andere toepassingen is geen mTLS vereist.

6

Gebruikers moeten bestaan in BroadWorks en hebben de volgende kenmerken nodig, afhankelijk van uw inrichtingsbeslissing:

  • Doorloop met vertrouwde e-mails: Het e-mailkenmerk van de BroadWorks-gebruiker moet een geldig e-mailadres bevatten dat uniek is voor die gebruiker. De gebruiker moet ook een primair nummer of toestel hebben.

  • Doorloop met niet-vertrouwde e-mails, zelfactivering of API-inrichting: Gebruiker heeft geen e-mailadres nodig, maar moet een primair nummer of toestel hebben.

Voor vertrouwde e-mails: We raden u aan hetzelfde e-mailadres ook in het kenmerk Alternatieve id in te voeren, zodat gebruikers zich met e-mailadres kunnen aanmelden bij BroadWorks.

Voor niet-vertrouwde e-mails: Afhankelijk van de e-mailinstellingen van de gebruiker kan het gebruik van niet-vertrouwde e-mails ertoe leiden dat de e-mail wordt verzonden naar de ongewenste of spammap van de gebruiker. De beheerder moet mogelijk de e-mailinstellingen van de gebruiker wijzigen om domeinen toe te staan

7

Webex voor Cisco BroadWorks DTAF-bestand voor de Webex-app

8

BW Business Lic of Std Enterprise of Prem Enterprise User Lic + Webex voor Cisco BroadWorks-abonnement

Als u een bestaande implementatie voor samenwerken hebt, hebt u geen UC-One Add-On Bundle, Collab Lic en Meet-me Conference Ports meer nodig.

Als u een bestaande UC-One SaaS-implementatie hebt, zijn er geen andere wijzigingen dan het accepteren van de voorwaarden van het Premium-pakket.

9

IP/poorten moeten toegankelijk zijn via de Webex-backend-services en de Webex-apps via openbaar internet.

Zie het gedeelte “Uw netwerk voorbereiden”.

10

TLS v1.2-configuratie op XSP|ADP's

11

Voor Flowthrough-inrichting moet de toepassingsserver verbinding maken met de BroadWorks-inrichtingsadapter.


 

We testen of ondersteunen geen uitgaande proxyconfiguratie. Als u een uitgaande proxy gebruikt, accepteert u de verantwoordelijkheid om deze te ondersteunen met Webex voor Cisco BroadWorks.

Zie het onderwerp “Uw netwerk voorbereiden”.

Over dit document

Het doel van dit document is u te helpen uw Webex for Cisco BroadWorks-oplossing te begrijpen, voor te bereiden, te implementeren en te beheren. De grote delen in het document weerspiegelen dit doel.

Deze gids bevat conceptueel en referentiemateriaal. We zijn van plan alle aspecten van de oplossing in dit ene document te behandelen.

De minimale set taken om de oplossing te implementeren zijn:

  1. Bereik uw accountteam om een Cisco-partner te worden. Het is noodzakelijk dat u de Cisco-aanrakingspunten onderzoekt om uzelf vertrouwd te maken (en getraind te worden). Wanneer u een Cisco-partner wordt, passen we de Webex voor Cisco BroadWorks-schakelaar toe op uw Webex-partnerorganisatie. (Zie Webex implementeren voor Cisco BroadWorks > Onboarding voor partners in dit document.)

  2. Configureer uw BroadWorks-systemen voor integratie met Webex. (Zie Webex implementeren voor Cisco BroadWorks > Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's in dit document.)

  3. Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)

  4. Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)

  5. Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)


 
  • Dit zijn stappen van hoog niveau, in de typische volgorde. Er zijn verschillende bijdragende taken die u niet kunt negeren.

  • Als u uw eigen toepassingen wilt maken om uw Webex voor Cisco BroadWorks-abonnees te beheren, leest u De inrichtings-API gebruiken in het gedeelte Referentie van deze handleiding.

Terminologie

We proberen het jargon en de letterwoorden in dit document te beperken en elke term uit te leggen wanneer deze voor het eerst wordt gebruikt. (Zie Webex voor Cisco BroadWorks-referentie > Terminologie als een term niet in de context wordt uitgelegd.)

Hoe het werkt

Webex voor Cisco BroadWorks is een aanbieding die BroadWorks-gesprekken integreert in Webex. Abonnees gebruiken één toepassing (de Webex-app) om gebruik te maken van functies die door beide platforms worden aangeboden:

  • Gebruikers bellen PSTN-nummers via uw BroadWorks-infrastructuur.

  • Gebruikers bellen met andere BroadWorks-nummers via uw BroadWorks-infrastructuur (audio-/videogesprekken door de nummers te selecteren die zijn gekoppeld aan de gebruikers of het toetsenblok om de nummers te introduceren).

  • Gebruikers kunnen ook een Webex VoIP-gesprek plaatsen via de Webex-infrastructuur door de optie 'Webex Call' te selecteren in de Webex-app. (Deze gesprekken zijn de Webex-app naar de Webex-app, niet de Webex-app naar PSTN).

  • Gebruikers kunnen Webex Meetings hosten en eraan deelnemen.

  • Gebruikers kunnen elkaar een voor een berichten sturen of in ruimten (permanente groepchat) en profiteren van functies als zoeken en bestanden delen (op Webex-infrastructuur).

  • Gebruikers kunnen aanwezigheid (status) delen. Ze kunnen aangepaste aanwezigheid of door de klant berekende aanwezigheid kiezen.

  • Nadat we u als partnerorganisatie hebben geïntegreerd in Control Hub, met de juiste rechten, kunt u de relatie tussen uw BroadWorks-exemplaar en Webex configureren.

  • U maakt klantorganisaties in Control Hub en richt gebruikers in deze organisaties in.

  • Elke abonnee in BroadWorks krijgt een Webex-identiteit op basis van zijn/haar e-mailadres (kenmerk e-mail-id in BroadWorks).

  • Gebruikers worden geverifieerd voor BroadWorks of voor Webex.

  • Clients krijgen langdurige tokens om ze te autoriseren voor services bij BroadWorks en Webex.

De Webex-app in het midden van deze oplossing; het is een brandbare toepassing die beschikbaar is op Mac/Windows-bureaubladen en Android/iOS-telefoons en -tablets.

Er is ook een webversie van de Webex-app die momenteel geen gespreksfuncties bevat.

De client maakt verbinding met de Webex-cloud om functies voor berichten, aanwezigheid en vergaderingen te leveren.

De client registreert zich bij uw BroadWorks-systemen voor gespreksfuncties.

De Webex-cloud werkt met uw BroadWorks-systemen om een naadloze gebruikersinrichting te garanderen.

Functies en beperkingen

Wij bieden verschillende pakketten met verschillende functies.

Softphone-pakket

Dit pakkettype gebruikt de Webex-app als een softphone only-client met belmogelijkheden, maar geen berichtmogelijkheden. Gebruikers met dit pakkettype kunnen deelnemen aan Webex-vergaderingen, maar kunnen geen vergaderingen zelf starten. Wanneer andere gebruikers (softphone of niet-softphone) in de telefoonlijst zoeken naar een softphone-gebruiker, bieden de zoekresultaten geen optie om een bericht te verzenden.

Softphone-gebruikers kunnen hun scherm delen tijdens een gesprek.

Basispakket

Het basispakket bevat functies voor bellen, chatten en vergaderen. Het omvat 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room). (** zie onderstaande Note voor uitzondering). In dit pakket kunnen de vergaderingen een maximale duur van 40 minuten hebben.

Pakket "Standaard"

Dit pakket omvat ook alles in het basispakket, zoals maximaal 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room).

Scherm delen binnen een PMR-vergadering is een rol die in eerste instantie alleen wordt uitgeoefend door de host van de vergadering, maar de host kan de rol van presentator overdragen aan een door hem of haar gekozen deelnemer aan de vergadering. Alleen de host kan de rol van presentator opnieuw opnemen zonder dat de huidige host deze aan hem of haar heeft doorgegeven.

"Premium"-pakket

Dit pakket omvat alles in het standaardpakket plus maximaal 300 deelnemers aan een vergadering in een 'unified space' en maximaal 1000 deelnemers in een persoonlijke vergaderruimte (PMR).

Scherm delen binnen een PMR-vergadering wordt ondersteund voor elke deelnemer aan de vergadering.

Pakketten vergelijken

Pakket

Oproepen

Berichten

Unified Space-vergaderingen

PMR Meetings

Softphone

Opgenomen

Niet inbegrepen

Geen

Geen

Eenvoudig

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Standaard

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Premium

Opgenomen

Opgenomen

300 deelnemers

1000 deelnemers


 
De limiet voor Unified Space-vergaderingen voor basisgebruikers is 100 deelnemers per Unified Space-vergadering, tenzij de ruimte ook gebruikers bevat waaraan de pakketten 'Standaard' of 'Premium' zijn toegewezen. In dat geval wordt de limiet verhoogd op basis van het gebruikerspakket van de host.

 

'Unified Space Meetings' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in een Webex-ruimte. Een gebruiker start bijvoorbeeld een vergadering vanuit de ruimte via de knoppen 'Vergaderen' of 'Plannen'.

'PMR-vergaderingen' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in de persoonlijke vergaderruimte (PMR) van een gebruiker. Deze vergaderingen gebruiken een speciale URL (bijvoorbeeld: cisco.webex.com/meet/roomOwnerUserID).

Berichten en vergaderingsfuncties

Raadpleeg de volgende tabel voor verschillen in ondersteuning van PMR-vergaderingsfuncties voor Basic-, Standard- en Premium-pakketten.

Tabel 1. Verschillen in functieondersteuning voor PMR-vergaderingen

Vergaderingsfunctie

Ondersteund met basispakket

Overgezet met standaardpakket

Ondersteund met Preminum-pakket

Opmerking

Vergaderduur

40 minuten of minder

Onbeperkt

Onbeperkt

Bureaublad delen

Ja

Ja

Ja

Basis: bureaublad delen door een PMR-vergaderingdeelnemer.

Standaard : bureaublad delen alleen door de host van de PMR-vergadering.

Premium: bureaublad delen door een deelnemer aan een PMR-vergadering.

Toepassingen delen

Ja

Ja

Ja

Basis: toepassingen delen door elke deelnemer aan een PMR-vergadering.

Standaard : toepassingen delen alleen door de host van de PMR-vergadering.

Premium: toepassingen delen door deelnemers aan een PMR-vergadering.

Chat met meerdere partijen

Ja

Ja

Ja

Whiteboarden

Ja

Ja

Ja

Wachtwoordbeveiliging

Ja

Ja

Ja

Web-app - geen downloaden of invoegtoepassingen (gastervaring)

Ja

Ja

Ja

Ondersteuning voor koppelen met Webex-apparaten

Ja

Ja

Ja

Vloerbeheer (Eén dempen / Alles verwijderen)

Ja

Ja

Ja

Koppeling voor blijvende vergaderingen

Ja

Ja

Ja

Toegang tot de Meetings-site

Ja

Ja

Ja

Deelnemen aan vergadering via VoIP

Ja

Ja

Ja

Vergrendeling

Ja

Ja

Ja

Bedieningselementen voor presentator

Nee

Nee

Ja

Extern bureaubladbeheer

Nee

Nee

Ja

Aantal deelnemers

100

100

1000

Opname lokaal opgeslagen in het systeem

Ja

Ja

Ja

Opnemen in de cloud

Nee

Nee

Ja

Opname - Cloudopslag

Nee

Nee

10 GB per locatie

Opnametranscripties

Nee

Nee

Ja

Vergaderingen plannen

Ja

Ja

Ja

Inhoud delen met externe integraties inschakelen

Nee

Nee

Ja

Basic— Inhoud delen door een deelnemer aan een PMR-vergadering.

Standaard: inhoud delen met alleen de host van de PMR-vergadering.

Premium: inhoud delen door een deelnemer aan een PMR-vergadering.

PMR-URL wijzigen toestaan

Nee

Nee

Ja

Basic— Gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL wijzigen vanuit Control Hub.

Standaard: de PMR-URL kan alleen worden gewijzigd vanuit Partner Hub door partner- en organisatiebeheerders.

Premium: gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL vanuit Partner Hub wijzigen.

Live streaming van vergaderingen (Bv. op Facebook, Youtube)

Nee

Nee

Ja

Andere gebruikers toestaan vergaderingen namens hen te plannen

Nee

Nee

Ja

Een alternatieve host toevoegen

Ja

Nee

Ja

App-integratie (bijv. Zendesk, Slack)

Afhankelijk van de integratie

Afhankelijk van de integratie

Ja

Zie het gedeelte App-integraties hieronder voor meer informatie over ondersteuning.

Integratie met Microsoft Office 365-agenda

Ja

Ja

Ja

Integratie met Google-agenda voor G Suite

Ja

Ja

Ja

Het Webex-helpcentrum publiceert de functies en documentatie voor gebruikers voor Webex op help.webex.com. Lees de volgende artikelen voor meer informatie over de functies:

Gespreksfuncties

De belervaring is vergelijkbaar met eerdere oplossingen die gebruikmaken van de BroadWorks-gespreksbeheermotor. Het verschil met UC-One Collaborate en UC-One SaaS is dat de Webex-app de primaire softclient is.

App-integraties

U kunt Webex voor Cisco BroadWorks integreren met de volgende toepassingen:

Ondersteuning voor Virtual Desktop Infrastructure (VDI)

Webex voor Cisco BroadWorks ondersteunt nu VDI-omgevingen (Virtual Desktop Infrastructure). Raadpleeg de Implementatiehandleiding voor Webex voor Virtual Desktop Infrastructure (VDI) voor meer informatie over de implementatie van VDI-infrastructuur.

IPv6-ondersteuning

Webex voor Cisco BroadWorks ondersteunt IPv6-adressering voor de Webex-app.

Toekomstige routekaart

Ga naar https://salesconnect.cisco.com/#/program/PAGE-16649 voor meer informatie over onze voornemens voor de toekomstige versies van Webex voor Cisco BroadWorks. De items van het stappenplan zijn in geen enkele hoedanigheid bindend. Cisco behoudt zich het recht voor om een of al deze items uit toekomstige releases te onthouden of te herzien.

Beperkingen

Inrichtingsbeperkingen

Tijdzone van Meetings-site

De tijdzone van de eerste abonnee voor elk pakket wordt de tijdzone voor de Webex Meetings-site die voor dat pakket is gemaakt.

Als er geen tijdzone is opgegeven in het inrichtingsverzoek voor de eerste gebruiker van elk pakket, wordt de tijdzone van de Webex Meetings-site voor dat pakket ingesteld op de regionale standaard van de organisatie van de abonnees.

Als uw klant een specifieke tijdzone van de Webex Meetings-site nodig heeft, geeft u de timezone parameter in de inrichtingsaanvraag voor:

  • de eerste abonnee die is ingericht voor het standaardpakket in de organisatie.

  • de eerste abonnee die is ingericht voor Premium-pakket in de organisatie.

  • de eerste abonnee die is ingericht voor het basispakket in de organisatie.

Algemene beperkingen

  • Geen gesprekken in de webversie van de Webex-client (dit is een clientbeperking, geen oplossingsbeperking.)

  • Webex beschikt mogelijk nog niet over alle besturingselementen voor de gebruikersinterface om bepaalde functies voor gespreksbeheer te ondersteunen die beschikbaar zijn via BroadWorks.

  • De Webex-client kan momenteel geen 'wit label' hebben.

  • Wanneer u klantorganisaties maakt met de door u gekozen inrichtingsmethode, worden deze automatisch gemaakt in dezelfde regio als uw partnerorganisatie. Dit gedrag is zo bepaald. We verwachten van multinationale partners dat ze in elke regio een partnerorganisatie creëren waar ze klantorganisaties beheren.

  • Rapportage over het gebruik van vergaderingen en berichten is beschikbaar via de klantorganisatie in Control Hub.

Bekende problemen en beperkingen

Zie Bekende problemen en beperkingen voor een actuele lijst met bekende problemen en beperkingen met het Webex voor Cisco BroadWorks-aanbod.

Berichtenlimieten

De volgende opslaglimieten voor gegevens (berichten en bestanden gecombineerd) zijn van toepassing op organisaties die Webex voor Cisco BroadWorks-services hebben aangeschaft via een serviceprovider. Deze limieten vertegenwoordigen de maximale opslag voor berichten en bestanden gecombineerd.

  • Basis: 2 GB per gebruiker gedurende 3 jaar

  • Standaard 5 GB per gebruiker gedurende 3 jaar

  • Premie: 10 GB per gebruiker gedurende 5 jaar

Voor elke klantorganisatie worden deze totalen per gebruiker samengevoegd om een geaggregeerd totaal voor die klant op te geven, op basis van het aantal gebruikers. Een bedrijf met vijf premium-gebruikers heeft bijvoorbeeld een totale limiet voor berichten en bestandsopslag van 50 GB. Een individuele gebruiker kan de limiet per gebruiker (10 GB) overschrijden op voorwaarde dat het bedrijf nog onder het geaggregeerde maximum (50 GB) zit.

Voor teamruimten die worden gemaakt, gelden de berichtlimieten voor het geaggregeerde totaal voor de klantorganisatie die eigenaar is van de teamruimte. U vindt informatie over de eigenaar van individuele teamruimten in het ruimtebeleid. Zie https://help.webex.com/en-us/baztm6/Webex-Space-Policy voor meer informatie over het bekijken van het ruimtebeleid voor een individuele teamruimte.

Aanvullende informatie

Raadpleeg https://help.webex.com/en-us/n8vw82eb/Webex-Capacities voor meer informatie over algemene berichtbeperkingen die van toepassing zijn op Webex-ruimten van het berichtenteam.

Beveiliging, gegevens en rollen

Webex-beveiliging

De Webex-client is een veilige toepassing die veilige verbindingen maakt met Webex en BroadWorks. De gegevens die in de Webex-cloud zijn opgeslagen en via de Webex-app aan de gebruiker zijn blootgesteld, worden zowel onderweg als in rust gecodeerd.

Meer informatie over gegevensuitwisseling vindt u in het deel Referentie van dit document.

Bijkomende lectuur

Locatie organisatiegegevens

We slaan uw Webex-gegevens op in het datacenter dat het meest overeenkomt met uw regio. Zie Gegevensresidentie in Webex in het Helpcentrum.

Rollen

Beheerder serviceprovider (u): Voor dagelijkse onderhoudsactiviteiten beheert u de lokale (bel)onderdelen van de oplossing met behulp van uw eigen systemen. U beheert de Webex-onderdelen van de oplossing via Partner Hub.

Zie Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM voor informatie over de rollen die beschikbaar zijn voor partners, de toegangsrechten die bij deze rollen horen en hoe u rollen kunt toewijzen.


 
De eerste gebruiker die is ingericht voor een nieuw partnerorganizaiton, wordt automatisch toegewezen aan de rollen Volledige beheerder en Volledige partnerbeheerder. Die beheerder kan het bovenstaande artikel gebruiken om extra rollen toe te wijzen.

Cisco Cloud Operations-team: Maakt uw 'partnerorganisatie' in Partner Hub, als deze niet bestaat, tijdens uw onboarding.

Zodra u uw Partner Hub-account hebt, configureert u de Webex-interfaces met uw eigen systemen. Vervolgens maakt u 'Onboarding-sjablonen' om de suites of pakketten weer te geven die via deze systemen worden aangeboden. Vervolgens richt u uw klanten of abonnees in.

#

Typische taak

SP

Cisco

1

Onboarding voor partners - De partnerorganisatie maken als deze nog niet bestaat en de benodigde functieschakelaars inschakelen

2

BroadWorks-configuratie in partnerorganisatie via Partner Hub (cluster)

3

Integratie-instellingen configureren in de partnerorganisatie via Partner Hub (aanbiedingssjablonen, branding)

4

BroadWorks-omgeving voorbereiden voor integratie (AS, XSP|ADP Patching, firewalls, XSP|ADP-configuratie, XSI, AuthService, CTI, NPS, DMS-toepassingen op XSP|ADP)

5

Inrichtingsintegratie of -proces ontwikkelen

6

GTM-materialen voorbereiden

7

Nieuwe gebruikers migreren of inrichten

Architectuur

Wat staat er in het diagram?

Clients

  • De Webex-app-client dient als de primaire toepassing in Webex voor Cisco BroadWorks-aanbiedingen. De client is beschikbaar op desktop-, mobiele en webplatforms.

    De client heeft systeemeigen chat-, presence- en meerpartijenaudio-/videovergaderingen die door de Webex-cloud worden geleverd. De Webex-client gebruikt uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken.

  • Cisco IP-telefoons en gerelateerde accessoires gebruiken ook uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken. We verwachten telefoons van derden te kunnen ondersteunen.

  • Activeringsportal voor gebruikers om zich aan te melden bij Webex met hun BroadWorks-aanmeldgegevens.

  • Partner Hub is een webinterface voor het beheren van uw Webex-organisatie en de organisaties van uw klanten. In Partner Hub kunt u de integratie tussen uw BroadWorks-infrastructuur en Webex configureren. U gebruikt ook Partner Hub om de clientconfiguratie en facturering te beheren.

Netwerk van serviceproviders

Het groene blok links op het diagram staat voor uw netwerk. Componenten die in uw netwerk worden gehost, bieden de volgende services en interfaces aan andere delen van de oplossing:

  • Openbare XSP|ADP, voor Webex voor Cisco BroadWorks: (De box staat voor een of meerdere XSP|ADP-boerderijen, mogelijk aan de voorkant door lastbalancers.)

    • Host de Xtended Services-interface (XSI-acties en XSI-gebeurtenissen), de Device Management-service (DMS), CTI-interface en de verificatieservice. Samen stellen deze toepassingen telefoons en Webex-clients in staat om zichzelf te verifiëren, hun gespreksconfiguratiebestanden te downloaden, gesprekken te starten en te ontvangen en elkaars haakstatus (telefonische aanwezigheid) en gespreksgeschiedenis te bekijken.

    • Publiceert directory naar Webex-clients.

  • Openbare XSP|ADP, met NPS:

    • Pushserver voor hostmeldingen: Een pushserver voor meldingen op een XSP|ADP in uw omgeving. Het werkt samen tussen uw toepassingsserver en onze NPS-proxy. De proxy levert korte tokens aan uw NPS om meldingen naar de cloudservices te autoriseren. Deze services (APNS & FCM) verzenden gespreksmeldingen naar Webex-clients op Apple iOS- en Google Android-apparaten.

  • Toepassingsserver:

    • Biedt gespreksbeheer en interfaces met andere BroadWorks-systemen (doorgaans)

    • Voor flowthrough-inrichting wordt het AS gebruikt door de partnerbeheerder om gebruikers in te richten in Webex

    • Hiermee wordt het gebruikersprofiel naar BroadWorks gepusht

  • OSS/BSS: Uw Operations Support System / Business SIP-services voor het beheer van uw BroadWorks-ondernemingen.

Webex Cloud

Het blauwe blok in het diagram staat voor de Webex-cloud. Webex-microservices ondersteunen het volledige spectrum van Webex-samenwerkingsmogelijkheden:

  • Cisco Common Identity (CI) is de identiteitsservice binnen Webex.

  • Webex voor Cisco BroadWorks staat voor de set microservices die de integratie tussen Webex en de gehoste BroadWorks-serviceprovider ondersteunen:

    • API's voor gebruikersinrichting

    • Configuratie van serviceprovider

    • Gebruikersaanmelding met BroadWorks-aanmeldgegevens

  • Webex-berichtenbox voor berichtengerelateerde microservices.

  • Webex Meetings-venster voor mediaverwerkingsservers en SBC's voor videovergaderingen met meerdere deelnemers (SIP & SRTP)

Webservices van derden

De volgende onderdelen van derden zijn weergegeven in het diagram:

  • APNS (Apple Push Notifications Service) pusht oproep- en berichtmeldingen naar Webex-toepassingen op Apple-apparaten.

  • FCM (FireBase Cloud Messaging) pusht meldingen voor gesprekken en berichten naar Webex-toepassingen op Android-apparaten.

XSP|ADP-architectuuroverwegingen

De rol van openbare XSP|ADP-servers in Webex voor Cisco BroadWorks

De openbare XSP|ADP in uw omgeving biedt de volgende interfaces/services aan Webex en clients:

  • Verificatieservice (AuthService), beveiligd door TLS, die reageert op Webex-verzoeken voor BroadWorks JWT (JSON Web Token) namens de gebruiker

  • CTI-interface, beveiligd door mTLS, waarop Webex zich abonneert voor gebeurtenissen uit de gespreksgeschiedenis en aanwezigheidsstatus van telefonie vanuit BroadWorks (haakstatus).

  • Xsi-acties en -gebeurtenissen-interfaces (eXtended Services Interface) voor gespreksbeheer voor abonnees, telefoonlijsten voor contactpersonen en gesprekslijsten en configuratie van de telefoonservice voor eindgebruikers

  • DM-service (Device Management) voor clients om hun configuratiebestanden voor gesprekken op te halen

Geef URL's op voor deze interfaces wanneer u Webex voor Cisco BroadWorks configureert. (Zie Uw BroadWorks-clusters configureren in Partnerhub in dit document.) Voor elk cluster kunt u slechts één URL voor elke interface opgeven. Als u meerdere interfaces hebt in uw BroadWorks-infrastructuur, kunt u meerdere clusters maken.

XSP|ADP-architectuur

XSP|ADP-architectuur: Optie 1
XSP|ADP-architectuur: Optie 2

We vereisen dat u een afzonderlijk, toegewezen XSP|ADP-exemplaar of -farm gebruikt om uw NPS-toepassing (Notification Push Server) te hosten. U kunt dezelfde NPS gebruiken met UC-One SaaS of UC-One Collaborate. Het is echter mogelijk dat u de andere toepassingen die vereist zijn voor Webex voor Cisco BroadWorks niet host op dezelfde XSP|ADP die de NPS-toepassing host.

We raden u aan een speciaal XSP|ADP-exemplaar/farm te gebruiken om de vereiste toepassingen voor Webex-integratie te hosten om de volgende redenen:

  • Als u bijvoorbeeld UC-One SaaS aanbiedt, raden we u aan een nieuwe XSP|ADP-farm te maken voor Webex voor Cisco BroadWorks. Op deze manier kunnen de twee diensten onafhankelijk werken terwijl u abonnees migreert.

  • Als u de Webex voor Cisco BroadWorks-toepassingen op een XSP|ADP-boerderij zoekt die voor andere doeleinden wordt gebruikt, is het uw verantwoordelijkheid om het gebruik te controleren, de daaruit voortvloeiende complexiteit te beheren en de verhoogde schaal te plannen.

  • De Cisco BroadWorks-systeemcapaciteitsplanner gaat uit van een specifieke XSP|ADP-farm en is mogelijk niet juist als u deze gebruikt voor collocatieberekeningen.

Tenzij anders vermeld, moet de speciale Webex voor Cisco BroadWorks XSP|ADP's de volgende toepassingen hosten:

  • Verificatieservice (TLS met CI-tokenvalidatie of mTLS)

  • CTI (mTLS)

  • XSI-acties (TLS)

  • XSI-gebeurtenissen (TLS)

  • DMS (TLS): optioneel. Het is niet verplicht om een afzonderlijk DMS-exemplaar of -bedrijf specifiek voor Webex voor Cisco BroadWorks te implementeren. U kunt hetzelfde DMS-exemplaar gebruiken dat u gebruikt voor UC-One SaaS of UC-One Collaborate.

  • Webview Gespreksinstellingen (TLS): optioneel. Webview voor gespreksinstellingen (CSW) is alleen vereist als u wilt dat Webex voor Cisco BroadWorks-gebruikers gespreksfuncties kunnen configureren in de Webex-app.

Webex vereist toegang tot CTI via een interface die is beveiligd door wederzijdse TLS-verificatie. Om deze vereiste te ondersteunen, raden we een van de volgende opties aan:

  • (Diagram gelabeld met Optie 1) Eén XSP|ADP-exemplaar of -bedrijf voor alle toepassingen, met twee interfaces die op elke server zijn geconfigureerd: een mTLS-interface voor CTI en een TLS-interface voor andere apps zoals de AuthService.

  • (Diagram gelabeld met Optie 2) Twee XSP|ADP-instanties of -farms, een met een mTLS-interface voor CTI, en de andere met een TLS-interface voor andere apps, zoals de AuthService.


 

XSP|ADP-hergebruik

Als u een bestaande XSP|ADP-boerderij hebt die voldoet aan een van de bovenstaande voorgestelde architecturen (optie 1 of 2) en deze lichtjes wordt geladen, is het mogelijk om uw bestaande XSP|ADP's opnieuw te gebruiken. U moet controleren of er geen tegenstrijdige configuratievereisten zijn tussen bestaande toepassingen en de nieuwe toepassingsvereisten voor Webex. De twee belangrijkste overwegingen zijn:

  • Als u meerdere Webex-partnerorganisaties op de XSP|ADP moet ondersteunen, betekent dit dat u mTLS moet gebruiken op de verificatieservice (CI Token Validation wordt alleen ondersteund voor één partnerorganisatie op een XSP|ADP). Als u mTLS gebruikt op de verificatieservice, betekent dit dat u niet tegelijkertijd clients kunt hebben die basisverificatie gebruiken op de verificatieservice. Deze situatie zou hergebruik van de XSP|ADP voorkomen.

  • Als de bestaande CTI-service is geconfigureerd voor gebruik door clients met de veilige poort (doorgaans 8012) maar zonder mTLS (d.w.z. clientverificatie), is dat in strijd met de Webex-vereiste om mTLS te hebben.

Omdat de XSP|ADP’s veel toepassingen hebben en het aantal permutaties van deze toepassingen groot is, kunnen er andere niet-geïdentificeerde conflicten zijn. Om deze reden moet elk mogelijk hergebruik van XSP|ADP's worden geverifieerd in een lab met de beoogde configuratie voordat wordt toegewezen aan het hergebruik.

NTP-synchronisatie configureren op XSP|ADP

De implementatie vereist tijdsynchronisatie voor alle XSP|ADP's die u met Webex gebruikt.

Installeer de ntp pakket nadat u het besturingssysteem hebt geïnstalleerd en voordat u de BroadWorks-software installeert. Vervolgens kunt u NTP configureren tijdens de installatie van de XSP|ADP-software. Zie de BroadWorks-handleiding voor softwarebeheer voor meer informatie.

Tijdens de interactieve installatie van de XSP|ADP-software krijgt u de optie om NTP te configureren. Ga verder als volgt:

  1. Wanneer het installatieprogramma hierom vraagt, Do you want to configure NTP?, voer in y.

  2. Wanneer het installatieprogramma hierom vraagt, Is this server going to be a NTP server?, voer in n.

  3. Wanneer het installatieprogramma hierom vraagt, What is the NTP address, hostname, or FQDN?, voer het adres van uw NTP-server of een openbare NTP-service in, bijvoorbeeld, pool.ntp.org.

Als uw XSP|ADP's een stille (niet-interactieve) installatie gebruiken, moet het installatieconfiguratiebestand de volgende Key=Value-paren bevatten:

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

XSP|ADP-identiteits- en beveiligingsvereisten

Achtergrond

De protocollen en coderingen van Cisco BroadWorks TLS-verbindingen kunnen op verschillende specificiteitsniveaus worden geconfigureerd. Deze niveaus variëren van de meest algemene (SSL-provider) tot de meest specifieke (individuele interface). Een meer specifieke instelling overschrijft altijd een meer algemene instelling. Als deze niet zijn opgegeven, worden SSL-instellingen op een lager niveau overgenomen van hogere niveaus.

Als er geen instellingen worden gewijzigd ten opzichte van de standaardinstellingen, worden de standaardinstellingen van de SSL-provider door alle niveaus overgenomen (JSSE Java Secure Sockets Extension).

Lijst met vereisten

  • De XSP|ADP moet zichzelf verifiëren bij clients met een door een certificeringsinstantie ondertekend certificaat waarin de algemene naam of alternatieve naam voor het onderwerp overeenkomt met het domeingedeelte van de XSI-interface.

  • De Xsi-interface moet het TLSv1.2-protocol ondersteunen.

  • De Xsi-interface moet een cijfersuite gebruiken die aan de volgende vereisten voldoet.

    • Diffie-Hellman Ephemeral (DHE) of Elliptic Curves Diffie-Hellman Ephemeral (ECDHE) sleuteluitwisseling

    • AES-code (Advanced Encryption Standard) met een minimale blokgrootte van 128 bits (bijv. AES-128 of AES-256)

    • GCM (Galois/Counter Mode) of CBC (Cipher Block Chaining) cipher mode

      • Indien een CBC-code gebruikt wordt, is enkel de SHA2-familie van hash-functies toegelaten voor sleutelafleiding (SHA256, SHA384, SHA512).

De volgende cijfers voldoen bijvoorbeeld aan de vereisten:

  • 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


 

De XSP|ADP CLI vereist de IANA-naamgevingsconventie voor versleutelingssuites, zoals hierboven weergegeven, niet de openSSL-conventie.

Ondersteunde TLS-cijfers voor de AuthService- en XSI-interfaces


 

Deze lijst kan worden gewijzigd naarmate onze cloudbeveiligingsvereisten evolueren. Volg de huidige aanbeveling voor Cisco-cloudbeveiliging voor cijferselectie, zoals beschreven in de lijst met vereisten in dit document.

  • 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

Parameters voor Xsi-gebeurtenisschaal

Mogelijk moet u de grootte van de Xsi-Events-wachtrij en het aantal thread verhogen om het volume aan gebeurtenissen af te handelen dat de Webex voor Cisco BroadWorks-oplossing vereist. U kunt de parameters als volgt verhogen tot de weergegeven minimumwaarden (verlaag ze niet als ze boven deze minimumwaarden liggen):

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

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

Meerdere XSP|ADP's

Randelement lastverdeling

Als u een load balancing-element op uw netwerkrand hebt, moet dit transparant omgaan met de verdeling van verkeer tussen uw meerdere XSP|ADP-servers en de Webex voor Cisco BroadWorks-cloud en -clients. In dit geval geeft u de URL van de load balancer op aan de Webex voor Cisco BroadWorks-configuratie.

Opmerkingen over deze architectuur:

  • Configureer DNS zodat de clients de load balancer kunnen vinden wanneer ze verbinding maken met de Xsi-interface (zie DNS-configuratie).

  • We raden u aan het randelement te configureren in de reverse SSL-proxymodus om punt-naar-punt-gegevenscodering te garanderen.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam. U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

Internetgerichte XSP|ADP-servers

Als u de Xsi-interfaces rechtstreeks blootstelt, gebruikt u DNS om het verkeer te distribueren naar de meerdere XSP|ADP-servers.

Opmerkingen over deze architectuur:

  • Er zijn twee records vereist om verbinding te maken met de XSP|ADP-servers:

    • Voor Webex-microservices: Round-robin A/AAAA-records zijn vereist om de meerdere XSP|ADP IP-adressen te bereiken. De reden hiervoor is dat de Webex-microservices geen SRV-zoekopdrachten kunnen uitvoeren. Zie Webex-cloudservices voor voorbeelden.

    • Voor de Webex-app: Een SRV-record dat wordt omgezet in A-records waarbij elk A-record wordt omgezet in één XSP|ADP. Zie de Webex-app voor voorbeelden.

      Gebruik geprioriteerde SRV-records om de XSI-service te richten op de meerdere XSP|ADP-adressen. Geef prioriteit aan uw SRV-records zodat de microservices altijd naar dezelfde A-record gaan (en het volgende IP-adres) en alleen naar de volgende A-record (en IP-adres) gaan als het eerste IP-adres niet beschikbaar is. GEBRUIK GEEN round-robin-benadering voor de Webex-app.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam.

  • U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

HTTP-omleidingen vermijden

Soms is DNS geconfigureerd om de XSP|ADP-URL op te lossen naar een HTTP-laadbalancer en is de laadbalancer geconfigureerd voor omleiding via een reverse proxy naar de XSP|ADP-servers.

Webex volgt geen omleiding wanneer u verbinding maakt met de URL's die u levert, dus deze configuratie werkt niet.

Bestellen en inrichten

Bestellen en inrichten is van toepassing op deze niveaus:

  • Inrichting van partner/serviceprovider:

    Elke geïntegreerde Webex voor Cisco BroadWorks-serviceprovider (of reseller) moet worden geconfigureerd als een partnerorganisatie in Webex en de nodige rechten krijgen. Cisco Operations biedt de beheerder van de partnerorganisatie toegang tot het beheren van Webex voor Cisco BroadWorks op Webex Partner Hub. De partnerbeheerder moet alle vereiste inrichtingsstappen uitvoeren voordat hij/zij een klant/bedrijfsorganisatie kan inrichten.

  • Bestellen en inrichten klant/onderneming:

    Elke BroadWorks Enterprise die is ingeschakeld voor Webex voor Cisco BroadWorks, activeert het maken van een gekoppelde Webex-klantorganisatie. Dit proces vindt automatisch plaats als onderdeel van de inrichting van de gebruiker/abonnee. Alle gebruikers/abonnees binnen een BroadWorks-onderneming zijn ingericht in dezelfde Webex-klantorganisatie.

    Hetzelfde gedrag is van toepassing als uw BroadWorks-systeem is geconfigureerd als serviceprovider met groepen. Wanneer u een abonnee inricht in een BroadWorks-groep, wordt er automatisch een klantorganisatie gemaakt in Webex die overeenkomt met de groep.

  • Bestellen en inrichten van gebruikers/abonnees:

    Webex voor Cisco BroadWorks ondersteunt momenteel de volgende modellen voor gebruikersinrichting:

    • Flowthrough-inrichting met vertrouwde e-mails

    • Flowthrough-inrichting zonder vertrouwde e-mails

    • Zelfinrichting gebruiker

    • API-inrichting

Flowthrough-inrichting met vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u kunt bevestigen dat BroadWorks e-mailadressen van abonnees heeft die geldig en uniek zijn voor Webex, maakt en activeert deze inrichtingsoptie automatisch Webex-accounts met deze e-mailadressen als gebruikers-id's.

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Flowthrough-inrichting met vertrouwde e-mails

Flowthrough-inrichting zonder vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u niet kunt vertrouwen op de e-mailadressen van abonnees die in handen zijn van BroadWorks, maakt deze inrichtingsoptie Webex-accounts, maar kan deze niet worden geactiveerd totdat abonnees hun e-mailadressen leveren en valideren. Op dat moment kan Webex de accounts met deze e-mailadressen activeren als gebruikers-id's.

Flowthrough-inrichting zonder vertrouwde e-mails

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Zelfinrichting gebruiker

Met deze optie is er geen flowthrough-inrichting van BroadWorks naar Webex. Nadat u de integratie tussen Webex en uw BroadWorks-systeem hebt geconfigureerd, krijgt u een of meer koppelingen die specifiek zijn voor het inrichten van gebruikers binnen uw Webex voor Cisco BroadWorks-partnerorganisatie.

Vervolgens ontwerpt u uw eigen communicatie (of delegeert u aan uw klanten) om de link naar abonnees te verspreiden. De abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun eigen Webex-accounts te maken en te activeren.

Zelfinrichting gebruiker

Omdat de accounts zijn ingericht binnen het bereik van uw partnerorganisatie, kunt u gebruikerspakketten handmatig aanpassen via Partner Hub of de API gebruiken om dit te doen.


 

Gebruikers moeten bestaan in het BroadWorks-systeem dat u met Webex integreert, of ze mogen geen accounts maken met die koppeling.

Serviceproviderinrichting door API's

Webex toont een reeks openbare API's waarmee u Webex voor Cisco BroadWorks gebruikers-/abonneevoorzieningen kunt maken in uw bestaande gebruikersbeheerworkflow/-tools.

Serviceproviderinrichting door API's - Vertrouwde e-mails
Serviceproviderinrichting door API's - Niet-vertrouwde e-mails

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Toestelnummer bellen

Met ondersteuning voor de functie voor toestelbellen kunnen Webex-gebruikers van Cisco Broadworks andere gebruikers bellen met een toestel dat vergelijkbaar is met het primaire telefoonnummer binnen dezelfde onderneming. Dit is vooral handig voor gebruikers die geen DID-nummers hebben.

Tijdens het inrichten wordt het toestelnummer van de gebruikers opgeslagen in de Webex-directory als het toestelnummer van de gebruiker. Voor BroadWorks-gesprekken wordt het toestelnummer weergegeven in de Webex-app in het toestelveld van alle gebieden met de gespreksinitiatiemethode en het profiel van de gebruiker. Webex voor Cisco BroadWorks ondersteunt alleen-toestelgesprekken tussen gebruikers binnen dezelfde groep en verschillende groepen van dezelfde onderneming met de combinatie van kiescode voor locatie en toestel. Bellen tussen twee bedrijven die alleen extensies gebruiken, wordt echter niet ondersteund.

Er kan een toestel worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'toestel'

      • De toestelparameter moet expliciet worden doorgegeven als onderdeel van de API-oproep. Voor bedrijven/groepen waarvoor LDC (Location Dialing Code) is geconfigureerd, moet de toestelparameter de combinatie LDC en 'toestelnummer' zijn.

    • Flowthrough- of zelfactiveringsinrichting

      • Toestel en LDC (indien van toepassing) worden automatisch opgehaald uit BroadWorks.

  • Gespreksgebruikers of -entiteiten met alleen BroadWorks

    • Automatisch gesynchroniseerd vanuit BroadWorks via adreslijstsynchronisatie met de combinatie van LDC (Location Dialing Code) en toestelnummer.

Tabel 2. Toestelnummers beheren op basis van de inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Toestelnummer beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

Toestelnummer moet worden doorgegeven als parameter

Doorstroomd

Toestel automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

BroadWorks-telefoonlijsten

Lijsten met bedrijven, groepen of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing

Voorwaarden

  1. De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.

  2. Patch waarbij kiescodes voor toestelnummers en locaties worden toegevoegd aan XSI en inrichtingsadapter februari 2022 voor versie 23 of hoger als onderdeel van:

    • 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. Schakel de koptekst X-BroadWorks-Remote-Party-Info in op het AS met de onderstaande CLI-opdracht voor deze SIP-gespreksstroom die vereist is voor ondersteuning van de functie voor toestelbellen.

    AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Prioriteit oproepopties in de app

Als onderdeel van de ondersteuning voor de functie Toestelbellen wordt De prioriteitsinstelling voor gespreksopties van de app ook op partnerniveau aangeboden voor alle Webex voor Cisco Broadworks-partners. Met deze instelling kan de partner de gespreksprioriteitsinstellingen van al zijn beheerde klanten beheren vanuit Partner Hub. De prioriteitsinstelling voor app-gespreksopties voor een klant kan ook op klantniveau worden gewijzigd vanuit Control Hub.

De prioriteitsinstelling voor app-gespreksopties bevat toestel als tweede optie in zowel Partner Hub als Control Hub wanneer een Webex voor Cisco Broadworks-gebruiker nieuw is ingericht met toestel via een van de bovengenoemde inrichtingsmethoden.

Voor alle bestaande ingerichte organisaties heeft de uitbreidingsoptie de verborgen status (standaard) in de prioriteitsinstelling voor app-gespreksopties. Er wordt geen toestel weergegeven in de optie voor audio-/videogesprekken van de gebruiker in de Webex-app.

Hieronder ziet u de opties om de optie Toestelgesprek zichtbaar te maken voor de bestaande klanten:

  1. Als een partner wil dat al zijn beheerde klantorganisaties een toestel krijgen als een van de gespreksopties, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Partnerhub. Hierdoor kunnen de beheerde klantorganisaties de instelling van hun partner overnemen.

  2. Als een partner een toestel wil aanbieden in gespreksopties voor een specifieke klantorganisatie, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Control Hub.

Ondersteuning voor groepscontactpersonen

Met deze functie wordt de Webex for BroadWorks DirSync-service verbeterd door de beperking voor het synchroniseren van maximaal 1500 contactpersonen uit de telefoonlijsten van de groep in BroadWorks te verwijderen en partners in staat te stellen maximaal 30K contactpersonen uit een enkele telefoonlijst van de groep te synchroniseren en deze gelijk te maken met de verhoging van 30K contactpersonen voor de Enterprise telefoonlijst, die afzonderlijk is vrijgegeven.

Er is een totale limiet van 200K voor alle externe contactpersonen per organisatie, die van toepassing is op de som van Enterprise- en Group-telefoonlijsten in één BroadWorks-onderneming. Een BroadWorks-onderneming met een bedrijfstelefoonlijst met 30K en ook 5 groepstelefoonlijsten met elk 30K worden ondersteund (180K totaal per organisatie). Als er echter 6 groepstelefoonlijsten zijn met elk 30K, wordt dit niet ondersteund (210K totaal).


 

Deze functie is beschikbaar op aanvraag. Neem contact op met uw accountteam om dit in te schakelen.

  • Voordat u de functie inschakelt, moet een vereiste migratie worden uitgevoerd om groepen in te richten en te koppelen voor alle bestaande ingerichte gebruikers.

  • Het Cisco-team voert een interne API uit om bestaande ingerichte gebruikers te migreren om ze aan de juiste groep te koppelen. OPMERKING: Dit kan tot een week duren om te verwerken.

  • Zodra de migratie is voltooid voor de partner en de functie is ingeschakeld, worden alle nieuw ingerichte gebruikers op de juiste manier 'gegroepeerd'.

Nadat de functie is ingeschakeld, begint de DirSync-service met het synchroniseren van contactpersonen uit de telefoonlijst van de BroadWorks-groep in de speciale opslag voor groepscontactpersonen in de Webex-contactservice.

Tijdens het inrichten moet de bedrijfsgroep van de gebruiker worden opgeslagen in de Webex-directory om aan te geven tot welke groep deze gebruiker behoort. Met de koppeling van de gebruiker aan een BroadWorks-groep in de Webex-directory kan de Webex-app contact zoeken in de opslag voor de contactservicegroep voor de specifieke groep van de gebruiker.

Voor deze functie moeten de Webex for BroadWorks-abonnees in Webex worden ingericht met de BroadWorks-bedrijfs-groeps-id.

De BroadWorks Enterprise Group Id kan worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Webex voor Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'spEnterpriseGroupId'

      • De BroadWorks Enterprise Group Id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek.

    • Flowthrough- of zelfactiveringsinrichting

      • BroadWorks-bedrijfs-groeps-id wordt automatisch opgehaald uit BroadWorks.

    • Gespreksgebruikers of -entiteiten met alleen BroadWorks

      • Niet van toepassing. Het is niet vereist om de BroadWorks Enterprise Group-id voor deze gebruikers te synchroniseren.

Tabel 3. Beheer van Enterprise Group ID op basis van inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Bedrijfs-groeps-id beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

BroadWorks-bedrijfs groep-id moet worden doorgegeven als parameter spEnterpriseGroupId

Doorstroomd

BroadWorks-bedrijfs groep-id wordt automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Niet van toepassing

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Niet van toepassing

BroadWorks-telefoonlijsten

Contactpersonen in de telefoonlijsten van de BroadWorks-groep

Synchroniseren met Directory

Groepscontacten worden opgeslagen in de Webex-contactservice die is gekoppeld aan de specifieke groep

Lijsten met BroadWorks-enterpsie of persional-telefoons

Contactpersonen in de lijsten met zakelijke of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing


 

Openbare API moet worden bijgewerkt VÓÓR de MIGRATIE. Migratie kan niet worden voltooid totdat DEZE API is voltooid. De BroadWorks Enterprise Group-id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek https://developer.webex.com/docs/api/changelog#2023-march

Nadat de functie is ingeschakeld en als gevolg van de volgende adreslijstsynchronisatie worden de bedrijfsgebruikersgroepen ook weergegeven in Control Hub. Het visualiseren van de groepen in Control Hub voor Webex voor BroadWorks is in dit stadium puur informatief. Partner- en klantbeheerders mogen geen wijzigingen aanbrengen aan groepen of groepslidmaatschap in Control Hub, omdat deze wijzigingen niet worden teruggekoppeld naar BroadWorks. Groepsbeheer in Control Hub is bedoeld voor gebruik door partners die de komende API's voor contactbeheer gaan gebruiken.

Migratie en toekomstbestendigheid

De progressie van Cisco van de BroadSoft Unified Communications Client is om van UC-One naar Webex te gaan. Er is een overeenkomstige progressie van de ondersteunende services weg van het netwerk van serviceproviders – behalve bellen – naar het Webex-cloudplatform.

Of u nu UC-One SaaS of BroadWorks Collaborate gebruikt, de voorkeursmigratiestrategie is het implementeren van nieuwe, speciale XSP|ADP's voor integratie met Webex voor Cisco BroadWorks. U kunt de twee services parallel uitvoeren terwijl u klanten migreert naar Webex en uiteindelijk de infrastructuur terugverdienen die is gebruikt voor de vorige oplossing.

Aanbevolen documentabonnementen

Webex Help Center-artikelen (op help.webex.com) hebben een optie Abonneren waarmee u een e-mailmelding kunt ontvangen wanneer dat artikel wordt bijgewerkt.

We raden u aan u te abonneren op elk van de volgende artikelen om ervoor te zorgen dat u geen kritieke updates mist die van invloed zijn op de netwerkverbinding. Om u in te schrijven, gaat u naar elk van de onderstaande links en klikt u in het artikel dat wordt gelanceerd op de knop Subscribe.

We raden u aan om u minimaal in te schrijven voor bovenstaande lijst. De meeste Webex-artikelen en -documenten die worden vermeld onder Aanvullende documenten hebben echter een optie Abonneren. Als deze optie moet worden weergegeven, moet het artikel worden weergegeven op help.webex.com.


 
Er is geen abonnementsoptie voor landingspagina's van documentatie.

Aanvullende documenten

Raadpleeg de volgende gerelateerde documentatie voor meer informatie over Webex voor Cisco BroadWorks:

Webex voor Cisco BroadWorks-documenten

Partnerbeheerders kunnen de volgende documenten en sites gebruiken om informatie te verkrijgen over Webex voor Cisco BroadWorks.

Webex voor Cisco BroadWorks-artikelen

Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:

Cisco BroadWorks-documenten

Partnerbeheerders kunnen verwijzen naar de Cisco BroadWorks-site op cisco.com voor technische documenten die beschrijven hoe het Cisco BroadWorks-gedeelte van de oplossing moet worden geïmplementeerd:

Webex Help-artikelen

De volgende Webex Help-sites kunnen worden gebruikt om Webex-artikelen te vinden waarmee klantbeheerders en eindgebruikers Webex-functies kunnen gebruiken.

  • Webex van serviceproviders: deze landingspagina bevat koppelingen met informatie over aan de slag gaan en veelgebruikte artikelen voor gebruikers van de Webex-app die Webex-services hebben gekocht bij een serviceprovider.

  • Webex-helpcentrum: gebruik de zoekfunctie op help.webex.com om te zoeken naar aanvullende Webex-artikelen waarin de Webex-app en de Webex Meetings-functionaliteit worden beschreven. U kunt zoeken naar gebruikers- of beheerdersartikelen.

Documentatie voor ontwikkelaars

Uw omgeving voorbereiden

Beslissingspunten

Overweging Vragen om te beantwoorden Resources

Architectuur en infrastructuur

Hoeveel XSP|ADP’s?

Hoe nemen ze mTLS in?

Cisco BroadWorks-systeemcapaciteitsplanner

Technische handleiding voor Cisco BroadWorks-systemen

XSP|ADP CLI-referentie

Dit document

Klant- en gebruikersvoorzieningen

Kunt u bevestigen dat u e-mails vertrouwt in BroadWorks?

Wilt u dat gebruikers e-mailadressen opgeven om hun eigen accounts te activeren?

Kunt u tools maken om onze API te gebruiken?

Openbare API-documenten op https://developer.webex.com

Dit document

Branding Welke kleur en logo wilt u gebruiken? Brandingartikel van de Webex-app
Sjablonen Wat zijn uw verschillende gebruiksscenario's voor klanten? Dit document
Abonneefuncties per klant/onderneming/groep Kies een pakket om het serviceniveau per sjabloon te definiëren. Basic, Standard, Premium of Softphone.

Dit document

Functie-/pakketmatrix

Gebruikersverificatie BroadWorks of Webex Dit document
Inrichtingsadapter (voor flowthrough-inrichtingsopties)

Gebruikt u al geïntegreerde IM&P, bijv. voor UC-One SaaS?

Bent u van plan meerdere sjablonen te gebruiken?

Is er een meer voorkomende usecase voorzien?

Dit document

CLI-referentie toepassingsserver

Architectuur en infrastructuur

  • Met welke schaal gaat u beginnen? Het is mogelijk om in de toekomst op te schalen, maar uw huidige gebruiksinschatting zou de infrastructuurplanning moeten stimuleren.

  • Werk samen met uw Cisco-accountmanager/verkoopvertegenwoordiger om uw XSP|ADP-infrastructuur te vergroten, volgens de Cisco BroadWorks System Capacity Planner en de Cisco BroadWorks System Engineering Guide.

  • Hoe maakt Webex wederzijdse TLS-verbindingen met uw XSP|ADP's? Rechtstreeks naar de XSP|ADP in een DMZ, of via TLS-proxy? Dit is van invloed op uw certificaatbeheer en de URL's die u gebruikt voor de interfaces. (We ondersteunen geen ongecodeerde TCP-verbindingen met de rand van uw netwerk).

Klant- en gebruikersvoorzieningen

Welke gebruikersinrichtingsmethode past het beste bij u?

  • Flowthrough Provisioning Met Vertrouwde E-mails: Door de service 'Geïntegreerde IM&P' toe te wijzen op BroadWorks, wordt de abonnee automatisch ingericht in Webex.

    Als u ook kunt bevestigen dat de e-mailadressen van abonnees in BroadWorks geldig en uniek zijn voor Webex, kunt u de variant 'vertrouwde e-mail' van flowthrough-inrichting gebruiken. Webex-abonneeaccounts worden zonder hun tussenkomst gemaakt en geactiveerd. Ze downloaden gewoon de client en melden zich aan.

    E-mailadres is een belangrijk gebruikerskenmerk in Webex. Daarom moet de serviceprovider een geldig e-mailadres voor de gebruiker opgeven om deze in te richten voor Webex-services. Dit moet het e-mail-id-kenmerk van de gebruiker zijn in BroadWorks. We raden u aan deze ook te kopiëren naar het kenmerk Alternatieve id.

  • Flowthrough-inrichting zonder vertrouwde e-mails: Als u de e-mailadressen van abonnees niet kunt vertrouwen, kunt u nog steeds de geïntegreerde IM&P-service in BroadWorks toewijzen om gebruikers in Webex in te richten.

    Met deze optie worden de accounts gemaakt wanneer u de service toewijst, maar moeten de abonnees hun e-mailadressen opgeven en valideren om de Webex-accounts te activeren.

  • Zelfinrichting gebruiker: Voor deze optie is geen IM&P-servicetoewijzing in BroadWorks vereist. U (of uw klanten) distribueert in plaats daarvan een inrichtingskoppeling en de koppelingen om de verschillende clients te downloaden, met uw branding en instructies.

    Abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun Webex-accounts te maken en te activeren. Vervolgens downloaden ze de client en melden zich aan en haalt Webex een aantal extra configuraties over hen op vanuit BroadWorks (inclusief hun primaire nummers).

  • SP-beheerde inrichting via API's: Webex stelt een reeks openbare API's bloot waarmee serviceproviders gebruikersvoorzieningen/abonneevoorzieningen kunnen bouwen in hun bestaande workflows.

Inrichtingsvereisten

In de volgende tabel worden de vereisten voor elke inrichtingsmethode samengevat. Naast deze vereisten moet uw implementatie voldoen aan de algemene systeemvereisten die in deze handleiding worden beschreven.

Inrichtingsmethode

Vereisten

Doorstroominrichting

(Vertrouwde of niet-vertrouwde e-mails)

De Webex-provisioning-API voegt bestaande BroadWorks-gebruikers automatisch toe aan Webex zodra de gebruiker aan de vereisten voldoet en u de geïntegreerde IM+P-service inschakelt.

Er zijn twee stromen (vertrouwde e-mails of niet-vertrouwde e-mails) die u toewijst via de onboardsjabloon op Webex.

Vereisten voor BroadWorks:

  • Gebruiker bestaat in BroadWorks met een primair nummer of toestel.

  • De gebruiker krijgt de geïntegreerde IM+P-service toegewezen, die verwijst naar de URL van de Webex-inrichtingsservice.

  • Alleen vertrouwde e-mails. De gebruiker heeft een e-mailadres geconfigureerd in BroadWorks. We raden u aan om het e-mailadres ook toe te voegen aan het veld Alternatieve id, omdat de gebruiker zich op die manier kan aanmelden met BroadWorks-referenties.

  • BroadWorks heeft verplichte patches geïnstalleerd voor flowthrough-inrichting. Zie Vereiste patches met flowthrough-inrichting (hieronder) voor de patchvereisten.

  • BroadWorks AS is rechtstreeks verbonden met de Webex-cloud of de proxy van de inrichtingsadapter is geconfigureerd met verbinding met de URL van de Webex-inrichtingsservice.

    Zie Toepassingsserver configureren met inrichtingsservice-URL om de URL van de Webex-inrichtingsservice op te halen.

    Zie Cisco BroadWorks Implement Provisioning Adapter Proxy FD om de Provisioning Adapter Proxy te configureren.

Webex-vereisten:

Het onboardsjabloon bevat de volgende instellingen:

  • De schakelaar BroadWorks-flow via inrichting inschakelen is ingeschakeld.

  • De naam en het wachtwoord van het inrichtingsaccount worden toegewezen met de beheerdersreferenties op systeemniveau van BroadWorks

  • Gebruikersverificatie is ingesteld op Trust BroadWorks-e-mails of Niet-vertrouwde e-mails.

Zelfinrichting gebruiker

Beheerder biedt een bestaande BroadWorks-gebruiker een koppeling naar de portal voor gebruikersactivering. De gebruiker moet zich met de BroadWorks-referenties aanmelden bij de portal en een geldig e-mailadres opgeven. Nadat het e-mailadres is gevalideerd, haalt Webex aanvullende gebruikersinformatie op om de inrichting te voltooien.

Vereisten voor BroadWorks:

  • Gebruiker moet bestaan in BroadWorks met een primair nummer of toestel

Webex-vereisten:

Het onboardsjabloon bevat de volgende instellingen:

  • De schakelaar Flow Through Provisioning inschakelen is uitgeschakeld.

  • Gebruikersverificatie is ingesteld op Niet-vertrouwde e-mails.

  • Gebruikers toestaan zichzelf te activeren is ingeschakeld.

SP-beheerde inrichting via API

(Vertrouwde of niet-vertrouwde e-mails)

Webex toont een reeks openbare API's waarmee u gebruikersvoorzieningen kunt bouwen in uw bestaande werkstromen en tools. Er zijn twee stromen:

  • Vertrouwde e-mails: de API voorziet de gebruiker en past het BroadWorks-e-mailadres toe als het Webex-e-mailadres.

  • Niet-vertrouwde e-mails: de API voorziet in de gebruiker, maar de gebruiker moet zich aanmelden bij de User Activation Portal en een geldig e-mailadres opgeven.

Vereisten voor BroadWorks:

  • Gebruiker moet bestaan in BroadWorks met een primair nummer of toestel.

Webex-vereisten:

  • In de onboardsjabloon is de gebruikersverificatie ingesteld op Trust BroadWorks e-mails of Niet-vertrouwde e-mails.

  • U moet uw aanvraag registreren en hiervoor toestemming vragen.

  • U moet een OAuth-token aanvragen met de scopes die zijn gemarkeerd in het gedeelte 'Verificatie' van de Webex for BroadWorks-ontwikkelaarshandleiding.

  • Er moet een beheerder of inrichtingsbeheerder worden toegewezen aan uw partnerorganisatie.

Ga naar BroadWorks-abonnees om de API's te gebruiken.

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Ondersteunde taallandinstellingen

Tijdens het inrichten wordt de taal die in beheergebruiker is toegewezen aan de eerste ingerichte beheergebruiker automatisch toegewezen als de standaardlandinstelling voor die klantorganisatie. Deze instelling bepaalt de standaardtaal die wordt gebruikt voor activeringsmails, vergaderingen en uitnodigingen voor vergaderingen onder die klantorganisatie.

Taallandinstellingen met vijf tekens in (ISO-639-1)_(ISO-3166)-indeling worden ondersteund. en_VS komt bijvoorbeeld overeen met English_UnitedStates. Als er slechts een taal met twee letters wordt aangevraagd (in ISO-639-1-indeling), genereert de service een landinstelling met vijf tekens door de aangevraagde taal te combineren met een landcode uit de sjabloon, d.w.z. "requestedLanguage_CountryCode", als er geen geldige landinstelling kan worden verkregen, wordt de standaard verstandige landinstelling gebruikt op basis van de vereiste taalcode.

De volgende tabel bevat de ondersteunde landinstellingen en de toewijzing waarmee een taalcode van twee letters wordt omgezet in een landinstelling met vijf tekens voor situaties waarin een landinstelling met vijf tekens niet beschikbaar is.

Tabel 1. Ondersteunde taallandcodes

Ondersteunde taallandinstellingen

(ISO-639-1)_(ISO-3166)

Als er alleen een taalcode met twee letters beschikbaar is...

Taalcode (ISO-639-1) **

Gebruik in plaats daarvan Standaard verstandige landinstelling (ISO-639-1)_(ISO-3166)

en_VS

en_AU

en_GB

en_CA

en

en_VS

fr_vr

fr_CA

vr

fr_vr

cs_CZ, CZ

cs

cs_CZ, CZ

da_DK

da's, da's

da_DK

de_de

de

de_de

hu_HU

(aan)laars

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_NEE

nb

nb_NEE

pl_VERV.

verv.

pl_VERV.

pt_PT

pt_BR

pt

pt_PT

ru_ru

ru

ru_ru

ro_RO

ro

ro_RO

zh_CN

zh_TW

zweer

zh_CN

sv_SE

sv

sv_SE

ar_SA

ar, teken, teken

ar_SA

tr_TR

staartstuk

tr_TR


 

De landinstellingen es_CO, id_ID, nb_NO en pt_PT worden niet ondersteund door Webex Meeting-sites. Voor deze landinstellingen zijn De Webex Meetings-sites alleen in het Engels. Engels is de standaardlandinstelling voor sites als er geen/ongeldige/niet-ondersteunde landinstelling vereist is voor de site. Dit taalveld is van toepassing bij het maken van een organisatie- en Webex Meetings-site. Als er geen taal wordt vermeld in een bericht of in de API van de abonnee, wordt de taal van de sjabloon gebruikt als standaardtaal.

Branding

Partnerbeheerders kunnen geavanceerde merkaanpassingen gebruiken om aan te passen hoe de Webex app eruitziet voor de klantorganisaties die de partner beheert. Partnerbeheerders kunnen de volgende instellingen aanpassen om ervoor te zorgen dat de Webex -app het merk en de identiteit van hun bedrijf weerspiegelt:

  • Bedrijfslogo's

  • Unieke kleurenschema's voor de lichte modus of de donkere modus

  • Aangepaste ondersteunings-URL's

Meer informatie over het aanpassen van branding vindt u in Geavanceerde branding-aanpassingen configureren.


 
  • Aanpassingen voor basisbranding worden afgeschaft. We raden u aan Advanced Branding te implementeren, dat een breder scala aan aanpassingen biedt.

  • Voor meer informatie over hoe branding wordt toegepast bij het koppelen aan een bestaande klantorganisatie, raadpleegt u Voorwaarden van organisatiebijlage in het gedeelte Webex voor BroadWorks toevoegen aan bestaande organisatie.

Onboardingssjablonen

Met onboardsjablonen kunt u de parameters definiëren waarmee klanten en gekoppelde abonnees automatisch worden ingericht in Webex voor Cisco BroadWorks. U kunt indien nodig meerdere onboardsjablonen configureren, maar wanneer u een klant onboardt, is deze aan slechts één sjabloon gekoppeld (u kunt niet meerdere sjablonen op één klant toepassen).

Enkele van de primaire sjabloonparameters worden hieronder weergegeven.

Pakket

  • U moet een standaardpakket selecteren wanneer u een sjabloon aanmaakt (zie Pakketten in het gedeelte Overzicht voor meer informatie). Alle gebruikers die zijn ingericht met die sjabloon, hetzij door middel van flowthrough- of self-provisioning, ontvangen het standaardpakket.

  • U hebt controle over de pakketselectie voor verschillende klanten door meerdere sjablonen te maken en telkens verschillende standaardpakketten te selecteren. U kunt vervolgens verschillende inrichtingskoppelingen of verschillende inrichtingsadapters per onderneming distribueren, afhankelijk van de door u gekozen gebruikersinrichtingsmethode voor deze sjablonen.

  • U kunt het pakket met specifieke abonnees wijzigen vanaf deze standaard met behulp van de inrichtings-API (zie Webex voor Cisco BroadWorks API-documentatie of via Partner Hub (zie Gebruikerspakket wijzigen in Partner Hub).

  • U kunt het pakket van een abonnee niet wijzigen vanuit BroadWorks. De toewijzing van de geïntegreerde IM&P-service is in- of uitgeschakeld. Als de abonnee deze service in BroadWorks wordt toegewezen, definieert de Partner Hub-sjabloon die is gekoppeld aan de inrichtings-URL van de onderneming van die abonnee het pakket.

Doorverkoper en ondernemingen of serviceprovider en groepen?

  • De manier waarop uw BroadWorks-systeem is geconfigureerd, heeft invloed op de flow via inrichting. Als u een reseller bent met Enterprises, moet u de Enterprise-modus inschakelen wanneer u een sjabloon maakt.

  • Als uw BroadWorks-systeem is geconfigureerd in de serviceprovidermodus, kunt u de Enterprise-modus uitschakelen in uw sjablonen.

  • Als u van plan bent klantorganisaties in te richten met beide BroadWorks-modi, moet u verschillende sjablonen gebruiken voor groepen en bedrijven.


 
Zorg ervoor dat u de BroadWorks-patches hebt toegepast die vereist zijn voor doorstroominrichting. Zie Vereiste patches met doorstroominrichting voor meer informatie.

Verificatiemodus

Bepaal hoe u wilt dat abonnees zich verifiëren wanneer ze zich aanmelden bij Webex. U kunt de modus toewijzen met de instelling Verificatiemodus in de onboardingsjabloon. In de volgende tabel worden enkele opties beschreven.


 
Deze instelling heeft geen invloed op het aanmelden bij de User Activation Portal. Gebruikers die zich aanmelden bij de portal, moeten hun BroadWorks-gebruikers-id en -wachtwoord invoeren, zoals geconfigureerd in BroadWorks, ongeacht hoe u de verificatiemodus configureert in de onboardsjabloon.
VerificatiemodusBroadWorksWebex
Primaire gebruikersidentiteitBroadWorks-gebruikers-idE-mailadres
Identiteitsprovider

BroadWorks.

  • Als u een directe verbinding met BroadWorks configureert, wordt de Webex-app rechtstreeks geverifieerd bij de BroadWorks-server.

    Als u een directe verbinding wilt configureren, moet het selectievakje Directe BroadWorks-verificatie inschakelen zijn ingeschakeld in de BroadWorks-clusterconfiguratie op Partner Hub (de instelling is standaard uitgeschakeld).

  • Anders wordt verificatie naar BroadWorks mogelijk gemaakt via een intermediaire service die door Webex wordt gehost.

Cisco Common Identity
Meervoudige verificatie?NeeVereist Customer IdP die meervoudige verificatie ondersteunt.

Validatiepad gebruikergegevens

  1. Browser wordt gestart waarbij de gebruiker e-mail levert om de eerste aanmeldstroom te starten en de verificatiemodus te detecteren.

  2. De browser wordt vervolgens omgeleid naar een door Webex gehoste BroadWorks-aanmeldpagina (deze pagina is brandable)

  3. Gebruiker levert BroadWorks gebruikers-id en wachtwoord op de aanmeldpagina.

  4. Gebruikersreferenties worden gevalideerd met BroadWorks.

  5. Bij succes wordt een autorisatiecode verkregen van Webex. Dit wordt gebruikt om de benodigde toegangstokens voor Webex-services te verkrijgen.

  1. Browser wordt gestart waarbij de gebruiker e-mail levert om de eerste aanmeldstroom te starten en de verificatiemodus te detecteren.

  2. De browser wordt omgeleid naar IdP (Cisco Common Identity of Customer IdP), waar ze een aanmeldportal krijgen.

  3. Gebruiker levert de juiste aanmeldgegevens op de aanmeldpagina

  4. Verificatie met meerdere factoren kan plaatsvinden als de Customer IdP dit ondersteunt.

  5. Bij succes wordt een autorisatiecode verkregen van Webex. Dit wordt gebruikt om de benodigde toegangstokens voor Webex-services te verkrijgen.


 
Zie SSO-aanmeldstroom voor een gedetailleerder overzicht van de SSO-aanmeldstroom met directe verificatie naar BroadWorks.

UTF-8-codering met BroadWorks-verificatie

Met BroadWorks-verificatie raden we u aan UTF-8-codering voor de verificatiekoptekst te configureren. UTF-8 lost een probleem op dat zich kan voordoen met wachtwoorden die speciale tekens gebruiken waarbij de webbrowser de tekens niet goed codeert. Met behulp van een UTF-8-gecodeerde, basis 64-gecodeerde header lost dit probleem op.

U kunt UTF-8-codering configureren door een van de volgende CLI-opdrachten uit te voeren op de XSP of ADP:

  • XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

  • ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

Land

U moet een land selecteren wanneer u een sjabloon maakt. Dit land wordt automatisch toegewezen als het organisatieland voor alle klanten die zijn ingericht met de sjabloon in Common Identity. Daarnaast bepaalt het land van de organisatie de standaard internationale inbelnummers voor Cisco PSTN in Webex Meeting-sites.

De standaard internationale inbelnummers van de site worden ingesteld op het eerste beschikbare inbelnummer dat is gedefinieerd in het telefoniedomein op basis van het land van de organisatie. Als het land van de organisatie niet wordt gevonden in het inbelnummer dat is gedefinieerd in het telefoniedomein, wordt het standaardnummer van die locatie gebruikt.

Tabel 2. In de volgende tabel wordt de standaardlandcode voor inbellen weergegeven op basis van elke locatie:

S-nr.

Locatie

Landcode

Landnaam

1

AMER

+1

ONS, CA

2

APAC

+65

Singapore

3

ANUS, SCHEREN

+61

Australië

4

EMEA

+44

VK

5

EURO

+49

Duitsland

Regelingen voor meerdere partners

Gaat u Webex voor Cisco BroadWorks sublicentie geven aan een andere serviceprovider? In dit geval heeft elke serviceprovider een afzonderlijke partnerorganisatie nodig in Webex Control Hub om hen in staat te stellen de oplossing voor hun klantenbestand in te richten.

Inrichtingsadapter en sjablonen

Wanneer u flowthrough provisioning gebruikt, wordt de inrichtings-URL die u invoert in BroadWorks afgeleid van de sjabloon in Control Hub. U kunt meerdere sjablonen en dus meerdere inrichtings-URL's hebben. Hiermee kunt u per onderneming selecteren welk pakket u op abonnees wilt toepassen wanneer ze de geïntegreerde IM&P-service krijgen.

U moet overwegen of u een inrichtings-URL op systeemniveau wilt instellen als een standaardinrichtingspad en welke sjabloon u daarvoor wilt gebruiken. Op deze manier hoeft u alleen de inrichtings-URL expliciet in te stellen voor bedrijven die een andere sjabloon nodig hebben.

Houd er ook rekening mee dat u mogelijk al een inrichtings-URL op systeemniveau gebruikt, bijvoorbeeld met UC-One SaaS. Als dat het geval is, kunt u ervoor kiezen om de URL op systeemniveau te behouden voor het inrichten van gebruikers op UC-One SaaS en deze te overschrijven voor bedrijven die overstappen naar Webex voor Cisco BroadWorks. U kunt ook de andere kant op gaan en de URL op systeemniveau instellen voor Webex voor BroadWorks en de bedrijven die u wilt behouden op UC-One SaaS opnieuw configureren.

De configuratiekeuzes met betrekking tot deze beslissing worden beschreven in Toepassingsserver configureren met inrichtingsservice-URL.

Proxy inrichtingsadapter

Voor extra beveiliging kunt u met de Provisioning Adapter Proxy een HTTP(S)-proxy gebruiken op het Application Delivery Platform voor flowthrough-inrichting tussen de AS en Webex. De proxyverbinding maakt een end-to-end TCP-tunnel die verkeer tussen de AS en Webex doorgeeft, waardoor de AS geen directe verbinding met het openbare internet hoeft te maken. Voor veilige verbindingen kan TLS worden gebruikt.

Voor deze functie moet u de proxy instellen op BroadWorks. Zie voor meer informatie Beschrijving van de proxyfunctie van de Cisco BroadWorks-inrichtingsadapter.

Minimumvereisten

Accounts

Alle abonnees die u inricht voor Webex moeten bestaan in het BroadWorks-systeem dat u integreert met Webex. U kunt indien nodig meerdere BroadWorks-systemen integreren.

Alle abonnees moeten BroadWorks-licenties en een primair nummer of toestel hebben.

Webex gebruikt e-mailadressen als primaire id's voor alle gebruikers. Als u flowthrough-inrichting gebruikt met vertrouwde e-mails, moeten uw gebruikers geldige adressen hebben in het e-mailkenmerk in BroadWorks.

Als uw sjabloon BroadWorks-verificatie gebruikt, kunt u e-mailadressen van abonnees kopiëren naar het kenmerk Alternatieve id in BroadWorks. Hierdoor kunnen gebruikers zich aanmelden bij Webex met hun e-mailadressen en hun BroadWorks-wachtwoorden.

Uw beheerders moeten hun Webex-accounts gebruiken om zich aan te melden bij Partner Hub.


 
Het wordt niet ondersteund om een BroadWorks-beheerder te integreren in Webex voor Cisco BroadWorks. U kunt BroadWorks-bellende gebruikers met een primair nummer en/of toestel alleen onboarden. Als u flowthrough-inrichting gebruikt, moeten gebruikers ook de geïntegreerde IM&P-service krijgen toegewezen.

Servers in uw netwerk- en softwarevereisten

  • De BroadWorks-instantie(s) moet(en) ten minste de volgende servers bevatten:

    • Toepassingsserver (AS) met BroadWorks-versie zoals hierboven

    • Netwerkserver (NS)

    • Profielserver (PS)

  • Openbare XSP|ADP-server(s) of Application Delivery Platform (ADP) die aan de volgende vereisten voldoen:

    • Verificatieservice (BWAuth)

    • XSI-acties en -gebeurtenissen-interfaces

    • DMS (webapplicatie voor apparaatbeheer)

    • CTI-interface (intergratie van computertelefonie)

    • TLS 1.2 met een geldig certificaat (niet zelfondertekend) en vereiste tussenproducten. Vereist systeembeheerder om het opzoeken van bedrijven te vergemakkelijken.

    • Wederzijdse TLS-verificatie (mTLS) voor verificatieservice (vereist dat de openbare Webex-clientcertificaatketen als vertrouwensankers is geïnstalleerd)

    • Wederzijdse TLS-verificatie (mTLS) voor CTI-interface (vereist dat de openbare Webex-clientcertificaatketen als vertrouwensankers is geïnstalleerd)

  • Een afzonderlijke XSP/ADP-server die fungeert als een pushserver voor gespreksmeldingen (een NPS in uw omgeving die wordt gebruikt om gespreksmeldingen naar Apple/Google te pushen). We noemen het hier 'CNPS' om het te onderscheiden van de service in Webex die pushmeldingen voor berichten en aanwezigheid levert).

    Deze server moet op R22 of hoger zijn.

  • We mandaat een afzonderlijke XSP/ADP-server voor CNPS omdat de onvoorspelbaarheid van de belasting van Webex voor BWKS-cloudverbindingen een negatieve invloed kan hebben op de prestaties van de NPS-server, met als gevolg toenemende latentie van meldingen. Zie de Cisco BroadWorks System Engineering Guide voor meer informatie over de XSP|ADP-schaal.

Webex-app-platforms

Fysieke telefoons en accessoires

Apparaatintegratie

Zie de Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks voor meer informatie over het onboarden en gebruiken van OS- en MPP-apparaten in de serviceruimte voor Webex voor Cisco BroadWorks.

Apparaatprofielen

Hieronder staan de DTAF-bestanden die u op uw toepassingsservers moet laden om de Webex-app als een belclient te ondersteunen. Het zijn dezelfde DTAF-bestanden als gebruikt voor UC-One SaaS, maar er is een nieuwe config-wxt.xml.template bestand dat wordt gebruikt voor de Webex-app.

Als u de nieuwste apparaatprofielen wilt downloaden, gaat u naar de site van het Application Delivery Platform Software Downloads om de nieuwste DTAF-bestanden op te halen. Deze downloads werken voor zowel ADP als XSP.

Clientnaam

Type apparaatprofiel en pakketnaam

Webex Mobile-sjabloon

Type identiteit/apparaatprofiel: Verbinding maken - mobiel

DTAF: ucone-mobile-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Sjabloon voor Webex-tablet

Type identiteit/apparaatprofiel: Verbinding maken - tablet

DTAF: ucone-tablet-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Webex Desktop-sjabloon

Type identiteit/apparaatprofiel: Bedrijfscommunicator - PC

DTAF: ucone-desktop-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Identificeer/apparaatprofiel

Alle Webex voor Cisco BroadWorks-gebruikers moeten een Identity/Device Profile hebben toegewezen in BroadWorks dat een van de bovenstaande apparaatprofielen gebruikt om te bellen met de Webex-app. Het profiel biedt de configuratie waarmee de gebruiker gesprekken kan plaatsen.

OAuth-aanmeldgegevens voor uw Webex voor Cisco BroadWorks verkrijgen

Dien een serviceverzoek in bij uw onboardingagent of bij Cisco TAC om Cisco OAuth in te richten voor uw Cisco Identity Provider Federation-account.

Gebruik de volgende titel van het verzoek voor de respectieve functies:

  1. XSP|ADP AuthService Configuration' voor het configureren van de service op XSP|ADP.

  2. 'NPS-configuratie voor verificatie proxy instellen' om NPS te configureren voor het gebruik van de verificatieproxy.

  3. CI-gebruikers-UUID synchroniseren' voor CI-gebruikers-UUID synchroniseren. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.

  4. Configureer BroadWorks om Cisco-facturering voor BroadWorks en Webex Voor BroadWorks-abonnementen in te schakelen.

Cisco geeft u een OAuth-client-id, een clientgeheim en een vernieuwingstoken die 60 dagen geldig is. Als het token verloopt voordat u het gebruikt, kunt u een andere aanvraag indienen.


 

Als u al de referenties van de Cisco OAuth-identiteitsprovider hebt verkregen, voltooit u een nieuw serviceverzoek om uw referenties bij te werken.

Bestellingscertificaten

Certificaatvereisten voor TLS-verificatie

Voor alle vereiste toepassingen hebt u beveiligingscertificaten nodig, ondertekend door een bekende certificeringsinstantie en geïmplementeerd op uw openbare XSP|ADP's. Deze worden gebruikt om TLS-certificaatverificatie te ondersteunen voor alle inkomende verbindingen met uw XSP|ADP-servers.

Deze certificaten moeten uw XSP|ADP openbare volledig gekwalificeerde domeinnaam bevatten als algemene naam of alternatieve naam van het onderwerp.

De exacte vereisten voor het implementeren van deze servercertificaten zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt samengevat waar het door de CA ondertekende openbare servercertificaat in deze drie gevallen moet worden geladen:

De openbaar ondersteunde certificeringsinstanties die door de Webex-app worden ondersteund voor verificatie, worden weergegeven in Ondersteunde certificeringsinstanties voor hybride Webex-services.

Vereisten voor TLS-certificaat voor TLS-bridge Proxy

  • Het openbaar ondertekende servercertificaat wordt in de proxy geladen.

  • De proxy presenteert dit openbaar ondertekende servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • Een intern door een certificeringsinstantie ondertekend certificaat kan op de XSP|ADP worden geladen.

  • De XSP|ADP legt dit intern ondertekende servercertificaat voor aan de proxy.

  • De proxy vertrouwt de interne CA die het XSP|ADP-servercertificaat heeft ondertekend.

TLS-certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ

  • Het openbaar ondertekende servercertificaat wordt geladen in de XSP|ADP's.

  • De XSP|ADP's presenteren openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP|ADP's heeft ondertekend.

Aanvullende certificaatvereisten voor wederzijdse TLS-verificatie via de CTI-interface

Wanneer u verbinding maakt met de CTI-interface, presenteert Webex een clientcertificaat als onderdeel van wederzijdse TLS-verificatie. Het CA-/kettingcertificaat van het Webex-clientcertificaat kan worden gedownload via Control Hub.

Het certificaat downloaden:

Meld u aan bij Partner Hub en ga naar Instellingen > BroadWorks Calling en klik op de koppeling voor het downloaden van het certificaat.

De exacte vereisten voor het implementeren van deze Webex CA-certificaatketen zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

Het volgende diagram geeft een samenvatting van de certificaatvereisten in deze drie gevallen:

mTLS-certificaatuitwisseling voor CTI via verschillende Edge-configuraties

(Optie) Certificaatvereisten voor TLS-bridge Proxy

  • Webex presenteert een openbaar ondertekend clientcertificaat aan de proxy.

  • De proxy vertrouwt de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de vertrouwensopslag van de proxy. Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de proxy geladen.

  • De proxy presenteert het openbaar ondertekende servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • De volmachthebber legt een intern ondertekend clientcertificaat voor aan de XSP|ADP’s.

    Dit certificaat moet het uitbreidingsveld Extended Key Usage van x509.v3 bevatten met het BroadWorks-OID-doel 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS-clientAuth. Bijv.:

    X509v3 extensions:
        X509v3 Extended Key Usage:
            1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication

    De CN van het interne certificaat moet bwcticlient.webex.com.


     
    • Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

    • Openbare certificeringsinstanties zijn mogelijk niet bereid om certificaten te ondertekenen met het vereiste bedrijfseigen BroadWorks-OID. In het geval van een overbruggingsproxy moet u mogelijk een interne CA gebruiken om het clientcertificaat dat de proxy aanbiedt aan de XSP|ADP te ondertekenen.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP’s presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

  • De ClientIdentity van de toepassingsserver bevat de CN van het intern ondertekende clientcertificaat dat door de proxy wordt voorgelegd aan de XSP|ADP.

(Optie) Certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ

  • Webex presenteert een door een interne CA ondertekend Cisco-clientcertificaat aan de XSP|ADP's.

  • De XSP|ADP's vertrouwen de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de vertrouwensopslag van de proxy. Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de XSP|ADP's geladen.

  • De XSP|ADP's presenteren de openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP|ADP's heeft ondertekend.

  • De Application Server ClientIdentity bevat de algemene naam van het door Cisco ondertekende clientcertificaat dat door Webex wordt aangeboden aan de XSP|ADP.

Uw netwerk voorbereiden

Zie voor meer informatie over verbindingen die worden gebruikt door Webex voor Cisco BroadWorks: Netwerkvereisten voor Webex voor Cisco BroadWorks. Dit artikel bevat de lijst met IP-adressen, poorten en protocollen die vereist zijn om de ingress- en egress-regels van uw firewall te configureren.

Netwerkvereisten voor Webex-services

De voorgaande firewalltabellen met ingress- en exress-regels documenteren alleen de verbindingen die specifiek zijn voor Webex voor Cisco BroadWorks. Zie Netwerkvereisten voor Webex-services voor algemene informatie over verbindingen tussen de Webex-app en de Webex-cloud. Dit artikel is algemeen voor Webex, maar in de volgende tabel worden de verschillende gedeelten van het artikel aangegeven en wordt aangegeven hoe relevant elk gedeelte is voor Webex voor Cisco BroadWorks.

Tabel 3. Netwerkvereisten voor verbindingen met de Webex-app (algemeen)

Deel van artikel over netwerkvereisten

Relevantie van informatie

Overzicht van door Webex ondersteunde apparaattypen en protocollen

Informatief

Transportprotocollen en versleutelingscodes voor cloudgeregistreerde Webex-apps en -apparaten

Informatief

Webex-services - Poortnummers en protocollen

Moet gelezen worden

IP-subnetten voor Webex-mediaservices

Moet gelezen worden

Domeinen en URL's die toegankelijk moeten zijn voor Webex-services

Moet gelezen worden

Aanvullende URL's voor hybride Webex-services

Optioneel

Proxyfuncties

Optioneel

802.1X: netwerktoegangsbeheer op basis van poorten

Optioneel

Netwerkvereisten voor SIP-gebaseerde Webex-services

Optioneel

Netwerkvereisten voor Webex Edge Audio

Optioneel

Een overzicht van andere hybride Webex-services en documentatie

Optioneel

Webex-services voor FedRAMP-klanten

N.v.t.

Aanvullende informatie

Zie Firewall-whitepaper van de Webex-app (PDF) voor meer informatie.

Ondersteuning voor redundantie van BroadWorks

De Webex-cloudservices en de Webex-clientapps die toegang moeten krijgen tot het netwerk van de partner ondersteunen volledig de Broadworks XSP|ADP-redundantie die door de partner wordt geboden. Wanneer een XSP|ADP of site niet beschikbaar is voor gepland onderhoud of ongeplande reden, kunnen de Webex-services en -apps doorschakelen naar een andere XSP|ADP of site die door de partner wordt geleverd om een verzoek te voltooien.

Netwerktopologie

De Broadworks XSP|ADP's kunnen rechtstreeks op het internet worden geïmplementeerd of kunnen zich in een DMZ bevinden met een load balancing-element zoals de F5 BIG-IP. Om geo-redundantie te bieden, kunnen de XSP|ADP's worden geïmplementeerd in twee (of meer) datacenters, elk met een load balancer, elk met een openbaar IP-adres. Als de XSP|ADP's zich achter een load balancer bevinden, zien de Webex-microservices en -app alleen het IP-adres van de load balancer en lijkt Broadworks slechts één XSP|ADP te hebben, zelfs als er meerdere XSP|ADP's achter zitten.

In het onderstaande voorbeeld worden de XSP|ADP's geïmplementeerd op twee sites, Site A en Site B. Op elke site zijn er twee XSP|ADP's, voorafgegaan door een lastbalancer. Site A heeft XSP|ADP1 en XSP|ADP2 voor LB1, en Site B heeft XSP|ADP3 en XSP|ADP4 voor LB2. Alleen de lastbalancers worden op het openbare netwerk weergegeven en de XSP|ADP's bevinden zich in de privénetwerken van DMZ.

Webex-cloudservices

DNS-configuratie

De microservices van Webex Cloud moeten de Broadworks XSP|ADP-server(s) kunnen vinden om verbinding te maken met de Xsi-interfaces, de verificatieservice en CTI.

Webex Cloud-microservices voeren DNS A/AAAA-zoekopdrachten uit voor de geconfigureerde XSP|ADP-hostnaam en maken verbinding met het geretourneerde IP-adres. Dit kan een load balancing edge-element zijn, of de XSP|ADP-server zelf. Als er meerdere IP-adressen worden geretourneerd, wordt het eerste IP in de lijst geselecteerd. SRV-zoekopdrachten worden momenteel niet ondersteund.

Voorbeeld: De DNS van de partner A Record voor ontdekking van Round-Robin gebalanceerde internet-gerichte XSP|ADP-server/load balancers.

Recordtype

Naam

Doel

Doel

A

webex-cloud-xsp.example.com

198.51.100.48

Verwijst naar LB1 (Site A)

A

webex-cloud-xsp.example.com

198.51.100.49

Verwijst naar LB2 (Site B)


 

Elke verwijzing naar XSP omvat XSP of ADP.

Failover

Wanneer de Webex-microservices een verzoek naar de XSP|ADP/Load Balancer verzenden en het verzoek mislukt, kunnen er verschillende dingen gebeuren:

  • Als de fout te wijten is aan een netwerkfout (bv.: TCP, SSL) markeren de Webex-microservices het IP als geblokkeerd en voeren ze onmiddellijk een route door naar het volgende IP.

  • Als er een foutcode (HTTP 5xx) wordt geretourneerd, markeren de Webex-microservices het IP als geblokkeerd en voeren ze onmiddellijk een route door naar het volgende IP.

  • Als er binnen 2 seconden geen HTTP-reactie wordt ontvangen, time-out van het verzoek en de Webex-microservices markeren het IP als geblokkeerd en voeren een route door naar het volgende IP.

Elk verzoek wordt 3 keer geprobeerd voordat een storing wordt teruggekoppeld naar de microservice.

Wanneer een IP in de geblokkeerde lijst staat, wordt het niet opgenomen in de lijst met adressen die moet worden geprobeerd bij het verzenden van een aanvraag naar een XSP|ADP. Na een vooraf bepaalde tijdsperiode verloopt een geblokkeerd IP en gaat het terug naar de lijst om te proberen wanneer een ander verzoek wordt gedaan.

Als alle IP-adressen zijn geblokkeerd, probeert de microservice de aanvraag nog steeds te verzenden door willekeurig een IP-adres te selecteren in de geblokkeerde lijst. Als dit is gelukt, wordt dat IP-adres verwijderd uit de geblokkeerde lijst.

Status

De status van de verbinding van de Webex-cloudservices met de XSP|ADP's of load balancers is te zien in Control Hub. Onder een BroadWorks-gesprekscluster wordt een verbindingsstatus weergegeven voor elk van deze interfaces:

  • XSI-acties

  • XSI-gebeurtenissen

  • Verificatieservice

De verbindingsstatus wordt bijgewerkt wanneer de pagina wordt geladen of tijdens invoerupdates. De verbindingsstatussen kunnen zijn:

  • Groen: Wanneer de interface kan worden bereikt op een van de IP's in Een recordzoekopdracht.

  • Rood: Wanneer alle IP's in de A-recordzoekopdracht niet bereikbaar zijn en de interface niet beschikbaar is.

De volgende services gebruiken de microservices om verbinding te maken met de XSP|ADP's en worden beïnvloed door de beschikbaarheid van de XSP|ADP-interface:

  • Aanmelden bij Webex-app

  • Token voor Webex-app vernieuwen

  • Niet-vertrouwde e-mail/zelfactivering

  • Gezondheidscontrole van Broadworks-service

Webex-app

DNS-configuratie

De Webex-app heeft toegang tot de services Xtended Services Interface (XSI-acties en XSI-gebeurtenissen) en Device Management Service (DMS) op de XSP|ADP.

Om de XSI-service te vinden, voert de Webex-app DNS SRV-zoekopdrachten uit voor _xsi-client._tcp.<webex app xsi domain>. De SRV verwijst naar de geconfigureerde URL voor de XSP|ADP-hosts of load balancers voor de XSI-service. Als SRV-zoekopdrachten niet beschikbaar zijn, keert de Webex-app terug naar A/AAAA-zoekopdrachten.

De SRV kan overschakelen op meerdere A/AAAA-doelen. Elke A/AAAA-record moet echter alleen naar één IP-adres worden toegewezen. Als er meerdere XSP|ADP's in een DMZ achter het load balancer/edge-apparaat zijn, moet de load balancer worden geconfigureerd om de sessiepersistentie te behouden en alle verzoeken van dezelfde sessie naar dezelfde XSP|ADP te routeren. We machtigen deze configuratie omdat de XSI-event heartbeats van de client naar dezelfde XSP|ADP moeten gaan die wordt gebruikt om het gebeurteniskanaal op te zetten.


 

In voorbeeld 1 bestaat de A/AAAA-record voor webex-app-XSP|ADP.example.com niet en hoeft deze niet te worden gebruikt. Als uw DNS vereist dat één A/AAAA-record moet worden gedefinieerd, mag slechts 1 IP-adres worden geretourneerd. De SRV moet echter nog steeds worden gedefinieerd voor de Webex-app.

Als de Webex-app de A/AAAA-naam gebruikt die wordt omgezet naar meer dan één IP-adres, of als het load balancer/edge-element geen sessiepersistentie handhaaft, verzendt de client uiteindelijk heartbeats naar een XSP|ADP waar het geen gebeurteniskanaal tot stand heeft gebracht. Dit resulteert in het afbreken van het kanaal en ook in aanzienlijk meer intern verkeer, wat de prestaties van uw XSP|ADP-cluster belemmert.

Omdat de Webex-cloud en de Webex-app verschillende vereisten hebben voor het opzoeken van A/AAAA-opnamen, moet u een afzonderlijke FQDN gebruiken voor toegang tot uw XSP|ADP's voor de Webex-cloud en de Webex-app. Zoals in de voorbeelden wordt weergegeven, gebruikt Webex Cloud Een record webex-cloud-xsp.example.com en de Webex-app gebruikt SRV _xsi-client._tcp.webex-app-xsp.example.com.

Voorbeeld 1: meerdere XSP|ADP's, elk achter afzonderlijke lastbalancers

In dit voorbeeld wijst de SRV naar A-records met elk Een record die naar een andere lastbalancer op een andere locatie wijzen. De Webex-app gebruikt altijd het eerste IP-adres in de lijst en gaat alleen naar de volgende record als de eerste is uitgeschakeld.

Hieronder vindt u een voorbeeld van SRV-records.

Recordtype

Opnemen

Doel

Doel

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc1.example.com

Clientdetectie van Xsi-interface

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc2.example.com

Clientdetectie van Xsi-interface

A

xsp-dc1.example.com

198.51.100.48

Verwijst naar LB1 (site A)

A

xsp-dc2.example.com

198.51.100.49

Punten naar LB2 (site B)

Voorbeeld 2: meerdere XSP|ADP's achter één lastbalancer (met TLS-brug)

Voor het eerste verzoek selecteert de load balancer een willekeurige XSP|ADP. XSP|ADP retourneert een cookie dat de Webex-app in toekomstige verzoeken bevat. Voor toekomstige verzoeken gebruikt de load balancer de cookie om de verbinding naar de juiste XSP|ADP te routeren, zodat het gebeurteniskanaal niet wordt verbroken.

Recordtype

Opnemen

Doel

Doel

SRV

_xsi-client._tcp.webex-app-xsp.example.com

LB.example.com

Lastbalancer

A

LB.voorbeeld.com

198.51.100.83

IP-adres van load balancer (XSP|ADP's bevinden zich achter load balancer)

URL DMS

Tijdens het aanmeldproces haalt de Webex-app ook de DMS-URL op om het configuratiebestand te downloaden. De host in de URL wordt geparseerd en de Webex-app voert DNS A/AAAA-zoekopdrachten uit van de host om verbinding te maken met de XSP|ADP die de DMS-service host.

Voorbeeld: DNS Een record voor het ontdekken van Round-Robin gebalanceerde internet-gerichte XSP|ADP-server/load balancers door de Webex-app om configuratiebestanden te downloaden via DMS:

Recordtype

Naam

Doel

Doel

A

xsp-dms.example.com

198.51.100.48

Verwijst naar LB1 (site A)

A

xsp-dms.example.com

198.51.100.49

Punten naar LB2 (site B)


 
Elke verwijzing naar XSP omvat XSP of ADP.
Hoe de Webex-app XSP|ADP-adressen vindt

De client probeert de XSP|ADP-knooppunten te vinden met behulp van de volgende DNS-flow:

  1. De client haalt aanvankelijk URL's voor Xsi-acties/Xsi-Events op uit de Webex-cloud (u hebt deze ingevoerd bij het maken van het gekoppelde BroadWorks-gesprekscluster). De Xsi-hostnaam/het Xsi-domein wordt geparseerd vanaf de URL en de client voert de SRV-zoekopdracht als volgt uit:

    1. De client voert een SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">

    2. Als de SRV-zoekopdracht een of meer A/AAAA-doelen retourneert:

      1. De client zoekt A/AAAA op voor deze doelen en slaat de geretourneerde IP-adressen in de cache.

      2. De client maakt verbinding met een van de doelen (en dus de A/AAAA-record met één IP-adres) op basis van de SRV-prioriteit, vervolgens het gewicht (of willekeurig als ze allemaal gelijk zijn).

    3. Als de SRV-zoekopdracht geen doelen retourneert:

      De client zoekt A/AAAA op van de Xsi-hoofdparameter en probeert vervolgens verbinding te maken met het geretourneerde IP-adres. Dit kan een load balancing edge-element zijn, of de XSP|ADP-server zelf.

      Zoals vermeld, moet de A/AAAA-record om dezelfde redenen worden omgezet naar één IP-adres.

  2. (Optioneel) U kunt vervolgens aangepaste XSI-acties/XSI-gebeurtenissen opgeven in de apparaatconfiguratie voor de Webex-app, met behulp van de volgende tags:

    <protocols>
    	<xsi>
    		<paths>
    			<root>%XSI_ROOT_WXT%</root>
    			<actions>%XSI_ACTIONS_PATH_WXT%</actions>
    			<events>%XSI_EVENTS_PATH_WXT%</events>
    		</paths>
    	</xsi>
    </protocols>
    1. Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.

    2. Als deze bestaan, vergelijkt de client met het oorspronkelijke XSI-adres dat hij heeft ontvangen via de BroadWorks-clusterconfiguratie.

    3. Als er een verschil wordt gedetecteerd, initialiseert de client de XSI-acties/ XSI Events-verbinding opnieuw. De eerste stap hierin is om hetzelfde DNS-opzoekproces uit te voeren dat wordt vermeld onder stap 1. Dit keer wordt een zoekopdracht aangevraagd voor de waarde in de parameter %XSI_ROOT_WXT% vanuit het configuratiebestand.


       
      Zorg ervoor dat u de bijbehorende SRV-records maakt als u deze tag gebruikt om de Xsi-interfaces te wijzigen.
Failover

Tijdens het aanmelden voert de Webex-app een DNS SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">, stelt een lijst met hosts op en maakt verbinding met een van de hosts op basis van de SRV-prioriteit en vervolgens het gewicht. Deze verbonden host wordt de geselecteerde host voor alle toekomstige aanvragen. Er wordt vervolgens een gebeurteniskanaal geopend voor de geselecteerde host en er wordt regelmatig een hartslag verzonden om het kanaal te verifiëren. Alle aanvragen die na de eerste worden verzonden, bevatten een cookie dat wordt geretourneerd in de HTTP-respons. Daarom is het belangrijk dat de load balancer de sessiepersistentie (affiniteit) behoudt en altijd aanvragen naar dezelfde backend XSP|ADP-server verzendt.

Als een verzoek of een heartbeat-verzoek aan een host mislukt, kunnen er verschillende dingen gebeuren:

  • Als de fout het gevolg is van een netwerkfout (bijv. TCP, SSL) gaat de route van de Webex-app onmiddellijk door naar de volgende host in de lijst.

  • Als er een foutcode (HTTP 5xx) wordt geretourneerd, markeert de Webex-app dat IP-adres als geblokkeerd en leidt deze door naar de volgende host in de lijst.

  • Als er niet binnen een bepaalde periode een reactie wordt ontvangen, wordt het verzoek als mislukt beschouwd vanwege een time-out en worden de volgende verzoeken naar de volgende host verzonden. Het time-outverzoek wordt echter als mislukt beschouwd. Sommige verzoeken worden opnieuw geprobeerd na een fout (met toenemende tijd voor opnieuw proberen). De verzoeken om het veronderstelde niet-vitale niet opnieuw te proberen.

Wanneer een nieuwe host is geprobeerd, wordt deze de nieuwe geselecteerde host als de host aanwezig is in de lijst. Nadat de laatste host in de lijst is geprobeerd, rolt de Webex-app over naar de eerste.

In het geval van heartbeat, als er twee opeenvolgende mislukte verzoeken zijn, initialiseert de Webex-app het gebeurteniskanaal opnieuw.

Houd er rekening mee dat de Webex-app geen fail-back uitvoert en dat DNS-servicedetectie slechts één keer wordt uitgevoerd bij het aanmelden.

Tijdens het aanmelden probeert de Webex-app het configuratiebestand te downloaden via de XSP|ADP/Dms-interface. Het voert een A/AAAA-recordzoekopdracht uit van de host in de opgehaalde DMS-URL en maakt verbinding met het eerste IP. Eerst wordt geprobeerd het verzoek om het configuratiebestand te downloaden te verzenden met een SSO-token. Als dit om welke reden dan ook mislukt, wordt het opnieuw geprobeerd, maar wel met de gebruikersnaam en het wachtwoord van het apparaat.

Webex voor BroadWorks implementeren

Implementatieoverzicht

De volgende diagrammen geven de typische volgorde van uw implementatietaken weer voor de verschillende gebruikersinrichtingsmodi. Veel van de taken zijn gemeenschappelijk voor alle inrichtingsmodi.

Shows the order of tasks required for deploying Webex for BroadWorks with flow-through provisioning and trusted emails
Taken vereist voor het implementeren van doorstroominrichting
Shows the order of tasks required for deploying Webex for BroadWorks with flow-through provisioning without emails
Taken vereist voor het implementeren van flowthrough-inrichting zonder vertrouwde e-mails
Shows the order of tasks required for deploying Webex for BroadWorks with self-activation
Taken vereist voor het implementeren van zelfinrichting van gebruikers

Onboarding van partners voor Webex voor Cisco BroadWorks

Elke Webex voor Cisco BroadWorks-serviceprovider of -reseller moet worden ingesteld als een partnerorganisatie voor Webex voor Cisco BroadWorks. Als u een bestaande Webex-partnerorganisatie hebt, kan dit worden gebruikt.

Om de noodzakelijke onboarding te voltooien, moet u uw Webex Cisco BroadWorks-papierwerk uitvoeren en moeten nieuwe partners de online overeenkomst voor indirecte kanaalpartners (ICPA) accepteren. Wanneer deze stappen zijn voltooid, maakt Cisco Compliance een nieuwe partnerorganisatie in Partner Hub (indien nodig) en verzendt een e-mail met verificatiegegevens naar de beheerder van uw administratie. Tegelijkertijd zal uw Partner Activation en/of Customer Success Program Manager contact met u opnemen om uw onboarding te starten.

Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's

We vereisen dat de NPS-toepassing op een andere XSP|ADP wordt uitgevoerd. Vereisten voor die XSP|ADP worden beschreven in Gespreksmeldingen configureren vanuit uw netwerk.

U hebt de volgende toepassingen/services nodig op uw XSP|ADP's.

Service/toepassing

Verificatie vereist

Doel van de dienst/toepassing

Xsi-gebeurtenissen

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, servicemeldingen

Xsi-acties

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, acties

Apparaatbeheer

TLS (server verifieert zichzelf bij clients)

Configuratie voor bellen downloaden

Verificatieservice

TLS (server verifieert zichzelf bij clients)

Gebruikersverificatie

Integratie van computertelefonie

mTLS (client en server verifiëren elkaar)

Telefonieaanwezigheid

Webview-toepassing voor gespreksinstellingen

TLS (server verifieert zichzelf bij clients)

Stelt gespreksinstellingen van gebruikers bloot in de selfcare-portal in de Webex-app

In dit gedeelte wordt beschreven hoe u de vereiste configuraties voor TLS en mTLS op deze interfaces kunt toepassen, maar u moet de bestaande documentatie raadplegen om de toepassingen op uw XSP|ADP's te laten installeren.

Vereisten co-residentie

  • De verificatieservice moet co-resident zijn met Xsi-toepassingen, omdat deze interfaces langdurige tokens voor serviceautorisatie moeten accepteren. De verificatieservice is vereist om deze tokens te valideren.

  • De verificatieservice en Xsi kunnen indien nodig op dezelfde poort worden uitgevoerd.

  • U kunt de andere services/toepassingen scheiden zoals vereist voor uw weegschaal (bijvoorbeeld dedicated device management XSP|ADP farm).

  • U kunt de Xsi-, CTI-, Authenticatieservice- en DMS-toepassingen co-lokaliseren.

  • Installeer geen andere toepassingen of services op de XSP|ADP's die worden gebruikt voor de integratie van BroadWorks met Webex.

  • Zoek de NPS-toepassing niet samen met andere toepassingen.

Xsi-interfaces

Installeer en configureer de Xsi-Actions- en Xsi-Events-toepassingen zoals beschreven in de Configuratiehandleiding voor Cisco BroadWorks Xtended Services Interface.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Voor alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moet dezelfde callControlApplicationName zijn gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker is geïntegreerd in Webex, maakt Webex een abonnement voor de gebruiker op de AS om telefoniegebeurtenissen te ontvangen voor aanwezigheid en gespreksgeschiedenis. Het abonnement is gekoppeld aan de callControlApplicationName en de AS gebruikt het om te weten naar welke Xsi-Events de telefonie-gebeurtenissen moeten worden verzonden.


 

Het wijzigen van de callControlApplicationName of het niet hebben van dezelfde naam op alle Xsi-Events-webapps zal invloed hebben op abonnementen en telefonie gebeurtenissen functionaliteit.

Verificatieservice configureren (met CI-tokenvalidatie)

Gebruik deze procedure om de verificatieservice te configureren voor het gebruik van CI-tokenvalidatie met TLS. Deze verificatiemethode wordt aanbevolen als u R22 of hoger gebruikt en uw systeem deze ondersteunt.


 

Wederzijdse TLS (mTLS) wordt ook ondersteund als een alternatieve verificatiemethode voor de verificatieservice. Als u meerdere Webex-organisaties op dezelfde XSP|ADP-server hebt uitgevoerd, moet u mTLS-verificatie gebruiken omdat CI-tokenvalidatie niet meerdere verbindingen met dezelfde XSP|ADP-verificatieservice ondersteunt.

Als u mTLS-verificatie wilt configureren voor de verificatieservice in plaats van CI-tokenvalidatie, raadpleegt u de bijlage voor Services configureren (met mTLS voor de verificatieservice).


 
Als u momenteel mTLS gebruikt voor de verificatieservice, is het niet verplicht om opnieuw te configureren voor het gebruik van CI-tokenvalidatie met TLS.
  1. Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.

  2. Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw versie:


     
    Elke verwijzing naar XSP omvat XSP of ADP.
  3. Installeer de AuthenticationService toepassing op elke XSP|ADP-service.

    1. Voer de volgende opdracht uit om de AuthenticationService-toepassing op de XSP|ADP te activeren op het contextpad /authService.

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
    2. Voer deze opdracht uit om de AuthenticationService te implementeren op de XSP|ADP:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
  4. Vanaf Broadworks build 2022.10 worden de certificerende autoriteiten die met Java komen niet meer automatisch opgenomen in de BroadWorks-vertrouwensopslag wanneer wordt overgeschakeld naar een nieuwe versie van java. De AuthenticationService opent een TLS-verbinding met Webex om het toegangstoken op te halen en moet het volgende in de truststore hebben om de IDBroker- en Webex-URL te valideren:

    • IdenTrust commercieel hoofd-CA 1

    • GoDaddy Root Certification Authority - G2

    Controleer of deze certificaten aanwezig zijn onder de volgende CLI

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

    Als dit niet aanwezig is, voert u de volgende opdracht uit om de standaard Java-trusts te importeren:

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

    U kunt deze certificaten ook handmatig toevoegen als vertrouwensankers met de volgende opdracht:

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

    Als de ADP is geüpgraded vanaf een vorige release, worden de certificeringsinstanties van de oude release automatisch geïmporteerd naar de nieuwe release en blijven ze geïmporteerd totdat ze handmatig worden verwijderd.


     

    De toepassing AuthenticationService is vrijgesteld van de instelling validatePeerIdentity onder ADP_CLI/System/SSLCommonSettings/GeneralSettings en valideert altijd de peer Identity. Zie de Cisco Broadworks X509 Certificate Validation FD voor meer informatie over deze instelling.

  5. Configureer de identiteitsproviders door de volgende opdrachten uit te voeren op elke XSP|ADP-server:

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

    • set clientId client-Id-From-Step1

    • set enabled true

    • set clientSecret client-Secret-From-Step1

    • set ciResponseBodyMaxSizeInBytes 65536

    • set issuerName <URL> —Voor de URL voer de URL van de IssuerName in die van toepassing is op uw CI-cluster. Zie volgende tabel.

    • set issuerUrl <URL> —Voor de URL voer de IssuerUrl in die van toepassing is op uw CI-cluster. Zie de volgende tabel.

    • set tokenInfoUrl <IdPProxy URL> —Voer de IdP-proxy-URL in die van toepassing is op uw Teams-cluster. Zie de tweede tabel die volgt.

    Tabel 1. Naam en URL van uitgever instellen
    Als CI-cluster is...Naam en URL van uitgever instellen op...

    US-A

    https://idbroker.webex.com/idb

    EU

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

    US-B

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


     
    Als u uw CI-cluster niet kent, kunt u de informatie verkrijgen via de klantgegevens in de helpdeskweergave van Control Hub.
    Tabel 2. TokenInfoURL instellen
    Als het Teams-cluster...TokenInfoURL instellen op... (IdP proxy-URL)

    ACHM, WATERPIJP

    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

    AASAPPEL

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


     
    • Als u uw Teams-cluster niet kent, kunt u de informatie verkrijgen via de klantgegevens in de helpdeskweergave van Control Hub.

    • Voor tests kunt u controleren of de tokenInfoURL geldig is door de " idp/authenticate" gedeelte van de URL met " ping".

  6. Geef de Webex-rechten op die aanwezig moeten zijn in het gebruikersprofiel in Webex door de volgende opdracht uit te voeren:

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

  7. Configureer identiteitsproviders voor Cisco Federation met de volgende opdrachten op elke XSP|ADP-server:

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

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

    • set refreshPeriodInMinutes 60

    • set refreshToken refresh-Token-From-Step1

  8. Voer de volgende opdracht uit om te valideren dat uw FLS-configuratie werkt. Met deze opdracht keert u de lijst met identiteitsproviders terug:

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

  9. Configureer Tokenbeheer met de volgende opdrachten op elke XSP|ADP-server:

    • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

    • set tokenIssuer BroadWorks

    • set tokenDurationInHours 720

  10. RSA-sleutels genereren en delen. U moet sleutels genereren op één XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's. Dit is te wijten aan de volgende factoren:

    • U moet dezelfde openbare/privésleutelparen gebruiken voor tokencodering/decodering in alle instanties van de verificatieservice.

    • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet uitgeven.


     
    Als u met de toetsen gaat fietsen of de lengte van de toetsen wijzigt, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw starten.
    1. Selecteer één XSP|ADP om een sleutelpaar te genereren.

    2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen in de browser van de client:

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

      (Dit genereert een privaat/openbaar sleutelpaar op de XSP|ADP, als dat er nog niet was)

    3. De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:

      XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere .keys bestand indien nodig.

    5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

  11. Geef de authService-URL op aan de webcontainer. De webcontainer van de XSP|ADP heeft de authService-URL nodig zodat deze tokens kan valideren. Op elk van de XSP|ADP's:

    1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het communicatiehulpprogramma BroadWorks:

      XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

    2. Voeg de URL van de verificatieservice toe aan de container:

      XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

      Hiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.

    3. Controleer de parameter met get.

    4. Start de XSP|ADP opnieuw op.

Clientverificatievereiste voor verificatieservice verwijderen (alleen R24)

Als u de verificatieservice met CI-tokenvalidatie op R24 hebt geconfigureerd, moet u ook de clientverificatievereiste voor de verificatieservice verwijderen. Voer de volgende CLI-opdracht uit:

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

TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)

De toepassingen Verificatieservice, Xsi-acties en Xsi-Events maken gebruik van HTTP-serverinterfaces. De TLS-configureerbaarheidsniveaus voor deze toepassingen zijn als volgt:

Meest algemeen = Systeem > Transport > HTTP > HTTP Server interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit CLI-context
Systeem (globaal)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze veilig zijn en of ze clientverificatie vereisen.

Apache tomcat vereist een certificaat voor elke veilige interface; het systeem genereert een zelfondertekend certificaat als dit nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2-protocol toevoegen aan de HTTP-serverinterface

De HTTP-interface die communiceert met de Webex-cloud moet zijn geconfigureerd voor TLSv1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren in de interface van de HTTP-server:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken in de HTTP-serverinterface

De vereiste cijfers configureren:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de interface van de HTTP-server.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 in de interface van de HTTP-server gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver

Profielserver en XSP|ADP zijn verplicht voor apparaatbeheer. Ze moeten worden geconfigureerd volgens de instructies in de configuratiehandleiding voor BroadWorks-apparaatbeheer.

CTI-interface en gerelateerde configuratie

De configuratievolgorde 'maximaal' wordt hieronder weergegeven. Het volgen van deze bestelling is niet verplicht.

  1. Toepassingsserver configureren voor CTI-abonnementen

  2. XSP|ADP's configureren voor mTLS geverifieerde CTI-abonnementen

  3. Inkomende poorten openen voor veilige CTI-interface

  4. Abonneer uw Webex-organisatie op BroadWorks CTI-gebeurtenissen

Toepassingsserver configureren voor CTI-abonnementen

Werk de ClientIdentity op de toepassingsserver bij met de algemene naam (CN) van het Webex voor Cisco BroadWorks CTI-clientcertificaat.

Voeg voor elke toepassingsserver die u met Webex gebruikt de certificaatidentiteit als volgt toe aan de ClientIdentity:

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


 

De algemene naam van het Webex voor Cisco BroadWorks-clientcertificaat is bwcticlient.webex.com.

TLS en cijfers configureren op de CTI-interface

De configureerbaarheidsniveaus voor de XSP|ADP CTI-interface zijn als volgt:

Meest algemeen = Systeem > Transport > CTI Interfaces > CTI interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit

CLI-context

Systeem (globaal)

(R22 en hoger)

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

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

Transportprotocollen voor dit systeem

(R22 en hoger)

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

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

Alle CTI-interfaces op dit systeem

(R22 en hoger)

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

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

Een specifieke CTI-interface op dit systeem

(R22 en hoger)

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

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


 

Bij een nieuwe installatie worden de volgende versleutelingen standaard op systeemniveau geïnstalleerd. Als er niets is geconfigureerd op het interfaceniveau (bijvoorbeeld op de CTI-interface of HTTP-interface), is deze coderingslijst van toepassing. Houd er rekening mee dat deze lijst in de loop der tijd kan veranderen:

  • TLS_ECDHE_RSA_MET_AES_128_GCM_SHA256

  • TLS_ECDHE_ECDSA_MET_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_MET_AES_128_CBC_SHA256

  • TLS_ECDHE_ECDSA_MET_AES_128_CBC_SHA256

  • TLS_DHE_DSS_MET_AES_128_GCM_SHA256

  • TLS_DHE_RSA_MET_AES_128_GCM_SHA256

  • TLS_DHE_RSA_MET_AES_128_CBC_SHA256

  • TLS_DHE_DSS_MET_AES_128_CBC_SHA256

  • TLS_ECDH_RSA_MET_AES_128_GCM_SHA256

  • TLS_ECDH_ECDSA_MET_AES_128_GCM_SHA256

  • TLS_ECDH_RSA_MET_AES_128_CBC_SHA256

  • TLS_ECDH_ECDSA_MET_AES_128_CBC_SHA256

CTI TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze een servercertificaat vereisen en of ze clientverificatie vereisen.

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

TLS 1.2-protocol toevoegen aan de CTI-interface

De XSP|ADP CTI-interface die communiceert met de Webex-cloud moet worden geconfigureerd voor TLS v1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren op de CTI-interface:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken op de CTI-interface

De vereiste cijfers configureren voor de CTI-interface:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Voer de get opdracht om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> <cipherName> om een code toe te voegen aan de CTI-interface.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 naar de CTI-interface gebruikt u: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Vertrouwensankers voor CTI-interface (R22 en hoger)

Bij deze procedure wordt ervan uitgegaan dat de XSP|ADP's ofwel naar het internet gericht zijn ofwel naar het internet gericht zijn via pass-through proxy. De certificaatconfiguratie is anders voor een brugproxy (zie TLS-certificaatvereisten voor TLS-brugproxy).

Ga als volgt te werk voor elke XSP|ADP in uw infrastructuur die CTI-gebeurtenissen publiceert in Webex:

  1. Aanmelden bij Partnerhub .

  2. Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om CombinedCertChain2023.txt op uw lokale computer.


     

    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze uploadt naar de XSP|ADP's. Alle bestanden zijn vereist.

  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE----- en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één tekstblok bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt

  5. Meld u aan bij de XSP|ADP en ga naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Optioneel) Uitvoeren help updateTrust om de parameters en opdrachtindeling weer te geven.

  7. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 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


     

    Alle aliassen moeten een andere naam hebben. webexclientroot2023 en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang alle ingangen uniek zijn.

  8. Bevestig dat de ankers zijn bijgewerkt:

    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. Clients toestaan te verifiëren met certificaten:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

CTI-interface toevoegen en mTLS inschakelen

  1. Voeg de CTI SSL-interface toe.

    De CLI-context is afhankelijk van uw BroadWorks-versie. De opdracht maakt een zelfondertekend servercertificaat in de interface en dwingt de interface om een clientcertificaat te vereisen.

    • Op BroadWorks R22 en R23:

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

  2. Vervang het servercertificaat en de sleutel op de CTI-interfaces van XSP|ADP. U hebt hiervoor het IP-adres van de CTI-interface nodig; u kunt dit lezen uit de volgende context:

    • Op BroadWorks R22 en R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Voer vervolgens de volgende opdrachten uit om het zelfondertekende certificaat van de interface te vervangen door uw eigen certificaat en privésleutel:

      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. Start de XSP|ADP opnieuw op.

Toegang tot BroadWorks CTI-gebeurtenissen inschakelen in Webex

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters configureert in Partner Hub. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters configureert in Partner Hub. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

  • Geef het CTI-adres op waarmee Webex zich kan abonneren op BroadWorks CTI Events.

  • CTI-abonnementen zijn per abonnee en worden alleen ingesteld en onderhouden terwijl die abonnee is ingericht voor Webex voor Cisco BroadWorks.

Webweergave Gespreksinstellingen

Call Settings Webview (CSWV) is een toepassing die wordt gehost op XSP|ADP zodat gebruikers hun BroadWorks-gespreksinstellingen kunnen wijzigen via een webview die ze in de softclient zien. Zie de Handleiding voor webview-oplossingen voor Cisco BroadWorks-gespreksinstellingen.

Webex maakt gebruik van deze functie om gebruikers toegang te geven tot algemene BroadWorks-gespreksinstellingen die niet eigen zijn aan de Webex-app.

Als u wilt dat uw Webex voor Cisco BroadWorks-abonnees toegang hebben tot gespreksinstellingen die verder gaan dan de standaardinstellingen die beschikbaar zijn in de Webex-app, moet u de functie Webview voor gespreksinstellingen implementeren.

De webview Gespreksinstellingen heeft twee onderdelen:

  • Webview-toepassing voor gespreksinstellingen, gehost op een Cisco BroadWorks XSP|ADP.

  • De Webex-app, die de gespreksinstellingen in een Webview weergeeft.

Gebruikerservaring

  • Windows-gebruikers: Klik op Gespreksinstellingen en klik vervolgens op Gespreksvoorkeuren openen > Geavanceerde gespreksinstellingen.

  • Mac-gebruikers: Klik op profielfoto en vervolgens op Voorkeuren > Geavanceerde gespreksinstellingen.

CSWV implementeren op BroadWorks

Webview Gespreksinstellingen installeren op XSP|ADP's

CSWV-toepassing moet zich op dezelfde XSP|ADP('s) bevinden als de host van de Xsi-Actions-interface in uw omgeving. Het is een onbeheerde toepassing op XSP|ADP, dus u moet een webarchiefbestand installeren en implementeren.

  1. Meld u aan bij cisco.com en zoek naar 'BWCallSettingsWeb' in het gedeelte software downloaden.

  2. Zoek en download de meest recente versie van het bestand.

    Bijvoorbeeld: BWCallSettingsWeb_1.8.2_1.war( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) was op het moment van schrijven het meest recent.

  3. Installeer, activeer en implementeer het webarchief volgens de configuratiehandleiding voor Cisco BroadWorks Xtended Service Platform voor uw XSP|ADP-versie. (Versie R24 is https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).

    1. Kopieer het .war-bestand naar een tijdelijke locatie op de XSP|ADP, zoals /tmp/.

    2. Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:

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

      De BroadWorks-softwaremanager valideert en installeert het bestand.

    3. [Optioneel] Verwijderen /tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist).

    4. Activeer de toepassing:

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      De naam en versie zijn verplicht voor elke toepassing, maar voor CSWV moet u ook een contextPath opgeven omdat het een onbeheerde toepassing is. U kunt alle waarden gebruiken die niet door een andere toepassing worden gebruikt, bijvoorbeeld: /callsettings.

    5. Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

  4. U kunt nu de URL voor gespreksinstellingen die u voor clients opgeeft, als volgt voorspellen:

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

    Opmerkingen:

    • U moet de trailing slash op deze URL opgeven wanneer u deze invoert in het clientconfiguratiebestand.

    • De XSP|ADP-FQDN moet overeenkomen met de FQDN voor Xsi-acties, omdat CSWV Xsi-acties moet gebruiken en CORS niet wordt ondersteund.

  5. Herhaal deze procedure voor andere XSP|ADP's in uw Webex voor Cisco BroadWorks-omgeving (indien nodig).

De toepassing Gespreksinstellingen Webview is nu actief op de XSP|ADP's.

Configureer de Webex-app om de webview met gespreksinstellingen te gebruiken

Zie de Webex voor Cisco BroadWorks-configuratiehandleiding voor meer informatie over clientconfiguratie.

Er is een aangepaste tag in het configuratiebestand van de Webex-app die u kunt gebruiken om de CSWV-URL in te stellen. Deze URL toont de gespreksinstellingen aan de gebruikers via de toepassingsinterface.

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

Configureer in de configuratiesjabloon van de Webex-app op BroadWorks de CSWV-URL in de tag %WEB_CALL_SETTINGS_URL_WXT%.

Als u de URL niet expliciet opgeeft, is de standaard leeg en is de pagina met gespreksinstellingen niet zichtbaar voor de gebruikers.

  1. Zorg ervoor dat u over de nieuwste configuratiesjablonen voor de Webex-app beschikt (zie Apparaatprofielen).

  2. Het doel voor webgespreksinstellingen instellen op csw:

    %WEB_CALL_SETTINGS_TARGET_WXT% csw

  3. Stel de URL voor webgespreksinstellingen voor uw omgeving in, bijvoorbeeld:

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

    U hebt deze waarde afgeleid bij het implementeren van de CSWV-toepassing.

  4. Het resulterende clientconfiguratiebestand moet als volgt worden ingevoerd:

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

     
    Elke verwijzing naar XSP omvat XSP of ADP.

Pushmeldingen voor gesprekken configureren in Webex voor Cisco BroadWorks

In dit document gebruiken we de term Call Notifications Push Server (CNPS) om een door XSP gehoste of door ADP gehoste toepassing te beschrijven die in uw omgeving wordt uitgevoerd. Uw CNPS werkt met uw BroadWorks-systeem om op de hoogte te zijn van binnenkomende gesprekken naar uw gebruikers en pusht meldingen van deze gesprekken naar de meldingsservices van Google Firebase Cloud Messaging (FCM) of Apple Push Notification Service (APN's).

Deze services melden de mobiele apparaten van Webex voor Cisco BroadWorks-abonnees dat ze inkomende gesprekken hebben op Webex.

Zie de functiebeschrijving van de pushserver voor meldingen voor meer informatie over NPS.

Een vergelijkbaar mechanisme in Webex werkt met Webex-berichten- en aanwezigheidsservices om meldingen naar de Google- (FCM) of Apple-meldingsservices (APNS) te pushen. Deze services brengen de mobiele Webex-gebruikers op hun beurt op de hoogte van inkomende berichten of aanwezigheidswijzigingen.


 

In dit gedeelte wordt beschreven hoe u NPS configureert voor de verificatieproxy wanneer de NPS nog geen andere apps ondersteunt. Als u een gedeelde NPS moet migreren om NPS-proxy te gebruiken, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruikenhttps://help.webex.com/nl5rir2/.

Overzicht van NPS-proxy

Voor compatibiliteit met Webex voor Cisco BroadWorks moet uw CNPS worden gepatcht ter ondersteuning van de NPS-proxyfunctie, Pushserver voor VoIP in UCaaS.

De functie implementeert een nieuw ontwerp in de pushserver voor meldingen om het beveiligingsprobleem van het delen van privésleutels voor pushmeldingscertificaten met serviceproviders voor mobiele clients op te lossen. In plaats van pushmeldingscertificaten en -sleutels te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een kortstondig pushmeldingstoken te verkrijgen van Webex voor Cisco BroadWorks-backend en gebruikt dit token voor verificatie met de Apple APN's en Google FCM-services.

De functie verbetert ook de mogelijkheid van de Notification Push Server om meldingen naar Android-apparaten te pushen via de nieuwe Google Firebase Cloud Messaging (FCM) HTTPv1 API.

APNS-overwegingen

Apple zal het op HTTP/1 gebaseerde binaire protocol over de Apple Push Notification-dienst na 31 maart 2021 niet langer ondersteunen. We raden u aan uw XSP|ADP te configureren om de op HTTP/2 gebaseerde interface voor APN's te gebruiken. Voor deze update moet uw XSP|ADP die de NPS host R22 of hoger uitvoeren.

Bereid uw NPS voor op Webex voor Cisco BroadWorks

1

Installeer en configureer een specifieke XSP (minimumversie R22) of Application Delivery Platform (ADP).

2

Installeer de NPS-verificatieproxypatches:

3

Activeer de toepassing Pushserver voor meldingen.

4

(Voor Android-meldingen) Schakel de FCM v1-API in op de NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.

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

6

Voeg een techsupport van de NPS XSP/ADP toe.

7

Op elke AS-server wordt het namedefs-bestand in /usr/local/broadworks/bw_base/conf moet worden geconfigureerd met SRV en A-records voor XSP/ADP-zoekopdrachten (Notification Push Server). Als er meerdere XSP/ADP zijn, voegt u voor elke zoekopdracht een vermelding toe.

Voorbeeld: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN EEN versie van 10.193.78.149


 

Na het instellen is een van de volgende opties vereist om de wijzigingen op te halen:

  1. Een restartbw wordt voorgevormd in een onderhoudsperiode.

  2. Via de Cisco BroadWorks CLI:

    R24 en ouder

    AS_CLI/ASDiagnostic/DNS> opnieuw laden

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> opnieuw laden

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> opnieuw laden

De volgende stappen

Als u een NPS opnieuw wilt installeren, gaat u naar NPS configureren om de verificatieproxy te gebruiken

Als u een bestaande Android-implementatie wilt migreren naar FCMv1, gaat u naar NPS migreren naar FCMv1

Configureer NPS om de verificatieproxy te gebruiken

Deze taak is van toepassing op een nieuwe installatie van NPS die is toegewezen aan Webex voor Cisco BroadWorks.

Als u de verificatieproxy wilt configureren op een NPS die met andere mobiele apps wordt gedeeld, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken ( https://help.webex.com/nl5rir2).

1

Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.

2

Maak het clientaccount aan op de 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: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get


 

De CiscoCI-uitgeverUrl moet ALTIJD een US CI-cluster zijn, ongeacht uw locatie. De standaardwaarde moet zijn:

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

Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):

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

(Voor Android-meldingen) Voeg de Android-toepassings-id toe aan de context van de FCM-toepassingen op de NPS.

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

5

(Voor Apple iOS-meldingen) Voeg de toepassings-id toe aan de context van de APNS-toepassingen en zorg ervoor dat u de verificatiesleutel weglaat. Stel deze in op leeg.

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

6

Configureer de volgende NPS-URL's:

XSP|ADP CLI-context

Parameter

Waarde

  • XSP|ADP_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|ADP_CLI/Applications/NotificationPushServer

    /APNS/Production>

url

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

7

Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:

XSP|ADP CLI-context

Parameter

Waarde

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen:

  1. Uitvoeren AS_CLI/System/PushNotification> get en controleer de waarde van enforceAllowedApplicationList. Als het true, moet u deze subtaak voltooien. Anders slaat u de rest van de deeltaak 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

Start de XSP|ADP opnieuw: bwrestart

10

Test gespreksmeldingen door gesprekken te voeren van een BroadWorks-abonnee naar twee mobiele Webex-gebruikers. Controleer of de gespreksmelding wordt weergegeven op iOS- en Android-apparaten.

NPS migreren naar FCMv1

Dit onderwerp bevat optionele procedures die u in Google FCM-console kunt gebruiken wanneer u een bestaande NPS-implementatie hebt die u naar FCMv1 moet migreren. Er zijn drie procedures:

UC-One-clients migreren naar FCMv1

Gebruik de onderstaande stappen in Google FCM-console om UC-One-clients te migreren naar Google FCM HTTPv1.


 

Als branding wordt toegepast op de client, moet de client de afzender-id hebben. Zie in de FCM-console Projectinstellingen > Cloud Messaging. De instelling wordt weergegeven in de aanmeldtabel voor het project.

Zie de Connect Mobile Branding Guide op 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? voor meer informatie. Raadpleeg de gcm_defaultSenderId parameter, die zich bevindt in het bestand Branding Kit, Resource folder, branding.xml met de onderstaande syntaxis:

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

  1. Meld u aan bij FCM-beheerder SDK op http://console.firebase.google.com.

  2. Selecteer de juiste Android-toepassing.

  3. Noteer de project-ID op het tabblad Algemeen

  4. Ga naar het tabblad Serviceaccounts om een serviceaccount te configureren. U kunt een nieuw serviceaccount maken of een bestaand serviceaccount configureren.

    Een nieuw serviceaccount maken:

    1. Klik op de blauwe knop om een nieuw serviceaccount aan te maken

    2. Klik op de blauwe knop om een nieuwe privésleutel te genereren

    3. Sleutel downloaden naar een veilige locatie

    Een bestaand serviceaccount hergebruiken:

    1. Klik op de blauwe tekst om bestaande serviceaccounts weer te geven.

    2. Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.

    3. Klik aan de rechterkant op het hamburgermenu en maak een nieuwe privésleutel aan.

    4. Download het json-bestand dat de sleutel bevat en sla het op naar een veilige locatie.

  5. Kopieer het json-bestand naar de XSP|ADP.

  6. Configureer de project-ID en:

    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. Configureer de toepassing:

    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. FCMv1 inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

SaaS-clients migreren naar FCMv1

Gebruik de onderstaande stappen op Google FCM Console als u SaaS-clients wilt migreren naar FCMv1.


 
Zorg ervoor dat u de procedure 'NPS configureren om verificatieproxy te gebruiken' al hebt voltooid.
  1. FCM uitschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

  3. FCM inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

ADP-server bijwerken

Gebruik de onderstaande stappen in Google FCM-console als u de NPS migreert om een ADP-server te gebruiken.

  1. Haal het JSON-bestand op van de Google Cloud-console:

    1. Ga op de Google Cloud Console naar de pagina Service Accounts.

    2. Klik op Selecteer een project, kies uw project en klik op Openen.

    3. Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.

    4. Selecteer een type Sleutel en klik op Aanmaken

      Het bestand wordt gedownload.

  2. FCM toevoegen aan de ADP-server:

    1. Importeer het JSON-bestand naar de ADP-server met de /bw/install opdracht.

    2. Meld u aan bij de ADP CLI en voeg project- en API-sleutel toe:

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

    3. Voeg vervolgens de toepassing en de sleutel toe:

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

    4. Controleer de configuratie:

      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

Uw partnerorganisatie configureren in Partner Hub

Uw BroadWorks-clusters configureren

[eenmaal per cluster]

Dit gebeurt om de volgende redenen:

  • Webex-cloud inschakelen om uw gebruikers te verifiëren met BroadWorks (via de door XSP|ADP gehoste verificatieservice).

  • Webex-apps inschakelen om de Xsi-interface te gebruiken voor gespreksbeheer.

  • Webex inschakelen om te luisteren naar door BroadWorks gepubliceerde CTI-gebeurtenissen (telefonische aanwezigheid en gespreksgeschiedenis).


 

De clusterwizard valideert de interfaces automatisch wanneer u ze toevoegt. U kunt de cluster blijven bewerken als een van de interfaces niet is gevalideerd, maar u kunt een cluster niet opslaan als er ongeldige invoer zijn.

We voorkomen dit omdat een onjuist geconfigureerde cluster problemen kan veroorzaken die moeilijk op te lossen zijn.

Wat u moet doen:

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Cluster toevoegen.

    Hiermee start u een wizard waarin u uw XSP|ADP-interfaces (URL's) levert. U kunt een poort toevoegen aan de interface-URL als u een niet-standaardpoort gebruikt.

  4. Geef dit cluster een naam en klik op Volgende.

    Het clusterconcept hier is slechts een verzameling van interfaces, meestal samengebracht op een XSP|ADP-server of -farm, waarmee Webex informatie van uw toepassingsserver (AS) kan lezen. U hebt mogelijk één XSP|ADP per AS-cluster of meerdere XSP|ADP's per cluster of meerdere AS-clusters per XSP|ADP. Schaalvereisten voor uw BroadWorks-systeem vallen hier buiten het bereik.

  5. (Optioneel) Een BroadWorks-gebruiker invoeren Accountnaam en Wachtwoord dat u weet dat u zich in het BroadWorks-systeem bevindt waarmee u verbinding maakt met Webex en klik vervolgens op Volgende.

    De validatietests kunnen dit account gebruiken om de verbindingen met de interfaces in het cluster te valideren.

  6. Voeg uw URL's voor XSI-acties en XSI-gebeurtenissen toe.

  7. Optioneel. Werk de DAS-URL bij met de URL van de apparaatactiveringsservice.

  8. Optioneel. Schakel het selectievakje Directe BroadWorks-verificatie inschakelen in als u wilt dat aanmeldingen bij BroadWorks rechtstreeks naar BroadWorks worden verzonden. Anders wordt verificatie naar BroadWorks via de Webex-gehoste IdP-proxyservice geproxy.

    Dit selectievakje is van invloed op deze aanmeldsituaties:

    • Aanmelding bij de gebruikersactiveringsportal: gebruikers moeten hun BroadWorks-aanmeldgegevens invoeren wanneer ze zich bij de portal aanmelden. De bovenstaande instelling bepaalt of de aanmelding rechtstreeks is naar BroadWorks of via de IdP-proxy.

    • Clientaanmelding: als BroadWorks-verificatie is geconfigureerd in de onboardsjabloon, bepaalt de bovenstaande instelling of de clientaanmelding bij de Webex-app rechtstreeks is naar BroadWorks of wordt geproxy via de IdP-proxy.

  9. Klik op Volgende.

  10. Ga als volgt te werk op de pagina CTI-interface:

    1. Voeg de CTI-URL en poort toe voor de CTI-interface waarmee u verbinding wilt maken.

    2. Optioneel. Schakel de schakelaar Gespreksgeschiedenis in en voer vervolgens uw BroadWorks-gebruikers-id in. Als deze optie is geselecteerd, worden BroadWorks-gespreksgeschiedenisgebeurtenissen gesynchroniseerd met de Webex-cloud. Gebruikers kunnen hun gespreksgeschiedenis bekijken in de Webex-app.

    3. Optioneel. Schakel de schakelaar Niet storen (NST) in en voer vervolgens uw BroadWorks-gebruikers-id in. Met deze optie worden NST-gebeurtenissen tussen Webex en BroadWorks gesynchroniseerd, zodat de functie op beide platforms hetzelfde werkt.

    4. Klik op Volgende.

  11. Voeg de URL van uw verificatieservice toe.

  12. Selecteer Verificatieservice met CI-tokenvalidatie.

    Voor deze optie is niet vereist dat mTLS de verbinding beschermt tegen Webex, omdat de verificatieservice het gebruikerstoken correct valideert met de Webex-identiteitsservice voordat het langlevende token aan de gebruiker wordt verstrekt.

  13. Controleer uw gegevens op het laatste scherm en klik op Maken. U zou een bericht met succes moeten zien.

    Partner Hub geeft de URL's door aan verschillende Webex-microservices die de verbindingen met de geleverde interfaces testen.

  14. Klik op Clusters weergeven en u moet uw nieuwe cluster zien en zien of de validatie is gelukt.

  15. De knop Aanmaken kan worden uitgeschakeld in het laatste (preview)scherm van de wizard. Als u de sjabloon niet kunt opslaan, geeft dit een probleem aan met een van de integraties die u zojuist hebt geconfigureerd.

    Deze controle hebben we doorgevoerd om fouten bij volgende taken te voorkomen. U kunt de wizard opnieuw doorlopen terwijl u uw implementatie configureert. Dit kan wijzigingen aan uw infrastructuur vereisen (bijv. XSP|ADP, load balancer of firewall), zoals beschreven in deze handleiding, voordat u de sjabloon kunt opslaan.

De verbindingen met uw BroadWorks-interfaces controleren

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Clusters weergeven.

  4. Partner Hub initieert verbindingstests van de verschillende microservices naar de interfaces in de clusters.

    Nadat de tests zijn voltooid, wordt op de pagina Clusterlijst het statusbericht weergegeven naast elk cluster.

    U moet groene succesberichten zien. Als u een rood foutbericht ziet, klikt u op de betreffende clusternaam om te zien welke instelling het probleem veroorzaakt.

  5. Optioneel. Selecteer een cluster als u bestaande instellingen voor dat cluster wilt zien, zoals XSI-acties, XSI-gebeurtenissen, DAS-URL en de instellingen van de CTI-interface.

Uw integratiesjablonen configureren

Onboardsjablonen zijn de manier waarop u gedeelde configuratie toepast op een of meer klanten terwijl u ze integreert via de inrichtingsmethoden. U moet elke sjabloon koppelen aan een cluster (dat u in het vorige gedeelte hebt gemaakt).

U kunt zoveel sjablonen maken als u nodig hebt, maar er kan slechts één sjabloon aan een klant worden gekoppeld.

  1. Meld u aan bij de Partnerhub en selecteer Klanten.

  2. Klik op de knop Onboarding templates om de bestaande templates te bekijken.

  3. Klik op Template aanmaken.

  4. Voeg in het venster Sjabloondetails de sjabloonnaam, het land of de regio en de standaardtaal van het e-mailadres toe.

  5. Gebruik in het venster Service-instelling de vervolgkeuzelijst Cluster om het cluster te kiezen dat u met deze sjabloon wilt gebruiken.

  6. Voer een sjabloonnaam in en klik op Volgende.

  7. Configureer uw inrichtingsmodus met de volgende aanbevolen instellingen:

    Tabel 3. Aanbevolen inrichtingsinstellingen voor verschillende inrichtingsmodi

    Naam van instelling

    Flowthrough-inrichting met vertrouwde e-mails

    Flowthrough-inrichting zonder e-mails

    Zelfinrichting van de gebruiker

    BroadWorks-flow via inrichting inschakelen (inclusief inrichtingsaccountgegevens indien Ingeschakeld**)

    Aan

    Geef de accountnaam en het wachtwoord voor inrichting op volgens de BroadWorks-configuratie.

    Aan

    Geef de accountnaam en het wachtwoord voor inrichting op volgens de BroadWorks-configuratie.

    Uit

    Automatisch nieuwe organisaties maken in Control Hub

    Aan

    Aan

    Aan

    E-mailadres serviceprovider

    Selecteer een e-mailadres in de vervolgkeuzelijst (u kunt enkele tekens typen om het adres te vinden als het een lange lijst is).

    Dit e-mailadres identificeert de beheerder binnen uw partnerorganisatie aan wie gedelegeerde beheerderstoegang wordt verleend tot alle nieuwe klantorganisaties die met de onboardsjabloon zijn gemaakt.

    Land

    Kies welk land u voor deze sjabloon gebruikt.

    Het land dat u kiest, komt overeen met klantorganisaties die met deze sjabloon zijn gemaakt voor een bepaalde regio. Momenteel zou de regio (EMEAR) of (Noord-Amerika en de rest van de wereld) kunnen zijn. Zie de land-naar-regio toewijzingen in deze spreadsheet.

    Het land van de organisatie bepaalt de standaard internationale inbelnummers voor Cisco PSTN in Webex Meeting-sites. Raadpleeg het gedeelte Land van de Help-pagina voor meer informatie.

    BroadWorks-enterprisemodus actief

    Schakel dit in als de klanten die u met deze sjabloon inricht ondernemingen in BroadWorks zijn.

    Als het groepen zijn, laat deze schakelaar dan uit.

    Als u een mix van bedrijven en groepen in uw BroadWorks hebt, moet u verschillende sjablonen maken voor deze verschillende cases.

    Opmerkingen uit de tabel:

    • † Deze switch zorgt ervoor dat er een nieuwe klantorganisatie wordt gemaakt als het e-maildomein van een abonnee niet overeenkomt met een bestaande Webex-organisatie.

      Dit moet altijd zijn ingeschakeld, tenzij u een handmatig bestel- en uitvoeringsproces gebruikt (via Cisco Commerce Workspace) om klantorganisaties in Webex te maken (voordat u begint met het inrichten van gebruikers in die organisaties). Deze optie wordt vaak het model 'Hybride inrichting' genoemd en valt buiten het bereik van dit document.

    • ** 'Inrichtingsaccount' verwijst naar het BroadWorks-beheerdersaccount op systeemniveau. Op BroadWorks hebt u een beheerdersaccount met de volgende kenmerken nodig: Beheerderstype=Inrichting, Alleen-lezen=Uit.

  8. Selecteer het standaardservicepakket voor klanten met deze sjabloon (zie Pakketten in het gedeelte Overzicht); Basis, Standaard, Premium of Softphone.

    U kunt deze instelling voor individuele gebruikers overschrijven via Partner Hub.

  9. Optioneel. Schakel Gratis bellen via Cisco Webex uitschakelen in als u Webex-gesprekken wilt uitschakelen.

  10. Selecteer een van de volgende opties voor Configuratie voor deelnemen aan vergadering:

    • Cisco-inbelnummers (PSTN)

    • Door de partner verstrekte inbelnummers (BYoPSTN): als u deze optie selecteert, raadpleegt u de Bring Your Own PSTN Solution Guide for Webex for Cisco BroadWorks voor gedetailleerde informatie over het configureren van deze optie.

  11. Klik op Volgende.

  12. Er zijn twee benaderingen voor het inrichten van abonnees met betrekking tot hoe hun identiteiten worden geverifieerd - met behulp van vertrouwde e-mails of niet-vertrouwde e-mails.

    In de workflow voor vertrouwde e-mail geven gebruikers e-mailadressen door aan de partner die ze toevoegt in BroadWorks. Als partner bent u verantwoordelijk voor het inrichten van het e-mailadres als onderdeel van de doorstroommethode of de API-methode.


     

    Het wordt sterk aanbevolen om de vertrouwde inrichtingsmethode te gebruiken, omdat deze ervoor zorgt dat alle abonnees volledig door u als partner worden ingericht en er geen actie is vereist van de eindgebruikers.

    In het geval van niet-vertrouwde e-mail moeten gebruikers hun e-mails verifiëren voordat ze deze inrichten, of kunnen gebruikers zichzelf activeren.

    In het niet-vertrouwde geval zijn er verschillende inrichtingsmodi op basis van de verificatie-instellingen in de onderstaande tabel:

    Tabel 4. Aanbevolen verificatie-instellingen voor gebruikers voor niet-vertrouwde inrichtingsmodi

    Naam van instelling

    Flowthrough-inrichting zonder e-mails

    Zelfinrichting van de gebruiker

    Beheerder eerst inrichten

    Aanbevolen*

    Niet van toepassing

    Gebruikers toestaan zichzelf te activeren

    Niet van toepassing

    Vereist

    • Opmerkingen uit de tabel:

    • * Elke klantorganisatie in Webex moet ten minste één gebruiker met een beheerdersrol hebben. De eerste gebruiker aan wie u geïntegreerde IM&P in BroadWorks toewijst, neemt de rol van klantbeheerder als er een nieuwe klantorganisatie is gemaakt in Webex. Als serviceprovider wilt u mogelijk controle hebben over wie de rol krijgt. Als u deze instelling controleert, wordt het voltooien van de activering van gebruikers geblokkeerd totdat de eerste gebruiker die u hebt ingericht, is geactiveerd. Als u deze instelling uitschakelt, wordt de eerste gebruiker die in de nieuwe organisatie actief wordt, de klantbeheerder.

  13. Klik op Volgende.

  14. Selecteer de standaard verificatiemodus (BroadWorks-verificatie of Webex-verificatie) om u aan te melden bij Webex.


     
    Deze instelling heeft geen invloed op het aanmelden van gebruikers bij de User Activation Portal. Gebruikers moeten hun BroadWorks-gebruikers-id en -wachtwoord gebruiken wanneer ze zich aanmelden bij de portal, ongeacht hoe de onboardsjabloon is geconfigureerd.

     
    Deze instelling wordt alleen toegepast op nieuw gemaakte klantorganisaties. Als partnerbeheerders een nieuwe verificatie-instelling proberen toe te passen op bestaande klantorganisaties, zijn de bestaande instellingen van toepassing zodat bestaande gebruikers geen toegang verliezen. Als u de verificatiemodus voor bestaande klantorganisaties wilt wijzigen, moet u een ticket openen met Cisco TAC.

    (Zie Verificatiemodus in het gedeelte Uw omgeving voorbereiden).

  15. Klik op Volgende.

  16. Voor Voorkeuren configureert u het volgende:

    1. Kies of u de e-mailadressen van gebruikers vooraf wilt invullen op de aanmeldpagina.

      U moet deze optie alleen gebruiken als u BroadWorks-verificatie hebt geselecteerd en de e-mailadressen van de gebruikers ook in het kenmerk Alternatieve id in BroadWorks hebt geplaatst. Anders moeten ze hun BroadWorks-gebruikersnaam gebruiken. De aanmeldpagina biedt een optie om de gebruiker te wijzigen, indien nodig, maar dit kan leiden tot aanmeldproblemen.

    2. Als u adreslijstsynchronisatie wilt inschakelen, stelt u de schakelaar Telefoonlijstsynchronisatie inschakelen voor alle nieuwe klantorganisaties in op Aan.

      Met deze optie kan Webex BroadWorks-contactpersonen in de klantorganisatie lezen, zodat gebruikers deze kunnen vinden en bellen vanuit de Webex-app.

    3. Voer een partnerbeheerder in.

      Deze naam wordt gebruikt in het geautomatiseerde e-mailbericht van Webex, waarin gebruikers worden uitgenodigd om hun e-mailadres te valideren.

    4. Zorg ervoor dat de schakelaar E-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties is ingeschakeld (de standaardinstelling is ingeschakeld).

    5. Klik op Volgende.

  17. Controleer uw gegevens op het laatste scherm. U kunt op de navigatieknoppen boven aan de wizard klikken om terug te gaan en eventuele details te wijzigen. Klik op Maken.

    U zou een bericht met succes moeten zien.

  18. Klik op Sjablonen weergeven en u moet uw nieuwe sjabloon met andere sjablonen in de lijst zien.

  19. Klik op de sjabloonnaam om de sjabloon indien nodig te wijzigen of te verwijderen.

    U hoeft de gegevens van het inrichtingsaccount niet opnieuw in te voeren. De velden Leeg wachtwoord/Wachtwoordbevestiging zijn er om de referenties te wijzigen als dat nodig is, maar laat ze leeg om de waarden te behouden die u aan de wizard hebt opgegeven.

  20. Voeg meer sjablonen toe als u verschillende gedeelde configuraties hebt die u aan klanten wilt aanbieden.


     

    Houd de pagina Sjablonen weergeven open, omdat u mogelijk sjabloongegevens nodig hebt voor een volgende taak.

Toepassingsserver configureren met inrichtingsservice-URL


 

Deze taak is alleen vereist voor flow door inrichting.

Patch Application Server (alleen R22, R23 en R24)

  1. Als u dit nog niet hebt gedaan, past u de volgende patch toe die van toepassing is op uw versie:.


     
    Zie BroadWorks-softwarevereisten in het gedeelte Referentie voor een volledige lijst met BroadWorks-patches die de vereiste vormen voor de implementatie van Webex voor Cisco BroadWorks.
  2. Wijzigen in de Maintenance/ContainerOptions context.

  3. De parameter voor de inrichtings-URL inschakelen:

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

De inrichtings-URL('s) ophalen in Partner Hub

Raadpleeg de Beheerhandleiding Cisco BroadWorks Application Server Command Line Interface voor meer informatie (Interface > Berichten en service > Geïntegreerde IM&P) over de AS-opdrachten.

  1. Meld u aan bij Partner Hub en ga naar Instellingen > BroadWorks-gesprekken.

  2. Klik op Sjablonen weergeven.

  3. Selecteer de sjabloon die u gebruikt om de abonnees van deze onderneming/groep in te richten in Webex.

    De sjabloondetails worden weergegeven in een flyout-deelvenster aan de rechterkant. Als u nog geen sjabloon hebt gemaakt, moet u dit doen voordat u de inrichtings-URL kunt krijgen.

  4. Kopieer de URL van de inrichtingsadapter.

Herhaal dit voor andere sjablonen als u er meer hebt dan één.

(Optie) Systeembrede inrichtingsparameters configureren op toepassingsserver


 

Mogelijk wilt u het systeembrede inrichtings- en servicedomein niet instellen als u UC-One SaaS gebruikt. Zie Beslissingspunten in het gedeelte Uw omgeving voorbereiden.

  1. Meld u aan bij de toepassingsserver en configureer de interface voor berichten.

    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. De geïntegreerde IMP-interface activeren:

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

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


 

U moet de volledig gekwalificeerde naam invoeren voor de provisioningURL parameter, zoals deze is gegeven in Control Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in de /etc/hosts bestand op het AS.

(Optie) Inrichtingsparameters per onderneming configureren op toepassingsserver

  1. Open in de BroadWorks-gebruikersinterface de onderneming die u wilt configureren en ga naar Services > Geïntegreerde IM&P.

  2. Selecteer Servicedomein gebruiken en voer een dummywaarde in (Webex negeert deze parameter. U kunt dit gebruiken example.com).

  3. Selecteer Messaging Server gebruiken.

  4. Plak in het veld URL de inrichtings-URL die u van uw sjabloon hebt gekopieerd in Partner Hub.


     

    U moet de volledig gekwalificeerde naam invoeren voor de provisioningURL parameter, zoals deze is gegeven in Partner Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in de /etc/hosts bestand op het AS.

  5. Voer in het veld Gebruikersnaam een naam in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.

  6. Voer een wachtwoord in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.

  7. Voor Standaard gebruikersidentiteit voor IM&P-id selecteert u Primair.

  8. Klik op Toepassen.

  9. Herhaal dit voor andere bedrijven die u wilt configureren voor flow door inrichting.

Inrichtingsgegevens gebruiker

Zie Gebruikersvoorzieningen voor serviceproviders voor informatie over de gebruikersgegevens die worden uitgewisseld tussen BroadWorks en Webex tijdens het inrichten van gebruikers.

Controle-API voorafgaand aan inrichting van partner

De API Pre-Provisioning Check helpt beheerders en verkoopteams door te controleren op fouten voordat u een klant of abonnee inricht voor een pakket. Gebruikers of integraties die zijn geautoriseerd door een gebruiker met de rol Volledige partnerbeheerder kunnen deze API gebruiken om ervoor te zorgen dat er geen conflicten of fouten zijn met de pakketinrichting voor een bepaalde klant of abonnee.

De API controleert of er conflicten zijn tussen deze klant/abonnee en bestaande klanten/abonnees op Webex. De API kan bijvoorbeeld fouten veroorzaken als de abonnee al is ingericht voor een andere klant of partner, als het e-mailadres al bestaat voor een andere abonnee of als er conflicten zijn tussen de inrichtingsparameters en wat er al bestaat in Webex. Dit geeft u de mogelijkheid om deze fouten op te lossen voordat u inricht, waardoor de kans op een succesvolle inrichting groter wordt.

Zie voor meer informatie over de API: Ontwikkelaarshandleiding van Webex voor groothandels

Als u de API wilt gebruiken, gaat u naar: Een Wholesale Subscriber-inrichting vooraf controleren


 

Als u toegang wilt krijgen tot een inrichtingsdocument voor groothandels voor abonnees, moet u zich aanmelden bij de https://developer.webex.com/-portal.

Partner SSO - SAML

Hiermee kunnen partnerbeheerders SAML SSO configureren voor nieuw gemaakte klantorganisaties. Partners kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren, evenals op hun eigen werknemers.


 
De onderstaande stappen voor Partner-SSO zijn alleen van toepassing op nieuw gemaakte klantorganisaties. Als partnerbeheerders proberen Partner SSO toe te voegen aan een bestaande klantorganisatie, blijft de bestaande verificatiemethode behouden om te voorkomen dat bestaande gebruikers de toegang verliezen. Als u partner-SSO wilt toevoegen aan een bestaande organisatie, moet u een ticket openen met Cisco TAC.
  1. Controleer of de provider van de externe identiteitsprovider voldoet aan de vereisten die worden vermeld in het gedeelte Vereisten voor identiteitsproviders van Integratie van eenmalige aanmelding in Control Hub.

  2. Open een serviceaanvraag met Cisco TAC. TAC moet een vertrouwensrelatie opbouwen tussen de externe identiteitsprovider en de Cisco Common Identity-service. .


     
    Als uw IdP de passEmailInRequest in te schakelen, zorg ervoor dat u deze vereiste in het serviceverzoek opneemt. Raadpleeg uw IdP als u niet zeker weet of deze functie vereist is.
  3. Upload het CI-metagegevensbestand dat TAC aan uw identiteitsprovider heeft geleverd.

  4. Configureer een integratiesjabloon. Selecteer Partnerverificatie voor de instelling Verificatiemodus. Voer voor de entiteits-id van de IDP-provider de entiteits-id in vanuit de XML-metagegevens van de SAML van de externe identiteitsprovider.

  5. Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.

  6. Precies dat de gebruiker kan inloggen.

Partner-SSO - OpenID Connect (OIDC)

Hiermee kunnen partnerbeheerders OIDC SSO configureren voor nieuw gemaakte klantorganisaties. Partners kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren, evenals op hun eigen werknemers.


 

De onderstaande stappen om Partner SSO OIDC in te stellen, zijn alleen van toepassing op nieuw gemaakte klantorganisaties. Als partnerbeheerders proberen het standaard verificatietype te wijzigen in Partner SSO OIDC in een bestaande tempel, zijn de wijzigingen niet van toepassing op de klantorganisaties die al zijn geïntegreerd met de sjabloon. Als u partner-SSO wilt toevoegen aan een bestaande klantorganisatie, moet u een ticket openen met Cisco TAC.

  1. Open een serviceaanvraag met Cisco TAC met de details van de OpenID Connect-id-provider. Hieronder staan verplichte en optionele IDP-kenmerken. TAC moet de id-provider instellen op de CI en de omleidings-URI opgeven die moet worden geconfigureerd op de id-provider.

    Kenmerk

    Vereist

    Beschrijving

    Naam IDP

    Ja

    Unieke maar hoofdlettergevoelige naam voor OIDC IdP-configuratie, kan bestaan uit letters, cijfers, koppeltekens, onderstrepingstekens, tildes en stippen en de maximale lengte is 128 tekens.

    OAuth-client-id

    Ja

    Wordt gebruikt om OIDC IdP-verificatie aan te vragen.

    OAuth-clientgeheim

    Ja

    Wordt gebruikt om OIDC IdP-verificatie aan te vragen.

    Lijst met scopes

    Ja

    Lijst met scopes die worden gebruikt om OIDC IdP-verificatie aan te vragen, opgesplitst per ruimte, bijvoorbeeld 'openid e-mailprofiel' Moet openid en e-mail bevatten.

    Autorisatieeindpunt

    Ja als DiscoveryEndpoint niet is verstrekt

    URL van het OAuth 2.0-verificatie-eindpunt van de IdP.

    tokenEindpunt

    Ja als DiscoveryEndpoint niet is verstrekt

    URL van het OAuth 2.0-tokeneindpunt van de IdP.

    Eindpunt van detectie

    Nee

    URL van het Discovery-eindpunt van de IdP voor detectie van OpenID-eindpunten.

    userInfoEindpunt

    Nee

    URL van het UserInfo-eindpunt van de IdP.

    Eindpunt sleutelset

    Nee

    URL van het eindpunt van de JSON-websleutelset van de IdP.


     

    Naast de bovenstaande IDP-attributen moet de id van de partnerorganisatie worden opgegeven in het TAC-verzoek.

  2. Configureer de omleidings-URI op de OpenID connect-id-provider.

  3. Configureer een integratiesjabloon. Voor de instelling Verificatiemodus selecteert u Partnerverificatie met OpenID Connect en voert u de IDP-naam in die tijdens de installatie van de IDP is opgegeven als de entiteits-id van OpenID Connect IDP.

  4. Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.

  5. Zeer dat de gebruiker zich kan aanmelden met de SSO-verificatieflow.

Gesprekscorrelatie-id inschakelen

Als u Webex voor Cisco BroadWorks wilt uitvoeren, moet u de gesprekscorrelatie-id inschakelen. Deze instelling is vereist voor veel gespreksfuncties, waaronder gespreksopname, groepsgesprek opnemen, directie en directie-assistent.

Gebruik de CLI om de functie in te schakelen op alle AS- en XSP|ADP-interfaces.

  • Voer de volgende opdrachten uit op AS-interfaces. Hierdoor kan het AS de X-BroadWorks-Correlation-Info SIP-koptekst:

    AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true

    AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true

  • Het enableCallCorrelationID parameter die is gekoppeld aan de toepassing Xsi-Actions wordt gebruikt om de opname van informatie over gesprekscorrelatie in Xsi-Actions-logboeken te beheren. Het wordt aanbevolen om enableCallCorrelationID ingeschakeld met de volgende opdracht op XSP|ADP-interfaces:

    XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true

Zie voor meer informatie over de gesprekscorrelatie-id de functiebeschrijving Cisco BroadWorks-gesprekscorrelatie-id.

Synchroniseren met Directory

Telefoonlijstsynchronisatie zorgt ervoor dat Webex voor Cisco BroadWorks-gebruikers de Webex-telefoonlijst kunnen gebruiken om elke belentiteit te bellen vanaf de BroadWorks-server. Wanneer deze functie is ingeschakeld, wordt de volledige telefoonlijst van de BroadWorks-server gesynchroniseerd met de Webex-telefoonlijst. Gebruikers kunnen toegang krijgen tot de telefoonlijst vanuit de Webex-app en een gesprek plaatsen naar elke belentiteit vanaf de BroadWorks-server.

Als u adreslijstsynchronisatie wilt inschakelen, gaat u naar Adreslijstsynchronisatie in Webex voor Cisco BroadWorks.


 
Webex voor Cisco BroadWorks-flowthrough-inrichting voegt berichtengebruikers en bijbehorende gespreksinformatie van de BroadWorks-server toe aan het Webex-platform. Telefoonlijsten, niet-berichtengebruikers en niet-gebruikersentiteiten zijn echter niet opgenomen (bijvoorbeeld een conferentieruimte-telefoon, faxapparaat of nummer van de Hunt-groep). Als u adreslijstsynchronisatie inschakelt, wordt gegarandeerd dat alle bellende entiteiten worden toegevoegd aan het Webex-platform.

Uniforme gespreksgeschiedenis

Wanneer Unified Call History is ingeschakeld, worden BroadWorks-gespreksgebeurtenissen gesynchroniseerd met de Webex-cloud en worden ze onderdeel van de Webex Unified Call- en Meetings-geschiedenis die wordt weergegeven in de Webex-app. Gebruikers kunnen hun eigen gedetailleerde gespreksgeschiedenis en vergaderingsgeschiedenis bekijken vanuit de Webex-app.

Unified Call History kan worden ingeschakeld door beheerders op partnerniveau in Partner Hub op clusterbasis. Wanneer deze functie is ingeschakeld, synchroniseert de BroadWorks-implementatie de volgende gespreksgebeurtenissen met de Webex-cloud:

  • Gespreksgeschiedenisgebeurtenissen: deze gebeurtenissen worden gebruikt om een gedetailleerde Unified-gespreksgeschiedenis op te bouwen

  • Hookstatusgebeurtenissen: Unified Call History bevat hookstatusoptimalisaties die de hoeveelheid netwerkbandbreedte voor Telephony Presence-updates verlagen

Vereisten voor Unified Call History

Voordat u Unified Call History kunt configureren, moet u ervoor zorgen dat u uw systeem hebt gepatcht. Deze functie is afhankelijk van de volgende BroadWorks-patches die worden geïnstalleerd:

Voor R22:

Voor R23:

Voor R24:


 
Voor de volledige lijst met BroadWorks-patches die u moet installeren als voorwaarde om Webex voor Cisco BroadWorks uit te voeren, raadpleegt u BroadWorks-softwarevereisten in het gedeelte Referentie.

Naast het patchen van uw systeem, wordt het clientconfiguratiebestand ( config-wxt.xml) moet de volgende tagset hebben: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>

Als u Hunt-groep, Call Center en andere omleidingsinformatie in de Unified-gespreksgeschiedenis wilt hebben, moeten de volgende Broadworks-patches zijn geïnstalleerd en actief zijn:

Voor R23:

  • AP.as.23.0.1075.ap383346

  • AP.as.23.0.1075.ap383994

Voor R24:

  • AP.as.24.0.944.ap383346

  • AP.as.24.0.944.ap383994

Als u informatie over de directie-assistent in de Unified-gespreksgeschiedenis wilt hebben, moeten de volgende Broadworks-patches zijn geïnstalleerd en actief zijn:

Voor R24:

  • AP.as.24.0.944.ap380052

  • AP.as.24.0.944.ap384239

  • ADP met Xsi-Events-24_2022.06 of hoger

Naast de Broadworks-patches moet adreslijstsynchronisatie ook zijn ingeschakeld voor de Unified-gespreksgeschiedenis van Executive-Assistant.


 

Wanneer u Gespreksgeschiedenis of NST-synchronisatie inschakelt, verzendt Webex CTI-abonnementsvernieuwingsaanvragen voor alle gebruikers onder het cluster. Afhankelijk van het aantal gebruikers kan dit tot enkele uren duren. Het wordt aanbevolen geen onderhoudsactiviteiten van Broadworks uit te voeren tijdens dezelfde onderhoudsperiode.

Gespreksgeschiedenis inschakelen (nieuw cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een nieuw cluster, raadpleegt u de stappen voor het toevoegen van een cluster in Uw partnerorganisatie configureren in Partner Hub.

Gespreksgeschiedenis inschakelen (bestaand cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een bestaand cluster, volgt u de volgende stappen:

  1. Meld u aan bij Partnerhub op admin.webex.com.

  2. Ga naar Instellingen en selecteer een bestaand cluster.

  3. Controleer of de clusterverbinding goed is. In het rechterdeelvenster moet een groen vinkje worden weergegeven met Connection established.

    Als dit niet wordt weergegeven, voert u onder Connnections controleren (optioneel) de BroadWorks-gebruikers-id en het BroadWorks-wachtwoord in en klikt u op Controleren om te controleren of de verbinding goed is.

  4. Schakel het selectievakje Gespreksgeschiedenis inschakelen in.

  5. Klik op Opslaan.

Interacties van functies

De volgende functieinteracties bestaan voor Unified Call History:

  • Unified Call History wordt niet ondersteund voor gebruikers die zijn geconfigureerd in BroadWorks met routelijsten of directe routes. Wanneer deze situatie bestaat, worden gebeurtenissen voor gespreksgeschiedenis en haakstatus niet naar de Webex-app verzonden.

  • Unified Call History wordt niet ondersteund bij toestelbellen. Gesprekken die zijn geplaatst via toestelbellen worden mogelijk niet correct weergegeven in de gespreksgeschiedenis.

Gespreksgeschiedenis weergeven in de Webex-app

Eindgebruikers kunnen hun Unified Call History openen en bekijken vanuit de Webex-app. Voor meer informatie raadpleegt u: Webex | Gespreks- en vergadergeschiedenis weergeven.

Unified Call History uitschakelen

Nadat u Unified Call History hebt ingeschakeld op een cluster, kunt u de functie niet zelf uitschakelen. Als u de functie wilt uitschakelen, neemt u contact op met het Cisco Technical Assistance Center (TAC).

Indicatie Visuele Spam

De Webex-app ondersteunt een visuele indicatie van spamgesprekken in de gesprekstoast wanneer het gesprek wordt weergegeven aan de gebelde en in de Unified Call History-records wanneer BroadWorks wordt bijgewerkt om de beller-id te valideren via het STIR/SHAKEN-framework. Deze functie hebben:

  1. Schakel Unified Call History in zoals beschreven in het vorige gedeelte.
  2. De volgende patches moeten geïnstalleerd en actief zijn:
    • AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
    • of minimaal AS-25_Rel_2022.12
  3. De functie moet geactiveerd worden via de AS CLI:
    • AS_CLI/System/ActivatableFeature> 104112 activeren
    • AS_CLI/System/StirShaken> enableVerification true instellen
  4. Broadworks moet worden geconfigureerd voor het ondertekenen, labelen en verifiëren van STIR-SHAKEN zoals beschreven in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification

Wanneer BroadWorks correct is geconfigureerd, wordt een nieuwe koptekst X-Cisco-CallerId-Disposition toegevoegd in INVITE-verzoeken die naar Cisco-clients worden verzonden en wordt een nieuwe veldbellerIdDisposition toegevoegd aan de bestaande gespreksgeschiedenisgebeurtenissen die via de CTI-interface naar de Webex-cloud worden verzonden. Webex-apparaten gebruiken deze informatie om een visuele spamindicatie te geven in de gesprekspresentatie en de Unified Call History van de gebelde.

Belleridentificatie en omleiding van gesprekken

Identificatie beller

Wanneer de Webex-app een gesprek ontvangt, wordt geprobeerd te identificeren wie de beller is en wordt deze informatie weergegeven in de melding voor een binnenkomend gesprek, in het gespreksvenster en nadat het gesprek is voltooid, in de gespreksgeschiedenis en voicemail.

De Webex-app probeert de beller-id te vinden door het inkomende telefoonnummer te koppelen aan de telefoonnummers van contactpersonen die in verschillende bronnen zijn gevonden. De Webex-app gebruikt de volgende bronnen in deze volgorde. Zodra het vindt het in een bron zal het niet proberen om ergens anders te zoeken.


 

Als er meerdere exemplaren van een nummer in één bron worden gevonden, wordt niet geprobeerd er een te kiezen. In dit geval wordt er geen beller-id weergegeven.

  • Webex Common Identity (CI) die gebruikers van uw organisatie bevat.

  • Persoonlijke contactpersonen en contactpersonen binnen de organisatie. Persoonlijke contactpersonen zijn zichtbaar op het tabblad Contactpersonen.

  • Lokaal adresboek. In Windows - Outlook-toepassing, in Mac - Mac-contactpersonen, in iOS - iPhone-contactpersonen, in Android - Android-contactpersonen.

Als er geen overeenkomst is gevonden met het inkomende telefoonnummer, gebruikt de app de weergavenaam in de SIP FROM-koptekst, indien beschikbaar. Anders wordt het gebruikersnaamgedeelte van de SIP-URI uit de koptekst SIP From als laatste redmiddel gebruikt.

Voor extern gespreksbeheer (d.w.z. Deskphone Control Mode) wordt XSI-informatie gebruikt, waarbij de BWKS-id of het toestel wordt gebruikt, geëxtraheerd uit informatie van externe partijen in de XSI-gebeurtenis. Als informatie van externe partijen niet beschikbaar is, wordt P-Asserted Identity (PAI) (indien geconfigureerd) gebruikt.

Gesprekken omleiden

Als een gesprek is omgeleid of doorgeschakeld, probeert de app te laten zien wie de beller is en hoe deze is doorgeschakeld in de gespreksmelding en de gespreksgeschiedenis.

  • Gesprek doorgeschakeld: Hier wordt het nummer weergegeven dat het gesprek heeft doorgeschakeld.

  • Hunt-groep: Hier wordt de naam weergegeven van de Hunt-groep die het gesprek heeft doorgeschakeld.

  • Callcenterwachtrij: Hier wordt de naam weergegeven van de wachtrij die het gesprek heeft doorgeschakeld.

  • Directie-assistent: Hier wordt de naam van de directeur weergegeven waarvoor het gesprek binnenkomt.

Uitzonderingen:

  • Voor interne gesprekken in de gesprekswachtrij, waarbij een agent een interne partij terugbelt, ziet de externe partij niet de naam van de gesprekswachtrij, maar de naam van de agent die deze belt.

Gesprek elders beantwoord:

Voor Hunt-groepen of gesprekswachtrijen die zijn ingesteld met gelijktijdige routering, zien agenten een gesprek dat elders in de gespreksgeschiedenis wordt beantwoord als een andere agent het gesprek opneemt. Voor Hunt-groepen of gesprekswachtrijen met opeenvolgende routering of in een overloop worden gesprekken weergegeven als gemiste oproep in de gespreksgeschiedenis als ze door een andere agent worden beantwoord.

Weergave van gedeelde lijn

Met de weergave van gedeelde lijn kunnen lijnen van andere gebruikers worden ingesteld als gedeelde lijnen op het apparaat voor eindgebruikers. De configuratie van de gedeelde lijn voor de Webex-app is vergelijkbaar met de configuratie van de gedeelde lijn voor bureautelefoons. Met deze specifieke functie kunt u weergaven voor gedeelde lijnen toewijzen aan de Webex-app van de eindgebruiker.

Deze functie biedt gebruikers de voordelen om gesprekken op het toestelnummer van een andere gebruiker rechtstreeks vanuit de Webex-app af te handelen.

  • U kunt de weergave van gedeelde lijn alleen instellen voor de bureaubladversie van een Webex-app.

  • U kunt maximaal 10 lijnen toevoegen, inclusief de primaire lijn Webex-app .

  • U kunt een workspace-lijn niet toewijzen als gedeelde lijn.

  • Een gebruiker kan niet tegelijkertijd met gedeelde lijnen worden ingericht met de service Executive Assistant.

  • De primaire lijnpoort van een gebruiker mag niet worden gewijzigd in een gedeelde lijn.

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

Pleister 1: Eigenaarsmarkering in apparaatlijst ter ondersteuning van gedeelde lijnen van Webex-client

R23 zonder ADP:

  • AP.as.23.0.1075.ap384179

  • AP.xsp.23.0.1075.ap384179

R23 met ADP:

  • AP.as.23.0.1075.ap384179

  • Xsi-Actions-23_2022.10

R24:

  • ALS: AP.as.24.0.944.ap384179

  • Xsi-Actions-24_2022.10

R25:

  • ALS: RI versie Rel_2022.10_1.310

  • Xsi-Actions-25_2022.10

Pleister 2: Patches voor het verhogen van het aantal poorten op apparaatprofieltypen (in dit geval voor de desktopclient: Business Communicator).

  • RI versie Rel_2022.10_1.310

Niet storen (NS)-synchronisatie

Synchronisatie Niet storen (NST) brengt de NST-instellingen op één lijn tussen Webex en BroadWorks door de NST-status tussen de twee platforms te synchroniseren. Als een gebruiker bijvoorbeeld Niet storen inschakelt vanuit de Webex-app, wordt die status gesynchroniseerd met BroadWorks-gespreksapparaten. Als gevolg daarvan gaat de bij BroadWorks geregistreerde bureautelefoon van de gebruiker niet over wanneer iemand deze probeert te bellen. Als een gebruiker NST instelt vanaf een bureautelefoon, wordt de status ook gesynchroniseerd met de Webex-app. Zonder deze functie worden NST-updates van het ene platform niet herkend door het andere platform.

NST-synchronisatie wordt toegepast op clusterniveau BroadWorks en kan door een partnerbeheerder worden ingeschakeld in Partnerhub.

Voorwaarden

Zorg ervoor dat de volgende patches worden toegepast op de AS en XSP|ADP. Pas alleen de patches toe voor uw BroadWorks-versie.

Voor versie 23:

<snipped>

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

Voor versie 24:

<snipped>

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

Nadat u de patches hebt aangebracht, activeert u functie 25433 op de AS:

AS_CLI/System/ActivatableFeature> activate 25433

Als er veel klanten (>50) in het BroadWorks-cluster zijn, worden bewerkingen zoals het bijwerken van XSI-acties, XSI-gebeurtenissen, DAS-URL, XSP|ADP-URL of NST-synchronisatie niet ondersteund. In dergelijke gevallen wordt het aanbevolen contact op te nemen met een Cisco TAC-ondersteuningsmedewerker voor ondersteuning.

Synchronisatie van apparaatfunctietoetsen configureren in BroadWorks. Zorg ervoor dat de telefoon SIP SUBSCRIBE/NOTIFY ondersteunt voor het gebeurtenispakket 'as-feature-event'. Zie Functietoetssynchronisatie voor Cisco BroadWorks-apparaten voor meer informatie.

NST-synchronisatie inschakelen (bestaand cluster)

  1. Aanmelden bij Partner Hub

  2. Klik op Instellingen.

  3. Klik op Cluster weergeven en selecteer het juiste BroadWorks-cluster.

  4. Schakel de schakelaar Niet storen (NST) in.

  5. Voer uw BroadWorks-gebruikers-id in en klik op Enable.

    Het systeem valideert dat het BroadWorks-cluster de juiste patches heeft om NST-synchronisatie te ondersteunen. Als de validatie mislukt, wordt de knop Opslaan uitgeschakeld.

  6. Als de validatie slaagt, klik dan op Save.


 
  • Zodra NST synchroniseren is ingeschakeld, vernieuwt Webex alle gebruikersabonnementen om het gebeurtenispakket Niet storen op te nemen. Afhankelijk van het aantal gebruikers kan het enkele uren duren voordat dit proces is voltooid.

  • NST-synchronisatie inschakelen is een eenrichtingsschakelaar. Zodra de functie is ingeschakeld, kunt u deze niet zelf uitschakelen.

NST-synchronisatie inschakelen (nieuw cluster)

U kunt de functie ook inschakelen tijdens het maken van het cluster. Zie 'Uw BroadWorks-clusters configureren' in Uw partnerorganisatie configureren in Partner Hub voor meer informatie.

NST-synchronisatie uitschakelen

U kunt NST-synchronisatie niet zelf uitschakelen. Als u de functie wilt uitschakelen, maakt u een BEMS-engineeringcase met de volgende informatie:

  • Gezin: Spark-service

  • Product: Bellen in Webex (Webex voor BroadWorks)

  • Onderdeel: WxBW- Inrichting

  • In het BEMS-geval moet worden vermeld dat Niet storen synchroniseren moet worden uitgeschakeld voor een partner. De case moet partnerId en BroadWorks clusterId bevatten.

Usecases

NST instellen en wissen in relatie tot werkstatus

Gespreksopname

Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopname.

Tabel 6. Opnamemodi

Opnamemodi

Beschrijving

Bedieningselementen/indicatoren die worden weergegeven in de Webex-app

Altijd

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker is niet in staat om te beginnen met of stoppen met opnemen.

  • Visuele indicator dat de opname bezig is

Altijd met onderbreken/hervatten

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker kan een opname onderbreken en hervatten.

  • Visuele indicator dat de opname bezig is

  • Knop Opname onderbreken

  • Knop Opname hervatten

OnDemand

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht, maar de opname wordt verwijderd tenzij de gebruiker op Opname starten drukt.

Als de gebruiker een opname start, blijft de volledige opname van de gespreksinstellingen behouden. Nadat de gebruiker de opname heeft gestart, kan de gebruiker de opname ook onderbreken en hervatten

  • Knop Opname starten

  • Knop Opname onderbreken

  • Knop Opname hervatten

OnDemand met door gebruiker geïnitieerde start

De opname wordt niet gestart tenzij de gebruiker de optie Opname starten selecteert in de Webex-app. De gebruiker heeft de optie om meerdere keren te starten en stoppen met opnemen tijdens een gesprek.

  • Knop Opname starten

  • Knop Opname stoppen

  • Knop Opname onderbreken

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

De Call Correlation Identifier (Correlatie-id gesprek) moet zijn ingeschakeld. Zie Gesprekscorrelatie-id inschakelen voor meer informatie.

De volgende configuratietag moet zijn ingeschakeld om deze functie te kunnen gebruiken: %ENABLE_CALL_RECORDING_WXT%.

Deze functie vereist een integratie met een gespreksopnameplatform van derden.

Als u gespreksopname op BroadWorks wilt configureren, gaat u naar de Cisco BroadWorks-interfacehandleiding voor gespreksopname.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van de opnamefunctie gaat u naar de help.webex.com artikel Webex | Uw gesprekken opnemen.

Als u een opname opnieuw wilt afspelen, moeten gebruikers of beheerders naar hun gespreksopnameplatform van derden gaan.

Groep gesprek parkeren en ophalen

Webex voor Cisco BroadWorks ondersteunt Groep gesprek parkeren en ophalen. Deze functie biedt gebruikers binnen een groep een manier om gesprekken te parkeren, die vervolgens door andere gebruikers in de groep kunnen worden opgehaald. Winkelmedewerkers in een winkelinstelling kunnen de functie bijvoorbeeld gebruiken om een gesprek te parkeren dat vervolgens kan worden opgehaald door iemand in een andere afdeling.

Werking van functies

Zodra de functie is geconfigureerd

  • Tijdens een gesprek klikt een gebruiker op de optie Parkeren in de Webex-app om het gesprek te parkeren op een toestel dat het systeem automatisch selecteert. Het systeem geeft het toestelnummer voor de gebruiker voor een periode van 10 seconden weer.

  • Een andere gebruiker in de groep klikt op de optie Gesprek ophalen in de Webex-app. De gebruiker voert vervolgens het toestelnummer van het geparkeerde gesprek in om het gesprek voort te zetten.

Vereisten

Zorg voor het volgende om deze functie te laten werken:

  • Het clientconfiguratiebestand moet de volgende tags hebben ingesteld:

    <call-park enabled="%ENABLE_CALL_PARK_WXT%"
            timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
  • De Call Correlatie-id moet zijn ingeschakeld op de AS en XSP|ADP. Zie Gesprekscorrelatie-id inschakelen voor meer informatie.

  • Uw SBC moet zijn geconfigureerd om de ' x-broadworks-correlation-in' SIP-kenmerk van en naar de toepassingsserver.

Configuratie

Zie 'Groep voor geparkeerde gesprekken toevoegen' in de Beheerhandleiding voor de webinterface van de Cisco BroadWorks-toepassingsservergroep - deel 2 voor meer informatie over het configureren van Groepsgesprek parkeren op BroadWorks. U moet een groep maken en gebruikers aan de groep toevoegen.

Meer informatie over het configureren van de gesprekscorrelatie-id in BroadWorks vindt u in Functiebeschrijving Cisco BroadWorks-gesprekscorrelatie-id.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van Groepsgesprek parkeren raadpleegt u Webex | Parkeren en Gesprekken ophalen.

Gesprek parkeren/doorverbonden gesprek parkeren

Normaal of doorverbonden gesprek parkeren wordt niet ondersteund in de gebruikersinterface van de Webex-app, maar ingerichte gebruikers kunnen de functie implementeren met behulp van functietoegangscodes:

  • Voer *68 in om een gesprek te parkeren

  • Voer *88 in om een gesprek op te halen

Inbreken

Inbrekersservice wordt vaak gebruikt in callcenteromgevingen of andere situaties waar directe hulp of interventie nodig kan zijn.

Wanneer een inbrekersservice is ingeschakeld, kan een aangewezen gebruiker of supervisor een actief gesprek invoeren door een specifieke opdracht te starten of door een speciale knop of toetscombinatie te gebruiken op hun telefoon of communicatieapparaat. Zodra de aanvraag voor inbreken is ingediend, brengt het systeem een verbinding tot stand met het lopende gesprek, zodat de bevoegde persoon het gesprek kan beluisteren of als actieve deelnemer aan het gesprek kan deelnemen.

Inbreken kan handig zijn in verschillende scenario's. In een callcenterinstelling kunnen supervisors of trainers vertegenwoordigers van de klantenservice controleren en coachen door hun gesprekken in realtime te beluisteren. Indien nodig kunnen ze ingrijpen om advies te geven of het gesprek overnemen als de vertegenwoordiger het moeilijk heeft. In noodsituaties of bij kritische gesprekken kan bevoegd personeel snel deelnemen aan lopende gesprekken om hulp te bieden of belangrijke beslissingen te nemen.

In de Webex-app voor inbreken krijgen we een melding dat het gesprek wordt omgezet in een conferentie. Er is geen extra informatie in de NOTIFY (call-info of conference-info) wat het type conferentie is, zodat we het op een andere manier kunnen behandelen.

Bij het inbreken wordt een drierichtingsgesprek tot stand gebracht tussen de partijen. De volgende termen worden geïntroduceerd:

  • Verantwoordelijke: Een supervisor is een persoon die toezicht houdt op en leiding geeft aan een team van klantenserviceagenten of callcentervertegenwoordigers. In het kader van het inbreken van gesprekken heeft een supervisor doorgaans de mogelijkheid om lopende gesprekken van klanten te controleren en tussenbeide te komen. Zij kunnen gespreksbewakingstools of -software gebruiken om gesprekken te beluisteren, agenten te begeleiden en kwaliteitscontrole te garanderen. De rol van de supervisor kan bestaan uit het trainen van agenten, het aanpakken van klantproblemen en het optimaliseren van de prestaties van het team.

  • Klant: Een klant verwijst naar een persoon of entiteit die contact opneemt met een bedrijf of organisatie om producten, diensten of ondersteuning te verkrijgen. In de context van gesprek inbreken is een klant iemand die een telefoongesprek voert of ontvangt met een agent van de klantenservice. Klanten kunnen tijdens het gesprek hulp, informatie of een oplossing zoeken voor hun vragen of problemen. Met de functie voor het inbreken van gesprekken kunnen supervisors of geautoriseerd personeel deelnemen aan het lopende gesprek tussen de klant en de agent.

  • Agent: Een agent, ook wel een vertegenwoordiger van de klantenservice of een callcenteragent genoemd, is een persoon die verantwoordelijk is voor het afhandelen van klantinteracties en het bieden van ondersteuning of hulp via de telefoon of andere communicatiekanalen. Agenten zijn opgeleid om vragen van klanten te beantwoorden, problemen op te lossen, transacties te verwerken en een positieve klantervaring te bieden. In de context van gesprek inbreken is een agent de persoon die rechtstreeks met de klant spreekt tijdens het telefoongesprek. De agent kan indien nodig begeleiding of feedback van de supervisor ontvangen via inbellen.

Mobiel systeemeigen gesprek escaleren naar vergadering

De Mobile Native Call Escalate to Meeting heeft twee unieke functies:

  • Nieuwe pushmelding

    Mobiele gebruikers in een native gesprek kunnen nu overschakelen naar de Webex-app door op de Nieuwe pushmelding te tikken. Wanneer u een systeemeigen gespreksscherm start, verschijnt er een Nieuwe pushmelding op het scherm en tikt u rechtstreeks op het scherm in gesprek van de Webex-app.

    U ziet de Webex-melding tijdens een telefoongesprek als u Webex Go gebruikt of als uw mobiele netwerkoperator (MNO) gesprekssignalering heeft met Cisco-gespreksbeheer voor uw mobiele telefoongesprekken.

  • Mobiel gesprek verplaatsen naar vergadering

    Wanneer u in gesprek bent met iemand, wilt u dat gesprek mogelijk verplaatsen naar een vergadering om gebruik te maken van enkele geavanceerde vergaderingsfuncties, zoals video, delen of whiteboards. Of nodig andere mensen uit in de discussie en ga naar een vergadering.

Vereisten voor BroadWorks

  • Activeerbare functie 25239

  • R23 met 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 met ADP:

    • AS-patch AP.as.23.0.1075.ap383064

    • ADP met Xsi-Actions-23, CommPilot-23 versie > 2022.05_1.303 en NPS versie > 2022.08_1.350

  • R24:

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

    • ADP met Xsi-Actions-24, CommPilot-24 versie > 2022.05_1.303 en NPS versie > 2022.08_1.350

  • R25:

    • AS RI versie Rel_2022.08_1.354

    • ADP met Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 en NPS-versie > 2022.08_1.350

Configuratie voor URI-bellen ter ondersteuning van het verplaatsen van een gesprek naar een vergadering

NS UrlDialing-beleid

Regel definiëren voor (.*)webex.com om te routeren via 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-routering NE voor I-SBC

Voorbeeldconfiguratie

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-routeringsprofiel

Het exemplaar van het URL-belbeleid is toegevoegd aan het/de juiste routeringsprofiel(en)

NS_CLI/Policy/Profile> get profile MyInst
 Profile:  Webex
                  Policy              Instance
    ==========================================
 …
              UrlDialing          WebexMeetings

ALS gebruik NS-route voor NetworkURL-gesprek

Schakel het AS in om de NS-route in de hybride AS-modus te respecteren

AS_CLI/Interface/IMS> set queryNSForNetworkURL true

E911-noodoproepen

Webex voor Cisco BroadWorks ondersteunt E911-noodoproepen. Met deze functie worden noodoproepen gerouteerd naar een PSAP (Public Safety Answering Point), dat vervolgens de hulpdiensten naar de locatie van de beller kan leiden. Als u deze functie wilt gebruiken, moet u Webex voor Cisco BroadWorks integreren met een E911-provider voor noodoproepen.

Gebruik de volgende Webex-artikelen om ondersteuning voor E911-noodoproepservices te configureren:

  • E911-noodoproepen in Webex voor BroadWorks: gebruik dit artikel om E911-noodoproepen in Webex voor Cisco BroadWorks te configureren met een van de volgende ondersteunde E911-providers:

    • Gegarandeerd

    • Binnen het systeem

    • RedSky

  • Disclaimer voor noodoproepen: als u een locatieservice hebt, kunt u het venster Disclaimer voor noodoproepen in de Webex-app zo configureren dat gebruikers hun locatie kunnen bijwerken wanneer ze zich aanmelden.

Clients aanpassen en inrichten

Gebruikers downloaden en installeren hun algemene Webex-apps voor desktop of mobiel (zie Webex-app-platforms voor downloadkoppelingen). Zodra de gebruiker zich heeft geverifieerd, wordt de client geregistreerd bij de Webex-cloud voor berichten en vergaderingen, worden de merkgegevens opgehaald, wordt de informatie over de BroadWorks-service ontdekt en wordt de belconfiguratie gedownload van de BroadWorks-toepassingsserver (via DMS op XSP|ADP).

U configureert de gespreksparameters voor Webex-apps in BroadWorks (zoals normaal). U configureert parameters voor branding, berichten en vergaderingen voor de clients in Control Hub. U kunt een configuratiebestand niet rechtstreeks wijzigen.

Deze twee sets configuraties kunnen overlappen. In dat geval vervangt de Webex-configuratie de BroadWorks-configuratie.

Configuratiesjablonen voor Webex-apps toevoegen aan de BroadWorks-toepassingsserver

Webex-apps worden geconfigureerd met DTAF-bestanden. De clients downloaden een XML-configuratiebestand van de toepassingsserver via de service Apparaatbeheer op de XSP|ADP.

  1. Haal de vereiste DTAF-bestanden op (zie Apparaatprofielen in het gedeelte Uw omgeving voorbereiden).

  2. Controleer of u de juiste tagsets hebt in BroadWorks System > Resources > Device Management Tagsets.

  3. Voor elke client die u inricht:

    1. Download en pak het DTAF zip-bestand voor de specifieke client uit.

    2. DTAF-bestanden importeren naar BroadWorks op System > Resources > Identity/Device Profile Types

    3. Open het nieuw toegevoegde apparaatprofiel voor bewerken en:

      • Voer de XSP|ADP farm FQDN en het Device Access Protocol in.

      • Schakel het selectievakje Support Remote Party Info in. Deze ondersteuning is vereist om bureaublad delen te laten werken.


         
        U kunt de ondersteuning voor Remote Party ook inschakelen door de volgende CLI-opdracht uit te voeren op de toepassingsserver: AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
    4. Pas de sjablonen aan volgens uw omgeving (zie onderstaande tabel).

    5. Sla het bestand op.

  4. Klik op Bestanden en verificatie en selecteer vervolgens de optie om alle systeembestanden opnieuw op te bouwen.

Naam

Beschrijving

Prioriteit codec

Prioriteitsvolgorde configureren voor de audio- en videocodecs voor VoIP-gesprekken

TCP, UDP en TLS

Configureer de protocollen die worden gebruikt voor SIP-signalering en media

RTP-audio- en videopoorten

Poortbereiken configureren voor RTP-audio en -video

SIP-opties

Configureer verschillende opties met betrekking tot SIP (SIP INFO, rport gebruiken, SIP-proxydetectie, vernieuwingsintervallen voor registratie en abonnement, enz.)

Branding voor Webex-app aanpassen


 

De portal voor gebruikersactivering gebruikt hetzelfde logo dat u toevoegt voor Client Branding.

Probleemrapportage en Help-URL's aanpassen

Als u deze opties wilt aanpassen, kunnen administators de procedure 'Feedback en Help-site-URL's toevoegen' volgen, die u in beide bovenstaande brandingartikelen kunt vinden.

Uw testorganisatie configureren voor Webex voor Cisco BroadWorks

Voordat u begint

Met Flowthrough-inrichting

U moet alle XSP|ADP-services en de partnerorganisatie in Control Hub configureren voordat u deze taak kunt uitvoeren.

1

Service toewijzen in BroadWorks:

  1. Maak een testonderneming onder uw serviceprovideronderneming in BroadWorks of maak een testgroep onder uw serviceprovider (afhankelijk van uw BroadWorks-configuratie).

  2. Configureer de IM&P-service voor die onderneming om naar de sjabloon te verwijzen die u test (haal de URL van de inrichtingsadapter en de referenties op in de Control Hub-onboardsjabloon).

  3. Maak testabonnees in die onderneming/groep.

  4. Geef de gebruikers unieke e-mailadressen in het e-mailveld in BroadWorks. Kopieer deze ook naar het kenmerk Alternatieve id.

  5. Wijs de geïntegreerde IM&P-service toe aan deze abonnees.


     

    Hierdoor worden de klantorganisatie en de eerste gebruikers gemaakt, wat enkele minuten duurt. Wacht even voordat u zich probeert aan te melden bij uw nieuwe gebruikers.

2

Klantorganisatie en gebruikers verifiëren in Control Hub:

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Klanten en controleer of uw nieuwe klantorganisatie in de lijst staat (de naam volgt de groepsnaam of de bedrijfsnaam, vanuit BroadWorks).

  3. Open de klantorganisatie en controleer of de abonnees gebruikers in die organisatie zijn.

  4. Controleer of de eerste abonnee aan wie u de geïntegreerde IM&P-service hebt toegewezen, de klantbeheerder van die organisatie is geworden.

Gebruikerstests

1

Download de Webex-app op twee verschillende machines.

2

Meld u aan als testgebruikers op de twee machines.

3

Voer testgesprekken.

Webex voor BroadWorks beheren

Klantorganisaties inrichten

In het huidige model richten we de klantorganisatie automatisch in wanneer u de eerste gebruiker integreert via een van de methoden die in dit document worden beschreven. Inrichting vindt slechts één keer plaats voor elke klant.

Gebruikers inrichten

U kunt gebruikers op de volgende manieren inrichten:

  • API's gebruiken om Webex-accounts te maken

  • Geïntegreerde IM&P (flowthrough provisioning) toewijzen met vertrouwde e-mails om Webex-accounts te maken

  • Wijs geïntegreerde IM&P (flowthrough provisioning) toe zonder vertrouwde e-mails. Gebruikers verstrekken en valideren e-mailadressen om Webex-accounts te maken

  • Gebruikers toestaan zichzelf te activeren (u stuurt ze een koppeling, ze maken Webex-accounts)

API's voor openbare inrichting

Webex stelt openbare API's bloot zodat serviceproviders Webex voor Cisco BroadWorks-abonneevoorzieningen kunnen integreren in hun bestaande inrichtingswerkstromen. De specificatie voor deze API's is beschikbaar op developer.webex.com. Als u wilt ontwikkelen met deze API's, neemt u contact op met uw Cisco-vertegenwoordiger om Webex voor Cisco BroadWorks op te halen.


 

Groothandels worden geweigerd door deze API's.

Doorstroominrichting

Op BroadWorks kunt u gebruikers inrichten met de optie Geïntegreerde IM&P inschakelen. Door deze actie voert de BroadWorks-inrichtingsadapter een API-oproep uit om de gebruiker in te richten op Webex. Onze provisioning-API is achterwaarts compatibel met de UC-One SaaS API. BroadWorks AS vereist geen codewijziging, alleen een configuratiewijziging naar het API-eindpunt voor de inrichtingsadapter.


 

Het inrichten van abonnees op Webex kan aanzienlijk duren (enkele minuten voor de eerste gebruiker binnen een onderneming). Webex voert de inrichting uit als een achtergrondtaak. Als de flowthrough-inrichting is geslaagd, geeft dit aan dat de inrichting is gestart. Het duidt niet op voltooiing.

Als u wilt bevestigen dat gebruikers en de klantorganisatie volledig zijn ingericht op Webex, moet u zich aanmelden bij Partner Hub en in uw lijst met klanten kijken.

BroadWorks-trunking-gebruikers kunnen Webex voor BroadWorks hebben via een gedeelde gespreksweergave (SCA). De trunking-gebruiker moet de verificatieservice hebben toegewezen. Zoals beschreven in de BroadWorks-handleiding voor trunking-oplossingen (Trunking Solution Guide) 8, kan de verificatie van de SCA Webex-weergave worden gescheiden van de algemene trunkverificatie. Webex voor BroadWorks kan niet worden ingericht voor trunking-gebruikers waaraan de functies Routelijst of Directe route zijn toegewezen.


 
De locatie van sjablonen is verplaatst van BroadWorks-gesprekken in de organisatie-instellingen naar het gedeelte Klantenlijst en wordt nu de onboardingsjabloon genoemd.

Zelfactivering van de gebruiker

BroadWorks-gebruikers inrichten in Webex zonder de geïntegreerde IM&P-service toe te wijzen:

  1. Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.

  2. Klik op Sjablonen weergeven.

  3. Selecteer de inrichtingssjabloon voor onboarding die u wilt toepassen op deze gebruiker.

    Vergeet niet dat elke sjabloon is gekoppeld aan een cluster en uw partnerorganisatie. Als de gebruiker zich niet in het BroadWorks-systeem bevindt dat aan deze sjabloon is gekoppeld, kan de gebruiker de koppeling niet zelf activeren.

  4. Kopieer de inrichtingskoppeling en verzend deze naar de gebruiker.

    U kunt ook de downloadkoppeling voor de software opnemen en de gebruiker eraan herinneren dat hij of zij zijn of haar e-mailadres moet opgeven en valideren om zijn of haar Webex-account te activeren.

  5. U kunt de activeringsstatus van de gebruiker op de geselecteerde sjabloon controleren.

Zie Gebruikersvoorzieningen en activeringsstromen voor meer informatie.

Inrichting met niet-vertrouwde e-mails

Partner Hub biedt een reeks besturingselementen in de weergave Gebruikersstatus waarmee Webex voor Cisco BroadWorks-serviceproviderbeheerders de gebruikersstatus kunnen controleren en fouten kunnen oplossen bij het inrichten van niet-vertrouwde e-mails. Zie Gebruikersvoorzieningen met niet-vertrouwde e-mails verifiëren voor meerinformatie.

Webex-gebruikers verplaatsen naar Webex voor Cisco BroadWorks

Als u bestaande Webex-gebruikers wilt verplaatsen naar Webex voor Cisco BroadWorks, raadpleegt u de onderstaande tabel om te bepalen welke procedure moet worden gevolgd.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfaanmelding (bv. gratis account, proefaccount)

  1. Inrichtingsgebruikers: als de Webex voor BroadWorks-organisatie niet bestaat (zonder dat er gebruikers zijn ingericht), volgt u de normale inrichting om de eerste gebruiker in te richten als beheerdersgebruiker en maakt u de organisatie. Hiermee wordt het Webex-gebruikersaccount automatisch verplaatst voor de eerste gebruiker. Gebruik de onderstaande procedure voor volgende gebruikers.

  2. Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks: als de Webex voor BroadWorks-organisatie bestaat (eerste gebruiker is ingericht), verkrijgt u toestemming van de gebruiker en verplaatst u volgende gebruikers.

Klantorganisatie

Webex voor BroadWorks toevoegen aan bestaande organisatie: de bijlage bij de organisatie (voor de eerste gebruiker) voegt ook Webex voor BroadWorks toe aan volgende gebruikers, zolang deze zijn toegewezen aan de juiste organisatie.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfaanmelding (bv. gratis account, proefaccount)

Als Webex voor BroadWorks-organisatie niet bestaat (er zijn geen gebruikers ingericht):

  • Inrichtingsgebruikers: volg de normale inrichting om de eerste gebruiker als een beheerdersgebruiker toe te voegen. Hiermee wordt het account voor de eerste gebruiker automatisch verplaatst en wordt de Webex for BroadWorks-organisatie gemaakt. Toestemming van de gebruiker is vereist om susbsequente gebruikers te verplaatsen (gebruik de onderstaande procedure).

Als Webex voor BroadWorks-organisatie bestaat (er is ten minste één gebruiker ingericht):

Klantorganisatie

Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks

Gebruik deze procedure om een bestaande Webex-gebruiker die zich in een consumentenorganisatie bevindt of een zelfaanmeldingsaccount heeft (gratis account of proefaccount) te verplaatsen naar Webex voor Cisco BroadWorks. Houd er rekening mee dat de Webex voor Cisco BroadWorks-organisatie moet bestaan (met de eerste gebruiker ingericht). In dit geval kunt u een van de volgende opties gebruiken om gebruikers te verplaatsen:

  • Gebruiker verplaatsen (met vertrouwde e-mail): gebruikt inrichting met vertrouwde e-mails

  • Gebruiker verplaatsen (met niet-vertrouwde e-mail): gebruikt inrichting met niet-vertrouwde e-mails

  • Zelfactivering


 
Als de Webex voor Cisco BroadWorks-organisatie nog niet is gemaakt (er zijn geen gebruikers ingericht), volgt u de normale inrichtingsprocessen (Inrichtingsgebruikers) om de organisatie te maken en de eerste gebruiker toe te voegen als een beheergebruiker. Nadat de eerste gebruiker is ingericht in de organisatie, volgt u de op toestemming gebaseerde methoden in deze procedure om volgende gebruikers te verplaatsen.

Gebruiker verplaatsen (met vertrouwd e-mailadres)

Als de onboardsjabloon vertrouwde e-mails gebruikt, kan de partnerbeheerder volgende gebruikers met dit proces verplaatsen:

  1. De beheerder voegt de gebruiker toe.

    • De gebruiker wordt gepusht naar de BroadWorks-inrichtingsbrug.

    • De CI-zoekopdracht bepaalt dat deze gebruiker een ander Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  2. De gebruiker opent de e-mail en klikt op Account activeren. De gebruiker wordt omgeleid naar de Webex-consumentenportal.

  3. Gebruiker meldt zich aan bij Webex.

  4. De gebruiker klikt op Verwijderen om het oude Webex-account te verwijderen.

    • Het oude Webex-account is verwijderd.

    • De gebruiker is ingericht in Webex voor Cisco BroadWorks met hetzelfde e-mailadres.

    • De gebruiker wordt omgeleid naar de pagina Downloaden.

Gebruiker verplaatsen (met niet-vertrouwde e-mail)

Als de onboardsjabloon niet-vertrouwde e-mails gebruikt, moet het e-mailadres van de gebruiker eerst worden gevalideerd. De beheerder kan dit proces volgen om volgende gebruikers te verplaatsen:

  1. De beheerder voegt de gebruiker toe.

    • De gebruiker wordt automatisch naar de BroadWorks-inrichtingsbrug gepusht.

    • Er wordt een tekst met een activeringskoppeling naar de gebruiker verzonden.

  2. De gebruiker klikt op de activeringskoppeling en voert het e-mailadres in.

    • De CI-zoekopdracht bepaalt dat deze gebruiker een ander Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op Nu deelnemen.

    • Het e-mailadres is gevalideerd.

    • De gebruiker wordt omgeleid om zich aan te melden bij de Webex-consumentenportal.

  4. Gebruiker meldt zich aan bij Webex.

  5. De gebruiker moet op Verwijderen klikken om het oude Webex-account te verwijderen.

    • Het oude Webex-account is verwijderd.

    • De gebruiker is ingericht in Webex voor Cisco BroadWorks met hetzelfde e-mailadres.

    • De gebruiker wordt omgeleid naar de pagina Downloaden.

Zelfactiveringsstroom

Als de gebruiker een bestaand BroadWorks-account heeft, kan hij of zij het zelfactiveringsproces gebruiken om zijn of haar account te verplaatsen.

  1. De gebruiker meldt zich aan bij de URL van de gebruikerstoegang met BroadWorks-aanmeldgegevens.

  2. De gebruiker voert zijn/haar e-mailadres in.

    • De gebruiker wordt gepusht naar de BroadWorks-inrichtingsbrug.

    • Er wordt een geautomatiseerd e-mailadres naar het e-mailadres van de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op de koppeling Nu deelnemen, waarmee het e-mailadres wordt gevalideerd.

    • CI zoekt gebruiker heeft een bestaand Webex-account. Gebruikers moeten het oude account verwijderen voordat ze kunnen doorgaan.

    • Gebruiker wordt omgeleid om zich aan te melden bij Webex.

  4. De gebruiker meldt zich aan bij de Consumentenportal.

  5. De gebruiker klikt op Account verwijderen.

    • Het oude Webex-account wordt verwijderd.

    • De gebruiker heeft een nieuw Webex voor Cisco BroadWorks-account met hetzelfde e-mailadres ingericht.

Webex voor BroadWorks toevoegen aan bestaande organisatie

Als u een partnerbeheerder bent die Webex voor BroadWorks-services toevoegt aan een bestaande Webex-klantorganisatie die nog niet is gekoppeld aan een door een partner beheerde BroadWorks-onderneming, MOET de beheerder van de klantorganisatie beheerderstoegang voor het inrichtingsverzoek goedkeuren om te slagen.

De goedkeuring van de organisatiebeheerder is vereist als een van de volgende situaties waar is:

  • De bestaande klantorganisatie heeft 100 gebruikers of meer

  • De organisatie heeft een geverifieerd e-maildomein

  • Het organisatiedomein is geclaimd

Als geen van de bovenstaande criteria waar is, kan een Automatic Attach optreden.


 
In een scenario met automatische bijlage wordt een Webex voor BroadWorks-abonnement toegevoegd aan een bestaande klantorganisatie zonder melding aan de bestaande organisatiebeheerder of eindgebruiker. In de meeste gevallen krijgt uw partnerorganisatie inrichtingsbeheerdersrechten. Als de klantorganisatie echter geen licenties heeft of alleen licenties heeft opgeschort/geannuleerd, wordt u een volledige beheerder gemaakt.

Met toegang tot de inrichtingsbeheerder hebt u beperkte zichtbaarheid in Control Hub voor de gebruikers in de bestaande organisatie. Het wordt aanbevolen dat u contact opneemt met de klantbeheerder en volledige beheerderstoegang tot de organisatie aanvraagt.

Partnerbeheerders kunnen de volgende procedure voltooien om BroadWorks-gespreksservices toe te voegen aan een bestaande Webex-organisatie:


 
Zorg ervoor dat de e-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties (de schakelaar is standaard ingeschakeld).
1

De partnerbeheerder richt Webex voor Cisco BroadWorks in voor de klant. Zie Inrichting van klantorganisaties voor hulp. Nu gebeurt het volgende:

  • Organisatiebijlage mislukt met een 2017 fout (Kan abonnee niet inrichten in een bestaande Webex-organisatie). (Er wordt geen fout ontvangen tijdens een automatische bijlage.)

  • Er wordt een e-mailmelding gegenereerd en verzonden naar de beheerders van de klantorganisatie (maximaal vijf beheerders). In de e-mailmelding wordt het e-mailadres van de partnerbeheerder gemarkeerd (zoals geconfigureerd in de sjabloon voor onboarding in Partner Hub) en wordt de organisatiebeheerder gevraagd de partnerbeheerder goed te keuren als externe beheerder. De klantorganisatiebeheerder moet het verzoek goedkeuren en de partnerbeheerder volledige beheerder toegang geven tot de klantorganisatie.


 

Stel dat de klantbeheerder geen e-mail ontvangt. In dat geval kan de klantbeheerder de partnerbeheerder (opgegeven in de sjabloon) handmatig toevoegen als de externe beheerder van de klantorganisatie vanuit de Control Hub. Probeer de gebruiker vervolgens opnieuw in te richten, waardoor de Webex voor Cisco BroadWorks-klantvoorziening wordt geactiveerd.

2

Met volledige beheerderstoegang kan de partnerbeheerder het proces voor het inrichten van de klant voltooien. Vanaf stap 1 hierboven moet u de inrichting van de klant opnieuw proberen. Nu u een externe Full Admin bent, mag u de fout 2017 echter niet waarnemen.

Zodra de inrichting van gespreksservices is voltooid, is de bestaande klantorganisatie zichtbaar als klant onder de partnerorganisatie van Webex voor BroadWorks.


 
De naam van de bijgevoegde organisatie verandert niet in de bedrijfsnaam van BroadWorks. De naam van de bijgevoegde organisatie blijft behouden zoals die was voorafgaand aan het bijvoegproces.

Voorwaarden van organisatiebijlage

  • Het e-mailadres van de eerste BroadWorks-abonnee die is ingericht, moet overeenkomen met het e-mailadres van een bestaande gebruiker in de beoogde klantorganisatie. Anders wordt een nieuwe klantorganisatie gemaakt.

  • De eerste gebruiker van de bestaande organisatie die is ingericht voor Webex voor BroadWorks, is niet ingericht als beheerdersgebruiker. Instellingen en rechten van de bestaande organisatie worden behouden.

  • De bestaande verificatie-instellingen van de organisatie hebben voorrang op wat is geconfigureerd op de Webex for BroadWorks-inrichtingssjabloon. Als gevolg hiervan verandert er niets aan de manier waarop bestaande gebruikers zich aanmelden.

    • Als de bestaande klantorganisatie echter basisbranding heeft ingeschakeld, hebben de geavanceerde branding-instellingen van de partner voorrang nadat de bijvoeging plaatsvindt. Als de klant wil dat de basisbranding intact blijft, moet de partner de klantorganisatie configureren om de branding in de instellingen voor geavanceerde branding te overschrijven.

  • De naam van de bestaande organisatie wordt niet gewijzigd.

  • Er is geen wijziging in de vlaggen voor e-mailonderdrukking in de instellingen van de bestaande organisatie. Dit kan van invloed zijn op nieuw ingerichte gebruikers. Afhankelijk van hoe de vlag is ingesteld, ontvangen nieuwe gebruikers al dan niet een e-mail met een code die moet worden ingevoerd om de activering te voltooien.

  • De beperkte beheermodus (ingesteld door de schakelaar voor beperkte partnermodus) is uitgeschakeld voor de bijgevoegde organisatie.

  • Zorg ervoor dat u het bevestigingsproces voor de organisatie voltooit (bestaande gebruikers verplaatsen en de organisatie-id bijwerken) voordat u nieuwe gebruikers inricht in de Webex voor Cisco BroadWorks-organisatie.

  • Een BroadWorks-onderneming kan slechts aan één Webex-organisatie worden gekoppeld. U kunt abonnees van één BroadWorks-onderneming niet inrichten in afzonderlijke Webex-organisaties.

Externe beheerder toevoegen

Zie het artikel Aanvraag externe beheerder goedkeuren voor de stappen die klantorganisatiebeheerders kunnen volgen om de partnerbeheerder toe te voegen als externe beheerder op help.webex.com.


 
De klantbeheerder moet de externe beheerder de volledige beheerdersrechten en -rechten geven.

 
Het e-mailadres dat de beheerder van de klantorganisatie als externe beheerder toevoegt, moet overeenkomen met het e-mailadres van de partnerbeheerder zoals is geconfigureerd in de sjabloon voor onboarding op Partner Hub.

Nadat u de e-mail van het onboardsjabloon op Partnerhub hebt toegevoegd als volledige beheerder, moeten eventuele extra partnerbeheerders ook worden toegevoegd als externe beheerder met volledige beheerdersrechten.

Webex voor BroadWorks loskoppelen van bestaande organisatie

Volg deze stappen om Webex voor BroadWorks los te koppelen van een bestaande Webex-organisatie. Als u bijvoorbeeld per ongeluk Webex voor BroadWorks aan een bestaande organisatie hebt gekoppeld en de bijlage wilt verwijderen.


 

Als u in Standaardstroom Webex voor BroadWorks loskoppelt van een bestaande Webex-organisatie (alleen standaardstroom), worden alle bijbehorende abonneegegevens verwijderd en wordt het Webex voor BroadWorks-abonnement van de klant gedeactiveerd. U verliest ook de toegang tot de klantorganisatie als dit het enige gekoppelde abonnement is. In de hybride stroom worden de klantabonnementen niet gewijzigd.

  1. Als u geen toegang hebt tot de klantinstellingen in Control Hub, laat de klantbeheerder u externe beheerder dan toegang verlenen door het verzoek van externe beheerder goed te keuren.

  2. Verwijder alle Webex voor BroadWorks-werkplekken uit de organisatie. Gebruik de API Een BroadWorks-werkplek verwijderen.

  3. Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de API Een BroadWorks-abonnee verwijderen.

  4. Verwijder in behandeling zijnde Webex voor BroadWorks-gebruikers uit de organisatie. Als gebruikers bijvoorbeeld zijn ingericht via de niet-vertrouwde e-mailstroom en er nog geen geldige e-mails zijn ingevoerd, blijven de gebruikers in behandeling. Volg Gebruikersvoorzieningen verifiëren met niet-vertrouwde e-mails om de gebruikers te verwijderen.

  5. Verwijder de configuratie van BroadWorks Calling voor deze klant. Open het Control Hub-exemplaar van de klant en klik op Hybrid onder het gedeelte BroadWorks Calling om alle configuraties te verwijderen.

Als u na de onthechting Webex voor BroadWorks aan de klant wilt koppelen, volgt u de inrichtingsprocessen om deze aan een bestaande klant te koppelen.


 
Een alternatieve optie om abonnees te verwijderen als u de API Een BroadWorks-abonnee verwijderen niet wilt gebruiken, is om naar BroadWorks CommPilot te gaan en de geïntegreerde IM&P-service voor de betrokken gebruikers te verwijderen.

Gebruikers en organisaties beheren

Als u gebruikers in Webex voor Cisco BroadWorks wilt beheren, moet u bedenken dat de gebruiker zowel in BroadWorks als in Webex bestaat. Belattributen en de BroadWorks-identiteit van de gebruiker worden in BroadWorks gehouden. Een afzonderlijke e-mailidentiteit voor de gebruiker en de licenties voor Webex-functies worden in Webex bewaard.

Gebruikersvoorzieningen verifiëren met niet-vertrouwde e-mails

Als u Webex voor BroadWorks-gebruikers inricht via doorstroominrichting met niet-vertrouwde e-mails, moeten gebruikers zichzelf inrichten door hun e-mailadres in de portal voor gebruikersactivering in te voeren. Als er een fout optreedt, kan de gebruiker de optie Opnieuw proberen gebruiken die in de portal wordt weergegeven om een nieuwe poging te doen. Als de gebruiker de fout opnieuw ondervindt, kan de beheerder de onderstaande stappen in Partner Hub gebruiken om de status te controleren en de gebruiker te onboarden, de gebruiker te verwijderen of configuratiewijzigingen toe te passen.

1

Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.

2

Klik op Sjablonen weergeven. Selecteer de juiste onboardsjabloon die u wilt toepassen op deze gebruiker.

3

Controleer onder Gebruikersverificatie of de volgende instellingen zijn ingesteld om ervoor te zorgen dat doorstroominrichting met niet-vertrouwde e-mails correct is geconfigureerd:

  • De optie Niet-vertrouwde e-mails moet zijn ingeschakeld
  • Het veld Koppeling delen moet naar de activeringskoppeling verwijzen. Als alles is geconfigureerd, kunnen gebruikers proberen zichzelf in te richten via de User Activation Portal.
4

Nadat de gebruiker is ingericht, klikt u in het gedeelte Gebruikersverificatie op Gebruikersstatus weergeven om de inrichtingsstatus te controleren.

In de weergave Gebruikersstatus wordt de lijst met gebruikers weergegeven, samen met details zoals de BroadWorks-id, het geselecteerde pakkettype en de huidige status. Deze weergave geeft aan of de gebruiker is ingericht of dat er een vereiste in behandeling is.
5

Voor gebruikers met fouten of vereisten in behandeling, klikt u op de drie stippen aan de rechterkant en kiest u een van de volgende beheeropties:

  • Activering opnieuw proberen: klik op deze optie om opnieuw te proberen de gebruiker te onboarden. Voer in het pop-upvenster een geldig e-mailadres in en klik op Onboard.
  • Gebruiker verwijderen: deze optie is mogelijk van toepassing als u de configuratie moet wijzigen om onboarding toe te staan. Nadat u de gebruiker hebt verwijderd en uw wijzigingen hebt aangebracht, kan de gebruiker opnieuw proberen te onboarden.
  • Pakkettype wijzigen: wijzig de instelling van het ene pakket naar het andere:
  • Fouttekst kopiëren: klik op deze optie om de fouttekst te kopiëren.

Aanvullende weergaveopties

De volgende extra opties zijn beschikbaar wanneer u de lijst met gebruikers bekijkt:

  • Exporteren: klik op deze knop als u de gebruikerslijst wilt exporteren naar een CSV-bestand.

  • Ingerichte gebruikers uitsluiten: schakel deze schakelaar in als u alleen gebruikers met vereisten of fouten in behandeling wilt weergeven.

Gebruikers-id of e-mailadres wijzigen

Wijzigingen gebruikers-id en e-mailadres

E-mail-id en alternatieve id zijn de BroadWorks-gebruikerskenmerken die worden gebruikt met Webex voor Cisco BroadWorks. De BroadWorks-gebruikers-id is nog steeds de primaire id van de gebruiker in BroadWorks. In de volgende tabel worden de doelstellingen van deze verschillende kenmerken beschreven en wordt beschreven wat u moet doen als u ze moet wijzigen:

Kenmerk in BroadWorksOvereenkomstig kenmerk in WebexDoelNotities
BroadWorks-gebruikers-idGeenPrimaire idU kunt deze id niet wijzigen en de gebruiker nog steeds aan hetzelfde account in Webex koppelen. U kunt de gebruiker verwijderen en opnieuw maken als dit onjuist is.
E-mail-idGebruikers-id

Verplicht voor doorstroominrichting (maken van Webex-gebruikers-id) wanneer u aangeeft dat u e-mail vertrouwt

Niet vereist in BroadWorks als u niet beweert dat u e-mails kunt vertrouwen

Niet vereist in BroadWorks als u abonnees toestaat zichzelf te activeren

Er is een handmatig proces om dit op beide plaatsen te wijzigen als de gebruiker het verkeerde e-mailadres heeft gekregen:

  1. Het e-mailadres van de gebruiker wijzigen in Control Hub

  2. E-mail-id-kenmerk wijzigen in BroadWorks

Wijzig de BroadWorks-gebruikers-id niet. Dit wordt niet ondersteund.

Alternatieve idGeenHiermee schakelt u het authn van de gebruiker in, via e-mail en wachtwoord, met de BroadWorks-gebruikers-idMoet hetzelfde zijn als de e-mail-id. Als U het e-mailadres niet in het kenmerk Alternatieve id kunt plaatsen, moeten gebruikers hun BroadWorks-gebruikers-id invoeren bij de verificatie.

Gebruikerspakket wijzigen in Partner Hub

1

Meld u aan bij Partner Hub en klik op Klanten.

2

Zoek en selecteer de klantorganisatie waar de gebruiker is gehuisvest.

De overzichtspagina van de organisatie wordt geopend in een deelvenster aan de rechterkant van het scherm.

3

Klik op Klant weergeven.

De klantorganisatie wordt geopend in Control Hub en toont de pagina Overzicht.
4

Klik op Users, zoek en klik op de getroffen gebruiker.

5

Klik in de Services van de gebruiker op Webex voor BroadWorks-pakketten (abonnementen).

Het deelvenster Pakketten van de gebruiker wordt geopend en u kunt zien welk pakket momenteel aan de gebruiker is toegewezen.

6

Kijk in het tabblad Profiel in het gedeelte Pakket en klik op het pijltje (>) om de weergave uit te vouwen.

7

Selecteer het gewenste pakket voor deze gebruiker (Basic, Standard, Premium of Softphone) en klik op Save.

Control Hub toont een bericht dat de gebruiker bijwerkt.

8

U kunt de gebruikersgegevens en het tabblad Control Hub sluiten.


 
Standaard- en Premium-pakketten hebben verschillende vergadersites die bij elk pakket horen. Wanneer een abonnee met beheerdersrechten met een van deze twee pakketten naar het andere pakket gaat, wordt de abonnee weergegeven met twee vergadersites in Control Hub. De vergaderingsmogelijkheden en vergaderingssite van de abonnee komen overeen met het huidige pakket. De vergadersite van het vorige pakket en alle eerder gemaakte inhoud op die site, zoals opnamen, blijven toegankelijk voor de sitebeheerder van de vergadering.

 
Het kan twee tot drie uur duren voordat nieuwe PMR-instellingen die het gevolg zijn van een pakketwijziging, worden bijgewerkt.

Gebruikers verwijderen

Er zijn verschillende methoden die beheerders kunnen gebruiken om een gebruiker te verwijderen uit Webex voor Cisco BroadWorks:


 
Als de gebruiker die u gaat verwijderen beheerdersrechten heeft, wijst u een nieuwe beheerder toe voordat u de gebruiker verwijdert. Er is geen automatische overdracht van de beheerdersrol als de laatste beheerder wordt verwijderd.

Webex voor Cisco BroadWorks API

Partnerbeheerders kunnen de Webex for Cisco BroadWorks API gebruiken om gebruikers te verwijderen:

  1. Voer de Remove a BroadWorks Subscriber API-aanvraag uit op https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Met deze aanvraag wordt het Webex for Cisco BroadWorks-abonnement verwijderd. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt behandeld als een gratis Webex-gebruiker.

  2. Voer het API-verzoek Een persoon verwijderen uit op https://developer.webex.com/docs/api/v1/people/delete-a-person om de gebruiker volledig te verwijderen.

Doorstroominrichting

Partnerbeheerders kunnen doorstroominrichting gebruiken om gebruikers te verwijderen:

  1. Op de BroadWorks-server verwijdert u de geïntegreerde IM+P-service van de gebruiker. U kunt de service voor de gebruiker uitschakelen via de pagina User – Integrated IM&P op BroadWorks. Zie 'Geïntegreerde IM&P configureren' in de Beheerhandleiding voor de webinterface van de Cisco BroadWorks-toepassingsservergroep – deel 2 voor een gedetailleerde procedure.

    Nadat de service is uitgeschakeld, verwijdert doorstroominrichting het Webex for Cisco BroadWorks-abonnement van de gebruiker. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt behandeld als een gratis Webex-gebruiker.

  2. Zoek en selecteer de gebruiker in Control Hub.

  3. Ga naar Actions en selecteer Delete User.

Control Hub (klantbeheerders)

Klantbeheerders kunnen Control Hub gebruiken om gebruikers uit hun organisatie te verwijderen. Zie Een gebruiker uit uw organisatie verwijderen in Webex Control Hub op https://help.webex.com/0qse04/ voor meer informatie.

Organisatie verwijderen

Volg deze procedure om een Webex voor Cisco BroadWorks-organisatie uit het systeem te verwijderen.
1

Gebruik de People API's om alle gebruikers uit de organisatie te verwijderen:

  1. Voer de API Personen weergeven uit om een lijst met gebruikers op te halen.

  2. Voer de API Een persoon verwijderen uit om de gebruikers te verwijderen.


 
Met de Een BroadWorks-abonnee-API verwijderen worden Webex voor Cisco BroadWorks-rechten van een gebruiker verwijderd, maar wordt de gebruiker niet verwijderd.
2

Als adreslijstsynchronisatie is ingeschakeld, schakelt u deze uit. Dit kan via Partner Hub of via de openbare API.

Adreslijstsynchronisatie uitschakelen via Partner Hub:

  1. Meld u aan bij Partner Hub en klik op Instellingen.

  2. Klik onder BroadWorks Calling op Sjablonen weergeven en selecteer de juiste sjabloon.

  3. Klik op de knop Toon statuslijst klantsynchronisatie in het zijpaneel.

  4. Voor de juiste klant klikt u op de drie stippen helemaal rechts en selecteert u Synchronisatie uitschakelen.

Als u adreslijstsynchronisatie via API wilt uitschakelen, gebruikt u Adreslijstsynchronisatie voor een BroadWorks Enterprise-API bijwerken en schakelt u de instelling enableDirSync uit.

Alle gebruikers met betrekking tot BroadWorks-adreslijstsynchronisatie voor deze organisatie worden verwijderd. Houd er rekening mee dat het verwijderen van gebruikers (met behulp van een van beide methoden) enige tijd kan duren, afhankelijk van de hoeveelheid gebruikers.

3

Nadat alle gebruikers zijn verwijderd, gebruikt u de API Een organisatie verwijderen om de organisatie te verwijderen.

Vrijgavebeheer

Bedieningselementen voor releasebeheer in Partner Hub maken het eenvoudig voor Webex voor Cisco BroadWorks-serviceproviders om releases te beheren door hen de mogelijkheid te geven de releasecadans te beheren waarmee de Webex-apps van gebruikers upgraden naar de nieuwste software.

De Webex-app maakt standaard gebruik van automatische upgrades (door Cisco beheerde maandelijkse versies). Met deze functie kunnen partnerbeheerders echter:

  • Aangepaste releaseschema's configureren met uitstel van de standaardreleaseschema's van Cisco

  • Configureer één releaseschema en trapsgewijs die planning naar alle klantorganisaties die ze beheren

  • Verschillende releaseschema's toewijzen aan verschillende klantorganisaties

Zie het Webex-artikel Aanpassingen voor releasebeheer voor meer informatie over releasebeheer, waaronder informatie over het configureren en toepassen van aangepaste releaseplanningen.

Het systeem opnieuw configureren

U kunt het systeem als volgt opnieuw configureren:

  • Een BroadWorks-cluster toevoegen in Partner Hub

  • Een BroadWorks-cluster bewerken of verwijderen in Partnerhub

  • Een onboardingsjabloon toevoegen in Partner Hub

  • Een onboardsjabloon bewerken of verwijderen in Partner Hub

Een BroadWorks-cluster bewerken of verwijderen in Partnerhub

U kunt een BroadWorks-cluster bewerken of verwijderen in Partnerhub.

1

Meld u aan bij Partner Hub met uw partnerbeheergegevens op https://admin.webex.com.

2

Ga naar Instellingen en zoek het gedeelte BroadWorks-gesprekken.

3

Klik op Clusters weergeven.

4

Klik op het cluster dat u wilt bewerken of verwijderen.

De clusterdetails worden weergegeven in een flyout-venster aan de rechterkant.
5

U hebt de volgende opties:

  • Wijzig de gegevens die u moet wijzigen en klik op Opslaan.
  • Klik op Verwijderen om het cluster te verwijderen en bevestig.

     

    Als er veel klanten (>50) in het BroadWorks-cluster zijn, worden bewerkingen zoals het bijwerken van XSI-acties, XSI-gebeurtenissen, DAS-URL, XSP|ADP-URL of NST-synchronisatie niet ondersteund. In dergelijke gevallen wordt het aanbevolen contact op te nemen met een Cisco TAC-ondersteuningsmedewerker voor ondersteuning.

    Als een sjabloon is gekoppeld aan het cluster, kunt u een cluster niet verwijderen. Verwijder de gekoppelde sjablonen voordat u het cluster verwijdert. Zie Een onboardsjabloon bewerken of verwijderen in Partnerhub.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Een onboardsjabloon bewerken of verwijderen in Partner Hub

U kunt sjablonen voor onboarding bewerken of verwijderen in Partner Hub.

1

Meld u aan bij Partner Hub met uw partnerbeheergegevens op https://admin.webex.com.

2

Ga naar Instellingen en zoek het gedeelte BroadWorks-gesprekken.

3

Klik op Sjablonen weergeven.

4

Klik op de sjabloon die u wilt bewerken of verwijderen.

5

U hebt de volgende opties:

  • Bewerk de gegevens die u moet wijzigen en klik op Opslaan.
  • Klik op Verwijderen om de sjabloon te verwijderen en bevestig.

Instelling

Waarden

Notities

Accountnaam/wachtwoord inrichten

Door gebruiker geleverde tekenreeksen

U hoeft de inrichtingsaccountgegevens niet opnieuw in te voeren bij het bewerken van een sjabloon. De velden Leeg wachtwoord/Wachtwoordbevestiging zijn er om de referenties te wijzigen als dat nodig is, maar laat ze leeg om de waarden te behouden die u oorspronkelijk hebt opgegeven.

E-mailadres van de gebruiker vooraf invullen op de aanmeldpagina

Aan/uit

Het kan tot 7 uur duren voordat een wijziging in deze instelling van kracht wordt. Dat wil zeggen, nadat u deze hebt ingeschakeld, moeten gebruikers mogelijk nog steeds hun e-mailadres invoeren op het aanmeldscherm.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Webex Assistant

Webex-assistent Meetings is een intelligente, interactieve virtuele vergaderingassistent die vergaderingen doorzoekbaar, actiebaar en productiever maakt. U kunt de Webex Assistant vragen actie-items op te volgen, belangrijke beslissingen te nemen en belangrijke momenten tijdens een vergadering of gebeurtenis te markeren.

Webex Assistant voor vergaderingen is gratis beschikbaar voor vergadersites met het Premium- en Standard-pakket en voor persoonlijke vergaderruimten. Support omvat zowel nieuwe als bestaande sites.

Webex Assistant voor vergaderingen inschakelen

Webex Assistant is standaard ingeschakeld voor zowel Standard- als Premium-pakket Broadworks-klanten.

Partnerbeheerders en klantorganisatiebeheerders kunnen de functie voor klantorganisaties uitschakelen via Control Hub.

Beperkingen

De volgende beperkingen bestaan voor Webex voor Cisco BroadWorks:

  • De ondersteuning is beperkt tot vergadersites met het Premium- en Standard-pakket en alleen persoonlijke vergaderruimten.

  • Transcripties voor ondertiteling worden alleen ondersteund in het Engels, Spaans, Frans en Duits.

  • Inhoud delen via e-mail is alleen toegankelijk voor gebruikers binnen uw organisatie

  • Vergaderingsinhoud is niet toegankelijk voor gebruikers buiten uw organisatie. Vergaderingsinhoud is ook niet toegankelijk wanneer deze wordt gedeeld tussen gebruikers van verschillende pakketten binnen dezelfde organisatie.

  • Met het Premium-pakket zijn transcripties na de vergadering beschikbaar, ongeacht of Webex Assistant is in- of uitgeschakeld. Als er echter lokale opname is geselecteerd, worden er geen transcripties of markeringen na de vergadering vastgelegd.

  • Met het standaardpakket is de optie Vergadering opnemen in de cloud niet beschikbaar en zijn transcripties na de vergadering dus niet beschikbaar, ongeacht of Webex Assistant is in- of uitgeschakeld. Als lokale opname is geselecteerd, worden zelfs transcripties of markeringen na de vergadering niet vastgelegd.

Aanvullende Informatie Over Webex Assistant

Zie Webex Assistant gebruiken in Webex Meetings en Events voor gebruikersinformatie over het gebruik van de functie.

Webex-gesprekken uitschakelen

Gratis bellen via Webex is standaard ingeschakeld zodat gebruikers gratis gesprekken kunnen voeren naar elk apparaat waarvoor Webex is ingeschakeld. Als u echter wilt dat alle gesprekken de BroadWorks-infrastructuur gebruiken, kunt u Webex-gesprekken binnen een onboardsjabloon uitschakelen. Hiermee schakelt u die optie uit voor de klantorganisaties die de sjabloon gebruiken.

Functieondersteuning

Wanneer Webex Calling is uitgeschakeld, zijn de volgende voorwaarden van toepassing op Webex voor Cisco BroadWorks-gebruikers:

  • Gebruikers zien Bellen met Webex niet meer als een selecteerbare gespreksoptie in de Webex-app.

  • Gebruikers kunnen geen gratis Webex-gesprekken plaatsen of ontvangen naar niet-Webex voor Cisco BroadWorks-gebruikers. Dit omvat gesprekken die zijn gestart vanuit een Webex-teamruimte, gespreksgeschiedenis, contactpersonen door de URI of het e-mailadres van de andere gebruiker in te voeren in de zoekbalk.

  • Scherm delen werkt binnen een BroadWorks-gesprek.

  • Webex-vergaderingen en telefonische aanwezigheid werken nog steeds, zelfs als Webex-gesprekken zijn uitgeschakeld.

Webex-gesprekken uitschakelen (nieuwe onboardsjabloon)

Tijdens het configureren van een nieuwe onboardsjabloon kunt u configureren of Webex-gesprekken worden in- of uitgeschakeld door het selectievakje Gratis bellen via Cisco Webex uitschakelen in de wizard Een nieuwe sjabloon toevoegen in te schakelen of uit te schakelen. Deze instelling wordt opgehaald voor gebruikers in klantorganisaties die u aan de sjabloon toewijst.

Zie Uw partnerorganisatie configureren in Partner Hub voor meer informatie over het configureren van een nieuwe integratiesjabloon.

Webex-gesprekken uitschakelen (bestaande onboardsjabloon)

Volg deze procedure om Webex-gesprekken uit te schakelen van een bestaande integratiesjabloon. Hiermee wordt de functie uitgeschakeld voor alle nieuwe gebruikers in klantorganisaties die deze sjabloon gebruiken.

  1. Meld u aan bij Partnerhub op admin.webex.com.

  2. Kies Instellingen.

  3. Klik op Sjabloon weergeven en kies de juiste onboardingsjabloon.

  4. Klik op Cisco Webex Free Calling uitschakelen.

  5. Klik op Opslaan.

Webex-gesprekken uitschakelen (bestaande gebruiker)

Als u deze functie uitschakelt op een onboardsjabloon, wordt de instelling alleen gewijzigd voor nieuwe gebruikers die zijn toegewezen aan de sjabloon. Als u Webex-gesprekken wilt uitschakelen voor een bestaande gebruiker, kunt u een van de onderstaande procedures volgen om de gebruiker bij te werken.


 
Zorg ervoor dat u al een van de bovenstaande procedures hebt voltooid om Webex-gesprekken uit te schakelen van de onboardsjabloon waaraan de gebruiker is toegewezen. Anders configureert een van de onderstaande procedures de gebruiker opnieuw met Webex-gesprekken ingeschakeld.

Als u flow-through provisioning gebruikt, kunt u het volgende doen:

  1. Open CommPilot en ga naar de gebruikersconfiguratie.

  2. Verwijder de geïntegreerde IM+P-service van de gebruiker en klik op OK.

  3. Voeg de geïntegreerde IM+P-service toe aan de gebruiker en klik op OK.

Anders kunt u de API gebruiken om de gebruiker bij te werken.

  1. Gebruik de Een BroadWorks-abonnee-API verwijderen om de gebruiker te verwijderen.

  2. Gebruik de Een BroadWorks-abonnee-API inrichten om de gebruiker toe te voegen.

Video of scherm delen uitschakelen in gesprekken

Partnerbeheerders kunnen configuratietags gebruiken om videogesprekken en/of scherm delen uit te schakelen in een gesprek vanuit de Webex-app (beide mediatypen zijn standaard ingeschakeld voor gesprekken).

Zie Videogesprekken uitschakelen en Scherm delen uitschakelen in de configuratiehandleiding van Webex voor Cisco BroadWorks voor meer informatie over de configuratie en opties.


 
Voor video kunt u ook configureren of media voor inkomende gesprekken standaard alleen video of audio zijn.

Busy Lamp Field (BLF)/melding voor gesprek opnemen

Busy Lamp Field (BLF)/melding voor gesprek opnemen maakt gebruik van de functies BLF en doorverbonden gesprek opnemen. Een BLF-gebruiker ontvangt een auditieve en visuele melding in de Webex-app wanneer een gebruiker uit de BLF-bewaakte lijst een binnenkomend gesprek ontvangt. De BLF-gebruiker kan het gesprek van de gecontroleerde gebruiker negeren of opnemen.

De BLF-/Call Pickup-melding helpt in situaties waarin een gebruiker gesprekken moet beantwoorden voor andere teamleden die op een andere locatie werken.

Gebruikers kunnen hun door BLF gecontroleerde lijst ook zien in het gedeelte Multi-gespreksvenster - Wachtlijst - (alleen Windows, Mac niet ondersteund) om de aanwezigheid van hun Webex- en niet-Webex-teamleden te zien. Webex-leden hebben een volledige Webex-aanwezigheid. Niet-Webex-leden moeten worden gesynchroniseerd met een telefoonlijst in Webex. Ze hebben alleen de status 'onbekend' en 'in-a-call' (de belstatus activeert het dialoogvenster voor gesprek opnemen).

Beperkingen van aanwezigheid voor niet-Webex-gebruikers:

  1. Aanwezigheid wordt niet ondersteund voor niet-CI Broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.

  2. CI-gebruikers zonder Webex-cloudrechten of computertype accounts (werkplekken) geven alleen aanwezigheid 'in gesprek' en 'onbekend' weer. Er is geen status actief, overgaan, enz.

  3. Niet-Webex-gebruikers uit de BLF-volglijst, die een gesprek hebben gestart voordat de Webex-client werd gestart of terwijl deze offline was, worden weergegeven met een 'onbekende' aanwezigheid.

  4. Als u uw verbinding verliest, worden alle niet-Webex-gespreksstatussen bij het opnieuw verbinden teruggezet op 'onbekend'.

  5. Als een niet-Webex-gebruiker van de BLF een gesprek heeft, wordt dit gesprek nog steeds weergegeven als 'in een gesprek'.

Vereisten

Zorg ervoor dat de volgende patches worden toegepast op BroadWorks. Installeer alleen de patches die van toepassing zijn op uw versie:

Voor R22:

  • AP.platform.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382362

  • AP.xsp.22.0.1123.ap382053

  • AP.xsp.22.0.1123.ap382362

  • AP.as.22.0.1123.ap383459

  • AP.as.22.0.1123.ap383520

Voor R23:

  • AP.platform.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382362

  • AP.as.23.0.1075.ap383459

  • AP.as.23.0.1075.ap383520

  • Als u XSP|ADP gebruikt:

    • AP.xsp.23.0.1075.ap382053

    • AP.xsp.23.0.1075.ap382362

  • Als u ADP gebruikt:

    • Xsi-Actions-23_2022.01_1.200.bwar

    • Xsi-Events-23_2022.01_1.201.bwar (of hoger)

Voor R24:

  • AP.as.24.0.944.ap382053

  • AP.as.24.0.944.ap382362

  • AP.as.24.0.944.ap383459

  • AP.as.24.0.944. ap383520

  • Xsi-Actions-24_2022.01_1.200.bwar

  • Xsi-Events-24_2022.01_1.201.bwar (of hoger)

Zorg ervoor dat de volgende configuratietags zijn ingeschakeld in de Webex-app:

  • <busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">

  • <display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>

  • <notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>(deze tag is optioneel)

U moet functie 101642 Verbeterd Xsi-mechanisme Voor Teamtelefonie activeren op de AS:

AS_CLI/System/ActivatableFeature> activate 101642

Inschakelen X-BroadWorks-Remote-Party-Info op de AS met de onderstaande CLI-opdracht omdat voor sommige SIP-gespreksstromen deze functie nodig is:

AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Zorg ervoor dat de volgende services zijn toegewezen aan gebruikers:

  • De service Doorverbonden gesprek aannemen toewijzen voor alle gebruikers

  • Busy Lamp Field instellen voor gebruikers


 
Elke verwijzing naar XSP omvat XSP of ADP.

Busy Lamp Field configureren op BroadWorks

Partnerbeheerders kunnen de volgende procedure gebruiken om Busy Lamp Field in te stellen voor een gebruiker.

  1. Meld u aan bij BroadWorks CommPilot.

  2. Ga voor een geselecteerde gebruiker naar Clienttoepassingen en configureer het Busy Lamp Field.

  3. Voeg de URL van de BLF-lijst toe die wordt gecontroleerd.

  4. Gebruik de zoekparameters om gebruikers te zoeken en toe te voegen aan de lijst Bewaakte gebruikers.

  5. Klik op OK.

Slido Integratieondersteuning

Webex voor Cisco BroadWorks ondersteunt integratie van de Webex-app met Slido.

Slido is een eenvoudig te gebruiken tool voor betrokkenheid van het publiek. Het helpt mensen om het meeste uit vergaderingen te halen door de kloof tussen sprekers en hun publiek te overbruggen. Wanneer Slido is geïntegreerd in uw Control Hub-organisatie, kunnen uw gebruikers de Slido app toevoegen aan hun vergaderingen in de Webex-app. Deze integratie biedt extra vraag en antwoord en enquêtefunctionaliteit voor de vergadering.

Zie SlidoIntegreren met Webex-appSlido voor meer informatie over het implementeren en gebruiken met de Webex-app.

Webex-beschikbaarheid: In een agendavergadering

Wanneer u een vergadering in uw Outlook-client hebt geaccepteerd die een afspraak, ad-hocvergadering of een niet-Webex-vergadering is, wordt uw Webex-beschikbaarheid weergegeven als 'In een agendavergadering'. Deze beschikbaarheid laat uw collega's weten dat u anders betrokken bent en dat een reactie kan worden vertraagd.

Deze functie inschakelen:

  1. ga naar het tabblad Algemeen van uw tabblad Instellingen in Windows of Voorkeuren op de Mac.

  2. Schakel het selectievakje Weergeven in een agendavergadering in.


 
Voor gebruikers met ingeschakelde Outlook-aanwezigheidsintegratie wordt 'In een agendavergadering' in Webex toegewezen aan 'Bezet' in Outlook.

Caveat

Om deze functie te laten werken, moet de Webex-app en de Outlook-client tegelijkertijd worden uitgevoerd.

We werken momenteel aan de ondersteuning van de optie 'Show as Working Elsewhere' in Outlook om een gebruiker niet weer te geven als 'In een agendavergadering' in Webex.

Als een gebruiker ervoor kiest om 'Weergeven wanneer in een agendavergadering' uit te schakelen terwijl hij of zij momenteel in een agendavergadering zit, wordt zijn of haar aanwezigheid pas bijgewerkt wanneer de vergadering is beëindigd. Hiervoor moet de client opnieuw worden gestart om op te halen.

Automatisch beantwoorden met toon

Met automatisch beantwoorden met toon kunnen gebruikers bellen vanuit een app van derden, zoals Contact Center, en wordt het gesprek automatisch gerouteerd via de Webex-app op hun bureaublad. Wanneer de Webex-app de andere partij belt, hoort de gebruiker een bepaalde toon met het advies dat het gesprek wordt verbonden.

Voor een Webex voor Cisco BroadWorks-gebruiker om deze functie te gebruiken:

  • De functie wordt alleen ondersteund op de weergave van de primaire lijn

  • De Webex-app moet de primaire lijnweergave zijn

  • De %ENABLE_AUTO_ANSWER_WXT%-tag moet zijn ingeschakeld

Als de gebruiker ook Gedeelde gespreksweergaven heeft (een bureautelefoon wordt bijvoorbeeld geconfigureerd als een van de weergaven van de secundaire lijn), wordt de functie nog steeds ondersteund op de primaire weergave zolang de weergaven van gedeelde gesprekken zijn geconfigureerd om geen inkomende gesprekken te ontvangen. Dit kan worden bereikt door een van de volgende drie voorwaarden te configureren in BroadWorks voor alle gedeelde gespreksweergaven:

  • Alle weergaven voor Click-to-Dial-gesprekken waarschuwen is uitgeschakeld in de configuratie voor weergave gedeeld gesprek. Dit is de aanbevolen aanpak

    of

  • Beëindiging toestaan op deze locatie moet zijn uitgeschakeld voor alle gedeelde gespreksweergaven of

    of

  • Locaties zijn uitgeschakeld voor alle weergaven van gedeelde gesprekken

Capaciteit verhogen

XSP|ADP-bedrijven

We raden u aan de capaciteitsplanner te gebruiken om te bepalen hoeveel extra XSP|ADP-resources u nodig hebt voor de voorgestelde toename van het aantal abonnees. Voor de speciale NPS of Webex voor Cisco BroadWorks-boerderijen hebt u de volgende schaalbaarheidsopties:

  • Schaalspecifieke boerderij: Voeg een of meer XSP|ADP-servers toe aan het bedrijf die extra capaciteit nodig hebben. Installeer en activeer dezelfde set toepassingen en configuraties als de bestaande knooppunten van de boerderij.

  • Specifieke boerderij toevoegen: Voeg een nieuwe, specifieke XSP|ADP-boerderij toe. U moet een nieuw cluster en nieuwe sjablonen maken in Partner Hub, zodat u nieuwe klanten kunt toevoegen op de nieuwe boerderij om de druk op de bestaande boerderij te verlichten.

  • Gespecialiseerde boerderij toevoegen: Als u knelpunten ondervindt voor een bepaalde service, wilt u mogelijk een afzonderlijke XSP|ADP-farm creëren voor dat doel, rekening houdend met de vereisten voor co-residency vermeld in dit document. Mogelijk moet u uw Control Hub-clusters en DNS-vermeldingen opnieuw configureren als u de URL wijzigt van de service met een nieuwe boerderij.

In alle gevallen is het uw verantwoordelijkheid om uw BroadWorks-omgeving te controleren en te bevoorraden. Als u Cisco-ondersteuning wilt inschakelen, kunt u contact opnemen met uw accountvertegenwoordiger, die professionele services kan regelen.

HTTP-servercertificaten beheren

U moet deze certificaten voor mTLS-geverifieerde webtoepassingen beheren op uw XSP|ADP's:

  • Ons certificaat voor de vertrouwensketen van de Webex-cloud

  • De certificaten van uw XSP|ADP HTTP-serverinterfaces

Vertrouwensketen

U downloadt het certificaat van de vertrouwensketen van Control Hub en installeert het op uw XSP|ADP's tijdens uw eerste configuratie. We verwachten dat u het certificaat bijwerkt voordat het verloopt en u informeert over hoe en wanneer u het kunt wijzigen.

Uw HTTP-serverinterfaces

De XSP|ADP moet een openbaar ondertekend servercertificaat presenteren aan Webex, zoals wordt beschreven in Certificaten bestellen. Er wordt een zelfondertekend certificaat gegenereerd voor de interface wanneer u de interface voor het eerst beveiligt. Dit certificaat is één jaar geldig vanaf die datum. U moet het zelfondertekende certificaat vervangen door een openbaar ondertekend certificaat. Het is uw verantwoordelijkheid om een nieuw certificaat aan te vragen voordat het verloopt.

Beperkt door partnermodus

Beperkt door de partnermodus is een Partner Hub-instelling die partnerbeheerders kunnen toewijzen aan specifieke klantorganisaties om de organisatie-instellingen te beperken die klantbeheerders kunnen bijwerken in Control Hub. Wanneer deze instelling is ingeschakeld voor een bepaalde klantorganisatie, hebben alle klantbeheerders van die organisatie, ongeacht hun rolrechten, geen toegang tot een set beperkte besturingselementen in Control Hub. Alleen een partnerbeheerder kan de beperkte instellingen bijwerken.


 
Beperkt door de partnermodus is een instelling op organisatieniveau in plaats van een rol. De instelling beperkt echter specifieke rolrechten voor klantbeheerders in de organisatie waarop de instelling wordt toegepast.

Toegang als klantbeheerder

Klantbeheerders ontvangen een melding wanneer de modus Beperkt door partner wordt toegepast. Nadat ze zich hebben aangemeld, zien ze een meldingsbanner boven aan het scherm, direct onder de Control Hub-koptekst. De banner informeert de klantbeheerder dat de beperkte modus is ingeschakeld en dat deze bepaalde gespreksinstellingen mogelijk niet kan bijwerken.

Voor een klantbeheerder in een organisatie waar de modus Beperkt door partner is ingeschakeld, wordt het toegangsniveau van Control Hub bepaald met de volgende formule:

(Toegang tot Control Hub) = (rechten van organisatierol) - (beperkt door beperkingen in de partnermodus)

Beperkingen

Wanneer de modus Beperkt door partner is ingeschakeld voor een klantorganisatie, hebben klantbeheerders in die organisatie geen toegang tot de volgende Control Hub-instellingen:

  • In de weergave Gebruikers zijn de volgende instellingen niet beschikbaar:

    • De knop Gebruikers beheren is grijs.

    • Gebruikers handmatig toevoegen of wijzigen: er is geen optie om gebruikers handmatig of via CSV toe te voegen of te wijzigen.

    • Gebruikers claimen: niet beschikbaar

    • Licenties automatisch toewijzen: niet beschikbaar

    • Adreslijstsynchronisatie -Kan instellingen voor directorysynchronisatie niet bewerken (deze instelling is alleen beschikbaar voor beheerders op partnerniveau).

    • Gebruikersgegevens: gebruikersinstellingen zoals voornaam, achternaam, weergavenaam en primair e-mailadres* kunnen worden bewerkt.

    • Pakket herstellen: er is geen optie om het pakkettype te herstellen.

    • Services bewerken: er is geen optie om de services te bewerken die zijn ingeschakeld voor een gebruiker (bijvoorbeeld Berichten, Vergaderingen, Bellen)

    • Status van services weergeven: kan de volledige status van hybride services of software-upgradekanaal niet zien

    • Primair werknummer: dit veld is alleen-lezen.

  • In de weergave Account zijn de volgende instellingen niet beschikbaar:

    • Bedrijfsnaam is alleen-lezen.

  • In de weergave Organisatie-instellingen zijn de volgende instellingen niet beschikbaar:

    • Domein: toegang is alleen-lezen.

    • E-mail: de instellingen voor E-mailuitnodiging beheerder onderdrukken en Landinstelling e-mailadres zijn alleen-lezen.

    • Verificatie: er is geen optie om de instellingen Verificatie en SSO te bewerken.

  • In het menu Bellen zijn de volgende instellingen niet beschikbaar:

    • Gespreksinstellingen: de instellingen voor gespreksprioriteit van de appopties zijn alleen-lezen.

    • Belgedrag: instellingen zijn alleen-lezen.

    • Locatie > PSTN: de opties Lokale gateway en Cisco PSTN zijn verborgen.

  • Onder SERVICES worden de serviceopties Migraties en Verbonden UC onderdrukt.

Beperkt door partnermodus inschakelen

Partnerbeheerders kunnen de onderstaande procedure gebruiken om: Beperkt door partnermodus voor een bepaalde klantorganisatie (de standaardinstelling is ingeschakeld).

  1. Meld u aan bij Partnerhub ( https://admin.webex.com) en selecteer Klanten.

  2. Selecteer de toepasselijke klantorganisatie.

  3. Schakel in de instellingenweergave aan de rechterkant de Beperkt door partnermodus toggle om de instelling in te schakelen.

    Als u de modus Beperkt door partner wilt uitschakelen, schakelt u de schakelaar uit.


 

Als de partner de beperkte beheermodus voor een klantbeheerder verwijdert, kan de klantbeheerder het volgende uitvoeren:

  • Webex voor groothandels toevoegen (met de knop)

  • Pakketten voor een gebruiker wijzigen

Partneranalyses

Dankzij verbeteringen in Control Hub kunnen partnerbeheerders eenvoudig pakketgegevens weergeven en bijwerken namens hun gebruikers. Deze functie biedt partners de mogelijkheid om een totaaloverzicht van alle klanten te krijgen en bevat de volgende details:

  • Totaal aantal gebruikers per pakket (Softphone, Basic, Standard, Premium)

  • Gebruiker per pakkettrend (dagelijks/wekelijks/maandelijks)

  • Klanten met het aantal toegewezen pakketten

Raadpleeg het Webex artikel voor volledige informatie over het gebruik van Partner Analytics Analyse voor Webex voor groothandel en Webex voor Broadworks-pakketten in Partner Hub .

API's voor factureringsrapport

Webex for Developers biedt openbare API's die kunnen worden gebruikt voor maandelijkse factureringsrapporten. Partnerbeheerders kunnen deze API's gebruiken om factureringsrapporten te maken, op te sommen, op te halen en te verwijderen. De volgende tabel bevat de API's, het type toegang dat vereist is en de rolvereisten.

API voor facturering

Doel

Type toegang

Rolvereiste voor API

(Beheerder vereist ten minste één van deze rollen)

Een BroadWorks-factureringsrapport maken

Wordt gebruikt om een factureringsrapport te genereren.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

BroadWorks-factureringsrapporten weergeven

Wordt gebruikt om de rapporten weer te geven die beschikbaar zijn om te bekijken.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks-factureringsrapport ophalen

Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks-factureringsrapport verwijderen

Wordt gebruikt om een gegenereerd rapport te verwijderen.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

Factureringsvelden

In de volgende tabel worden de velden weergegeven die in het gegenereerde rapport zijn opgenomen.

Veld

Beschrijving

resellerNaam

Partnernaam of organisatie-id van partner

billingId

Unieke facturerings-id of C-nummer van partner

spEnterprise-id

De door de serviceprovider geleverde unieke id voor de onderneming van de abonnee.

Intern

De status van de interne proefperiode van de klant (ja/nee)

userId

De gebruikers-id van de abonnee op BroadWorks

abonnee-id

Een unieke id voor de abonnee in kwestie in Webex

zelf geactiveerd

Ja/Nee

eersteStartdatum

Datum waarop de abonnee is ingericht.

factureringStartdatum

Datum waarop facturering begint in deze maand

Einddatum facturering

Datum waarop facturering deze maand eindigt

pakket

Het pakkettype dat in rekening wordt gebracht

hoeveelheid

Geprorateerde hoeveelheid voor facturatie.

  • 1: geeft een volledige maand aan


 
  • Nadat u een factureringsrapport voor een specifieke periode hebt gegenereerd, kunt u dat rapport niet opnieuw genereren, tenzij u eerst het bestaande rapport verwijdert.

  • Als u het pakkettype of de BroadWorks-gebruikers-id voor een bepaalde gebruiker wijzigt, worden in het rapport voor de maand waarin de wijziging heeft plaatsgevonden meerdere vermeldingen voor die gebruiker weergegeven met afzonderlijke geprorateerde vermeldingen voor en na de wijziging.

Problemen met Webex voor Cisco BroadWorks oplossen

Abonneren op de statuspagina van Webex

Controleer eerst https://status.webex.com wanneer u een onverwachte onderbreking van de service ervaart. Als u uw configuratie in Control Hub of BroadWorks niet hebt gewijzigd vóór de onderbreking, controleert u de statuspagina. Lees meer over het abonneren op status- en incidentmeldingen in het Webex-helpcentrum.

Analyse van Control Hub gebruiken

Webex houdt gebruiks- en kwaliteitsgegevens bij voor uw organisatie en de organisaties van uw klant. Lees meer over de Control Hub-analyse in het Webex-helpcentrum.

Netwerkproblemen

Klanten of gebruikers worden niet gemaakt in Control Hub met flowthrough-inrichting:

  • Kan de toepassingsserver de inrichtings-URL bereiken?

  • Zijn het inrichtingsaccount en het wachtwoord correct? Bestaat dat account in BroadWorks?

Clusters falen consequent in verbindingstests:


 

Er wordt verwacht dat de mTLS-verbinding met de verificatieservice mislukt wanneer u het eerste cluster in Partner Hub maakt, omdat u het cluster moet maken om toegang te krijgen tot de Webex-certificaatketen. Zonder dat kunt u geen vertrouwensanker maken voor de verificatieservice XSP|ADP's. De mTLS-verbinding testen vanuit Partner Hub is dus niet gelukt.

  • Zijn de XSP|ADP-interfaces openbaar toegankelijk?

  • Gebruikt u de juiste poorten? U kunt een poort invoeren in de interfacedefinitie op het cluster.

Validatie van interfaces mislukt

Xsi-acties en Xsi-events-interfaces:

  • Controleer of de interface-URL's juist zijn ingevoerd op het cluster in Partner Hub, inclusief de /v2.0/ aan het einde van de URL's.
  • Controleer of de firewall communicatie tussen Webex en deze interfaces mogelijk maakt.

  • Bekijk het advies voor interfaceconfiguratie in dit document.

Interface voor verificatieservice:

  • Controleer of de interface-URL's juist zijn ingevoerd op het cluster in Partner Hub, inclusief de /v2.0/ aan het einde van de URL's.
  • Controleer of de firewall communicatie tussen Webex en deze interfaces mogelijk maakt.

  • Bekijk het advies voor interfaceconfiguratie in dit document, met bijzondere aandacht voor:

    1. Zorg ervoor dat u RSA-sleutels hebt gedeeld met alle XSP|ADP's.
    2. Zorg ervoor dat u op alle XSP|ADP's de AuthService-URL voor de webcontainer hebt opgegeven.
    3. Als u de TLS-coderingsconfiguratie hebt bewerkt, controleert u of u de juiste naamgevingsconventie hebt gebruikt. Voor de XSP|ADP moet u de IANA-naamnotatie voor de TLS-cijfers invoeren. In een eerdere versie van dit document zijn de vereiste versleutelingssuites onjuist vermeld in de naamgevingsconventie van OpenSSL.
    4. Als u mTLS gebruikt met de verificatieservice, worden de Webex-clientcertificaten dan geladen in uw XSP|ADP/ADP-vertrouwensarchief? Is de app (of de interface) geconfigureerd om clientcertificaten te vereisen?

    5. Als u CI-tokenvalidatie gebruikt met de verificatieservice, is de app (of interface) dan geconfigureerd om geen clientcertificaten te vereisen?

Clientproblemen

Controleer of de client is verbonden met BroadWorks

  1. Meld u aan bij de Webex-app.

  2. Controleer of het pictogram Gespreksopties (een handset met een versnelling erboven) aanwezig is op de zijbalk.

    Als het pictogram niet aanwezig is, is de gebruiker mogelijk nog niet ingeschakeld voor de gespreksservice in Control Hub.

  3. Open het menu Instellingen/Voorkeuren en ga naar het gedeelte Telefoonservices. U ziet de status SSO-sessie Waarvoor U bent aangemeld.

    Als een andere telefoonservice, zoals Webex Calling, wordt weergegeven, gebruikt de gebruiker Webex niet voor Cisco BroadWorks.

Deze verificatie betekent:

  • De client heeft de vereiste Webex-microservices getransverseerd.

  • De gebruiker is geverifieerd.

  • De client heeft een langlevend JSON-webtoken ontvangen van uw BroadWorks-systeem.

  • De client heeft zijn apparaatprofiel opgehaald en geregistreerd bij BroadWorks.

Clientlogboeken

Alle clients van de Webex-app kunnen logboeken Verzenden naar Webex. Dit is de beste optie voor mobiele clients. U moet ook het e-mailadres van de gebruiker noteren en de geschatte tijd waarop het probleem is opgetreden als u hulp zoekt bij TAC. Zie Waar vind ik ondersteuning voor Webex voor meer informatie?

Als u handmatig logboeken moet verzamelen vanaf een Windows-pc, bevinden ze zich als volgt:

Windows-pc: C:\Users\{username}\AppData\Local\CiscoSpark

Mac:/Users/{username}/Library/Logs/SparkMacDesktop

Problemen met aanmelden gebruiker

mTLS-verificatie verkeerd geconfigureerd

Als alle gebruikers zijn getroffen, controleert u de mTLS-verbinding van Webex met uw verificatieservice-URL:

  • Controleer of de toepassing voor de verificatieservice of de interface die wordt gebruikt, is geconfigureerd voor mTLS.

  • Controleer of de Webex-certificaatketen is geïnstalleerd als vertrouwensanker.

  • Controleer of het servercertificaat op de interface/toepassing geldig is en ondertekend is door een bekende CA.

Bericht over licentieoverschrijding

Dit bericht kan voor een klant worden weergegeven in de klantweergave van Partnerhub. Dit bericht wordt weergegeven wanneer het licentiegebruik hoger is dan wat in de licentie is toegestaan. Het bericht kan worden genegeerd.

Handleiding voor probleemoplossing

Voor gedetailleerde informatie over het oplossen van problemen met Webex voor Cisco BroadWorks raadpleegt u de Handleiding voor het oplossen van problemen met Webex voor Cisco BroadWorks.

Ondersteuning

Ondersteuningsbeleid voor steady-state

De Dienstverlener is het eerste aanspreekpunt voor de eindklant (enterprise) support. Escaleer problemen die de SP niet kan oplossen naar TAC. Ondersteuning voor BroadWorks-serverversies volgt het BroadSoft-beleid van de huidige versie en twee eerdere grote versies (N-2). Lees meer op Beleid voor de levenscyclus van BroadSoft-producten sectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.

Escalatiebeleid

  • U (serviceprovider/partner) bent het eerste aanspreekpunt voor ondersteuning van eindklanten (enterprise).

  • Problemen die niet door de SP kunnen worden opgelost, worden geëscaleerd naar TAC.

BroadWorks-versies

Resources voor zelfondersteuning

  • Gebruikers kunnen ondersteuning vinden via het Webex-helpcentrum, waar er een Webex voor Cisco BroadWorks-specifieke pagina is met algemene help- en ondersteuningsonderwerpen voor de Webex-app.

  • De Webex-app kan worden aangepast met deze Help-URL en de URL van een probleemrapport.

  • Gebruikers van de Webex-app kunnen feedback of logboeken rechtstreeks vanaf de client verzenden. De logboeken gaan naar de Webex-cloud, waar ze kunnen worden geanalyseerd door Webex DevOps.

  • We hebben ook een Help Center-pagina die is toegewezen aan Help op beheerdersniveau voor Webex voor Cisco BroadWorks.

Informatie verzamelen om een serviceaanvraag in te dienen

Wanneer u fouten ziet in Control Hub, hebben ze mogelijk informatie bijgevoegd die TAC kan helpen uw probleem te onderzoeken. Als u bijvoorbeeld een traceer-id ziet voor een bepaalde fout of een foutcode, slaat u de tekst op om met ons te delen.

Probeer ten minste de volgende informatie op te nemen wanneer u een query indient of een case opent:

  • Organisatie-id van de klant en de organisatie-id van de partner (elke id is een tekenreeks van 32 hexadecimale tekens, gescheiden door koppeltekens)

  • TrackingID (ook een tekenreeks van 32 hexadecimale cijfers) als de interface of het foutbericht er een bevat

  • E-mailadres gebruiker (als een bepaalde gebruiker problemen ondervindt)

  • Clientversies (als het probleem symptomen heeft die door de client worden opgemerkt)

Webex voor BroadWorks-referentie

UC-One SaaS-vergelijking met Webex voor Cisco BroadWorks

Oplossing >

UC-One SaaS

Webex voor Cisco BroadWorks

Cloud

Cisco UC-One Cloud (GCP)

Webex-cloud (AWS)

Clients

UC-One: Mobiel, bureaublad

Receptionist, supervisor

Webex: Mobiel, Desktop, Web

Groot technologieverschil

Vergaderingen geleverd op Broadsoft Meet-technologie

Vergaderingen geleverd via Webex Meetings-technologie

Vroege veldproeven

Staging-omgeving, bètaclients

Productieomgeving, GA-klanten

Gebruikersidentiteit

BroadWorks-id diende als primaire id, tenzij de serviceprovider al SSO-integratie heeft.

 

Gebruikers-id en geheim in BroadWorks

E-mail-id in Cisco CI dient als primaire id

SSO-integratie in serviceprovider BroadWorks waarbij de gebruiker zich op dat moment verifieert met de BroadWorks-gebruikers-id en BroadWorks-geheim.

 

Gebruiker levert referenties via SSO met BroadWorks en geheim in BroadWorks

OF

Gebruikers-id en geheim in CI IdP

OF

Gebruikers-id in CI, ID en geheimen in IdP

Clientverificatie

Gebruikers leveren referenties via client

BroadWorks-tokens met een lange levensduur vereist bij gebruik van Webex-berichten

Gebruikers leveren referenties via de browser (aanmeldingspagina van Webex BIdP-proxy of CI)

Webex-toegangs- en vernieuwingstokens

Beheer / configuratie

Uw OSS/BSS-systemen en

Doorverkoopportaal

Uw OSS/BSS-systemen en Control Hub

Activering van partner/serviceprovider

Eenmalige installatie door Cisco Operations

Eenmalige installatie door Cisco Operations

Activering van klant/onderneming

Doorverkoopportaal

Control Hub

Automatisch gemaakt bij inschrijving eerste gebruiker

Activeringsopties voor de gebruiker

Zelfingeschreven

Externe IM&P instellen in BroadWorks

Geïntegreerde IM&P instellen in BroadWorks (doorgaans bedrijven)

XSP|ADP-serviceinterfaces

XSI-acties

 

XSI-gebeurtenissen

CTI (mTLS)

Verificatieservice (mTLS optioneel)

DMS

XSI-acties

XSI-acties (mTLS)

XSI-gebeurtenissen

CTI (mTLS)

Verificatieservice (TLS)

DMS

Webex installeren en aanmelden (Subscriber Perspective)

1

Download en installeer Webex. Zie Webex | De app downloaden voor meer informatie.

2

Webex uitvoeren.

Webex vraagt u naar uw e-mailadres.
3

Voer uw e-mailadres in en klik op Volgende.

4

Afhankelijk van de manier waarop uw organisatie in Webex is geconfigureerd, vindt een van de volgende handelingen plaats:

  1. Webex start een browser waarmee u de verificatie met uw identiteitsprovider kunt voltooien. Dit kan meervoudige verificatie (MFA) zijn.

  2. Webex start een browser waarin u uw BroadWorks-gebruikers-id en -wachtwoord kunt invoeren.

Webex wordt geladen nadat u bent geverifieerd met de IdP of BroadWorks.

Gegevensuitwisseling en -opslag

Deze secties bevatten details over gegevensuitwisseling en opslag met Webex. Alle gegevens worden zowel in transit als in rust versleuteld. Zie Beveiliging van de Webex-app voor meer informatie.

Onboarding serviceprovider

Wanneer u clusters en gebruikerssjablonen configureert in Webex Control Hub tijdens de onboarding van serviceproviders, wisselt u de volgende BroadWorks-gegevens uit die Webex opslaat:

  • URL Xsi-acties

  • URL van Xsi-Events

  • URL CTI-interface

  • URL verificatieservice

  • Referenties voor BroadWorks-inrichtingsadapter

Gebruikersvoorzieningen serviceprovider

Deze tabel bevat gebruikers- en bedrijfsgegevens die worden uitgewisseld als onderdeel van gebruikersvoorzieningen via de Webex-API's.

Gegevens verplaatsen naar Webex

Van

Door

Opgeslagen door Webex?

Gebruikers-id voor BroadWorks

BroadWorks, volgens API

Webex-API's

Ja

E-mail (indien SP verstrekt)

BroadWorks, volgens API

Webex-API's

Ja

E-mail (indien door gebruiker opgegeven)

Gebruiker

Portal voor gebruikersactivering

Ja

Voornaam

BroadWorks, volgens API

Webex-API's

Ja

Achternaam

BroadWorks, volgens API

Webex-API's

Ja

Primair telefoonnummer

BroadWorks, volgens API

Webex-API's

Ja

Mobiel telefoonnummer

BroadWorks, volgens API

Webex-API's

Ja

Primair toestel

BroadWorks, volgens API

Webex-API's

Ja

BroadWorks-serviceprovider-id en groeps-id

BroadWorks, volgens API

Webex-API's

Ja

Taal

BroadWorks, volgens API

Webex-API's

Ja

Tijdzone

BroadWorks, volgens API

Webex-API's

Ja

Gebruiker verwijderen

Webex voor Cisco BroadWorks API's ondersteunen zowel gedeeltelijke als volledige verwijdering van gebruikers. Deze tabel bevat alle gebruikersgegevens die zijn opgeslagen tijdens het inrichten en wat in elk scenario wordt verwijderd.

Gebruikersgegevens

Gedeeltelijke verwijdering

Volledige verwijdering

Gebruikers-id voor BroadWorks

Ja

Ja

E-mail

Nee

Ja

Voornaam

Nee

Ja

Achternaam

Nee

Ja

Primair telefoonnummer

Ja

Ja

Mobiel telefoonnummer

Ja

Ja

Extensie

Ja

Ja

BroadWorks-serviceprovider-id en groeps-id

Ja

Ja

Taal

Nee

Ja

Gebruikersaanmelding en configuratie ophalen

Webex-verificatie

Webex-verificatie verwijst naar aanmelding van gebruikers bij een Webex-app door een van de Webex-ondersteuningsmechanismen. ( BroadWorks-verificatie wordt afzonderlijk behandeld.) In deze tabel wordt het type gegevens weergegeven dat tussen de verschillende componenten van de verificatiestroom wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via de Webex-app

Webex

Beperkt toegangstoken en (onafhankelijke) IdP-URL

Webex

Gebruikersbrowser

Gebruikersgegevens

Gebruikersbrowser

Identiteitsprovider (die al gebruikersidentiteit heeft)

SAML-verklaring

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Tokens voor toegang en vernieuwing

Webex

Gebruikersbrowser

Tokens voor toegang en vernieuwing

Gebruikersbrowser

Webex-app

BroadWorks-verificatie

BroadWorks-verificatie verwijst naar aanmelding van gebruikers bij een Webex-app met hun BroadWorks-referenties. In deze tabel wordt het type gegevens weergegeven dat tussen de verschillende componenten van de verificatiestroom wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via de Webex-app

Webex

Token voor beperkte toegang en IdP-URL (Webex Bwks IdP-proxy)

Webex

Gebruikersbrowser

Brandinginformatie en BroadWorks-URL's

Webex

Gebruikersbrowser

BroadWorks-gebruikersreferenties

Gebruiker via browser (aanmeldingspagina met merknaam, bediend door Webex)

Webex

BroadWorks-gebruikersreferenties

Webex

BroadWorks

BroadWorks-gebruikersprofiel

BroadWorks

Webex

SAML-verklaring

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Tokens voor toegang en vernieuwing

Webex

Gebruikersbrowser

Tokens voor toegang en vernieuwing

Gebruikersbrowser

Webex-app

Melding van verlopen BroadWorks-wachtwoord tijdens aanmelden

Deze functie verbetert het aanmeldproces en bepaalt de aanmeldstroom op basis van:

Verbetering van aanmeldwaarschuwing en foutberichten:

  • Op dit moment krijgen de Wexbex voor BWKS-gebruikers die gebruikmaken van BroadWorks-verificatie en -aanmelding via de UAP geen melding dat hun wachtwoord bijna verloopt of dat ze zich niet kunnen aanmelden omdat het wachtwoord al is verlopen. Als het wachtwoord over 10 dagen of minder verloopt, ontvangt de gebruiker met deze functie een waarschuwing dat het wachtwoord bijna verloopt en wordt aangegeven hoeveel dagen er nog over zijn. De gebruiker wordt geadviseerd contact op te nemen met de partner of de koppeling Wachtwoord vergeten op het aanmeldscherm te volgen om het wachtwoord opnieuw in te stellen.
  • Als het wachtwoord is verlopen en de configuratie in BroadWorks 'enforcePasswordChangeOnExpiry' is ingesteld op waar, is de fout 'onjuiste gebruikersnaam en wachtwoord' gegooid, maar nu met deze functie is het foutbericht verbeterd: De aanmeldpoging is mislukt De combinatie van de gebruikersnaam en het wachtwoord komt niet overeen met onze gegevens of uw wachtwoord moet worden bijgewerkt. Probeer het opnieuw of neem contact op met uw beheerder om het wachtwoord bij te werken. Foutcode 100006

Aanmeldstroom beheren:

  • De partner kan de aanmelding beperken door een instelling 'w4bwks-password-expiry-fail-login' in te schakelen. Deze instelling 'kan door Cisco worden ingeschakeld op verzoek van een partner. Als BroadWorks-wachtwoord is verlopen, wordt de configuratie in BroadWorks 'enforcePasswordChangeOnExpiry' ingesteld op onwaar en wordt de instelling 'w4bwks-password-expiry-fail-login' ingeschakeld. Vervolgens wordt een fout geslingerd die zegt dat het wachtwoord x dagen geleden is verlopen, terwijl als de instellingsservice is uitgeschakeld, inloggen is toegestaan. De instelling is standaard uitgeschakeld.

De koppeling Wachtwoord vergeten op de aanmeldpagina kan door de partner worden geconfigureerd als onderdeel van de functie Geavanceerde aanpassing. Partners zouden de koppeling doorgaans configureren om de gebruiker naar een partnerportal te navigeren voor wachtwoordbeheer en het opnieuw instellen van het wachtwoord.


 

Deze functie verbetert alleen de aanmeldingservaring van de gebruiker tijdens het aanmelden van de geactiveerde gebruiker wanneer het wachtwoord op het punt staat te verlopen of al is verlopen. De functie wordt niet verwerkt als een wachtwoord verloopt terwijl de gebruiker is aangemeld bij de Webex-app. Bij de volgende aanmeldpoging krijgt de gebruiker een melding voor het verlopen van het wachtwoord.

Clientconfiguratie ophalen

Deze tabel toont het type gegevens dat tussen de verschillende componenten wordt uitgewisseld tijdens het ophalen van clientconfiguraties.

Gegevens verplaatsen

Van

Doel

Registratie

Klant

Webex

Organisatie-instellingen, inclusief BroadWorks-URL's

Webex

Klant

JWT-token voor BroadWorks

BroadWorks via Webex

Klant

JWT-token voor BroadWorks

Klant

BroadWorks

Apparaattoken

BroadWorks

Klant

Apparaattoken

Klant

BroadWorks

Configuratiebestand

BroadWorks

Klant

Gebruik bij steady-state

In dit gedeelte worden de gegevens beschreven die tussen componenten worden verplaatst tijdens herverificatie na het verlopen van een token, via BroadWorks of Webex.

In deze tabel wordt de gegevensbeweging voor bellen weergegeven.

Gegevens verplaatsen

Van

Doel

SIP-signalering

Klant

BroadWorks

SRTP-media

Klant

BroadWorks

SIP-signalering

BroadWorks

Klant

SRTP-media

BroadWorks

Klant

In deze tabel wordt de gegevensbeweging voor berichten, aanwezigheid en vergaderingen weergegeven.

Gegevens verplaatsen

Van

Doel

HTTPS REST-berichten en aanwezigheid

Klant

Webex

HTTPS REST-berichten en aanwezigheid

Webex

Klant

SIP-signalering

Klant

Webex

SRTP-media

Klant

Webex

SIP-signalering

Webex

Klant

SRTP-media

Webex

Klant

De inrichtings-API gebruiken

Toegang voor ontwikkelaars

De API-specificatie is beschikbaar op https://developer.webex.com en een handleiding voor het gebruik is te vinden op https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

U moet zich aanmelden om de API specificatie te lezen ophttps://developer.webex.com/docs/api/v1/broadworks-subscribers .

Toepassingsverificatie en autorisatie

Uw toepassing wordt geïntegreerd met Webex als een Integratie. Met dit mechanisme kan de toepassing beheertaken uitvoeren (zoals het inrichten van abonnees) voor een beheerder binnen uw partnerorganisatie.

Webex-API's volgen de OAuth 2-standaard ( http://oauth.net/2/). Met OAuth 2 kunnen integraties van derden vernieuwings- en toegangstokens verkrijgen namens de door u gekozen partnerbeheerder voor het verifiëren van API-gesprekken.

U moet eerst uw integratie met Webex registreren. Na registratie moet uw toepassing deze OAuth 2.0-autorisatietoekenningsflow ondersteunen om de benodigde vernieuwings- en toegangstokens te verkrijgen.

Zie https://developer.webex.com/docs/integrations voor meer informatie over integraties en hoe u deze OAuth 2-autorisatieflow in uw toepassing kunt opbouwen.


 

Er zijn twee rollen vereist voor het implementeren van integraties - de ontwikkelaar en de autorisatiegebruiker - en deze kunnen worden bekleed door afzonderlijke personen/teams in uw omgeving.

  • De ontwikkelaar maakt de app en registreert deze op https://developer.webex.com om de vereiste OAuth ClientID/Secret te genereren met scopes die worden verwacht voor de toepassing. Als uw toepassing wordt gemaakt door een derde partij, kan deze de toepassing registreren (als u om toegang hebt gevraagd) of kan u deze met uw eigen toegang doen.

  • De gebruiker autoriseren is het account dat de toepassing gebruikt om de API-oproepen te autoriseren, om uw partnerorganisatie, de organisaties van uw klanten of hun abonnees te wijzigen. Dit account moet de rol Volledige beheerder of Volledige verkoopbeheerder hebben in uw partnerorganisatie. Deze rekening mag niet door een derde worden aangehouden.

Naam organisatie

De organisatienaam is afhankelijk van de inrichtingsmodus die u gebruikt:

  • Enterprise-modus: de organisatienaam komt exact overeen met spEnterprise-id.

  • Serviceprovidermodus: de organisatienaam is het gedeelte groep-id van de spEnterprise-id.

De organisatienaam bevat alle spaties, hoofdletters en speciale tekens die zijn opgegeven in de oorspronkelijke spEnterprise-id.

Softwarevereisten voor BroadWorks

Zie Lifecycle Management - BroadSoft Servers.

We verwachten dat de serviceprovider "patch current" is met de nieuwste BroadWorks-patches en Release Independent (RI)-apps. De lijst met patches hieronder is de minimale vereiste voor integratie met Webex.


 
Controleer de patchnotities voor deze softwarepatches. Sommige patches hebben mogelijk aanvullende CLI-vereisten.

Versie R22

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.22.0.1123.ap364260

AP.as.22.0.1123.ap365173

AP.as.22.0.1123.ap368517

Vereist voor adreslijstsynchronisatie

AP.as.22.0.1123.ap369763

AP.as.22.0.1123.ap372989

AP.as.22.0.1123.ap372757

AP.as.22.0.1123.ap372963

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.22.0.1123.ap373197

Vereiste patch voor toepassingsserver

AP.as.22.0.1123.ap378391

AP.as.22.0.1123.ap374793

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.22.0.1123.ap377718

Vereiste patch voor de functie Gespreksopname

AP.as.22.0.1123.ap377868

AP.as.22.0.1123.ap376508

Vereiste patch voor doorstroominrichting

AP.xsp.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Profielserver

AP.ps.22.0.1123.ap372989

AP.ps.22.0.1123.ap372757

AP.ps.22.0.1123.ap378391

AP.ps.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Platform

AP.platform.22.0.1123.ap353577

AP.platform.22.0.1123.ap354313

Vereist voor NPS-verificatieproxy

AP.platform.22.0.1123.ap365173

AP.platform.22.0.1123.ap367732

AP.platform.22.0.1123.ap369433

AP.platform.22.0.1123.ap369607

Vereist voor NPS-verificatieproxy

AP.platform.22.0.1123.ap372757

AP.platform.22.0.1123.ap376508

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.platform.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

XSP|ADP

AP.xsp.22.0.1123.ap354313

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap365173

AP.xsp.22.0.1123.ap368067

AP.xsp.22.0.1123.ap368601

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.xsp.22.0.1123.ap369607

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap370952

AP.xsp.22.0.1123.ap373008

AP.xsp.22.0.1123.ap372757

AP.xsp.22.0.1123.ap372433

AP.xsp.22.0.1123.ap372963

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.xsp.22.0.1123.ap378391

AP.xsp.22.0.1123.ap374677

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap375206

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap376508

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.xsp.22.0.1123.ap378585

Vereist voor Unified Call History

Overig

AP.xsa.22.0.1123.ap372757

AP.xs.22.0.1123.ap372757

AP.ums.22.0.1123.ap378391

AP.nfm.22.0.1123.ap378391

Versie R23

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.23.0.1075.ap368517

Vereist voor adreslijstsynchronisatie

AP.as.23.0.1075.ap369763

AP.as.23.0.1075.ap373197

App-server configureren

AP.as.23.0.1075.ap373271

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.23.0.1075.ap378391

AP.as.23.0.1075.ap376509

AP.as.23.0.1075.ap377718

Vereist voor gespreksopname

AP.as.23.0.1075.ap377868

AP.as.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Profielserver

AP.ps.23.0.1075.ap378391

Platform

AP.platform.23.0.1075.ap367732

AP.platform.23.0.1075.ap370952

AP.platform.23.0.1075.ap369607

Vereist voor NPS-verificatieproxy

AP.platform.23.0.1075.ap376509

AP.platform.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

XSP|ADP

AP.xsp.23.0.1075.ap368067

AP.xsp.23.0.1075.ap369607

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap370952

AP.xsp.23.0.1075.ap373008

AP.xsp.23.0.1075.ap373271

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.xsp.23.0.1075.ap378391

AP.xsp.23.0.1075.ap374677

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap375206

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap376509

AP.xsp.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Overig

Bij gebruik van ADP...

Xsi-Events-23_2021.05_1.251.bwar

Vereiste patch voor haakstatus (Presence) en Unified Call History

Versie R24

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.24.0.944.ap384177

Vereist voor Unified Messaging Server (UMS)

AP.as.24.0.944.ap375100

Vereist voor flowthrough-inrichting

AP.as.24.0.944.ap377718

Vereist voor gespreksopname

AP.as.24.0.944.ap377868

AP.as.24.0.944.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Overig

Xsi-Events-24_2021.05_1.251.bwar

Vereiste patch voor haakstatus (Presence) en Unified Call History

Inrichtings- en activeringsstromen voor gebruikers


 

Inrichting beschrijft het toevoegen van de gebruiker aan Webex. Activering omvat e-mailvalidatie en servicetoewijzing in Webex.

E-mailadressen van gebruikers moeten uniek zijn, omdat Webex het e-mailadres gebruikt om een gebruiker te identificeren. Als u vertrouwde e-mailadressen voor de gebruikers hebt, kunt u ervoor kiezen deze automatisch te activeren wanneer u ze automatisch inricht. Dit proces is 'automatische inrichting en automatische activering'.

Automatische gebruikersinrichting en automatische activering (vertrouwde e-mailstroom)

Voorwaarden

  • Uw inrichtingsadapter wijst naar Webex voor Cisco BroadWorks (waarvoor een uitgaande verbinding van AS naar Webex Provisioning Bridge is vereist).

  • U moet geldige bereikbare e-mailadressen van eindgebruikers hebben als alternatieve id's in BroadWorks.

  • Control Hub heeft een inrichtingsaccount in de configuratie van uw partnerorganisatie.

Stap

Beschrijving

1

U noteert en neemt bestellingen voor de service op bij uw klanten.

2

U verwerkt de klantorder en richt de klant in uw systemen in.

3

Het service-inrichtingssysteem activeert de inrichting van BroadWorks. Deze stap, in het kort, maakt de onderneming en de gebruikers. Vervolgens wijst het de benodigde services en nummers toe aan elke gebruiker. Een van die diensten is de externe IM&P.

4

Met deze inrichtingsstap wordt de automatische inrichting van de klantorganisatie en gebruikers in Webex geactiveerd. (De IM&P-servicetoewijzing zorgt ervoor dat de inrichtingsadapter de Webex-inrichtings-API belt).

5

Uw systemen moeten de Webex-provisioning-API gebruiken als u het pakket later voor de gebruiker moet aanpassen (om van de standaardinstelling te veranderen).

SSO-aanmeldstroom

SAML SSO-aanmeldstroom met directe BroadWorks-verificatie (delen van resources tussen verschillende bronnen)

Hier volgt de SAML SSO-aanmeldstroom voor de Webex-app bij gebruik van BroadWorks-verificatie en wanneer Resource delen met meerdere bronnen is ingeschakeld, zodat directe verificatie naar BroadWorks mogelijk is. De afbeelding toont client- en gebruikersevenementen aan de linkerkant met tekst op de pijlen die weergeeft wat de client voor autorisatie voorziet. Stap 1 en 5 zijn gebruikersevenementen. Aan de rechterkant van de afbeelding ziet u gebeurtenissen voor aanmeldservices, samen met wat er wordt teruggestuurd naar de client.

BroadWorks-registratie en servicedetectiestroom

Hieronder volgt de BroadWorks-servicedetectiestroom die onmiddellijk volgt uit de vorige Webex SAML SSO-aanmeldstroom. De client gebruikt het toegangstoken dat is verkregen bij de registratie bij Webex-apparaatbeheer om registratie aan te vragen bij de BroadWorks-implementatie.

Alternatieve aanmeldstromen

De bovenstaande afbeeldingen gaan ervan uit dat SAML SSO-aanmelding is geconfigureerd met BroadWorks-verificatie waarvoor directe BroadWorks-verificatie is ingeschakeld (Cross-Origin Resource Sharing). Hieronder vindt u enkele alternatieve SAML SSO-aanmeldstromen:

  • BroadWorks-verificatie zonder directe BroadWorks-verificatie (delen van resources tussen verschillende bronnen):

    • Het enige verschil is in stap 5 en 6 van de Webex-aanmeldstroom. In stap 5 worden de aanmeldingsgegevens gevalideerd door de IdP-proxy (in plaats van XSI) en wordt een SAML-verklaring teruggestuurd naar de client.

    • De stroom loopt door de resterende stappen in de twee diagrammen.

    • Het SSO-token wordt niet gebruikt in deze flow.

  • SAML SSO Webex-verificatie:

    • In stap 3 van de Webex-aanmeldstroom retourneert de service Common Identity de identiteitsprovider die wordt gebruikt door Webex-verificatie.

    • Op dit moment wordt een alternatieve SAML SSO-aanmeldstroom voor Webex gestart.

Gebruikersinteracties

Aanmelden

  1. De Webex-app lanceert een browser naar Cisco Common Identity (CI) zodat gebruikers hun e-mailadres kunnen invoeren.

  2. CI ontdekt dat de gekoppelde klantorganisatie de BroadWorks IDP-proxy (IDP) heeft geconfigureerd als hun SAML IDP. CI wordt omgeleid naar de IDP die de gebruiker een aanmeldpagina aanbiedt. (De serviceprovider kan deze aanmeldpagina aanmerken.)

  3. De gebruiker voert zijn of haar BroadWorks-referenties in.

  4. Broadworks verifieert de gebruiker via de IDP. Bij succes stuurt de IDP de browser terug naar CI met een SAML-succes om de verificatieflow te voltooien (niet weergegeven in diagram).

  5. Bij succesvolle verificatie verkrijgt de Webex-app toegangstokens van CI (niet weergegeven in diagram). De client gebruikt deze om een BroadWorks langlevende Jason Web Token (JWT) aan te vragen.

  6. De Webex-app ontdekt de gespreksconfiguratie van BroadWorks en andere services van Webex.

  7. De Webex-app wordt geregistreerd bij BroadWorks.

Aanmelden vanuit het perspectief van een gebruiker

Dit diagram is de typische aanmeldingsstroom, zoals gezien door de eindgebruiker of abonnee:

  1. U downloadt en installeert de Webex-app.

  2. Mogelijk hebt u de koppeling van uw serviceprovider ontvangen of kunt u de download vinden op de pagina Webex-downloads.

  3. U voert uw e-mailadres in op het aanmeldscherm van Webex. Klik op Volgende.

  4. U wordt meestal omgeleid naar een pagina met het merk Serviceprovider.

  5. Die pagina kan u verwelkomen via uw e-mailadres.

    Als er geen e-mailadres is of als het e-mailadres onjuist is, voert u in plaats daarvan uw BroadWorks-gebruikersnaam in.

  6. Voer uw BroadWorks-wachtwoord in.

  7. Als u zich hebt aangemeld, wordt Webex geopend.

Gespreksstroom: bedrijfstelefoonlijst

Gespreksstroom: PSTN-nummer

Presentatie en delen

Een ruimtevergadering starten

Interacties met de klant

Profiel ophalen uit DMS en SIP-register met AS

  1. De client belt XSI om een apparaatbeheertoken en de URL naar het DMS op te halen.

  2. De klant vraagt zijn apparaatprofiel aan bij DMS door het token van stap 1 voor te leggen.

  3. De client leest het apparaatprofiel en haalt de SIP-referenties, adressen en poorten op.

  4. Client verzendt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.

  5. SBC stuurt het SIP REGISTER naar het AS (SBC kan een zoekopdracht uitvoeren in de NS om een AS te vinden als SBC de SIP-gebruiker nog niet kent.)

Test- en laboratoriumrichtlijnen

De volgende richtlijnen zijn van toepassing op test- en laboratoriumorganisaties:

  • Serviceproviderpartners zijn beperkt tot maximaal 50 testgebruikers die in meerdere organisaties kunnen worden ingericht.

  • Gebruikers buiten de eerste 50 testgebruikers worden gefactureerd.

  • Om een nauwkeurige verwerking op uw factuur te garanderen, moeten alle testorganisaties 'test' opnemen in de naam van de BroadWorks-organisatie.

  • Interne testorganisaties moeten worden aangewezen in Webex Control Hub. Dit is om te voorkomen dat testgebruikers worden gefactureerd als werkelijke gebruikers.

Een organisatie aanwijzen als een testorganisatie

Een organisatie aanwijzen als testorganisatie:

  1. Meld u aan bij Partner Hub en selecteer Klanten.

  2. Selecteer de juiste klant.

  3. Schakel in de rechterbedieningsbalk de schakelaar Interne testorganisatie in.

Voicemail afspelen

Zorg ervoor dat u voor voicemail de Mediaserver configureert om een van de volgende codes te gebruiken:

  • mp3

  • wav: WAV-bestanden worden ondersteund in de volgende indelingen: PCM (ondersteund op alle platforms) en DVI-ADPCM (niet ondersteund op Android

Als u wav-bestanden gebruikt, voert u de volgende CLI-opdrachten uit om de toepassingsserver en de mediaserver te configureren:

  • AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV

  • MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw

Terminologie

ACL (ACL)
Lijst met toegangscontrole
ALG
Gateway toepassingslaag
API
Toepassingsprogrammeerinterface
APNS
Apple Push-notificatieservice
AS
Toepassingsserver
ATA, VORMEN, VORMEN
Analoge telefoonoplader, adapter die analoge telefonie converteert naar VoIP
BAM
Toepassingsbeheer van BroadSoft
Basisverificatie
Een verificatiemethode waarbij een account (gebruikersnaam) wordt gevalideerd met een gedeeld geheim (wachtwoord)
BMS, (VER)LEIDEN
BroadSoft-berichtenserver
BOSJE
Bidirectionele stromen via synchrone HTTP
BRAADSTUK
Basic Rate Interface BRI is een ISDN-toegangsmethode
Bundel
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (cfr. Pakket)
CA
Certificeringsinstantie
Provider
Een organisatie die telefonieverkeer afhandelt (cfr. Partner, serviceprovider, Value Added Reseller)
CAPTCHA
Volledig geautomatiseerde Public Turing-test om computers en mensen uit elkaar te houden
CCXML
Taal voor eXtensible Markup voor gespreksbeheer
CIF
Algemeen Tussenformaat
CLI, VASTBINDEN
Opdrachtregelinterface
CN
Algemene naam
CNPS, CNPS
Pushserver voor gespreksmeldingen. Een pushserver voor meldingen die wordt uitgevoerd op een XSP|ADP in uw omgeving, om gespreksmeldingen naar FCM en APNS te pushen. Zie NPS-proxy.
CPE
Gebouwapparatuur van de klant
CPR, AFLEIDEN
Aangepaste aanwezigheidsregel
CSS, CVS
Cascade-stijlblad
CSV
Door komma's gescheiden waarde
CTI
Integratie van computertelefonie
CUBE
Cisco Unified Border Element
DMZ
Gedemilitariseerde zone
DN
Telefoonlijstnummer
Niet storen
Niet storen
DNS
Domeinnaamsysteem
DPG
Bel peergroep
DSCP
Punt Gedifferentieerde Servicecode
DTAF
Archiefbestand van apparaattype
DTG
Bestemmings-trunk-groep
DTMF
Dubbele toon met meerdere frequenties
Eindgebruiker
De persoon die de services gebruikt, die gesprekken voert, deelneemt aan vergaderingen of berichten verzendt (cf. Abonnee)
Organisatie
Een verzameling van eindgebruikers (cfr. Organisatie)
FCM
Firebase-cloudberichten
SCHAAMTE
Convergentie van vaste mobiele apparaten
Doorstroominrichting
Gebruikers maken in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' toe te wijzen in BroadWorks.
FQDN
Volledig gekwalificeerde domeinnaam (FQDN)
Volledige doorstroominrichting
Gebruikers maken en verifiëren in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' toe te wijzen in BroadWorks en te bevestigen dat elke BroadWorks-gebruiker een uniek en geldig e-mailadres heeft.
FXO, FXO
Foreign Exchange Office is de poort die de analoge lijn ontvangt. Dit is de stekker op de telefoon of faxmachine of de stekkers op uw analoge telefoonsysteem. Het levert een on-hook/off-hook indicatie (lussluiting). Aangezien de FXO-poort is gekoppeld aan een apparaat, zoals een fax of een telefoon, wordt het apparaat vaak het 'FXO-apparaat' genoemd.
FXS, FXS
Foreign Exchange Subscriber is de poort die daadwerkelijk de analoge lijn aan de abonnee levert. Met andere woorden, het is de "plug in the wall" die een kiestoon, accustroom en belspanning levert.
GCM
Google Cloud-bericht
GCM
Galois/Counter-modus (coderingstechnologie)
VERSTOPT
Apparaat voor menselijke interface
HTTPS
Beveiligde contactdozen met hypertekstdoorschakelprotocol
IAD
Apparaat voor geïntegreerde toegang
IM&P
Instant Messaging en Aanwezigheid
IP-PSTN
Een serviceprovider die VoIP-naar-PSTN-services levert, uitwisselbaar met ITSP, of een algemene term voor 'openbare' telefonie met internetverbinding, gezamenlijk geleverd door grote telecomproviders (in plaats van door landen, zoals PSTN is)
ITSP, ITSP
Internettelefonieserviceprovider
IVR, IVR
Interactieve spraakrespons / Responder
JID
Het systeemeigen adres van een XMPP-entiteit wordt een Jabber-id of JID localpart@domain.part.example.com/resourcepart (@ . / zijn separatoren)
JSON
Java-scriptobjectnotatie
JOOD
Java Secure Socket Extension; de onderliggende technologie die veilige verbindingsfuncties biedt voor BroadWorks-servers
KEM
Toetsuitbreidingsmodule (hardware Cisco-telefoons)
LLT
Long-lived (of Long Life) Token; een zelfbeschrijvende, veilige vorm van toondertoken waarmee gebruikers langer geverifieerd kunnen blijven en niet gekoppeld zijn aan specifieke toepassingen.
MA, MA, MAMA
Berichtarchivering
MIB, MIB
Basis managementinformatie
MEVROUW
Mediaserver
mTLS
Wederzijdse verificatie tussen twee partijen met behulp van certificaatuitwisseling bij het tot stand brengen van een TLS-verbinding
MUG, MUG, MUG
Chat met meerdere gebruikers
NAT, NAT
Vertalingen van netwerkadressen
NPS
Pushserver voor meldingen; zie CNPS
NPS-proxy

Een service in Webex die korte autorisatietokens levert aan uw CNPS, zodat deze de gespreksmeldingen naar FCM en APN's en uiteindelijk naar Android- en iOS-apparaten met Webex kan pushen.

OCI, OCI
Clientinterface openen
Organisatie
Een bedrijf of organisatie die een verzameling eindgebruikers vertegenwoordigt (cfr. Onderneming)
OTG
Uitgaande trunkgroep
Pakket
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (cfr. bundel)
Partner
Een agentorganisatie die samenwerkt met Cisco om producten en services te distribueren naar andere organisaties (cf. Value Added Reseller, serviceprovider, provider)
PBX
Ruilen privé-filiaal
PEM
E-mail met verbeterde privacy
PLONS
Openbaar mobiel landnetwerk
PRI, SNOEIWERK
Primary Rate Interface (PRI) is een standaard voor telecommunicatie-interface die wordt gebruikt op een digitaal netwerk voor geïntegreerde diensten (ISDN)
PS
Profielserver
PSTN
Openbaar geschakeld telefoonnetwerk
QoS
Servicekwaliteit
Doorverkoopportaal
Een website waarop de beheerder van de reseller zijn UC-One SaaS-oplossing kan configureren. Het wordt soms BAM-portal, beheerportal of beheerportal genoemd.
RTCP
Real-time beheerprotocol
RTP
Protocol voor realtime vervoer
SBC, ZWAARD
Sessie Border Controller
SCÈNE, SCÈNE
Weergave van gedeelde oproep
SD (SD)
Standaarddefinitie
SDP
Protocol voor sessiebeschrijving
SP
Serviceprovider; Een organisatie die telefonie of gerelateerde diensten levert aan andere organisaties (cf. Vervoerder, Partner, Value Added Reseller)
SIP
Protocol voor het starten van een sessie
SLET
Short-lived (of Short Life) Token (ook wel BroadWorks SSO Token genoemd); een authenticated token voor eenmalig gebruik dat wordt gebruikt om veilige toegang tot webtoepassingen te krijgen.
SMB
Kleine tot middelgrote ondernemingen
SNMP
Eenvoudig netwerkbeheerprotocol
sRTCP
secure Realtime Transfer Control Protocol (VoIP-gespreksmedia)
sRTP
beveiligd Realtime-doorverbindprotocol (VoIP-gespreksmedia)
SSL
Laag met veilige contactdozen
Abonnee
De persoon die de services gebruikt, die gesprekken voert, deelneemt aan vergaderingen of berichten verzendt (cf. Eindgebruiker)
TCP
Transmissieregelprotocol
TDM
Tijdverdeling multiplexen
TLS
Transportlagenbeveiliging
ToS
Soort service
UAP, UAP
Portal voor gebruikersactivering
UC
Unified Communications
GEBRUIKERSINTERFACE
Gebruikersinterface
U Id
Unieke id
AFMETINGEN
Berichtenserver
URI
Uniforme resource-id
URL
Uniforme bronzoeker
USS
Server voor delen
UTC
Gecoördineerde wereldtijd
UVS
Videoserver
Value Added Reseller (VAR)
Een agentorganisatie die samenwerkt met Cisco om producten en services te distribueren naar andere organisaties (cf. Vervoerder, Partner, Serviceprovider)
VGA
Grafische matrix voor video
VoIP
Voice over Internet Protocol (IP)
VXML
Taal voor uitbreidbare spraak
WebDAV
Webgedistribueerde creatie en versioning
WebRTC
Realtime webcommunicatie
WRS
WebRTC-server
XMPP
Extensible Messaging and Presence Protocol
Bijlage

Services configureren (met mTLS voor de verificatieservice)

De onderstaande procedures vervangen de procedures in het onderwerp Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's. Voltooi deze procedures alleen als u mTLS gebruikt voor de verificatieservice in plaats van CI-tokenvalidatie. Deze procedures zijn verplicht als u meerdere Webex-organisaties op dezelfde XSP|ADP-server uitvoert. Anders zijn ze optioneel.


 
Als u niet meerdere Webex-organisaties op dezelfde XSP|ADP-server uitvoert, wordt CI Token Validation (met TLS) aanbevolen voor de verificatieservice. Raadpleeg Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's voor meer informatie over het configureren van de verificatieservice en andere services.

Xsi-interfaces

Installeer en configureer de Xsi-Actions- en Xsi-Events-toepassingen zoals beschreven in de Configuratiehandleiding voor Cisco BroadWorks Xtended Services Interface.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Voor alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moet dezelfde callControlApplicationName zijn gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker is geïntegreerd in Webex, maakt Webex een abonnement voor de gebruiker op de AS om telefoniegebeurtenissen te ontvangen voor aanwezigheid en gespreksgeschiedenis. Het abonnement is gekoppeld aan de callControlApplicationName en de AS gebruikt het om te weten naar welke Xsi-Events de telefonie-gebeurtenissen moeten worden verzonden.


 

Het wijzigen van de callControlApplicationName of het niet hebben van dezelfde naam op alle Xsi-Events-webapps zal invloed hebben op abonnementen en telefonie gebeurtenissen functionaliteit.

Verificatieservice configureren (met mTLS)

BroadWorks-tokens met een lange levensduur worden gegenereerd en gevalideerd door de verificatieservice die wordt gehost op uw XSP|ADP's.

Vereisten

  • Op de XSP|ADP-servers die de verificatieservice hosten, moet een mTLS-interface zijn geconfigureerd.

  • XSP|ADP's moeten dezelfde sleutels delen voor het coderen/decoderen van BroadWorks-tokens met een lange levensduur. Het kopiëren van deze sleutels naar elke XSP|ADP is een handmatig proces.

  • XSP|ADP's moeten worden gesynchroniseerd met NTP.

Configuratieoverzicht

De essentiële configuratie op uw XSP|ADP's omvat:

  • Implementeer de verificatieservice.

  • Configureer de tokenduur tot ten minste 60 dagen (laat de uitgever staan als BroadWorks).

  • RSA-sleutels genereren en delen met XSP|ADP's.

  • Geef de authService-URL op aan de webcontainer.

De verificatieservice implementeren op XSP|ADP

Op elke XSP|ADP die met Webex wordt gebruikt:

  1. Activeer de toepassing voor de verificatieservice op het pad /authService(je moet dit pad gebruiken):

    XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService

    (waarbij <version> is uw BroadWorks-versie).

  2. Implementeer de toepassing:

    XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authService

Duur token configureren

  1. Controleer de bestaande tokenconfiguratie (uren):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> get

  2. Stel de duur in op 60 dagen (max. 180 dagen):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> set tokenDurationInHours 1440

RSA-sleutels genereren en delen

  • U moet dezelfde openbare/privésleutelparen gebruiken voor tokencodering/decodering in alle instanties van de verificatieservice.

  • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet uitgeven.

Vanwege deze twee factoren moet u sleutels genereren op één XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's.


 

Als u met de toetsen gaat fietsen of de lengte van de toetsen wijzigt, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw starten.

  1. Selecteer één XSP|ADP om een sleutelpaar te genereren.

  2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen in de browser van de client:

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

    (Dit genereert een privaat/openbaar sleutelpaar op de XSP|ADP, als dat er nog niet was)

  3. De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:

    XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

  4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere .keys bestand indien nodig.

  5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

Geef de authService-URL aan de webcontainer

De webcontainer van de XSP|ADP heeft de authService-URL nodig zodat deze tokens kan valideren.

Op elk van de XSP|ADP's:

  1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het communicatiehulpprogramma BroadWorks:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

  2. Voeg de URL van de verificatieservice toe aan de container:

    XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

    Hiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.

  3. Controleer de parameter met get.

  4. Start de XSP|ADP opnieuw op.

TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)

De toepassingen Verificatieservice, Xsi-acties en Xsi-Events maken gebruik van HTTP-serverinterfaces. De TLS-configureerbaarheidsniveaus voor deze toepassingen zijn als volgt:

Meest algemeen = Systeem > Transport > HTTP > HTTP Server interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit CLI-context
Systeem (globaal)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze veilig zijn en of ze clientverificatie vereisen.

Apache tomcat vereist een certificaat voor elke veilige interface; het systeem genereert een zelfondertekend certificaat als dit nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2-protocol toevoegen aan de HTTP-serverinterface

De HTTP-interface die communiceert met de Webex-cloud moet zijn geconfigureerd voor TLSv1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren in de interface van de HTTP-server:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken in de HTTP-serverinterface

De vereiste cijfers configureren:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de interface van de HTTP-server.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 in de interface van de HTTP-server gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Trust configureren voor verificatieservice (met mTLS)

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om CombinedCertChain2023.txt op uw lokale computer.


     
    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze uploadt naar de XSP|ADP's. Alle bestanden zijn vereist.
  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt.

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE----- en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één tekstblok bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt.

  5. Meld u aan bij de XSP|ADP en ga naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoeren UpdateTrust om de parameters en opdrachtindeling weer te geven.

  6. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023

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

     

    Alle aliassen moeten een andere naam hebben. webexclientroot, webexclientroot2023, webexclientissuing en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang de vier ingangen uniek zijn.

  7. Bevestig dat de ankers zijn bijgewerkt:

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get

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

(Optie) mTLS configureren op het niveau van de HTTP-interface/poort

Het is mogelijk om mTLS te configureren op het niveau van de HTTP-interface/poort of per webtoepassing.

De manier waarop u mTLS inschakelt voor uw toepassing, hangt af van de toepassingen die u host op de XSP|ADP. Als u meerdere toepassingen host waarvoor mTLS nodig is, moet u mTLS inschakelen op de interface. Als u slechts één van de verschillende toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op HTTP-interface/poortniveau is mTLS vereist voor alle gehoste webtoepassingen die via deze interface/poort worden geopend.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/HttpServer> en voer de get opdracht om de raakvlakken te zien.

  3. Als u een interface wilt toevoegen en daar clientverificatie wilt vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true

    Zie de XSP|ADP CLI-documentatie voor meer informatie. In wezen de eerste true beveiligt de interface met TLS (servercertificaat wordt gemaakt indien nodig) en de tweede true dwingt de interface om clientcertificaatverificatie te vereisen (samen zijn het mTLS).

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/HttpServer> get

Interface Port Name Secure Client Auth Req Cluster Fqdn
         =======================================================
         192.0.2.7 443 XSP|ADP01.collab.example.net true false 
         192.0.2.7 444 XSP|ADP01.collab.example.net true true

In dit voorbeeld is mTLS (Client Auth Req = true) ingeschakeld op 192.0.2.7 poort 444. TLS is ingeschakeld op 192.0.2.7 poort 443.

(Optie) mTLS configureren voor specifieke webtoepassingen

Het is mogelijk om mTLS te configureren op het niveau van de HTTP-interface/poort of per webtoepassing.

De manier waarop u mTLS inschakelt voor uw toepassing, hangt af van de toepassingen die u host op de XSP|ADP. Als u meerdere toepassingen host waarvoor mTLS nodig is, moet u mTLS inschakelen op de interface. Als u slechts één van de verschillende toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op toepassingsniveau is mTLS vereist voor die toepassing, ongeacht de HTTP-serverinterfaceconfiguratie.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> en voer de get om te zien welke toepassingen worden uitgevoerd.

  3. Een toepassing toevoegen en hiervoor clientverificatie vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true

    Zie de XSP|ADP CLI-documentatie voor meer informatie. Daar worden de toepassingsnamen opgesomd. Het true in dit commando wordt mTLS ingeschakeld.

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add 192.0.2.7 443 AuthenticationService true

De voorbeeldopdracht voegt de AuthenticationService-toepassing toe aan 192.0.2.7:443 en vereist dat de toepassing certificaten van de client aanvraagt en verifieert.

Vraag na bij get:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> get

Interface Ip Port Application Name Client Auth Req
         ===================================================
         192.0.2.7 443 AuthenticationService      true          

Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver

Profielserver en XSP|ADP zijn verplicht voor apparaatbeheer. Ze moeten worden geconfigureerd volgens de instructies in de configuratiehandleiding voor BroadWorks-apparaatbeheer.

Hoe gaat u verder?

Voor configuratie kunt u opnieuw deelnemen aan de hoofddocumentstroom via CTI-interface en gerelateerde configuratie.

Aanvullende certificaatvereisten voor wederzijdse TLS-verificatie tegen AuthService

Webex communiceert met de verificatieservice via een wederzijdse TLS-geverifieerde verbinding. Dit betekent dat Webex een clientcertificaat presenteert en dat de XSP|ADP moet valideren. Als u dit certificaat wilt vertrouwen, gebruikt u de Webex CA-certificaatketen om een vertrouwensanker op XSP|ADP (of proxy) te maken. De certificaatketen kan worden gedownload via Partner Hub:

  1. Ga naar Instellingen > BroadWorks Calling.

  2. Klik op de koppeling voor het downloadcertificaat.


 

U kunt de certificaatketen ook ophalen van https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.

De exacte vereisten voor het implementeren van deze Webex CA-certificaatketen zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt samengevat waar de Webex CA-certificaatketen in deze drie gevallen moet worden geïmplementeerd.

Vereisten voor wederzijds TLS-certificaat voor TLS-bridge Proxy

  • Webex presenteert een door Webex CA ondertekend clientcertificaat aan de proxy.

  • De Webex CA-certificaatketen wordt geïmplementeerd in het proxyvertrouwensarchief, zodat de proxy het clientcertificaat vertrouwt.

  • Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de proxy geladen.

  • De proxy presenteert een openbaar ondertekend servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • De volmachthebber legt een intern ondertekend clientcertificaat voor aan de XSP|ADP’s.

    Dit certificaat moet het uitbreidingsveld Extended Key Usage van x509.v3 bevatten met het BroadWorks-OID-doel 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS-clientAuth. Bijv.:

    X509v3 extensions:

    X509v3 Extended Key Usage:

    1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client
                  Authentication 

     

    Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP’s presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

Vereisten voor wederzijds TLS-certificaat voor TLS-passthrough Proxy of XSP in DMZ

  • Webex presenteert een door Webex CA ondertekend clientcertificaat aan de XSP's.

  • De Webex CA-certificaatketen wordt geïmplementeerd in het vertrouwensarchief van de XSP's, zodat de XSP's het clientcertificaat vertrouwen.

  • Het openbaar ondertekende XSP-servercertificaat wordt ook in de XSP's geladen.

  • De XSP's presenteren openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP's heeft ondertekend.

Revisiegeschiedenis van document

De volgende tabel toont een geschiedenis van wijzigingen aan dit document in de afgelopen 12 maanden.

Datum

Versie

Beschrijving van de wijziging

22 maart 2024

2-112

  • Vereisten bijgewerkt in het gedeelte Niet storen synchroniseren (NST).

07 maart 2024

2-111

  • Het gedeelte Aanmeldstroom beheren is bijgewerkt in Gebruikersaanmelding en Configuratie ophalen.

24 februari 2024

2-110

  • Redactionele wijzigingen.

20 februari 2024

2-109

  • Het gedeelte Indicatie visuele spam toegevoegd onder Webex voor BroadWorks implementeren.

07 februari 2024

2-108

  • Een functie BroadWorks-melding voor het verlopen van een wachtwoord toegevoegd tijdens het aanmelden onder Webex for BroadWorks-referentie.

25 januari 2024

2-107

  • Redactionele wijzigingen.

23 januari 2024

2-106

  • Redactionele wijzigingen aangebracht in het gedeelte Gebruiker verplaatsen (met toestemming) naar Webex voor Cisco BroadWorks onder Webex beheren voor BroadWorks.

10 januari 2024

2-105

  • Redactionele wijzigingen.

20 december 2023

2-104

13 december 2023

2-103

  • Klantsjabloon is gewijzigd in 'Onboarding-sjabloon'. De oplossingshandleiding is bijgewerkt.

12 december 2023

2-102

  • Webex voor BroadWorks toevoegen aan het gedeelte Bestaande organisatie onder Webex voor BroadWorks beheren is bijgewerkt.

08 december 2023

2-101

  • Redactionele wijzigingen.

08 november 2023

2-100

  • Een opmerking toegevoegd in het gedeelte Webex voor BroadWorks toevoegen aan bestaande organisatie.

25 oktober 2023

2-99

  • R24 toegevoegd in het gedeelte Toepassingsserver configureren met inrichtingsservice-URL.

13 september 2023

2-98

  • Netwerkvereisten voor Webex voor Cisco Broadworks-koppelingen toegevoegd onder Aanbevolen documentabonnementen.

04 september 2023

2-97

  • Gedeelte Functies en beperkingen bijgewerkt onder Overzicht van Webex voor Cisco BroadWorks.

08 augustus 2023

2-96

  • Aantekeningen toegevoegd in Een BroadWorks-cluster bewerken of verwijderen in Partnerhub onder Webex beheren voor BroadWorks.

23 juni 2023

2-95

  • Het gedeelte Uw NPS voorbereiden op Webex voor Cisco BroadWorks is bijgewerkt onder Webex implementeren voor Cisco BroadWorks.

  • Het configureren van NPS voor het gebruik van Authentication Proxy connectionTimeout naar 3000 is bijgewerkt onder Webex voor Cisco BroadWorks implementeren.

30 mei 2023

2-94

  • Bijgewerkte sectie BroadWorks-softwarevereisten onder Webex voor Cisco BroadWorks-referentie.

26 mei 2023

2-93

  • Gedeelte Vertrouwensankers voor CTI-interface (R22 en hoger) bijgewerkt onder Webex implementeren voor Cisco BroadWorks.

  • Het gedeelte Vertrouwen configureren voor verificatieservice (met mTLS) is bijgewerkt onder Bijlage.

24 mei 2023

2-92

  • Het gedeelte Webex voor BroadWorks loskoppelen van bestaande organisatie is bijgewerkt onder Webex voor Cisco BroadWorks beheren.

  • Gedeelte Inbreken toegevoegd onder Webex voor Cisco BroadWorks implementeren.

10 mei 2023

2-91

  • Het gedeelte Busy Lamp Field/Call Pickup Notification is bijgewerkt onder Webex beheren voor Cisco BroadWorks.

09 mei 2023

2-90

  • Bijgewerkte sectie Land onder Uw omgeving voorbereiden.

04 mei 2023

2-89

  • Het gedeelte Uw klantsjablonen configureren is bijgewerkt onder Uw partnerorganisatie configureren in Partner Hub.

27 april 2023

2-88

  • Sectie Land toegevoegd onder Uw omgeving voorbereiden.

14 april 2023

2-87

  • Het gedeelte Ondersteuning voor groepscontactpersonen is bijgewerkt onder Bestellen en inrichten.

17 maart 2023

2-86

  • Het gedeelte Mobiel systeemeigen gesprek escaleren naar vergadering is toegevoegd onder Webex voor BroadWorks implementeren.

11 maart 2023

2-85

  • Bijgewerkte stappen in Verificatieservice configureren (met CI-tokenvalidatie) onder Webex voor Cisco BroadWorks implementeren.

10 maart 2023

2-84

  • Bijgewerkte sectie Xsi-interfaces.

07 maart 2023

2-83

  • Het gedeelte Ondersteuning voor groepscontactpersonen is toegevoegd onder Bestellen en inrichten.

28 februari 2023

2-82

  • Gedeelte Partner-SSO - OpenID Connect (OIDC) toegevoegd onder Webex voor Cisco BroadWorks implementeren.

15 februari 2023

2-81

  • Sectie Vertrouwensankers voor CTI-interface (R22 en hoger) bijgewerkt onder Webex implementeren voor Cisco BroadWorks en Vertrouwensservice configureren voor verificatieservice (met mTLS) onder Bijlage.

10 februari 2023

2-80

  • Toestelnummer bijgewerkt onder Overzicht van Webex voor Cisco BroadWorks.

Overzicht van Webex voor Cisco BroadWorks

Introductie van Webex voor Cisco BroadWorks

Revisiegeschiedenis van document

Dit gedeelte behandelt systeembeheerders bij Cisco-partnerorganisaties (serviceproviders) die Webex implementeren voor hun klantorganisaties of deze oplossing rechtstreeks aanbieden aan hun eigen abonnees.

Doel van de oplossing

  • Webex-cloudsamenwerkingsfuncties aanbieden aan kleine en middelgrote klanten die al gespreksservice hebben die wordt geleverd door BroadWorks-serviceproviders.

  • BroadWorks-gebaseerde gespreksservice aanbieden aan kleine en middelgrote Webex-klanten.

Context

We evolueren al onze samenwerkingsklanten naar een uniforme toepassing. Dit pad vermindert aannameproblemen, verbetert de interoperabiliteit en migratie en biedt voorspelbare gebruikerservaringen in ons hele samenwerkingsportfolio. Een deel van deze inspanning is het verplaatsen van de BroadWorks-gespreksmogelijkheden naar de Webex-app en uiteindelijk het verminderen van investeringen in de UC-One-clients.

Voordelen

  • Toekomstbestendigheid: tegen beëindiging van UC-One Collaborate, beweging van alle clients naar het Unified Client Framework (UCF)

  • Het beste van beide: Webex-functies voor berichten en vergaderingen inschakelen met behoud van BroadWorks-gesprekken op uw telefonienetwerk

Toepassingsgebied van de oplossing

  • Bestaande/nieuwe kleine tot middelgrote klanten (minder dan 250 abonnees) die een reeks samenwerkingsfuncties willen, hebben mogelijk al BroadWorks-gesprekken.

  • Bestaande kleine tot middelgrote Webex-klanten die BroadWorks Calling willen toevoegen.

  • Niet voor grotere ondernemingen (raadpleeg ons Enterprise-portfolio voor Webex).

  • Niet voor één gebruiker (evalueer Webex Online-aanbiedingen).

De functiesets in Webex voor Cisco BroadWorks zijn gericht op gebruiksscenario's voor kleine tot middelgrote bedrijven. De Webex voor Cisco BroadWorks-pakketten zijn ontworpen om de complexiteit voor kleine en middelgrote ondernemingen te verminderen en we evalueren voortdurend hun geschiktheid voor dit segment. We kunnen ervoor kiezen functies die anders beschikbaar zijn in de bedrijfspakketten te verbergen of te verwijderen.

Vereisten voor succes met Webex voor Cisco BroadWorks

#

Vereiste

Notities

1

Patchstroom BroadWorks R22 of hoger

2

XSP|ADP voor XSI, CTI, DMS en authService

Specifieke XSP|ADP voor Webex voor Cisco BroadWorks

3

Afzonderlijke XSP|ADP voor NPS kunnen worden gedeeld met andere oplossingen die NPS gebruiken.

Als u een bestaande implementatie voor samenwerken hebt, controleert u aanbevelingen voor XSP|ADP- en NPS-configuraties.

4

CI-tokenvalidatie (met TLS) geconfigureerd voor Webex-verbindingen met de verificatieservice.

5

mTLS is geconfigureerd voor Webex-verbindingen met de CTI-interface.

Voor andere toepassingen is geen mTLS vereist.

6

Gebruikers moeten bestaan in BroadWorks en hebben de volgende kenmerken nodig, afhankelijk van uw inrichtingsbeslissing:

  • Doorloop met vertrouwde e-mails: Het e-mailkenmerk van de BroadWorks-gebruiker moet een geldig e-mailadres bevatten dat uniek is voor die gebruiker. De gebruiker moet ook een primair nummer of toestel hebben.

  • Doorloop met niet-vertrouwde e-mails, zelfactivering of API-inrichting: Gebruiker heeft geen e-mailadres nodig, maar moet een primair nummer of toestel hebben.

Voor vertrouwde e-mails: We raden u aan hetzelfde e-mailadres ook in het kenmerk Alternatieve id in te voeren, zodat gebruikers zich met e-mailadres kunnen aanmelden bij BroadWorks.

Voor niet-vertrouwde e-mails: Afhankelijk van de e-mailinstellingen van de gebruiker kan het gebruik van niet-vertrouwde e-mails ertoe leiden dat de e-mail wordt verzonden naar de ongewenste of spammap van de gebruiker. De beheerder moet mogelijk de e-mailinstellingen van de gebruiker wijzigen om domeinen toe te staan

7

Webex voor Cisco BroadWorks DTAF-bestand voor de Webex-app

8

BW Business Lic of Std Enterprise of Prem Enterprise User Lic + Webex voor Cisco BroadWorks-abonnement

Als u een bestaande implementatie voor samenwerken hebt, hebt u geen UC-One Add-On Bundle, Collab Lic en Meet-me Conference Ports meer nodig.

Als u een bestaande UC-One SaaS-implementatie hebt, zijn er geen andere wijzigingen dan het accepteren van de voorwaarden van het Premium-pakket.

9

IP/poorten moeten toegankelijk zijn via de Webex-backend-services en de Webex-apps via openbaar internet.

Zie het gedeelte “Uw netwerk voorbereiden”.

10

TLS v1.2-configuratie op XSP|ADP's

11

Voor Flowthrough-inrichting moet de toepassingsserver verbinding maken met de BroadWorks-inrichtingsadapter.


 

We testen of ondersteunen geen uitgaande proxyconfiguratie. Als u een uitgaande proxy gebruikt, accepteert u de verantwoordelijkheid om deze te ondersteunen met Webex voor Cisco BroadWorks.

Zie het onderwerp “Uw netwerk voorbereiden”.

Over dit document

Het doel van dit document is u te helpen uw Webex for Cisco BroadWorks-oplossing te begrijpen, voor te bereiden, te implementeren en te beheren. De grote delen in het document weerspiegelen dit doel.

Deze gids bevat conceptueel en referentiemateriaal. We zijn van plan alle aspecten van de oplossing in dit ene document te behandelen.

De minimale set taken om de oplossing te implementeren zijn:

  1. Bereik uw accountteam om een Cisco-partner te worden. Het is noodzakelijk dat u de Cisco-aanrakingspunten onderzoekt om uzelf vertrouwd te maken (en getraind te worden). Wanneer u een Cisco-partner wordt, passen we de Webex voor Cisco BroadWorks-schakelaar toe op uw Webex-partnerorganisatie. (Zie Webex implementeren voor Cisco BroadWorks > Onboarding voor partners in dit document.)

  2. Configureer uw BroadWorks-systemen voor integratie met Webex. (Zie Webex implementeren voor Cisco BroadWorks > Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's in dit document.)

  3. Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)

  4. Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)

  5. Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)


 
  • Dit zijn stappen van hoog niveau, in de typische volgorde. Er zijn verschillende bijdragende taken die u niet kunt negeren.

  • Als u uw eigen toepassingen wilt maken om uw Webex voor Cisco BroadWorks-abonnees te beheren, leest u De inrichtings-API gebruiken in het gedeelte Referentie van deze handleiding.

Terminologie

We proberen het jargon en de letterwoorden in dit document te beperken en elke term uit te leggen wanneer deze voor het eerst wordt gebruikt. (Zie Webex voor Cisco BroadWorks-referentie > Terminologie als een term niet in de context wordt uitgelegd.)

Hoe het werkt

Webex voor Cisco BroadWorks is een aanbieding die BroadWorks-gesprekken integreert in Webex. Abonnees gebruiken één toepassing (de Webex-app) om gebruik te maken van functies die door beide platforms worden aangeboden:

  • Gebruikers bellen PSTN-nummers via uw BroadWorks-infrastructuur.

  • Gebruikers bellen met andere BroadWorks-nummers via uw BroadWorks-infrastructuur (audio-/videogesprekken door de nummers te selecteren die zijn gekoppeld aan de gebruikers of het toetsenblok om de nummers te introduceren).

  • Gebruikers kunnen ook een Webex VoIP-gesprek plaatsen via de Webex-infrastructuur door de optie 'Webex Call' te selecteren in de Webex-app. (Deze gesprekken zijn de Webex-app naar de Webex-app, niet de Webex-app naar PSTN).

  • Gebruikers kunnen Webex Meetings hosten en eraan deelnemen.

  • Gebruikers kunnen elkaar een voor een berichten sturen of in ruimten (permanente groepchat) en profiteren van functies als zoeken en bestanden delen (op Webex-infrastructuur).

  • Gebruikers kunnen aanwezigheid (status) delen. Ze kunnen aangepaste aanwezigheid of door de klant berekende aanwezigheid kiezen.

  • Nadat we u als partnerorganisatie hebben geïntegreerd in Control Hub, met de juiste rechten, kunt u de relatie tussen uw BroadWorks-exemplaar en Webex configureren.

  • U maakt klantorganisaties in Control Hub en richt gebruikers in deze organisaties in.

  • Elke abonnee in BroadWorks krijgt een Webex-identiteit op basis van zijn/haar e-mailadres (kenmerk e-mail-id in BroadWorks).

  • Gebruikers worden geverifieerd voor BroadWorks of voor Webex.

  • Clients krijgen langdurige tokens om ze te autoriseren voor services bij BroadWorks en Webex.

De Webex-app in het midden van deze oplossing; het is een brandbare toepassing die beschikbaar is op Mac/Windows-bureaubladen en Android/iOS-telefoons en -tablets.

Er is ook een webversie van de Webex-app die momenteel geen gespreksfuncties bevat.

De client maakt verbinding met de Webex-cloud om functies voor berichten, aanwezigheid en vergaderingen te leveren.

De client registreert zich bij uw BroadWorks-systemen voor gespreksfuncties.

De Webex-cloud werkt met uw BroadWorks-systemen om een naadloze gebruikersinrichting te garanderen.

Functies en beperkingen

Wij bieden verschillende pakketten met verschillende functies.

Softphone-pakket

Dit pakkettype gebruikt de Webex-app als een softphone only-client met belmogelijkheden, maar geen berichtmogelijkheden. Gebruikers met dit pakkettype kunnen deelnemen aan Webex-vergaderingen, maar kunnen geen vergaderingen zelf starten. Wanneer andere gebruikers (softphone of niet-softphone) in de telefoonlijst zoeken naar een softphone-gebruiker, bieden de zoekresultaten geen optie om een bericht te verzenden.

Softphone-gebruikers kunnen hun scherm delen tijdens een gesprek.

Basispakket

Het basispakket bevat functies voor bellen, chatten en vergaderen. Het omvat 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room). (** zie onderstaande Note voor uitzondering). In dit pakket kunnen de vergaderingen een maximale duur van 40 minuten hebben.

Pakket "Standaard"

Dit pakket omvat ook alles in het basispakket, zoals maximaal 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room).

Scherm delen binnen een PMR-vergadering is een rol die in eerste instantie alleen wordt uitgeoefend door de host van de vergadering, maar de host kan de rol van presentator overdragen aan een door hem of haar gekozen deelnemer aan de vergadering. Alleen de host kan de rol van presentator opnieuw opnemen zonder dat de huidige host deze aan hem of haar heeft doorgegeven.

"Premium"-pakket

Dit pakket omvat alles in het standaardpakket plus maximaal 300 deelnemers aan een vergadering in een 'unified space' en maximaal 1000 deelnemers in een persoonlijke vergaderruimte (PMR).

Scherm delen binnen een PMR-vergadering wordt ondersteund voor elke deelnemer aan de vergadering.

Pakketten vergelijken

Pakket

Oproepen

Berichten

Unified Space-vergaderingen

PMR Meetings

Softphone

Opgenomen

Niet inbegrepen

Geen

Geen

Eenvoudig

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Standaard

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Premium

Opgenomen

Opgenomen

300 deelnemers

1000 deelnemers


 
De limiet voor Unified Space-vergaderingen voor basisgebruikers is 100 deelnemers per Unified Space-vergadering, tenzij de ruimte ook gebruikers bevat waaraan de pakketten 'Standaard' of 'Premium' zijn toegewezen. In dat geval wordt de limiet verhoogd op basis van het gebruikerspakket van de host.

 

'Unified Space Meetings' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in een Webex-ruimte. Een gebruiker start bijvoorbeeld een vergadering vanuit de ruimte via de knoppen 'Vergaderen' of 'Plannen'.

'PMR-vergaderingen' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in de persoonlijke vergaderruimte (PMR) van een gebruiker. Deze vergaderingen gebruiken een speciale URL (bijvoorbeeld: cisco.webex.com/meet/roomOwnerUserID).

Berichten en vergaderingsfuncties

Raadpleeg de volgende tabel voor verschillen in ondersteuning van PMR-vergaderingsfuncties voor Basic-, Standard- en Premium-pakketten.

Tabel 1. Verschillen in functieondersteuning voor PMR-vergaderingen

Vergaderingsfunctie

Ondersteund met basispakket

Overgezet met standaardpakket

Ondersteund met Preminum-pakket

Opmerking

Vergaderduur

40 minuten of minder

Onbeperkt

Onbeperkt

Bureaublad delen

Ja

Ja

Ja

Basis: bureaublad delen door een PMR-vergaderingdeelnemer.

Standaard : bureaublad delen alleen door de host van de PMR-vergadering.

Premium: bureaublad delen door een deelnemer aan een PMR-vergadering.

Toepassingen delen

Ja

Ja

Ja

Basis: toepassingen delen door elke deelnemer aan een PMR-vergadering.

Standaard : toepassingen delen alleen door de host van de PMR-vergadering.

Premium: toepassingen delen door deelnemers aan een PMR-vergadering.

Chat met meerdere partijen

Ja

Ja

Ja

Whiteboarden

Ja

Ja

Ja

Wachtwoordbeveiliging

Ja

Ja

Ja

Web-app - geen downloaden of invoegtoepassingen (gastervaring)

Ja

Ja

Ja

Ondersteuning voor koppelen met Webex-apparaten

Ja

Ja

Ja

Vloerbeheer (Eén dempen / Alles verwijderen)

Ja

Ja

Ja

Koppeling voor blijvende vergaderingen

Ja

Ja

Ja

Toegang tot de Meetings-site

Ja

Ja

Ja

Deelnemen aan vergadering via VoIP

Ja

Ja

Ja

Vergrendeling

Ja

Ja

Ja

Bedieningselementen voor presentator

Nee

Nee

Ja

Extern bureaubladbeheer

Nee

Nee

Ja

Aantal deelnemers

100

100

1000

Opname lokaal opgeslagen in het systeem

Ja

Ja

Ja

Opnemen in de cloud

Nee

Nee

Ja

Opname - Cloudopslag

Nee

Nee

10 GB per locatie

Opnametranscripties

Nee

Nee

Ja

Vergaderingen plannen

Ja

Ja

Ja

Inhoud delen met externe integraties inschakelen

Nee

Nee

Ja

Basic— Inhoud delen door een deelnemer aan een PMR-vergadering.

Standaard: inhoud delen met alleen de host van de PMR-vergadering.

Premium: inhoud delen door een deelnemer aan een PMR-vergadering.

PMR-URL wijzigen toestaan

Nee

Nee

Ja

Basic— Gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL wijzigen vanuit Control Hub.

Standaard: de PMR-URL kan alleen worden gewijzigd vanuit Partner Hub door partner- en organisatiebeheerders.

Premium: gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL vanuit Partner Hub wijzigen.

Live streaming van vergaderingen (Bv. op Facebook, Youtube)

Nee

Nee

Ja

Andere gebruikers toestaan vergaderingen namens hen te plannen

Nee

Nee

Ja

Een alternatieve host toevoegen

Ja

Nee

Ja

App-integratie (bijv. Zendesk, Slack)

Afhankelijk van de integratie

Afhankelijk van de integratie

Ja

Zie het gedeelte App-integraties hieronder voor meer informatie over ondersteuning.

Integratie met Microsoft Office 365-agenda

Ja

Ja

Ja

Integratie met Google-agenda voor G Suite

Ja

Ja

Ja

Het Webex-helpcentrum publiceert de functies en documentatie voor gebruikers voor Webex op help.webex.com. Lees de volgende artikelen voor meer informatie over de functies:

Gespreksfuncties

De belervaring is vergelijkbaar met eerdere oplossingen die gebruikmaken van de BroadWorks-gespreksbeheermotor. Het verschil met UC-One Collaborate en UC-One SaaS is dat de Webex-app de primaire softclient is.

App-integraties

U kunt Webex voor Cisco BroadWorks integreren met de volgende toepassingen:

Ondersteuning voor Virtual Desktop Infrastructure (VDI)

Webex voor Cisco BroadWorks ondersteunt nu VDI-omgevingen (Virtual Desktop Infrastructure). Raadpleeg de Implementatiehandleiding voor Webex voor Virtual Desktop Infrastructure (VDI) voor meer informatie over de implementatie van VDI-infrastructuur.

IPv6-ondersteuning

Webex voor Cisco BroadWorks ondersteunt IPv6-adressering voor de Webex-app.

Toekomstige routekaart

Ga naar https://salesconnect.cisco.com/#/program/PAGE-16649 voor meer informatie over onze voornemens voor de toekomstige versies van Webex voor Cisco BroadWorks. De items van het stappenplan zijn in geen enkele hoedanigheid bindend. Cisco behoudt zich het recht voor om een of al deze items uit toekomstige releases te onthouden of te herzien.

Beperkingen

Inrichtingsbeperkingen

Tijdzone van Meetings-site

De tijdzone van de eerste abonnee voor elk pakket wordt de tijdzone voor de Webex Meetings-site die voor dat pakket is gemaakt.

Als er geen tijdzone is opgegeven in het inrichtingsverzoek voor de eerste gebruiker van elk pakket, wordt de tijdzone van de Webex Meetings-site voor dat pakket ingesteld op de regionale standaard van de organisatie van de abonnees.

Als uw klant een specifieke tijdzone van de Webex Meetings-site nodig heeft, geeft u de timezone parameter in de inrichtingsaanvraag voor:

  • de eerste abonnee die is ingericht voor het standaardpakket in de organisatie.

  • de eerste abonnee die is ingericht voor Premium-pakket in de organisatie.

  • de eerste abonnee die is ingericht voor het basispakket in de organisatie.

Algemene beperkingen

  • Geen gesprekken in de webversie van de Webex-client (dit is een clientbeperking, geen oplossingsbeperking.)

  • Webex beschikt mogelijk nog niet over alle besturingselementen voor de gebruikersinterface om bepaalde functies voor gespreksbeheer te ondersteunen die beschikbaar zijn via BroadWorks.

  • De Webex-client kan momenteel geen 'wit label' hebben.

  • Wanneer u klantorganisaties maakt met de door u gekozen inrichtingsmethode, worden deze automatisch gemaakt in dezelfde regio als uw partnerorganisatie. Dit gedrag is zo bepaald. We verwachten van multinationale partners dat ze in elke regio een partnerorganisatie creëren waar ze klantorganisaties beheren.

  • Rapportage over het gebruik van vergaderingen en berichten is beschikbaar via de klantorganisatie in Control Hub.

Bekende problemen en beperkingen

Zie Bekende problemen en beperkingen voor een actuele lijst met bekende problemen en beperkingen met het Webex voor Cisco BroadWorks-aanbod.

Berichtenlimieten

De volgende opslaglimieten voor gegevens (berichten en bestanden gecombineerd) zijn van toepassing op organisaties die Webex voor Cisco BroadWorks-services hebben aangeschaft via een serviceprovider. Deze limieten vertegenwoordigen de maximale opslag voor berichten en bestanden gecombineerd.

  • Basis: 2 GB per gebruiker gedurende 3 jaar

  • Standaard 5 GB per gebruiker gedurende 3 jaar

  • Premie: 10 GB per gebruiker gedurende 5 jaar

Voor elke klantorganisatie worden deze totalen per gebruiker samengevoegd om een geaggregeerd totaal voor die klant op te geven, op basis van het aantal gebruikers. Een bedrijf met vijf premium-gebruikers heeft bijvoorbeeld een totale limiet voor berichten en bestandsopslag van 50 GB. Een individuele gebruiker kan de limiet per gebruiker (10 GB) overschrijden op voorwaarde dat het bedrijf nog onder het geaggregeerde maximum (50 GB) zit.

Voor teamruimten die worden gemaakt, gelden de berichtlimieten voor het geaggregeerde totaal voor de klantorganisatie die eigenaar is van de teamruimte. U vindt informatie over de eigenaar van individuele teamruimten in het ruimtebeleid. Zie https://help.webex.com/en-us/baztm6/Webex-Space-Policy voor meer informatie over het bekijken van het ruimtebeleid voor een individuele teamruimte.

Aanvullende informatie

Raadpleeg https://help.webex.com/en-us/n8vw82eb/Webex-Capacities voor meer informatie over algemene berichtbeperkingen die van toepassing zijn op Webex-ruimten van het berichtenteam.

Beveiliging, gegevens en rollen

Webex-beveiliging

De Webex-client is een veilige toepassing die veilige verbindingen maakt met Webex en BroadWorks. De gegevens die in de Webex-cloud zijn opgeslagen en via de Webex-app aan de gebruiker zijn blootgesteld, worden zowel onderweg als in rust gecodeerd.

Meer informatie over gegevensuitwisseling vindt u in het deel Referentie van dit document.

Bijkomende lectuur

Locatie organisatiegegevens

We slaan uw Webex-gegevens op in het datacenter dat het meest overeenkomt met uw regio. Zie Gegevensresidentie in Webex in het Helpcentrum.

Rollen

Beheerder serviceprovider (u): Voor dagelijkse onderhoudsactiviteiten beheert u de lokale (bel)onderdelen van de oplossing met behulp van uw eigen systemen. U beheert de Webex-onderdelen van de oplossing via Partner Hub.

Zie Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM voor informatie over de rollen die beschikbaar zijn voor partners, de toegangsrechten die bij deze rollen horen en hoe u rollen kunt toewijzen.


 
De eerste gebruiker die is ingericht voor een nieuw partnerorganizaiton, wordt automatisch toegewezen aan de rollen Volledige beheerder en Volledige partnerbeheerder. Die beheerder kan het bovenstaande artikel gebruiken om extra rollen toe te wijzen.

Cisco Cloud Operations-team: Maakt uw 'partnerorganisatie' in Partner Hub, als deze niet bestaat, tijdens uw onboarding.

Zodra u uw Partner Hub-account hebt, configureert u de Webex-interfaces met uw eigen systemen. Vervolgens maakt u 'Onboarding-sjablonen' om de suites of pakketten weer te geven die via deze systemen worden aangeboden. Vervolgens richt u uw klanten of abonnees in.

#

Typische taak

SP

Cisco

1

Onboarding voor partners - De partnerorganisatie maken als deze nog niet bestaat en de benodigde functieschakelaars inschakelen

2

BroadWorks-configuratie in partnerorganisatie via Partner Hub (cluster)

3

Integratie-instellingen configureren in de partnerorganisatie via Partner Hub (aanbiedingssjablonen, branding)

4

BroadWorks-omgeving voorbereiden voor integratie (AS, XSP|ADP Patching, firewalls, XSP|ADP-configuratie, XSI, AuthService, CTI, NPS, DMS-toepassingen op XSP|ADP)

5

Inrichtingsintegratie of -proces ontwikkelen

6

GTM-materialen voorbereiden

7

Nieuwe gebruikers migreren of inrichten

Architectuur

Wat staat er in het diagram?

Clients

  • De Webex-app-client dient als de primaire toepassing in Webex voor Cisco BroadWorks-aanbiedingen. De client is beschikbaar op desktop-, mobiele en webplatforms.

    De client heeft systeemeigen chat-, presence- en meerpartijenaudio-/videovergaderingen die door de Webex-cloud worden geleverd. De Webex-client gebruikt uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken.

  • Cisco IP-telefoons en gerelateerde accessoires gebruiken ook uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken. We verwachten telefoons van derden te kunnen ondersteunen.

  • Activeringsportal voor gebruikers om zich aan te melden bij Webex met hun BroadWorks-aanmeldgegevens.

  • Partner Hub is een webinterface voor het beheren van uw Webex-organisatie en de organisaties van uw klanten. In Partner Hub kunt u de integratie tussen uw BroadWorks-infrastructuur en Webex configureren. U gebruikt ook Partner Hub om de clientconfiguratie en facturering te beheren.

Netwerk van serviceproviders

Het groene blok links op het diagram staat voor uw netwerk. Componenten die in uw netwerk worden gehost, bieden de volgende services en interfaces aan andere delen van de oplossing:

  • Openbare XSP|ADP, voor Webex voor Cisco BroadWorks: (De box staat voor een of meerdere XSP|ADP-boerderijen, mogelijk aan de voorkant door lastbalancers.)

    • Host de Xtended Services-interface (XSI-acties en XSI-gebeurtenissen), de Device Management-service (DMS), CTI-interface en de verificatieservice. Samen stellen deze toepassingen telefoons en Webex-clients in staat om zichzelf te verifiëren, hun gespreksconfiguratiebestanden te downloaden, gesprekken te starten en te ontvangen en elkaars haakstatus (telefonische aanwezigheid) en gespreksgeschiedenis te bekijken.

    • Publiceert directory naar Webex-clients.

  • Openbare XSP|ADP, met NPS:

    • Pushserver voor hostmeldingen: Een pushserver voor meldingen op een XSP|ADP in uw omgeving. Het werkt samen tussen uw toepassingsserver en onze NPS-proxy. De proxy levert korte tokens aan uw NPS om meldingen naar de cloudservices te autoriseren. Deze services (APNS & FCM) verzenden gespreksmeldingen naar Webex-clients op Apple iOS- en Google Android-apparaten.

  • Toepassingsserver:

    • Biedt gespreksbeheer en interfaces met andere BroadWorks-systemen (doorgaans)

    • Voor flowthrough-inrichting wordt het AS gebruikt door de partnerbeheerder om gebruikers in te richten in Webex

    • Hiermee wordt het gebruikersprofiel naar BroadWorks gepusht

  • OSS/BSS: Uw Operations Support System / Business SIP-services voor het beheer van uw BroadWorks-ondernemingen.

Webex Cloud

Het blauwe blok in het diagram staat voor de Webex-cloud. Webex-microservices ondersteunen het volledige spectrum van Webex-samenwerkingsmogelijkheden:

  • Cisco Common Identity (CI) is de identiteitsservice binnen Webex.

  • Webex voor Cisco BroadWorks staat voor de set microservices die de integratie tussen Webex en de gehoste BroadWorks-serviceprovider ondersteunen:

    • API's voor gebruikersinrichting

    • Configuratie van serviceprovider

    • Gebruikersaanmelding met BroadWorks-aanmeldgegevens

  • Webex-berichtenbox voor berichtengerelateerde microservices.

  • Webex Meetings-venster voor mediaverwerkingsservers en SBC's voor videovergaderingen met meerdere deelnemers (SIP & SRTP)

Webservices van derden

De volgende onderdelen van derden zijn weergegeven in het diagram:

  • APNS (Apple Push Notifications Service) pusht oproep- en berichtmeldingen naar Webex-toepassingen op Apple-apparaten.

  • FCM (FireBase Cloud Messaging) pusht meldingen voor gesprekken en berichten naar Webex-toepassingen op Android-apparaten.

XSP|ADP-architectuuroverwegingen

De rol van openbare XSP|ADP-servers in Webex voor Cisco BroadWorks

De openbare XSP|ADP in uw omgeving biedt de volgende interfaces/services aan Webex en clients:

  • Verificatieservice (AuthService), beveiligd door TLS, die reageert op Webex-verzoeken voor BroadWorks JWT (JSON Web Token) namens de gebruiker

  • CTI-interface, beveiligd door mTLS, waarop Webex zich abonneert voor gebeurtenissen uit de gespreksgeschiedenis en aanwezigheidsstatus van telefonie vanuit BroadWorks (haakstatus).

  • Xsi-acties en -gebeurtenissen-interfaces (eXtended Services Interface) voor gespreksbeheer voor abonnees, telefoonlijsten voor contactpersonen en gesprekslijsten en configuratie van de telefoonservice voor eindgebruikers

  • DM-service (Device Management) voor clients om hun configuratiebestanden voor gesprekken op te halen

Geef URL's op voor deze interfaces wanneer u Webex voor Cisco BroadWorks configureert. (Zie Uw BroadWorks-clusters configureren in Partnerhub in dit document.) Voor elk cluster kunt u slechts één URL voor elke interface opgeven. Als u meerdere interfaces hebt in uw BroadWorks-infrastructuur, kunt u meerdere clusters maken.

XSP|ADP-architectuur

XSP|ADP-architectuur: Optie 1
XSP|ADP-architectuur: Optie 2

We vereisen dat u een afzonderlijk, toegewezen XSP|ADP-exemplaar of -farm gebruikt om uw NPS-toepassing (Notification Push Server) te hosten. U kunt dezelfde NPS gebruiken met UC-One SaaS of UC-One Collaborate. Het is echter mogelijk dat u de andere toepassingen die vereist zijn voor Webex voor Cisco BroadWorks niet host op dezelfde XSP|ADP die de NPS-toepassing host.

We raden u aan een speciaal XSP|ADP-exemplaar/farm te gebruiken om de vereiste toepassingen voor Webex-integratie te hosten om de volgende redenen:

  • Als u bijvoorbeeld UC-One SaaS aanbiedt, raden we u aan een nieuwe XSP|ADP-farm te maken voor Webex voor Cisco BroadWorks. Op deze manier kunnen de twee diensten onafhankelijk werken terwijl u abonnees migreert.

  • Als u de Webex voor Cisco BroadWorks-toepassingen op een XSP|ADP-boerderij zoekt die voor andere doeleinden wordt gebruikt, is het uw verantwoordelijkheid om het gebruik te controleren, de daaruit voortvloeiende complexiteit te beheren en de verhoogde schaal te plannen.

  • De Cisco BroadWorks-systeemcapaciteitsplanner gaat uit van een specifieke XSP|ADP-farm en is mogelijk niet juist als u deze gebruikt voor collocatieberekeningen.

Tenzij anders vermeld, moet de speciale Webex voor Cisco BroadWorks XSP|ADP's de volgende toepassingen hosten:

  • Verificatieservice (TLS met CI-tokenvalidatie of mTLS)

  • CTI (mTLS)

  • XSI-acties (TLS)

  • XSI-gebeurtenissen (TLS)

  • DMS (TLS): optioneel. Het is niet verplicht om een afzonderlijk DMS-exemplaar of -bedrijf specifiek voor Webex voor Cisco BroadWorks te implementeren. U kunt hetzelfde DMS-exemplaar gebruiken dat u gebruikt voor UC-One SaaS of UC-One Collaborate.

  • Webview Gespreksinstellingen (TLS): optioneel. Webview voor gespreksinstellingen (CSW) is alleen vereist als u wilt dat Webex voor Cisco BroadWorks-gebruikers gespreksfuncties kunnen configureren in de Webex-app.

Webex vereist toegang tot CTI via een interface die is beveiligd door wederzijdse TLS-verificatie. Om deze vereiste te ondersteunen, raden we een van de volgende opties aan:

  • (Diagram gelabeld met Optie 1) Eén XSP|ADP-exemplaar of -bedrijf voor alle toepassingen, met twee interfaces die op elke server zijn geconfigureerd: een mTLS-interface voor CTI en een TLS-interface voor andere apps zoals de AuthService.

  • (Diagram gelabeld met Optie 2) Twee XSP|ADP-instanties of -farms, een met een mTLS-interface voor CTI, en de andere met een TLS-interface voor andere apps, zoals de AuthService.


 

XSP|ADP-hergebruik

Als u een bestaande XSP|ADP-boerderij hebt die voldoet aan een van de bovenstaande voorgestelde architecturen (optie 1 of 2) en deze lichtjes wordt geladen, is het mogelijk om uw bestaande XSP|ADP's opnieuw te gebruiken. U moet controleren of er geen tegenstrijdige configuratievereisten zijn tussen bestaande toepassingen en de nieuwe toepassingsvereisten voor Webex. De twee belangrijkste overwegingen zijn:

  • Als u meerdere Webex-partnerorganisaties op de XSP|ADP moet ondersteunen, betekent dit dat u mTLS moet gebruiken op de verificatieservice (CI Token Validation wordt alleen ondersteund voor één partnerorganisatie op een XSP|ADP). Als u mTLS gebruikt op de verificatieservice, betekent dit dat u niet tegelijkertijd clients kunt hebben die basisverificatie gebruiken op de verificatieservice. Deze situatie zou hergebruik van de XSP|ADP voorkomen.

  • Als de bestaande CTI-service is geconfigureerd voor gebruik door clients met de veilige poort (doorgaans 8012) maar zonder mTLS (d.w.z. clientverificatie), is dat in strijd met de Webex-vereiste om mTLS te hebben.

Omdat de XSP|ADP’s veel toepassingen hebben en het aantal permutaties van deze toepassingen groot is, kunnen er andere niet-geïdentificeerde conflicten zijn. Om deze reden moet elk mogelijk hergebruik van XSP|ADP's worden geverifieerd in een lab met de beoogde configuratie voordat wordt toegewezen aan het hergebruik.

NTP-synchronisatie configureren op XSP|ADP

De implementatie vereist tijdsynchronisatie voor alle XSP|ADP's die u met Webex gebruikt.

Installeer de ntp pakket nadat u het besturingssysteem hebt geïnstalleerd en voordat u de BroadWorks-software installeert. Vervolgens kunt u NTP configureren tijdens de installatie van de XSP|ADP-software. Zie de BroadWorks-handleiding voor softwarebeheer voor meer informatie.

Tijdens de interactieve installatie van de XSP|ADP-software krijgt u de optie om NTP te configureren. Ga verder als volgt:

  1. Wanneer het installatieprogramma hierom vraagt, Do you want to configure NTP?, voer in y.

  2. Wanneer het installatieprogramma hierom vraagt, Is this server going to be a NTP server?, voer in n.

  3. Wanneer het installatieprogramma hierom vraagt, What is the NTP address, hostname, or FQDN?, voer het adres van uw NTP-server of een openbare NTP-service in, bijvoorbeeld, pool.ntp.org.

Als uw XSP|ADP's een stille (niet-interactieve) installatie gebruiken, moet het installatieconfiguratiebestand de volgende Key=Value-paren bevatten:

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

XSP|ADP-identiteits- en beveiligingsvereisten

Achtergrond

De protocollen en coderingen van Cisco BroadWorks TLS-verbindingen kunnen op verschillende specificiteitsniveaus worden geconfigureerd. Deze niveaus variëren van de meest algemene (SSL-provider) tot de meest specifieke (individuele interface). Een meer specifieke instelling overschrijft altijd een meer algemene instelling. Als deze niet zijn opgegeven, worden SSL-instellingen op een lager niveau overgenomen van hogere niveaus.

Als er geen instellingen worden gewijzigd ten opzichte van de standaardinstellingen, worden de standaardinstellingen van de SSL-provider door alle niveaus overgenomen (JSSE Java Secure Sockets Extension).

Lijst met vereisten

  • De XSP|ADP moet zichzelf verifiëren bij clients met een door een certificeringsinstantie ondertekend certificaat waarin de algemene naam of alternatieve naam voor het onderwerp overeenkomt met het domeingedeelte van de XSI-interface.

  • De Xsi-interface moet het TLSv1.2-protocol ondersteunen.

  • De Xsi-interface moet een cijfersuite gebruiken die aan de volgende vereisten voldoet.

    • Diffie-Hellman Ephemeral (DHE) of Elliptic Curves Diffie-Hellman Ephemeral (ECDHE) sleuteluitwisseling

    • AES-code (Advanced Encryption Standard) met een minimale blokgrootte van 128 bits (bijv. AES-128 of AES-256)

    • GCM (Galois/Counter Mode) of CBC (Cipher Block Chaining) cipher mode

      • Indien een CBC-code gebruikt wordt, is enkel de SHA2-familie van hash-functies toegelaten voor sleutelafleiding (SHA256, SHA384, SHA512).

De volgende cijfers voldoen bijvoorbeeld aan de vereisten:

  • 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


 

De XSP|ADP CLI vereist de IANA-naamgevingsconventie voor versleutelingssuites, zoals hierboven weergegeven, niet de openSSL-conventie.

Ondersteunde TLS-cijfers voor de AuthService- en XSI-interfaces


 

Deze lijst kan worden gewijzigd naarmate onze cloudbeveiligingsvereisten evolueren. Volg de huidige aanbeveling voor Cisco-cloudbeveiliging voor cijferselectie, zoals beschreven in de lijst met vereisten in dit document.

  • 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

Parameters voor Xsi-gebeurtenisschaal

Mogelijk moet u de grootte van de Xsi-Events-wachtrij en het aantal thread verhogen om het volume aan gebeurtenissen af te handelen dat de Webex voor Cisco BroadWorks-oplossing vereist. U kunt de parameters als volgt verhogen tot de weergegeven minimumwaarden (verlaag ze niet als ze boven deze minimumwaarden liggen):

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

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

Meerdere XSP|ADP's

Randelement lastverdeling

Als u een load balancing-element op uw netwerkrand hebt, moet dit transparant omgaan met de verdeling van verkeer tussen uw meerdere XSP|ADP-servers en de Webex voor Cisco BroadWorks-cloud en -clients. In dit geval geeft u de URL van de load balancer op aan de Webex voor Cisco BroadWorks-configuratie.

Opmerkingen over deze architectuur:

  • Configureer DNS zodat de clients de load balancer kunnen vinden wanneer ze verbinding maken met de Xsi-interface (zie DNS-configuratie).

  • We raden u aan het randelement te configureren in de reverse SSL-proxymodus om punt-naar-punt-gegevenscodering te garanderen.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam. U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

Internetgerichte XSP|ADP-servers

Als u de Xsi-interfaces rechtstreeks blootstelt, gebruikt u DNS om het verkeer te distribueren naar de meerdere XSP|ADP-servers.

Opmerkingen over deze architectuur:

  • Er zijn twee records vereist om verbinding te maken met de XSP|ADP-servers:

    • Voor Webex-microservices: Round-robin A/AAAA-records zijn vereist om de meerdere XSP|ADP IP-adressen te bereiken. De reden hiervoor is dat de Webex-microservices geen SRV-zoekopdrachten kunnen uitvoeren. Zie Webex-cloudservices voor voorbeelden.

    • Voor de Webex-app: Een SRV-record dat wordt omgezet in A-records waarbij elk A-record wordt omgezet in één XSP|ADP. Zie de Webex-app voor voorbeelden.

      Gebruik geprioriteerde SRV-records om de XSI-service te richten op de meerdere XSP|ADP-adressen. Geef prioriteit aan uw SRV-records zodat de microservices altijd naar dezelfde A-record gaan (en het volgende IP-adres) en alleen naar de volgende A-record (en IP-adres) gaan als het eerste IP-adres niet beschikbaar is. GEBRUIK GEEN round-robin-benadering voor de Webex-app.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam.

  • U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

HTTP-omleidingen vermijden

Soms is DNS geconfigureerd om de XSP|ADP-URL op te lossen naar een HTTP-laadbalancer en is de laadbalancer geconfigureerd voor omleiding via een reverse proxy naar de XSP|ADP-servers.

Webex volgt geen omleiding wanneer u verbinding maakt met de URL's die u levert, dus deze configuratie werkt niet.

Bestellen en inrichten

Bestellen en inrichten is van toepassing op deze niveaus:

  • Inrichting van partner/serviceprovider:

    Elke geïntegreerde Webex voor Cisco BroadWorks-serviceprovider (of reseller) moet worden geconfigureerd als een partnerorganisatie in Webex en de nodige rechten krijgen. Cisco Operations biedt de beheerder van de partnerorganisatie toegang tot het beheren van Webex voor Cisco BroadWorks op Webex Partner Hub. De partnerbeheerder moet alle vereiste inrichtingsstappen uitvoeren voordat hij/zij een klant/bedrijfsorganisatie kan inrichten.

  • Bestellen en inrichten klant/onderneming:

    Elke BroadWorks Enterprise die is ingeschakeld voor Webex voor Cisco BroadWorks, activeert het maken van een gekoppelde Webex-klantorganisatie. Dit proces vindt automatisch plaats als onderdeel van de inrichting van de gebruiker/abonnee. Alle gebruikers/abonnees binnen een BroadWorks-onderneming zijn ingericht in dezelfde Webex-klantorganisatie.

    Hetzelfde gedrag is van toepassing als uw BroadWorks-systeem is geconfigureerd als serviceprovider met groepen. Wanneer u een abonnee inricht in een BroadWorks-groep, wordt er automatisch een klantorganisatie gemaakt in Webex die overeenkomt met de groep.

  • Bestellen en inrichten van gebruikers/abonnees:

    Webex voor Cisco BroadWorks ondersteunt momenteel de volgende modellen voor gebruikersinrichting:

    • Flowthrough-inrichting met vertrouwde e-mails

    • Flowthrough-inrichting zonder vertrouwde e-mails

    • Zelfinrichting gebruiker

    • API-inrichting

Flowthrough-inrichting met vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u kunt bevestigen dat BroadWorks e-mailadressen van abonnees heeft die geldig en uniek zijn voor Webex, maakt en activeert deze inrichtingsoptie automatisch Webex-accounts met deze e-mailadressen als gebruikers-id's.

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Flowthrough-inrichting met vertrouwde e-mails

Flowthrough-inrichting zonder vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u niet kunt vertrouwen op de e-mailadressen van abonnees die in handen zijn van BroadWorks, maakt deze inrichtingsoptie Webex-accounts, maar kan deze niet worden geactiveerd totdat abonnees hun e-mailadressen leveren en valideren. Op dat moment kan Webex de accounts met deze e-mailadressen activeren als gebruikers-id's.

Flowthrough-inrichting zonder vertrouwde e-mails

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Zelfinrichting gebruiker

Met deze optie is er geen flowthrough-inrichting van BroadWorks naar Webex. Nadat u de integratie tussen Webex en uw BroadWorks-systeem hebt geconfigureerd, krijgt u een of meer koppelingen die specifiek zijn voor het inrichten van gebruikers binnen uw Webex voor Cisco BroadWorks-partnerorganisatie.

Vervolgens ontwerpt u uw eigen communicatie (of delegeert u aan uw klanten) om de link naar abonnees te verspreiden. De abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun eigen Webex-accounts te maken en te activeren.

Zelfinrichting gebruiker

Omdat de accounts zijn ingericht binnen het bereik van uw partnerorganisatie, kunt u gebruikerspakketten handmatig aanpassen via Partner Hub of de API gebruiken om dit te doen.


 

Gebruikers moeten bestaan in het BroadWorks-systeem dat u met Webex integreert, of ze mogen geen accounts maken met die koppeling.

Serviceproviderinrichting door API's

Webex toont een reeks openbare API's waarmee u Webex voor Cisco BroadWorks gebruikers-/abonneevoorzieningen kunt maken in uw bestaande gebruikersbeheerworkflow/-tools.

Serviceproviderinrichting door API's - Vertrouwde e-mails
Serviceproviderinrichting door API's - Niet-vertrouwde e-mails

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Toestelnummer bellen

Met ondersteuning voor de functie voor toestelbellen kunnen Webex-gebruikers van Cisco Broadworks andere gebruikers bellen met een toestel dat vergelijkbaar is met het primaire telefoonnummer binnen dezelfde onderneming. Dit is vooral handig voor gebruikers die geen DID-nummers hebben.

Tijdens het inrichten wordt het toestelnummer van de gebruikers opgeslagen in de Webex-directory als het toestelnummer van de gebruiker. Voor BroadWorks-gesprekken wordt het toestelnummer weergegeven in de Webex-app in het toestelveld van alle gebieden met de gespreksinitiatiemethode en het profiel van de gebruiker. Webex voor Cisco BroadWorks ondersteunt alleen-toestelgesprekken tussen gebruikers binnen dezelfde groep en verschillende groepen van dezelfde onderneming met de combinatie van kiescode voor locatie en toestel. Bellen tussen twee bedrijven die alleen extensies gebruiken, wordt echter niet ondersteund.

Er kan een toestel worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'toestel'

      • De toestelparameter moet expliciet worden doorgegeven als onderdeel van de API-oproep. Voor bedrijven/groepen waarvoor LDC (Location Dialing Code) is geconfigureerd, moet de toestelparameter de combinatie LDC en 'toestelnummer' zijn.

    • Flowthrough- of zelfactiveringsinrichting

      • Toestel en LDC (indien van toepassing) worden automatisch opgehaald uit BroadWorks.

  • Gespreksgebruikers of -entiteiten met alleen BroadWorks

    • Automatisch gesynchroniseerd vanuit BroadWorks via adreslijstsynchronisatie met de combinatie van LDC (Location Dialing Code) en toestelnummer.

Tabel 2. Toestelnummers beheren op basis van de inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Toestelnummer beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

Toestelnummer moet worden doorgegeven als parameter

Doorstroomd

Toestel automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

BroadWorks-telefoonlijsten

Lijsten met bedrijven, groepen of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing

Voorwaarden

  1. De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.

  2. Patch waarbij kiescodes voor toestelnummers en locaties worden toegevoegd aan XSI en inrichtingsadapter februari 2022 voor versie 23 of hoger als onderdeel van:

    • 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. Schakel de koptekst X-BroadWorks-Remote-Party-Info in op het AS met de onderstaande CLI-opdracht voor deze SIP-gespreksstroom die vereist is voor ondersteuning van de functie voor toestelbellen.

    AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Prioriteit oproepopties in de app

Als onderdeel van de ondersteuning voor de functie Toestelbellen wordt De prioriteitsinstelling voor gespreksopties van de app ook op partnerniveau aangeboden voor alle Webex voor Cisco Broadworks-partners. Met deze instelling kan de partner de gespreksprioriteitsinstellingen van al zijn beheerde klanten beheren vanuit Partner Hub. De prioriteitsinstelling voor app-gespreksopties voor een klant kan ook op klantniveau worden gewijzigd vanuit Control Hub.

De prioriteitsinstelling voor app-gespreksopties bevat toestel als tweede optie in zowel Partner Hub als Control Hub wanneer een Webex voor Cisco Broadworks-gebruiker nieuw is ingericht met toestel via een van de bovengenoemde inrichtingsmethoden.

Voor alle bestaande ingerichte organisaties heeft de uitbreidingsoptie de verborgen status (standaard) in de prioriteitsinstelling voor app-gespreksopties. Er wordt geen toestel weergegeven in de optie voor audio-/videogesprekken van de gebruiker in de Webex-app.

Hieronder ziet u de opties om de optie Toestelgesprek zichtbaar te maken voor de bestaande klanten:

  1. Als een partner wil dat al zijn beheerde klantorganisaties een toestel krijgen als een van de gespreksopties, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Partnerhub. Hierdoor kunnen de beheerde klantorganisaties de instelling van hun partner overnemen.

  2. Als een partner een toestel wil aanbieden in gespreksopties voor een specifieke klantorganisatie, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Control Hub.

Ondersteuning voor groepscontactpersonen

Met deze functie wordt de Webex for BroadWorks DirSync-service verbeterd door de beperking voor het synchroniseren van maximaal 1500 contactpersonen uit de telefoonlijsten van de groep in BroadWorks te verwijderen en partners in staat te stellen maximaal 30K contactpersonen uit een enkele telefoonlijst van de groep te synchroniseren en deze gelijk te maken met de verhoging van 30K contactpersonen voor de Enterprise telefoonlijst, die afzonderlijk is vrijgegeven.

Er is een totale limiet van 200K voor alle externe contactpersonen per organisatie, die van toepassing is op de som van Enterprise- en Group-telefoonlijsten in één BroadWorks-onderneming. Een BroadWorks-onderneming met een bedrijfstelefoonlijst met 30K en ook 5 groepstelefoonlijsten met elk 30K worden ondersteund (180K totaal per organisatie). Als er echter 6 groepstelefoonlijsten zijn met elk 30K, wordt dit niet ondersteund (210K totaal).


 

Deze functie is beschikbaar op aanvraag. Neem contact op met uw accountteam om dit in te schakelen.

  • Voordat u de functie inschakelt, moet een vereiste migratie worden uitgevoerd om groepen in te richten en te koppelen voor alle bestaande ingerichte gebruikers.

  • Het Cisco-team voert een interne API uit om bestaande ingerichte gebruikers te migreren om ze aan de juiste groep te koppelen. OPMERKING: Dit kan tot een week duren om te verwerken.

  • Zodra de migratie is voltooid voor de partner en de functie is ingeschakeld, worden alle nieuw ingerichte gebruikers op de juiste manier 'gegroepeerd'.

Nadat de functie is ingeschakeld, begint de DirSync-service met het synchroniseren van contactpersonen uit de telefoonlijst van de BroadWorks-groep in de speciale opslag voor groepscontactpersonen in de Webex-contactservice.

Tijdens het inrichten moet de bedrijfsgroep van de gebruiker worden opgeslagen in de Webex-directory om aan te geven tot welke groep deze gebruiker behoort. Met de koppeling van de gebruiker aan een BroadWorks-groep in de Webex-directory kan de Webex-app contact zoeken in de opslag voor de contactservicegroep voor de specifieke groep van de gebruiker.

Voor deze functie moeten de Webex for BroadWorks-abonnees in Webex worden ingericht met de BroadWorks-bedrijfs-groeps-id.

De BroadWorks Enterprise Group Id kan worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Webex voor Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'spEnterpriseGroupId'

      • De BroadWorks Enterprise Group Id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek.

    • Flowthrough- of zelfactiveringsinrichting

      • BroadWorks-bedrijfs-groeps-id wordt automatisch opgehaald uit BroadWorks.

    • Gespreksgebruikers of -entiteiten met alleen BroadWorks

      • Niet van toepassing. Het is niet vereist om de BroadWorks Enterprise Group-id voor deze gebruikers te synchroniseren.

Tabel 3. Beheer van Enterprise Group ID op basis van inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Bedrijfs-groeps-id beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

BroadWorks-bedrijfs groep-id moet worden doorgegeven als parameter spEnterpriseGroupId

Doorstroomd

BroadWorks-bedrijfs groep-id wordt automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Niet van toepassing

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Niet van toepassing

BroadWorks-telefoonlijsten

Contactpersonen in de telefoonlijsten van de BroadWorks-groep

Synchroniseren met Directory

Groepscontacten worden opgeslagen in de Webex-contactservice die is gekoppeld aan de specifieke groep

Lijsten met BroadWorks-enterpsie of persional-telefoons

Contactpersonen in de lijsten met zakelijke of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing


 

Openbare API moet worden bijgewerkt VÓÓR de MIGRATIE. Migratie kan niet worden voltooid totdat DEZE API is voltooid. De BroadWorks Enterprise Group-id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek https://developer.webex.com/docs/api/changelog#2023-march

Nadat de functie is ingeschakeld en als gevolg van de volgende adreslijstsynchronisatie worden de bedrijfsgebruikersgroepen ook weergegeven in Control Hub. Het visualiseren van de groepen in Control Hub voor Webex voor BroadWorks is in dit stadium puur informatief. Partner- en klantbeheerders mogen geen wijzigingen aanbrengen aan groepen of groepslidmaatschap in Control Hub, omdat deze wijzigingen niet worden teruggekoppeld naar BroadWorks. Groepsbeheer in Control Hub is bedoeld voor gebruik door partners die de komende API's voor contactbeheer gaan gebruiken.

Migratie en toekomstbestendigheid

De progressie van Cisco van de BroadSoft Unified Communications Client is om van UC-One naar Webex te gaan. Er is een overeenkomstige progressie van de ondersteunende services weg van het netwerk van serviceproviders – behalve bellen – naar het Webex-cloudplatform.

Of u nu UC-One SaaS of BroadWorks Collaborate gebruikt, de voorkeursmigratiestrategie is het implementeren van nieuwe, speciale XSP|ADP's voor integratie met Webex voor Cisco BroadWorks. U kunt de twee services parallel uitvoeren terwijl u klanten migreert naar Webex en uiteindelijk de infrastructuur terugverdienen die is gebruikt voor de vorige oplossing.

Aanbevolen documentabonnementen

Webex Help Center-artikelen (op help.webex.com) hebben een optie Abonneren waarmee u een e-mailmelding kunt ontvangen wanneer dat artikel wordt bijgewerkt.

We raden u aan u te abonneren op elk van de volgende artikelen om ervoor te zorgen dat u geen kritieke updates mist die van invloed zijn op de netwerkverbinding. Om u in te schrijven, gaat u naar elk van de onderstaande links en klikt u in het artikel dat wordt gelanceerd op de knop Subscribe.

We raden u aan om u minimaal in te schrijven voor bovenstaande lijst. De meeste Webex-artikelen en -documenten die worden vermeld onder Aanvullende documenten hebben echter een optie Abonneren. Als deze optie moet worden weergegeven, moet het artikel worden weergegeven op help.webex.com.


 
Er is geen abonnementsoptie voor landingspagina's van documentatie.

Aanvullende documenten

Raadpleeg de volgende gerelateerde documentatie voor meer informatie over Webex voor Cisco BroadWorks:

Webex voor Cisco BroadWorks-documenten

Partnerbeheerders kunnen de volgende documenten en sites gebruiken om informatie te verkrijgen over Webex voor Cisco BroadWorks.

Webex voor Cisco BroadWorks-artikelen

Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:

Cisco BroadWorks-documenten

Partnerbeheerders kunnen verwijzen naar de Cisco BroadWorks-site op cisco.com voor technische documenten die beschrijven hoe het Cisco BroadWorks-gedeelte van de oplossing moet worden geïmplementeerd:

Webex Help-artikelen

De volgende Webex Help-sites kunnen worden gebruikt om Webex-artikelen te vinden waarmee klantbeheerders en eindgebruikers Webex-functies kunnen gebruiken.

  • Webex van serviceproviders: deze landingspagina bevat koppelingen met informatie over aan de slag gaan en veelgebruikte artikelen voor gebruikers van de Webex-app die Webex-services hebben gekocht bij een serviceprovider.

  • Webex-helpcentrum: gebruik de zoekfunctie op help.webex.com om te zoeken naar aanvullende Webex-artikelen waarin de Webex-app en de Webex Meetings-functionaliteit worden beschreven. U kunt zoeken naar gebruikers- of beheerdersartikelen.

Documentatie voor ontwikkelaars

Uw omgeving voorbereiden

Beslissingspunten

Overweging Vragen om te beantwoorden Resources

Architectuur en infrastructuur

Hoeveel XSP|ADP’s?

Hoe nemen ze mTLS in?

Cisco BroadWorks-systeemcapaciteitsplanner

Technische handleiding voor Cisco BroadWorks-systemen

XSP|ADP CLI-referentie

Dit document

Klant- en gebruikersvoorzieningen

Kunt u bevestigen dat u e-mails vertrouwt in BroadWorks?

Wilt u dat gebruikers e-mailadressen opgeven om hun eigen accounts te activeren?

Kunt u tools maken om onze API te gebruiken?

Openbare API-documenten op https://developer.webex.com

Dit document

Branding Welke kleur en logo wilt u gebruiken? Brandingartikel van de Webex-app
Sjablonen Wat zijn uw verschillende gebruiksscenario's voor klanten? Dit document
Abonneefuncties per klant/onderneming/groep Kies een pakket om het serviceniveau per sjabloon te definiëren. Basic, Standard, Premium of Softphone.

Dit document

Functie-/pakketmatrix

Gebruikersverificatie BroadWorks of Webex Dit document
Inrichtingsadapter (voor flowthrough-inrichtingsopties)

Gebruikt u al geïntegreerde IM&P, bijv. voor UC-One SaaS?

Bent u van plan meerdere sjablonen te gebruiken?

Is er een meer voorkomende usecase voorzien?

Dit document

CLI-referentie toepassingsserver

Architectuur en infrastructuur

  • Met welke schaal gaat u beginnen? Het is mogelijk om in de toekomst op te schalen, maar uw huidige gebruiksinschatting zou de infrastructuurplanning moeten stimuleren.

  • Werk samen met uw Cisco-accountmanager/verkoopvertegenwoordiger om uw XSP|ADP-infrastructuur te vergroten, volgens de Cisco BroadWorks System Capacity Planner en de Cisco BroadWorks System Engineering Guide.

  • Hoe maakt Webex wederzijdse TLS-verbindingen met uw XSP|ADP's? Rechtstreeks naar de XSP|ADP in een DMZ, of via TLS-proxy? Dit is van invloed op uw certificaatbeheer en de URL's die u gebruikt voor de interfaces. (We ondersteunen geen ongecodeerde TCP-verbindingen met de rand van uw netwerk).

Klant- en gebruikersvoorzieningen

Welke gebruikersinrichtingsmethode past het beste bij u?

  • Flowthrough Provisioning Met Vertrouwde E-mails: Door de service 'Geïntegreerde IM&P' toe te wijzen op BroadWorks, wordt de abonnee automatisch ingericht in Webex.

    Als u ook kunt bevestigen dat de e-mailadressen van abonnees in BroadWorks geldig en uniek zijn voor Webex, kunt u de variant 'vertrouwde e-mail' van flowthrough-inrichting gebruiken. Webex-abonneeaccounts worden zonder hun tussenkomst gemaakt en geactiveerd. Ze downloaden gewoon de client en melden zich aan.

    E-mailadres is een belangrijk gebruikerskenmerk in Webex. Daarom moet de serviceprovider een geldig e-mailadres voor de gebruiker opgeven om deze in te richten voor Webex-services. Dit moet het e-mail-id-kenmerk van de gebruiker zijn in BroadWorks. We raden u aan deze ook te kopiëren naar het kenmerk Alternatieve id.

  • Flowthrough-inrichting zonder vertrouwde e-mails: Als u de e-mailadressen van abonnees niet kunt vertrouwen, kunt u nog steeds de geïntegreerde IM&P-service in BroadWorks toewijzen om gebruikers in Webex in te richten.

    Met deze optie worden de accounts gemaakt wanneer u de service toewijst, maar moeten de abonnees hun e-mailadressen opgeven en valideren om de Webex-accounts te activeren.

  • Zelfinrichting gebruiker: Voor deze optie is geen IM&P-servicetoewijzing in BroadWorks vereist. U (of uw klanten) distribueert in plaats daarvan een inrichtingskoppeling en de koppelingen om de verschillende clients te downloaden, met uw branding en instructies.

    Abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun Webex-accounts te maken en te activeren. Vervolgens downloaden ze de client en melden zich aan en haalt Webex een aantal extra configuraties over hen op vanuit BroadWorks (inclusief hun primaire nummers).

  • SP-beheerde inrichting via API's: Webex stelt een reeks openbare API's bloot waarmee serviceproviders gebruikersvoorzieningen/abonneevoorzieningen kunnen bouwen in hun bestaande workflows.

Inrichtingsvereisten

In de volgende tabel worden de vereisten voor elke inrichtingsmethode samengevat. Naast deze vereisten moet uw implementatie voldoen aan de algemene systeemvereisten die in deze handleiding worden beschreven.

Inrichtingsmethode

Vereisten

Doorstroominrichting

(Vertrouwde of niet-vertrouwde e-mails)

De Webex-provisioning-API voegt bestaande BroadWorks-gebruikers automatisch toe aan Webex zodra de gebruiker aan de vereisten voldoet en u de geïntegreerde IM+P-service inschakelt.

Er zijn twee stromen (vertrouwde e-mails of niet-vertrouwde e-mails) die u toewijst via de onboardsjabloon op Webex.

Vereisten voor BroadWorks:

  • Gebruiker bestaat in BroadWorks met een primair nummer of toestel.

  • De gebruiker krijgt de geïntegreerde IM+P-service toegewezen, die verwijst naar de URL van de Webex-inrichtingsservice.

  • Alleen vertrouwde e-mails. De gebruiker heeft een e-mailadres geconfigureerd in BroadWorks. We raden u aan om het e-mailadres ook toe te voegen aan het veld Alternatieve id, omdat de gebruiker zich op die manier kan aanmelden met BroadWorks-referenties.

  • BroadWorks heeft verplichte patches geïnstalleerd voor flowthrough-inrichting. Zie Vereiste patches met flowthrough-inrichting (hieronder) voor de patchvereisten.

  • BroadWorks AS is rechtstreeks verbonden met de Webex-cloud of de proxy van de inrichtingsadapter is geconfigureerd met verbinding met de URL van de Webex-inrichtingsservice.

    Zie Toepassingsserver configureren met inrichtingsservice-URL om de URL van de Webex-inrichtingsservice op te halen.

    Zie Cisco BroadWorks Implement Provisioning Adapter Proxy FD om de Provisioning Adapter Proxy te configureren.

Webex-vereisten:

Het onboardsjabloon bevat de volgende instellingen:

  • De schakelaar BroadWorks-flow via inrichting inschakelen is ingeschakeld.

  • De naam en het wachtwoord van het inrichtingsaccount worden toegewezen met de beheerdersreferenties op systeemniveau van BroadWorks

  • Gebruikersverificatie is ingesteld op Trust BroadWorks-e-mails of Niet-vertrouwde e-mails.

Zelfinrichting gebruiker

Beheerder biedt een bestaande BroadWorks-gebruiker een koppeling naar de portal voor gebruikersactivering. De gebruiker moet zich met de BroadWorks-referenties aanmelden bij de portal en een geldig e-mailadres opgeven. Nadat het e-mailadres is gevalideerd, haalt Webex aanvullende gebruikersinformatie op om de inrichting te voltooien.

Vereisten voor BroadWorks:

  • Gebruiker moet bestaan in BroadWorks met een primair nummer of toestel

Webex-vereisten:

Het onboardsjabloon bevat de volgende instellingen:

  • De schakelaar Flow Through Provisioning inschakelen is uitgeschakeld.

  • Gebruikersverificatie is ingesteld op Niet-vertrouwde e-mails.

  • Gebruikers toestaan zichzelf te activeren is ingeschakeld.

SP-beheerde inrichting via API

(Vertrouwde of niet-vertrouwde e-mails)

Webex toont een reeks openbare API's waarmee u gebruikersvoorzieningen kunt bouwen in uw bestaande werkstromen en tools. Er zijn twee stromen:

  • Vertrouwde e-mails: de API voorziet de gebruiker en past het BroadWorks-e-mailadres toe als het Webex-e-mailadres.

  • Niet-vertrouwde e-mails: de API voorziet in de gebruiker, maar de gebruiker moet zich aanmelden bij de User Activation Portal en een geldig e-mailadres opgeven.

Vereisten voor BroadWorks:

  • Gebruiker moet bestaan in BroadWorks met een primair nummer of toestel.

Webex-vereisten:

  • In de onboardsjabloon is de gebruikersverificatie ingesteld op Trust BroadWorks e-mails of Niet-vertrouwde e-mails.

  • U moet uw aanvraag registreren en hiervoor toestemming vragen.

  • U moet een OAuth-token aanvragen met de scopes die zijn gemarkeerd in het gedeelte 'Verificatie' van de Webex for BroadWorks-ontwikkelaarshandleiding.

  • Er moet een beheerder of inrichtingsbeheerder worden toegewezen aan uw partnerorganisatie.

Ga naar BroadWorks-abonnees om de API's te gebruiken.

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Ondersteunde taallandinstellingen

Tijdens het inrichten wordt de taal die in beheergebruiker is toegewezen aan de eerste ingerichte beheergebruiker automatisch toegewezen als de standaardlandinstelling voor die klantorganisatie. Deze instelling bepaalt de standaardtaal die wordt gebruikt voor activeringsmails, vergaderingen en uitnodigingen voor vergaderingen onder die klantorganisatie.

Taallandinstellingen met vijf tekens in (ISO-639-1)_(ISO-3166)-indeling worden ondersteund. en_VS komt bijvoorbeeld overeen met English_UnitedStates. Als er slechts een taal met twee letters wordt aangevraagd (in ISO-639-1-indeling), genereert de service een landinstelling met vijf tekens door de aangevraagde taal te combineren met een landcode uit de sjabloon, d.w.z. "requestedLanguage_CountryCode", als er geen geldige landinstelling kan worden verkregen, wordt de standaard verstandige landinstelling gebruikt op basis van de vereiste taalcode.

De volgende tabel bevat de ondersteunde landinstellingen en de toewijzing waarmee een taalcode van twee letters wordt omgezet in een landinstelling met vijf tekens voor situaties waarin een landinstelling met vijf tekens niet beschikbaar is.

Tabel 1. Ondersteunde taallandcodes

Ondersteunde taallandinstellingen

(ISO-639-1)_(ISO-3166)

Als er alleen een taalcode met twee letters beschikbaar is...

Taalcode (ISO-639-1) **

Gebruik in plaats daarvan Standaard verstandige landinstelling (ISO-639-1)_(ISO-3166)

en_VS

en_AU

en_GB

en_CA

en

en_VS

fr_vr

fr_CA

vr

fr_vr

cs_CZ, CZ

cs

cs_CZ, CZ

da_DK

da's, da's

da_DK

de_de

de

de_de

hu_HU

(aan)laars

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_NEE

nb

nb_NEE

pl_VERV.

verv.

pl_VERV.

pt_PT

pt_BR

pt

pt_PT

ru_ru

ru

ru_ru

ro_RO

ro

ro_RO

zh_CN

zh_TW

zweer

zh_CN

sv_SE

sv

sv_SE

ar_SA

ar, teken, teken

ar_SA

tr_TR

staartstuk

tr_TR


 

De landinstellingen es_CO, id_ID, nb_NO en pt_PT worden niet ondersteund door Webex Meeting-sites. Voor deze landinstellingen zijn De Webex Meetings-sites alleen in het Engels. Engels is de standaardlandinstelling voor sites als er geen/ongeldige/niet-ondersteunde landinstelling vereist is voor de site. Dit taalveld is van toepassing bij het maken van een organisatie- en Webex Meetings-site. Als er geen taal wordt vermeld in een bericht of in de API van de abonnee, wordt de taal van de sjabloon gebruikt als standaardtaal.

Branding

Partnerbeheerders kunnen geavanceerde merkaanpassingen gebruiken om aan te passen hoe de Webex app eruitziet voor de klantorganisaties die de partner beheert. Partnerbeheerders kunnen de volgende instellingen aanpassen om ervoor te zorgen dat de Webex -app het merk en de identiteit van hun bedrijf weerspiegelt:

  • Bedrijfslogo's

  • Unieke kleurenschema's voor de lichte modus of de donkere modus

  • Aangepaste ondersteunings-URL's

Meer informatie over het aanpassen van branding vindt u in Geavanceerde branding-aanpassingen configureren.


 
  • Aanpassingen voor basisbranding worden afgeschaft. We raden u aan Advanced Branding te implementeren, dat een breder scala aan aanpassingen biedt.

  • Voor meer informatie over hoe branding wordt toegepast bij het koppelen aan een bestaande klantorganisatie, raadpleegt u Voorwaarden van organisatiebijlage in het gedeelte Webex voor BroadWorks toevoegen aan bestaande organisatie.

Onboardingssjablonen

Met onboardsjablonen kunt u de parameters definiëren waarmee klanten en gekoppelde abonnees automatisch worden ingericht in Webex voor Cisco BroadWorks. U kunt indien nodig meerdere onboardsjablonen configureren, maar wanneer u een klant onboardt, is deze aan slechts één sjabloon gekoppeld (u kunt niet meerdere sjablonen op één klant toepassen).

Enkele van de primaire sjabloonparameters worden hieronder weergegeven.

Pakket

  • U moet een standaardpakket selecteren wanneer u een sjabloon aanmaakt (zie Pakketten in het gedeelte Overzicht voor meer informatie). Alle gebruikers die zijn ingericht met die sjabloon, hetzij door middel van flowthrough- of self-provisioning, ontvangen het standaardpakket.

  • U hebt controle over de pakketselectie voor verschillende klanten door meerdere sjablonen te maken en telkens verschillende standaardpakketten te selecteren. U kunt vervolgens verschillende inrichtingskoppelingen of verschillende inrichtingsadapters per onderneming distribueren, afhankelijk van de door u gekozen gebruikersinrichtingsmethode voor deze sjablonen.

  • U kunt het pakket met specifieke abonnees wijzigen vanaf deze standaard met behulp van de inrichtings-API (zie Webex voor Cisco BroadWorks API-documentatie of via Partner Hub (zie Gebruikerspakket wijzigen in Partner Hub).

  • U kunt het pakket van een abonnee niet wijzigen vanuit BroadWorks. De toewijzing van de geïntegreerde IM&P-service is in- of uitgeschakeld. Als de abonnee deze service in BroadWorks wordt toegewezen, definieert de Partner Hub-sjabloon die is gekoppeld aan de inrichtings-URL van de onderneming van die abonnee het pakket.

Doorverkoper en ondernemingen of serviceprovider en groepen?

  • De manier waarop uw BroadWorks-systeem is geconfigureerd, heeft invloed op de flow via inrichting. Als u een reseller bent met Enterprises, moet u de Enterprise-modus inschakelen wanneer u een sjabloon maakt.

  • Als uw BroadWorks-systeem is geconfigureerd in de serviceprovidermodus, kunt u de Enterprise-modus uitschakelen in uw sjablonen.

  • Als u van plan bent klantorganisaties in te richten met beide BroadWorks-modi, moet u verschillende sjablonen gebruiken voor groepen en bedrijven.


 
Zorg ervoor dat u de BroadWorks-patches hebt toegepast die vereist zijn voor doorstroominrichting. Zie Vereiste patches met doorstroominrichting voor meer informatie.

Verificatiemodus

Bepaal hoe u wilt dat abonnees zich verifiëren wanneer ze zich aanmelden bij Webex. U kunt de modus toewijzen met de instelling Verificatiemodus in de onboardingsjabloon. In de volgende tabel worden enkele opties beschreven.


 
Deze instelling heeft geen invloed op het aanmelden bij de User Activation Portal. Gebruikers die zich aanmelden bij de portal, moeten hun BroadWorks-gebruikers-id en -wachtwoord invoeren, zoals geconfigureerd in BroadWorks, ongeacht hoe u de verificatiemodus configureert in de onboardsjabloon.
VerificatiemodusBroadWorksWebex
Primaire gebruikersidentiteitBroadWorks-gebruikers-idE-mailadres
Identiteitsprovider

BroadWorks.

  • Als u een directe verbinding met BroadWorks configureert, wordt de Webex-app rechtstreeks geverifieerd bij de BroadWorks-server.

    Als u een directe verbinding wilt configureren, moet het selectievakje Directe BroadWorks-verificatie inschakelen zijn ingeschakeld in de BroadWorks-clusterconfiguratie op Partner Hub (de instelling is standaard uitgeschakeld).

  • Anders wordt verificatie naar BroadWorks mogelijk gemaakt via een intermediaire service die door Webex wordt gehost.

Cisco Common Identity
Meervoudige verificatie?NeeVereist Customer IdP die meervoudige verificatie ondersteunt.

Validatiepad gebruikergegevens

  1. Browser wordt gestart waarbij de gebruiker e-mail levert om de eerste aanmeldstroom te starten en de verificatiemodus te detecteren.

  2. De browser wordt vervolgens omgeleid naar een door Webex gehoste BroadWorks-aanmeldpagina (deze pagina is brandable)

  3. Gebruiker levert BroadWorks gebruikers-id en wachtwoord op de aanmeldpagina.

  4. Gebruikersreferenties worden gevalideerd met BroadWorks.

  5. Bij succes wordt een autorisatiecode verkregen van Webex. Dit wordt gebruikt om de benodigde toegangstokens voor Webex-services te verkrijgen.

  1. Browser wordt gestart waarbij de gebruiker e-mail levert om de eerste aanmeldstroom te starten en de verificatiemodus te detecteren.

  2. De browser wordt omgeleid naar IdP (Cisco Common Identity of Customer IdP), waar ze een aanmeldportal krijgen.

  3. Gebruiker levert de juiste aanmeldgegevens op de aanmeldpagina

  4. Verificatie met meerdere factoren kan plaatsvinden als de Customer IdP dit ondersteunt.

  5. Bij succes wordt een autorisatiecode verkregen van Webex. Dit wordt gebruikt om de benodigde toegangstokens voor Webex-services te verkrijgen.


 
Zie SSO-aanmeldstroom voor een gedetailleerder overzicht van de SSO-aanmeldstroom met directe verificatie naar BroadWorks.

UTF-8-codering met BroadWorks-verificatie

Met BroadWorks-verificatie raden we u aan UTF-8-codering voor de verificatiekoptekst te configureren. UTF-8 lost een probleem op dat zich kan voordoen met wachtwoorden die speciale tekens gebruiken waarbij de webbrowser de tekens niet goed codeert. Met behulp van een UTF-8-gecodeerde, basis 64-gecodeerde header lost dit probleem op.

U kunt UTF-8-codering configureren door een van de volgende CLI-opdrachten uit te voeren op de XSP of ADP:

  • XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

  • ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8

Land

U moet een land selecteren wanneer u een sjabloon maakt. Dit land wordt automatisch toegewezen als het organisatieland voor alle klanten die zijn ingericht met de sjabloon in Common Identity. Daarnaast bepaalt het land van de organisatie de standaard internationale inbelnummers voor Cisco PSTN in Webex Meeting-sites.

De standaard internationale inbelnummers van de site worden ingesteld op het eerste beschikbare inbelnummer dat is gedefinieerd in het telefoniedomein op basis van het land van de organisatie. Als het land van de organisatie niet wordt gevonden in het inbelnummer dat is gedefinieerd in het telefoniedomein, wordt het standaardnummer van die locatie gebruikt.

Tabel 2. In de volgende tabel wordt de standaardlandcode voor inbellen weergegeven op basis van elke locatie:

S-nr.

Locatie

Landcode

Landnaam

1

AMER

+1

ONS, CA

2

APAC

+65

Singapore

3

ANUS, SCHEREN

+61

Australië

4

EMEA

+44

VK

5

EURO

+49

Duitsland

Regelingen voor meerdere partners

Gaat u Webex voor Cisco BroadWorks sublicentie geven aan een andere serviceprovider? In dit geval heeft elke serviceprovider een afzonderlijke partnerorganisatie nodig in Webex Control Hub om hen in staat te stellen de oplossing voor hun klantenbestand in te richten.

Inrichtingsadapter en sjablonen

Wanneer u flowthrough provisioning gebruikt, wordt de inrichtings-URL die u invoert in BroadWorks afgeleid van de sjabloon in Control Hub. U kunt meerdere sjablonen en dus meerdere inrichtings-URL's hebben. Hiermee kunt u per onderneming selecteren welk pakket u op abonnees wilt toepassen wanneer ze de geïntegreerde IM&P-service krijgen.

U moet overwegen of u een inrichtings-URL op systeemniveau wilt instellen als een standaardinrichtingspad en welke sjabloon u daarvoor wilt gebruiken. Op deze manier hoeft u alleen de inrichtings-URL expliciet in te stellen voor bedrijven die een andere sjabloon nodig hebben.

Houd er ook rekening mee dat u mogelijk al een inrichtings-URL op systeemniveau gebruikt, bijvoorbeeld met UC-One SaaS. Als dat het geval is, kunt u ervoor kiezen om de URL op systeemniveau te behouden voor het inrichten van gebruikers op UC-One SaaS en deze te overschrijven voor bedrijven die overstappen naar Webex voor Cisco BroadWorks. U kunt ook de andere kant op gaan en de URL op systeemniveau instellen voor Webex voor BroadWorks en de bedrijven die u wilt behouden op UC-One SaaS opnieuw configureren.

De configuratiekeuzes met betrekking tot deze beslissing worden beschreven in Toepassingsserver configureren met inrichtingsservice-URL.

Proxy inrichtingsadapter

Voor extra beveiliging kunt u met de Provisioning Adapter Proxy een HTTP(S)-proxy gebruiken op het Application Delivery Platform voor flowthrough-inrichting tussen de AS en Webex. De proxyverbinding maakt een end-to-end TCP-tunnel die verkeer tussen de AS en Webex doorgeeft, waardoor de AS geen directe verbinding met het openbare internet hoeft te maken. Voor veilige verbindingen kan TLS worden gebruikt.

Voor deze functie moet u de proxy instellen op BroadWorks. Zie voor meer informatie Beschrijving van de proxyfunctie van de Cisco BroadWorks-inrichtingsadapter.

Minimumvereisten

Accounts

Alle abonnees die u inricht voor Webex moeten bestaan in het BroadWorks-systeem dat u integreert met Webex. U kunt indien nodig meerdere BroadWorks-systemen integreren.

Alle abonnees moeten BroadWorks-licenties en een primair nummer of toestel hebben.

Webex gebruikt e-mailadressen als primaire id's voor alle gebruikers. Als u flowthrough-inrichting gebruikt met vertrouwde e-mails, moeten uw gebruikers geldige adressen hebben in het e-mailkenmerk in BroadWorks.

Als uw sjabloon BroadWorks-verificatie gebruikt, kunt u e-mailadressen van abonnees kopiëren naar het kenmerk Alternatieve id in BroadWorks. Hierdoor kunnen gebruikers zich aanmelden bij Webex met hun e-mailadressen en hun BroadWorks-wachtwoorden.

Uw beheerders moeten hun Webex-accounts gebruiken om zich aan te melden bij Partner Hub.


 
Het wordt niet ondersteund om een BroadWorks-beheerder te integreren in Webex voor Cisco BroadWorks. U kunt BroadWorks-bellende gebruikers met een primair nummer en/of toestel alleen onboarden. Als u flowthrough-inrichting gebruikt, moeten gebruikers ook de geïntegreerde IM&P-service krijgen toegewezen.

Servers in uw netwerk- en softwarevereisten

  • De BroadWorks-instantie(s) moet(en) ten minste de volgende servers bevatten:

    • Toepassingsserver (AS) met BroadWorks-versie zoals hierboven

    • Netwerkserver (NS)

    • Profielserver (PS)

  • Openbare XSP|ADP-server(s) of Application Delivery Platform (ADP) die aan de volgende vereisten voldoen:

    • Verificatieservice (BWAuth)

    • XSI-acties en -gebeurtenissen-interfaces

    • DMS (webapplicatie voor apparaatbeheer)

    • CTI-interface (intergratie van computertelefonie)

    • TLS 1.2 met een geldig certificaat (niet zelfondertekend) en vereiste tussenproducten. Vereist systeembeheerder om het opzoeken van bedrijven te vergemakkelijken.

    • Wederzijdse TLS-verificatie (mTLS) voor verificatieservice (vereist dat de openbare Webex-clientcertificaatketen als vertrouwensankers is geïnstalleerd)

    • Wederzijdse TLS-verificatie (mTLS) voor CTI-interface (vereist dat de openbare Webex-clientcertificaatketen als vertrouwensankers is geïnstalleerd)

  • Een afzonderlijke XSP/ADP-server die fungeert als een pushserver voor gespreksmeldingen (een NPS in uw omgeving die wordt gebruikt om gespreksmeldingen naar Apple/Google te pushen). We noemen het hier 'CNPS' om het te onderscheiden van de service in Webex die pushmeldingen voor berichten en aanwezigheid levert).

    Deze server moet op R22 of hoger zijn.

  • We mandaat een afzonderlijke XSP/ADP-server voor CNPS omdat de onvoorspelbaarheid van de belasting van Webex voor BWKS-cloudverbindingen een negatieve invloed kan hebben op de prestaties van de NPS-server, met als gevolg toenemende latentie van meldingen. Zie de Cisco BroadWorks System Engineering Guide voor meer informatie over de XSP|ADP-schaal.

Webex-app-platforms

Fysieke telefoons en accessoires

Apparaatintegratie

Zie de Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks voor meer informatie over het onboarden en gebruiken van OS- en MPP-apparaten in de serviceruimte voor Webex voor Cisco BroadWorks.

Apparaatprofielen

Hieronder staan de DTAF-bestanden die u op uw toepassingsservers moet laden om de Webex-app als een belclient te ondersteunen. Het zijn dezelfde DTAF-bestanden als gebruikt voor UC-One SaaS, maar er is een nieuwe config-wxt.xml.template bestand dat wordt gebruikt voor de Webex-app.

Als u de nieuwste apparaatprofielen wilt downloaden, gaat u naar de site van het Application Delivery Platform Software Downloads om de nieuwste DTAF-bestanden op te halen. Deze downloads werken voor zowel ADP als XSP.

Clientnaam

Type apparaatprofiel en pakketnaam

Webex Mobile-sjabloon

Type identiteit/apparaatprofiel: Verbinding maken - mobiel

DTAF: ucone-mobile-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Sjabloon voor Webex-tablet

Type identiteit/apparaatprofiel: Verbinding maken - tablet

DTAF: ucone-tablet-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Webex Desktop-sjabloon

Type identiteit/apparaatprofiel: Bedrijfscommunicator - PC

DTAF: ucone-desktop-ucaas-X.X.XX-wxt-MonthYear_DTAF.zip

Configuratiebestand: config-wxt.xml

Identificeer/apparaatprofiel

Alle Webex voor Cisco BroadWorks-gebruikers moeten een Identity/Device Profile hebben toegewezen in BroadWorks dat een van de bovenstaande apparaatprofielen gebruikt om te bellen met de Webex-app. Het profiel biedt de configuratie waarmee de gebruiker gesprekken kan plaatsen.

OAuth-aanmeldgegevens voor uw Webex voor Cisco BroadWorks verkrijgen

Dien een serviceverzoek in bij uw onboardingagent of bij Cisco TAC om Cisco OAuth in te richten voor uw Cisco Identity Provider Federation-account.

Gebruik de volgende titel van het verzoek voor de respectieve functies:

  1. XSP|ADP AuthService Configuration' voor het configureren van de service op XSP|ADP.

  2. 'NPS-configuratie voor verificatie proxy instellen' om NPS te configureren voor het gebruik van de verificatieproxy.

  3. CI-gebruikers-UUID synchroniseren' voor CI-gebruikers-UUID synchroniseren. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.

  4. Configureer BroadWorks om Cisco-facturering voor BroadWorks en Webex Voor BroadWorks-abonnementen in te schakelen.

Cisco geeft u een OAuth-client-id, een clientgeheim en een vernieuwingstoken die 60 dagen geldig is. Als het token verloopt voordat u het gebruikt, kunt u een andere aanvraag indienen.


 

Als u al de referenties van de Cisco OAuth-identiteitsprovider hebt verkregen, voltooit u een nieuw serviceverzoek om uw referenties bij te werken.

Bestellingscertificaten

Certificaatvereisten voor TLS-verificatie

Voor alle vereiste toepassingen hebt u beveiligingscertificaten nodig, ondertekend door een bekende certificeringsinstantie en geïmplementeerd op uw openbare XSP|ADP's. Deze worden gebruikt om TLS-certificaatverificatie te ondersteunen voor alle inkomende verbindingen met uw XSP|ADP-servers.

Deze certificaten moeten uw XSP|ADP openbare volledig gekwalificeerde domeinnaam bevatten als algemene naam of alternatieve naam van het onderwerp.

De exacte vereisten voor het implementeren van deze servercertificaten zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt samengevat waar het door de CA ondertekende openbare servercertificaat in deze drie gevallen moet worden geladen:

De openbaar ondersteunde certificeringsinstanties die door de Webex-app worden ondersteund voor verificatie, worden weergegeven in Ondersteunde certificeringsinstanties voor hybride Webex-services.

Vereisten voor TLS-certificaat voor TLS-bridge Proxy

  • Het openbaar ondertekende servercertificaat wordt in de proxy geladen.

  • De proxy presenteert dit openbaar ondertekende servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • Een intern door een certificeringsinstantie ondertekend certificaat kan op de XSP|ADP worden geladen.

  • De XSP|ADP legt dit intern ondertekende servercertificaat voor aan de proxy.

  • De proxy vertrouwt de interne CA die het XSP|ADP-servercertificaat heeft ondertekend.

TLS-certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ

  • Het openbaar ondertekende servercertificaat wordt geladen in de XSP|ADP's.

  • De XSP|ADP's presenteren openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP|ADP's heeft ondertekend.

Aanvullende certificaatvereisten voor wederzijdse TLS-verificatie via de CTI-interface

Wanneer u verbinding maakt met de CTI-interface, presenteert Webex een clientcertificaat als onderdeel van wederzijdse TLS-verificatie. Het CA-/kettingcertificaat van het Webex-clientcertificaat kan worden gedownload via Control Hub.

Het certificaat downloaden:

Meld u aan bij Partner Hub en ga naar Instellingen > BroadWorks Calling en klik op de koppeling voor het downloaden van het certificaat.

De exacte vereisten voor het implementeren van deze Webex CA-certificaatketen zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

Het volgende diagram geeft een samenvatting van de certificaatvereisten in deze drie gevallen:

mTLS-certificaatuitwisseling voor CTI via verschillende Edge-configuraties

(Optie) Certificaatvereisten voor TLS-bridge Proxy

  • Webex presenteert een openbaar ondertekend clientcertificaat aan de proxy.

  • De proxy vertrouwt de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de vertrouwensopslag van de proxy. Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de proxy geladen.

  • De proxy presenteert het openbaar ondertekende servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • De volmachthebber legt een intern ondertekend clientcertificaat voor aan de XSP|ADP’s.

    Dit certificaat moet het uitbreidingsveld Extended Key Usage van x509.v3 bevatten met het BroadWorks-OID-doel 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS-clientAuth. Bijv.:

    X509v3 extensions:
        X509v3 Extended Key Usage:
            1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication

    De CN van het interne certificaat moet bwcticlient.webex.com.


     
    • Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

    • Openbare certificeringsinstanties zijn mogelijk niet bereid om certificaten te ondertekenen met het vereiste bedrijfseigen BroadWorks-OID. In het geval van een overbruggingsproxy moet u mogelijk een interne CA gebruiken om het clientcertificaat dat de proxy aanbiedt aan de XSP|ADP te ondertekenen.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP’s presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

  • De ClientIdentity van de toepassingsserver bevat de CN van het intern ondertekende clientcertificaat dat door de proxy wordt voorgelegd aan de XSP|ADP.

(Optie) Certificaatvereisten voor TLS-passthrough Proxy of XSP|ADP in DMZ

  • Webex presenteert een door een interne CA ondertekend Cisco-clientcertificaat aan de XSP|ADP's.

  • De XSP|ADP's vertrouwen de interne Cisco-CA die het clientcertificaat heeft ondertekend. U kunt deze CA/keten downloaden van Control Hub en deze toevoegen aan de vertrouwensopslag van de proxy. Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de XSP|ADP's geladen.

  • De XSP|ADP's presenteren de openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP|ADP's heeft ondertekend.

  • De Application Server ClientIdentity bevat de algemene naam van het door Cisco ondertekende clientcertificaat dat door Webex wordt aangeboden aan de XSP|ADP.

Uw netwerk voorbereiden

Zie voor meer informatie over verbindingen die worden gebruikt door Webex voor Cisco BroadWorks: Netwerkvereisten voor Webex voor Cisco BroadWorks. Dit artikel bevat de lijst met IP-adressen, poorten en protocollen die vereist zijn om de ingress- en egress-regels van uw firewall te configureren.

Netwerkvereisten voor Webex-services

De voorgaande firewalltabellen met ingress- en exress-regels documenteren alleen de verbindingen die specifiek zijn voor Webex voor Cisco BroadWorks. Zie Netwerkvereisten voor Webex-services voor algemene informatie over verbindingen tussen de Webex-app en de Webex-cloud. Dit artikel is algemeen voor Webex, maar in de volgende tabel worden de verschillende gedeelten van het artikel aangegeven en wordt aangegeven hoe relevant elk gedeelte is voor Webex voor Cisco BroadWorks.

Tabel 3. Netwerkvereisten voor verbindingen met de Webex-app (algemeen)

Deel van artikel over netwerkvereisten

Relevantie van informatie

Overzicht van door Webex ondersteunde apparaattypen en protocollen

Informatief

Transportprotocollen en versleutelingscodes voor cloudgeregistreerde Webex-apps en -apparaten

Informatief

Webex-services - Poortnummers en protocollen

Moet gelezen worden

IP-subnetten voor Webex-mediaservices

Moet gelezen worden

Domeinen en URL's die toegankelijk moeten zijn voor Webex-services

Moet gelezen worden

Aanvullende URL's voor hybride Webex-services

Optioneel

Proxyfuncties

Optioneel

802.1X: netwerktoegangsbeheer op basis van poorten

Optioneel

Netwerkvereisten voor SIP-gebaseerde Webex-services

Optioneel

Netwerkvereisten voor Webex Edge Audio

Optioneel

Een overzicht van andere hybride Webex-services en documentatie

Optioneel

Webex-services voor FedRAMP-klanten

N.v.t.

Aanvullende informatie

Zie Firewall-whitepaper van de Webex-app (PDF) voor meer informatie.

Ondersteuning voor redundantie van BroadWorks

De Webex-cloudservices en de Webex-clientapps die toegang moeten krijgen tot het netwerk van de partner ondersteunen volledig de Broadworks XSP|ADP-redundantie die door de partner wordt geboden. Wanneer een XSP|ADP of site niet beschikbaar is voor gepland onderhoud of ongeplande reden, kunnen de Webex-services en -apps doorschakelen naar een andere XSP|ADP of site die door de partner wordt geleverd om een verzoek te voltooien.

Netwerktopologie

De Broadworks XSP|ADP's kunnen rechtstreeks op het internet worden geïmplementeerd of kunnen zich in een DMZ bevinden met een load balancing-element zoals de F5 BIG-IP. Om geo-redundantie te bieden, kunnen de XSP|ADP's worden geïmplementeerd in twee (of meer) datacenters, elk met een load balancer, elk met een openbaar IP-adres. Als de XSP|ADP's zich achter een load balancer bevinden, zien de Webex-microservices en -app alleen het IP-adres van de load balancer en lijkt Broadworks slechts één XSP|ADP te hebben, zelfs als er meerdere XSP|ADP's achter zitten.

In het onderstaande voorbeeld worden de XSP|ADP's geïmplementeerd op twee sites, Site A en Site B. Op elke site zijn er twee XSP|ADP's, voorafgegaan door een lastbalancer. Site A heeft XSP|ADP1 en XSP|ADP2 voor LB1, en Site B heeft XSP|ADP3 en XSP|ADP4 voor LB2. Alleen de lastbalancers worden op het openbare netwerk weergegeven en de XSP|ADP's bevinden zich in de privénetwerken van DMZ.

Webex-cloudservices

DNS-configuratie

De microservices van Webex Cloud moeten de Broadworks XSP|ADP-server(s) kunnen vinden om verbinding te maken met de Xsi-interfaces, de verificatieservice en CTI.

Webex Cloud-microservices voeren DNS A/AAAA-zoekopdrachten uit voor de geconfigureerde XSP|ADP-hostnaam en maken verbinding met het geretourneerde IP-adres. Dit kan een load balancing edge-element zijn, of de XSP|ADP-server zelf. Als er meerdere IP-adressen worden geretourneerd, wordt het eerste IP in de lijst geselecteerd. SRV-zoekopdrachten worden momenteel niet ondersteund.

Voorbeeld: De DNS van de partner A Record voor ontdekking van Round-Robin gebalanceerde internet-gerichte XSP|ADP-server/load balancers.

Recordtype

Naam

Doel

Doel

A

webex-cloud-xsp.example.com

198.51.100.48

Verwijst naar LB1 (Site A)

A

webex-cloud-xsp.example.com

198.51.100.49

Verwijst naar LB2 (Site B)


 

Elke verwijzing naar XSP omvat XSP of ADP.

Failover

Wanneer de Webex-microservices een verzoek naar de XSP|ADP/Load Balancer verzenden en het verzoek mislukt, kunnen er verschillende dingen gebeuren:

  • Als de fout te wijten is aan een netwerkfout (bv.: TCP, SSL) markeren de Webex-microservices het IP als geblokkeerd en voeren ze onmiddellijk een route door naar het volgende IP.

  • Als er een foutcode (HTTP 5xx) wordt geretourneerd, markeren de Webex-microservices het IP als geblokkeerd en voeren ze onmiddellijk een route door naar het volgende IP.

  • Als er binnen 2 seconden geen HTTP-reactie wordt ontvangen, time-out van het verzoek en de Webex-microservices markeren het IP als geblokkeerd en voeren een route door naar het volgende IP.

Elk verzoek wordt 3 keer geprobeerd voordat een storing wordt teruggekoppeld naar de microservice.

Wanneer een IP in de geblokkeerde lijst staat, wordt het niet opgenomen in de lijst met adressen die moet worden geprobeerd bij het verzenden van een aanvraag naar een XSP|ADP. Na een vooraf bepaalde tijdsperiode verloopt een geblokkeerd IP en gaat het terug naar de lijst om te proberen wanneer een ander verzoek wordt gedaan.

Als alle IP-adressen zijn geblokkeerd, probeert de microservice de aanvraag nog steeds te verzenden door willekeurig een IP-adres te selecteren in de geblokkeerde lijst. Als dit is gelukt, wordt dat IP-adres verwijderd uit de geblokkeerde lijst.

Status

De status van de verbinding van de Webex-cloudservices met de XSP|ADP's of load balancers is te zien in Control Hub. Onder een BroadWorks-gesprekscluster wordt een verbindingsstatus weergegeven voor elk van deze interfaces:

  • XSI-acties

  • XSI-gebeurtenissen

  • Verificatieservice

De verbindingsstatus wordt bijgewerkt wanneer de pagina wordt geladen of tijdens invoerupdates. De verbindingsstatussen kunnen zijn:

  • Groen: Wanneer de interface kan worden bereikt op een van de IP's in Een recordzoekopdracht.

  • Rood: Wanneer alle IP's in de A-recordzoekopdracht niet bereikbaar zijn en de interface niet beschikbaar is.

De volgende services gebruiken de microservices om verbinding te maken met de XSP|ADP's en worden beïnvloed door de beschikbaarheid van de XSP|ADP-interface:

  • Aanmelden bij Webex-app

  • Token voor Webex-app vernieuwen

  • Niet-vertrouwde e-mail/zelfactivering

  • Gezondheidscontrole van Broadworks-service

Webex-app

DNS-configuratie

De Webex-app heeft toegang tot de services Xtended Services Interface (XSI-acties en XSI-gebeurtenissen) en Device Management Service (DMS) op de XSP|ADP.

Om de XSI-service te vinden, voert de Webex-app DNS SRV-zoekopdrachten uit voor _xsi-client._tcp.<webex app xsi domain>. De SRV verwijst naar de geconfigureerde URL voor de XSP|ADP-hosts of load balancers voor de XSI-service. Als SRV-zoekopdrachten niet beschikbaar zijn, keert de Webex-app terug naar A/AAAA-zoekopdrachten.

De SRV kan overschakelen op meerdere A/AAAA-doelen. Elke A/AAAA-record moet echter alleen naar één IP-adres worden toegewezen. Als er meerdere XSP|ADP's in een DMZ achter het load balancer/edge-apparaat zijn, moet de load balancer worden geconfigureerd om de sessiepersistentie te behouden en alle verzoeken van dezelfde sessie naar dezelfde XSP|ADP te routeren. We machtigen deze configuratie omdat de XSI-event heartbeats van de client naar dezelfde XSP|ADP moeten gaan die wordt gebruikt om het gebeurteniskanaal op te zetten.


 

In voorbeeld 1 bestaat de A/AAAA-record voor webex-app-XSP|ADP.example.com niet en hoeft deze niet te worden gebruikt. Als uw DNS vereist dat één A/AAAA-record moet worden gedefinieerd, mag slechts 1 IP-adres worden geretourneerd. De SRV moet echter nog steeds worden gedefinieerd voor de Webex-app.

Als de Webex-app de A/AAAA-naam gebruikt die wordt omgezet naar meer dan één IP-adres, of als het load balancer/edge-element geen sessiepersistentie handhaaft, verzendt de client uiteindelijk heartbeats naar een XSP|ADP waar het geen gebeurteniskanaal tot stand heeft gebracht. Dit resulteert in het afbreken van het kanaal en ook in aanzienlijk meer intern verkeer, wat de prestaties van uw XSP|ADP-cluster belemmert.

Omdat de Webex-cloud en de Webex-app verschillende vereisten hebben voor het opzoeken van A/AAAA-opnamen, moet u een afzonderlijke FQDN gebruiken voor toegang tot uw XSP|ADP's voor de Webex-cloud en de Webex-app. Zoals in de voorbeelden wordt weergegeven, gebruikt Webex Cloud Een record webex-cloud-xsp.example.com en de Webex-app gebruikt SRV _xsi-client._tcp.webex-app-xsp.example.com.

Voorbeeld 1: meerdere XSP|ADP's, elk achter afzonderlijke lastbalancers

In dit voorbeeld wijst de SRV naar A-records met elk Een record die naar een andere lastbalancer op een andere locatie wijzen. De Webex-app gebruikt altijd het eerste IP-adres in de lijst en gaat alleen naar de volgende record als de eerste is uitgeschakeld.

Hieronder vindt u een voorbeeld van SRV-records.

Recordtype

Opnemen

Doel

Doel

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc1.example.com

Clientdetectie van Xsi-interface

SRV

_xsi-client._tcp.webex-app-xsp.example.com

xsp-dc2.example.com

Clientdetectie van Xsi-interface

A

xsp-dc1.example.com

198.51.100.48

Verwijst naar LB1 (site A)

A

xsp-dc2.example.com

198.51.100.49

Punten naar LB2 (site B)

Voorbeeld 2: meerdere XSP|ADP's achter één lastbalancer (met TLS-brug)

Voor het eerste verzoek selecteert de load balancer een willekeurige XSP|ADP. XSP|ADP retourneert een cookie dat de Webex-app in toekomstige verzoeken bevat. Voor toekomstige verzoeken gebruikt de load balancer de cookie om de verbinding naar de juiste XSP|ADP te routeren, zodat het gebeurteniskanaal niet wordt verbroken.

Recordtype

Opnemen

Doel

Doel

SRV

_xsi-client._tcp.webex-app-xsp.example.com

LB.example.com

Lastbalancer

A

LB.voorbeeld.com

198.51.100.83

IP-adres van load balancer (XSP|ADP's bevinden zich achter load balancer)

URL DMS

Tijdens het aanmeldproces haalt de Webex-app ook de DMS-URL op om het configuratiebestand te downloaden. De host in de URL wordt geparseerd en de Webex-app voert DNS A/AAAA-zoekopdrachten uit van de host om verbinding te maken met de XSP|ADP die de DMS-service host.

Voorbeeld: DNS Een record voor het ontdekken van Round-Robin gebalanceerde internet-gerichte XSP|ADP-server/load balancers door de Webex-app om configuratiebestanden te downloaden via DMS:

Recordtype

Naam

Doel

Doel

A

xsp-dms.example.com

198.51.100.48

Verwijst naar LB1 (site A)

A

xsp-dms.example.com

198.51.100.49

Punten naar LB2 (site B)


 
Elke verwijzing naar XSP omvat XSP of ADP.
Hoe de Webex-app XSP|ADP-adressen vindt

De client probeert de XSP|ADP-knooppunten te vinden met behulp van de volgende DNS-flow:

  1. De client haalt aanvankelijk URL's voor Xsi-acties/Xsi-Events op uit de Webex-cloud (u hebt deze ingevoerd bij het maken van het gekoppelde BroadWorks-gesprekscluster). De Xsi-hostnaam/het Xsi-domein wordt geparseerd vanaf de URL en de client voert de SRV-zoekopdracht als volgt uit:

    1. De client voert een SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">

    2. Als de SRV-zoekopdracht een of meer A/AAAA-doelen retourneert:

      1. De client zoekt A/AAAA op voor deze doelen en slaat de geretourneerde IP-adressen in de cache.

      2. De client maakt verbinding met een van de doelen (en dus de A/AAAA-record met één IP-adres) op basis van de SRV-prioriteit, vervolgens het gewicht (of willekeurig als ze allemaal gelijk zijn).

    3. Als de SRV-zoekopdracht geen doelen retourneert:

      De client zoekt A/AAAA op van de Xsi-hoofdparameter en probeert vervolgens verbinding te maken met het geretourneerde IP-adres. Dit kan een load balancing edge-element zijn, of de XSP|ADP-server zelf.

      Zoals vermeld, moet de A/AAAA-record om dezelfde redenen worden omgezet naar één IP-adres.

  2. (Optioneel) U kunt vervolgens aangepaste XSI-acties/XSI-gebeurtenissen opgeven in de apparaatconfiguratie voor de Webex-app, met behulp van de volgende tags:

    <protocols>
    	<xsi>
    		<paths>
    			<root>%XSI_ROOT_WXT%</root>
    			<actions>%XSI_ACTIONS_PATH_WXT%</actions>
    			<events>%XSI_EVENTS_PATH_WXT%</events>
    		</paths>
    	</xsi>
    </protocols>
    1. Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.

    2. Als deze bestaan, vergelijkt de client met het oorspronkelijke XSI-adres dat hij heeft ontvangen via de BroadWorks-clusterconfiguratie.

    3. Als er een verschil wordt gedetecteerd, initialiseert de client de XSI-acties/ XSI Events-verbinding opnieuw. De eerste stap hierin is om hetzelfde DNS-opzoekproces uit te voeren dat wordt vermeld onder stap 1. Dit keer wordt een zoekopdracht aangevraagd voor de waarde in de parameter %XSI_ROOT_WXT% vanuit het configuratiebestand.


       
      Zorg ervoor dat u de bijbehorende SRV-records maakt als u deze tag gebruikt om de Xsi-interfaces te wijzigen.
Failover

Tijdens het aanmelden voert de Webex-app een DNS SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">, stelt een lijst met hosts op en maakt verbinding met een van de hosts op basis van de SRV-prioriteit en vervolgens het gewicht. Deze verbonden host wordt de geselecteerde host voor alle toekomstige aanvragen. Er wordt vervolgens een gebeurteniskanaal geopend voor de geselecteerde host en er wordt regelmatig een hartslag verzonden om het kanaal te verifiëren. Alle aanvragen die na de eerste worden verzonden, bevatten een cookie dat wordt geretourneerd in de HTTP-respons. Daarom is het belangrijk dat de load balancer de sessiepersistentie (affiniteit) behoudt en altijd aanvragen naar dezelfde backend XSP|ADP-server verzendt.

Als een verzoek of een heartbeat-verzoek aan een host mislukt, kunnen er verschillende dingen gebeuren:

  • Als de fout het gevolg is van een netwerkfout (bijv. TCP, SSL) gaat de route van de Webex-app onmiddellijk door naar de volgende host in de lijst.

  • Als er een foutcode (HTTP 5xx) wordt geretourneerd, markeert de Webex-app dat IP-adres als geblokkeerd en leidt deze door naar de volgende host in de lijst.

  • Als er niet binnen een bepaalde periode een reactie wordt ontvangen, wordt het verzoek als mislukt beschouwd vanwege een time-out en worden de volgende verzoeken naar de volgende host verzonden. Het time-outverzoek wordt echter als mislukt beschouwd. Sommige verzoeken worden opnieuw geprobeerd na een fout (met toenemende tijd voor opnieuw proberen). De verzoeken om het veronderstelde niet-vitale niet opnieuw te proberen.

Wanneer een nieuwe host is geprobeerd, wordt deze de nieuwe geselecteerde host als de host aanwezig is in de lijst. Nadat de laatste host in de lijst is geprobeerd, rolt de Webex-app over naar de eerste.

In het geval van heartbeat, als er twee opeenvolgende mislukte verzoeken zijn, initialiseert de Webex-app het gebeurteniskanaal opnieuw.

Houd er rekening mee dat de Webex-app geen fail-back uitvoert en dat DNS-servicedetectie slechts één keer wordt uitgevoerd bij het aanmelden.

Tijdens het aanmelden probeert de Webex-app het configuratiebestand te downloaden via de XSP|ADP/Dms-interface. Het voert een A/AAAA-recordzoekopdracht uit van de host in de opgehaalde DMS-URL en maakt verbinding met het eerste IP. Eerst wordt geprobeerd het verzoek om het configuratiebestand te downloaden te verzenden met een SSO-token. Als dit om welke reden dan ook mislukt, wordt het opnieuw geprobeerd, maar wel met de gebruikersnaam en het wachtwoord van het apparaat.

Webex voor BroadWorks implementeren

Implementatieoverzicht

De volgende diagrammen geven de typische volgorde van uw implementatietaken weer voor de verschillende gebruikersinrichtingsmodi. Veel van de taken zijn gemeenschappelijk voor alle inrichtingsmodi.

Shows the order of tasks required for deploying Webex for BroadWorks with flow-through provisioning and trusted emails
Taken vereist voor het implementeren van doorstroominrichting
Shows the order of tasks required for deploying Webex for BroadWorks with flow-through provisioning without emails
Taken vereist voor het implementeren van flowthrough-inrichting zonder vertrouwde e-mails
Shows the order of tasks required for deploying Webex for BroadWorks with self-activation
Taken vereist voor het implementeren van zelfinrichting van gebruikers

Onboarding van partners voor Webex voor Cisco BroadWorks

Elke Webex voor Cisco BroadWorks-serviceprovider of -reseller moet worden ingesteld als een partnerorganisatie voor Webex voor Cisco BroadWorks. Als u een bestaande Webex-partnerorganisatie hebt, kan dit worden gebruikt.

Om de noodzakelijke onboarding te voltooien, moet u uw Webex Cisco BroadWorks-papierwerk uitvoeren en moeten nieuwe partners de online overeenkomst voor indirecte kanaalpartners (ICPA) accepteren. Wanneer deze stappen zijn voltooid, maakt Cisco Compliance een nieuwe partnerorganisatie in Partner Hub (indien nodig) en verzendt een e-mail met verificatiegegevens naar de beheerder van uw administratie. Tegelijkertijd zal uw Partner Activation en/of Customer Success Program Manager contact met u opnemen om uw onboarding te starten.


 

Webex partners in één regio kunnen klantorganisaties maken in elke regio waarin we de services aanbieden. Voor ondersteuning raadpleegt u: Gegevensresidentie in Webex.

Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's

We vereisen dat de NPS-toepassing op een andere XSP|ADP wordt uitgevoerd. Vereisten voor die XSP|ADP worden beschreven in Gespreksmeldingen configureren vanuit uw netwerk.

U hebt de volgende toepassingen/services nodig op uw XSP|ADP's.

Service/toepassing

Verificatie vereist

Doel van de dienst/toepassing

Xsi-gebeurtenissen

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, servicemeldingen

Xsi-acties

TLS (server verifieert zichzelf bij clients)

Gespreksbeheer, acties

Apparaatbeheer

TLS (server verifieert zichzelf bij clients)

Configuratie voor bellen downloaden

Verificatieservice

TLS (server verifieert zichzelf bij clients)

Gebruikersverificatie

Integratie van computertelefonie

mTLS (client en server verifiëren elkaar)

Telefonieaanwezigheid

Webview-toepassing voor gespreksinstellingen

TLS (server verifieert zichzelf bij clients)

Stelt gespreksinstellingen van gebruikers bloot in de selfcare-portal in de Webex-app

In dit gedeelte wordt beschreven hoe u de vereiste configuraties voor TLS en mTLS op deze interfaces kunt toepassen, maar u moet de bestaande documentatie raadplegen om de toepassingen op uw XSP|ADP's te laten installeren.

Vereisten co-residentie

  • De verificatieservice moet co-resident zijn met Xsi-toepassingen, omdat deze interfaces langdurige tokens voor serviceautorisatie moeten accepteren. De verificatieservice is vereist om deze tokens te valideren.

  • De verificatieservice en Xsi kunnen indien nodig op dezelfde poort worden uitgevoerd.

  • U kunt de andere services/toepassingen scheiden zoals vereist voor uw weegschaal (bijvoorbeeld dedicated device management XSP|ADP farm).

  • U kunt de Xsi-, CTI-, Authenticatieservice- en DMS-toepassingen co-lokaliseren.

  • Installeer geen andere toepassingen of services op de XSP|ADP's die worden gebruikt voor de integratie van BroadWorks met Webex.

  • Zoek de NPS-toepassing niet samen met andere toepassingen.

Xsi-interfaces

Installeer en configureer de Xsi-Actions- en Xsi-Events-toepassingen zoals beschreven in de Configuratiehandleiding voor Cisco BroadWorks Xtended Services Interface.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Voor alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moet dezelfde callControlApplicationName zijn gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker is geïntegreerd in Webex, maakt Webex een abonnement voor de gebruiker op de AS om telefoniegebeurtenissen te ontvangen voor aanwezigheid en gespreksgeschiedenis. Het abonnement is gekoppeld aan de callControlApplicationName en de AS gebruikt het om te weten naar welke Xsi-Events de telefonie-gebeurtenissen moeten worden verzonden.


 

Het wijzigen van de callControlApplicationName of het niet hebben van dezelfde naam op alle Xsi-Events-webapps zal invloed hebben op abonnementen en telefonie gebeurtenissen functionaliteit.

Verificatieservice configureren (met CI-tokenvalidatie)

Gebruik deze procedure om de verificatieservice te configureren voor het gebruik van CI-tokenvalidatie met TLS. Deze verificatiemethode wordt aanbevolen als u R22 of hoger gebruikt en uw systeem deze ondersteunt.


 

Wederzijdse TLS (mTLS) wordt ook ondersteund als een alternatieve verificatiemethode voor de verificatieservice. Als u meerdere Webex-organisaties op dezelfde XSP|ADP-server hebt uitgevoerd, moet u mTLS-verificatie gebruiken omdat CI-tokenvalidatie niet meerdere verbindingen met dezelfde XSP|ADP-verificatieservice ondersteunt.

Als u mTLS-verificatie wilt configureren voor de verificatieservice in plaats van CI-tokenvalidatie, raadpleegt u de bijlage voor Services configureren (met mTLS voor de verificatieservice).


 
Als u momenteel mTLS gebruikt voor de verificatieservice, is het niet verplicht om opnieuw te configureren voor het gebruik van CI-tokenvalidatie met TLS.
  1. Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.

  2. Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw versie:


     
    Elke verwijzing naar XSP omvat XSP of ADP.
  3. Installeer de AuthenticationService toepassing op elke XSP|ADP-service.

    1. Voer de volgende opdracht uit om de AuthenticationService-toepassing op de XSP|ADP te activeren op het contextpad /authService.

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
    2. Voer deze opdracht uit om de AuthenticationService te implementeren op de XSP|ADP:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
  4. Vanaf Broadworks build 2022.10 worden de certificerende autoriteiten die met Java komen niet meer automatisch opgenomen in de BroadWorks-vertrouwensopslag wanneer wordt overgeschakeld naar een nieuwe versie van java. De AuthenticationService opent een TLS-verbinding met Webex om het toegangstoken op te halen en moet het volgende in de truststore hebben om de IDBroker- en Webex-URL te valideren:

    • IdenTrust commercieel hoofd-CA 1

    • GoDaddy Root Certification Authority - G2

    Controleer of deze certificaten aanwezig zijn onder de volgende CLI

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

    Als dit niet aanwezig is, voert u de volgende opdracht uit om de standaard Java-trusts te importeren:

    ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

    U kunt deze certificaten ook handmatig toevoegen als vertrouwensankers met de volgende opdracht:

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

    Als de ADP is geüpgraded vanaf een vorige release, worden de certificeringsinstanties van de oude release automatisch geïmporteerd naar de nieuwe release en blijven ze geïmporteerd totdat ze handmatig worden verwijderd.


     

    De toepassing AuthenticationService is vrijgesteld van de instelling validatePeerIdentity onder ADP_CLI/System/SSLCommonSettings/GeneralSettings en valideert altijd de peer Identity. Zie de Cisco Broadworks X509 Certificate Validation FD voor meer informatie over deze instelling.

  5. Configureer de identiteitsproviders door de volgende opdrachten uit te voeren op elke XSP|ADP-server:

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

    • set clientId client-Id-From-Step1

    • set enabled true

    • set clientSecret client-Secret-From-Step1

    • set ciResponseBodyMaxSizeInBytes 65536

    • set issuerName <URL> —Voor de URL voer de URL van de IssuerName in die van toepassing is op uw CI-cluster. Zie volgende tabel.

    • set issuerUrl <URL> —Voor de URL voer de IssuerUrl in die van toepassing is op uw CI-cluster. Zie de volgende tabel.

    • set tokenInfoUrl <IdPProxy URL> —Voer de IdP-proxy-URL in die van toepassing is op uw Teams-cluster. Zie de tweede tabel die volgt.

    Tabel 1. Naam en URL van uitgever instellen
    Als CI-cluster is...Naam en URL van uitgever instellen op...

    US-A

    https://idbroker.webex.com/idb

    EU

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

    US-B

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


     
    Als u uw CI-cluster niet kent, kunt u de informatie verkrijgen via de klantgegevens in de helpdeskweergave van Control Hub.
    Tabel 2. TokenInfoURL instellen
    Als het Teams-cluster...TokenInfoURL instellen op... (IdP proxy-URL)

    ACHM, WATERPIJP

    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

    AASAPPEL

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


     
    • Als u uw Teams-cluster niet kent, kunt u de informatie verkrijgen via de klantgegevens in de helpdeskweergave van Control Hub.

    • Voor tests kunt u controleren of de tokenInfoURL geldig is door de " idp/authenticate" gedeelte van de URL met " ping".

  6. Geef de Webex-rechten op die aanwezig moeten zijn in het gebruikersprofiel in Webex door de volgende opdracht uit te voeren:

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

  7. Configureer identiteitsproviders voor Cisco Federation met de volgende opdrachten op elke XSP|ADP-server:

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

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

    • set refreshPeriodInMinutes 60

    • set refreshToken refresh-Token-From-Step1

  8. Voer de volgende opdracht uit om te valideren dat uw FLS-configuratie werkt. Met deze opdracht keert u de lijst met identiteitsproviders terug:

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

  9. Configureer Tokenbeheer met de volgende opdrachten op elke XSP|ADP-server:

    • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

    • set tokenIssuer BroadWorks

    • set tokenDurationInHours 720

  10. RSA-sleutels genereren en delen. U moet sleutels genereren op één XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's. Dit is te wijten aan de volgende factoren:

    • U moet dezelfde openbare/privésleutelparen gebruiken voor tokencodering/decodering in alle instanties van de verificatieservice.

    • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet uitgeven.


     
    Als u met de toetsen gaat fietsen of de lengte van de toetsen wijzigt, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw starten.
    1. Selecteer één XSP|ADP om een sleutelpaar te genereren.

    2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen in de browser van de client:

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

      (Dit genereert een privaat/openbaar sleutelpaar op de XSP|ADP, als dat er nog niet was)

    3. De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:

      XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere .keys bestand indien nodig.

    5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

  11. Geef de authService-URL op aan de webcontainer. De webcontainer van de XSP|ADP heeft de authService-URL nodig zodat deze tokens kan valideren. Op elk van de XSP|ADP's:

    1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het communicatiehulpprogramma BroadWorks:

      XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

    2. Voeg de URL van de verificatieservice toe aan de container:

      XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

      Hiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.

    3. Controleer de parameter met get.

    4. Start de XSP|ADP opnieuw op.

Clientverificatievereiste voor verificatieservice verwijderen (alleen R24)

Als u de verificatieservice met CI-tokenvalidatie op R24 hebt geconfigureerd, moet u ook de clientverificatievereiste voor de verificatieservice verwijderen. Voer de volgende CLI-opdracht uit:

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

TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)

De toepassingen Verificatieservice, Xsi-acties en Xsi-Events maken gebruik van HTTP-serverinterfaces. De TLS-configureerbaarheidsniveaus voor deze toepassingen zijn als volgt:

Meest algemeen = Systeem > Transport > HTTP > HTTP Server interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit CLI-context
Systeem (globaal)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze veilig zijn en of ze clientverificatie vereisen.

Apache tomcat vereist een certificaat voor elke veilige interface; het systeem genereert een zelfondertekend certificaat als dit nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2-protocol toevoegen aan de HTTP-serverinterface

De HTTP-interface die communiceert met de Webex-cloud moet zijn geconfigureerd voor TLSv1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren in de interface van de HTTP-server:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken in de HTTP-serverinterface

De vereiste cijfers configureren:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de interface van de HTTP-server.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 in de interface van de HTTP-server gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver

Profielserver en XSP|ADP zijn verplicht voor apparaatbeheer. Ze moeten worden geconfigureerd volgens de instructies in de configuratiehandleiding voor BroadWorks-apparaatbeheer.

CTI-interface en gerelateerde configuratie

De configuratievolgorde 'maximaal' wordt hieronder weergegeven. Het volgen van deze bestelling is niet verplicht.

  1. Toepassingsserver configureren voor CTI-abonnementen

  2. XSP|ADP's configureren voor mTLS geverifieerde CTI-abonnementen

  3. Inkomende poorten openen voor veilige CTI-interface

  4. Abonneer uw Webex-organisatie op BroadWorks CTI-gebeurtenissen

Toepassingsserver configureren voor CTI-abonnementen

Werk de ClientIdentity op de toepassingsserver bij met de algemene naam (CN) van het Webex voor Cisco BroadWorks CTI-clientcertificaat.

Voeg voor elke toepassingsserver die u met Webex gebruikt de certificaatidentiteit als volgt toe aan de ClientIdentity:

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


 

De algemene naam van het Webex voor Cisco BroadWorks-clientcertificaat is bwcticlient.webex.com.

TLS en cijfers configureren op de CTI-interface

De configureerbaarheidsniveaus voor de XSP|ADP CTI-interface zijn als volgt:

Meest algemeen = Systeem > Transport > CTI Interfaces > CTI interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit

CLI-context

Systeem (globaal)

(R22 en hoger)

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

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

Transportprotocollen voor dit systeem

(R22 en hoger)

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

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

Alle CTI-interfaces op dit systeem

(R22 en hoger)

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

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

Een specifieke CTI-interface op dit systeem

(R22 en hoger)

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

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


 

Bij een nieuwe installatie worden de volgende versleutelingen standaard op systeemniveau geïnstalleerd. Als er niets is geconfigureerd op het interfaceniveau (bijvoorbeeld op de CTI-interface of HTTP-interface), is deze coderingslijst van toepassing. Houd er rekening mee dat deze lijst in de loop der tijd kan veranderen:

  • TLS_ECDHE_RSA_MET_AES_128_GCM_SHA256

  • TLS_ECDHE_ECDSA_MET_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_MET_AES_128_CBC_SHA256

  • TLS_ECDHE_ECDSA_MET_AES_128_CBC_SHA256

  • TLS_DHE_DSS_MET_AES_128_GCM_SHA256

  • TLS_DHE_RSA_MET_AES_128_GCM_SHA256

  • TLS_DHE_RSA_MET_AES_128_CBC_SHA256

  • TLS_DHE_DSS_MET_AES_128_CBC_SHA256

  • TLS_ECDH_RSA_MET_AES_128_GCM_SHA256

  • TLS_ECDH_ECDSA_MET_AES_128_GCM_SHA256

  • TLS_ECDH_RSA_MET_AES_128_CBC_SHA256

  • TLS_ECDH_ECDSA_MET_AES_128_CBC_SHA256

CTI TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze een servercertificaat vereisen en of ze clientverificatie vereisen.

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

TLS 1.2-protocol toevoegen aan de CTI-interface

De XSP|ADP CTI-interface die communiceert met de Webex-cloud moet worden geconfigureerd voor TLS v1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren op de CTI-interface:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken op de CTI-interface

De vereiste cijfers configureren voor de CTI-interface:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Voer de get opdracht om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> <cipherName> om een code toe te voegen aan de CTI-interface.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 naar de CTI-interface gebruikt u: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Vertrouwensankers voor CTI-interface (R22 en hoger)

Bij deze procedure wordt ervan uitgegaan dat de XSP|ADP's ofwel naar het internet gericht zijn ofwel naar het internet gericht zijn via pass-through proxy. De certificaatconfiguratie is anders voor een brugproxy (zie TLS-certificaatvereisten voor TLS-brugproxy).

Ga als volgt te werk voor elke XSP|ADP in uw infrastructuur die CTI-gebeurtenissen publiceert in Webex:

  1. Aanmelden bij Partnerhub .

  2. Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om CombinedCertChain2023.txt op uw lokale computer.


     

    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze uploadt naar de XSP|ADP's. Alle bestanden zijn vereist.

  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE----- en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één tekstblok bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt

  5. Meld u aan bij de XSP|ADP en ga naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Optioneel) Uitvoeren help updateTrust om de parameters en opdrachtindeling weer te geven.

  7. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 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


     

    Alle aliassen moeten een andere naam hebben. webexclientroot2023 en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang alle ingangen uniek zijn.

  8. Bevestig dat de ankers zijn bijgewerkt:

    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. Clients toestaan te verifiëren met certificaten:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

CTI-interface toevoegen en mTLS inschakelen

  1. Voeg de CTI SSL-interface toe.

    De CLI-context is afhankelijk van uw BroadWorks-versie. De opdracht maakt een zelfondertekend servercertificaat in de interface en dwingt de interface om een clientcertificaat te vereisen.

    • Op BroadWorks R22 en R23:

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

  2. Vervang het servercertificaat en de sleutel op de CTI-interfaces van XSP|ADP. U hebt hiervoor het IP-adres van de CTI-interface nodig; u kunt dit lezen uit de volgende context:

    • Op BroadWorks R22 en R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Voer vervolgens de volgende opdrachten uit om het zelfondertekende certificaat van de interface te vervangen door uw eigen certificaat en privésleutel:

      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. Start de XSP|ADP opnieuw op.

Toegang tot BroadWorks CTI-gebeurtenissen inschakelen in Webex

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters configureert in Partner Hub. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters configureert in Partner Hub. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

  • Geef het CTI-adres op waarmee Webex zich kan abonneren op BroadWorks CTI Events.

  • CTI-abonnementen zijn per abonnee en worden alleen ingesteld en onderhouden terwijl die abonnee is ingericht voor Webex voor Cisco BroadWorks.

Webweergave Gespreksinstellingen

Call Settings Webview (CSWV) is een toepassing die wordt gehost op XSP|ADP zodat gebruikers hun BroadWorks-gespreksinstellingen kunnen wijzigen via een webview die ze in de softclient zien. Zie de Handleiding voor webview-oplossingen voor Cisco BroadWorks-gespreksinstellingen.

Webex maakt gebruik van deze functie om gebruikers toegang te geven tot algemene BroadWorks-gespreksinstellingen die niet eigen zijn aan de Webex-app.

Als u wilt dat uw Webex voor Cisco BroadWorks-abonnees toegang hebben tot gespreksinstellingen die verder gaan dan de standaardinstellingen die beschikbaar zijn in de Webex-app, moet u de functie Webview voor gespreksinstellingen implementeren.

De webview Gespreksinstellingen heeft twee onderdelen:

  • Webview-toepassing voor gespreksinstellingen, gehost op een Cisco BroadWorks XSP|ADP.

  • De Webex-app, die de gespreksinstellingen in een Webview weergeeft.

Gebruikerservaring

  • Windows-gebruikers: Klik op Gespreksinstellingen en klik vervolgens op Gespreksvoorkeuren openen > Geavanceerde gespreksinstellingen.

  • Mac-gebruikers: Klik op profielfoto en vervolgens op Voorkeuren > Geavanceerde gespreksinstellingen.

CSWV implementeren op BroadWorks

Webview Gespreksinstellingen installeren op XSP|ADP's

CSWV-toepassing moet zich op dezelfde XSP|ADP('s) bevinden als de host van de Xsi-Actions-interface in uw omgeving. Het is een onbeheerde toepassing op XSP|ADP, dus u moet een webarchiefbestand installeren en implementeren.

  1. Meld u aan bij cisco.com en zoek naar 'BWCallSettingsWeb' in het gedeelte software downloaden.

  2. Zoek en download de meest recente versie van het bestand.

    Bijvoorbeeld: BWCallSettingsWeb_1.8.2_1.war( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) was op het moment van schrijven het meest recent.

  3. Installeer, activeer en implementeer het webarchief volgens de configuratiehandleiding voor Cisco BroadWorks Xtended Service Platform voor uw XSP|ADP-versie. (Versie R24 is https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).

    1. Kopieer het .war-bestand naar een tijdelijke locatie op de XSP|ADP, zoals /tmp/.

    2. Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:

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

      De BroadWorks-softwaremanager valideert en installeert het bestand.

    3. [Optioneel] Verwijderen /tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist).

    4. Activeer de toepassing:

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      De naam en versie zijn verplicht voor elke toepassing, maar voor CSWV moet u ook een contextPath opgeven omdat het een onbeheerde toepassing is. U kunt alle waarden gebruiken die niet door een andere toepassing worden gebruikt, bijvoorbeeld: /callsettings.

    5. Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

  4. U kunt nu de URL voor gespreksinstellingen die u voor clients opgeeft, als volgt voorspellen:

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

    Opmerkingen:

    • U moet de trailing slash op deze URL opgeven wanneer u deze invoert in het clientconfiguratiebestand.

    • De XSP|ADP-FQDN moet overeenkomen met de FQDN voor Xsi-acties, omdat CSWV Xsi-acties moet gebruiken en CORS niet wordt ondersteund.

  5. Herhaal deze procedure voor andere XSP|ADP's in uw Webex voor Cisco BroadWorks-omgeving (indien nodig).

De toepassing Gespreksinstellingen Webview is nu actief op de XSP|ADP's.

Configureer de Webex-app om de webview met gespreksinstellingen te gebruiken

Zie de Webex voor Cisco BroadWorks-configuratiehandleiding voor meer informatie over clientconfiguratie.

Er is een aangepaste tag in het configuratiebestand van de Webex-app die u kunt gebruiken om de CSWV-URL in te stellen. Deze URL toont de gespreksinstellingen aan de gebruikers via de toepassingsinterface.

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

Configureer in de configuratiesjabloon van de Webex-app op BroadWorks de CSWV-URL in de tag %WEB_CALL_SETTINGS_URL_WXT%.

Als u de URL niet expliciet opgeeft, is de standaard leeg en is de pagina met gespreksinstellingen niet zichtbaar voor de gebruikers.

  1. Zorg ervoor dat u over de nieuwste configuratiesjablonen voor de Webex-app beschikt (zie Apparaatprofielen).

  2. Het doel voor webgespreksinstellingen instellen op csw:

    %WEB_CALL_SETTINGS_TARGET_WXT% csw

  3. Stel de URL voor webgespreksinstellingen voor uw omgeving in, bijvoorbeeld:

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

    U hebt deze waarde afgeleid bij het implementeren van de CSWV-toepassing.

  4. Het resulterende clientconfiguratiebestand moet als volgt worden ingevoerd:

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

     
    Elke verwijzing naar XSP omvat XSP of ADP.

Pushmeldingen voor gesprekken configureren in Webex voor Cisco BroadWorks

In dit document gebruiken we de term Call Notifications Push Server (CNPS) om een door XSP gehoste of door ADP gehoste toepassing te beschrijven die in uw omgeving wordt uitgevoerd. Uw CNPS werkt met uw BroadWorks-systeem om op de hoogte te zijn van binnenkomende gesprekken naar uw gebruikers en pusht meldingen van deze gesprekken naar de meldingsservices van Google Firebase Cloud Messaging (FCM) of Apple Push Notification Service (APN's).

Deze services melden de mobiele apparaten van Webex voor Cisco BroadWorks-abonnees dat ze inkomende gesprekken hebben op Webex.

Zie de functiebeschrijving van de pushserver voor meldingen voor meer informatie over NPS.

Een vergelijkbaar mechanisme in Webex werkt met Webex-berichten- en aanwezigheidsservices om meldingen naar de Google- (FCM) of Apple-meldingsservices (APNS) te pushen. Deze services brengen de mobiele Webex-gebruikers op hun beurt op de hoogte van inkomende berichten of aanwezigheidswijzigingen.


 

In dit gedeelte wordt beschreven hoe u NPS configureert voor de verificatieproxy wanneer de NPS nog geen andere apps ondersteunt. Als u een gedeelde NPS moet migreren om NPS-proxy te gebruiken, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruikenhttps://help.webex.com/nl5rir2/.

Overzicht van NPS-proxy

Voor compatibiliteit met Webex voor Cisco BroadWorks moet uw CNPS worden gepatcht ter ondersteuning van de NPS-proxyfunctie, Pushserver voor VoIP in UCaaS.

De functie implementeert een nieuw ontwerp in de pushserver voor meldingen om het beveiligingsprobleem van het delen van privésleutels voor pushmeldingscertificaten met serviceproviders voor mobiele clients op te lossen. In plaats van pushmeldingscertificaten en -sleutels te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een kortstondig pushmeldingstoken te verkrijgen van Webex voor Cisco BroadWorks-backend en gebruikt dit token voor verificatie met de Apple APN's en Google FCM-services.

De functie verbetert ook de mogelijkheid van de Notification Push Server om meldingen naar Android-apparaten te pushen via de nieuwe Google Firebase Cloud Messaging (FCM) HTTPv1 API.

APNS-overwegingen

Apple zal het op HTTP/1 gebaseerde binaire protocol over de Apple Push Notification-dienst na 31 maart 2021 niet langer ondersteunen. We raden u aan uw XSP|ADP te configureren om de op HTTP/2 gebaseerde interface voor APN's te gebruiken. Voor deze update moet uw XSP|ADP die de NPS host R22 of hoger uitvoeren.

Bereid uw NPS voor op Webex voor Cisco BroadWorks

1

Installeer en configureer een specifieke XSP (minimumversie R22) of Application Delivery Platform (ADP).

2

Installeer de NPS-verificatieproxypatches:

3

Activeer de toepassing Pushserver voor meldingen.

4

(Voor Android-meldingen) Schakel de FCM v1-API in op de NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.

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

6

Voeg een techsupport van de NPS XSP/ADP toe.

7

Op elke AS-server wordt het namedefs-bestand in /usr/local/broadworks/bw_base/conf moet worden geconfigureerd met SRV en A-records voor XSP/ADP-zoekopdrachten (Notification Push Server). Als er meerdere XSP/ADP zijn, voegt u voor elke zoekopdracht een vermelding toe.

Voorbeeld: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN EEN versie van 10.193.78.149


 

Na het instellen is een van de volgende opties vereist om de wijzigingen op te halen:

  1. Een restartbw wordt voorgevormd in een onderhoudsperiode.

  2. Via de Cisco BroadWorks CLI:

    R24 en ouder

    AS_CLI/ASDiagnostic/DNS> opnieuw laden

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> opnieuw laden

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> opnieuw laden

De volgende stappen

Als u een NPS opnieuw wilt installeren, gaat u naar NPS configureren om de verificatieproxy te gebruiken

Als u een bestaande Android-implementatie wilt migreren naar FCMv1, gaat u naar NPS migreren naar FCMv1

Configureer NPS om de verificatieproxy te gebruiken

Deze taak is van toepassing op een nieuwe installatie van NPS die is toegewezen aan Webex voor Cisco BroadWorks.

Als u de verificatieproxy wilt configureren op een NPS die met andere mobiele apps wordt gedeeld, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken ( https://help.webex.com/nl5rir2).

1

Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.

2

Maak het clientaccount aan op de 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: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get


 

De CiscoCI-uitgeverUrl moet ALTIJD een US CI-cluster zijn, ongeacht uw locatie. De standaardwaarde moet zijn:

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

Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):

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

(Voor Android-meldingen) Voeg de Android-toepassings-id toe aan de context van de FCM-toepassingen op de NPS.

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

5

(Voor Apple iOS-meldingen) Voeg de toepassings-id toe aan de context van de APNS-toepassingen en zorg ervoor dat u de verificatiesleutel weglaat. Stel deze in op leeg.

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

6

Configureer de volgende NPS-URL's:

XSP|ADP CLI-context

Parameter

Waarde

  • XSP|ADP_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|ADP_CLI/Applications/NotificationPushServer

    /APNS/Production>

url

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

7

Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:

XSP|ADP CLI-context

Parameter

Waarde

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen:

  1. Uitvoeren AS_CLI/System/PushNotification> get en controleer de waarde van enforceAllowedApplicationList. Als het true, moet u deze subtaak voltooien. Anders slaat u de rest van de deeltaak 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

Start de XSP|ADP opnieuw: bwrestart

10

Test gespreksmeldingen door gesprekken te voeren van een BroadWorks-abonnee naar twee mobiele Webex-gebruikers. Controleer of de gespreksmelding wordt weergegeven op iOS- en Android-apparaten.

NPS migreren naar FCMv1

Dit onderwerp bevat optionele procedures die u in Google FCM-console kunt gebruiken wanneer u een bestaande NPS-implementatie hebt die u naar FCMv1 moet migreren. Er zijn drie procedures:

UC-One-clients migreren naar FCMv1

Gebruik de onderstaande stappen in Google FCM-console om UC-One-clients te migreren naar Google FCM HTTPv1.


 

Als branding wordt toegepast op de client, moet de client de afzender-id hebben. Zie in de FCM-console Projectinstellingen > Cloud Messaging. De instelling wordt weergegeven in de aanmeldtabel voor het project.

Zie de Connect Mobile Branding Guide op 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? voor meer informatie. Raadpleeg de gcm_defaultSenderId parameter, die zich bevindt in het bestand Branding Kit, Resource folder, branding.xml met de onderstaande syntaxis:

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

  1. Meld u aan bij FCM-beheerder SDK op http://console.firebase.google.com.

  2. Selecteer de juiste Android-toepassing.

  3. Noteer de project-ID op het tabblad Algemeen

  4. Ga naar het tabblad Serviceaccounts om een serviceaccount te configureren. U kunt een nieuw serviceaccount maken of een bestaand serviceaccount configureren.

    Een nieuw serviceaccount maken:

    1. Klik op de blauwe knop om een nieuw serviceaccount aan te maken

    2. Klik op de blauwe knop om een nieuwe privésleutel te genereren

    3. Sleutel downloaden naar een veilige locatie

    Een bestaand serviceaccount hergebruiken:

    1. Klik op de blauwe tekst om bestaande serviceaccounts weer te geven.

    2. Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.

    3. Klik aan de rechterkant op het hamburgermenu en maak een nieuwe privésleutel aan.

    4. Download het json-bestand dat de sleutel bevat en sla het op naar een veilige locatie.

  5. Kopieer het json-bestand naar de XSP|ADP.

  6. Configureer de project-ID en:

    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. Configureer de toepassing:

    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. FCMv1 inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

SaaS-clients migreren naar FCMv1

Gebruik de onderstaande stappen op Google FCM Console als u SaaS-clients wilt migreren naar FCMv1.


 
Zorg ervoor dat u de procedure 'NPS configureren om verificatieproxy te gebruiken' al hebt voltooid.
  1. FCM uitschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

  3. FCM inschakelen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Voer het installatiebestand bwrestart opdracht om de XSP|ADP opnieuw te starten.

ADP-server bijwerken

Gebruik de onderstaande stappen in Google FCM-console als u de NPS migreert om een ADP-server te gebruiken.

  1. Haal het JSON-bestand op van de Google Cloud-console:

    1. Ga op de Google Cloud Console naar de pagina Service Accounts.

    2. Klik op Selecteer een project, kies uw project en klik op Openen.

    3. Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.

    4. Selecteer een type Sleutel en klik op Aanmaken

      Het bestand wordt gedownload.

  2. FCM toevoegen aan de ADP-server:

    1. Importeer het JSON-bestand naar de ADP-server met de /bw/install opdracht.

    2. Meld u aan bij de ADP CLI en voeg project- en API-sleutel toe:

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

    3. Voeg vervolgens de toepassing en de sleutel toe:

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

    4. Controleer de configuratie:

      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

Uw partnerorganisatie configureren in Partner Hub

Uw BroadWorks-clusters configureren

[eenmaal per cluster]

Dit gebeurt om de volgende redenen:

  • Webex-cloud inschakelen om uw gebruikers te verifiëren met BroadWorks (via de door XSP|ADP gehoste verificatieservice).

  • Webex-apps inschakelen om de Xsi-interface te gebruiken voor gespreksbeheer.

  • Webex inschakelen om te luisteren naar door BroadWorks gepubliceerde CTI-gebeurtenissen (telefonische aanwezigheid en gespreksgeschiedenis).


 

De clusterwizard valideert de interfaces automatisch wanneer u ze toevoegt. U kunt de cluster blijven bewerken als een van de interfaces niet is gevalideerd, maar u kunt een cluster niet opslaan als er ongeldige invoer zijn.

We voorkomen dit omdat een onjuist geconfigureerde cluster problemen kan veroorzaken die moeilijk op te lossen zijn.

Wat u moet doen:

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Cluster toevoegen.

    Hiermee start u een wizard waarin u uw XSP|ADP-interfaces (URL's) levert. U kunt een poort toevoegen aan de interface-URL als u een niet-standaardpoort gebruikt.

  4. Geef dit cluster een naam en klik op Volgende.

    Het clusterconcept hier is slechts een verzameling van interfaces, meestal samengebracht op een XSP|ADP-server of -farm, waarmee Webex informatie van uw toepassingsserver (AS) kan lezen. U hebt mogelijk één XSP|ADP per AS-cluster of meerdere XSP|ADP's per cluster of meerdere AS-clusters per XSP|ADP. Schaalvereisten voor uw BroadWorks-systeem vallen hier buiten het bereik.

  5. (Optioneel) Een BroadWorks-gebruiker invoeren Accountnaam en Wachtwoord dat u weet dat u zich in het BroadWorks-systeem bevindt waarmee u verbinding maakt met Webex en klik vervolgens op Volgende.

    De validatietests kunnen dit account gebruiken om de verbindingen met de interfaces in het cluster te valideren.

  6. Voeg uw URL's voor XSI-acties en XSI-gebeurtenissen toe.

  7. Optioneel. Werk de DAS-URL bij met de URL van de apparaatactiveringsservice.

  8. Optioneel. Schakel het selectievakje Directe BroadWorks-verificatie inschakelen in als u wilt dat aanmeldingen bij BroadWorks rechtstreeks naar BroadWorks worden verzonden. Anders wordt verificatie naar BroadWorks via de Webex-gehoste IdP-proxyservice geproxy.

    Dit selectievakje is van invloed op deze aanmeldsituaties:

    • Aanmelding bij de gebruikersactiveringsportal: gebruikers moeten hun BroadWorks-aanmeldgegevens invoeren wanneer ze zich bij de portal aanmelden. De bovenstaande instelling bepaalt of de aanmelding rechtstreeks is naar BroadWorks of via de IdP-proxy.

    • Clientaanmelding: als BroadWorks-verificatie is geconfigureerd in de onboardsjabloon, bepaalt de bovenstaande instelling of de clientaanmelding bij de Webex-app rechtstreeks is naar BroadWorks of wordt geproxy via de IdP-proxy.

  9. Klik op Volgende.

  10. Ga als volgt te werk op de pagina CTI-interface:

    1. Voeg de CTI-URL en poort toe voor de CTI-interface waarmee u verbinding wilt maken.

    2. Optioneel. Schakel de schakelaar Gespreksgeschiedenis in en voer vervolgens uw BroadWorks-gebruikers-id in. Als deze optie is geselecteerd, worden BroadWorks-gespreksgeschiedenisgebeurtenissen gesynchroniseerd met de Webex-cloud. Gebruikers kunnen hun gespreksgeschiedenis bekijken in de Webex-app.

    3. Optioneel. Schakel de schakelaar Niet storen (NST) in en voer vervolgens uw BroadWorks-gebruikers-id in. Met deze optie worden NST-gebeurtenissen tussen Webex en BroadWorks gesynchroniseerd, zodat de functie op beide platforms hetzelfde werkt.

    4. Klik op Volgende.

  11. Voeg de URL van uw verificatieservice toe.

  12. Selecteer Verificatieservice met CI-tokenvalidatie.

    Voor deze optie is niet vereist dat mTLS de verbinding beschermt tegen Webex, omdat de verificatieservice het gebruikerstoken correct valideert met de Webex-identiteitsservice voordat het langlevende token aan de gebruiker wordt verstrekt.

  13. Controleer uw gegevens op het laatste scherm en klik op Maken. U zou een bericht met succes moeten zien.

    Partner Hub geeft de URL's door aan verschillende Webex-microservices die de verbindingen met de geleverde interfaces testen.

  14. Klik op Clusters weergeven en u moet uw nieuwe cluster zien en zien of de validatie is gelukt.

  15. De knop Aanmaken kan worden uitgeschakeld in het laatste (preview)scherm van de wizard. Als u de sjabloon niet kunt opslaan, geeft dit een probleem aan met een van de integraties die u zojuist hebt geconfigureerd.

    Deze controle hebben we doorgevoerd om fouten bij volgende taken te voorkomen. U kunt de wizard opnieuw doorlopen terwijl u uw implementatie configureert. Dit kan wijzigingen aan uw infrastructuur vereisen (bijv. XSP|ADP, load balancer of firewall), zoals beschreven in deze handleiding, voordat u de sjabloon kunt opslaan.

De verbindingen met uw BroadWorks-interfaces controleren

  1. Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.

  2. Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.

  3. Klik op Clusters weergeven.

  4. Partner Hub initieert verbindingstests van de verschillende microservices naar de interfaces in de clusters.

    Nadat de tests zijn voltooid, wordt op de pagina Clusterlijst het statusbericht weergegeven naast elk cluster.

    U moet groene succesberichten zien. Als u een rood foutbericht ziet, klikt u op de betreffende clusternaam om te zien welke instelling het probleem veroorzaakt.

  5. Optioneel. Selecteer een cluster als u bestaande instellingen voor dat cluster wilt zien, zoals XSI-acties, XSI-gebeurtenissen, DAS-URL en de instellingen van de CTI-interface.

Uw integratiesjablonen configureren

Onboardsjablonen zijn de manier waarop u gedeelde configuratie toepast op een of meer klanten terwijl u ze integreert via de inrichtingsmethoden. U moet elke sjabloon koppelen aan een cluster (dat u in het vorige gedeelte hebt gemaakt).

U kunt zoveel sjablonen maken als u nodig hebt, maar er kan slechts één sjabloon aan een klant worden gekoppeld.

  1. Meld u aan bij de Partnerhub en selecteer Klanten.

  2. Klik op de knop Onboarding templates om de bestaande templates te bekijken.

  3. Klik op Template aanmaken.

  4. Voeg in het venster Sjabloondetails de sjabloonnaam, het land of de regio en de standaardtaal van het e-mailadres toe.

  5. Gebruik in het venster Service-instelling de vervolgkeuzelijst Cluster om het cluster te kiezen dat u met deze sjabloon wilt gebruiken.

  6. Voer een sjabloonnaam in en klik op Volgende.

  7. Configureer uw inrichtingsmodus met de volgende aanbevolen instellingen:

    Tabel 3. Aanbevolen inrichtingsinstellingen voor verschillende inrichtingsmodi

    Naam van instelling

    Flowthrough-inrichting met vertrouwde e-mails

    Flowthrough-inrichting zonder e-mails

    Zelfinrichting van de gebruiker

    BroadWorks-flow via inrichting inschakelen (inclusief inrichtingsaccountgegevens indien Ingeschakeld**)

    Aan

    Geef de accountnaam en het wachtwoord voor inrichting op volgens de BroadWorks-configuratie.

    Aan

    Geef de accountnaam en het wachtwoord voor inrichting op volgens de BroadWorks-configuratie.

    Uit

    Automatisch nieuwe organisaties maken in Control Hub

    Aan

    Aan

    Aan

    E-mailadres serviceprovider

    Selecteer een e-mailadres in de vervolgkeuzelijst (u kunt enkele tekens typen om het adres te vinden als het een lange lijst is).

    Dit e-mailadres identificeert de beheerder binnen uw partnerorganisatie aan wie gedelegeerde beheerderstoegang wordt verleend tot alle nieuwe klantorganisaties die met de onboardsjabloon zijn gemaakt.

    Land

    Kies welk land u voor deze sjabloon gebruikt.

    Het land dat u kiest, komt overeen met klantorganisaties die met deze sjabloon zijn gemaakt voor een bepaalde regio. Momenteel zou de regio (EMEAR) of (Noord-Amerika en de rest van de wereld) kunnen zijn. Zie de land-naar-regio toewijzingen in deze spreadsheet.

    Het land van de organisatie bepaalt de standaard internationale inbelnummers voor Cisco PSTN in Webex Meeting-sites. Raadpleeg het gedeelte Land van de Help-pagina voor meer informatie.

    BroadWorks-enterprisemodus actief

    Schakel dit in als de klanten die u met deze sjabloon inricht ondernemingen in BroadWorks zijn.

    Als het groepen zijn, laat deze schakelaar dan uit.

    Als u een mix van bedrijven en groepen in uw BroadWorks hebt, moet u verschillende sjablonen maken voor deze verschillende cases.

    Opmerkingen uit de tabel:

    • † Deze switch zorgt ervoor dat er een nieuwe klantorganisatie wordt gemaakt als het e-maildomein van een abonnee niet overeenkomt met een bestaande Webex-organisatie.

      Dit moet altijd zijn ingeschakeld, tenzij u een handmatig bestel- en uitvoeringsproces gebruikt (via Cisco Commerce Workspace) om klantorganisaties in Webex te maken (voordat u begint met het inrichten van gebruikers in die organisaties). Deze optie wordt vaak het model 'Hybride inrichting' genoemd en valt buiten het bereik van dit document.

    • ** 'Inrichtingsaccount' verwijst naar het BroadWorks-beheerdersaccount op systeemniveau. Op BroadWorks hebt u een beheerdersaccount met de volgende kenmerken nodig: Beheerderstype=Inrichting, Alleen-lezen=Uit.

  8. Selecteer het standaardservicepakket voor klanten met deze sjabloon (zie Pakketten in het gedeelte Overzicht); Basis, Standaard, Premium of Softphone.

    U kunt deze instelling voor individuele gebruikers overschrijven via Partner Hub.

  9. Optioneel. Schakel Gratis bellen via Cisco Webex uitschakelen in als u Webex-gesprekken wilt uitschakelen.

  10. Selecteer een van de volgende opties voor Configuratie voor deelnemen aan vergadering:

    • Cisco-inbelnummers (PSTN)

    • Door de partner verstrekte inbelnummers (BYoPSTN): als u deze optie selecteert, raadpleegt u de Bring Your Own PSTN Solution Guide for Webex for Cisco BroadWorks voor gedetailleerde informatie over het configureren van deze optie.

  11. Klik op Volgende.

  12. Er zijn twee benaderingen voor het inrichten van abonnees met betrekking tot hoe hun identiteiten worden geverifieerd - met behulp van vertrouwde e-mails of niet-vertrouwde e-mails.

    In de workflow voor vertrouwde e-mail geven gebruikers e-mailadressen door aan de partner die ze toevoegt in BroadWorks. Als partner bent u verantwoordelijk voor het inrichten van het e-mailadres als onderdeel van de doorstroommethode of de API-methode.


     

    Het wordt sterk aanbevolen om de vertrouwde inrichtingsmethode te gebruiken, omdat deze ervoor zorgt dat alle abonnees volledig door u als partner worden ingericht en er geen actie is vereist van de eindgebruikers.

    In het geval van niet-vertrouwde e-mail moeten gebruikers hun e-mails verifiëren voordat ze deze inrichten, of kunnen gebruikers zichzelf activeren.

    In het niet-vertrouwde geval zijn er verschillende inrichtingsmodi op basis van de verificatie-instellingen in de onderstaande tabel:

    Tabel 4. Aanbevolen verificatie-instellingen voor gebruikers voor niet-vertrouwde inrichtingsmodi

    Naam van instelling

    Flowthrough-inrichting zonder e-mails

    Zelfinrichting van de gebruiker

    Beheerder eerst inrichten

    Aanbevolen*

    Niet van toepassing

    Gebruikers toestaan zichzelf te activeren

    Niet van toepassing

    Vereist

    • Opmerkingen uit de tabel:

    • * Elke klantorganisatie in Webex moet ten minste één gebruiker met een beheerdersrol hebben. De eerste gebruiker aan wie u geïntegreerde IM&P in BroadWorks toewijst, neemt de rol van klantbeheerder als er een nieuwe klantorganisatie is gemaakt in Webex. Als serviceprovider wilt u mogelijk controle hebben over wie de rol krijgt. Als u deze instelling controleert, wordt het voltooien van de activering van gebruikers geblokkeerd totdat de eerste gebruiker die u hebt ingericht, is geactiveerd. Als u deze instelling uitschakelt, wordt de eerste gebruiker die in de nieuwe organisatie actief wordt, de klantbeheerder.

  13. Klik op Volgende.

  14. Selecteer de standaard verificatiemodus (BroadWorks-verificatie of Webex-verificatie) om u aan te melden bij Webex.


     
    Deze instelling heeft geen invloed op het aanmelden van gebruikers bij de User Activation Portal. Gebruikers moeten hun BroadWorks-gebruikers-id en -wachtwoord gebruiken wanneer ze zich aanmelden bij de portal, ongeacht hoe de onboardsjabloon is geconfigureerd.

     
    Deze instelling wordt alleen toegepast op nieuw gemaakte klantorganisaties. Als partnerbeheerders een nieuwe verificatie-instelling proberen toe te passen op bestaande klantorganisaties, zijn de bestaande instellingen van toepassing zodat bestaande gebruikers geen toegang verliezen. Als u de verificatiemodus voor bestaande klantorganisaties wilt wijzigen, moet u een ticket openen met Cisco TAC.

    (Zie Verificatiemodus in het gedeelte Uw omgeving voorbereiden).

  15. Klik op Volgende.

  16. Voor Voorkeuren configureert u het volgende:

    1. Kies of u de e-mailadressen van gebruikers vooraf wilt invullen op de aanmeldpagina.

      U moet deze optie alleen gebruiken als u BroadWorks-verificatie hebt geselecteerd en de e-mailadressen van de gebruikers ook in het kenmerk Alternatieve id in BroadWorks hebt geplaatst. Anders moeten ze hun BroadWorks-gebruikersnaam gebruiken. De aanmeldpagina biedt een optie om de gebruiker te wijzigen, indien nodig, maar dit kan leiden tot aanmeldproblemen.

    2. Als u adreslijstsynchronisatie wilt inschakelen, stelt u de schakelaar Telefoonlijstsynchronisatie inschakelen voor alle nieuwe klantorganisaties in op Aan.

      Met deze optie kan Webex BroadWorks-contactpersonen in de klantorganisatie lezen, zodat gebruikers deze kunnen vinden en bellen vanuit de Webex-app.

    3. Voer een partnerbeheerder in.

      Deze naam wordt gebruikt in het geautomatiseerde e-mailbericht van Webex, waarin gebruikers worden uitgenodigd om hun e-mailadres te valideren.

    4. Zorg ervoor dat de schakelaar E-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties is ingeschakeld (de standaardinstelling is ingeschakeld).

    5. Klik op Volgende.

  17. Controleer uw gegevens op het laatste scherm. U kunt op de navigatieknoppen boven aan de wizard klikken om terug te gaan en eventuele details te wijzigen. Klik op Maken.

    U zou een bericht met succes moeten zien.

  18. Klik op Sjablonen weergeven en u moet uw nieuwe sjabloon met andere sjablonen in de lijst zien.

  19. Klik op de sjabloonnaam om de sjabloon indien nodig te wijzigen of te verwijderen.

    U hoeft de gegevens van het inrichtingsaccount niet opnieuw in te voeren. De velden Leeg wachtwoord/Wachtwoordbevestiging zijn er om de referenties te wijzigen als dat nodig is, maar laat ze leeg om de waarden te behouden die u aan de wizard hebt opgegeven.

  20. Voeg meer sjablonen toe als u verschillende gedeelde configuraties hebt die u aan klanten wilt aanbieden.


     

    Houd de pagina Sjablonen weergeven open, omdat u mogelijk sjabloongegevens nodig hebt voor een volgende taak.

Toepassingsserver configureren met inrichtingsservice-URL


 

Deze taak is alleen vereist voor flow door inrichting.

Patch Application Server (alleen R22, R23 en R24)

  1. Als u dit nog niet hebt gedaan, past u de volgende patch toe die van toepassing is op uw versie:.


     
    Zie BroadWorks-softwarevereisten in het gedeelte Referentie voor een volledige lijst met BroadWorks-patches die de vereiste vormen voor de implementatie van Webex voor Cisco BroadWorks.
  2. Wijzigen in de Maintenance/ContainerOptions context.

  3. De parameter voor de inrichtings-URL inschakelen:

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

De inrichtings-URL('s) ophalen in Partner Hub

Raadpleeg de Beheerhandleiding Cisco BroadWorks Application Server Command Line Interface voor meer informatie (Interface > Berichten en service > Geïntegreerde IM&P) over de AS-opdrachten.

  1. Meld u aan bij Partner Hub en ga naar Instellingen > BroadWorks-gesprekken.

  2. Klik op Sjablonen weergeven.

  3. Selecteer de sjabloon die u gebruikt om de abonnees van deze onderneming/groep in te richten in Webex.

    De sjabloondetails worden weergegeven in een flyout-deelvenster aan de rechterkant. Als u nog geen sjabloon hebt gemaakt, moet u dit doen voordat u de inrichtings-URL kunt krijgen.

  4. Kopieer de URL van de inrichtingsadapter.

Herhaal dit voor andere sjablonen als u er meer hebt dan één.

(Optie) Systeembrede inrichtingsparameters configureren op toepassingsserver


 

Mogelijk wilt u het systeembrede inrichtings- en servicedomein niet instellen als u UC-One SaaS gebruikt. Zie Beslissingspunten in het gedeelte Uw omgeving voorbereiden.

  1. Meld u aan bij de toepassingsserver en configureer de interface voor berichten.

    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. De geïntegreerde IMP-interface activeren:

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

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


 

U moet de volledig gekwalificeerde naam invoeren voor de provisioningURL parameter, zoals deze is gegeven in Control Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in de /etc/hosts bestand op het AS.

(Optie) Inrichtingsparameters per onderneming configureren op toepassingsserver

  1. Open in de BroadWorks-gebruikersinterface de onderneming die u wilt configureren en ga naar Services > Geïntegreerde IM&P.

  2. Selecteer Servicedomein gebruiken en voer een dummywaarde in (Webex negeert deze parameter. U kunt dit gebruiken example.com).

  3. Selecteer Messaging Server gebruiken.

  4. Plak in het veld URL de inrichtings-URL die u van uw sjabloon hebt gekopieerd in Partner Hub.


     

    U moet de volledig gekwalificeerde naam invoeren voor de provisioningURL parameter, zoals deze is gegeven in Partner Hub. Als uw toepassingsserver geen toegang heeft tot DNS om de hostnaam op te lossen, moet u de toewijzing maken in de /etc/hosts bestand op het AS.

  5. Voer in het veld Gebruikersnaam een naam in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.

  6. Voer een wachtwoord in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.

  7. Voor Standaard gebruikersidentiteit voor IM&P-id selecteert u Primair.

  8. Klik op Toepassen.

  9. Herhaal dit voor andere bedrijven die u wilt configureren voor flow door inrichting.

Inrichtingsgegevens gebruiker

Zie Gebruikersvoorzieningen voor serviceproviders voor informatie over de gebruikersgegevens die worden uitgewisseld tussen BroadWorks en Webex tijdens het inrichten van gebruikers.

Controle-API voorafgaand aan inrichting van partner

De API Pre-Provisioning Check helpt beheerders en verkoopteams door te controleren op fouten voordat u een klant of abonnee inricht voor een pakket. Gebruikers of integraties die zijn geautoriseerd door een gebruiker met de rol Volledige partnerbeheerder kunnen deze API gebruiken om ervoor te zorgen dat er geen conflicten of fouten zijn met de pakketinrichting voor een bepaalde klant of abonnee.

De API controleert of er conflicten zijn tussen deze klant/abonnee en bestaande klanten/abonnees op Webex. De API kan bijvoorbeeld fouten veroorzaken als de abonnee al is ingericht voor een andere klant of partner, als het e-mailadres al bestaat voor een andere abonnee of als er conflicten zijn tussen de inrichtingsparameters en wat er al bestaat in Webex. Dit geeft u de mogelijkheid om deze fouten op te lossen voordat u inricht, waardoor de kans op een succesvolle inrichting groter wordt.

Zie voor meer informatie over de API: Ontwikkelaarshandleiding van Webex voor groothandels

Als u de API wilt gebruiken, gaat u naar: Een Wholesale Subscriber-inrichting vooraf controleren


 

Als u toegang wilt krijgen tot een inrichtingsdocument voor groothandels voor abonnees, moet u zich aanmelden bij de https://developer.webex.com/-portal.

Partner SSO - SAML

Hiermee kunnen partnerbeheerders SAML SSO configureren voor nieuw gemaakte klantorganisaties. Partners kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren, evenals op hun eigen werknemers.


 
De onderstaande stappen voor Partner-SSO zijn alleen van toepassing op nieuw gemaakte klantorganisaties. Als partnerbeheerders proberen Partner SSO toe te voegen aan een bestaande klantorganisatie, blijft de bestaande verificatiemethode behouden om te voorkomen dat bestaande gebruikers de toegang verliezen. Als u partner-SSO wilt toevoegen aan een bestaande organisatie, moet u een ticket openen met Cisco TAC.
  1. Controleer of de provider van de externe identiteitsprovider voldoet aan de vereisten die worden vermeld in het gedeelte Vereisten voor identiteitsproviders van Integratie van eenmalige aanmelding in Control Hub.

  2. Open een serviceaanvraag met Cisco TAC. TAC moet een vertrouwensrelatie opbouwen tussen de externe identiteitsprovider en de Cisco Common Identity-service. .


     
    Als uw IdP de passEmailInRequest in te schakelen, zorg ervoor dat u deze vereiste in het serviceverzoek opneemt. Raadpleeg uw IdP als u niet zeker weet of deze functie vereist is.
  3. Upload het CI-metagegevensbestand dat TAC aan uw identiteitsprovider heeft geleverd.

  4. Configureer een integratiesjabloon. Selecteer Partnerverificatie voor de instelling Verificatiemodus. Voer voor de entiteits-id van de IDP-provider de entiteits-id in vanuit de XML-metagegevens van de SAML van de externe identiteitsprovider.

  5. Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.

  6. Precies dat de gebruiker kan inloggen.

Partner-SSO - OpenID Connect (OIDC)

Hiermee kunnen partnerbeheerders OIDC SSO configureren voor nieuw gemaakte klantorganisaties. Partners kunnen één vooraf gedefinieerde SSO-relatie configureren en die configuratie toepassen op de klantorganisaties die ze beheren, evenals op hun eigen werknemers.


 

De onderstaande stappen om Partner SSO OIDC in te stellen, zijn alleen van toepassing op nieuw gemaakte klantorganisaties. Als partnerbeheerders proberen het standaard verificatietype te wijzigen in Partner SSO OIDC in een bestaande tempel, zijn de wijzigingen niet van toepassing op de klantorganisaties die al zijn geïntegreerd met de sjabloon.

  1. Open een serviceaanvraag met Cisco TAC met de details van de OpenID Connect-id-provider. Hieronder staan verplichte en optionele IDP-kenmerken. TAC moet de id-provider instellen op de CI en de omleidings-URI opgeven die moet worden geconfigureerd op de id-provider.

    Kenmerk

    Vereist

    Beschrijving

    Naam IDP

    Ja

    Unieke maar hoofdlettergevoelige naam voor OIDC IdP-configuratie, kan bestaan uit letters, cijfers, koppeltekens, onderstrepingstekens, tildes en stippen en de maximale lengte is 128 tekens.

    OAuth-client-id

    Ja

    Wordt gebruikt om OIDC IdP-verificatie aan te vragen.

    OAuth-clientgeheim

    Ja

    Wordt gebruikt om OIDC IdP-verificatie aan te vragen.

    Lijst met scopes

    Ja

    Lijst met scopes die worden gebruikt om OIDC IdP-verificatie aan te vragen, opgesplitst per ruimte, bijvoorbeeld 'openid e-mailprofiel' Moet openid en e-mail bevatten.

    Autorisatieeindpunt

    Ja als DiscoveryEndpoint niet is verstrekt

    URL van het OAuth 2.0-verificatie-eindpunt van de IdP.

    tokenEindpunt

    Ja als DiscoveryEndpoint niet is verstrekt

    URL van het OAuth 2.0-tokeneindpunt van de IdP.

    Eindpunt van detectie

    Nee

    URL van het Discovery-eindpunt van de IdP voor detectie van OpenID-eindpunten.

    userInfoEindpunt

    Nee

    URL van het UserInfo-eindpunt van de IdP.

    Eindpunt sleutelset

    Nee

    URL van het eindpunt van de JSON-websleutelset van de IdP.


     

    Naast de bovenstaande IDP-attributen moet de id van de partnerorganisatie worden opgegeven in het TAC-verzoek.

  2. Configureer de omleidings-URI op de OpenID connect-id-provider.

  3. Configureer een integratiesjabloon. Voor de instelling Verificatiemodus selecteert u Partnerverificatie met OpenID Connect en voert u de IDP-naam in die tijdens de installatie van de IDP is opgegeven als de entiteits-id van OpenID Connect IDP.

  4. Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.

  5. Zeer dat de gebruiker zich kan aanmelden met de SSO-verificatieflow.

Gesprekscorrelatie-id inschakelen

Als u Webex voor Cisco BroadWorks wilt uitvoeren, moet u de gesprekscorrelatie-id inschakelen. Deze instelling is vereist voor veel gespreksfuncties, waaronder gespreksopname, groepsgesprek opnemen, directie en directie-assistent.

Gebruik de CLI om de functie in te schakelen op alle AS- en XSP|ADP-interfaces.

  • Voer de volgende opdrachten uit op AS-interfaces. Hierdoor kan het AS de X-BroadWorks-Correlation-Info SIP-koptekst:

    AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true

    AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true

  • Het enableCallCorrelationID parameter die is gekoppeld aan de toepassing Xsi-Actions wordt gebruikt om de opname van informatie over gesprekscorrelatie in Xsi-Actions-logboeken te beheren. Het wordt aanbevolen om enableCallCorrelationID ingeschakeld met de volgende opdracht op XSP|ADP-interfaces:

    XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true

Zie voor meer informatie over de gesprekscorrelatie-id de functiebeschrijving Cisco BroadWorks-gesprekscorrelatie-id.

Synchroniseren met Directory

Telefoonlijstsynchronisatie zorgt ervoor dat Webex voor Cisco BroadWorks-gebruikers de Webex-telefoonlijst kunnen gebruiken om elke belentiteit te bellen vanaf de BroadWorks-server. Wanneer deze functie is ingeschakeld, wordt de volledige telefoonlijst van de BroadWorks-server gesynchroniseerd met de Webex-telefoonlijst. Gebruikers kunnen toegang krijgen tot de telefoonlijst vanuit de Webex-app en een gesprek plaatsen naar elke belentiteit vanaf de BroadWorks-server.

Als u adreslijstsynchronisatie wilt inschakelen, gaat u naar Adreslijstsynchronisatie in Webex voor Cisco BroadWorks.


 
Webex voor Cisco BroadWorks-flowthrough-inrichting voegt berichtengebruikers en bijbehorende gespreksinformatie van de BroadWorks-server toe aan het Webex-platform. Telefoonlijsten, niet-berichtengebruikers en niet-gebruikersentiteiten zijn echter niet opgenomen (bijvoorbeeld een conferentieruimte-telefoon, faxapparaat of nummer van de Hunt-groep). Als u adreslijstsynchronisatie inschakelt, wordt gegarandeerd dat alle bellende entiteiten worden toegevoegd aan het Webex-platform.

Uniforme gespreksgeschiedenis

Wanneer Unified Call History is ingeschakeld, worden BroadWorks-gespreksgebeurtenissen gesynchroniseerd met de Webex-cloud en worden ze onderdeel van de Webex Unified Call- en Meetings-geschiedenis die wordt weergegeven in de Webex-app. Gebruikers kunnen hun eigen gedetailleerde gespreksgeschiedenis en vergaderingsgeschiedenis bekijken vanuit de Webex-app.

Unified Call History kan worden ingeschakeld door beheerders op partnerniveau in Partner Hub op clusterbasis. Wanneer deze functie is ingeschakeld, synchroniseert de BroadWorks-implementatie de volgende gespreksgebeurtenissen met de Webex-cloud:

  • Gespreksgeschiedenisgebeurtenissen: deze gebeurtenissen worden gebruikt om een gedetailleerde Unified-gespreksgeschiedenis op te bouwen

  • Hookstatusgebeurtenissen: Unified Call History bevat hookstatusoptimalisaties die de hoeveelheid netwerkbandbreedte voor Telephony Presence-updates verlagen

Vereisten voor Unified Call History

Voordat u Unified Call History kunt configureren, moet u ervoor zorgen dat u uw systeem hebt gepatcht. Deze functie is afhankelijk van de volgende BroadWorks-patches die worden geïnstalleerd:

Voor R22:

Voor R23:

Voor R24:


 
Voor de volledige lijst met BroadWorks-patches die u moet installeren als voorwaarde om Webex voor Cisco BroadWorks uit te voeren, raadpleegt u BroadWorks-softwarevereisten in het gedeelte Referentie.

Naast het patchen van uw systeem, wordt het clientconfiguratiebestand ( config-wxt.xml) moet de volgende tagset hebben: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>

Als u Hunt-groep, Call Center en andere omleidingsinformatie in de Unified-gespreksgeschiedenis wilt hebben, moeten de volgende Broadworks-patches zijn geïnstalleerd en actief zijn:

Voor R23:

  • AP.as.23.0.1075.ap383346

  • AP.as.23.0.1075.ap383994

Voor R24:

  • AP.as.24.0.944.ap383346

  • AP.as.24.0.944.ap383994

Als u informatie over de directie-assistent in de Unified-gespreksgeschiedenis wilt hebben, moeten de volgende Broadworks-patches zijn geïnstalleerd en actief zijn:

Voor R24:

  • AP.as.24.0.944.ap380052

  • AP.as.24.0.944.ap384239

  • ADP met Xsi-Events-24_2022.06 of hoger

Naast de Broadworks-patches moet adreslijstsynchronisatie ook zijn ingeschakeld voor de Unified-gespreksgeschiedenis van Executive-Assistant.


 

Wanneer u Gespreksgeschiedenis of NST-synchronisatie inschakelt, verzendt Webex CTI-abonnementsvernieuwingsaanvragen voor alle gebruikers onder het cluster. Afhankelijk van het aantal gebruikers kan dit tot enkele uren duren. Het wordt aanbevolen geen onderhoudsactiviteiten van Broadworks uit te voeren tijdens dezelfde onderhoudsperiode.

Gespreksgeschiedenis inschakelen (nieuw cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een nieuw cluster, raadpleegt u de stappen voor het toevoegen van een cluster in Uw partnerorganisatie configureren in Partner Hub.

Gespreksgeschiedenis inschakelen (bestaand cluster)

Als u Gespreksgeschiedenis wilt inschakelen op een bestaand cluster, volgt u de volgende stappen:

  1. Meld u aan bij Partnerhub op admin.webex.com.

  2. Ga naar Instellingen en selecteer een bestaand cluster.

  3. Controleer of de clusterverbinding goed is. In het rechterdeelvenster moet een groen vinkje worden weergegeven met Connection established.

    Als dit niet wordt weergegeven, voert u onder Connnections controleren (optioneel) de BroadWorks-gebruikers-id en het BroadWorks-wachtwoord in en klikt u op Controleren om te controleren of de verbinding goed is.

  4. Schakel het selectievakje Gespreksgeschiedenis inschakelen in.

  5. Klik op Opslaan.

Interacties van functies

De volgende functieinteracties bestaan voor Unified Call History:

  • Unified Call History wordt niet ondersteund voor gebruikers die zijn geconfigureerd in BroadWorks met routelijsten of directe routes. Wanneer deze situatie bestaat, worden gebeurtenissen voor gespreksgeschiedenis en haakstatus niet naar de Webex-app verzonden.

  • Unified Call History wordt niet ondersteund bij toestelbellen. Gesprekken die zijn geplaatst via toestelbellen worden mogelijk niet correct weergegeven in de gespreksgeschiedenis.

Gespreksgeschiedenis weergeven in de Webex-app

Eindgebruikers kunnen hun Unified Call History openen en bekijken vanuit de Webex-app. Voor meer informatie raadpleegt u: Webex | Gespreks- en vergadergeschiedenis weergeven.

Unified Call History uitschakelen

Nadat u Unified Call History hebt ingeschakeld op een cluster, kunt u de functie niet zelf uitschakelen. Als u de functie wilt uitschakelen, neemt u contact op met het Cisco Technical Assistance Center (TAC).

Indicatie Visuele Spam

De Webex-app ondersteunt een visuele indicatie van spamgesprekken in de gesprekstoast wanneer het gesprek wordt weergegeven aan de gebelde en in de Unified Call History-records wanneer BroadWorks wordt bijgewerkt om de beller-id te valideren via het STIR/SHAKEN-framework. Deze functie hebben:

  1. Schakel Unified Call History in zoals beschreven in het vorige gedeelte.
  2. De volgende patches moeten geïnstalleerd en actief zijn:
    • AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
    • of minimaal AS-25_Rel_2022.12
  3. De functie moet geactiveerd worden via de AS CLI:
    • AS_CLI/System/ActivatableFeature> 104112 activeren
    • AS_CLI/System/StirShaken> enableVerification true instellen
  4. Broadworks moet worden geconfigureerd voor het ondertekenen, labelen en verifiëren van STIR-SHAKEN zoals beschreven in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification

Wanneer BroadWorks correct is geconfigureerd, wordt een nieuwe koptekst X-Cisco-CallerId-Disposition toegevoegd in INVITE-verzoeken die naar Cisco-clients worden verzonden en wordt een nieuwe veldbellerIdDisposition toegevoegd aan de bestaande gespreksgeschiedenisgebeurtenissen die via de CTI-interface naar de Webex-cloud worden verzonden. Webex-apparaten gebruiken deze informatie om een visuele spamindicatie te geven in de gesprekspresentatie en de Unified Call History van de gebelde.

Belleridentificatie en omleiding van gesprekken

Identificatie beller

Wanneer de Webex-app een gesprek ontvangt, wordt geprobeerd te identificeren wie de beller is en wordt deze informatie weergegeven in de melding voor een binnenkomend gesprek, in het gespreksvenster en nadat het gesprek is voltooid, in de gespreksgeschiedenis en voicemail.

De Webex-app probeert de beller-id te vinden door het inkomende telefoonnummer te koppelen aan de telefoonnummers van contactpersonen die in verschillende bronnen zijn gevonden. De Webex-app gebruikt de volgende bronnen in deze volgorde. Zodra het vindt het in een bron zal het niet proberen om ergens anders te zoeken.


 

Als er meerdere exemplaren van een nummer in één bron worden gevonden, wordt niet geprobeerd er een te kiezen. In dit geval wordt er geen beller-id weergegeven.

  • Webex Common Identity (CI) die gebruikers van uw organisatie bevat.

  • Persoonlijke contactpersonen en contactpersonen binnen de organisatie. Persoonlijke contactpersonen zijn zichtbaar op het tabblad Contactpersonen.

  • Lokaal adresboek. In Windows - Outlook-toepassing, in Mac - Mac-contactpersonen, in iOS - iPhone-contactpersonen, in Android - Android-contactpersonen.

Als er geen overeenkomst is gevonden met het inkomende telefoonnummer, gebruikt de app de weergavenaam in de SIP FROM-koptekst, indien beschikbaar. Anders wordt het gebruikersnaamgedeelte van de SIP-URI uit de koptekst SIP From als laatste redmiddel gebruikt.

Voor extern gespreksbeheer (d.w.z. Deskphone Control Mode) wordt XSI-informatie gebruikt, waarbij de BWKS-id of het toestel wordt gebruikt, geëxtraheerd uit informatie van externe partijen in de XSI-gebeurtenis. Als informatie van externe partijen niet beschikbaar is, wordt P-Asserted Identity (PAI) (indien geconfigureerd) gebruikt.

Gesprekken omleiden

Als een gesprek is omgeleid of doorgeschakeld, probeert de app te laten zien wie de beller is en hoe deze is doorgeschakeld in de gespreksmelding en de gespreksgeschiedenis.

  • Gesprek doorgeschakeld: Hier wordt het nummer weergegeven dat het gesprek heeft doorgeschakeld.

  • Hunt-groep: Hier wordt de naam weergegeven van de Hunt-groep die het gesprek heeft doorgeschakeld.

  • Callcenterwachtrij: Hier wordt de naam weergegeven van de wachtrij die het gesprek heeft doorgeschakeld.

  • Directie-assistent: Hier wordt de naam van de directeur weergegeven waarvoor het gesprek binnenkomt.

Uitzonderingen:

  • Voor interne gesprekken in de gesprekswachtrij, waarbij een agent een interne partij terugbelt, ziet de externe partij niet de naam van de gesprekswachtrij, maar de naam van de agent die deze belt.

Gesprek elders beantwoord:

Voor Hunt-groepen of gesprekswachtrijen die zijn ingesteld met gelijktijdige routering, zien agenten een gesprek dat elders in de gespreksgeschiedenis wordt beantwoord als een andere agent het gesprek opneemt. Voor Hunt-groepen of gesprekswachtrijen met opeenvolgende routering of in een overloop worden gesprekken weergegeven als gemiste oproep in de gespreksgeschiedenis als ze door een andere agent worden beantwoord.

Weergave van gedeelde lijn

Met de weergave van gedeelde lijn kunnen lijnen van andere gebruikers worden ingesteld als gedeelde lijnen op het apparaat voor eindgebruikers. De configuratie van de gedeelde lijn voor de Webex-app is vergelijkbaar met de configuratie van de gedeelde lijn voor bureautelefoons. Met deze specifieke functie kunt u weergaven voor gedeelde lijnen toewijzen aan de Webex-app van de eindgebruiker.

Deze functie biedt gebruikers de voordelen om gesprekken op het toestelnummer van een andere gebruiker rechtstreeks vanuit de Webex-app af te handelen.

  • U kunt de weergave van gedeelde lijn alleen instellen voor de bureaubladversie van een Webex-app.

  • U kunt maximaal 10 lijnen toevoegen, inclusief de primaire lijn Webex-app .

  • U kunt een workspace-lijn niet toewijzen als gedeelde lijn.

  • Een gebruiker kan niet tegelijkertijd met gedeelde lijnen worden ingericht met de service Executive Assistant.

  • De primaire lijnpoort van een gebruiker mag niet worden gewijzigd in een gedeelde lijn.

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

Pleister 1: Eigenaarsmarkering in apparaatlijst ter ondersteuning van gedeelde lijnen van Webex-client

R23 zonder ADP:

  • AP.as.23.0.1075.ap384179

  • AP.xsp.23.0.1075.ap384179

R23 met ADP:

  • AP.as.23.0.1075.ap384179

  • Xsi-Actions-23_2022.10

R24:

  • ALS: AP.as.24.0.944.ap384179

  • Xsi-Actions-24_2022.10

R25:

  • ALS: RI versie Rel_2022.10_1.310

  • Xsi-Actions-25_2022.10

Pleister 2: Patches voor het verhogen van het aantal poorten op apparaatprofieltypen (in dit geval voor de desktopclient: Business Communicator).

  • RI versie Rel_2022.10_1.310

Niet storen (NS)-synchronisatie

Synchronisatie Niet storen (NST) brengt de NST-instellingen op één lijn tussen Webex en BroadWorks door de NST-status tussen de twee platforms te synchroniseren. Als een gebruiker bijvoorbeeld Niet storen inschakelt vanuit de Webex-app, wordt die status gesynchroniseerd met BroadWorks-gespreksapparaten. Als gevolg daarvan gaat de bij BroadWorks geregistreerde bureautelefoon van de gebruiker niet over wanneer iemand deze probeert te bellen. Als een gebruiker NST instelt vanaf een bureautelefoon, wordt de status ook gesynchroniseerd met de Webex-app. Zonder deze functie worden NST-updates van het ene platform niet herkend door het andere platform.

NST-synchronisatie wordt toegepast op clusterniveau BroadWorks en kan door een partnerbeheerder worden ingeschakeld in Partnerhub.


 

Als er veel klanten (>50) in het BroadWorks-cluster zitten, wordt NST-synchronisatie niet ondersteund. In dergelijke gevallen wordt het aanbevolen contact op te nemen met een Cisco TAC-ondersteuningsmedewerker voor ondersteuning.

Voorwaarden

Zorg ervoor dat de volgende patches worden toegepast op de AS en XSP|ADP. Pas alleen de patches toe voor uw BroadWorks-versie.

Voor versie 23:

<snipped>

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

Voor versie 24:

<snipped>

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

Nadat u de patches hebt aangebracht, activeert u functie 25433 op de AS:

AS_CLI/System/ActivatableFeature> activate 25433

Als er veel klanten (>50) in het BroadWorks-cluster zijn, worden bewerkingen zoals het bijwerken van XSI-acties, XSI-gebeurtenissen, DAS-URL, XSP|ADP-URL of NST-synchronisatie niet ondersteund. In dergelijke gevallen wordt het aanbevolen contact op te nemen met een Cisco TAC-ondersteuningsmedewerker voor ondersteuning.

Synchronisatie van apparaatfunctietoetsen configureren in BroadWorks. Zorg ervoor dat de telefoon SIP SUBSCRIBE/NOTIFY ondersteunt voor het gebeurtenispakket 'as-feature-event'. Zie Functietoetssynchronisatie voor Cisco BroadWorks-apparaten voor meer informatie.

NST-synchronisatie inschakelen (bestaand cluster)

  1. Aanmelden bij Partner Hub

  2. Klik op Instellingen.

  3. Klik op Cluster weergeven en selecteer het juiste BroadWorks-cluster.

  4. Schakel de schakelaar Niet storen (NST) in.

  5. Voer uw BroadWorks-gebruikers-id in en klik op Enable.

    Het systeem valideert dat het BroadWorks-cluster de juiste patches heeft om NST-synchronisatie te ondersteunen. Als de validatie mislukt, wordt de knop Opslaan uitgeschakeld.

  6. Als de validatie slaagt, klik dan op Save.


 
  • Zodra NST synchroniseren is ingeschakeld, vernieuwt Webex alle gebruikersabonnementen om het gebeurtenispakket Niet storen op te nemen. Afhankelijk van het aantal gebruikers kan het enkele uren duren voordat dit proces is voltooid.

  • NST-synchronisatie inschakelen is een eenrichtingsschakelaar. Zodra de functie is ingeschakeld, kunt u deze niet zelf uitschakelen.

NST-synchronisatie inschakelen (nieuw cluster)

U kunt de functie ook inschakelen tijdens het maken van het cluster. Zie 'Uw BroadWorks-clusters configureren' in Uw partnerorganisatie configureren in Partner Hub voor meer informatie.

NST-synchronisatie uitschakelen

U kunt NST-synchronisatie niet zelf uitschakelen. Als u de functie wilt uitschakelen, maakt u een BEMS-engineeringcase met de volgende informatie:

  • Gezin: Spark-service

  • Product: Bellen in Webex (Webex voor BroadWorks)

  • Onderdeel: WxBW- Inrichting

  • In het BEMS-geval moet worden vermeld dat Niet storen synchroniseren moet worden uitgeschakeld voor een partner. De case moet partnerId en BroadWorks clusterId bevatten.

Usecases

NST instellen en wissen in relatie tot werkstatus

Gespreksopname

Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopname.

Tabel 6. Opnamemodi

Opnamemodi

Beschrijving

Bedieningselementen/indicatoren die worden weergegeven in de Webex-app

Altijd

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker is niet in staat om te beginnen met of stoppen met opnemen.

  • Visuele indicator dat de opname bezig is

Altijd met onderbreken/hervatten

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker kan een opname onderbreken en hervatten.

  • Visuele indicator dat de opname bezig is

  • Knop Opname onderbreken

  • Knop Opname hervatten

OnDemand

De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht, maar de opname wordt verwijderd tenzij de gebruiker op Opname starten drukt.

Als de gebruiker een opname start, blijft de volledige opname van de gespreksinstellingen behouden. Nadat de gebruiker de opname heeft gestart, kan de gebruiker de opname ook onderbreken en hervatten

  • Knop Opname starten

  • Knop Opname onderbreken

  • Knop Opname hervatten

OnDemand met door gebruiker geïnitieerde start

De opname wordt niet gestart tenzij de gebruiker de optie Opname starten selecteert in de Webex-app. De gebruiker heeft de optie om meerdere keren te starten en stoppen met opnemen tijdens een gesprek.

  • Knop Opname starten

  • Knop Opname stoppen

  • Knop Opname onderbreken

Vereisten

Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:

De Call Correlation Identifier (Correlatie-id gesprek) moet zijn ingeschakeld. Zie Gesprekscorrelatie-id inschakelen voor meer informatie.

De volgende configuratietag moet zijn ingeschakeld om deze functie te kunnen gebruiken: %ENABLE_CALL_RECORDING_WXT%.

Deze functie vereist een integratie met een gespreksopnameplatform van derden.

Als u gespreksopname op BroadWorks wilt configureren, gaat u naar de Cisco BroadWorks-interfacehandleiding voor gespreksopname.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van de opnamefunctie gaat u naar de help.webex.com artikel Webex | Uw gesprekken opnemen.

Als u een opname opnieuw wilt afspelen, moeten gebruikers of beheerders naar hun gespreksopnameplatform van derden gaan.

Groep gesprek parkeren en ophalen

Webex voor Cisco BroadWorks ondersteunt Groep gesprek parkeren en ophalen. Deze functie biedt gebruikers binnen een groep een manier om gesprekken te parkeren, die vervolgens door andere gebruikers in de groep kunnen worden opgehaald. Winkelmedewerkers in een winkelinstelling kunnen de functie bijvoorbeeld gebruiken om een gesprek te parkeren dat vervolgens kan worden opgehaald door iemand in een andere afdeling.

Werking van functies

Zodra de functie is geconfigureerd

  • Tijdens een gesprek klikt een gebruiker op de optie Parkeren in de Webex-app om het gesprek te parkeren op een toestel dat het systeem automatisch selecteert. Het systeem geeft het toestelnummer voor de gebruiker voor een periode van 10 seconden weer.

  • Een andere gebruiker in de groep klikt op de optie Gesprek ophalen in de Webex-app. De gebruiker voert vervolgens het toestelnummer van het geparkeerde gesprek in om het gesprek voort te zetten.

Vereisten

Zorg voor het volgende om deze functie te laten werken:

  • Het clientconfiguratiebestand moet de volgende tags hebben ingesteld:

    <call-park enabled="%ENABLE_CALL_PARK_WXT%"
            timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
  • De Call Correlatie-id moet zijn ingeschakeld op de AS en XSP|ADP. Zie Gesprekscorrelatie-id inschakelen voor meer informatie.

  • Uw SBC moet zijn geconfigureerd om de ' x-broadworks-correlation-in' SIP-kenmerk van en naar de toepassingsserver.

Configuratie

Zie 'Groep voor geparkeerde gesprekken toevoegen' in de Beheerhandleiding voor de webinterface van de Cisco BroadWorks-toepassingsservergroep - deel 2 voor meer informatie over het configureren van Groepsgesprek parkeren op BroadWorks. U moet een groep maken en gebruikers aan de groep toevoegen.

Meer informatie over het configureren van de gesprekscorrelatie-id in BroadWorks vindt u in Functiebeschrijving Cisco BroadWorks-gesprekscorrelatie-id.

Aanvullende informatie

Voor gebruikersinformatie over het gebruik van Groepsgesprek parkeren raadpleegt u Webex | Parkeren en Gesprekken ophalen.

Gesprek parkeren/doorverbonden gesprek parkeren

Normaal of doorverbonden gesprek parkeren wordt niet ondersteund in de gebruikersinterface van de Webex-app, maar ingerichte gebruikers kunnen de functie implementeren met behulp van functietoegangscodes:

  • Voer *68 in om een gesprek te parkeren

  • Voer *88 in om een gesprek op te halen

Inbreken

Inbrekersservice wordt vaak gebruikt in callcenteromgevingen of andere situaties waar directe hulp of interventie nodig kan zijn.

Wanneer een inbrekersservice is ingeschakeld, kan een aangewezen gebruiker of supervisor een actief gesprek invoeren door een specifieke opdracht te starten of door een speciale knop of toetscombinatie te gebruiken op hun telefoon of communicatieapparaat. Zodra de aanvraag voor inbreken is ingediend, brengt het systeem een verbinding tot stand met het lopende gesprek, zodat de bevoegde persoon het gesprek kan beluisteren of als actieve deelnemer aan het gesprek kan deelnemen.

Inbreken kan handig zijn in verschillende scenario's. In een callcenterinstelling kunnen supervisors of trainers vertegenwoordigers van de klantenservice controleren en coachen door hun gesprekken in realtime te beluisteren. Indien nodig kunnen ze ingrijpen om advies te geven of het gesprek overnemen als de vertegenwoordiger het moeilijk heeft. In noodsituaties of bij kritische gesprekken kan bevoegd personeel snel deelnemen aan lopende gesprekken om hulp te bieden of belangrijke beslissingen te nemen.

In de Webex-app voor inbreken krijgen we een melding dat het gesprek wordt omgezet in een conferentie. Er is geen extra informatie in de NOTIFY (call-info of conference-info) wat het type conferentie is, zodat we het op een andere manier kunnen behandelen.

Bij het inbreken wordt een drierichtingsgesprek tot stand gebracht tussen de partijen. De volgende termen worden geïntroduceerd:

  • Verantwoordelijke: Een supervisor is een persoon die toezicht houdt op en leiding geeft aan een team van klantenserviceagenten of callcentervertegenwoordigers. In het kader van het inbreken van gesprekken heeft een supervisor doorgaans de mogelijkheid om lopende gesprekken van klanten te controleren en tussenbeide te komen. Zij kunnen gespreksbewakingstools of -software gebruiken om gesprekken te beluisteren, agenten te begeleiden en kwaliteitscontrole te garanderen. De rol van de supervisor kan bestaan uit het trainen van agenten, het aanpakken van klantproblemen en het optimaliseren van de prestaties van het team.

  • Klant: Een klant verwijst naar een persoon of entiteit die contact opneemt met een bedrijf of organisatie om producten, diensten of ondersteuning te verkrijgen. In de context van gesprek inbreken is een klant iemand die een telefoongesprek voert of ontvangt met een agent van de klantenservice. Klanten kunnen tijdens het gesprek hulp, informatie of een oplossing zoeken voor hun vragen of problemen. Met de functie voor het inbreken van gesprekken kunnen supervisors of geautoriseerd personeel deelnemen aan het lopende gesprek tussen de klant en de agent.

  • Agent: Een agent, ook wel een vertegenwoordiger van de klantenservice of een callcenteragent genoemd, is een persoon die verantwoordelijk is voor het afhandelen van klantinteracties en het bieden van ondersteuning of hulp via de telefoon of andere communicatiekanalen. Agenten zijn opgeleid om vragen van klanten te beantwoorden, problemen op te lossen, transacties te verwerken en een positieve klantervaring te bieden. In de context van gesprek inbreken is een agent de persoon die rechtstreeks met de klant spreekt tijdens het telefoongesprek. De agent kan indien nodig begeleiding of feedback van de supervisor ontvangen via inbellen.

Mobiel systeemeigen gesprek escaleren naar vergadering

De Mobile Native Call Escalate to Meeting heeft twee unieke functies:

  • Nieuwe pushmelding

    Mobiele gebruikers in een native gesprek kunnen nu overschakelen naar de Webex-app door op de Nieuwe pushmelding te tikken. Wanneer u een systeemeigen gespreksscherm start, verschijnt er een Nieuwe pushmelding op het scherm en tikt u rechtstreeks op het scherm in gesprek van de Webex-app.

    U ziet de Webex-melding tijdens een telefoongesprek als u Webex Go gebruikt of als uw mobiele netwerkoperator (MNO) gesprekssignalering heeft met Cisco-gespreksbeheer voor uw mobiele telefoongesprekken.

  • Mobiel gesprek verplaatsen naar vergadering

    Wanneer u in gesprek bent met iemand, wilt u dat gesprek mogelijk verplaatsen naar een vergadering om gebruik te maken van enkele geavanceerde vergaderingsfuncties, zoals video, delen of whiteboards. Of nodig andere mensen uit in de discussie en ga naar een vergadering.

Vereisten voor BroadWorks

  • Activeerbare functie 25239

  • R23 met 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 met ADP:

    • AS-patch AP.as.23.0.1075.ap383064

    • ADP met Xsi-Actions-23, CommPilot-23 versie > 2022.05_1.303 en NPS versie > 2022.08_1.350

  • R24:

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

    • ADP met Xsi-Actions-24, CommPilot-24 versie > 2022.05_1.303 en NPS versie > 2022.08_1.350

  • R25:

    • AS RI versie Rel_2022.08_1.354

    • ADP met Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 en NPS-versie > 2022.08_1.350

Configuratie voor URI-bellen ter ondersteuning van het verplaatsen van een gesprek naar een vergadering

NS UrlDialing-beleid

Regel definiëren voor (.*)webex.com om te routeren via 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-routering NE voor I-SBC

Voorbeeldconfiguratie

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-routeringsprofiel

Het exemplaar van het URL-belbeleid is toegevoegd aan het/de juiste routeringsprofiel(en)

NS_CLI/Policy/Profile> get profile MyInst
 Profile:  Webex
                  Policy              Instance
    ==========================================
 …
              UrlDialing          WebexMeetings

ALS gebruik NS-route voor NetworkURL-gesprek

Schakel het AS in om de NS-route in de hybride AS-modus te respecteren

AS_CLI/Interface/IMS> set queryNSForNetworkURL true

E911-noodoproepen

Webex voor Cisco BroadWorks ondersteunt E911-noodoproepen. Met deze functie worden noodoproepen gerouteerd naar een PSAP (Public Safety Answering Point), dat vervolgens de hulpdiensten naar de locatie van de beller kan leiden. Als u deze functie wilt gebruiken, moet u Webex voor Cisco BroadWorks integreren met een E911-provider voor noodoproepen.

Gebruik de volgende Webex-artikelen om ondersteuning voor E911-noodoproepservices te configureren:

  • E911-noodoproepen in Webex voor BroadWorks: gebruik dit artikel om E911-noodoproepen in Webex voor Cisco BroadWorks te configureren met een van de volgende ondersteunde E911-providers:

    • Gegarandeerd

    • Binnen het systeem

    • RedSky

  • Disclaimer voor noodoproepen: als u een locatieservice hebt, kunt u het venster Disclaimer voor noodoproepen in de Webex-app zo configureren dat gebruikers hun locatie kunnen bijwerken wanneer ze zich aanmelden.

Clients aanpassen en inrichten

Gebruikers downloaden en installeren hun algemene Webex-apps voor desktop of mobiel (zie Webex-app-platforms voor downloadkoppelingen). Zodra de gebruiker zich heeft geverifieerd, wordt de client geregistreerd bij de Webex-cloud voor berichten en vergaderingen, worden de merkgegevens opgehaald, wordt de informatie over de BroadWorks-service ontdekt en wordt de belconfiguratie gedownload van de BroadWorks-toepassingsserver (via DMS op XSP|ADP).

U configureert de gespreksparameters voor Webex-apps in BroadWorks (zoals normaal). U configureert parameters voor branding, berichten en vergaderingen voor de clients in Control Hub. U kunt een configuratiebestand niet rechtstreeks wijzigen.

Deze twee sets configuraties kunnen overlappen. In dat geval vervangt de Webex-configuratie de BroadWorks-configuratie.

Configuratiesjablonen voor Webex-apps toevoegen aan de BroadWorks-toepassingsserver

Webex-apps worden geconfigureerd met DTAF-bestanden. De clients downloaden een XML-configuratiebestand van de toepassingsserver via de service Apparaatbeheer op de XSP|ADP.

  1. Haal de vereiste DTAF-bestanden op (zie Apparaatprofielen in het gedeelte Uw omgeving voorbereiden).

  2. Controleer of u de juiste tagsets hebt in BroadWorks System > Resources > Device Management Tagsets.

  3. Voor elke client die u inricht:

    1. Download en pak het DTAF zip-bestand voor de specifieke client uit.

    2. DTAF-bestanden importeren naar BroadWorks op System > Resources > Identity/Device Profile Types

    3. Open het nieuw toegevoegde apparaatprofiel voor bewerken en:

      • Voer de XSP|ADP farm FQDN en het Device Access Protocol in.

      • Schakel het selectievakje Support Remote Party Info in. Deze ondersteuning is vereist om bureaublad delen te laten werken.


         
        U kunt de ondersteuning voor Remote Party ook inschakelen door de volgende CLI-opdracht uit te voeren op de toepassingsserver: AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
    4. Pas de sjablonen aan volgens uw omgeving (zie onderstaande tabel).

    5. Sla het bestand op.

  4. Klik op Bestanden en verificatie en selecteer vervolgens de optie om alle systeembestanden opnieuw op te bouwen.

Naam

Beschrijving

Prioriteit codec

Prioriteitsvolgorde configureren voor de audio- en videocodecs voor VoIP-gesprekken

TCP, UDP en TLS

Configureer de protocollen die worden gebruikt voor SIP-signalering en media

RTP-audio- en videopoorten

Poortbereiken configureren voor RTP-audio en -video

SIP-opties

Configureer verschillende opties met betrekking tot SIP (SIP INFO, rport gebruiken, SIP-proxydetectie, vernieuwingsintervallen voor registratie en abonnement, enz.)

Branding voor Webex-app aanpassen


 

De portal voor gebruikersactivering gebruikt hetzelfde logo dat u toevoegt voor Client Branding.

Probleemrapportage en Help-URL's aanpassen

Als u deze opties wilt aanpassen, kunnen administators de procedure 'Feedback en Help-site-URL's toevoegen' volgen, die u in beide bovenstaande brandingartikelen kunt vinden.

Uw testorganisatie configureren voor Webex voor Cisco BroadWorks

Voordat u begint

Met Flowthrough-inrichting

U moet alle XSP|ADP-services en de partnerorganisatie in Control Hub configureren voordat u deze taak kunt uitvoeren.

1

Service toewijzen in BroadWorks:

  1. Maak een testonderneming onder uw serviceprovideronderneming in BroadWorks of maak een testgroep onder uw serviceprovider (afhankelijk van uw BroadWorks-configuratie).

  2. Configureer de IM&P-service voor die onderneming om naar de sjabloon te verwijzen die u test (haal de URL van de inrichtingsadapter en de referenties op in de Control Hub-onboardsjabloon).

  3. Maak testabonnees in die onderneming/groep.

  4. Geef de gebruikers unieke e-mailadressen in het e-mailveld in BroadWorks. Kopieer deze ook naar het kenmerk Alternatieve id.

  5. Wijs de geïntegreerde IM&P-service toe aan deze abonnees.


     

    Hierdoor worden de klantorganisatie en de eerste gebruikers gemaakt, wat enkele minuten duurt. Wacht even voordat u zich probeert aan te melden bij uw nieuwe gebruikers.

2

Klantorganisatie en gebruikers verifiëren in Control Hub:

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Klanten en controleer of uw nieuwe klantorganisatie in de lijst staat (de naam volgt de groepsnaam of de bedrijfsnaam, vanuit BroadWorks).

  3. Open de klantorganisatie en controleer of de abonnees gebruikers in die organisatie zijn.

  4. Controleer of de eerste abonnee aan wie u de geïntegreerde IM&P-service hebt toegewezen, de klantbeheerder van die organisatie is geworden.

Gebruikerstests

1

Download de Webex-app op twee verschillende machines.

2

Meld u aan als testgebruikers op de twee machines.

3

Voer testgesprekken.

Webex voor BroadWorks beheren

Klantorganisaties inrichten

In het huidige model richten we de klantorganisatie automatisch in wanneer u de eerste gebruiker integreert via een van de methoden die in dit document worden beschreven. Inrichting vindt slechts één keer plaats voor elke klant.

Gebruikers inrichten

U kunt gebruikers op de volgende manieren inrichten:

  • API's gebruiken om Webex-accounts te maken

  • Geïntegreerde IM&P (flowthrough provisioning) toewijzen met vertrouwde e-mails om Webex-accounts te maken

  • Wijs geïntegreerde IM&P (flowthrough provisioning) toe zonder vertrouwde e-mails. Gebruikers verstrekken en valideren e-mailadressen om Webex-accounts te maken

  • Gebruikers toestaan zichzelf te activeren (u stuurt ze een koppeling, ze maken Webex-accounts)

API's voor openbare inrichting

Webex stelt openbare API's bloot zodat serviceproviders Webex voor Cisco BroadWorks-abonneevoorzieningen kunnen integreren in hun bestaande inrichtingswerkstromen. De specificatie voor deze API's is beschikbaar op developer.webex.com. Als u wilt ontwikkelen met deze API's, neemt u contact op met uw Cisco-vertegenwoordiger om Webex voor Cisco BroadWorks op te halen.


 

Groothandels worden geweigerd door deze API's.

Doorstroominrichting

Op BroadWorks kunt u gebruikers inrichten met de optie Geïntegreerde IM&P inschakelen. Door deze actie voert de BroadWorks-inrichtingsadapter een API-oproep uit om de gebruiker in te richten op Webex. Onze provisioning-API is achterwaarts compatibel met de UC-One SaaS API. BroadWorks AS vereist geen codewijziging, alleen een configuratiewijziging naar het API-eindpunt voor de inrichtingsadapter.


 

Het inrichten van abonnees op Webex kan aanzienlijk duren (enkele minuten voor de eerste gebruiker binnen een onderneming). Webex voert de inrichting uit als een achtergrondtaak. Als de flowthrough-inrichting is geslaagd, geeft dit aan dat de inrichting is gestart. Het duidt niet op voltooiing.

Als u wilt bevestigen dat gebruikers en de klantorganisatie volledig zijn ingericht op Webex, moet u zich aanmelden bij Partner Hub en in uw lijst met klanten kijken.

BroadWorks-trunking-gebruikers kunnen Webex voor BroadWorks hebben via een gedeelde gespreksweergave (SCA). De trunking-gebruiker moet de verificatieservice hebben toegewezen. Zoals beschreven in de BroadWorks-handleiding voor trunking-oplossingen (Trunking Solution Guide) 8, kan de verificatie van de SCA Webex-weergave worden gescheiden van de algemene trunkverificatie. Webex voor BroadWorks kan niet worden ingericht voor trunking-gebruikers waaraan de functies Routelijst of Directe route zijn toegewezen.


 
De locatie van sjablonen is verplaatst van BroadWorks-gesprekken in de organisatie-instellingen naar het gedeelte Klantenlijst en wordt nu de onboardingsjabloon genoemd.

Zelfactivering van de gebruiker

BroadWorks-gebruikers inrichten in Webex zonder de geïntegreerde IM&P-service toe te wijzen:

  1. Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.

  2. Klik op Sjablonen weergeven.

  3. Selecteer de inrichtingssjabloon voor onboarding die u wilt toepassen op deze gebruiker.

    Vergeet niet dat elke sjabloon is gekoppeld aan een cluster en uw partnerorganisatie. Als de gebruiker zich niet in het BroadWorks-systeem bevindt dat aan deze sjabloon is gekoppeld, kan de gebruiker de koppeling niet zelf activeren.

  4. Kopieer de inrichtingskoppeling en verzend deze naar de gebruiker.

    U kunt ook de downloadkoppeling voor de software opnemen en de gebruiker eraan herinneren dat hij of zij zijn of haar e-mailadres moet opgeven en valideren om zijn of haar Webex-account te activeren.

  5. U kunt de activeringsstatus van de gebruiker op de geselecteerde sjabloon controleren.

Zie Gebruikersvoorzieningen en activeringsstromen voor meer informatie.

Inrichting met niet-vertrouwde e-mails

Partner Hub biedt een reeks besturingselementen in de weergave Gebruikersstatus waarmee Webex voor Cisco BroadWorks-serviceproviderbeheerders de gebruikersstatus kunnen controleren en fouten kunnen oplossen bij het inrichten van niet-vertrouwde e-mails. Zie Gebruikersvoorzieningen met niet-vertrouwde e-mails verifiëren voor meerinformatie.

Webex-gebruikers verplaatsen naar Webex voor Cisco BroadWorks

Als u bestaande Webex-gebruikers wilt verplaatsen naar Webex voor Cisco BroadWorks, raadpleegt u de onderstaande tabel om te bepalen welke procedure moet worden gevolgd.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfaanmelding (bv. gratis account, proefaccount)

  1. Inrichtingsgebruikers: als de Webex voor BroadWorks-organisatie niet bestaat (zonder dat er gebruikers zijn ingericht), volgt u de normale inrichting om de eerste gebruiker in te richten als beheerdersgebruiker en maakt u de organisatie. Hiermee wordt het Webex-gebruikersaccount automatisch verplaatst voor de eerste gebruiker. Gebruik de onderstaande procedure voor volgende gebruikers.

  2. Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks: als de Webex voor BroadWorks-organisatie bestaat (eerste gebruiker is ingericht), verkrijgt u toestemming van de gebruiker en verplaatst u volgende gebruikers.

Klantorganisatie

Webex voor BroadWorks toevoegen aan bestaande organisatie: de bijlage bij de organisatie (voor de eerste gebruiker) voegt ook Webex voor BroadWorks toe aan volgende gebruikers, zolang deze zijn toegewezen aan de juiste organisatie.

Bestaande Webex-gebruiker behoort tot een…

Volg deze processen om de gebruiker te verplaatsen

Consumentenorganisatie of zelfaanmelding (bv. gratis account, proefaccount)

Als Webex voor BroadWorks-organisatie niet bestaat (er zijn geen gebruikers ingericht):

  • Inrichtingsgebruikers: volg de normale inrichting om de eerste gebruiker als een beheerdersgebruiker toe te voegen. Hiermee wordt het account voor de eerste gebruiker automatisch verplaatst en wordt de Webex for BroadWorks-organisatie gemaakt. Toestemming van de gebruiker is vereist om susbsequente gebruikers te verplaatsen (gebruik de onderstaande procedure).

Als Webex voor BroadWorks-organisatie bestaat (er is ten minste één gebruiker ingericht):

Klantorganisatie

Gebruiker (met toestemming) verplaatsen naar Webex voor Cisco BroadWorks

Gebruik deze procedure om een bestaande Webex-gebruiker die zich in een consumentenorganisatie bevindt of een zelfaanmeldingsaccount heeft (gratis account of proefaccount) te verplaatsen naar Webex voor Cisco BroadWorks. Houd er rekening mee dat de Webex voor Cisco BroadWorks-organisatie moet bestaan (met de eerste gebruiker ingericht). In dit geval kunt u een van de volgende opties gebruiken om gebruikers te verplaatsen:

  • Gebruiker verplaatsen (met vertrouwde e-mail): gebruikt inrichting met vertrouwde e-mails

  • Gebruiker verplaatsen (met niet-vertrouwde e-mail): gebruikt inrichting met niet-vertrouwde e-mails

  • Zelfactivering


 
Als de Webex voor Cisco BroadWorks-organisatie nog niet is gemaakt (er zijn geen gebruikers ingericht), volgt u de normale inrichtingsprocessen (Inrichtingsgebruikers) om de organisatie te maken en de eerste gebruiker toe te voegen als een beheergebruiker. Nadat de eerste gebruiker is ingericht in de organisatie, volgt u de op toestemming gebaseerde methoden in deze procedure om volgende gebruikers te verplaatsen.

Gebruiker verplaatsen (met vertrouwd e-mailadres)

Als de onboardsjabloon vertrouwde e-mails gebruikt, kan de partnerbeheerder volgende gebruikers met dit proces verplaatsen:

  1. De beheerder voegt de gebruiker toe.

    • De gebruiker wordt gepusht naar de BroadWorks-inrichtingsbrug.

    • De CI-zoekopdracht bepaalt dat deze gebruiker een ander Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  2. De gebruiker opent de e-mail en klikt op Account activeren. De gebruiker wordt omgeleid naar de Webex-consumentenportal.

  3. Gebruiker meldt zich aan bij Webex.

  4. De gebruiker klikt op Verwijderen om het oude Webex-account te verwijderen.

    • Het oude Webex-account is verwijderd.

    • De gebruiker is ingericht in Webex voor Cisco BroadWorks met hetzelfde e-mailadres.

    • De gebruiker wordt omgeleid naar de pagina Downloaden.

Gebruiker verplaatsen (met niet-vertrouwde e-mail)

Als de onboardsjabloon niet-vertrouwde e-mails gebruikt, moet het e-mailadres van de gebruiker eerst worden gevalideerd. De beheerder kan dit proces volgen om volgende gebruikers te verplaatsen:

  1. De beheerder voegt de gebruiker toe.

    • De gebruiker wordt automatisch naar de BroadWorks-inrichtingsbrug gepusht.

    • Er wordt een tekst met een activeringskoppeling naar de gebruiker verzonden.

  2. De gebruiker klikt op de activeringskoppeling en voert het e-mailadres in.

    • De CI-zoekopdracht bepaalt dat deze gebruiker een ander Webex-account met dit e-mailadres heeft.

    • Er wordt een geautomatiseerde e-mail naar de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op Nu deelnemen.

    • Het e-mailadres is gevalideerd.

    • De gebruiker wordt omgeleid om zich aan te melden bij de Webex-consumentenportal.

  4. Gebruiker meldt zich aan bij Webex.

  5. De gebruiker moet op Verwijderen klikken om het oude Webex-account te verwijderen.

    • Het oude Webex-account is verwijderd.

    • De gebruiker is ingericht in Webex voor Cisco BroadWorks met hetzelfde e-mailadres.

    • De gebruiker wordt omgeleid naar de pagina Downloaden.

Zelfactiveringsstroom

Als de gebruiker een bestaand BroadWorks-account heeft, kan hij of zij het zelfactiveringsproces gebruiken om zijn of haar account te verplaatsen.

  1. De gebruiker meldt zich aan bij de URL van de gebruikerstoegang met BroadWorks-aanmeldgegevens.

  2. De gebruiker voert zijn/haar e-mailadres in.

    • De gebruiker wordt gepusht naar de BroadWorks-inrichtingsbrug.

    • Er wordt een geautomatiseerd e-mailadres naar het e-mailadres van de gebruiker verzonden.

  3. De gebruiker opent de e-mail en klikt op de koppeling Nu deelnemen, waarmee het e-mailadres wordt gevalideerd.

    • CI zoekt gebruiker heeft een bestaand Webex-account. Gebruikers moeten het oude account verwijderen voordat ze kunnen doorgaan.

    • Gebruiker wordt omgeleid om zich aan te melden bij Webex.

  4. De gebruiker meldt zich aan bij de Consumentenportal.

  5. De gebruiker klikt op Account verwijderen.

    • Het oude Webex-account wordt verwijderd.

    • De gebruiker heeft een nieuw Webex voor Cisco BroadWorks-account met hetzelfde e-mailadres ingericht.

Webex voor BroadWorks toevoegen aan bestaande organisatie

Als u een partnerbeheerder bent die Webex voor BroadWorks-services toevoegt aan een bestaande Webex-klantorganisatie die nog niet is gekoppeld aan een door een partner beheerde BroadWorks-onderneming, MOET de beheerder van de klantorganisatie beheerderstoegang voor het inrichtingsverzoek goedkeuren om te slagen.

De goedkeuring van de organisatiebeheerder is vereist als een van de volgende situaties waar is:

  • De bestaande klantorganisatie heeft 100 gebruikers of meer

  • De organisatie heeft een geverifieerd e-maildomein

  • Het organisatiedomein is geclaimd

Als geen van de bovenstaande criteria waar is, kan een Automatic Attach optreden.


 
In een scenario met automatische bijlage wordt een Webex voor BroadWorks-abonnement toegevoegd aan een bestaande klantorganisatie zonder melding aan de bestaande organisatiebeheerder of eindgebruiker. In de meeste gevallen krijgt uw partnerorganisatie inrichtingsbeheerdersrechten. Als de klantorganisatie echter geen licenties heeft of alleen licenties heeft opgeschort/geannuleerd, wordt u een volledige beheerder gemaakt.

Met toegang tot de inrichtingsbeheerder hebt u beperkte zichtbaarheid in Control Hub voor de gebruikers in de bestaande organisatie. Het wordt aanbevolen dat u contact opneemt met de klantbeheerder en volledige beheerderstoegang tot de organisatie aanvraagt.

Partnerbeheerders kunnen de volgende procedure voltooien om BroadWorks-gespreksservices toe te voegen aan een bestaande Webex-organisatie:


 
Zorg ervoor dat de e-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties (de schakelaar is standaard ingeschakeld).
1

De partnerbeheerder richt Webex voor Cisco BroadWorks in voor de klant. Zie Inrichting van klantorganisaties voor hulp. Nu gebeurt het volgende:

  • Organisatiebijlage mislukt met een 2017 fout (Kan abonnee niet inrichten in een bestaande Webex-organisatie). (Er wordt geen fout ontvangen tijdens een automatische bijlage.)

  • Er wordt een e-mailmelding gegenereerd en verzonden naar de beheerders van de klantorganisatie (maximaal vijf beheerders). In de e-mailmelding wordt het e-mailadres van de partnerbeheerder gemarkeerd (zoals geconfigureerd in de sjabloon voor onboarding in Partner Hub) en wordt de organisatiebeheerder gevraagd de partnerbeheerder goed te keuren als externe beheerder. De klantorganisatiebeheerder moet het verzoek goedkeuren en de partnerbeheerder volledige beheerder toegang geven tot de klantorganisatie.


 

Stel dat de klantbeheerder geen e-mail ontvangt. In dat geval kan de klantbeheerder de partnerbeheerder (opgegeven in de sjabloon) handmatig toevoegen als de externe beheerder van de klantorganisatie vanuit de Control Hub. Probeer de gebruiker vervolgens opnieuw in te richten, waardoor de Webex voor Cisco BroadWorks-klantvoorziening wordt geactiveerd.

2

Met volledige beheerderstoegang kan de partnerbeheerder het proces voor het inrichten van de klant voltooien. Vanaf stap 1 hierboven moet u de inrichting van de klant opnieuw proberen. Nu u een externe Full Admin bent, mag u de fout 2017 echter niet waarnemen.

Zodra de inrichting van gespreksservices is voltooid, is de bestaande klantorganisatie zichtbaar als klant onder de partnerorganisatie van Webex voor BroadWorks.


 
De naam van de bijgevoegde organisatie verandert niet in de bedrijfsnaam van BroadWorks. De naam van de bijgevoegde organisatie blijft behouden zoals die was voorafgaand aan het bijvoegproces.

Voorwaarden van organisatiebijlage

  • Het e-mailadres van de eerste BroadWorks-abonnee die is ingericht, moet overeenkomen met het e-mailadres van een bestaande gebruiker in de beoogde klantorganisatie. Anders wordt een nieuwe klantorganisatie gemaakt.

  • De eerste gebruiker van de bestaande organisatie die is ingericht voor Webex voor BroadWorks, is niet ingericht als beheerdersgebruiker. Instellingen en rechten van de bestaande organisatie worden behouden.

  • De bestaande verificatie-instellingen van de organisatie hebben voorrang op wat is geconfigureerd op de Webex for BroadWorks-inrichtingssjabloon. Als gevolg hiervan verandert er niets aan de manier waarop bestaande gebruikers zich aanmelden.

    • Als de bestaande klantorganisatie echter basisbranding heeft ingeschakeld, hebben de geavanceerde branding-instellingen van de partner voorrang nadat de bijvoeging plaatsvindt. Als de klant wil dat de basisbranding intact blijft, moet de partner de klantorganisatie configureren om de branding in de instellingen voor geavanceerde branding te overschrijven.

  • De naam van de bestaande organisatie wordt niet gewijzigd.

  • Er is geen wijziging in de vlaggen voor e-mailonderdrukking in de instellingen van de bestaande organisatie. Dit kan van invloed zijn op nieuw ingerichte gebruikers. Afhankelijk van hoe de vlag is ingesteld, ontvangen nieuwe gebruikers al dan niet een e-mail met een code die moet worden ingevoerd om de activering te voltooien.

  • De beperkte beheermodus (ingesteld door de schakelaar voor beperkte partnermodus) is uitgeschakeld voor de bijgevoegde organisatie.

  • Zorg ervoor dat u het bevestigingsproces voor de organisatie voltooit (bestaande gebruikers verplaatsen en de organisatie-id bijwerken) voordat u nieuwe gebruikers inricht in de Webex voor Cisco BroadWorks-organisatie.

  • Een BroadWorks-onderneming kan slechts aan één Webex-organisatie worden gekoppeld. U kunt abonnees van één BroadWorks-onderneming niet inrichten in afzonderlijke Webex-organisaties.

Externe beheerder toevoegen

Zie het artikel Aanvraag externe beheerder goedkeuren voor de stappen die klantorganisatiebeheerders kunnen volgen om de partnerbeheerder toe te voegen als externe beheerder op help.webex.com.


 
De klantbeheerder moet de externe beheerder de volledige beheerdersrechten en -rechten geven.

 
Het e-mailadres dat de beheerder van de klantorganisatie als externe beheerder toevoegt, moet overeenkomen met het e-mailadres van de partnerbeheerder zoals is geconfigureerd in de sjabloon voor onboarding op Partner Hub.

Nadat u de e-mail van het onboardsjabloon op Partnerhub hebt toegevoegd als volledige beheerder, moeten eventuele extra partnerbeheerders ook worden toegevoegd als externe beheerder met volledige beheerdersrechten.

Webex voor BroadWorks loskoppelen van bestaande organisatie

Volg deze stappen om Webex voor BroadWorks los te koppelen van een bestaande Webex-organisatie. Als u bijvoorbeeld per ongeluk Webex voor BroadWorks aan een bestaande organisatie hebt gekoppeld en de bijlage wilt verwijderen.


 

Als u in Standaardstroom Webex voor BroadWorks loskoppelt van een bestaande Webex-organisatie (alleen standaardstroom), worden alle bijbehorende abonneegegevens verwijderd en wordt het Webex voor BroadWorks-abonnement van de klant gedeactiveerd. U verliest ook de toegang tot de klantorganisatie als dit het enige gekoppelde abonnement is. In de hybride stroom worden de klantabonnementen niet gewijzigd.

  1. Als u geen toegang hebt tot de klantinstellingen in Control Hub, laat de klantbeheerder u externe beheerder dan toegang verlenen door het verzoek van externe beheerder goed te keuren.

  2. Verwijder alle Webex voor BroadWorks-werkplekken uit de organisatie. Gebruik de API Een BroadWorks-werkplek verwijderen.

  3. Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de API Een BroadWorks-abonnee verwijderen.

  4. Verwijder in behandeling zijnde Webex voor BroadWorks-gebruikers uit de organisatie. Als gebruikers bijvoorbeeld zijn ingericht via de niet-vertrouwde e-mailstroom en er nog geen geldige e-mails zijn ingevoerd, blijven de gebruikers in behandeling. Volg Gebruikersvoorzieningen verifiëren met niet-vertrouwde e-mails om de gebruikers te verwijderen.

  5. Verwijder de configuratie van BroadWorks Calling voor deze klant. Open het Control Hub-exemplaar van de klant en klik op Hybrid onder het gedeelte BroadWorks Calling om alle configuraties te verwijderen.

Als u na de onthechting Webex voor BroadWorks aan de klant wilt koppelen, volgt u de inrichtingsprocessen om deze aan een bestaande klant te koppelen.


 
Een alternatieve optie om abonnees te verwijderen als u de API Een BroadWorks-abonnee verwijderen niet wilt gebruiken, is om naar BroadWorks CommPilot te gaan en de geïntegreerde IM&P-service voor de betrokken gebruikers te verwijderen.

Gebruikers en organisaties beheren

Als u gebruikers in Webex voor Cisco BroadWorks wilt beheren, moet u bedenken dat de gebruiker zowel in BroadWorks als in Webex bestaat. Belattributen en de BroadWorks-identiteit van de gebruiker worden in BroadWorks gehouden. Een afzonderlijke e-mailidentiteit voor de gebruiker en de licenties voor Webex-functies worden in Webex bewaard.

Gebruikersvoorzieningen verifiëren met niet-vertrouwde e-mails

Als u Webex voor BroadWorks-gebruikers inricht via doorstroominrichting met niet-vertrouwde e-mails, moeten gebruikers zichzelf inrichten door hun e-mailadres in de portal voor gebruikersactivering in te voeren. Als er een fout optreedt, kan de gebruiker de optie Opnieuw proberen gebruiken die in de portal wordt weergegeven om een nieuwe poging te doen. Als de gebruiker de fout opnieuw ondervindt, kan de beheerder de onderstaande stappen in Partner Hub gebruiken om de status te controleren en de gebruiker te onboarden, de gebruiker te verwijderen of configuratiewijzigingen toe te passen.

1

Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.

2

Klik op Sjablonen weergeven. Selecteer de juiste onboardsjabloon die u wilt toepassen op deze gebruiker.

3

Controleer onder Gebruikersverificatie of de volgende instellingen zijn ingesteld om ervoor te zorgen dat doorstroominrichting met niet-vertrouwde e-mails correct is geconfigureerd:

  • De optie Niet-vertrouwde e-mails moet zijn ingeschakeld
  • Het veld Koppeling delen moet naar de activeringskoppeling verwijzen. Als alles is geconfigureerd, kunnen gebruikers proberen zichzelf in te richten via de User Activation Portal.
4

Nadat de gebruiker is ingericht, klikt u in het gedeelte Gebruikersverificatie op Gebruikersstatus weergeven om de inrichtingsstatus te controleren.

In de weergave Gebruikersstatus wordt de lijst met gebruikers weergegeven, samen met details zoals de BroadWorks-id, het geselecteerde pakkettype en de huidige status. Deze weergave geeft aan of de gebruiker is ingericht of dat er een vereiste in behandeling is.
5

Voor gebruikers met fouten of vereisten in behandeling, klikt u op de drie stippen aan de rechterkant en kiest u een van de volgende beheeropties:

  • Activering opnieuw proberen: klik op deze optie om opnieuw te proberen de gebruiker te onboarden. Voer in het pop-upvenster een geldig e-mailadres in en klik op Onboard.
  • Gebruiker verwijderen: deze optie is mogelijk van toepassing als u de configuratie moet wijzigen om onboarding toe te staan. Nadat u de gebruiker hebt verwijderd en uw wijzigingen hebt aangebracht, kan de gebruiker opnieuw proberen te onboarden.
  • Pakkettype wijzigen: wijzig de instelling van het ene pakket naar het andere:
  • Fouttekst kopiëren: klik op deze optie om de fouttekst te kopiëren.

Aanvullende weergaveopties

De volgende extra opties zijn beschikbaar wanneer u de lijst met gebruikers bekijkt:

  • Exporteren: klik op deze knop als u de gebruikerslijst wilt exporteren naar een CSV-bestand.

  • Ingerichte gebruikers uitsluiten: schakel deze schakelaar in als u alleen gebruikers met vereisten of fouten in behandeling wilt weergeven.

Gebruikers-id of e-mailadres wijzigen

Wijzigingen gebruikers-id en e-mailadres

E-mail-id en alternatieve id zijn de BroadWorks-gebruikerskenmerken die worden gebruikt met Webex voor Cisco BroadWorks. De BroadWorks-gebruikers-id is nog steeds de primaire id van de gebruiker in BroadWorks. In de volgende tabel worden de doelstellingen van deze verschillende kenmerken beschreven en wordt beschreven wat u moet doen als u ze moet wijzigen:

Kenmerk in BroadWorksOvereenkomstig kenmerk in WebexDoelNotities
BroadWorks-gebruikers-idGeenPrimaire idU kunt deze id niet wijzigen en de gebruiker nog steeds aan hetzelfde account in Webex koppelen. U kunt de gebruiker verwijderen en opnieuw maken als dit onjuist is.
E-mail-idGebruikers-id

Verplicht voor doorstroominrichting (maken van Webex-gebruikers-id) wanneer u aangeeft dat u e-mail vertrouwt

Niet vereist in BroadWorks als u niet beweert dat u e-mails kunt vertrouwen

Niet vereist in BroadWorks als u abonnees toestaat zichzelf te activeren

Er is een handmatig proces om dit op beide plaatsen te wijzigen als de gebruiker het verkeerde e-mailadres heeft gekregen:

  1. Het e-mailadres van de gebruiker wijzigen in Control Hub

  2. E-mail-id-kenmerk wijzigen in BroadWorks

Wijzig de BroadWorks-gebruikers-id niet. Dit wordt niet ondersteund.

Alternatieve idGeenHiermee schakelt u het authn van de gebruiker in, via e-mail en wachtwoord, met de BroadWorks-gebruikers-idMoet hetzelfde zijn als de e-mail-id. Als U het e-mailadres niet in het kenmerk Alternatieve id kunt plaatsen, moeten gebruikers hun BroadWorks-gebruikers-id invoeren bij de verificatie.

Gebruikerspakket wijzigen in Partner Hub

1

Meld u aan bij Partner Hub en klik op Klanten.

2

Zoek en selecteer de klantorganisatie waar de gebruiker is gehuisvest.

De overzichtspagina van de organisatie wordt geopend in een deelvenster aan de rechterkant van het scherm.

3

Klik op Klant weergeven.

De klantorganisatie wordt geopend in Control Hub en toont de pagina Overzicht.
4

Klik op Users, zoek en klik op de getroffen gebruiker.

5

Klik in de Services van de gebruiker op Webex voor BroadWorks-pakketten (abonnementen).

Het deelvenster Pakketten van de gebruiker wordt geopend en u kunt zien welk pakket momenteel aan de gebruiker is toegewezen.

6

Kijk in het tabblad Profiel in het gedeelte Pakket en klik op het pijltje (>) om de weergave uit te vouwen.

7

Selecteer het gewenste pakket voor deze gebruiker (Basic, Standard, Premium of Softphone) en klik op Save.

Control Hub toont een bericht dat de gebruiker bijwerkt.

8

U kunt de gebruikersgegevens en het tabblad Control Hub sluiten.


 
Standaard- en Premium-pakketten hebben verschillende vergadersites die bij elk pakket horen. Wanneer een abonnee met beheerdersrechten met een van deze twee pakketten naar het andere pakket gaat, wordt de abonnee weergegeven met twee vergadersites in Control Hub. De vergaderingsmogelijkheden en vergaderingssite van de abonnee komen overeen met het huidige pakket. De vergadersite van het vorige pakket en alle eerder gemaakte inhoud op die site, zoals opnamen, blijven toegankelijk voor de sitebeheerder van de vergadering.

 
Het kan twee tot drie uur duren voordat nieuwe PMR-instellingen die het gevolg zijn van een pakketwijziging, worden bijgewerkt.

Gebruikers verwijderen

Er zijn verschillende methoden die beheerders kunnen gebruiken om een gebruiker te verwijderen uit Webex voor Cisco BroadWorks:


 
Als de gebruiker die u gaat verwijderen beheerdersrechten heeft, wijst u een nieuwe beheerder toe voordat u de gebruiker verwijdert. Er is geen automatische overdracht van de beheerdersrol als de laatste beheerder wordt verwijderd.

Webex voor Cisco BroadWorks API

Partnerbeheerders kunnen de Webex for Cisco BroadWorks API gebruiken om gebruikers te verwijderen:

  1. Voer de Remove a BroadWorks Subscriber API-aanvraag uit op https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Met deze aanvraag wordt het Webex for Cisco BroadWorks-abonnement verwijderd. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt behandeld als een gratis Webex-gebruiker.

  2. Voer het API-verzoek Een persoon verwijderen uit op https://developer.webex.com/docs/api/v1/people/delete-a-person om de gebruiker volledig te verwijderen.

Doorstroominrichting

Partnerbeheerders kunnen doorstroominrichting gebruiken om gebruikers te verwijderen:

  1. Op de BroadWorks-server verwijdert u de geïntegreerde IM+P-service van de gebruiker. U kunt de service voor de gebruiker uitschakelen via de pagina User – Integrated IM&P op BroadWorks. Zie 'Geïntegreerde IM&P configureren' in de Beheerhandleiding voor de webinterface van de Cisco BroadWorks-toepassingsservergroep – deel 2 voor een gedetailleerde procedure.

    Nadat de service is uitgeschakeld, verwijdert doorstroominrichting het Webex for Cisco BroadWorks-abonnement van de gebruiker. De gebruiker wordt niet langer gefactureerd als Webex voor Cisco BroadWorks-gebruiker en wordt behandeld als een gratis Webex-gebruiker.

  2. Zoek en selecteer de gebruiker in Control Hub.

  3. Ga naar Actions en selecteer Delete User.

Control Hub (klantbeheerders)

Klantbeheerders kunnen Control Hub gebruiken om gebruikers uit hun organisatie te verwijderen. Zie Een gebruiker uit uw organisatie verwijderen in Webex Control Hub op https://help.webex.com/0qse04/ voor meer informatie.

Organisatie verwijderen

Volg deze procedure om een Webex voor Cisco BroadWorks-organisatie uit het systeem te verwijderen.
1

Gebruik de People API's om alle gebruikers uit de organisatie te verwijderen:

  1. Voer de API Personen weergeven uit om een lijst met gebruikers op te halen.

  2. Voer de API Een persoon verwijderen uit om de gebruikers te verwijderen.


 
Met de Een BroadWorks-abonnee-API verwijderen worden Webex voor Cisco BroadWorks-rechten van een gebruiker verwijderd, maar wordt de gebruiker niet verwijderd.
2

Als adreslijstsynchronisatie is ingeschakeld, schakelt u deze uit. Dit kan via Partner Hub of via de openbare API.

Adreslijstsynchronisatie uitschakelen via Partner Hub:

  1. Meld u aan bij Partner Hub en klik op Instellingen.

  2. Klik onder BroadWorks Calling op Sjablonen weergeven en selecteer de juiste sjabloon.

  3. Klik op de knop Toon statuslijst klantsynchronisatie in het zijpaneel.

  4. Voor de juiste klant klikt u op de drie stippen helemaal rechts en selecteert u Synchronisatie uitschakelen.

Als u adreslijstsynchronisatie via API wilt uitschakelen, gebruikt u Adreslijstsynchronisatie voor een BroadWorks Enterprise-API bijwerken en schakelt u de instelling enableDirSync uit.

Alle gebruikers met betrekking tot BroadWorks-adreslijstsynchronisatie voor deze organisatie worden verwijderd. Houd er rekening mee dat het verwijderen van gebruikers (met behulp van een van beide methoden) enige tijd kan duren, afhankelijk van de hoeveelheid gebruikers.

3

Nadat alle gebruikers zijn verwijderd, gebruikt u de API Een organisatie verwijderen om de organisatie te verwijderen.

Vrijgavebeheer

Bedieningselementen voor releasebeheer in Partner Hub maken het eenvoudig voor Webex voor Cisco BroadWorks-serviceproviders om releases te beheren door hen de mogelijkheid te geven de releasecadans te beheren waarmee de Webex-apps van gebruikers upgraden naar de nieuwste software.

De Webex-app maakt standaard gebruik van automatische upgrades (door Cisco beheerde maandelijkse versies). Met deze functie kunnen partnerbeheerders echter:

  • Aangepaste releaseschema's configureren met uitstel van de standaardreleaseschema's van Cisco

  • Configureer één releaseschema en trapsgewijs die planning naar alle klantorganisaties die ze beheren

  • Verschillende releaseschema's toewijzen aan verschillende klantorganisaties

Zie het Webex-artikel Aanpassingen voor releasebeheer voor meer informatie over releasebeheer, waaronder informatie over het configureren en toepassen van aangepaste releaseplanningen.

Het systeem opnieuw configureren

U kunt het systeem als volgt opnieuw configureren:

  • Een BroadWorks-cluster toevoegen in Partner Hub

  • Een BroadWorks-cluster bewerken of verwijderen in Partnerhub

  • Een onboardingsjabloon toevoegen in Partner Hub

  • Een onboardsjabloon bewerken of verwijderen in Partner Hub

Een BroadWorks-cluster bewerken of verwijderen in Partnerhub

U kunt een BroadWorks-cluster bewerken of verwijderen in Partnerhub.

1

Meld u aan bij Partner Hub met uw partnerbeheergegevens op https://admin.webex.com.

2

Ga naar Instellingen en zoek het gedeelte BroadWorks-gesprekken.

3

Klik op Clusters weergeven.

4

Klik op het cluster dat u wilt bewerken of verwijderen.

De clusterdetails worden weergegeven in een flyout-venster aan de rechterkant.
5

U hebt de volgende opties:

  • Wijzig de gegevens die u moet wijzigen en klik op Opslaan.
  • Klik op Verwijderen om het cluster te verwijderen en bevestig.

     

    Als er veel klanten (>50) in het BroadWorks-cluster zijn, worden bewerkingen zoals het bijwerken van XSI-acties, XSI-gebeurtenissen, DAS-URL, XSP|ADP-URL of NST-synchronisatie niet ondersteund. In dergelijke gevallen wordt het aanbevolen contact op te nemen met een Cisco TAC-ondersteuningsmedewerker voor ondersteuning.

    Als een sjabloon is gekoppeld aan het cluster, kunt u een cluster niet verwijderen. Verwijder de gekoppelde sjablonen voordat u het cluster verwijdert. Zie Een onboardsjabloon bewerken of verwijderen in Partnerhub.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Een onboardsjabloon bewerken of verwijderen in Partner Hub

U kunt sjablonen voor onboarding bewerken of verwijderen in Partner Hub.

1

Meld u aan bij Partner Hub met uw partnerbeheergegevens op https://admin.webex.com.

2

Ga naar Instellingen en zoek het gedeelte BroadWorks-gesprekken.

3

Klik op Sjablonen weergeven.

4

Klik op de sjabloon die u wilt bewerken of verwijderen.

5

U hebt de volgende opties:

  • Bewerk de gegevens die u moet wijzigen en klik op Opslaan.
  • Klik op Verwijderen om de sjabloon te verwijderen en bevestig.

Instelling

Waarden

Notities

Accountnaam/wachtwoord inrichten

Door gebruiker geleverde tekenreeksen

U hoeft de inrichtingsaccountgegevens niet opnieuw in te voeren bij het bewerken van een sjabloon. De velden Leeg wachtwoord/Wachtwoordbevestiging zijn er om de referenties te wijzigen als dat nodig is, maar laat ze leeg om de waarden te behouden die u oorspronkelijk hebt opgegeven.

E-mailadres van de gebruiker vooraf invullen op de aanmeldpagina

Aan/uit

Het kan tot 7 uur duren voordat een wijziging in deze instelling van kracht wordt. Dat wil zeggen, nadat u deze hebt ingeschakeld, moeten gebruikers mogelijk nog steeds hun e-mailadres invoeren op het aanmeldscherm.

De clusterlijst wordt bijgewerkt met uw wijzigingen.

Webex Assistant

Webex-assistent Meetings is een intelligente, interactieve virtuele vergaderingassistent die vergaderingen doorzoekbaar, actiebaar en productiever maakt. U kunt de Webex Assistant vragen actie-items op te volgen, belangrijke beslissingen te nemen en belangrijke momenten tijdens een vergadering of gebeurtenis te markeren.

Webex Assistant voor vergaderingen is gratis beschikbaar voor vergadersites met het Premium- en Standard-pakket en voor persoonlijke vergaderruimten. Support omvat zowel nieuwe als bestaande sites.

Webex Assistant voor vergaderingen inschakelen

Webex Assistant is standaard ingeschakeld voor zowel Standard- als Premium-pakket Broadworks-klanten.

Partnerbeheerders en klantorganisatiebeheerders kunnen de functie voor klantorganisaties uitschakelen via Control Hub.

Beperkingen

De volgende beperkingen bestaan voor Webex voor Cisco BroadWorks:

  • De ondersteuning is beperkt tot vergadersites met het Premium- en Standard-pakket en alleen persoonlijke vergaderruimten.

  • Transcripties voor ondertiteling worden alleen ondersteund in het Engels, Spaans, Frans en Duits.

  • Inhoud delen via e-mail is alleen toegankelijk voor gebruikers binnen uw organisatie

  • Vergaderingsinhoud is niet toegankelijk voor gebruikers buiten uw organisatie. Vergaderingsinhoud is ook niet toegankelijk wanneer deze wordt gedeeld tussen gebruikers van verschillende pakketten binnen dezelfde organisatie.

  • Met het Premium-pakket zijn transcripties na de vergadering beschikbaar, ongeacht of Webex Assistant is in- of uitgeschakeld. Als er echter lokale opname is geselecteerd, worden er geen transcripties of markeringen na de vergadering vastgelegd.

  • Met het standaardpakket is de optie Vergadering opnemen in de cloud niet beschikbaar en zijn transcripties na de vergadering dus niet beschikbaar, ongeacht of Webex Assistant is in- of uitgeschakeld. Als lokale opname is geselecteerd, worden zelfs transcripties of markeringen na de vergadering niet vastgelegd.

Aanvullende Informatie Over Webex Assistant

Zie Webex Assistant gebruiken in Webex Meetings en Events voor gebruikersinformatie over het gebruik van de functie.

Webex-gesprekken uitschakelen

Gratis bellen via Webex is standaard ingeschakeld zodat gebruikers gratis gesprekken kunnen voeren naar elk apparaat waarvoor Webex is ingeschakeld. Als u echter wilt dat alle gesprekken de BroadWorks-infrastructuur gebruiken, kunt u Webex-gesprekken binnen een onboardsjabloon uitschakelen. Hiermee schakelt u die optie uit voor de klantorganisaties die de sjabloon gebruiken.

Functieondersteuning

Wanneer Webex Calling is uitgeschakeld, zijn de volgende voorwaarden van toepassing op Webex voor Cisco BroadWorks-gebruikers:

  • Gebruikers zien Bellen met Webex niet meer als een selecteerbare gespreksoptie in de Webex-app.

  • Gebruikers kunnen geen gratis Webex-gesprekken plaatsen of ontvangen naar niet-Webex voor Cisco BroadWorks-gebruikers. Dit omvat gesprekken die zijn gestart vanuit een Webex-teamruimte, gespreksgeschiedenis, contactpersonen door de URI of het e-mailadres van de andere gebruiker in te voeren in de zoekbalk.

  • Scherm delen werkt binnen een BroadWorks-gesprek.

  • Webex-vergaderingen en telefonische aanwezigheid werken nog steeds, zelfs als Webex-gesprekken zijn uitgeschakeld.

Webex-gesprekken uitschakelen (nieuwe onboardsjabloon)

Tijdens het configureren van een nieuwe onboardsjabloon kunt u configureren of Webex-gesprekken worden in- of uitgeschakeld door het selectievakje Gratis bellen via Cisco Webex uitschakelen in de wizard Een nieuwe sjabloon toevoegen in te schakelen of uit te schakelen. Deze instelling wordt opgehaald voor gebruikers in klantorganisaties die u aan de sjabloon toewijst.

Zie Uw partnerorganisatie configureren in Partner Hub voor meer informatie over het configureren van een nieuwe integratiesjabloon.

Webex-gesprekken uitschakelen (bestaande onboardsjabloon)

Volg deze procedure om Webex-gesprekken uit te schakelen van een bestaande integratiesjabloon. Hiermee wordt de functie uitgeschakeld voor alle nieuwe gebruikers in klantorganisaties die deze sjabloon gebruiken.

  1. Meld u aan bij Partnerhub op admin.webex.com.

  2. Kies Instellingen.

  3. Klik op Sjabloon weergeven en kies de juiste onboardingsjabloon.

  4. Klik op Cisco Webex Free Calling uitschakelen.

  5. Klik op Opslaan.

Webex-gesprekken uitschakelen (bestaande gebruiker)

Als u deze functie uitschakelt op een onboardsjabloon, wordt de instelling alleen gewijzigd voor nieuwe gebruikers die zijn toegewezen aan de sjabloon. Als u Webex-gesprekken wilt uitschakelen voor een bestaande gebruiker, kunt u een van de onderstaande procedures volgen om de gebruiker bij te werken.


 
Zorg ervoor dat u al een van de bovenstaande procedures hebt voltooid om Webex-gesprekken uit te schakelen van de onboardsjabloon waaraan de gebruiker is toegewezen. Anders configureert een van de onderstaande procedures de gebruiker opnieuw met Webex-gesprekken ingeschakeld.

Als u flow-through provisioning gebruikt, kunt u het volgende doen:

  1. Open CommPilot en ga naar de gebruikersconfiguratie.

  2. Verwijder de geïntegreerde IM+P-service van de gebruiker en klik op OK.

  3. Voeg de geïntegreerde IM+P-service toe aan de gebruiker en klik op OK.

Anders kunt u de API gebruiken om de gebruiker bij te werken.

  1. Gebruik de Een BroadWorks-abonnee-API verwijderen om de gebruiker te verwijderen.

  2. Gebruik de Een BroadWorks-abonnee-API inrichten om de gebruiker toe te voegen.

Video of scherm delen uitschakelen in gesprekken

Partnerbeheerders kunnen configuratietags gebruiken om videogesprekken en/of scherm delen uit te schakelen in een gesprek vanuit de Webex-app (beide mediatypen zijn standaard ingeschakeld voor gesprekken).

Zie Videogesprekken uitschakelen en Scherm delen uitschakelen in de configuratiehandleiding van Webex voor Cisco BroadWorks voor meer informatie over de configuratie en opties.


 
Voor video kunt u ook configureren of media voor inkomende gesprekken standaard alleen video of audio zijn.

Busy Lamp Field (BLF)/melding voor gesprek opnemen

Busy Lamp Field (BLF)/melding voor gesprek opnemen maakt gebruik van de functies BLF en doorverbonden gesprek opnemen. Een BLF-gebruiker ontvangt een auditieve en visuele melding in de Webex-app wanneer een gebruiker uit de BLF-bewaakte lijst een binnenkomend gesprek ontvangt. De BLF-gebruiker kan het gesprek van de gecontroleerde gebruiker negeren of opnemen.

De BLF-/Call Pickup-melding helpt in situaties waarin een gebruiker gesprekken moet beantwoorden voor andere teamleden die op een andere locatie werken.

Gebruikers kunnen hun door BLF gecontroleerde lijst ook zien in het gedeelte Multi-gespreksvenster - Wachtlijst - (alleen Windows, Mac niet ondersteund) om de aanwezigheid van hun Webex- en niet-Webex-teamleden te zien. Voor hulp bij het inschakelen van meerdere gesprekken raadpleegt u: Venster met meerdere gesprekken

Webex-leden hebben een volledige Webex-aanwezigheid. Niet-Webex-leden moeten worden gesynchroniseerd met een telefoonlijst in Webex. Ze hebben alleen de status 'onbekend' en 'in-a-call' (de belstatus activeert het dialoogvenster voor gesprek opnemen).

Beperkingen van aanwezigheid voor niet-Webex-gebruikers:

  1. Aanwezigheid wordt niet ondersteund voor niet-CI Broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.

  2. CI-gebruikers zonder Webex-cloudrechten of computertype accounts (werkplekken) geven alleen aanwezigheid 'in gesprek' en 'onbekend' weer. Er is geen status actief, overgaan, enz.

  3. Niet-Webex-gebruikers uit de BLF-volglijst, die een gesprek hebben gestart voordat de Webex-client werd gestart of terwijl deze offline was, worden weergegeven met een 'onbekende' aanwezigheid.

  4. Als u uw verbinding verliest, worden alle niet-Webex-gespreksstatussen bij het opnieuw verbinden teruggezet op 'onbekend'.

  5. Als een niet-Webex-gebruiker van de BLF een gesprek heeft, wordt dit gesprek nog steeds weergegeven als 'in een gesprek'.

Vereisten

Zorg ervoor dat de volgende patches worden toegepast op BroadWorks. Installeer alleen de patches die van toepassing zijn op uw versie:

Voor R22:

  • AP.platform.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382053

  • AP.as.22.0.1123.ap382362

  • AP.xsp.22.0.1123.ap382053

  • AP.xsp.22.0.1123.ap382362

  • AP.as.22.0.1123.ap383459

  • AP.as.22.0.1123.ap383520

Voor R23:

  • AP.platform.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382053

  • AP.as.23.0.1075.ap382362

  • AP.as.23.0.1075.ap383459

  • AP.as.23.0.1075.ap383520

  • Als u XSP|ADP gebruikt:

    • AP.xsp.23.0.1075.ap382053

    • AP.xsp.23.0.1075.ap382362

  • Als u ADP gebruikt:

    • Xsi-Actions-23_2022.01_1.200.bwar

    • Xsi-Events-23_2022.01_1.201.bwar (of hoger)

Voor R24:

  • AP.as.24.0.944.ap382053

  • AP.as.24.0.944.ap382362

  • AP.as.24.0.944.ap383459

  • AP.as.24.0.944. ap383520

  • Xsi-Actions-24_2022.01_1.200.bwar

  • Xsi-Events-24_2022.01_1.201.bwar (of hoger)

Zorg ervoor dat de volgende configuratietags zijn ingeschakeld in de Webex-app:

  • <busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">

  • <display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>

  • <notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>(deze tag is optioneel)

U moet functie 101642 Verbeterd Xsi-mechanisme Voor Teamtelefonie activeren op de AS:

AS_CLI/System/ActivatableFeature> activate 101642

Inschakelen X-BroadWorks-Remote-Party-Info op de AS met de onderstaande CLI-opdracht omdat voor sommige SIP-gespreksstromen deze functie nodig is:

AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Zorg ervoor dat de volgende services zijn toegewezen aan gebruikers:

  • De service Doorverbonden gesprek aannemen toewijzen voor alle gebruikers

  • Busy Lamp Field instellen voor gebruikers


 
Elke verwijzing naar XSP omvat XSP of ADP.

Busy Lamp Field configureren op BroadWorks

Partnerbeheerders kunnen de volgende procedure gebruiken om Busy Lamp Field in te stellen voor een gebruiker.

  1. Meld u aan bij BroadWorks CommPilot.

  2. Ga voor een geselecteerde gebruiker naar Clienttoepassingen en configureer het Busy Lamp Field.

  3. Voeg de URL van de BLF-lijst toe die wordt gecontroleerd.

  4. Gebruik de zoekparameters om gebruikers te zoeken en toe te voegen aan de lijst Bewaakte gebruikers.

  5. Klik op OK.

Slido Integratieondersteuning

Webex voor Cisco BroadWorks ondersteunt integratie van de Webex-app met Slido.

Slido is een eenvoudig te gebruiken tool voor betrokkenheid van het publiek. Het helpt mensen om het meeste uit vergaderingen te halen door de kloof tussen sprekers en hun publiek te overbruggen. Wanneer Slido is geïntegreerd in uw Control Hub-organisatie, kunnen uw gebruikers de Slido app toevoegen aan hun vergaderingen in de Webex-app. Deze integratie biedt extra vraag en antwoord en enquêtefunctionaliteit voor de vergadering.

Zie SlidoIntegreren met Webex-appSlido voor meer informatie over het implementeren en gebruiken met de Webex-app.

Webex-beschikbaarheid: In een agendavergadering

Wanneer u een vergadering in uw Outlook-client hebt geaccepteerd die een afspraak, ad-hocvergadering of een niet-Webex-vergadering is, wordt uw Webex-beschikbaarheid weergegeven als 'In een agendavergadering'. Deze beschikbaarheid laat uw collega's weten dat u anders betrokken bent en dat een reactie kan worden vertraagd.

Deze functie inschakelen:

  1. ga naar het tabblad Algemeen van uw tabblad Instellingen in Windows of Voorkeuren op de Mac.

  2. Schakel het selectievakje Weergeven in een agendavergadering in.


 
Voor gebruikers met ingeschakelde Outlook-aanwezigheidsintegratie wordt 'In een agendavergadering' in Webex toegewezen aan 'Bezet' in Outlook.

Caveat

Om deze functie te laten werken, moet de Webex-app en de Outlook-client tegelijkertijd worden uitgevoerd.

We werken momenteel aan de ondersteuning van de optie 'Show as Working Elsewhere' in Outlook om een gebruiker niet weer te geven als 'In een agendavergadering' in Webex.

Als een gebruiker ervoor kiest om 'Weergeven wanneer in een agendavergadering' uit te schakelen terwijl hij of zij momenteel in een agendavergadering zit, wordt zijn of haar aanwezigheid pas bijgewerkt wanneer de vergadering is beëindigd. Hiervoor moet de client opnieuw worden gestart om op te halen.

Automatisch beantwoorden met toon

Met automatisch beantwoorden met toon kunnen gebruikers bellen vanuit een app van derden, zoals Contact Center, en wordt het gesprek automatisch gerouteerd via de Webex-app op hun bureaublad. Wanneer de Webex-app de andere partij belt, hoort de gebruiker een bepaalde toon met het advies dat het gesprek wordt verbonden.

Voor een Webex voor Cisco BroadWorks-gebruiker om deze functie te gebruiken:

  • De functie wordt alleen ondersteund op de weergave van de primaire lijn

  • De Webex-app moet de primaire lijnweergave zijn

  • De %ENABLE_AUTO_ANSWER_WXT%-tag moet zijn ingeschakeld

Als de gebruiker ook Gedeelde gespreksweergaven heeft (een bureautelefoon wordt bijvoorbeeld geconfigureerd als een van de weergaven van de secundaire lijn), wordt de functie nog steeds ondersteund op de primaire weergave zolang de weergaven van gedeelde gesprekken zijn geconfigureerd om geen inkomende gesprekken te ontvangen. Dit kan worden bereikt door een van de volgende drie voorwaarden te configureren in BroadWorks voor alle gedeelde gespreksweergaven:

  • Alle weergaven voor Click-to-Dial-gesprekken waarschuwen is uitgeschakeld in de configuratie voor weergave gedeeld gesprek. Dit is de aanbevolen aanpak

    of

  • Beëindiging toestaan op deze locatie moet zijn uitgeschakeld voor alle gedeelde gespreksweergaven of

    of

  • Locaties zijn uitgeschakeld voor alle weergaven van gedeelde gesprekken

Capaciteit verhogen

XSP|ADP-bedrijven

We raden u aan de capaciteitsplanner te gebruiken om te bepalen hoeveel extra XSP|ADP-resources u nodig hebt voor de voorgestelde toename van het aantal abonnees. Voor de speciale NPS of Webex voor Cisco BroadWorks-boerderijen hebt u de volgende schaalbaarheidsopties:

  • Schaalspecifieke boerderij: Voeg een of meer XSP|ADP-servers toe aan het bedrijf die extra capaciteit nodig hebben. Installeer en activeer dezelfde set toepassingen en configuraties als de bestaande knooppunten van de boerderij.

  • Specifieke boerderij toevoegen: Voeg een nieuwe, specifieke XSP|ADP-boerderij toe. U moet een nieuw cluster en nieuwe sjablonen maken in Partner Hub, zodat u nieuwe klanten kunt toevoegen op de nieuwe boerderij om de druk op de bestaande boerderij te verlichten.

  • Gespecialiseerde boerderij toevoegen: Als u knelpunten ondervindt voor een bepaalde service, wilt u mogelijk een afzonderlijke XSP|ADP-farm creëren voor dat doel, rekening houdend met de vereisten voor co-residency vermeld in dit document. Mogelijk moet u uw Control Hub-clusters en DNS-vermeldingen opnieuw configureren als u de URL wijzigt van de service met een nieuwe boerderij.

In alle gevallen is het uw verantwoordelijkheid om uw BroadWorks-omgeving te controleren en te bevoorraden. Als u Cisco-ondersteuning wilt inschakelen, kunt u contact opnemen met uw accountvertegenwoordiger, die professionele services kan regelen.

HTTP-servercertificaten beheren

U moet deze certificaten voor mTLS-geverifieerde webtoepassingen beheren op uw XSP|ADP's:

  • Ons certificaat voor de vertrouwensketen van de Webex-cloud

  • De certificaten van uw XSP|ADP HTTP-serverinterfaces

Vertrouwensketen

U downloadt het certificaat van de vertrouwensketen van Control Hub en installeert het op uw XSP|ADP's tijdens uw eerste configuratie. We verwachten dat u het certificaat bijwerkt voordat het verloopt en u informeert over hoe en wanneer u het kunt wijzigen.

Uw HTTP-serverinterfaces

De XSP|ADP moet een openbaar ondertekend servercertificaat presenteren aan Webex, zoals wordt beschreven in Certificaten bestellen. Er wordt een zelfondertekend certificaat gegenereerd voor de interface wanneer u de interface voor het eerst beveiligt. Dit certificaat is één jaar geldig vanaf die datum. U moet het zelfondertekende certificaat vervangen door een openbaar ondertekend certificaat. Het is uw verantwoordelijkheid om een nieuw certificaat aan te vragen voordat het verloopt.

Beperkt door partnermodus

Beperkt door de partnermodus is een Partner Hub-instelling die partnerbeheerders kunnen toewijzen aan specifieke klantorganisaties om de organisatie-instellingen te beperken die klantbeheerders kunnen bijwerken in Control Hub. Wanneer deze instelling is ingeschakeld voor een bepaalde klantorganisatie, hebben alle klantbeheerders van die organisatie, ongeacht hun rolrechten, geen toegang tot een set beperkte besturingselementen in Control Hub. Alleen een partnerbeheerder kan de beperkte instellingen bijwerken.


 
Beperkt door de partnermodus is een instelling op organisatieniveau in plaats van een rol. De instelling beperkt echter specifieke rolrechten voor klantbeheerders in de organisatie waarop de instelling wordt toegepast.

Toegang als klantbeheerder

Klantbeheerders ontvangen een melding wanneer de modus Beperkt door partner wordt toegepast. Nadat ze zich hebben aangemeld, zien ze een meldingsbanner boven aan het scherm, direct onder de Control Hub-koptekst. De banner informeert de klantbeheerder dat de beperkte modus is ingeschakeld en dat deze bepaalde gespreksinstellingen mogelijk niet kan bijwerken.

Voor een klantbeheerder in een organisatie waar de modus Beperkt door partner is ingeschakeld, wordt het toegangsniveau van Control Hub bepaald met de volgende formule:

(Toegang tot Control Hub) = (rechten van organisatierol) - (beperkt door beperkingen in de partnermodus)

Beperkingen

Wanneer de modus Beperkt door partner is ingeschakeld voor een klantorganisatie, hebben klantbeheerders in die organisatie geen toegang tot de volgende Control Hub-instellingen:

  • In de weergave Gebruikers zijn de volgende instellingen niet beschikbaar:

    • De knop Gebruikers beheren is grijs.

    • Gebruikers handmatig toevoegen of wijzigen: er is geen optie om gebruikers handmatig of via CSV toe te voegen of te wijzigen.

    • Gebruikers claimen: niet beschikbaar

    • Licenties automatisch toewijzen: niet beschikbaar

    • Adreslijstsynchronisatie -Kan instellingen voor directorysynchronisatie niet bewerken (deze instelling is alleen beschikbaar voor beheerders op partnerniveau).

    • Gebruikersgegevens: gebruikersinstellingen zoals voornaam, achternaam, weergavenaam en primair e-mailadres* kunnen worden bewerkt.

    • Pakket herstellen: er is geen optie om het pakkettype te herstellen.

    • Services bewerken: er is geen optie om de services te bewerken die zijn ingeschakeld voor een gebruiker (bijvoorbeeld Berichten, Vergaderingen, Bellen)

    • Status van services weergeven: kan de volledige status van hybride services of software-upgradekanaal niet zien

    • Primair werknummer: dit veld is alleen-lezen.

  • In de weergave Account zijn de volgende instellingen niet beschikbaar:

    • Bedrijfsnaam is alleen-lezen.

  • In de weergave Organisatie-instellingen zijn de volgende instellingen niet beschikbaar:

    • Domein: toegang is alleen-lezen.

    • E-mail: de instellingen voor E-mailuitnodiging beheerder onderdrukken en Landinstelling e-mailadres zijn alleen-lezen.

    • Verificatie: er is geen optie om de instellingen Verificatie en SSO te bewerken.

  • In het menu Bellen zijn de volgende instellingen niet beschikbaar:

    • Gespreksinstellingen: de instellingen voor gespreksprioriteit van de appopties zijn alleen-lezen.

    • Belgedrag: instellingen zijn alleen-lezen.

    • Locatie > PSTN: de opties Lokale gateway en Cisco PSTN zijn verborgen.

  • Onder SERVICES worden de serviceopties Migraties en Verbonden UC onderdrukt.

Beperkt door partnermodus inschakelen

Partnerbeheerders kunnen de onderstaande procedure gebruiken om: Beperkt door partnermodus voor een bepaalde klantorganisatie (de standaardinstelling is ingeschakeld).

  1. Meld u aan bij Partnerhub ( https://admin.webex.com) en selecteer Klanten.

  2. Selecteer de toepasselijke klantorganisatie.

  3. Schakel in de instellingenweergave aan de rechterkant de Beperkt door partnermodus toggle om de instelling in te schakelen.

    Als u de modus Beperkt door partner wilt uitschakelen, schakelt u de schakelaar uit.


 

Als de partner de beperkte beheermodus voor een klantbeheerder verwijdert, kan de klantbeheerder het volgende uitvoeren:

  • Webex voor groothandels toevoegen (met de knop)

  • Pakketten voor een gebruiker wijzigen

Partneranalyses

Dankzij verbeteringen in Control Hub kunnen partnerbeheerders eenvoudig pakketgegevens weergeven en bijwerken namens hun gebruikers. Deze functie biedt partners de mogelijkheid om een totaaloverzicht van alle klanten te krijgen en bevat de volgende details:

  • Totaal aantal gebruikers per pakket (Softphone, Basic, Standard, Premium)

  • Gebruiker per pakkettrend (dagelijks/wekelijks/maandelijks)

  • Klanten met het aantal toegewezen pakketten

Raadpleeg het Webex artikel voor volledige informatie over het gebruik van Partner Analytics Analyse voor Webex voor groothandel en Webex voor Broadworks-pakketten in Partner Hub .

API's voor factureringsrapport

Webex for Developers biedt openbare API's die kunnen worden gebruikt voor maandelijkse factureringsrapporten. Partnerbeheerders kunnen deze API's gebruiken om factureringsrapporten te maken, op te sommen, op te halen en te verwijderen. De volgende tabel bevat de API's, het type toegang dat vereist is en de rolvereisten.

API voor facturering

Doel

Type toegang

Rolvereiste voor API

(Beheerder vereist ten minste één van deze rollen)

Een BroadWorks-factureringsrapport maken

Wordt gebruikt om een factureringsrapport te genereren.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

BroadWorks-factureringsrapporten weergeven

Wordt gebruikt om de rapporten weer te geven die beschikbaar zijn om te bekijken.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks-factureringsrapport ophalen

Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen.

Leestoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

  • Alleen-lezenbeheerder

Een BroadWorks-factureringsrapport verwijderen

Wordt gebruikt om een gegenereerd rapport te verwijderen.

Schrijftoegang

  • Volledige beheerder

  • Volledige verkoopbeheerder

Factureringsvelden

In de volgende tabel worden de velden weergegeven die in het gegenereerde rapport zijn opgenomen.

Veld

Beschrijving

resellerNaam

Partnernaam of organisatie-id van partner

billingId

Unieke facturerings-id of C-nummer van partner

spEnterprise-id

De door de serviceprovider geleverde unieke id voor de onderneming van de abonnee.

Intern

De status van de interne proefperiode van de klant (ja/nee)

userId

De gebruikers-id van de abonnee op BroadWorks

abonnee-id

Een unieke id voor de abonnee in kwestie in Webex

zelf geactiveerd

Ja/Nee

eersteStartdatum

Datum waarop de abonnee is ingericht.

factureringStartdatum

Datum waarop facturering begint in deze maand

Einddatum facturering

Datum waarop facturering deze maand eindigt

pakket

Het pakkettype dat in rekening wordt gebracht

hoeveelheid

Geprorateerde hoeveelheid voor facturatie.

  • 1: geeft een volledige maand aan


 
  • Nadat u een factureringsrapport voor een specifieke periode hebt gegenereerd, kunt u dat rapport niet opnieuw genereren, tenzij u eerst het bestaande rapport verwijdert.

  • Als u het pakkettype of de BroadWorks-gebruikers-id voor een bepaalde gebruiker wijzigt, worden in het rapport voor de maand waarin de wijziging heeft plaatsgevonden meerdere vermeldingen voor die gebruiker weergegeven met afzonderlijke geprorateerde vermeldingen voor en na de wijziging.

Problemen met Webex voor Cisco BroadWorks oplossen

Abonneren op de statuspagina van Webex

Controleer eerst https://status.webex.com wanneer u een onverwachte onderbreking van de service ervaart. Als u uw configuratie in Control Hub of BroadWorks niet hebt gewijzigd vóór de onderbreking, controleert u de statuspagina. Lees meer over het abonneren op status- en incidentmeldingen in het Webex-helpcentrum.

Analyse van Control Hub gebruiken

Webex houdt gebruiks- en kwaliteitsgegevens bij voor uw organisatie en de organisaties van uw klant. Lees meer over de Control Hub-analyse in het Webex-helpcentrum.

Netwerkproblemen

Klanten of gebruikers worden niet gemaakt in Control Hub met flowthrough-inrichting:

  • Kan de toepassingsserver de inrichtings-URL bereiken?

  • Zijn het inrichtingsaccount en het wachtwoord correct? Bestaat dat account in BroadWorks?

Clusters falen consequent in verbindingstests:


 

Er wordt verwacht dat de mTLS-verbinding met de verificatieservice mislukt wanneer u het eerste cluster in Partner Hub maakt, omdat u het cluster moet maken om toegang te krijgen tot de Webex-certificaatketen. Zonder dat kunt u geen vertrouwensanker maken voor de verificatieservice XSP|ADP's. De mTLS-verbinding testen vanuit Partner Hub is dus niet gelukt.

  • Zijn de XSP|ADP-interfaces openbaar toegankelijk?

  • Gebruikt u de juiste poorten? U kunt een poort invoeren in de interfacedefinitie op het cluster.

Validatie van interfaces mislukt

Xsi-acties en Xsi-events-interfaces:

  • Controleer of de interface-URL's juist zijn ingevoerd op het cluster in Partner Hub, inclusief de /v2.0/ aan het einde van de URL's.
  • Controleer of de firewall communicatie tussen Webex en deze interfaces mogelijk maakt.

  • Bekijk het advies voor interfaceconfiguratie in dit document.

Interface voor verificatieservice:

  • Controleer of de interface-URL's juist zijn ingevoerd op het cluster in Partner Hub, inclusief de /v2.0/ aan het einde van de URL's.
  • Controleer of de firewall communicatie tussen Webex en deze interfaces mogelijk maakt.

  • Bekijk het advies voor interfaceconfiguratie in dit document, met bijzondere aandacht voor:

    1. Zorg ervoor dat u RSA-sleutels hebt gedeeld met alle XSP|ADP's.
    2. Zorg ervoor dat u op alle XSP|ADP's de AuthService-URL voor de webcontainer hebt opgegeven.
    3. Als u de TLS-coderingsconfiguratie hebt bewerkt, controleert u of u de juiste naamgevingsconventie hebt gebruikt. Voor de XSP|ADP moet u de IANA-naamnotatie voor de TLS-cijfers invoeren. In een eerdere versie van dit document zijn de vereiste versleutelingssuites onjuist vermeld in de naamgevingsconventie van OpenSSL.
    4. Als u mTLS gebruikt met de verificatieservice, worden de Webex-clientcertificaten dan geladen in uw XSP|ADP/ADP-vertrouwensarchief? Is de app (of de interface) geconfigureerd om clientcertificaten te vereisen?

    5. Als u CI-tokenvalidatie gebruikt met de verificatieservice, is de app (of interface) dan geconfigureerd om geen clientcertificaten te vereisen?

Clientproblemen

Controleer of de client is verbonden met BroadWorks

  1. Meld u aan bij de Webex-app.

  2. Controleer of het pictogram Gespreksopties (een handset met een versnelling erboven) aanwezig is op de zijbalk.

    Als het pictogram niet aanwezig is, is de gebruiker mogelijk nog niet ingeschakeld voor de gespreksservice in Control Hub.

  3. Open het menu Instellingen/Voorkeuren en ga naar het gedeelte Telefoonservices. U ziet de status SSO-sessie Waarvoor U bent aangemeld.

    Als een andere telefoonservice, zoals Webex Calling, wordt weergegeven, gebruikt de gebruiker Webex niet voor Cisco BroadWorks.

Deze verificatie betekent:

  • De client heeft de vereiste Webex-microservices getransverseerd.

  • De gebruiker is geverifieerd.

  • De client heeft een langlevend JSON-webtoken ontvangen van uw BroadWorks-systeem.

  • De client heeft zijn apparaatprofiel opgehaald en geregistreerd bij BroadWorks.

Clientlogboeken

Alle clients van de Webex-app kunnen logboeken Verzenden naar Webex. Dit is de beste optie voor mobiele clients. U moet ook het e-mailadres van de gebruiker noteren en de geschatte tijd waarop het probleem is opgetreden als u hulp zoekt bij TAC. Zie Waar vind ik ondersteuning voor Webex voor meer informatie?

Als u handmatig logboeken moet verzamelen vanaf een Windows-pc, bevinden ze zich als volgt:

Windows-pc: C:\Users\{username}\AppData\Local\CiscoSpark

Mac:/Users/{username}/Library/Logs/SparkMacDesktop

Problemen met aanmelden gebruiker

mTLS-verificatie verkeerd geconfigureerd

Als alle gebruikers zijn getroffen, controleert u de mTLS-verbinding van Webex met uw verificatieservice-URL:

  • Controleer of de toepassing voor de verificatieservice of de interface die wordt gebruikt, is geconfigureerd voor mTLS.

  • Controleer of de Webex-certificaatketen is geïnstalleerd als vertrouwensanker.

  • Controleer of het servercertificaat op de interface/toepassing geldig is en ondertekend is door een bekende CA.

Bericht over licentieoverschrijding

Dit bericht kan voor een klant worden weergegeven in de klantweergave van Partnerhub. Dit bericht wordt weergegeven wanneer het licentiegebruik hoger is dan wat in de licentie is toegestaan. Het bericht kan worden genegeerd.

Handleiding voor probleemoplossing

Voor gedetailleerde informatie over het oplossen van problemen met Webex voor Cisco BroadWorks raadpleegt u de Handleiding voor het oplossen van problemen met Webex voor Cisco BroadWorks.

Ondersteuning

Ondersteuningsbeleid voor steady-state

De Dienstverlener is het eerste aanspreekpunt voor de eindklant (enterprise) support. Escaleer problemen die de SP niet kan oplossen naar TAC. Ondersteuning voor BroadWorks-serverversies volgt het BroadSoft-beleid van de huidige versie en twee eerdere grote versies (N-2). Lees meer op Beleid voor de levenscyclus van BroadSoft-producten sectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.

Escalatiebeleid

  • U (serviceprovider/partner) bent het eerste aanspreekpunt voor ondersteuning van eindklanten (enterprise).

  • Problemen die niet door de SP kunnen worden opgelost, worden geëscaleerd naar TAC.

BroadWorks-versies

Resources voor zelfondersteuning

  • Gebruikers kunnen ondersteuning vinden via het Webex-helpcentrum, waar er een Webex voor Cisco BroadWorks-specifieke pagina is met algemene help- en ondersteuningsonderwerpen voor de Webex-app.

  • De Webex-app kan worden aangepast met deze Help-URL en de URL van een probleemrapport.

  • Gebruikers van de Webex-app kunnen feedback of logboeken rechtstreeks vanaf de client verzenden. De logboeken gaan naar de Webex-cloud, waar ze kunnen worden geanalyseerd door Webex DevOps.

  • We hebben ook een Help Center-pagina die is toegewezen aan Help op beheerdersniveau voor Webex voor Cisco BroadWorks.

Informatie verzamelen om een serviceaanvraag in te dienen

Wanneer u fouten ziet in Control Hub, hebben ze mogelijk informatie bijgevoegd die TAC kan helpen uw probleem te onderzoeken. Als u bijvoorbeeld een traceer-id ziet voor een bepaalde fout of een foutcode, slaat u de tekst op om met ons te delen.

Probeer ten minste de volgende informatie op te nemen wanneer u een query indient of een case opent:

  • Organisatie-id van de klant en de organisatie-id van de partner (elke id is een tekenreeks van 32 hexadecimale tekens, gescheiden door koppeltekens)

  • TrackingID (ook een tekenreeks van 32 hexadecimale cijfers) als de interface of het foutbericht er een bevat

  • E-mailadres gebruiker (als een bepaalde gebruiker problemen ondervindt)

  • Clientversies (als het probleem symptomen heeft die door de client worden opgemerkt)

Webex voor BroadWorks-referentie

UC-One SaaS-vergelijking met Webex voor Cisco BroadWorks

Oplossing >

UC-One SaaS

Webex voor Cisco BroadWorks

Cloud

Cisco UC-One Cloud (GCP)

Webex-cloud (AWS)

Clients

UC-One: Mobiel, bureaublad

Receptionist, supervisor

Webex: Mobiel, Desktop, Web

Groot technologieverschil

Vergaderingen geleverd op Broadsoft Meet-technologie

Vergaderingen geleverd via Webex Meetings-technologie

Vroege veldproeven

Staging-omgeving, bètaclients

Productieomgeving, GA-klanten

Gebruikersidentiteit

BroadWorks-id diende als primaire id, tenzij de serviceprovider al SSO-integratie heeft.

 

Gebruikers-id en geheim in BroadWorks

E-mail-id in Cisco CI dient als primaire id

SSO-integratie in serviceprovider BroadWorks waarbij de gebruiker zich op dat moment verifieert met de BroadWorks-gebruikers-id en BroadWorks-geheim.

 

Gebruiker levert referenties via SSO met BroadWorks en geheim in BroadWorks

OF

Gebruikers-id en geheim in CI IdP

OF

Gebruikers-id in CI, ID en geheimen in IdP

Clientverificatie

Gebruikers leveren referenties via client

BroadWorks-tokens met een lange levensduur vereist bij gebruik van Webex-berichten

Gebruikers leveren referenties via de browser (aanmeldingspagina van Webex BIdP-proxy of CI)

Webex-toegangs- en vernieuwingstokens

Beheer / configuratie

Uw OSS/BSS-systemen en

Doorverkoopportaal

Uw OSS/BSS-systemen en Control Hub

Activering van partner/serviceprovider

Eenmalige installatie door Cisco Operations

Eenmalige installatie door Cisco Operations

Activering van klant/onderneming

Doorverkoopportaal

Control Hub

Automatisch gemaakt bij inschrijving eerste gebruiker

Activeringsopties voor de gebruiker

Zelfingeschreven

Externe IM&P instellen in BroadWorks

Geïntegreerde IM&P instellen in BroadWorks (doorgaans bedrijven)

XSP|ADP-serviceinterfaces

XSI-acties

 

XSI-gebeurtenissen

CTI (mTLS)

Verificatieservice (mTLS optioneel)

DMS

XSI-acties

XSI-acties (mTLS)

XSI-gebeurtenissen

CTI (mTLS)

Verificatieservice (TLS)

DMS

Webex installeren en aanmelden (Subscriber Perspective)

1

Download en installeer Webex. Zie Webex | De app downloaden voor meer informatie.

2

Webex uitvoeren.

Webex vraagt u naar uw e-mailadres.
3

Voer uw e-mailadres in en klik op Volgende.

4

Afhankelijk van de manier waarop uw organisatie in Webex is geconfigureerd, vindt een van de volgende handelingen plaats:

  1. Webex start een browser waarmee u de verificatie met uw identiteitsprovider kunt voltooien. Dit kan meervoudige verificatie (MFA) zijn.

  2. Webex start een browser waarin u uw BroadWorks-gebruikers-id en -wachtwoord kunt invoeren.

Webex wordt geladen nadat u bent geverifieerd met de IdP of BroadWorks.

Gegevensuitwisseling en -opslag

Deze secties bevatten details over gegevensuitwisseling en opslag met Webex. Alle gegevens worden zowel in transit als in rust versleuteld. Zie Beveiliging van de Webex-app voor meer informatie.

Onboarding serviceprovider

Wanneer u clusters en gebruikerssjablonen configureert in Webex Control Hub tijdens de onboarding van serviceproviders, wisselt u de volgende BroadWorks-gegevens uit die Webex opslaat:

  • URL Xsi-acties

  • URL van Xsi-Events

  • URL CTI-interface

  • URL verificatieservice

  • Referenties voor BroadWorks-inrichtingsadapter

Gebruikersvoorzieningen serviceprovider

Deze tabel bevat gebruikers- en bedrijfsgegevens die worden uitgewisseld als onderdeel van gebruikersvoorzieningen via de Webex-API's.

Gegevens verplaatsen naar Webex

Van

Door

Opgeslagen door Webex?

Gebruikers-id voor BroadWorks

BroadWorks, volgens API

Webex-API's

Ja

E-mail (indien SP verstrekt)

BroadWorks, volgens API

Webex-API's

Ja

E-mail (indien door gebruiker opgegeven)

Gebruiker

Portal voor gebruikersactivering

Ja

Voornaam

BroadWorks, volgens API

Webex-API's

Ja

Achternaam

BroadWorks, volgens API

Webex-API's

Ja

Primair telefoonnummer

BroadWorks, volgens API

Webex-API's

Ja

Mobiel telefoonnummer

BroadWorks, volgens API

Webex-API's

Ja

Primair toestel

BroadWorks, volgens API

Webex-API's

Ja

BroadWorks-serviceprovider-id en groeps-id

BroadWorks, volgens API

Webex-API's

Ja

Taal

BroadWorks, volgens API

Webex-API's

Ja

Tijdzone

BroadWorks, volgens API

Webex-API's

Ja

Gebruiker verwijderen

Webex voor Cisco BroadWorks API's ondersteunen zowel gedeeltelijke als volledige verwijdering van gebruikers. Deze tabel bevat alle gebruikersgegevens die zijn opgeslagen tijdens het inrichten en wat in elk scenario wordt verwijderd.

Gebruikersgegevens

Gedeeltelijke verwijdering

Volledige verwijdering

Gebruikers-id voor BroadWorks

Ja

Ja

E-mail

Nee

Ja

Voornaam

Nee

Ja

Achternaam

Nee

Ja

Primair telefoonnummer

Ja

Ja

Mobiel telefoonnummer

Ja

Ja

Extensie

Ja

Ja

BroadWorks-serviceprovider-id en groeps-id

Ja

Ja

Taal

Nee

Ja

Gebruikersaanmelding en configuratie ophalen

Webex-verificatie

Webex-verificatie verwijst naar aanmelding van gebruikers bij een Webex-app door een van de Webex-ondersteuningsmechanismen. ( BroadWorks-verificatie wordt afzonderlijk behandeld.) In deze tabel wordt het type gegevens weergegeven dat tussen de verschillende componenten van de verificatiestroom wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via de Webex-app

Webex

Beperkt toegangstoken en (onafhankelijke) IdP-URL

Webex

Gebruikersbrowser

Gebruikersgegevens

Gebruikersbrowser

Identiteitsprovider (die al gebruikersidentiteit heeft)

SAML-verklaring

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Tokens voor toegang en vernieuwing

Webex

Gebruikersbrowser

Tokens voor toegang en vernieuwing

Gebruikersbrowser

Webex-app

BroadWorks-verificatie

BroadWorks-verificatie verwijst naar aanmelding van gebruikers bij een Webex-app met hun BroadWorks-referenties. In deze tabel wordt het type gegevens weergegeven dat tussen de verschillende componenten van de verificatiestroom wordt uitgewisseld.

Gegevens verplaatsen

Van

Doel

E-mailadres

Gebruiker via de Webex-app

Webex

Token voor beperkte toegang en IdP-URL (Webex Bwks IdP-proxy)

Webex

Gebruikersbrowser

Brandinginformatie en BroadWorks-URL's

Webex

Gebruikersbrowser

BroadWorks-gebruikersreferenties

Gebruiker via browser (aanmeldingspagina met merknaam, bediend door Webex)

Webex

BroadWorks-gebruikersreferenties

Webex

BroadWorks

BroadWorks-gebruikersprofiel

BroadWorks

Webex

SAML-verklaring

Gebruikersbrowser

Webex

Verificatiecode

Webex

Gebruikersbrowser

Verificatiecode

Gebruikersbrowser

Webex

Tokens voor toegang en vernieuwing

Webex

Gebruikersbrowser

Tokens voor toegang en vernieuwing

Gebruikersbrowser

Webex-app

Melding van verlopen BroadWorks-wachtwoord tijdens aanmelden

Deze functie verbetert het aanmeldproces en bepaalt de aanmeldstroom op basis van:

Verbetering van aanmeldwaarschuwing en foutberichten:

  • Op dit moment krijgen de Wexbex voor BWKS-gebruikers die gebruikmaken van BroadWorks-verificatie en -aanmelding via de UAP geen melding dat hun wachtwoord bijna verloopt of dat ze zich niet kunnen aanmelden omdat het wachtwoord al is verlopen. Als het wachtwoord over 10 dagen of minder verloopt, ontvangt de gebruiker met deze functie een waarschuwing dat het wachtwoord bijna verloopt en wordt aangegeven hoeveel dagen er nog over zijn. De gebruiker wordt geadviseerd contact op te nemen met de partner of de koppeling Wachtwoord vergeten op het aanmeldscherm te volgen om het wachtwoord opnieuw in te stellen.
  • Als het wachtwoord is verlopen en de configuratie in BroadWorks 'enforcePasswordChangeOnExpiry' is ingesteld op waar, is de fout 'onjuiste gebruikersnaam en wachtwoord' gegooid, maar nu met deze functie is het foutbericht verbeterd: De aanmeldpoging is mislukt De combinatie van de gebruikersnaam en het wachtwoord komt niet overeen met onze gegevens of uw wachtwoord moet worden bijgewerkt. Probeer het opnieuw of neem contact op met uw beheerder om het wachtwoord bij te werken. Foutcode 100006

Aanmeldstroom beheren:

  • De partner kan de aanmelding beperken door een instelling 'w4bwks-password-expiry-fail-login' in te schakelen. Deze instelling 'kan door Cisco worden ingeschakeld op verzoek van een partner. Als BroadWorks-wachtwoord is verlopen, wordt de configuratie in BroadWorks 'enforcePasswordChangeOnExpiry' ingesteld op onwaar en wordt de instelling 'w4bwks-password-expiry-fail-login' ingeschakeld. Vervolgens wordt een fout geslingerd die zegt dat het wachtwoord x dagen geleden is verlopen, terwijl als de instellingsservice is uitgeschakeld, inloggen is toegestaan. De instelling is standaard uitgeschakeld.

De koppeling Wachtwoord vergeten op de aanmeldpagina kan door de partner worden geconfigureerd als onderdeel van de functie Geavanceerde aanpassing. Partners zouden de koppeling doorgaans configureren om de gebruiker naar een partnerportal te navigeren voor wachtwoordbeheer en het opnieuw instellen van het wachtwoord.


 

Deze functie verbetert alleen de aanmeldingservaring van de gebruiker tijdens het aanmelden van de geactiveerde gebruiker wanneer het wachtwoord op het punt staat te verlopen of al is verlopen. De functie wordt niet verwerkt als een wachtwoord verloopt terwijl de gebruiker is aangemeld bij de Webex-app. Bij de volgende aanmeldpoging krijgt de gebruiker een melding voor het verlopen van het wachtwoord.

Clientconfiguratie ophalen

Deze tabel toont het type gegevens dat tussen de verschillende componenten wordt uitgewisseld tijdens het ophalen van clientconfiguraties.

Gegevens verplaatsen

Van

Doel

Registratie

Klant

Webex

Organisatie-instellingen, inclusief BroadWorks-URL's

Webex

Klant

JWT-token voor BroadWorks

BroadWorks via Webex

Klant

JWT-token voor BroadWorks

Klant

BroadWorks

Apparaattoken

BroadWorks

Klant

Apparaattoken

Klant

BroadWorks

Configuratiebestand

BroadWorks

Klant

Gebruik bij steady-state

In dit gedeelte worden de gegevens beschreven die tussen componenten worden verplaatst tijdens herverificatie na het verlopen van een token, via BroadWorks of Webex.

In deze tabel wordt de gegevensbeweging voor bellen weergegeven.

Gegevens verplaatsen

Van

Doel

SIP-signalering

Klant

BroadWorks

SRTP-media

Klant

BroadWorks

SIP-signalering

BroadWorks

Klant

SRTP-media

BroadWorks

Klant

In deze tabel wordt de gegevensbeweging voor berichten, aanwezigheid en vergaderingen weergegeven.

Gegevens verplaatsen

Van

Doel

HTTPS REST-berichten en aanwezigheid

Klant

Webex

HTTPS REST-berichten en aanwezigheid

Webex

Klant

SIP-signalering

Klant

Webex

SRTP-media

Klant

Webex

SIP-signalering

Webex

Klant

SRTP-media

Webex

Klant

De inrichtings-API gebruiken

Toegang voor ontwikkelaars

De API-specificatie is beschikbaar op https://developer.webex.com en een handleiding voor het gebruik is te vinden op https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

U moet zich aanmelden om de API specificatie te lezen ophttps://developer.webex.com/docs/api/v1/broadworks-subscribers .

Toepassingsverificatie en autorisatie

Uw toepassing wordt geïntegreerd met Webex als een Integratie. Met dit mechanisme kan de toepassing beheertaken uitvoeren (zoals het inrichten van abonnees) voor een beheerder binnen uw partnerorganisatie.

Webex-API's volgen de OAuth 2-standaard ( http://oauth.net/2/). Met OAuth 2 kunnen integraties van derden vernieuwings- en toegangstokens verkrijgen namens de door u gekozen partnerbeheerder voor het verifiëren van API-gesprekken.

U moet eerst uw integratie met Webex registreren. Na registratie moet uw toepassing deze OAuth 2.0-autorisatietoekenningsflow ondersteunen om de benodigde vernieuwings- en toegangstokens te verkrijgen.

Zie https://developer.webex.com/docs/integrations voor meer informatie over integraties en hoe u deze OAuth 2-autorisatieflow in uw toepassing kunt opbouwen.


 

Er zijn twee rollen vereist voor het implementeren van integraties - de ontwikkelaar en de autorisatiegebruiker - en deze kunnen worden bekleed door afzonderlijke personen/teams in uw omgeving.

  • De ontwikkelaar maakt de app en registreert deze op https://developer.webex.com om de vereiste OAuth ClientID/Secret te genereren met scopes die worden verwacht voor de toepassing. Als uw toepassing wordt gemaakt door een derde partij, kan deze de toepassing registreren (als u om toegang hebt gevraagd) of kan u deze met uw eigen toegang doen.

  • De gebruiker autoriseren is het account dat de toepassing gebruikt om de API-oproepen te autoriseren, om uw partnerorganisatie, de organisaties van uw klanten of hun abonnees te wijzigen. Dit account moet de rol Volledige beheerder of Volledige verkoopbeheerder hebben in uw partnerorganisatie. Deze rekening mag niet door een derde worden aangehouden.

Naam organisatie

De organisatienaam is afhankelijk van de inrichtingsmodus die u gebruikt:

  • Enterprise-modus: de organisatienaam komt exact overeen met spEnterprise-id.

  • Serviceprovidermodus: de organisatienaam is het gedeelte groep-id van de spEnterprise-id.

De organisatienaam bevat alle spaties, hoofdletters en speciale tekens die zijn opgegeven in de oorspronkelijke spEnterprise-id.

Softwarevereisten voor BroadWorks

Zie Lifecycle Management - BroadSoft Servers.

We verwachten dat de serviceprovider "patch current" is met de nieuwste BroadWorks-patches en Release Independent (RI)-apps. De lijst met patches hieronder is de minimale vereiste voor integratie met Webex.


 
Controleer de patchnotities voor deze softwarepatches. Sommige patches hebben mogelijk aanvullende CLI-vereisten.

Versie R22

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.22.0.1123.ap364260

AP.as.22.0.1123.ap365173

AP.as.22.0.1123.ap368517

Vereist voor adreslijstsynchronisatie

AP.as.22.0.1123.ap369763

AP.as.22.0.1123.ap372989

AP.as.22.0.1123.ap372757

AP.as.22.0.1123.ap372963

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.22.0.1123.ap373197

Vereiste patch voor toepassingsserver

AP.as.22.0.1123.ap378391

AP.as.22.0.1123.ap374793

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.22.0.1123.ap377718

Vereiste patch voor de functie Gespreksopname

AP.as.22.0.1123.ap377868

AP.as.22.0.1123.ap376508

Vereiste patch voor doorstroominrichting

AP.xsp.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Profielserver

AP.ps.22.0.1123.ap372989

AP.ps.22.0.1123.ap372757

AP.ps.22.0.1123.ap378391

AP.ps.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Platform

AP.platform.22.0.1123.ap353577

AP.platform.22.0.1123.ap354313

Vereist voor NPS-verificatieproxy

AP.platform.22.0.1123.ap365173

AP.platform.22.0.1123.ap367732

AP.platform.22.0.1123.ap369433

AP.platform.22.0.1123.ap369607

Vereist voor NPS-verificatieproxy

AP.platform.22.0.1123.ap372757

AP.platform.22.0.1123.ap376508

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.platform.22.0.1123.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

XSP|ADP

AP.xsp.22.0.1123.ap354313

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap365173

AP.xsp.22.0.1123.ap368067

AP.xsp.22.0.1123.ap368601

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.xsp.22.0.1123.ap369607

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap370952

AP.xsp.22.0.1123.ap373008

AP.xsp.22.0.1123.ap372757

AP.xsp.22.0.1123.ap372433

AP.xsp.22.0.1123.ap372963

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.xsp.22.0.1123.ap378391

AP.xsp.22.0.1123.ap374677

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap375206

Vereist voor NPS-verificatieproxy

AP.xsp.22.0.1123.ap376508

Vereist voor de verificatieservice met CI-tokenvalidatie

AP.xsp.22.0.1123.ap378585

Vereist voor Unified Call History

Overig

AP.xsa.22.0.1123.ap372757

AP.xs.22.0.1123.ap372757

AP.ums.22.0.1123.ap378391

AP.nfm.22.0.1123.ap378391

Versie R23

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.23.0.1075.ap368517

Vereist voor adreslijstsynchronisatie

AP.as.23.0.1075.ap369763

AP.as.23.0.1075.ap373197

App-server configureren

AP.as.23.0.1075.ap373271

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.as.23.0.1075.ap378391

AP.as.23.0.1075.ap376509

AP.as.23.0.1075.ap377718

Vereist voor gespreksopname

AP.as.23.0.1075.ap377868

AP.as.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Profielserver

AP.ps.23.0.1075.ap378391

Platform

AP.platform.23.0.1075.ap367732

AP.platform.23.0.1075.ap370952

AP.platform.23.0.1075.ap369607

Vereist voor NPS-verificatieproxy

AP.platform.23.0.1075.ap376509

AP.platform.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

XSP|ADP

AP.xsp.23.0.1075.ap368067

AP.xsp.23.0.1075.ap369607

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap370952

AP.xsp.23.0.1075.ap373008

AP.xsp.23.0.1075.ap373271

Vereist om te upgraden van V1- naar V2-pushmeldingen

AP.xsp.23.0.1075.ap378391

AP.xsp.23.0.1075.ap374677

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap375206

Vereist voor NPS-verificatieproxy

AP.xsp.23.0.1075.ap376509

AP.xsp.23.0.1075.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Overig

Bij gebruik van ADP...

Xsi-Events-23_2021.05_1.251.bwar

Vereiste patch voor haakstatus (Presence) en Unified Call History

Versie R24

Server

Pleister

Aanvullende informatie

Toepassingsserver

AP.as.24.0.944.ap384177

Vereist voor Unified Messaging Server (UMS)

AP.as.24.0.944.ap375100

Vereist voor flowthrough-inrichting

AP.as.24.0.944.ap377718

Vereist voor gespreksopname

AP.as.24.0.944.ap377868

AP.as.24.0.944.ap378585

Vereiste patch voor haakstatus (Presence) en Unified Call History

Overig

Xsi-Events-24_2021.05_1.251.bwar

Vereiste patch voor haakstatus (Presence) en Unified Call History

Inrichtings- en activeringsstromen voor gebruikers


 

Inrichting beschrijft het toevoegen van de gebruiker aan Webex. Activering omvat e-mailvalidatie en servicetoewijzing in Webex.

E-mailadressen van gebruikers moeten uniek zijn, omdat Webex het e-mailadres gebruikt om een gebruiker te identificeren. Als u vertrouwde e-mailadressen voor de gebruikers hebt, kunt u ervoor kiezen deze automatisch te activeren wanneer u ze automatisch inricht. Dit proces is 'automatische inrichting en automatische activering'.

Automatische gebruikersinrichting en automatische activering (vertrouwde e-mailstroom)

Voorwaarden

  • Uw inrichtingsadapter wijst naar Webex voor Cisco BroadWorks (waarvoor een uitgaande verbinding van AS naar Webex Provisioning Bridge is vereist).

  • U moet geldige bereikbare e-mailadressen van eindgebruikers hebben als alternatieve id's in BroadWorks.

  • Control Hub heeft een inrichtingsaccount in de configuratie van uw partnerorganisatie.

Stap

Beschrijving

1

U noteert en neemt bestellingen voor de service op bij uw klanten.

2

U verwerkt de klantorder en richt de klant in uw systemen in.

3

Het service-inrichtingssysteem activeert de inrichting van BroadWorks. Deze stap, in het kort, maakt de onderneming en de gebruikers. Vervolgens wijst het de benodigde services en nummers toe aan elke gebruiker. Een van die diensten is de externe IM&P.

4

Met deze inrichtingsstap wordt de automatische inrichting van de klantorganisatie en gebruikers in Webex geactiveerd. (De IM&P-servicetoewijzing zorgt ervoor dat de inrichtingsadapter de Webex-inrichtings-API belt).

5

Uw systemen moeten de Webex-provisioning-API gebruiken als u het pakket later voor de gebruiker moet aanpassen (om van de standaardinstelling te veranderen).

SSO-aanmeldstroom

SAML SSO-aanmeldstroom met directe BroadWorks-verificatie (delen van resources tussen verschillende bronnen)

Hier volgt de SAML SSO-aanmeldstroom voor de Webex-app bij gebruik van BroadWorks-verificatie en wanneer Resource delen met meerdere bronnen is ingeschakeld, zodat directe verificatie naar BroadWorks mogelijk is. De afbeelding toont client- en gebruikersevenementen aan de linkerkant met tekst op de pijlen die weergeeft wat de client voor autorisatie voorziet. Stap 1 en 5 zijn gebruikersevenementen. Aan de rechterkant van de afbeelding ziet u gebeurtenissen voor aanmeldservices, samen met wat er wordt teruggestuurd naar de client.

BroadWorks-registratie en servicedetectiestroom

Hieronder volgt de BroadWorks-servicedetectiestroom die onmiddellijk volgt uit de vorige Webex SAML SSO-aanmeldstroom. De client gebruikt het toegangstoken dat is verkregen bij de registratie bij Webex-apparaatbeheer om registratie aan te vragen bij de BroadWorks-implementatie.

Alternatieve aanmeldstromen

De bovenstaande afbeeldingen gaan ervan uit dat SAML SSO-aanmelding is geconfigureerd met BroadWorks-verificatie waarvoor directe BroadWorks-verificatie is ingeschakeld (Cross-Origin Resource Sharing). Hieronder vindt u enkele alternatieve SAML SSO-aanmeldstromen:

  • BroadWorks-verificatie zonder directe BroadWorks-verificatie (delen van resources tussen verschillende bronnen):

    • Het enige verschil is in stap 5 en 6 van de Webex-aanmeldstroom. In stap 5 worden de aanmeldingsgegevens gevalideerd door de IdP-proxy (in plaats van XSI) en wordt een SAML-verklaring teruggestuurd naar de client.

    • De stroom loopt door de resterende stappen in de twee diagrammen.

    • Het SSO-token wordt niet gebruikt in deze flow.

  • SAML SSO Webex-verificatie:

    • In stap 3 van de Webex-aanmeldstroom retourneert de service Common Identity de identiteitsprovider die wordt gebruikt door Webex-verificatie.

    • Op dit moment wordt een alternatieve SAML SSO-aanmeldstroom voor Webex gestart.

Gebruikersinteracties

Aanmelden

  1. De Webex-app lanceert een browser naar Cisco Common Identity (CI) zodat gebruikers hun e-mailadres kunnen invoeren.

  2. CI ontdekt dat de gekoppelde klantorganisatie de BroadWorks IDP-proxy (IDP) heeft geconfigureerd als hun SAML IDP. CI wordt omgeleid naar de IDP die de gebruiker een aanmeldpagina aanbiedt. (De serviceprovider kan deze aanmeldpagina aanmerken.)

  3. De gebruiker voert zijn of haar BroadWorks-referenties in.

  4. Broadworks verifieert de gebruiker via de IDP. Bij succes stuurt de IDP de browser terug naar CI met een SAML-succes om de verificatieflow te voltooien (niet weergegeven in diagram).

  5. Bij succesvolle verificatie verkrijgt de Webex-app toegangstokens van CI (niet weergegeven in diagram). De client gebruikt deze om een BroadWorks langlevende Jason Web Token (JWT) aan te vragen.

  6. De Webex-app ontdekt de gespreksconfiguratie van BroadWorks en andere services van Webex.

  7. De Webex-app wordt geregistreerd bij BroadWorks.

Aanmelden vanuit het perspectief van een gebruiker

Dit diagram is de typische aanmeldingsstroom, zoals gezien door de eindgebruiker of abonnee:

  1. U downloadt en installeert de Webex-app.

  2. Mogelijk hebt u de koppeling van uw serviceprovider ontvangen of kunt u de download vinden op de pagina Webex-downloads.

  3. U voert uw e-mailadres in op het aanmeldscherm van Webex. Klik op Volgende.

  4. U wordt meestal omgeleid naar een pagina met het merk Serviceprovider.

  5. Die pagina kan u verwelkomen via uw e-mailadres.

    Als er geen e-mailadres is of als het e-mailadres onjuist is, voert u in plaats daarvan uw BroadWorks-gebruikersnaam in.

  6. Voer uw BroadWorks-wachtwoord in.

  7. Als u zich hebt aangemeld, wordt Webex geopend.

Gespreksstroom: bedrijfstelefoonlijst

Gespreksstroom: PSTN-nummer

Presentatie en delen

Een ruimtevergadering starten

Interacties met de klant

Profiel ophalen uit DMS en SIP-register met AS

  1. De client belt XSI om een apparaatbeheertoken en de URL naar het DMS op te halen.

  2. De klant vraagt zijn apparaatprofiel aan bij DMS door het token van stap 1 voor te leggen.

  3. De client leest het apparaatprofiel en haalt de SIP-referenties, adressen en poorten op.

  4. Client verzendt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.

  5. SBC stuurt het SIP REGISTER naar het AS (SBC kan een zoekopdracht uitvoeren in de NS om een AS te vinden als SBC de SIP-gebruiker nog niet kent.)

Test- en laboratoriumrichtlijnen

De volgende richtlijnen zijn van toepassing op test- en laboratoriumorganisaties:

  • Serviceproviderpartners zijn beperkt tot maximaal 50 testgebruikers die in meerdere organisaties kunnen worden ingericht.

  • Gebruikers buiten de eerste 50 testgebruikers worden gefactureerd.

  • Om een nauwkeurige verwerking op uw factuur te garanderen, moeten alle testorganisaties 'test' opnemen in de naam van de BroadWorks-organisatie.

  • Interne testorganisaties moeten worden aangewezen in Webex Control Hub. Dit is om te voorkomen dat testgebruikers worden gefactureerd als werkelijke gebruikers.

Een organisatie aanwijzen als een testorganisatie

Een organisatie aanwijzen als testorganisatie:

  1. Meld u aan bij Partner Hub en selecteer Klanten.

  2. Selecteer de juiste klant.

  3. Schakel in de rechterbedieningsbalk de schakelaar Interne testorganisatie in.

Voicemail afspelen

Zorg ervoor dat u voor voicemail de Mediaserver configureert om een van de volgende codes te gebruiken:

  • mp3

  • wav: WAV-bestanden worden ondersteund in de volgende indelingen: PCM (ondersteund op alle platforms) en DVI-ADPCM (niet ondersteund op Android

Als u wav-bestanden gebruikt, voert u de volgende CLI-opdrachten uit om de toepassingsserver en de mediaserver te configureren:

  • AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV

  • MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw

Terminologie

ACL (ACL)
Lijst met toegangscontrole
ALG
Gateway toepassingslaag
API
Toepassingsprogrammeerinterface
APNS
Apple Push-notificatieservice
AS
Toepassingsserver
ATA, VORMEN, VORMEN
Analoge telefoonoplader, adapter die analoge telefonie converteert naar VoIP
BAM
Toepassingsbeheer van BroadSoft
Basisverificatie
Een verificatiemethode waarbij een account (gebruikersnaam) wordt gevalideerd met een gedeeld geheim (wachtwoord)
BMS, (VER)LEIDEN
BroadSoft-berichtenserver
BOSJE
Bidirectionele stromen via synchrone HTTP
BRAADSTUK
Basic Rate Interface BRI is een ISDN-toegangsmethode
Bundel
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (cfr. Pakket)
CA
Certificeringsinstantie
Provider
Een organisatie die telefonieverkeer afhandelt (cfr. Partner, serviceprovider, Value Added Reseller)
CAPTCHA
Volledig geautomatiseerde Public Turing-test om computers en mensen uit elkaar te houden
CCXML
Taal voor eXtensible Markup voor gespreksbeheer
CIF
Algemeen Tussenformaat
CLI, VASTBINDEN
Opdrachtregelinterface
CN
Algemene naam
CNPS, CNPS
Pushserver voor gespreksmeldingen. Een pushserver voor meldingen die wordt uitgevoerd op een XSP|ADP in uw omgeving, om gespreksmeldingen naar FCM en APNS te pushen. Zie NPS-proxy.
CPE
Gebouwapparatuur van de klant
CPR, AFLEIDEN
Aangepaste aanwezigheidsregel
CSS, CVS
Cascade-stijlblad
CSV
Door komma's gescheiden waarde
CTI
Integratie van computertelefonie
CUBE
Cisco Unified Border Element
DMZ
Gedemilitariseerde zone
DN
Telefoonlijstnummer
Niet storen
Niet storen
DNS
Domeinnaamsysteem
DPG
Bel peergroep
DSCP
Punt Gedifferentieerde Servicecode
DTAF
Archiefbestand van apparaattype
DTG
Bestemmings-trunk-groep
DTMF
Dubbele toon met meerdere frequenties
Eindgebruiker
De persoon die de services gebruikt, die gesprekken voert, deelneemt aan vergaderingen of berichten verzendt (cf. Abonnee)
Organisatie
Een verzameling van eindgebruikers (cfr. Organisatie)
FCM
Firebase-cloudberichten
SCHAAMTE
Convergentie van vaste mobiele apparaten
Doorstroominrichting
Gebruikers maken in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' toe te wijzen in BroadWorks.
FQDN
Volledig gekwalificeerde domeinnaam (FQDN)
Volledige doorstroominrichting
Gebruikers maken en verifiëren in de Webex-identiteitsopslag door de service 'Geïntegreerde IM&P' toe te wijzen in BroadWorks en te bevestigen dat elke BroadWorks-gebruiker een uniek en geldig e-mailadres heeft.
FXO, FXO
Foreign Exchange Office is de poort die de analoge lijn ontvangt. Dit is de stekker op de telefoon of faxmachine of de stekkers op uw analoge telefoonsysteem. Het levert een on-hook/off-hook indicatie (lussluiting). Aangezien de FXO-poort is gekoppeld aan een apparaat, zoals een fax of een telefoon, wordt het apparaat vaak het 'FXO-apparaat' genoemd.
FXS, FXS
Foreign Exchange Subscriber is de poort die daadwerkelijk de analoge lijn aan de abonnee levert. Met andere woorden, het is de "plug in the wall" die een kiestoon, accustroom en belspanning levert.
GCM
Google Cloud-bericht
GCM
Galois/Counter-modus (coderingstechnologie)
VERSTOPT
Apparaat voor menselijke interface
HTTPS
Beveiligde contactdozen met hypertekstdoorschakelprotocol
IAD
Apparaat voor geïntegreerde toegang
IM&P
Instant Messaging en Aanwezigheid
IP-PSTN
Een serviceprovider die VoIP-naar-PSTN-services levert, uitwisselbaar met ITSP, of een algemene term voor 'openbare' telefonie met internetverbinding, gezamenlijk geleverd door grote telecomproviders (in plaats van door landen, zoals PSTN is)
ITSP, ITSP
Internettelefonieserviceprovider
IVR, IVR
Interactieve spraakrespons / Responder
JID
Het systeemeigen adres van een XMPP-entiteit wordt een Jabber-id of JID localpart@domain.part.example.com/resourcepart (@ . / zijn separatoren)
JSON
Java-scriptobjectnotatie
JOOD
Java Secure Socket Extension; de onderliggende technologie die veilige verbindingsfuncties biedt voor BroadWorks-servers
KEM
Toetsuitbreidingsmodule (hardware Cisco-telefoons)
LLT
Long-lived (of Long Life) Token; een zelfbeschrijvende, veilige vorm van toondertoken waarmee gebruikers langer geverifieerd kunnen blijven en niet gekoppeld zijn aan specifieke toepassingen.
MA, MA, MAMA
Berichtarchivering
MIB, MIB
Basis managementinformatie
MEVROUW
Mediaserver
mTLS
Wederzijdse verificatie tussen twee partijen met behulp van certificaatuitwisseling bij het tot stand brengen van een TLS-verbinding
MUG, MUG, MUG
Chat met meerdere gebruikers
NAT, NAT
Vertalingen van netwerkadressen
NPS
Pushserver voor meldingen; zie CNPS
NPS-proxy

Een service in Webex die korte autorisatietokens levert aan uw CNPS, zodat deze de gespreksmeldingen naar FCM en APN's en uiteindelijk naar Android- en iOS-apparaten met Webex kan pushen.

OCI, OCI
Clientinterface openen
Organisatie
Een bedrijf of organisatie die een verzameling eindgebruikers vertegenwoordigt (cfr. Onderneming)
OTG
Uitgaande trunkgroep
Pakket
Een verzameling van diensten zoals geleverd aan een eindgebruiker of abonnee (cfr. bundel)
Partner
Een agentorganisatie die samenwerkt met Cisco om producten en services te distribueren naar andere organisaties (cf. Value Added Reseller, serviceprovider, provider)
PBX
Ruilen privé-filiaal
PEM
E-mail met verbeterde privacy
PLONS
Openbaar mobiel landnetwerk
PRI, SNOEIWERK
Primary Rate Interface (PRI) is een standaard voor telecommunicatie-interface die wordt gebruikt op een digitaal netwerk voor geïntegreerde diensten (ISDN)
PS
Profielserver
PSTN
Openbaar geschakeld telefoonnetwerk
QoS
Servicekwaliteit
Doorverkoopportaal
Een website waarop de beheerder van de reseller zijn UC-One SaaS-oplossing kan configureren. Het wordt soms BAM-portal, beheerportal of beheerportal genoemd.
RTCP
Real-time beheerprotocol
RTP
Protocol voor realtime vervoer
SBC, ZWAARD
Sessie Border Controller
SCÈNE, SCÈNE
Weergave van gedeelde oproep
SD (SD)
Standaarddefinitie
SDP
Protocol voor sessiebeschrijving
SP
Serviceprovider; Een organisatie die telefonie of gerelateerde diensten levert aan andere organisaties (cf. Vervoerder, Partner, Value Added Reseller)
SIP
Protocol voor het starten van een sessie
SLET
Short-lived (of Short Life) Token (ook wel BroadWorks SSO Token genoemd); een authenticated token voor eenmalig gebruik dat wordt gebruikt om veilige toegang tot webtoepassingen te krijgen.
SMB
Kleine tot middelgrote ondernemingen
SNMP
Eenvoudig netwerkbeheerprotocol
sRTCP
secure Realtime Transfer Control Protocol (VoIP-gespreksmedia)
sRTP
beveiligd Realtime-doorverbindprotocol (VoIP-gespreksmedia)
SSL
Laag met veilige contactdozen
Abonnee
De persoon die de services gebruikt, die gesprekken voert, deelneemt aan vergaderingen of berichten verzendt (cf. Eindgebruiker)
TCP
Transmissieregelprotocol
TDM
Tijdverdeling multiplexen
TLS
Transportlagenbeveiliging
ToS
Soort service
UAP, UAP
Portal voor gebruikersactivering
UC
Unified Communications
GEBRUIKERSINTERFACE
Gebruikersinterface
U Id
Unieke id
AFMETINGEN
Berichtenserver
URI
Uniforme resource-id
URL
Uniforme bronzoeker
USS
Server voor delen
UTC
Gecoördineerde wereldtijd
UVS
Videoserver
Value Added Reseller (VAR)
Een agentorganisatie die samenwerkt met Cisco om producten en services te distribueren naar andere organisaties (cf. Vervoerder, Partner, Serviceprovider)
VGA
Grafische matrix voor video
VoIP
Voice over Internet Protocol (IP)
VXML
Taal voor uitbreidbare spraak
WebDAV
Webgedistribueerde creatie en versioning
WebRTC
Realtime webcommunicatie
WRS
WebRTC-server
XMPP
Extensible Messaging and Presence Protocol
Bijlage

Services configureren (met mTLS voor de verificatieservice)

De onderstaande procedures vervangen de procedures in het onderwerp Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's. Voltooi deze procedures alleen als u mTLS gebruikt voor de verificatieservice in plaats van CI-tokenvalidatie. Deze procedures zijn verplicht als u meerdere Webex-organisaties op dezelfde XSP|ADP-server uitvoert. Anders zijn ze optioneel.


 
Als u niet meerdere Webex-organisaties op dezelfde XSP|ADP-server uitvoert, wordt CI Token Validation (met TLS) aanbevolen voor de verificatieservice. Raadpleeg Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's voor meer informatie over het configureren van de verificatieservice en andere services.

Xsi-interfaces

Installeer en configureer de Xsi-Actions- en Xsi-Events-toepassingen zoals beschreven in de Configuratiehandleiding voor Cisco BroadWorks Xtended Services Interface.

Slechts één exemplaar van de Xsi-Events-toepassingen mag worden geïmplementeerd op de XSP|ADP die wordt gebruikt voor de CTI-interface.

Voor alle Xsi-Events die worden gebruikt voor de integratie van Broadworks met Webex moet dezelfde callControlApplicationName zijn gedefinieerd onder Applications/Xsi-Events/GeneralSettings. Bijvoorbeeld:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

Wanneer een gebruiker is geïntegreerd in Webex, maakt Webex een abonnement voor de gebruiker op de AS om telefoniegebeurtenissen te ontvangen voor aanwezigheid en gespreksgeschiedenis. Het abonnement is gekoppeld aan de callControlApplicationName en de AS gebruikt het om te weten naar welke Xsi-Events de telefonie-gebeurtenissen moeten worden verzonden.


 

Het wijzigen van de callControlApplicationName of het niet hebben van dezelfde naam op alle Xsi-Events-webapps zal invloed hebben op abonnementen en telefonie gebeurtenissen functionaliteit.

Verificatieservice configureren (met mTLS)

BroadWorks-tokens met een lange levensduur worden gegenereerd en gevalideerd door de verificatieservice die wordt gehost op uw XSP|ADP's.

Vereisten

  • Op de XSP|ADP-servers die de verificatieservice hosten, moet een mTLS-interface zijn geconfigureerd.

  • XSP|ADP's moeten dezelfde sleutels delen voor het coderen/decoderen van BroadWorks-tokens met een lange levensduur. Het kopiëren van deze sleutels naar elke XSP|ADP is een handmatig proces.

  • XSP|ADP's moeten worden gesynchroniseerd met NTP.

Configuratieoverzicht

De essentiële configuratie op uw XSP|ADP's omvat:

  • Implementeer de verificatieservice.

  • Configureer de tokenduur tot ten minste 60 dagen (laat de uitgever staan als BroadWorks).

  • RSA-sleutels genereren en delen met XSP|ADP's.

  • Geef de authService-URL op aan de webcontainer.

De verificatieservice implementeren op XSP|ADP

Op elke XSP|ADP die met Webex wordt gebruikt:

  1. Activeer de toepassing voor de verificatieservice op het pad /authService(je moet dit pad gebruiken):

    XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService

    (waarbij <version> is uw BroadWorks-versie).

  2. Implementeer de toepassing:

    XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authService

Duur token configureren

  1. Controleer de bestaande tokenconfiguratie (uren):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> get

  2. Stel de duur in op 60 dagen (max. 180 dagen):

    XSP|ADP_CLI/Applications/authenticationService/TokenManagement> set tokenDurationInHours 1440

RSA-sleutels genereren en delen

  • U moet dezelfde openbare/privésleutelparen gebruiken voor tokencodering/decodering in alle instanties van de verificatieservice.

  • Het sleutelpaar wordt gegenereerd door de verificatieservice wanneer deze voor het eerst een token moet uitgeven.

Vanwege deze twee factoren moet u sleutels genereren op één XSP|ADP en deze vervolgens kopiëren naar alle andere XSP|ADP's.


 

Als u met de toetsen gaat fietsen of de lengte van de toetsen wijzigt, moet u de volgende configuratie herhalen en alle XSP|ADP's opnieuw starten.

  1. Selecteer één XSP|ADP om een sleutelpaar te genereren.

  2. Gebruik een client om een gecodeerd token aan te vragen van die XSP|ADP, door de volgende URL aan te vragen in de browser van de client:

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

    (Dit genereert een privaat/openbaar sleutelpaar op de XSP|ADP, als dat er nog niet was)

  3. De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:

    XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

  4. Het geëxporteerde bestand kopiëren /var/broadworks/tmp/authService.keys naar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere .keys bestand indien nodig.

  5. Importeer de sleutels op elk van de andere XSP|ADP's:

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

Geef de authService-URL aan de webcontainer

De webcontainer van de XSP|ADP heeft de authService-URL nodig zodat deze tokens kan valideren.

Op elk van de XSP|ADP's:

  1. Voeg de URL van de verificatieservice toe als een externe verificatieservice voor het communicatiehulpprogramma BroadWorks:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

  2. Voeg de URL van de verificatieservice toe aan de container:

    XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

    Hiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.

  3. Controleer de parameter met get.

  4. Start de XSP|ADP opnieuw op.

TLS en cijfers configureren op de HTTP-interfaces (voor XSI en verificatieservice)

De toepassingen Verificatieservice, Xsi-acties en Xsi-Events maken gebruik van HTTP-serverinterfaces. De TLS-configureerbaarheidsniveaus voor deze toepassingen zijn als volgt:

Meest algemeen = Systeem > Transport > HTTP > HTTP Server interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen weer te geven of te wijzigen, zijn:

Specificiteit CLI-context
Systeem (globaal)

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

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

Transportprotocollen voor dit systeem

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

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

HTTP op dit systeem

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

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

Specifieke HTTP-serverinterfaces op dit systeem

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

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

HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer>

  2. Voer de get opdracht geven en de resultaten lezen. U moet de interfaces (IP-adressen) zien en, voor elk, of ze veilig zijn en of ze clientverificatie vereisen.

Apache tomcat vereist een certificaat voor elke veilige interface; het systeem genereert een zelfondertekend certificaat als dit nodig is.

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2-protocol toevoegen aan de HTTP-serverinterface

De HTTP-interface die communiceert met de Webex-cloud moet zijn geconfigureerd voor TLSv1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Het TLSv1.2-protocol configureren in de interface van de HTTP-server:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke protocollen al gebruikt worden op deze interface.

  3. Voer de opdracht in add <interfaceIp> 443 TLSv1.2 om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

TLS-coderingsconfiguratie bewerken in de HTTP-serverinterface

De vereiste cijfers configureren:

  1. Meld u aan bij de XSP|ADP en ga naar XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

  2. Voer de opdracht in get <interfaceIp> 443 om te zien welke cijfers al gebruikt worden op deze interface. Er moet er ten minste één zijn van de door Cisco aanbevolen suites (zie XSP|ADP-identiteits- en beveiligingsvereisten in het gedeelte Overzicht).

  3. Voer de opdracht in add <interfaceIp> 443 <cipherName> om een code toe te voegen aan de interface van de HTTP-server.


     

    De XSP|ADP CLI vereist de naam van de IANA-standaard versleutelingssuite, niet de naam van de openSSL-versleutelingssuite. Bijvoorbeeld om de openSSL-code toe te voegen ECDHE-ECDSA-CHACHA20-POLY1305 in de interface van de HTTP-server gebruikt u: XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Trust configureren voor verificatieservice (met mTLS)

  1. Meld u aan bij Control Hub met uw partnerbeheerdersaccount.

  2. Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om CombinedCertChain2023.txt op uw lokale computer.


     
    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze uploadt naar de XSP|ADP's. Alle bestanden zijn vereist.
  3. Splits de certificaatketen op in twee certificaten - combinedcertchain2023.txt.

    1. Openen combinedcertchain2023.txt in een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE----- en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het oorspronkelijke bestand op als issuing2023.txt. Het oorspronkelijke bestand mag nu slechts één tekstblok bevatten, omgeven door de regels -----BEGIN CERTIFICATE----- en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv. /var/broadworks/tmp/root2023.txt en /var/broadworks/tmp/issuing2023.txt.

  5. Meld u aan bij de XSP|ADP en ga naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoeren UpdateTrust om de parameters en opdrachtindeling weer te geven.

  6. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023

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

     

    Alle aliassen moeten een andere naam hebben. webexclientroot, webexclientroot2023, webexclientissuing en webexclientissuing2023 zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang de vier ingangen uniek zijn.

  7. Bevestig dat de ankers zijn bijgewerkt:

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get

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

(Optie) mTLS configureren op het niveau van de HTTP-interface/poort

Het is mogelijk om mTLS te configureren op het niveau van de HTTP-interface/poort of per webtoepassing.

De manier waarop u mTLS inschakelt voor uw toepassing, hangt af van de toepassingen die u host op de XSP|ADP. Als u meerdere toepassingen host waarvoor mTLS nodig is, moet u mTLS inschakelen op de interface. Als u slechts één van de verschillende toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op HTTP-interface/poortniveau is mTLS vereist voor alle gehoste webtoepassingen die via deze interface/poort worden geopend.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/HttpServer> en voer de get opdracht om de raakvlakken te zien.

  3. Als u een interface wilt toevoegen en daar clientverificatie wilt vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true

    Zie de XSP|ADP CLI-documentatie voor meer informatie. In wezen de eerste true beveiligt de interface met TLS (servercertificaat wordt gemaakt indien nodig) en de tweede true dwingt de interface om clientcertificaatverificatie te vereisen (samen zijn het mTLS).

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/HttpServer> get

Interface Port Name Secure Client Auth Req Cluster Fqdn
         =======================================================
         192.0.2.7 443 XSP|ADP01.collab.example.net true false 
         192.0.2.7 444 XSP|ADP01.collab.example.net true true

In dit voorbeeld is mTLS (Client Auth Req = true) ingeschakeld op 192.0.2.7 poort 444. TLS is ingeschakeld op 192.0.2.7 poort 443.

(Optie) mTLS configureren voor specifieke webtoepassingen

Het is mogelijk om mTLS te configureren op het niveau van de HTTP-interface/poort of per webtoepassing.

De manier waarop u mTLS inschakelt voor uw toepassing, hangt af van de toepassingen die u host op de XSP|ADP. Als u meerdere toepassingen host waarvoor mTLS nodig is, moet u mTLS inschakelen op de interface. Als u slechts één van de verschillende toepassingen hoeft te beveiligen die dezelfde HTTP-interface gebruiken, kunt u mTLS configureren op toepassingsniveau.

Bij het configureren van mTLS op toepassingsniveau is mTLS vereist voor die toepassing, ongeacht de HTTP-serverinterfaceconfiguratie.

  1. Meld u aan bij de XSP|ADP waarvan u de interface configureert.

  2. Navigeren naar XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> en voer de get om te zien welke toepassingen worden uitgevoerd.

  3. Een toepassing toevoegen en hiervoor clientverificatie vereisen (wat hetzelfde betekent als mTLS):

    XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true

    Zie de XSP|ADP CLI-documentatie voor meer informatie. Daar worden de toepassingsnamen opgesomd. Het true in dit commando wordt mTLS ingeschakeld.

Bijvoorbeeld:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add 192.0.2.7 443 AuthenticationService true

De voorbeeldopdracht voegt de AuthenticationService-toepassing toe aan 192.0.2.7:443 en vereist dat de toepassing certificaten van de client aanvraagt en verifieert.

Vraag na bij get:

XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> get

Interface Ip Port Application Name Client Auth Req
         ===================================================
         192.0.2.7 443 AuthenticationService      true          

Apparaatbeheer configureren op XSP|ADP, toepassingsserver en profielserver

Profielserver en XSP|ADP zijn verplicht voor apparaatbeheer. Ze moeten worden geconfigureerd volgens de instructies in de configuratiehandleiding voor BroadWorks-apparaatbeheer.

Hoe gaat u verder?

Voor configuratie kunt u opnieuw deelnemen aan de hoofddocumentstroom via CTI-interface en gerelateerde configuratie.

Aanvullende certificaatvereisten voor wederzijdse TLS-verificatie tegen AuthService

Webex communiceert met de verificatieservice via een wederzijdse TLS-geverifieerde verbinding. Dit betekent dat Webex een clientcertificaat presenteert en dat de XSP|ADP moet valideren. Als u dit certificaat wilt vertrouwen, gebruikt u de Webex CA-certificaatketen om een vertrouwensanker op XSP|ADP (of proxy) te maken. De certificaatketen kan worden gedownload via Partner Hub:

  1. Ga naar Instellingen > BroadWorks Calling.

  2. Klik op de koppeling voor het downloadcertificaat.


 

U kunt de certificaatketen ook ophalen van https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.

De exacte vereisten voor het implementeren van deze Webex CA-certificaatketen zijn afhankelijk van hoe uw openbare XSP|ADP's worden geïmplementeerd:

  • Via een TLS bridging proxy

  • Via een TLS pass-through proxy

  • Rechtstreeks naar de XSP|ADP

In het volgende diagram wordt samengevat waar de Webex CA-certificaatketen in deze drie gevallen moet worden geïmplementeerd.

Vereisten voor wederzijds TLS-certificaat voor TLS-bridge Proxy

  • Webex presenteert een door Webex CA ondertekend clientcertificaat aan de proxy.

  • De Webex CA-certificaatketen wordt geïmplementeerd in het proxyvertrouwensarchief, zodat de proxy het clientcertificaat vertrouwt.

  • Het openbaar ondertekende XSP|ADP-servercertificaat wordt ook in de proxy geladen.

  • De proxy presenteert een openbaar ondertekend servercertificaat aan Webex.

  • Webex vertrouwt de openbare CA die het servercertificaat van de proxy heeft ondertekend.

  • De volmachthebber legt een intern ondertekend clientcertificaat voor aan de XSP|ADP’s.

    Dit certificaat moet het uitbreidingsveld Extended Key Usage van x509.v3 bevatten met het BroadWorks-OID-doel 1.3.6.1.4.1.6431.1.1.8.2.1.3 en de TLS-clientAuth. Bijv.:

    X509v3 extensions:

    X509v3 Extended Key Usage:

    1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client
                  Authentication 

     

    Houd er bij het genereren van interne clientcertificaten voor de proxy rekening mee dat SAN-certificaten niet worden ondersteund. Interne servercertificaten voor de XSP|ADP kunnen SAN zijn.

  • De XSP|ADP's vertrouwen de interne CA.

  • De XSP|ADP’s presenteren een intern ondertekend servercertificaat.

  • De proxy vertrouwt de interne CA.

Vereisten voor wederzijds TLS-certificaat voor TLS-passthrough Proxy of XSP in DMZ

  • Webex presenteert een door Webex CA ondertekend clientcertificaat aan de XSP's.

  • De Webex CA-certificaatketen wordt geïmplementeerd in het vertrouwensarchief van de XSP's, zodat de XSP's het clientcertificaat vertrouwen.

  • Het openbaar ondertekende XSP-servercertificaat wordt ook in de XSP's geladen.

  • De XSP's presenteren openbaar ondertekende servercertificaten aan Webex.

  • Webex vertrouwt de openbare CA die de servercertificaten van de XSP's heeft ondertekend.

Revisiegeschiedenis van document

De volgende tabel toont een geschiedenis van wijzigingen aan dit document in de afgelopen 12 maanden.

Datum

Versie

Beschrijving van de wijziging

27 maart 2024

2-113

  • Busy Lamp Field/Gesprek opnemen en partner-SSO bijgewerkt - gedeelte OpenID Connect.

22 maart 2024

2-112

  • Vereisten bijgewerkt in het gedeelte Niet storen synchroniseren (NST).

07 maart 2024

2-111

  • Het gedeelte Aanmeldstroom beheren is bijgewerkt in Gebruikersaanmelding en Configuratie ophalen.

24 februari 2024

2-110

  • Redactionele wijzigingen.

20 februari 2024

2-109

  • Het gedeelte Indicatie visuele spam toegevoegd onder Webex voor BroadWorks implementeren.

07 februari 2024

2-108

  • Een functie BroadWorks-melding voor het verlopen van een wachtwoord toegevoegd tijdens het aanmelden onder Webex for BroadWorks-referentie.

25 januari 2024

2-107

  • Redactionele wijzigingen.

23 januari 2024

2-106

  • Redactionele wijzigingen aangebracht in het gedeelte Gebruiker verplaatsen (met toestemming) naar Webex voor Cisco BroadWorks onder Webex beheren voor BroadWorks.

10 januari 2024

2-105

  • Redactionele wijzigingen.

20 december 2023

2-104

13 december 2023

2-103

  • Klantsjabloon is gewijzigd in 'Onboarding-sjabloon'. De oplossingshandleiding is bijgewerkt.

12 december 2023

2-102

  • Webex voor BroadWorks toevoegen aan het gedeelte Bestaande organisatie onder Webex voor BroadWorks beheren is bijgewerkt.

08 december 2023

2-101

  • Redactionele wijzigingen.

08 november 2023

2-100

  • Een opmerking toegevoegd in het gedeelte Webex voor BroadWorks toevoegen aan bestaande organisatie.

25 oktober 2023

2-99

  • R24 toegevoegd in het gedeelte Toepassingsserver configureren met inrichtingsservice-URL.

13 september 2023

2-98

  • Netwerkvereisten voor Webex voor Cisco Broadworks-koppelingen toegevoegd onder Aanbevolen documentabonnementen.

04 september 2023

2-97

  • Gedeelte Functies en beperkingen bijgewerkt onder Overzicht van Webex voor Cisco BroadWorks.

08 augustus 2023

2-96

  • Aantekeningen toegevoegd in Een BroadWorks-cluster bewerken of verwijderen in Partnerhub onder Webex beheren voor BroadWorks.

23 juni 2023

2-95

  • Het gedeelte Uw NPS voorbereiden op Webex voor Cisco BroadWorks is bijgewerkt onder Webex implementeren voor Cisco BroadWorks.

  • Het configureren van NPS voor het gebruik van Authentication Proxy connectionTimeout naar 3000 is bijgewerkt onder Webex voor Cisco BroadWorks implementeren.

30 mei 2023

2-94

  • Bijgewerkte sectie BroadWorks-softwarevereisten onder Webex voor Cisco BroadWorks-referentie.

26 mei 2023

2-93

  • Gedeelte Vertrouwensankers voor CTI-interface (R22 en hoger) bijgewerkt onder Webex implementeren voor Cisco BroadWorks.

  • Het gedeelte Vertrouwen configureren voor verificatieservice (met mTLS) is bijgewerkt onder Bijlage.

24 mei 2023

2-92

  • Het gedeelte Webex voor BroadWorks loskoppelen van bestaande organisatie is bijgewerkt onder Webex voor Cisco BroadWorks beheren.

  • Gedeelte Inbreken toegevoegd onder Webex voor Cisco BroadWorks implementeren.

10 mei 2023

2-91

  • Het gedeelte Busy Lamp Field/Call Pickup Notification is bijgewerkt onder Webex beheren voor Cisco BroadWorks.

09 mei 2023

2-90

  • Bijgewerkte sectie Land onder Uw omgeving voorbereiden.

04 mei 2023

2-89

  • Het gedeelte Uw klantsjablonen configureren is bijgewerkt onder Uw partnerorganisatie configureren in Partner Hub.

27 april 2023

2-88

  • Sectie Land toegevoegd onder Uw omgeving voorbereiden.

14 april 2023

2-87

  • Het gedeelte Ondersteuning voor groepscontactpersonen is bijgewerkt onder Bestellen en inrichten.

17 maart 2023

2-86

  • Het gedeelte Mobiel systeemeigen gesprek escaleren naar vergadering is toegevoegd onder Webex voor BroadWorks implementeren.

11 maart 2023

2-85

  • Bijgewerkte stappen in Verificatieservice configureren (met CI-tokenvalidatie) onder Webex voor Cisco BroadWorks implementeren.

10 maart 2023

2-84

  • Bijgewerkte sectie Xsi-interfaces.

07 maart 2023

2-83

  • Het gedeelte Ondersteuning voor groepscontactpersonen is toegevoegd onder Bestellen en inrichten.

28 februari 2023

2-82

  • Gedeelte Partner-SSO - OpenID Connect (OIDC) toegevoegd onder Webex voor Cisco BroadWorks implementeren.

15 februari 2023

2-81

  • Sectie Vertrouwensankers voor CTI-interface (R22 en hoger) bijgewerkt onder Webex implementeren voor Cisco BroadWorks en Vertrouwensservice configureren voor verificatieservice (met mTLS) onder Bijlage.

10 februari 2023

2-80

  • Toestelnummer bijgewerkt onder Overzicht van Webex voor Cisco BroadWorks.

Overzicht van Webex voor Cisco BroadWorks

Introductie van Webex voor Cisco BroadWorks

Revisiegeschiedenis van document

Dit gedeelte behandelt systeembeheerders bij Cisco-partnerorganisaties (serviceproviders) die Webex implementeren voor hun klantorganisaties of deze oplossing rechtstreeks aanbieden aan hun eigen abonnees.

Doel van de oplossing

  • Webex-cloudsamenwerkingsfuncties aanbieden aan kleine en middelgrote klanten die al gespreksservice hebben die wordt geleverd door BroadWorks-serviceproviders.

  • BroadWorks-gebaseerde gespreksservice aanbieden aan kleine en middelgrote Webex-klanten.

Context

We evolueren al onze samenwerkingsklanten naar een uniforme toepassing. Dit pad vermindert aannameproblemen, verbetert de interoperabiliteit en migratie en biedt voorspelbare gebruikerservaringen in ons hele samenwerkingsportfolio. Een deel van deze inspanning is het verplaatsen van de BroadWorks-gespreksmogelijkheden naar de Webex-app en uiteindelijk het verminderen van investeringen in de UC-One-clients.

Voordelen

  • Toekomstbestendigheid: tegen beëindiging van UC-One Collaborate, beweging van alle clients naar het Unified Client Framework (UCF)

  • Het beste van beide: Webex-functies voor berichten en vergaderingen inschakelen met behoud van BroadWorks-gesprekken op uw telefonienetwerk

Toepassingsgebied van de oplossing

  • Bestaande/nieuwe kleine tot middelgrote klanten (minder dan 250 abonnees) die een reeks samenwerkingsfuncties willen, hebben mogelijk al BroadWorks-gesprekken.

  • Bestaande kleine tot middelgrote Webex-klanten die BroadWorks Calling willen toevoegen.

  • Niet voor grotere ondernemingen (raadpleeg ons Enterprise-portfolio voor Webex).

  • Niet voor één gebruiker (evalueer Webex Online-aanbiedingen).

De functiesets in Webex voor Cisco BroadWorks zijn gericht op gebruiksscenario's voor kleine tot middelgrote bedrijven. De Webex voor Cisco BroadWorks-pakketten zijn ontworpen om de complexiteit voor kleine en middelgrote ondernemingen te verminderen en we evalueren voortdurend hun geschiktheid voor dit segment. We kunnen ervoor kiezen functies die anders beschikbaar zijn in de bedrijfspakketten te verbergen of te verwijderen.

Vereisten voor succes met Webex voor Cisco BroadWorks

#

Vereiste

Notities

1

Patchstroom BroadWorks R22 of hoger

2

XSP|ADP voor XSI, CTI, DMS en authService

Specifieke XSP|ADP voor Webex voor Cisco BroadWorks

3

Afzonderlijke XSP|ADP voor NPS kunnen worden gedeeld met andere oplossingen die NPS gebruiken.

Als u een bestaande implementatie voor samenwerken hebt, controleert u aanbevelingen voor XSP|ADP- en NPS-configuraties.

4

CI-tokenvalidatie (met TLS) geconfigureerd voor Webex-verbindingen met de verificatieservice.

5

mTLS is geconfigureerd voor Webex-verbindingen met de CTI-interface.

Voor andere toepassingen is geen mTLS vereist.

6

Gebruikers moeten bestaan in BroadWorks en hebben de volgende kenmerken nodig, afhankelijk van uw inrichtingsbeslissing:

  • Doorloop met vertrouwde e-mails: Het e-mailkenmerk van de BroadWorks-gebruiker moet een geldig e-mailadres bevatten dat uniek is voor die gebruiker. De gebruiker moet ook een primair nummer of toestel hebben.

  • Doorloop met niet-vertrouwde e-mails, zelfactivering of API-inrichting: Gebruiker heeft geen e-mailadres nodig, maar moet een primair nummer of toestel hebben.

Voor vertrouwde e-mails: We raden u aan hetzelfde e-mailadres ook in het kenmerk Alternatieve id in te voeren, zodat gebruikers zich met e-mailadres kunnen aanmelden bij BroadWorks.

Voor niet-vertrouwde e-mails: Afhankelijk van de e-mailinstellingen van de gebruiker kan het gebruik van niet-vertrouwde e-mails ertoe leiden dat de e-mail wordt verzonden naar de ongewenste of spammap van de gebruiker. De beheerder moet mogelijk de e-mailinstellingen van de gebruiker wijzigen om domeinen toe te staan

7

Webex voor Cisco BroadWorks DTAF-bestand voor de Webex-app

8

BW Business Lic of Std Enterprise of Prem Enterprise User Lic + Webex voor Cisco BroadWorks-abonnement

Als u een bestaande implementatie voor samenwerken hebt, hebt u geen UC-One Add-On Bundle, Collab Lic en Meet-me Conference Ports meer nodig.

Als u een bestaande UC-One SaaS-implementatie hebt, zijn er geen andere wijzigingen dan het accepteren van de voorwaarden van het Premium-pakket.

9

IP/poorten moeten toegankelijk zijn via de Webex-backend-services en de Webex-apps via openbaar internet.

Zie het gedeelte “Uw netwerk voorbereiden”.

10

TLS v1.2-configuratie op XSP|ADP's

11

Voor Flowthrough-inrichting moet de toepassingsserver verbinding maken met de BroadWorks-inrichtingsadapter.


 

We testen of ondersteunen geen uitgaande proxyconfiguratie. Als u een uitgaande proxy gebruikt, accepteert u de verantwoordelijkheid om deze te ondersteunen met Webex voor Cisco BroadWorks.

Zie het onderwerp “Uw netwerk voorbereiden”.

Over dit document

Het doel van dit document is u te helpen uw Webex for Cisco BroadWorks-oplossing te begrijpen, voor te bereiden, te implementeren en te beheren. De grote delen in het document weerspiegelen dit doel.

Deze gids bevat conceptueel en referentiemateriaal. We zijn van plan alle aspecten van de oplossing in dit ene document te behandelen.

De minimale set taken om de oplossing te implementeren zijn:

  1. Bereik uw accountteam om een Cisco-partner te worden. Het is noodzakelijk dat u de Cisco-aanrakingspunten onderzoekt om uzelf vertrouwd te maken (en getraind te worden). Wanneer u een Cisco-partner wordt, passen we de Webex voor Cisco BroadWorks-schakelaar toe op uw Webex-partnerorganisatie. (Zie Webex implementeren voor Cisco BroadWorks > Onboarding voor partners in dit document.)

  2. Configureer uw BroadWorks-systemen voor integratie met Webex. (Zie Webex implementeren voor Cisco BroadWorks > Services configureren op uw Webex voor Cisco BroadWorks XSP|ADP's in dit document.)

  3. Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)

  4. Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)

  5. Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)


 
  • Dit zijn stappen van hoog niveau, in de typische volgorde. Er zijn verschillende bijdragende taken die u niet kunt negeren.

  • Als u uw eigen toepassingen wilt maken om uw Webex voor Cisco BroadWorks-abonnees te beheren, leest u De inrichtings-API gebruiken in het gedeelte Referentie van deze handleiding.

Terminologie

We proberen het jargon en de letterwoorden in dit document te beperken en elke term uit te leggen wanneer deze voor het eerst wordt gebruikt. (Zie Webex voor Cisco BroadWorks-referentie > Terminologie als een term niet in de context wordt uitgelegd.)

Hoe het werkt

Webex voor Cisco BroadWorks is een aanbieding die BroadWorks-gesprekken integreert in Webex. Abonnees gebruiken één toepassing (de Webex-app) om gebruik te maken van functies die door beide platforms worden aangeboden:

  • Gebruikers bellen PSTN-nummers via uw BroadWorks-infrastructuur.

  • Gebruikers bellen met andere BroadWorks-nummers via uw BroadWorks-infrastructuur (audio-/videogesprekken door de nummers te selecteren die zijn gekoppeld aan de gebruikers of het toetsenblok om de nummers te introduceren).

  • Gebruikers kunnen ook een Webex VoIP-gesprek plaatsen via de Webex-infrastructuur door de optie 'Webex Call' te selecteren in de Webex-app. (Deze gesprekken zijn de Webex-app naar de Webex-app, niet de Webex-app naar PSTN).

  • Gebruikers kunnen Webex Meetings hosten en eraan deelnemen.

  • Gebruikers kunnen elkaar een voor een berichten sturen of in ruimten (permanente groepchat) en profiteren van functies als zoeken en bestanden delen (op Webex-infrastructuur).

  • Gebruikers kunnen aanwezigheid (status) delen. Ze kunnen aangepaste aanwezigheid of door de klant berekende aanwezigheid kiezen.

  • Nadat we u als partnerorganisatie hebben geïntegreerd in Control Hub, met de juiste rechten, kunt u de relatie tussen uw BroadWorks-exemplaar en Webex configureren.

  • U maakt klantorganisaties in Control Hub en richt gebruikers in deze organisaties in.

  • Elke abonnee in BroadWorks krijgt een Webex-identiteit op basis van zijn/haar e-mailadres (kenmerk e-mail-id in BroadWorks).

  • Gebruikers worden geverifieerd voor BroadWorks of voor Webex.

  • Clients krijgen langdurige tokens om ze te autoriseren voor services bij BroadWorks en Webex.

De Webex-app in het midden van deze oplossing; het is een brandbare toepassing die beschikbaar is op Mac/Windows-bureaubladen en Android/iOS-telefoons en -tablets.

Er is ook een webversie van de Webex-app die momenteel geen gespreksfuncties bevat.

De client maakt verbinding met de Webex-cloud om functies voor berichten, aanwezigheid en vergaderingen te leveren.

De client registreert zich bij uw BroadWorks-systemen voor gespreksfuncties.

De Webex-cloud werkt met uw BroadWorks-systemen om een naadloze gebruikersinrichting te garanderen.

Functies en beperkingen

Wij bieden verschillende pakketten met verschillende functies.

Softphone-pakket

Dit pakkettype gebruikt de Webex-app als een softphone only-client met belmogelijkheden, maar geen berichtmogelijkheden. Gebruikers met dit pakkettype kunnen deelnemen aan Webex-vergaderingen, maar kunnen geen vergaderingen zelf starten. Wanneer andere gebruikers (softphone of niet-softphone) in de telefoonlijst zoeken naar een softphone-gebruiker, bieden de zoekresultaten geen optie om een bericht te verzenden.

Softphone-gebruikers kunnen hun scherm delen tijdens een gesprek.

Basispakket

Het basispakket bevat functies voor bellen, chatten en vergaderen. Het omvat 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room). (** zie onderstaande Note voor uitzondering). In dit pakket kunnen de vergaderingen een maximale duur van 40 minuten hebben.

Pakket "Standaard"

Dit pakket omvat ook alles in het basispakket, zoals maximaal 100 deelnemers aan 'unified space'-vergaderingen en PMR-vergaderingen (Personal Meeting Room).

Scherm delen binnen een PMR-vergadering is een rol die in eerste instantie alleen wordt uitgeoefend door de host van de vergadering, maar de host kan de rol van presentator overdragen aan een door hem of haar gekozen deelnemer aan de vergadering. Alleen de host kan de rol van presentator opnieuw opnemen zonder dat de huidige host deze aan hem of haar heeft doorgegeven.

"Premium"-pakket

Dit pakket omvat alles in het standaardpakket plus maximaal 300 deelnemers aan een vergadering in een 'unified space' en maximaal 1000 deelnemers in een persoonlijke vergaderruimte (PMR).

Scherm delen binnen een PMR-vergadering wordt ondersteund voor elke deelnemer aan de vergadering.

Pakketten vergelijken

Pakket

Oproepen

Berichten

Unified Space-vergaderingen

PMR Meetings

Softphone

Opgenomen

Niet inbegrepen

Geen

Geen

Eenvoudig

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Standaard

Opgenomen

Opgenomen

100 deelnemers

100 deelnemers

Premium

Opgenomen

Opgenomen

300 deelnemers

1000 deelnemers


 
De limiet voor Unified Space-vergaderingen voor basisgebruikers is 100 deelnemers per Unified Space-vergadering, tenzij de ruimte ook gebruikers bevat waaraan de pakketten 'Standaard' of 'Premium' zijn toegewezen. In dat geval wordt de limiet verhoogd op basis van het gebruikerspakket van de host.

 

'Unified Space Meetings' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in een Webex-ruimte. Een gebruiker start bijvoorbeeld een vergadering vanuit de ruimte via de knoppen 'Vergaderen' of 'Plannen'.

'PMR-vergaderingen' verwijst naar een Webex-vergadering (gepland of ongepland) die plaatsvindt in de persoonlijke vergaderruimte (PMR) van een gebruiker. Deze vergaderingen gebruiken een speciale URL (bijvoorbeeld: cisco.webex.com/meet/roomOwnerUserID).

Berichten en vergaderingsfuncties

Raadpleeg de volgende tabel voor verschillen in ondersteuning van PMR-vergaderingsfuncties voor Basic-, Standard- en Premium-pakketten.

Tabel 1. Verschillen in functieondersteuning voor PMR-vergaderingen

Vergaderingsfunctie

Ondersteund met basispakket

Overgezet met standaardpakket

Ondersteund met Preminum-pakket

Opmerking

Vergaderduur

40 minuten of minder

Onbeperkt

Onbeperkt

Bureaublad delen

Ja

Ja

Ja

Basis: bureaublad delen door een PMR-vergaderingdeelnemer.

Standaard : bureaublad delen alleen door de host van de PMR-vergadering.

Premium: bureaublad delen door een deelnemer aan een PMR-vergadering.

Toepassingen delen

Ja

Ja

Ja

Basis: toepassingen delen door elke deelnemer aan een PMR-vergadering.

Standaard : toepassingen delen alleen door de host van de PMR-vergadering.

Premium: toepassingen delen door deelnemers aan een PMR-vergadering.

Chat met meerdere partijen

Ja

Ja

Ja

Whiteboarden

Ja

Ja

Ja

Wachtwoordbeveiliging

Ja

Ja

Ja

Web-app - geen downloaden of invoegtoepassingen (gastervaring)

Ja

Ja

Ja

Ondersteuning voor koppelen met Webex-apparaten

Ja

Ja

Ja

Vloerbeheer (Eén dempen / Alles verwijderen)

Ja

Ja

Ja

Koppeling voor blijvende vergaderingen

Ja

Ja

Ja

Toegang tot de Meetings-site

Ja

Ja

Ja

Deelnemen aan vergadering via VoIP

Ja

Ja

Ja

Vergrendeling

Ja

Ja

Ja

Bedieningselementen voor presentator

Nee

Nee

Ja

Extern bureaubladbeheer

Nee

Nee

Ja

Aantal deelnemers

100

100

1000

Opname lokaal opgeslagen in het systeem

Ja

Ja

Ja

Opnemen in de cloud

Nee

Nee

Ja

Opname - Cloudopslag

Nee

Nee

10 GB per locatie

Opnametranscripties

Nee

Nee

Ja

Vergaderingen plannen

Ja

Ja

Ja

Inhoud delen met externe integraties inschakelen

Nee

Nee

Ja

Basic— Inhoud delen door een deelnemer aan een PMR-vergadering.

Standaard: inhoud delen met alleen de host van de PMR-vergadering.

Premium: inhoud delen door een deelnemer aan een PMR-vergadering.

PMR-URL wijzigen toestaan

Nee

Nee

Ja

Basic— Gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL wijzigen vanuit Control Hub.

Standaard: de PMR-URL kan alleen worden gewijzigd vanuit Partner Hub door partner- en organisatiebeheerders.

Premium: gebruikers kunnen de PMR-URL wijzigen vanaf de Webex-site. Partner- en organisatiebeheerders kunnen de URL vanuit Partner Hub wijzigen.

Live streaming van vergaderingen (Bv. op Facebook, Youtube)

Nee

Nee

Ja

Andere gebruikers toestaan vergaderingen namens hen te plannen

Nee

Nee

Ja

Een alternatieve host toevoegen

Ja

Nee

Ja

App-integratie (bijv. Zendesk, Slack)

Afhankelijk van de integratie

Afhankelijk van de integratie

Ja

Zie het gedeelte App-integraties hieronder voor meer informatie over ondersteuning.

Integratie met Microsoft Office 365-agenda

Ja

Ja

Ja

Integratie met Google-agenda voor G Suite

Ja

Ja

Ja

Het Webex-helpcentrum publiceert de functies en documentatie voor gebruikers voor Webex op help.webex.com. Lees de volgende artikelen voor meer informatie over de functies:

Gespreksfuncties

De belervaring is vergelijkbaar met eerdere oplossingen die gebruikmaken van de BroadWorks-gespreksbeheermotor. Het verschil met UC-One Collaborate en UC-One SaaS is dat de Webex-app de primaire softclient is.

App-integraties

U kunt Webex voor Cisco BroadWorks integreren met de volgende toepassingen:

Ondersteuning voor Virtual Desktop Infrastructure (VDI)

Webex voor Cisco BroadWorks ondersteunt nu VDI-omgevingen (Virtual Desktop Infrastructure). Raadpleeg de Implementatiehandleiding voor Webex voor Virtual Desktop Infrastructure (VDI) voor meer informatie over de implementatie van VDI-infrastructuur.

IPv6-ondersteuning

Webex voor Cisco BroadWorks ondersteunt IPv6-adressering voor de Webex-app.

Pro-pakket voor Control Hub

De add-on onservice Pro Pack voor Control Hub biedt uw beheerders, informatiebeveiligingsprofessionals en nalevingsfunctionarissen geavanceerde functionaliteit op het gebied van beveiliging, naleving en analyse die kunnen worden geïntegreerd met uw software.

Deze aanvullende diensten zijn alleen beschikbaar voor Standard- en Premium-pakketten.

Zie de Help-pagina van het Pro-pakket voor Control Hub voor meer informatie.

Toekomstige routekaart

Ga naar https://salesconnect.cisco.com/#/program/PAGE-16649 voor meer informatie over onze voornemens voor de toekomstige versies van Webex voor Cisco BroadWorks. De items van het stappenplan zijn in geen enkele hoedanigheid bindend. Cisco behoudt zich het recht voor om een of al deze items uit toekomstige releases te onthouden of te herzien.

Beperkingen

Inrichtingsbeperkingen

Tijdzone van Meetings-site

De tijdzone van de eerste abonnee voor elk pakket wordt de tijdzone voor de Webex Meetings-site die voor dat pakket is gemaakt.

Als er geen tijdzone is opgegeven in het inrichtingsverzoek voor de eerste gebruiker van elk pakket, wordt de tijdzone van de Webex Meetings-site voor dat pakket ingesteld op de regionale standaard van de organisatie van de abonnees.

Als uw klant een specifieke tijdzone van de Webex Meetings-site nodig heeft, geeft u de timezone parameter in de inrichtingsaanvraag voor:

  • de eerste abonnee die is ingericht voor het standaardpakket in de organisatie.

  • de eerste abonnee die is ingericht voor Premium-pakket in de organisatie.

  • de eerste abonnee die is ingericht voor het basispakket in de organisatie.

Algemene beperkingen

  • Geen gesprekken in de webversie van de Webex-client (dit is een clientbeperking, geen oplossingsbeperking.)

  • Webex beschikt mogelijk nog niet over alle besturingselementen voor de gebruikersinterface om bepaalde functies voor gespreksbeheer te ondersteunen die beschikbaar zijn via BroadWorks.

  • De Webex-client kan momenteel geen 'wit label' hebben.

  • Wanneer u klantorganisaties maakt met de door u gekozen inrichtingsmethode, worden deze automatisch gemaakt in dezelfde regio als uw partnerorganisatie. Dit gedrag is zo bepaald. We verwachten van multinationale partners dat ze in elke regio een partnerorganisatie creëren waar ze klantorganisaties beheren.

  • Rapportage over het gebruik van vergaderingen en berichten is beschikbaar via de klantorganisatie in Control Hub.

Bekende problemen en beperkingen

Zie Bekende problemen en beperkingen voor een actuele lijst met bekende problemen en beperkingen met het Webex voor Cisco BroadWorks-aanbod.

Berichtenlimieten

De volgende opslaglimieten voor gegevens (berichten en bestanden gecombineerd) zijn van toepassing op organisaties die Webex voor Cisco BroadWorks-services hebben aangeschaft via een serviceprovider. Deze limieten vertegenwoordigen de maximale opslag voor berichten en bestanden gecombineerd.

  • Basis: 2 GB per gebruiker gedurende 3 jaar

  • Standaard 5 GB per gebruiker gedurende 3 jaar

  • Premie: 10 GB per gebruiker gedurende 5 jaar

Voor elke klantorganisatie worden deze totalen per gebruiker samengevoegd om een geaggregeerd totaal voor die klant op te geven, op basis van het aantal gebruikers. Een bedrijf met vijf premium-gebruikers heeft bijvoorbeeld een totale limiet voor berichten en bestandsopslag van 50 GB. Een individuele gebruiker kan de limiet per gebruiker (10 GB) overschrijden op voorwaarde dat het bedrijf nog onder het geaggregeerde maximum (50 GB) zit.

Voor teamruimten die worden gemaakt, gelden de berichtlimieten voor het geaggregeerde totaal voor de klantorganisatie die eigenaar is van de teamruimte. U vindt informatie over de eigenaar van individuele teamruimten in het ruimtebeleid. Zie https://help.webex.com/en-us/baztm6/Webex-Space-Policy voor meer informatie over het bekijken van het ruimtebeleid voor een individuele teamruimte.

Aanvullende informatie

Raadpleeg https://help.webex.com/en-us/n8vw82eb/Webex-Capacities voor meer informatie over algemene berichtbeperkingen die van toepassing zijn op Webex-ruimten van het berichtenteam.

Beveiliging, gegevens en rollen

Webex-beveiliging

De Webex-client is een veilige toepassing die veilige verbindingen maakt met Webex en BroadWorks. De gegevens die in de Webex-cloud zijn opgeslagen en via de Webex-app aan de gebruiker zijn blootgesteld, worden zowel onderweg als in rust gecodeerd.

Meer informatie over gegevensuitwisseling vindt u in het deel Referentie van dit document.

Bijkomende lectuur

Locatie organisatiegegevens

We slaan uw Webex-gegevens op in het datacenter dat het meest overeenkomt met uw regio. Zie Gegevensresidentie in Webex in het Helpcentrum.

Rollen

Beheerder serviceprovider (u): Voor dagelijkse onderhoudsactiviteiten beheert u de lokale (bel)onderdelen van de oplossing met behulp van uw eigen systemen. U beheert de Webex-onderdelen van de oplossing via Partner Hub.

Zie Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM voor informatie over de rollen die beschikbaar zijn voor partners, de toegangsrechten die bij deze rollen horen en hoe u rollen kunt toewijzen.


 
De eerste gebruiker die is ingericht voor een nieuw partnerorganizaiton, wordt automatisch toegewezen aan de rollen Volledige beheerder en Volledige partnerbeheerder. Die beheerder kan het bovenstaande artikel gebruiken om extra rollen toe te wijzen.

Cisco Cloud Operations-team: Maakt uw 'partnerorganisatie' in Partner Hub, als deze niet bestaat, tijdens uw onboarding.

Zodra u uw Partner Hub-account hebt, configureert u de Webex-interfaces met uw eigen systemen. Vervolgens maakt u 'Onboarding-sjablonen' om de suites of pakketten weer te geven die via deze systemen worden aangeboden. Vervolgens richt u uw klanten of abonnees in.

#

Typische taak

SP

Cisco

1

Onboarding voor partners - De partnerorganisatie maken als deze nog niet bestaat en de benodigde functieschakelaars inschakelen

2

BroadWorks-configuratie in partnerorganisatie via Partner Hub (cluster)

3

Integratie-instellingen configureren in de partnerorganisatie via Partner Hub (aanbiedingssjablonen, branding)

4

BroadWorks-omgeving voorbereiden voor integratie (AS, XSP|ADP Patching, firewalls, XSP|ADP-configuratie, XSI, AuthService, CTI, NPS, DMS-toepassingen op XSP|ADP)

5

Inrichtingsintegratie of -proces ontwikkelen

6

GTM-materialen voorbereiden

7

Nieuwe gebruikers migreren of inrichten

Architectuur

Wat staat er in het diagram?

Clients

  • De Webex-app-client dient als de primaire toepassing in Webex voor Cisco BroadWorks-aanbiedingen. De client is beschikbaar op desktop-, mobiele en webplatforms.

    De client heeft systeemeigen chat-, presence- en meerpartijenaudio-/videovergaderingen die door de Webex-cloud worden geleverd. De Webex-client gebruikt uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken.

  • Cisco IP-telefoons en gerelateerde accessoires gebruiken ook uw BroadWorks-infrastructuur voor SIP- en PSTN-gesprekken. We verwachten telefoons van derden te kunnen ondersteunen.

  • Activeringsportal voor gebruikers om zich aan te melden bij Webex met hun BroadWorks-aanmeldgegevens.

  • Partner Hub is een webinterface voor het beheren van uw Webex-organisatie en de organisaties van uw klanten. In Partner Hub kunt u de integratie tussen uw BroadWorks-infrastructuur en Webex configureren. U gebruikt ook Partner Hub om de clientconfiguratie en facturering te beheren.

Netwerk van serviceproviders

Het groene blok links op het diagram staat voor uw netwerk. Componenten die in uw netwerk worden gehost, bieden de volgende services en interfaces aan andere delen van de oplossing:

  • Openbare XSP|ADP, voor Webex voor Cisco BroadWorks: (De box staat voor een of meerdere XSP|ADP-boerderijen, mogelijk aan de voorkant door lastbalancers.)

    • Host de Xtended Services-interface (XSI-acties en XSI-gebeurtenissen), de Device Management-service (DMS), CTI-interface en de verificatieservice. Samen stellen deze toepassingen telefoons en Webex-clients in staat om zichzelf te verifiëren, hun gespreksconfiguratiebestanden te downloaden, gesprekken te starten en te ontvangen en elkaars haakstatus (telefonische aanwezigheid) en gespreksgeschiedenis te bekijken.

    • Publiceert directory naar Webex-clients.

  • Openbare XSP|ADP, met NPS:

    • Pushserver voor hostmeldingen: Een pushserver voor meldingen op een XSP|ADP in uw omgeving. Het werkt samen tussen uw toepassingsserver en onze NPS-proxy. De proxy levert korte tokens aan uw NPS om meldingen naar de cloudservices te autoriseren. Deze services (APNS & FCM) verzenden gespreksmeldingen naar Webex-clients op Apple iOS- en Google Android-apparaten.

  • Toepassingsserver:

    • Biedt gespreksbeheer en interfaces met andere BroadWorks-systemen (doorgaans)

    • Voor flowthrough-inrichting wordt het AS gebruikt door de partnerbeheerder om gebruikers in te richten in Webex

    • Hiermee wordt het gebruikersprofiel naar BroadWorks gepusht

  • OSS/BSS: Uw Operations Support System / Business SIP-services voor het beheer van uw BroadWorks-ondernemingen.

Webex Cloud

Het blauwe blok in het diagram staat voor de Webex-cloud. Webex-microservices ondersteunen het volledige spectrum van Webex-samenwerkingsmogelijkheden:

  • Cisco Common Identity (CI) is de identiteitsservice binnen Webex.

  • Webex voor Cisco BroadWorks staat voor de set microservices die de integratie tussen Webex en de gehoste BroadWorks-serviceprovider ondersteunen:

    • API's voor gebruikersinrichting

    • Configuratie van serviceprovider

    • Gebruikersaanmelding met BroadWorks-aanmeldgegevens

  • Webex-berichtenbox voor berichtengerelateerde microservices.

  • Webex Meetings-venster voor mediaverwerkingsservers en SBC's voor videovergaderingen met meerdere deelnemers (SIP & SRTP)

Webservices van derden

De volgende onderdelen van derden zijn weergegeven in het diagram:

  • APNS (Apple Push Notifications Service) pusht oproep- en berichtmeldingen naar Webex-toepassingen op Apple-apparaten.

  • FCM (FireBase Cloud Messaging) pusht meldingen voor gesprekken en berichten naar Webex-toepassingen op Android-apparaten.

XSP|ADP-architectuuroverwegingen

De rol van openbare XSP|ADP-servers in Webex voor Cisco BroadWorks

De openbare XSP|ADP in uw omgeving biedt de volgende interfaces/services aan Webex en clients:

  • Verificatieservice (AuthService), beveiligd door TLS, die reageert op Webex-verzoeken voor BroadWorks JWT (JSON Web Token) namens de gebruiker

  • CTI-interface, beveiligd door mTLS, waarop Webex zich abonneert voor gebeurtenissen uit de gespreksgeschiedenis en aanwezigheidsstatus van telefonie vanuit BroadWorks (haakstatus).

  • Xsi-acties en -gebeurtenissen-interfaces (eXtended Services Interface) voor gespreksbeheer voor abonnees, telefoonlijsten voor contactpersonen en gesprekslijsten en configuratie van de telefoonservice voor eindgebruikers

  • DM-service (Device Management) voor clients om hun configuratiebestanden voor gesprekken op te halen

Geef URL's op voor deze interfaces wanneer u Webex voor Cisco BroadWorks configureert. (Zie Uw BroadWorks-clusters configureren in Partnerhub in dit document.) Voor elk cluster kunt u slechts één URL voor elke interface opgeven. Als u meerdere interfaces hebt in uw BroadWorks-infrastructuur, kunt u meerdere clusters maken.

XSP|ADP-architectuur

XSP|ADP-architectuur: Optie 1
XSP|ADP-architectuur: Optie 2

We vereisen dat u een afzonderlijk, toegewezen XSP|ADP-exemplaar of -farm gebruikt om uw NPS-toepassing (Notification Push Server) te hosten. U kunt dezelfde NPS gebruiken met UC-One SaaS of UC-One Collaborate. Het is echter mogelijk dat u de andere toepassingen die vereist zijn voor Webex voor Cisco BroadWorks niet host op dezelfde XSP|ADP die de NPS-toepassing host.

We raden u aan een speciaal XSP|ADP-exemplaar/farm te gebruiken om de vereiste toepassingen voor Webex-integratie te hosten om de volgende redenen:

  • Als u bijvoorbeeld UC-One SaaS aanbiedt, raden we u aan een nieuwe XSP|ADP-farm te maken voor Webex voor Cisco BroadWorks. Op deze manier kunnen de twee diensten onafhankelijk werken terwijl u abonnees migreert.

  • Als u de Webex voor Cisco BroadWorks-toepassingen op een XSP|ADP-boerderij zoekt die voor andere doeleinden wordt gebruikt, is het uw verantwoordelijkheid om het gebruik te controleren, de daaruit voortvloeiende complexiteit te beheren en de verhoogde schaal te plannen.

  • De Cisco BroadWorks-systeemcapaciteitsplanner gaat uit van een specifieke XSP|ADP-farm en is mogelijk niet juist als u deze gebruikt voor collocatieberekeningen.

Tenzij anders vermeld, moet de speciale Webex voor Cisco BroadWorks XSP|ADP's de volgende toepassingen hosten:

  • Verificatieservice (TLS met CI-tokenvalidatie of mTLS)

  • CTI (mTLS)

  • XSI-acties (TLS)

  • XSI-gebeurtenissen (TLS)

  • DMS (TLS): optioneel. Het is niet verplicht om een afzonderlijk DMS-exemplaar of -bedrijf specifiek voor Webex voor Cisco BroadWorks te implementeren. U kunt hetzelfde DMS-exemplaar gebruiken dat u gebruikt voor UC-One SaaS of UC-One Collaborate.

  • Webview Gespreksinstellingen (TLS): optioneel. Webview voor gespreksinstellingen (CSW) is alleen vereist als u wilt dat Webex voor Cisco BroadWorks-gebruikers gespreksfuncties kunnen configureren in de Webex-app.

Webex vereist toegang tot CTI via een interface die is beveiligd door wederzijdse TLS-verificatie. Om deze vereiste te ondersteunen, raden we een van de volgende opties aan:

  • (Diagram gelabeld met Optie 1) Eén XSP|ADP-exemplaar of -bedrijf voor alle toepassingen, met twee interfaces die op elke server zijn geconfigureerd: een mTLS-interface voor CTI en een TLS-interface voor andere apps zoals de AuthService.

  • (Diagram gelabeld met Optie 2) Twee XSP|ADP-instanties of -farms, een met een mTLS-interface voor CTI, en de andere met een TLS-interface voor andere apps, zoals de AuthService.


 

XSP|ADP-hergebruik

Als u een bestaande XSP|ADP-boerderij hebt die voldoet aan een van de bovenstaande voorgestelde architecturen (optie 1 of 2) en deze lichtjes wordt geladen, is het mogelijk om uw bestaande XSP|ADP's opnieuw te gebruiken. U moet controleren of er geen tegenstrijdige configuratievereisten zijn tussen bestaande toepassingen en de nieuwe toepassingsvereisten voor Webex. De twee belangrijkste overwegingen zijn:

  • Als u meerdere Webex-partnerorganisaties op de XSP|ADP moet ondersteunen, betekent dit dat u mTLS moet gebruiken op de verificatieservice (CI Token Validation wordt alleen ondersteund voor één partnerorganisatie op een XSP|ADP). Als u mTLS gebruikt op de verificatieservice, betekent dit dat u niet tegelijkertijd clients kunt hebben die basisverificatie gebruiken op de verificatieservice. Deze situatie zou hergebruik van de XSP|ADP voorkomen.

  • Als de bestaande CTI-service is geconfigureerd voor gebruik door clients met de veilige poort (doorgaans 8012) maar zonder mTLS (d.w.z. clientverificatie), is dat in strijd met de Webex-vereiste om mTLS te hebben.

Omdat de XSP|ADP’s veel toepassingen hebben en het aantal permutaties van deze toepassingen groot is, kunnen er andere niet-geïdentificeerde conflicten zijn. Om deze reden moet elk mogelijk hergebruik van XSP|ADP's worden geverifieerd in een lab met de beoogde configuratie voordat wordt toegewezen aan het hergebruik.

NTP-synchronisatie configureren op XSP|ADP

De implementatie vereist tijdsynchronisatie voor alle XSP|ADP's die u met Webex gebruikt.

Installeer de ntp pakket nadat u het besturingssysteem hebt geïnstalleerd en voordat u de BroadWorks-software installeert. Vervolgens kunt u NTP configureren tijdens de installatie van de XSP|ADP-software. Zie de BroadWorks-handleiding voor softwarebeheer voor meer informatie.

Tijdens de interactieve installatie van de XSP|ADP-software krijgt u de optie om NTP te configureren. Ga verder als volgt:

  1. Wanneer het installatieprogramma hierom vraagt, Do you want to configure NTP?, voer in y.

  2. Wanneer het installatieprogramma hierom vraagt, Is this server going to be a NTP server?, voer in n.

  3. Wanneer het installatieprogramma hierom vraagt, What is the NTP address, hostname, or FQDN?, voer het adres van uw NTP-server of een openbare NTP-service in, bijvoorbeeld, pool.ntp.org.

Als uw XSP|ADP's een stille (niet-interactieve) installatie gebruiken, moet het installatieconfiguratiebestand de volgende Key=Value-paren bevatten:

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

XSP|ADP-identiteits- en beveiligingsvereisten

Achtergrond

De protocollen en coderingen van Cisco BroadWorks TLS-verbindingen kunnen op verschillende specificiteitsniveaus worden geconfigureerd. Deze niveaus variëren van de meest algemene (SSL-provider) tot de meest specifieke (individuele interface). Een meer specifieke instelling overschrijft altijd een meer algemene instelling. Als deze niet zijn opgegeven, worden SSL-instellingen op een lager niveau overgenomen van hogere niveaus.

Als er geen instellingen worden gewijzigd ten opzichte van de standaardinstellingen, worden de standaardinstellingen van de SSL-provider door alle niveaus overgenomen (JSSE Java Secure Sockets Extension).

Lijst met vereisten

  • De XSP|ADP moet zichzelf verifiëren bij clients met een door een certificeringsinstantie ondertekend certificaat waarin de algemene naam of alternatieve naam voor het onderwerp overeenkomt met het domeingedeelte van de XSI-interface.

  • De Xsi-interface moet het TLSv1.2-protocol ondersteunen.

  • De Xsi-interface moet een cijfersuite gebruiken die aan de volgende vereisten voldoet.

    • Diffie-Hellman Ephemeral (DHE) of Elliptic Curves Diffie-Hellman Ephemeral (ECDHE) sleuteluitwisseling

    • AES-code (Advanced Encryption Standard) met een minimale blokgrootte van 128 bits (bijv. AES-128 of AES-256)

    • GCM (Galois/Counter Mode) of CBC (Cipher Block Chaining) cipher mode

      • Indien een CBC-code gebruikt wordt, is enkel de SHA2-familie van hash-functies toegelaten voor sleutelafleiding (SHA256, SHA384, SHA512).

De volgende cijfers voldoen bijvoorbeeld aan de vereisten:

  • 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


 

De XSP|ADP CLI vereist de IANA-naamgevingsconventie voor versleutelingssuites, zoals hierboven weergegeven, niet de openSSL-conventie.

Ondersteunde TLS-cijfers voor de AuthService- en XSI-interfaces


 

Deze lijst kan worden gewijzigd naarmate onze cloudbeveiligingsvereisten evolueren. Volg de huidige aanbeveling voor Cisco-cloudbeveiliging voor cijferselectie, zoals beschreven in de lijst met vereisten in dit document.

  • 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

Parameters voor Xsi-gebeurtenisschaal

Mogelijk moet u de grootte van de Xsi-Events-wachtrij en het aantal thread verhogen om het volume aan gebeurtenissen af te handelen dat de Webex voor Cisco BroadWorks-oplossing vereist. U kunt de parameters als volgt verhogen tot de weergegeven minimumwaarden (verlaag ze niet als ze boven deze minimumwaarden liggen):

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

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

Meerdere XSP|ADP's

Randelement lastverdeling

Als u een load balancing-element op uw netwerkrand hebt, moet dit transparant omgaan met de verdeling van verkeer tussen uw meerdere XSP|ADP-servers en de Webex voor Cisco BroadWorks-cloud en -clients. In dit geval geeft u de URL van de load balancer op aan de Webex voor Cisco BroadWorks-configuratie.

Opmerkingen over deze architectuur:

  • Configureer DNS zodat de clients de load balancer kunnen vinden wanneer ze verbinding maken met de Xsi-interface (zie DNS-configuratie).

  • We raden u aan het randelement te configureren in de reverse SSL-proxymodus om punt-naar-punt-gegevenscodering te garanderen.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam. U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

Internetgerichte XSP|ADP-servers

Als u de Xsi-interfaces rechtstreeks blootstelt, gebruikt u DNS om het verkeer te distribueren naar de meerdere XSP|ADP-servers.

Opmerkingen over deze architectuur:

  • Er zijn twee records vereist om verbinding te maken met de XSP|ADP-servers:

    • Voor Webex-microservices: Round-robin A/AAAA-records zijn vereist om de meerdere XSP|ADP IP-adressen te bereiken. De reden hiervoor is dat de Webex-microservices geen SRV-zoekopdrachten kunnen uitvoeren. Zie Webex-cloudservices voor voorbeelden.

    • Voor de Webex-app: Een SRV-record dat wordt omgezet in A-records waarbij elk A-record wordt omgezet in één XSP|ADP. Zie de Webex-app voor voorbeelden.

      Gebruik geprioriteerde SRV-records om de XSI-service te richten op de meerdere XSP|ADP-adressen. Geef prioriteit aan uw SRV-records zodat de microservices altijd naar dezelfde A-record gaan (en het volgende IP-adres) en alleen naar de volgende A-record (en IP-adres) gaan als het eerste IP-adres niet beschikbaar is. GEBRUIK GEEN round-robin-benadering voor de Webex-app.

  • Certificaten van XSP|ADP01 en XSP|ADP02 moeten beide het XSP|ADP-domein hebben, bijvoorbeeld uw-XSP|ADP.example.com, in de alternatieve naam van het onderwerp. Ze moeten hun eigen FQDN's hebben, bijvoorbeeld XSP|ADP01.example.com, in de algemene naam.

  • U kunt jokercertificaten gebruiken, maar we raden ze niet aan.

HTTP-omleidingen vermijden

Soms is DNS geconfigureerd om de XSP|ADP-URL op te lossen naar een HTTP-laadbalancer en is de laadbalancer geconfigureerd voor omleiding via een reverse proxy naar de XSP|ADP-servers.

Webex volgt geen omleiding wanneer u verbinding maakt met de URL's die u levert, dus deze configuratie werkt niet.

Bestellen en inrichten

Bestellen en inrichten is van toepassing op deze niveaus:

  • Inrichting van partner/serviceprovider:

    Elke geïntegreerde Webex voor Cisco BroadWorks-serviceprovider (of reseller) moet worden geconfigureerd als een partnerorganisatie in Webex en de nodige rechten krijgen. Cisco Operations biedt de beheerder van de partnerorganisatie toegang tot het beheren van Webex voor Cisco BroadWorks op Webex Partner Hub. De partnerbeheerder moet alle vereiste inrichtingsstappen uitvoeren voordat hij/zij een klant/bedrijfsorganisatie kan inrichten.

  • Bestellen en inrichten klant/onderneming:

    Elke BroadWorks Enterprise die is ingeschakeld voor Webex voor Cisco BroadWorks, activeert het maken van een gekoppelde Webex-klantorganisatie. Dit proces vindt automatisch plaats als onderdeel van de inrichting van de gebruiker/abonnee. Alle gebruikers/abonnees binnen een BroadWorks-onderneming zijn ingericht in dezelfde Webex-klantorganisatie.

    Hetzelfde gedrag is van toepassing als uw BroadWorks-systeem is geconfigureerd als serviceprovider met groepen. Wanneer u een abonnee inricht in een BroadWorks-groep, wordt er automatisch een klantorganisatie gemaakt in Webex die overeenkomt met de groep.

  • Bestellen en inrichten van gebruikers/abonnees:

    Webex voor Cisco BroadWorks ondersteunt momenteel de volgende modellen voor gebruikersinrichting:

    • Flowthrough-inrichting met vertrouwde e-mails

    • Flowthrough-inrichting zonder vertrouwde e-mails

    • Zelfinrichting gebruiker

    • API-inrichting

Flowthrough-inrichting met vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u kunt bevestigen dat BroadWorks e-mailadressen van abonnees heeft die geldig en uniek zijn voor Webex, maakt en activeert deze inrichtingsoptie automatisch Webex-accounts met deze e-mailadressen als gebruikers-id's.

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Flowthrough-inrichting met vertrouwde e-mails

Flowthrough-inrichting zonder vertrouwde e-mails

U configureert de geïntegreerde IM&P-service om een Webex-inrichtings-URL te gebruiken en wijst de service vervolgens toe aan gebruikers. De toepassingsserver gebruikt de Webex-inrichtings-API om de bijbehorende Webex-gebruikersaccounts aan te vragen.

Als u niet kunt vertrouwen op de e-mailadressen van abonnees die in handen zijn van BroadWorks, maakt deze inrichtingsoptie Webex-accounts, maar kan deze niet worden geactiveerd totdat abonnees hun e-mailadressen leveren en valideren. Op dat moment kan Webex de accounts met deze e-mailadressen activeren als gebruikers-id's.

Flowthrough-inrichting zonder vertrouwde e-mails

U kunt het abonneepakket wijzigen via Partner Hub of u kunt uw eigen toepassing schrijven om de inrichtings-API te gebruiken om abonneepakketten te wijzigen.

Zelfinrichting gebruiker

Met deze optie is er geen flowthrough-inrichting van BroadWorks naar Webex. Nadat u de integratie tussen Webex en uw BroadWorks-systeem hebt geconfigureerd, krijgt u een of meer koppelingen die specifiek zijn voor het inrichten van gebruikers binnen uw Webex voor Cisco BroadWorks-partnerorganisatie.

Vervolgens ontwerpt u uw eigen communicatie (of delegeert u aan uw klanten) om de link naar abonnees te verspreiden. De abonnees volgen de koppeling en leveren en valideren hun e-mailadressen om hun eigen Webex-accounts te maken en te activeren.

Zelfinrichting gebruiker

Omdat de accounts zijn ingericht binnen het bereik van uw partnerorganisatie, kunt u gebruikerspakketten handmatig aanpassen via Partner Hub of de API gebruiken om dit te doen.


 

Gebruikers moeten bestaan in het BroadWorks-systeem dat u met Webex integreert, of ze mogen geen accounts maken met die koppeling.

Serviceproviderinrichting door API's

Webex toont een reeks openbare API's waarmee u Webex voor Cisco BroadWorks gebruikers-/abonneevoorzieningen kunt maken in uw bestaande gebruikersbeheerworkflow/-tools.

Serviceproviderinrichting door API's - Vertrouwde e-mails
Serviceproviderinrichting door API's - Niet-vertrouwde e-mails

Vereiste patches met doorstroominrichting

Als u flow-through-inrichting gebruikt, moet u een systeempatch installeren en een CLI-eigenschap toepassen. Raadpleeg de onderstaande lijst voor instructies die van toepassing zijn op uw BroadWorks-versie:

Voor R22:

  1. Installeer AP.as.22.0.1123.ap376508.

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.

Voor R23:

  1. Installeer AP.as.23.0.1075.ap376509

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.

Voor R24:

  1. Installeer AP.as.24.0.944.ap375100

  2. Stel na de installatie de eigenschap in bw.msg.includeIsEnterpriseInOSSschema tot true vanuit de CLI in Maintenance/ContainerOptions.

    Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.


 
Nadat u deze stappen hebt voltooid, kunt u geen nieuwe gebruikers inrichten met UC-One Collaborate-services. Nieuw ingerichte gebruikers moeten Webex zijn voor Cisco BroadWorks-gebruikers.

Toestelnummer bellen

Met ondersteuning voor de functie voor toestelbellen kunnen Webex-gebruikers van Cisco Broadworks andere gebruikers bellen met een toestel dat vergelijkbaar is met het primaire telefoonnummer binnen dezelfde onderneming. Dit is vooral handig voor gebruikers die geen DID-nummers hebben.

Tijdens het inrichten wordt het toestelnummer van de gebruikers opgeslagen in de Webex-directory als het toestelnummer van de gebruiker. Voor BroadWorks-gesprekken wordt het toestelnummer weergegeven in de Webex-app in het toestelveld van alle gebieden met de gespreksinitiatiemethode en het profiel van de gebruiker. Webex voor Cisco BroadWorks ondersteunt alleen-toestelgesprekken tussen gebruikers binnen dezelfde groep en verschillende groepen van dezelfde onderneming met de combinatie van kiescode voor locatie en toestel. Bellen tussen twee bedrijven die alleen extensies gebruiken, wordt echter niet ondersteund.

Er kan een toestel worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'toestel'

      • De toestelparameter moet expliciet worden doorgegeven als onderdeel van de API-oproep. Voor bedrijven/groepen waarvoor LDC (Location Dialing Code) is geconfigureerd, moet de toestelparameter de combinatie LDC en 'toestelnummer' zijn.

    • Flowthrough- of zelfactiveringsinrichting

      • Toestel en LDC (indien van toepassing) worden automatisch opgehaald uit BroadWorks.

  • Gespreksgebruikers of -entiteiten met alleen BroadWorks

    • Automatisch gesynchroniseerd vanuit BroadWorks via adreslijstsynchronisatie met de combinatie van LDC (Location Dialing Code) en toestelnummer.

Tabel 2. Toestelnummers beheren op basis van de inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Toestelnummer beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

Toestelnummer moet worden doorgegeven als parameter

Doorstroomd

Toestel automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Toestel gesynchroniseerd met adreslijstsynchronisatie

BroadWorks-telefoonlijsten

Lijsten met bedrijven, groepen of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing

Voorwaarden

  1. De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.

  2. Patch waarbij kiescodes voor toestelnummers en locaties worden toegevoegd aan XSI en inrichtingsadapter februari 2022 voor versie 23 of hoger als onderdeel van:

    • 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. Schakel de koptekst X-BroadWorks-Remote-Party-Info in op het AS met de onderstaande CLI-opdracht voor deze SIP-gespreksstroom die vereist is voor ondersteuning van de functie voor toestelbellen.

    AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

Prioriteit oproepopties in de app

Als onderdeel van de ondersteuning voor de functie Toestelbellen wordt De prioriteitsinstelling voor gespreksopties van de app ook op partnerniveau aangeboden voor alle Webex voor Cisco Broadworks-partners. Met deze instelling kan de partner de gespreksprioriteitsinstellingen van al zijn beheerde klanten beheren vanuit Partner Hub. De prioriteitsinstelling voor app-gespreksopties voor een klant kan ook op klantniveau worden gewijzigd vanuit Control Hub.

De prioriteitsinstelling voor app-gespreksopties bevat toestel als tweede optie in zowel Partner Hub als Control Hub wanneer een Webex voor Cisco Broadworks-gebruiker nieuw is ingericht met toestel via een van de bovengenoemde inrichtingsmethoden.

Voor alle bestaande ingerichte organisaties heeft de uitbreidingsoptie de verborgen status (standaard) in de prioriteitsinstelling voor app-gespreksopties. Er wordt geen toestel weergegeven in de optie voor audio-/videogesprekken van de gebruiker in de Webex-app.

Hieronder ziet u de opties om de optie Toestelgesprek zichtbaar te maken voor de bestaande klanten:

  1. Als een partner wil dat al zijn beheerde klantorganisaties een toestel krijgen als een van de gespreksopties, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Partnerhub. Hierdoor kunnen de beheerde klantorganisaties de instelling van hun partner overnemen.

  2. Als een partner een toestel wil aanbieden in gespreksopties voor een specifieke klantorganisatie, wordt het aanbevolen dat de partnerbeheerder het toestel verplaatst van verborgen naar beschikbaar in Control Hub.

Ondersteuning voor groepscontactpersonen

Met deze functie wordt de Webex for BroadWorks DirSync-service verbeterd door de beperking voor het synchroniseren van maximaal 1500 contactpersonen uit de telefoonlijsten van de groep in BroadWorks te verwijderen en partners in staat te stellen maximaal 30K contactpersonen uit een enkele telefoonlijst van de groep te synchroniseren en deze gelijk te maken met de verhoging van 30K contactpersonen voor de Enterprise telefoonlijst, die afzonderlijk is vrijgegeven.

Er is een totale limiet van 200K voor alle externe contactpersonen per organisatie, die van toepassing is op de som van Enterprise- en Group-telefoonlijsten in één BroadWorks-onderneming. Een BroadWorks-onderneming met een bedrijfstelefoonlijst met 30K en ook 5 groepstelefoonlijsten met elk 30K worden ondersteund (180K totaal per organisatie). Als er echter 6 groepstelefoonlijsten zijn met elk 30K, wordt dit niet ondersteund (210K totaal).


 

Deze functie is beschikbaar op aanvraag. Neem contact op met uw accountteam om dit in te schakelen.

  • Voordat u de functie inschakelt, moet een vereiste migratie worden uitgevoerd om groepen in te richten en te koppelen voor alle bestaande ingerichte gebruikers.

  • Het Cisco-team voert een interne API uit om bestaande ingerichte gebruikers te migreren om ze aan de juiste groep te koppelen. OPMERKING: Dit kan tot een week duren om te verwerken.

  • Zodra de migratie is voltooid voor de partner en de functie is ingeschakeld, worden alle nieuw ingerichte gebruikers op de juiste manier 'gegroepeerd'.

Nadat de functie is ingeschakeld, begint de DirSync-service met het synchroniseren van contactpersonen uit de telefoonlijst van de BroadWorks-groep in de speciale opslag voor groepscontactpersonen in de Webex-contactservice.

Tijdens het inrichten moet de bedrijfsgroep van de gebruiker worden opgeslagen in de Webex-directory om aan te geven tot welke groep deze gebruiker behoort. Met de koppeling van de gebruiker aan een BroadWorks-groep in de Webex-directory kan de Webex-app contact zoeken in de opslag voor de contactservicegroep voor de specifieke groep van de gebruiker.

Voor deze functie moeten de Webex for BroadWorks-abonnees in Webex worden ingericht met de BroadWorks-bedrijfs-groeps-id.

De BroadWorks Enterprise Group Id kan worden ingericht voor de Cisco BroadWorks-gebruikers via de volgende methoden:

  • Webex voor Cisco BroadWorks-gebruikers

    • Openbare API-inrichting als 'spEnterpriseGroupId'

      • De BroadWorks Enterprise Group Id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek.

    • Flowthrough- of zelfactiveringsinrichting

      • BroadWorks-bedrijfs-groeps-id wordt automatisch opgehaald uit BroadWorks.

    • Gespreksgebruikers of -entiteiten met alleen BroadWorks

      • Niet van toepassing. Het is niet vereist om de BroadWorks Enterprise Group-id voor deze gebruikers te synchroniseren.

Tabel 3. Beheer van Enterprise Group ID op basis van inrichtingsmethode

BroadWorks-gespreksrecords

Beschrijving

Inrichtingsmethode

Bedrijfs-groeps-id beheren

Webex voor Cisco BroadWorks-gebruikers

Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks

Openbare API

BroadWorks-bedrijfs groep-id moet worden doorgegeven als parameter spEnterpriseGroupId

Doorstroomd

BroadWorks-bedrijfs groep-id wordt automatisch opgehaald uit BroadWorks

Gebruikers die alleen bellen via BroadWorks

Bellende gebruikers die niet zijn geïntegreerd in Webex

Synchroniseren met Directory

Niet van toepassing

Aanroepende entiteiten die geen gebruiker zijn

Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer

Synchroniseren met Directory

Niet van toepassing

BroadWorks-telefoonlijsten

Contactpersonen in de telefoonlijsten van de BroadWorks-groep

Synchroniseren met Directory

Groepscontacten worden opgeslagen in de Webex-contactservice die is gekoppeld aan de specifieke groep

Lijsten met BroadWorks-enterpsie of persional-telefoons

Contactpersonen in de lijsten met zakelijke of persoonlijke telefoons

Synchroniseren met Directory

Niet van toepassing


 

Openbare API moet worden bijgewerkt VÓÓR de MIGRATIE. Migratie kan niet worden voltooid totdat DEZE API is voltooid. De BroadWorks Enterprise Group-id moet expliciet worden doorgegeven in de spEnterpriseGroupId-parameter van het API-gesprek https://developer.webex.com/docs/api/changelog#2023-march

Nadat de functie is ingeschakeld en als gevolg van de volgende adreslijstsynchronisatie worden de bedrijfsgebruikersgroepen ook weergegeven in Control Hub. Het visualiseren van de groepen in Control Hub voor Webex voor BroadWorks is in dit stadium puur informatief. Partner- en klantbeheerders mogen geen wijzigingen aanbrengen aan groepen of groepslidmaatschap in Control Hub, omdat deze wijzigingen niet worden teruggekoppeld naar BroadWorks. Groepsbeheer in Control Hub is bedoeld voor gebruik door partners die de komende API's voor contactbeheer gaan gebruiken.

Migratie en toekomstbestendigheid

De progressie van Cisco van de BroadSoft Unified Communications Client is om van UC-One naar Webex te gaan. Er is een overeenkomstige progressie van de ondersteunende services weg van het netwerk van serviceproviders – behalve bellen – naar het Webex-cloudplatform.

Of u nu UC-One SaaS of BroadWorks Collaborate gebruikt, de voorkeursmigratiestrategie is het implementeren van nieuwe, speciale XSP|ADP's voor integratie met Webex voor Cisco BroadWorks. U kunt de twee services parallel uitvoeren terwijl u klanten migreert naar Webex en uiteindelijk de infrastructuur terugverdienen die is gebruikt voor de vorige oplossing.

Aanbevolen documentabonnementen

Webex Help Center-artikelen (op help.webex.com) hebben een optie Abonneren waarmee u een e-mailmelding kunt ontvangen wanneer dat artikel wordt bijgewerkt.

We raden u aan u te abonneren op elk van de volgende artikelen om ervoor te zorgen dat u geen kritieke updates mist die van invloed zijn op de netwerkverbinding. Om u in te schrijven, gaat u naar elk van de onderstaande links en klikt u in het artikel dat wordt gelanceerd op de knop Subscribe.

We raden u aan om u minimaal in te schrijven voor bovenstaande lijst. De meeste Webex-artikelen en -documenten die worden vermeld onder Aanvullende documenten hebben echter een optie Abonneren. Als deze optie moet worden weergegeven, moet het artikel worden weergegeven op help.webex.com.


 
Er is geen abonnementsoptie voor landingspagina's van documentatie.

Aanvullende documenten

Raadpleeg de volgende gerelateerde documentatie voor meer informatie over Webex voor Cisco BroadWorks:

Webex voor Cisco BroadWorks-documenten

Partnerbeheerders kunnen de volgende documenten en sites gebruiken om informatie te verkrijgen over Webex voor Cisco BroadWorks.

Webex voor Cisco BroadWorks-artikelen

Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:

Cisco BroadWorks-documenten

Partnerbeheerders kunnen verwijzen naar de Cisco BroadWorks-site op cisco.com voor technische documenten die beschrijven hoe het Cisco BroadWorks-gedeelte van de oplossing moet worden geïmplementeerd:

Webex Help-artikelen

De volgende Webex Help-sites kunnen worden gebruikt om Webex-artikelen te vin