- Start
- /
- Artikel
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.
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:
| 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.
| 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:

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.)
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.)
Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)
Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)
Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)
|
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.
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:
Zendesk—Alleen premium
Slack—Alleen premium
Microsoft Teams voor Webex Meetings—Standaard of Premium
Microsoft Teams for Calling: ondersteund met alle pakketten
Office 365-agenda—Standaard of Premium
Google-agenda voor G Suite—Standaard of Premium
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


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:
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:
Wanneer het installatieprogramma hierom vraagt,
Do you want to configure NTP?, voer iny.Wanneer het installatieprogramma hierom vraagt,
Is this server going to be a NTP server?, voer inn.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_SHA384TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_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_SHA384TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256TLS_DHE_RSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384TLS_DHE_RSA_WITH_AES_256_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256TLS_DHE_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHATLS_ECDHE_RSA_WITH_AES_256_CBC_SHATLS_DHE_RSA_WITH_AES_256_CBC_SHATLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHATLS_ECDHE_RSA_WITH_AES_128_CBC_SHATLS_DHE_RSA_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_256_GCM_SHA384TLS_DHE_PSK_WITH_AES_256_GCM_SHA384TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_PSK_WITH_AES_128_GCM_SHA256TLS_DHE_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_128_GCM_SHA256TLS_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_256_CBC_SHA256TLS_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384TLS_ECDHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_PSK_WITH_AES_256_CBC_SHA384TLS_DHE_PSK_WITH_AES_256_CBC_SHA384TLS_RSA_PSK_WITH_AES_256_CBC_SHATLS_DHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHATLS_PSK_WITH_AES_256_CBC_SHA384TLS_PSK_WITH_AES_256_CBC_SHATLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_128_CBC_SHA256TLS_DHE_PSK_WITH_AES_128_CBC_SHA256TLS_RSA_PSK_WITH_AES_128_CBC_SHATLS_DHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_WITH_AES_128_CBC_SHATLS_PSK_WITH_AES_128_CBC_SHA256TLS_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 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.
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.

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.


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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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
De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.
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
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:
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.
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.
|
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.
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.
Bring Your Own PSTN-oplossing voor Webex voor Cisco BroadWorks: met deze oplossing kunnen serviceproviders telefoonnummers inrichten die ze bezitten (in plaats van door Cisco geleverde nummers) voor gebruikers om te gebruiken wanneer ze deelnemen aan Webex Meetings.
Webex voor Cisco BroadWorks-configuratiehandleiding: beschrijft hoe u de Webex-app voor Webex voor Cisco BroadWorks configureert.
- Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks: beschrijft hoe u het besturingssysteem en de MPP-apparaten van de serviceruimte kunt onboarden en gebruiken.
Handleiding voor probleemoplossing van Webex voor Cisco BroadWorks: bevat informatie voor het oplossen van problemen met Webex voor Cisco BroadWorks.
Webex voor Cisco BroadWorks-artikelen
Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:
Documentatie van Webex voor Cisco BroadWorks: de landingspagina bevat technische documenten en optionele Webex-artikelen die zijn bedoeld voor partnerbeheerders van Webex voor Cisco BroadWorks.
Nieuw in Webex voor Cisco BroadWorks: lees meer over de nieuwste functies en wat er binnenkort beschikbaar is.
Bekende problemen en beperkingen: lees meer over bekende problemen die we hebben geïdentificeerd in de Webex for Cisco BroadWorks-oplossing.
Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM: in dit artikel wordt beschreven hoe u partnerbeheerdersrollen toewijst voor partnerorganisaties die Webex voor Cisco BroadWorks aanbieden. Rollen worden gebruikt om beheerderstoegang toe te wijzen aan instellingen in Partnerhub en Control Hub.
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
Webex voor BroadWorks-ontwikkelaarshandleiding: bevat informatie voor ontwikkelaars die toepassingen maken die de Webex voor BroadWorks-API's gebruiken.
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:
Webex-vereisten: Het onboardsjabloon bevat de volgende instellingen:
|
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:
Webex-vereisten: Het onboardsjabloon bevat de volgende instellingen:
|
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:
Vereisten voor BroadWorks:
Webex-vereisten:
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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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.
|
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. |
| Verificatiemodus | BroadWorks | Webex |
| Primaire gebruikersidentiteit | BroadWorks-gebruikers-id | E-mailadres |
| Identiteitsprovider | BroadWorks.
| Cisco Common Identity |
| Meervoudige verificatie? | Nee | Vereist Customer IdP die meervoudige verificatie ondersteunt. |
Validatiepad gebruikergegevens
|
|
|
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-8ADP_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.
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
BroadWorks-exemplaar(en) met minimale versie R22. Zie de BroadWorks-softwarevereisten (in dit document) voor ondersteunde versies en patches. Voor meer informatie, zie Beleid voor de levenscyclus van BroadSoft-producten sectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.
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
Als u de Engelse versie van de Webex-app wilt downloaden, gaat u naar https://www.webex.com/webexfromserviceproviders-downloads.html. De Webex-app is beschikbaar op:
Windows-pc's/laptops
Apple-pc's/laptops met MacOS
iOS (Apple Store)
Android (Play store)
Webbrowsers (ga naar https://teams.webex.com/)
Gelokaliseerde versies
Gebruik een van de volgende koppelingen om een gelokaliseerde versie van de Webex-app te downloaden:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (Koreaans)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (Frans)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (Portugees)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (Traditioneel Chinees)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (vereenvoudigd Chinees)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Japan)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spanje)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (Duits)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italiaans)
Fysieke telefoons en accessoires
Cisco IP-telefoons:
Cisco IP-telefoon 6800-serie met Firmware voor meerdere platforms voor meerdere platforms
Cisco IP-telefoon 7800-serie met Firmware voor meerdere platforms voor meerdere platforms
Cisco IP-telefoon 8800-serie met Firmware voor meerdere platforms voor meerdere platforms
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html voor modellen en meer informatie.
We ondersteunen telefoons van derden op dezelfde manier als met andere BroadWorks-integraties. Ze hebben echter nog geen contacten en aanwezigheidsintegratie met Webex voor Cisco BroadWorks.
Adapters:
Analoge telefoonoplader voor meerdere platforms voor Cisco ATA 191
Analoge telefoonoplader voor meerdere platforms voor Cisco ATA 192
Zie https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html voor modellen en meer informatie.
Hoofdtelefoons:
Cisco-hoofdtelefoon 500-serie
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html voor modellen en meer informatie.
Apparaten met Room OS:
Webex Room- en Room Kit-serie
Webex Desk-serie
Webex Board-serie
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: Configuratiebestand: |
Sjabloon voor Webex-tablet |
Type identiteit/apparaatprofiel: Verbinding maken - tablet DTAF: Configuratiebestand: |
Webex Desktop-sjabloon |
Type identiteit/apparaatprofiel: Bedrijfscommunicator - PC DTAF: Configuratiebestand: |
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:
XSP|ADP AuthService Configuration' voor het configureren van de service op XSP|ADP.
'NPS-configuratie voor verificatie proxy instellen' om NPS te configureren voor het gebruik van de verificatieproxy.
CI-gebruikers-UUID synchroniseren' voor CI-gebruikers-UUID synchroniseren. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.
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 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:

(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 AuthenticationDe 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.
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 |
Moet gelezen worden | |
Moet gelezen worden | |
Domeinen en URL's die toegankelijk moeten zijn voor Webex-services | Moet gelezen worden |
Optioneel | |
Optioneel | |
Optioneel | |
Optioneel | |
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 |
|
| Verwijst naar LB1 (Site A) |
A |
|
| 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 |
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 |
|
| Clientdetectie van Xsi-interface |
SRV |
|
| Clientdetectie van Xsi-interface |
A |
|
| Verwijst naar LB1 (site A) |
A |
|
| 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 |
|
| Lastbalancer |
A | LB.voorbeeld.com |
| 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 |
|
| Verwijst naar LB1 (site A) |
A |
|
| 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:
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:
De client voert een SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">
Als de SRV-zoekopdracht een of meer A/AAAA-doelen retourneert:
De client zoekt A/AAAA op voor deze doelen en slaat de geretourneerde IP-adressen in de cache.
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).
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.
(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>Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.
Als deze bestaan, vergelijkt de client met het oorspronkelijke XSI-adres dat hij heeft ontvangen via de BroadWorks-clusterconfiguratie.
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.
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.



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. |
Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.
Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw versie:
Voor R22:
Voor R23:
Voor R24: geen patch vereist
Elke verwijzing naar XSP omvat XSP of ADP.Installeer de
AuthenticationServicetoepassing op elke XSP|ADP-service.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/authServiceVoer deze opdracht uit om de AuthenticationService te implementeren op de XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
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> getAls dit niet aanwezig is, voert u de volgende opdracht uit om de standaard Java-trusts te importeren:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrustU 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.
Configureer de identiteitsproviders door de volgende opdrachten uit te voeren op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> getset clientId client-Id-From-Step1set enabled trueset clientSecret client-Secret-From-Step1set ciResponseBodyMaxSizeInBytes 65536set issuerName <URL>—Voor deURLvoer de URL van de IssuerName in die van toepassing is op uw CI-cluster. Zie volgende tabel.set issuerUrl <URL>—Voor deURLvoer 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
EU
US-B
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".
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:userConfigureer identiteitsproviders voor Cisco Federation met de volgende opdrachten op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> getset flsUrl https://cifls.webex.com/federationset refreshPeriodInMinutes 60set refreshToken refresh-Token-From-Step1
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> GetConfigureer Tokenbeheer met de volgende opdrachten op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>set tokenIssuer BroadWorksset tokenDurationInHours 720
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.Selecteer één XSP|ADP om een sleutelpaar te genereren.
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)
De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeysHet geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere.keysbestand indien nodig.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 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:
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/authServiceVoeg de URL van de verificatieservice toe aan de container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authServiceHiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.
Controleer de parameter met
get.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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>Voer de opdracht in
get <interfaceIp> 443om 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).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-POLY1305in 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_POLY1305Raadpleeg 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.
Toepassingsserver configureren voor CTI-abonnementen
XSP|ADP's configureren voor mTLS geverifieerde CTI-abonnementen
Inkomende poorten openen voor veilige CTI-interface
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 |
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:
|
CTI TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp>om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>Voer de
getopdracht 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).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-POLY1305naar de CTI-interface gebruikt u:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305Raadpleeg 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:
Aanmelden bij Partnerhub .
Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om
CombinedCertChain2023.txtop 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.
Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txtOpenen
combinedcertchain2023.txtin een teksteditor.Selecteer en knip het eerste tekstblok, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----en plak het tekstblok in een nieuw bestand.Sla het nieuwe bestand op als
root2023.txt.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-----.
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txtMeld u aan bij de XSP|ADP en ga naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>(Optioneel) Uitvoeren
help updateTrustom de parameters en opdrachtindeling weer te geven.Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txtXSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Alle aliassen moeten een andere naam hebben.
webexclientroot2023enwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang alle ingangen uniek zijn.Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> getAlias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]Clients toestaan te verifiëren met certificaten:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
CTI-interface toevoegen en mTLS inschakelen
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
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> getVoer 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>
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 .
Mac-gebruikers: Klik op profielfoto en vervolgens op .
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.
Meld u aan bij cisco.com en zoek naar 'BWCallSettingsWeb' in het gedeelte software downloaden.
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.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).
Kopieer het .war-bestand naar een tijdelijke locatie op de XSP|ADP, zoals
/tmp/.Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.warDe BroadWorks-softwaremanager valideert en installeert het bestand.
[Optioneel] Verwijderen
/tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist).Activeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettingsDe 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.Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
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.
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.
Zorg ervoor dat u over de nieuwste configuratiesjablonen voor de Webex-app beschikt (zie Apparaatprofielen).
Het doel voor webgespreksinstellingen instellen op
csw:%WEB_CALL_SETTINGS_TARGET_WXT% cswStel 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.
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.
Zie de functiebeschrijving Pushserver voor VoIP in UCaaS voor meer informatie.
De BroadWorks-patches voor de functie zijn beschikbaar op: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Zie voor NPS-software en -patches het gedeelte Uw NPS voorbereiden op Webex voor Cisco BroadWorks.
Zoek en download de patch vanaf de downloadpagina van de software.
Meer informatie over de ADP-server vindt u op https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
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: XSP R22-patches: XSP R23-pleisters: | ||
| 3 | Activeer de toepassing Pushserver voor meldingen. | ||
| 4 | (Voor Android-meldingen) Schakel de FCM v1-API in op de NPS.
| ||
| 5 | (Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.
| ||
| 6 | Voeg een techsupport van de NPS XSP/ADP toe. | ||
| 7 | Op elke AS-server wordt het namedefs-bestand in 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
|
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:
Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u
| |||||||||||||||||||
| 3 | Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):
| |||||||||||||||||||
| 4 | (Voor Android-meldingen) Voeg de Android-toepassings-id toe aan de context van de FCM-toepassingen op de NPS.
| |||||||||||||||||||
| 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.
| |||||||||||||||||||
| 6 | Configureer de volgende NPS-URL's:
| |||||||||||||||||||
| 7 | Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:
| |||||||||||||||||||
| 8 | Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen: | |||||||||||||||||||
| 9 | Start de XSP|ADP opnieuw: | |||||||||||||||||||
| 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: wanneer u bestaande UCaaS-clients hebt en deze moet migreren om FCMv1 te gebruiken.
SaaS-clients migreren naar FCMv1: wanneer u bestaande SaaS-clients hebt en deze moet migreren om FCMv1 te gebruiken.
ADP-server bijwerken: wanneer u de NPS naar een ADP-server migreert.
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 . 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
|
Meld u aan bij FCM-beheerder SDK op http://console.firebase.google.com.
Selecteer de juiste Android-toepassing.
Noteer de project-ID op het tabblad Algemeen
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:
Klik op de blauwe knop om een nieuw serviceaccount aan te maken
Klik op de blauwe knop om een nieuwe privésleutel te genereren
Sleutel downloaden naar een veilige locatie
Een bestaand serviceaccount hergebruiken:
Klik op de blauwe tekst om bestaande serviceaccounts weer te geven.
Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.
Klik aan de rechterkant op het hamburgermenu en maak een nieuwe privésleutel aan.
Download het json-bestand dat de sleutel bevat en sla het op naar een veilige locatie.
Kopieer het json-bestand naar de XSP|ADP.
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 ********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_projectFCMv1 inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...DoneVoer het installatiebestand
bwrestartopdracht 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. |
FCM uitschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...DoneVoer het installatiebestand
bwrestartopdracht om de XSP|ADP opnieuw te starten.FCM inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...DoneVoer het installatiebestand
bwrestartopdracht 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.
Haal het JSON-bestand op van de Google Cloud-console:
Ga op de Google Cloud Console naar de pagina Service Accounts.
Klik op Selecteer een project, kies uw project en klik op Openen.
Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.
Selecteer een type Sleutel en klik op Aanmaken
Het bestand wordt gedownload.
FCM toevoegen aan de ADP-server:
Importeer het JSON-bestand naar de ADP-server met de
/bw/installopdracht.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:Voeg vervolgens de toepassing en de sleutel toe:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...DoneControleer 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:
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
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.
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.
(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.
Voeg uw URL's voor XSI-acties en XSI-gebeurtenissen toe.
Optioneel. Werk de DAS-URL bij met de URL van de apparaatactiveringsservice.
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.
Klik op Volgende.
Ga als volgt te werk op de pagina CTI-interface:
Voeg de CTI-URL en poort toe voor de CTI-interface waarmee u verbinding wilt maken.
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.
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.
Klik op Volgende.
Voeg de URL van uw verificatieservice toe.
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.
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.
Klik op Clusters weergeven en u moet uw nieuwe cluster zien en zien of de validatie is gelukt.
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
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
Klik op Clusters weergeven.
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.
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.
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
Klik op Sjabloon toevoegen.
Hiermee start u een wizard waarin u de configuratie kunt leveren voor klanten die deze sjabloon gebruiken.
Gebruik de vervolgkeuzelijst Cluster om het cluster te kiezen dat u met deze sjabloon wilt gebruiken.
Voer een sjabloonnaam in en klik op Volgende.
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.
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.
Optioneel. Schakel Gratis bellen via Cisco Webex uitschakelen in als u Webex-gesprekken wilt uitschakelen.
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.
Klik op Volgende.
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.
Klik op Volgende.
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).
Klik op Volgende.
Voor Voorkeuren configureert u het volgende:
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.
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.
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.
Zorg ervoor dat de schakelaar Bestaande organisaties inrichten is ingeschakeld (de standaardinstelling is ingeschakeld).
Klik op Volgende.
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.
Klik op Sjablonen weergeven en u moet uw nieuwe sjabloon met andere sjablonen in de lijst zien.
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.
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)
Als u dit nog niet hebt gedaan, past u de volgende patch toe die van toepassing is op uw versie:.
Voor R22:
AP.as.22.0.1123.ap373197Voor R23:
AP.as.23.0.1075.ap373197Voor R24:
AP.as.24.0.944.ap384177
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.Wijzigen in de
Maintenance/ContainerOptionscontext.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.
Meld u aan bij Partner Hub en ga naar .
Klik op Sjablonen weergeven.
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.
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. |
Meld u aan bij de toepassingsserver en configureer de interface voor berichten.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURLAS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_nameAS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_passwordAS_CLI/Interface/Messaging> set enableSynchronization true
De geïntegreerde IMP-interface activeren:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
U moet de volledig gekwalificeerde naam invoeren voor de |
(Optie) Inrichtingsparameters per onderneming configureren op toepassingsserver
Open in de BroadWorks-gebruikersinterface de onderneming die u wilt configureren en ga naar Services > Geïntegreerde IM&P.
Selecteer Servicedomein gebruiken en voer een dummywaarde in (Webex negeert deze parameter. U kunt dit gebruiken
example.com).Selecteer Messaging Server gebruiken.
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
provisioningURLparameter, 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/hostsbestand op het AS.Voer in het veld Gebruikersnaam een naam in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.
Voer een wachtwoord in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.
Voor Standaard gebruikersidentiteit voor IM&P-id selecteert u Primair.
Klik op Toepassen.
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. |
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.
Open een serviceaanvraag met Cisco TAC. TAC moet een vertrouwensrelatie opbouwen tussen de externe identiteitsprovider en de Cisco Common Identity-service. .
Als uw IdP depassEmailInRequestin 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.Upload het CI-metagegevensbestand dat TAC aan uw identiteitsprovider heeft geleverd.
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.

Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.
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. |
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.
Configureer de omleidings-URI op de OpenID connect-id-provider.
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.

Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.
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-InfoSIP-koptekst:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork trueAS_CLI/Interface/SIP> set sendCallCorrelationIDAccess trueHet
enableCallCorrelationIDparameter 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 omenableCallCorrelationIDingeschakeld 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:
AP.as.22.0.1123.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
Voor R23:
AP.as.23.0.1075.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433Bij gebruik van XSP:
AP.xsp.23.0.1075.ap378585Bij gebruik van ADP:
Xsi-Events-23_2021.05_1.251.bwar
Voor R24:
AP.as.24.0.944.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
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:
Meld u aan bij Partnerhub op
admin.webex.com.Ga naar Instellingen en selecteer een bestaand cluster.
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.
Schakel het selectievakje Gespreksgeschiedenis inschakelen in.
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)
Aanmelden bij Partner Hub
Klik op Instellingen.
Klik op Cluster weergeven en selecteer het juiste BroadWorks-cluster.
Schakel de schakelaar Niet storen (NST) in.
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.
Als de validatie slaagt, klik dan op Save.
|
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

Gespreksopname
Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopname.
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. |
|
Altijd met onderbreken/hervatten | De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker kan een opname onderbreken en 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 |
|
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. |
|
Vereisten
Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:
Voor R22: AP.as.22.0.1123.ap377718
Voor R23: AP.as.23.0.1075.ap377718
Voor R24: AP.as.24.0.944.ap377718
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.
Haal de vereiste DTAF-bestanden op (zie Apparaatprofielen in het gedeelte Uw omgeving voorbereiden).
Controleer of u de juiste tagsets hebt in BroadWorks System > Resources > Device Management Tagsets.
Voor elke client die u inricht:
Download en pak het DTAF zip-bestand voor de specifieke client uit.
DTAF-bestanden importeren naar BroadWorks op System > Resources > Identity/Device Profile Types
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
Pas de sjablonen aan volgens uw omgeving (zie onderstaande tabel).
Sla het bestand op.
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
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 hun eigen merkaanpassingen toe te passen, kunnen klantbeheerders de procedures volgen bij Uw bedrijfsbranding toevoegen aan Webex.
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: |
| 2 | Klantorganisatie en gebruikers verifiëren in Control Hub: |
Gebruikerstests
| 1 | Download de Webex-app op twee verschillende machines. |
| 2 | Meld u aan als testgebruikers op de twee machines. |
| 3 | Voer testgesprekken. |
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:
Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.
Klik op Sjablonen weergeven.
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.
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.
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) |
|
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):
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
Gebruiker verplaatsen (met vertrouwd e-mailadres)
Als de onboardsjabloon vertrouwde e-mails gebruikt, kan de partnerbeheerder volgende gebruikers met dit proces verplaatsen:
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.
De gebruiker opent de e-mail en klikt op Account activeren. De gebruiker wordt omgeleid naar de Webex-consumentenportal.
Gebruiker meldt zich aan bij Webex.
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:
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.
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.
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.
Gebruiker meldt zich aan bij Webex.
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.
De gebruiker meldt zich aan bij de URL van de gebruikerstoegang met BroadWorks-aanmeldgegevens.
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.
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.
De gebruiker meldt zich aan bij de Consumentenportal.
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:
| ||
| 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.
|
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. |
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.
Verwijder alle Webex voor BroadWorks-werkplekken uit de organisatie. Gebruik de API Een BroadWorks-werkplek verwijderen.
Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de API Een BroadWorks-abonnee verwijderen.
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.
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:
|
| 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:
![]() |
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 BroadWorks | Overeenkomstig kenmerk in Webex | Doel | Notities |
| BroadWorks-gebruikers-id | Geen | Primaire id | U 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-id | Gebruikers-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:
Wijzig de BroadWorks-gebruikers-id niet. Dit wordt niet ondersteund. |
| Alternatieve id | Geen | Hiermee schakelt u het authn van de gebruiker in, via e-mail en wachtwoord, met de BroadWorks-gebruikers-id | Moet 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:
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.
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:
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.
Zoek en selecteer de gebruiker in Control Hub.
- 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
| 1 | Gebruik de People API's om alle gebruikers uit de organisatie te verwijderen:
| ||
| 2 | Als adreslijstsynchronisatie is ingeschakeld, schakelt u deze uit. Dit kan via Partner Hub of via de openbare API. Adreslijstsynchronisatie uitschakelen via Partner Hub: 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 | ||
| 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:
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 | |||||||||
| 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:
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.
Meld u aan bij Partnerhub op admin.webex.com.
Kies Instellingen.
Klik op Sjabloon weergeven en kies de juiste onboardingsjabloon.
Klik op Cisco Webex Free Calling uitschakelen.
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:
Open CommPilot en ga naar de gebruikersconfiguratie.
Verwijder de geïntegreerde IM+P-service van de gebruiker en klik op OK.
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.
Gebruik de Een BroadWorks-abonnee-API verwijderen om de gebruiker te verwijderen.
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:
Aanwezigheid wordt niet ondersteund voor niet-CI Broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.
CI-gebruikers zonder Webex-cloudrechten of computertype accounts (werkplekken) geven alleen aanwezigheid 'in gesprek' en 'onbekend' weer. Er is geen status actief, overgaan, enz.
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.
Als u uw verbinding verliest, worden alle niet-Webex-gespreksstatussen bij het opnieuw verbinden teruggezet op 'onbekend'.
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.
Meld u aan bij BroadWorks CommPilot.
Ga voor een geselecteerde gebruiker naar Clienttoepassingen en configureer het Busy Lamp Field.
Voeg de URL van de BLF-lijst toe die wordt gecontroleerd.
Gebruik de zoekparameters om gebruikers te zoeken en toe te voegen aan de lijst Bewaakte gebruikers.
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:
ga naar het tabblad Algemeen van uw tabblad Instellingen in Windows of Voorkeuren op de Mac.
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).
Meld u aan bij Partnerhub ( https://admin.webex.com) en selecteer Klanten.
Selecteer de toepasselijke klantorganisatie.
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:
|
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 |
|
BroadWorks-factureringsrapporten weergeven | Wordt gebruikt om de rapporten weer te geven die beschikbaar zijn om te bekijken. | Leestoegang |
|
Een BroadWorks-factureringsrapport ophalen | Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen. | Leestoegang |
|
Een BroadWorks-factureringsrapport verwijderen | Wordt gebruikt om een gegenereerd rapport te verwijderen. | Schrijftoegang |
|
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.
|
|
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:
- Zorg ervoor dat u RSA-sleutels hebt gedeeld met alle XSP|ADP's.
- Zorg ervoor dat u op alle XSP|ADP's de AuthService-URL voor de webcontainer hebt opgegeven.
- 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.
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?
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
Meld u aan bij de Webex-app.
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.
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
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.
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)
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: 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 |
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.
|
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 | ||
Vereist voor adreslijstsynchronisatie | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereiste patch voor toepassingsserver | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereiste patch voor de functie Gespreksopname | ||
Vereiste patch voor doorstroominrichting | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Profielserver | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Platform | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
XSP|ADP | Vereist voor NPS-verificatieproxy | |
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereist voor NPS-verificatieproxy | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereist voor Unified Call History | ||
Overig | AP.xsa.22.0.1123.ap372757 | |
Versie R23
Server | Pleister | Aanvullende informatie |
|---|---|---|
Toepassingsserver | Vereist voor adreslijstsynchronisatie | |
App-server configureren | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor gespreksopname | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Profielserver | ||
Platform | ||
Vereist voor NPS-verificatieproxy | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
XSP|ADP | ||
Vereist voor NPS-verificatieproxy | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Overig | Bij gebruik van ADP... | Vereiste patch voor haakstatus (Presence) en Unified Call History |
Versie R24
Server | Pleister | Aanvullende informatie |
|---|---|---|
Toepassingsserver | Vereist voor Unified Messaging Server (UMS) | |
Vereist voor flowthrough-inrichting | ||
Vereist voor gespreksopname | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Overig | Vereiste patch voor haakstatus (Presence) en Unified Call History |
BroadWorks-tags vereist voor Webex
Raadpleeg de Webex voor Cisco BroadWorks-configuratiehandleiding voor informatie over de BroadWorks-systeemtags en aangepaste tags die u voor Webex moet configureren.
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

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.

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

De Webex-app lanceert een browser naar Cisco Common Identity (CI) zodat gebruikers hun e-mailadres kunnen invoeren.
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.)
De gebruiker voert zijn of haar BroadWorks-referenties in.
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).
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.
De Webex-app ontdekt de gespreksconfiguratie van BroadWorks en andere services van Webex.
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:

U downloadt en installeert de Webex-app.
Mogelijk hebt u de koppeling van uw serviceprovider ontvangen of kunt u de download vinden op de pagina Webex-downloads.
U voert uw e-mailadres in op het aanmeldscherm van Webex. Klik op Volgende.
U wordt meestal omgeleid naar een pagina met het merk Serviceprovider.
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.
Voer uw BroadWorks-wachtwoord in.
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
De client belt XSI om een apparaatbeheertoken en de URL naar het DMS op te halen.
De klant vraagt zijn apparaatprofiel aan bij DMS door het token van stap 1 voor te leggen.
De client leest het apparaatprofiel en haalt de SIP-referenties, adressen en poorten op.
Client verzendt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.
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:
Meld u aan bij Partner Hub en selecteer Klanten.
Selecteer de juiste klant.
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 WAVMS_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
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:
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).Implementeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects>deploy application /authService
Duur token configureren
Controleer de bestaande tokenconfiguratie (uren):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>getStel 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. |
Selecteer één XSP|ADP om een sleutelpaar te genereren.
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)
De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeysHet geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere.keysbestand indien nodig.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:
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/authServiceVoeg de URL van de verificatieservice toe aan de container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authServiceHiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.
Controleer de parameter met
get.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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>Voer de opdracht in
get <interfaceIp> 443om 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).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-POLY1305in 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_POLY1305Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.
Trust configureren voor verificatieservice (met mTLS)
Meld u aan bij Control Hub met uw partnerbeheerdersaccount.
Ga naar en klik op Webex CA-certificaat downloaden om
CombinedCertChain2023.txtop 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.Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txt.Openen
combinedcertchain2023.txtin een teksteditor.Selecteer en knip het eerste tekstblok, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----en plak het tekstblok in een nieuw bestand.Sla het nieuwe bestand op als
root2023.txt.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-----.
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txt.Meld u aan bij de XSP|ADP en ga naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoerenUpdateTrustom de parameters en opdrachtindeling weer te geven.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,webexclientissuingenwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang de vier ingangen uniek zijn.Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> getAlias 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.
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
Navigeren naar
XSP|ADP_CLI/Interface/Http/HttpServer>en voer degetopdracht om de raakvlakken te zien.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 trueZie de XSP|ADP CLI-documentatie voor meer informatie. In wezen de eerste
truebeveiligt de interface met TLS (servercertificaat wordt gemaakt indien nodig) en de tweedetruedwingt 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.
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
Navigeren naar
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>en voer degetom te zien welke toepassingen worden uitgevoerd.Een toepassing toevoegen en hiervoor clientverificatie vereisen (wat hetzelfde betekent als mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName trueZie de XSP|ADP CLI-documentatie voor meer informatie. Daar worden de toepassingsnamen opgesomd. Het
truein 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:
Ga naar Instellingen > BroadWorks Calling.
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 |
| |
25 januari 2024 | 2-107 |
| |
23 januari 2024 | 2-106 |
| |
10 januari 2024 | 2-105 |
| |
20 december 2023 | 2-104 |
| |
13 december 2023 | 2-103 |
| |
12 december 2023 | 2-102 |
| |
08 december 2023 | 2-101 |
| |
08 november 2023 | 2-100 |
| |
25 oktober 2023 | 2-99 |
| |
13 september 2023 | 2-98 |
| |
04 september 2023 | 2-97 |
| |
08 augustus 2023 | 2-96 |
| |
23 juni 2023 | 2-95 |
| |
30 mei 2023 | 2-94 |
| |
26 mei 2023 | 2-93 |
| |
24 mei 2023 | 2-92 |
| |
10 mei 2023 | 2-91 |
| |
09 mei 2023 | 2-90 |
| |
04 mei 2023 | 2-89 |
| |
27 april 2023 | 2-88 |
| |
14 april 2023 | 2-87 |
| |
17 maart 2023 | 2-86 |
| |
11 maart 2023 | 2-85 |
| |
10 maart 2023 | 2-84 |
| |
07 maart 2023 | 2-83 |
| |
28 februari 2023 | 2-82 |
| |
15 februari 2023 | 2-81 |
| |
10 februari 2023 | 2-80 |
| |
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:
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).Implementeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects>deploy application /authService
Duur token configureren
Controleer de bestaande tokenconfiguratie (uren):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>getStel 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. |
Selecteer één XSP|ADP om een sleutelpaar te genereren.
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)
De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeysHet geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere.keysbestand indien nodig.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:
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/authServiceVoeg de URL van de verificatieservice toe aan de container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authServiceHiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.
Controleer de parameter met
get.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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>Voer de opdracht in
get <interfaceIp> 443om 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).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-POLY1305in 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_POLY1305Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.
Trust configureren voor verificatieservice (met mTLS)
Meld u aan bij Control Hub met uw partnerbeheerdersaccount.
Ga naar en klik op Webex CA-certificaat downloaden om
CombinedCertChain2023.txtop 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.Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txt.Openen
combinedcertchain2023.txtin een teksteditor.Selecteer en knip het eerste tekstblok, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----en plak het tekstblok in een nieuw bestand.Sla het nieuwe bestand op als
root2023.txt.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-----.
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txt.Meld u aan bij de XSP|ADP en ga naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoerenUpdateTrustom de parameters en opdrachtindeling weer te geven.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,webexclientissuingenwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang de vier ingangen uniek zijn.Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> getAlias 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.
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
Navigeren naar
XSP|ADP_CLI/Interface/Http/HttpServer>en voer degetopdracht om de raakvlakken te zien.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 trueZie de XSP|ADP CLI-documentatie voor meer informatie. In wezen de eerste
truebeveiligt de interface met TLS (servercertificaat wordt gemaakt indien nodig) en de tweedetruedwingt 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.
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
Navigeren naar
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>en voer degetom te zien welke toepassingen worden uitgevoerd.Een toepassing toevoegen en hiervoor clientverificatie vereisen (wat hetzelfde betekent als mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName trueZie de XSP|ADP CLI-documentatie voor meer informatie. Daar worden de toepassingsnamen opgesomd. Het
truein 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:
Ga naar Instellingen > BroadWorks Calling.
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 |
| |
24 februari 2024 | 2-110 |
| |
20 februari 2024 | 2-109 |
| |
07 februari 2024 | 2-108 |
| |
25 januari 2024 | 2-107 |
| |
23 januari 2024 | 2-106 |
| |
10 januari 2024 | 2-105 |
| |
20 december 2023 | 2-104 |
| |
13 december 2023 | 2-103 |
| |
12 december 2023 | 2-102 |
| |
08 december 2023 | 2-101 |
| |
08 november 2023 | 2-100 |
| |
25 oktober 2023 | 2-99 |
| |
13 september 2023 | 2-98 |
| |
04 september 2023 | 2-97 |
| |
08 augustus 2023 | 2-96 |
| |
23 juni 2023 | 2-95 |
| |
30 mei 2023 | 2-94 |
| |
26 mei 2023 | 2-93 |
| |
24 mei 2023 | 2-92 |
| |
10 mei 2023 | 2-91 |
| |
09 mei 2023 | 2-90 |
| |
04 mei 2023 | 2-89 |
| |
27 april 2023 | 2-88 |
| |
14 april 2023 | 2-87 |
| |
17 maart 2023 | 2-86 |
| |
11 maart 2023 | 2-85 |
| |
10 maart 2023 | 2-84 |
| |
07 maart 2023 | 2-83 |
| |
28 februari 2023 | 2-82 |
| |
15 februari 2023 | 2-81 |
| |
10 februari 2023 | 2-80 |
| |
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:
| 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.
| 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:

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.)
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.)
Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)
Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)
Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)
|
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.
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:
Zendesk—Alleen premium
Slack—Alleen premium
Microsoft Teams voor Webex Meetings—Standaard of Premium
Microsoft Teams for Calling: ondersteund met alle pakketten
Office 365-agenda—Standaard of Premium
Google-agenda voor G Suite—Standaard of Premium
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


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:
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:
Wanneer het installatieprogramma hierom vraagt,
Do you want to configure NTP?, voer iny.Wanneer het installatieprogramma hierom vraagt,
Is this server going to be a NTP server?, voer inn.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_SHA384TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_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_SHA384TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256TLS_DHE_RSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384TLS_DHE_RSA_WITH_AES_256_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256TLS_DHE_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHATLS_ECDHE_RSA_WITH_AES_256_CBC_SHATLS_DHE_RSA_WITH_AES_256_CBC_SHATLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHATLS_ECDHE_RSA_WITH_AES_128_CBC_SHATLS_DHE_RSA_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_256_GCM_SHA384TLS_DHE_PSK_WITH_AES_256_GCM_SHA384TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_PSK_WITH_AES_128_GCM_SHA256TLS_DHE_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_128_GCM_SHA256TLS_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_256_CBC_SHA256TLS_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384TLS_ECDHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_PSK_WITH_AES_256_CBC_SHA384TLS_DHE_PSK_WITH_AES_256_CBC_SHA384TLS_RSA_PSK_WITH_AES_256_CBC_SHATLS_DHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHATLS_PSK_WITH_AES_256_CBC_SHA384TLS_PSK_WITH_AES_256_CBC_SHATLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_128_CBC_SHA256TLS_DHE_PSK_WITH_AES_128_CBC_SHA256TLS_RSA_PSK_WITH_AES_128_CBC_SHATLS_DHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_WITH_AES_128_CBC_SHATLS_PSK_WITH_AES_128_CBC_SHA256TLS_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 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.
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.

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.


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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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
De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.
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
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:
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.
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.
|
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.
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.
Bring Your Own PSTN-oplossing voor Webex voor Cisco BroadWorks: met deze oplossing kunnen serviceproviders telefoonnummers inrichten die ze bezitten (in plaats van door Cisco geleverde nummers) voor gebruikers om te gebruiken wanneer ze deelnemen aan Webex Meetings.
Webex voor Cisco BroadWorks-configuratiehandleiding: beschrijft hoe u de Webex-app voor Webex voor Cisco BroadWorks configureert.
- Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks: beschrijft hoe u het besturingssysteem en de MPP-apparaten van de serviceruimte kunt onboarden en gebruiken.
Handleiding voor probleemoplossing van Webex voor Cisco BroadWorks: bevat informatie voor het oplossen van problemen met Webex voor Cisco BroadWorks.
Webex voor Cisco BroadWorks-artikelen
Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:
Documentatie van Webex voor Cisco BroadWorks: de landingspagina bevat technische documenten en optionele Webex-artikelen die zijn bedoeld voor partnerbeheerders van Webex voor Cisco BroadWorks.
Nieuw in Webex voor Cisco BroadWorks: lees meer over de nieuwste functies en wat er binnenkort beschikbaar is.
Bekende problemen en beperkingen: lees meer over bekende problemen die we hebben geïdentificeerd in de Webex for Cisco BroadWorks-oplossing.
Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM: in dit artikel wordt beschreven hoe u partnerbeheerdersrollen toewijst voor partnerorganisaties die Webex voor Cisco BroadWorks aanbieden. Rollen worden gebruikt om beheerderstoegang toe te wijzen aan instellingen in Partnerhub en Control Hub.
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
Webex voor BroadWorks-ontwikkelaarshandleiding: bevat informatie voor ontwikkelaars die toepassingen maken die de Webex voor BroadWorks-API's gebruiken.
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:
Webex-vereisten: Het onboardsjabloon bevat de volgende instellingen:
|
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:
Webex-vereisten: Het onboardsjabloon bevat de volgende instellingen:
|
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:
Vereisten voor BroadWorks:
Webex-vereisten:
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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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.
|
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. |
| Verificatiemodus | BroadWorks | Webex |
| Primaire gebruikersidentiteit | BroadWorks-gebruikers-id | E-mailadres |
| Identiteitsprovider | BroadWorks.
| Cisco Common Identity |
| Meervoudige verificatie? | Nee | Vereist Customer IdP die meervoudige verificatie ondersteunt. |
Validatiepad gebruikergegevens
|
|
|
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-8ADP_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.
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
BroadWorks-exemplaar(en) met minimale versie R22. Zie de BroadWorks-softwarevereisten (in dit document) voor ondersteunde versies en patches. Voor meer informatie, zie Beleid voor de levenscyclus van BroadSoft-producten sectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.
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
Als u de Engelse versie van de Webex-app wilt downloaden, gaat u naar https://www.webex.com/webexfromserviceproviders-downloads.html. De Webex-app is beschikbaar op:
Windows-pc's/laptops
Apple-pc's/laptops met MacOS
iOS (Apple Store)
Android (Play store)
Webbrowsers (ga naar https://teams.webex.com/)
Gelokaliseerde versies
Gebruik een van de volgende koppelingen om een gelokaliseerde versie van de Webex-app te downloaden:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (Koreaans)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (Frans)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (Portugees)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (Traditioneel Chinees)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (vereenvoudigd Chinees)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Japan)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spanje)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (Duits)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italiaans)
Fysieke telefoons en accessoires
Cisco IP-telefoons:
Cisco IP-telefoon 6800-serie met Firmware voor meerdere platforms voor meerdere platforms
Cisco IP-telefoon 7800-serie met Firmware voor meerdere platforms voor meerdere platforms
Cisco IP-telefoon 8800-serie met Firmware voor meerdere platforms voor meerdere platforms
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html voor modellen en meer informatie.
We ondersteunen telefoons van derden op dezelfde manier als met andere BroadWorks-integraties. Ze hebben echter nog geen contacten en aanwezigheidsintegratie met Webex voor Cisco BroadWorks.
Adapters:
Analoge telefoonoplader voor meerdere platforms voor Cisco ATA 191
Analoge telefoonoplader voor meerdere platforms voor Cisco ATA 192
Zie https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html voor modellen en meer informatie.
Hoofdtelefoons:
Cisco-hoofdtelefoon 500-serie
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html voor modellen en meer informatie.
Apparaten met Room OS:
Webex Room- en Room Kit-serie
Webex Desk-serie
Webex Board-serie
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: Configuratiebestand: |
Sjabloon voor Webex-tablet |
Type identiteit/apparaatprofiel: Verbinding maken - tablet DTAF: Configuratiebestand: |
Webex Desktop-sjabloon |
Type identiteit/apparaatprofiel: Bedrijfscommunicator - PC DTAF: Configuratiebestand: |
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:
XSP|ADP AuthService Configuration' voor het configureren van de service op XSP|ADP.
'NPS-configuratie voor verificatie proxy instellen' om NPS te configureren voor het gebruik van de verificatieproxy.
CI-gebruikers-UUID synchroniseren' voor CI-gebruikers-UUID synchroniseren. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.
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 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:

(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 AuthenticationDe 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.
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 |
Moet gelezen worden | |
Moet gelezen worden | |
Domeinen en URL's die toegankelijk moeten zijn voor Webex-services | Moet gelezen worden |
Optioneel | |
Optioneel | |
Optioneel | |
Optioneel | |
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 |
|
| Verwijst naar LB1 (Site A) |
A |
|
| 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 |
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 |
|
| Clientdetectie van Xsi-interface |
SRV |
|
| Clientdetectie van Xsi-interface |
A |
|
| Verwijst naar LB1 (site A) |
A |
|
| 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 |
|
| Lastbalancer |
A | LB.voorbeeld.com |
| 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 |
|
| Verwijst naar LB1 (site A) |
A |
|
| 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:
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:
De client voert een SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">
Als de SRV-zoekopdracht een of meer A/AAAA-doelen retourneert:
De client zoekt A/AAAA op voor deze doelen en slaat de geretourneerde IP-adressen in de cache.
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).
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.
(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>Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.
Als deze bestaan, vergelijkt de client met het oorspronkelijke XSI-adres dat hij heeft ontvangen via de BroadWorks-clusterconfiguratie.
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.
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.



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. |
Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.
Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw versie:
Voor R22:
Voor R23:
Voor R24: geen patch vereist
Elke verwijzing naar XSP omvat XSP of ADP.Installeer de
AuthenticationServicetoepassing op elke XSP|ADP-service.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/authServiceVoer deze opdracht uit om de AuthenticationService te implementeren op de XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
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> getAls dit niet aanwezig is, voert u de volgende opdracht uit om de standaard Java-trusts te importeren:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrustU 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.
Configureer de identiteitsproviders door de volgende opdrachten uit te voeren op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> getset clientId client-Id-From-Step1set enabled trueset clientSecret client-Secret-From-Step1set ciResponseBodyMaxSizeInBytes 65536set issuerName <URL>—Voor deURLvoer de URL van de IssuerName in die van toepassing is op uw CI-cluster. Zie volgende tabel.set issuerUrl <URL>—Voor deURLvoer 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
EU
US-B
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".
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:userConfigureer identiteitsproviders voor Cisco Federation met de volgende opdrachten op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> getset flsUrl https://cifls.webex.com/federationset refreshPeriodInMinutes 60set refreshToken refresh-Token-From-Step1
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> GetConfigureer Tokenbeheer met de volgende opdrachten op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>set tokenIssuer BroadWorksset tokenDurationInHours 720
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.Selecteer één XSP|ADP om een sleutelpaar te genereren.
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)
De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeysHet geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere.keysbestand indien nodig.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 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:
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/authServiceVoeg de URL van de verificatieservice toe aan de container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authServiceHiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.
Controleer de parameter met
get.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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>Voer de opdracht in
get <interfaceIp> 443om 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).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-POLY1305in 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_POLY1305Raadpleeg 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.
Toepassingsserver configureren voor CTI-abonnementen
XSP|ADP's configureren voor mTLS geverifieerde CTI-abonnementen
Inkomende poorten openen voor veilige CTI-interface
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 |
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:
|
CTI TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp>om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>Voer de
getopdracht 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).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-POLY1305naar de CTI-interface gebruikt u:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305Raadpleeg 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:
Aanmelden bij Partnerhub .
Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om
CombinedCertChain2023.txtop 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.
Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txtOpenen
combinedcertchain2023.txtin een teksteditor.Selecteer en knip het eerste tekstblok, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----en plak het tekstblok in een nieuw bestand.Sla het nieuwe bestand op als
root2023.txt.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-----.
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txtMeld u aan bij de XSP|ADP en ga naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>(Optioneel) Uitvoeren
help updateTrustom de parameters en opdrachtindeling weer te geven.Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txtXSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Alle aliassen moeten een andere naam hebben.
webexclientroot2023enwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang alle ingangen uniek zijn.Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> getAlias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]Clients toestaan te verifiëren met certificaten:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
CTI-interface toevoegen en mTLS inschakelen
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
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> getVoer 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>
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 .
Mac-gebruikers: Klik op profielfoto en vervolgens op .
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.
Meld u aan bij cisco.com en zoek naar 'BWCallSettingsWeb' in het gedeelte software downloaden.
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.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).
Kopieer het .war-bestand naar een tijdelijke locatie op de XSP|ADP, zoals
/tmp/.Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.warDe BroadWorks-softwaremanager valideert en installeert het bestand.
[Optioneel] Verwijderen
/tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist).Activeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettingsDe 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.Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
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.
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.
Zorg ervoor dat u over de nieuwste configuratiesjablonen voor de Webex-app beschikt (zie Apparaatprofielen).
Het doel voor webgespreksinstellingen instellen op
csw:%WEB_CALL_SETTINGS_TARGET_WXT% cswStel 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.
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.
Zie de functiebeschrijving Pushserver voor VoIP in UCaaS voor meer informatie.
De BroadWorks-patches voor de functie zijn beschikbaar op: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Zie voor NPS-software en -patches het gedeelte Uw NPS voorbereiden op Webex voor Cisco BroadWorks.
Zoek en download de patch vanaf de downloadpagina van de software.
Meer informatie over de ADP-server vindt u op https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
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: XSP R22-patches: XSP R23-pleisters: | ||
| 3 | Activeer de toepassing Pushserver voor meldingen. | ||
| 4 | (Voor Android-meldingen) Schakel de FCM v1-API in op de NPS.
| ||
| 5 | (Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.
| ||
| 6 | Voeg een techsupport van de NPS XSP/ADP toe. | ||
| 7 | Op elke AS-server wordt het namedefs-bestand in 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
|
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:
Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u
| |||||||||||||||||||
| 3 | Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):
| |||||||||||||||||||
| 4 | (Voor Android-meldingen) Voeg de Android-toepassings-id toe aan de context van de FCM-toepassingen op de NPS.
| |||||||||||||||||||
| 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.
| |||||||||||||||||||
| 6 | Configureer de volgende NPS-URL's:
| |||||||||||||||||||
| 7 | Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:
| |||||||||||||||||||
| 8 | Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen: | |||||||||||||||||||
| 9 | Start de XSP|ADP opnieuw: | |||||||||||||||||||
| 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: wanneer u bestaande UCaaS-clients hebt en deze moet migreren om FCMv1 te gebruiken.
SaaS-clients migreren naar FCMv1: wanneer u bestaande SaaS-clients hebt en deze moet migreren om FCMv1 te gebruiken.
ADP-server bijwerken: wanneer u de NPS naar een ADP-server migreert.
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 . 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
|
Meld u aan bij FCM-beheerder SDK op http://console.firebase.google.com.
Selecteer de juiste Android-toepassing.
Noteer de project-ID op het tabblad Algemeen
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:
Klik op de blauwe knop om een nieuw serviceaccount aan te maken
Klik op de blauwe knop om een nieuwe privésleutel te genereren
Sleutel downloaden naar een veilige locatie
Een bestaand serviceaccount hergebruiken:
Klik op de blauwe tekst om bestaande serviceaccounts weer te geven.
Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.
Klik aan de rechterkant op het hamburgermenu en maak een nieuwe privésleutel aan.
Download het json-bestand dat de sleutel bevat en sla het op naar een veilige locatie.
Kopieer het json-bestand naar de XSP|ADP.
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 ********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_projectFCMv1 inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...DoneVoer het installatiebestand
bwrestartopdracht 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. |
FCM uitschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...DoneVoer het installatiebestand
bwrestartopdracht om de XSP|ADP opnieuw te starten.FCM inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...DoneVoer het installatiebestand
bwrestartopdracht 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.
Haal het JSON-bestand op van de Google Cloud-console:
Ga op de Google Cloud Console naar de pagina Service Accounts.
Klik op Selecteer een project, kies uw project en klik op Openen.
Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.
Selecteer een type Sleutel en klik op Aanmaken
Het bestand wordt gedownload.
FCM toevoegen aan de ADP-server:
Importeer het JSON-bestand naar de ADP-server met de
/bw/installopdracht.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:Voeg vervolgens de toepassing en de sleutel toe:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...DoneControleer 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:
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
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.
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.
(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.
Voeg uw URL's voor XSI-acties en XSI-gebeurtenissen toe.
Optioneel. Werk de DAS-URL bij met de URL van de apparaatactiveringsservice.
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.
Klik op Volgende.
Ga als volgt te werk op de pagina CTI-interface:
Voeg de CTI-URL en poort toe voor de CTI-interface waarmee u verbinding wilt maken.
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.
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.
Klik op Volgende.
Voeg de URL van uw verificatieservice toe.
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.
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.
Klik op Clusters weergeven en u moet uw nieuwe cluster zien en zien of de validatie is gelukt.
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
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
Klik op Clusters weergeven.
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.
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.
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
Klik op Sjabloon toevoegen.
Hiermee start u een wizard waarin u de configuratie kunt leveren voor klanten die deze sjabloon gebruiken.
Gebruik de vervolgkeuzelijst Cluster om het cluster te kiezen dat u met deze sjabloon wilt gebruiken.
Voer een sjabloonnaam in en klik op Volgende.
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.
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.
Optioneel. Schakel Gratis bellen via Cisco Webex uitschakelen in als u Webex-gesprekken wilt uitschakelen.
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.
Klik op Volgende.
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.
Klik op Volgende.
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).
Klik op Volgende.
Voor Voorkeuren configureert u het volgende:
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.
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.
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.
Zorg ervoor dat de schakelaar E-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties is ingeschakeld (de standaardinstelling is ingeschakeld).
Klik op Volgende.
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.
Klik op Sjablonen weergeven en u moet uw nieuwe sjabloon met andere sjablonen in de lijst zien.
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.
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)
Als u dit nog niet hebt gedaan, past u de volgende patch toe die van toepassing is op uw versie:.
Voor R22:
AP.as.22.0.1123.ap373197Voor R23:
AP.as.23.0.1075.ap373197Voor R24:
AP.as.24.0.944.ap384177
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.Wijzigen in de
Maintenance/ContainerOptionscontext.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.
Meld u aan bij Partner Hub en ga naar .
Klik op Sjablonen weergeven.
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.
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. |
Meld u aan bij de toepassingsserver en configureer de interface voor berichten.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURLAS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_nameAS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_passwordAS_CLI/Interface/Messaging> set enableSynchronization true
De geïntegreerde IMP-interface activeren:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
U moet de volledig gekwalificeerde naam invoeren voor de |
(Optie) Inrichtingsparameters per onderneming configureren op toepassingsserver
Open in de BroadWorks-gebruikersinterface de onderneming die u wilt configureren en ga naar Services > Geïntegreerde IM&P.
Selecteer Servicedomein gebruiken en voer een dummywaarde in (Webex negeert deze parameter. U kunt dit gebruiken
example.com).Selecteer Messaging Server gebruiken.
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
provisioningURLparameter, 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/hostsbestand op het AS.Voer in het veld Gebruikersnaam een naam in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.
Voer een wachtwoord in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.
Voor Standaard gebruikersidentiteit voor IM&P-id selecteert u Primair.
Klik op Toepassen.
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. |
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.
Open een serviceaanvraag met Cisco TAC. TAC moet een vertrouwensrelatie opbouwen tussen de externe identiteitsprovider en de Cisco Common Identity-service. .
Als uw IdP depassEmailInRequestin 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.Upload het CI-metagegevensbestand dat TAC aan uw identiteitsprovider heeft geleverd.
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.

Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.
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. |
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.
Configureer de omleidings-URI op de OpenID connect-id-provider.
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.

Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.
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-InfoSIP-koptekst:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork trueAS_CLI/Interface/SIP> set sendCallCorrelationIDAccess trueHet
enableCallCorrelationIDparameter 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 omenableCallCorrelationIDingeschakeld 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:
AP.as.22.0.1123.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
Voor R23:
AP.as.23.0.1075.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433Bij gebruik van XSP:
AP.xsp.23.0.1075.ap378585Bij gebruik van ADP:
Xsi-Events-23_2021.05_1.251.bwar
Voor R24:
AP.as.24.0.944.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
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:
Meld u aan bij Partnerhub op
admin.webex.com.Ga naar Instellingen en selecteer een bestaand cluster.
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.
Schakel het selectievakje Gespreksgeschiedenis inschakelen in.
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:
- Schakel Unified Call History in zoals beschreven in het vorige gedeelte.
- 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
- De functie moet geactiveerd worden via de AS CLI:
- AS_CLI/System/ActivatableFeature> 104112 activeren
- AS_CLI/System/StirShaken> enableVerification true instellen
- 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)
Aanmelden bij Partner Hub
Klik op Instellingen.
Klik op Cluster weergeven en selecteer het juiste BroadWorks-cluster.
Schakel de schakelaar Niet storen (NST) in.
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.
Als de validatie slaagt, klik dan op Save.
|
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

Gespreksopname
Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopname.
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. |
|
Altijd met onderbreken/hervatten | De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker kan een opname onderbreken en 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 |
|
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. |
|
Vereisten
Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:
Voor R22: AP.as.22.0.1123.ap377718
Voor R23: AP.as.23.0.1075.ap377718
Voor R24: AP.as.24.0.944.ap377718
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.
Haal de vereiste DTAF-bestanden op (zie Apparaatprofielen in het gedeelte Uw omgeving voorbereiden).
Controleer of u de juiste tagsets hebt in BroadWorks System > Resources > Device Management Tagsets.
Voor elke client die u inricht:
Download en pak het DTAF zip-bestand voor de specifieke client uit.
DTAF-bestanden importeren naar BroadWorks op System > Resources > Identity/Device Profile Types
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
Pas de sjablonen aan volgens uw omgeving (zie onderstaande tabel).
Sla het bestand op.
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
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 hun eigen merkaanpassingen toe te passen, kunnen klantbeheerders de procedures volgen bij Uw bedrijfsbranding toevoegen aan Webex.
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: |
| 2 | Klantorganisatie en gebruikers verifiëren in Control Hub: |
Gebruikerstests
| 1 | Download de Webex-app op twee verschillende machines. |
| 2 | Meld u aan als testgebruikers op de twee machines. |
| 3 | Voer testgesprekken. |
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:
Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.
Klik op Sjablonen weergeven.
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.
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.
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) |
|
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):
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
Gebruiker verplaatsen (met vertrouwd e-mailadres)
Als de onboardsjabloon vertrouwde e-mails gebruikt, kan de partnerbeheerder volgende gebruikers met dit proces verplaatsen:
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.
De gebruiker opent de e-mail en klikt op Account activeren. De gebruiker wordt omgeleid naar de Webex-consumentenportal.
Gebruiker meldt zich aan bij Webex.
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:
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.
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.
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.
Gebruiker meldt zich aan bij Webex.
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.
De gebruiker meldt zich aan bij de URL van de gebruikerstoegang met BroadWorks-aanmeldgegevens.
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.
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.
De gebruiker meldt zich aan bij de Consumentenportal.
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:
| ||
| 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.
|
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. |
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.
Verwijder alle Webex voor BroadWorks-werkplekken uit de organisatie. Gebruik de API Een BroadWorks-werkplek verwijderen.
Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de API Een BroadWorks-abonnee verwijderen.
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.
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:
|
| 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:
![]() |
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 BroadWorks | Overeenkomstig kenmerk in Webex | Doel | Notities |
| BroadWorks-gebruikers-id | Geen | Primaire id | U 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-id | Gebruikers-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:
Wijzig de BroadWorks-gebruikers-id niet. Dit wordt niet ondersteund. |
| Alternatieve id | Geen | Hiermee schakelt u het authn van de gebruiker in, via e-mail en wachtwoord, met de BroadWorks-gebruikers-id | Moet 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:
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.
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:
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.
Zoek en selecteer de gebruiker in Control Hub.
- 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
| 1 | Gebruik de People API's om alle gebruikers uit de organisatie te verwijderen:
| ||
| 2 | Als adreslijstsynchronisatie is ingeschakeld, schakelt u deze uit. Dit kan via Partner Hub of via de openbare API. Adreslijstsynchronisatie uitschakelen via Partner Hub: 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 | ||
| 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:
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 | |||||||||
| 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:
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.
Meld u aan bij Partnerhub op admin.webex.com.
Kies Instellingen.
Klik op Sjabloon weergeven en kies de juiste onboardingsjabloon.
Klik op Cisco Webex Free Calling uitschakelen.
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:
Open CommPilot en ga naar de gebruikersconfiguratie.
Verwijder de geïntegreerde IM+P-service van de gebruiker en klik op OK.
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.
Gebruik de Een BroadWorks-abonnee-API verwijderen om de gebruiker te verwijderen.
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:
Aanwezigheid wordt niet ondersteund voor niet-CI Broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.
CI-gebruikers zonder Webex-cloudrechten of computertype accounts (werkplekken) geven alleen aanwezigheid 'in gesprek' en 'onbekend' weer. Er is geen status actief, overgaan, enz.
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.
Als u uw verbinding verliest, worden alle niet-Webex-gespreksstatussen bij het opnieuw verbinden teruggezet op 'onbekend'.
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.
Meld u aan bij BroadWorks CommPilot.
Ga voor een geselecteerde gebruiker naar Clienttoepassingen en configureer het Busy Lamp Field.
Voeg de URL van de BLF-lijst toe die wordt gecontroleerd.
Gebruik de zoekparameters om gebruikers te zoeken en toe te voegen aan de lijst Bewaakte gebruikers.
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:
ga naar het tabblad Algemeen van uw tabblad Instellingen in Windows of Voorkeuren op de Mac.
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).
Meld u aan bij Partnerhub ( https://admin.webex.com) en selecteer Klanten.
Selecteer de toepasselijke klantorganisatie.
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:
|
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 |
|
BroadWorks-factureringsrapporten weergeven | Wordt gebruikt om de rapporten weer te geven die beschikbaar zijn om te bekijken. | Leestoegang |
|
Een BroadWorks-factureringsrapport ophalen | Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen. | Leestoegang |
|
Een BroadWorks-factureringsrapport verwijderen | Wordt gebruikt om een gegenereerd rapport te verwijderen. | Schrijftoegang |
|
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.
|
|
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:
- Zorg ervoor dat u RSA-sleutels hebt gedeeld met alle XSP|ADP's.
- Zorg ervoor dat u op alle XSP|ADP's de AuthService-URL voor de webcontainer hebt opgegeven.
- 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.
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?
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
Meld u aan bij de Webex-app.
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.
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
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.
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)
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: 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 |
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.
|
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 | ||
Vereist voor adreslijstsynchronisatie | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereiste patch voor toepassingsserver | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereiste patch voor de functie Gespreksopname | ||
Vereiste patch voor doorstroominrichting | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Profielserver | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Platform | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
XSP|ADP | Vereist voor NPS-verificatieproxy | |
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereist voor NPS-verificatieproxy | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereist voor Unified Call History | ||
Overig | AP.xsa.22.0.1123.ap372757 | |
Versie R23
Server | Pleister | Aanvullende informatie |
|---|---|---|
Toepassingsserver | Vereist voor adreslijstsynchronisatie | |
App-server configureren | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor gespreksopname | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Profielserver | ||
Platform | ||
Vereist voor NPS-verificatieproxy | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
XSP|ADP | ||
Vereist voor NPS-verificatieproxy | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Overig | Bij gebruik van ADP... | Vereiste patch voor haakstatus (Presence) en Unified Call History |
Versie R24
Server | Pleister | Aanvullende informatie |
|---|---|---|
Toepassingsserver | Vereist voor Unified Messaging Server (UMS) | |
Vereist voor flowthrough-inrichting | ||
Vereist voor gespreksopname | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Overig | Vereiste patch voor haakstatus (Presence) en Unified Call History |
BroadWorks-tags vereist voor Webex
Raadpleeg de Webex voor Cisco BroadWorks-configuratiehandleiding voor informatie over de BroadWorks-systeemtags en aangepaste tags die u voor Webex moet configureren.
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

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.

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

De Webex-app lanceert een browser naar Cisco Common Identity (CI) zodat gebruikers hun e-mailadres kunnen invoeren.
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.)
De gebruiker voert zijn of haar BroadWorks-referenties in.
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).
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.
De Webex-app ontdekt de gespreksconfiguratie van BroadWorks en andere services van Webex.
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:

U downloadt en installeert de Webex-app.
Mogelijk hebt u de koppeling van uw serviceprovider ontvangen of kunt u de download vinden op de pagina Webex-downloads.
U voert uw e-mailadres in op het aanmeldscherm van Webex. Klik op Volgende.
U wordt meestal omgeleid naar een pagina met het merk Serviceprovider.
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.
Voer uw BroadWorks-wachtwoord in.
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
De client belt XSI om een apparaatbeheertoken en de URL naar het DMS op te halen.
De klant vraagt zijn apparaatprofiel aan bij DMS door het token van stap 1 voor te leggen.
De client leest het apparaatprofiel en haalt de SIP-referenties, adressen en poorten op.
Client verzendt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.
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:
Meld u aan bij Partner Hub en selecteer Klanten.
Selecteer de juiste klant.
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 WAVMS_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
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:
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).Implementeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects>deploy application /authService
Duur token configureren
Controleer de bestaande tokenconfiguratie (uren):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>getStel 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. |
Selecteer één XSP|ADP om een sleutelpaar te genereren.
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)
De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeysHet geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere.keysbestand indien nodig.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:
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/authServiceVoeg de URL van de verificatieservice toe aan de container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authServiceHiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.
Controleer de parameter met
get.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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>Voer de opdracht in
get <interfaceIp> 443om 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).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-POLY1305in 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_POLY1305Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.
Trust configureren voor verificatieservice (met mTLS)
Meld u aan bij Control Hub met uw partnerbeheerdersaccount.
Ga naar en klik op Webex CA-certificaat downloaden om
CombinedCertChain2023.txtop 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.Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txt.Openen
combinedcertchain2023.txtin een teksteditor.Selecteer en knip het eerste tekstblok, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----en plak het tekstblok in een nieuw bestand.Sla het nieuwe bestand op als
root2023.txt.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-----.
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txt.Meld u aan bij de XSP|ADP en ga naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoerenUpdateTrustom de parameters en opdrachtindeling weer te geven.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,webexclientissuingenwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang de vier ingangen uniek zijn.Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> getAlias 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.
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
Navigeren naar
XSP|ADP_CLI/Interface/Http/HttpServer>en voer degetopdracht om de raakvlakken te zien.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 trueZie de XSP|ADP CLI-documentatie voor meer informatie. In wezen de eerste
truebeveiligt de interface met TLS (servercertificaat wordt gemaakt indien nodig) en de tweedetruedwingt 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.
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
Navigeren naar
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>en voer degetom te zien welke toepassingen worden uitgevoerd.Een toepassing toevoegen en hiervoor clientverificatie vereisen (wat hetzelfde betekent als mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName trueZie de XSP|ADP CLI-documentatie voor meer informatie. Daar worden de toepassingsnamen opgesomd. Het
truein 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:
Ga naar Instellingen > BroadWorks Calling.
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 |
| |
20 februari 2024 | 2-109 |
| |
07 februari 2024 | 2-108 |
| |
25 januari 2024 | 2-107 |
| |
23 januari 2024 | 2-106 |
| |
10 januari 2024 | 2-105 |
| |
20 december 2023 | 2-104 |
| |
13 december 2023 | 2-103 |
| |
12 december 2023 | 2-102 |
| |
08 december 2023 | 2-101 |
| |
08 november 2023 | 2-100 |
| |
25 oktober 2023 | 2-99 |
| |
13 september 2023 | 2-98 |
| |
04 september 2023 | 2-97 |
| |
08 augustus 2023 | 2-96 |
| |
23 juni 2023 | 2-95 |
| |
30 mei 2023 | 2-94 |
| |
26 mei 2023 | 2-93 |
| |
24 mei 2023 | 2-92 |
| |
10 mei 2023 | 2-91 |
| |
09 mei 2023 | 2-90 |
| |
04 mei 2023 | 2-89 |
| |
27 april 2023 | 2-88 |
| |
14 april 2023 | 2-87 |
| |
17 maart 2023 | 2-86 |
| |
11 maart 2023 | 2-85 |
| |
10 maart 2023 | 2-84 |
| |
07 maart 2023 | 2-83 |
| |
28 februari 2023 | 2-82 |
| |
15 februari 2023 | 2-81 |
| |
10 februari 2023 | 2-80 |
| |
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:
| 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.
| 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:
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.)
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.)
Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)
Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)
Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)
|
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.
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:
Zendesk—Alleen premium
Slack—Alleen premium
Microsoft Teams voor Webex Meetings—Standaard of Premium
Microsoft Teams for Calling: ondersteund met alle pakketten
Office 365-agenda—Standaard of Premium
Google-agenda voor G Suite—Standaard of Premium
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
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:
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:
Wanneer het installatieprogramma hierom vraagt,
Do you want to configure NTP?, voer iny.Wanneer het installatieprogramma hierom vraagt,
Is this server going to be a NTP server?, voer inn.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_SHA384TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_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_SHA384TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256TLS_DHE_RSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384TLS_DHE_RSA_WITH_AES_256_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256TLS_DHE_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHATLS_ECDHE_RSA_WITH_AES_256_CBC_SHATLS_DHE_RSA_WITH_AES_256_CBC_SHATLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHATLS_ECDHE_RSA_WITH_AES_128_CBC_SHATLS_DHE_RSA_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_256_GCM_SHA384TLS_DHE_PSK_WITH_AES_256_GCM_SHA384TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_PSK_WITH_AES_128_GCM_SHA256TLS_DHE_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_128_GCM_SHA256TLS_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_256_CBC_SHA256TLS_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384TLS_ECDHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_PSK_WITH_AES_256_CBC_SHA384TLS_DHE_PSK_WITH_AES_256_CBC_SHA384TLS_RSA_PSK_WITH_AES_256_CBC_SHATLS_DHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHATLS_PSK_WITH_AES_256_CBC_SHA384TLS_PSK_WITH_AES_256_CBC_SHATLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_128_CBC_SHA256TLS_DHE_PSK_WITH_AES_128_CBC_SHA256TLS_RSA_PSK_WITH_AES_128_CBC_SHATLS_DHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_WITH_AES_128_CBC_SHATLS_PSK_WITH_AES_128_CBC_SHA256TLS_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 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.
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.
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.
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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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
De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.
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
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:
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.
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.
|
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.
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.
Bring Your Own PSTN-oplossing voor Webex voor Cisco BroadWorks: met deze oplossing kunnen serviceproviders telefoonnummers inrichten die ze bezitten (in plaats van door Cisco geleverde nummers) voor gebruikers om te gebruiken wanneer ze deelnemen aan Webex Meetings.
Webex voor Cisco BroadWorks-configuratiehandleiding: beschrijft hoe u de Webex-app voor Webex voor Cisco BroadWorks configureert.
- Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks: beschrijft hoe u het besturingssysteem en de MPP-apparaten van de serviceruimte kunt onboarden en gebruiken.
Handleiding voor probleemoplossing van Webex voor Cisco BroadWorks: bevat informatie voor het oplossen van problemen met Webex voor Cisco BroadWorks.
Webex voor Cisco BroadWorks-artikelen
Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:
Documentatie van Webex voor Cisco BroadWorks: de landingspagina bevat technische documenten en optionele Webex-artikelen die zijn bedoeld voor partnerbeheerders van Webex voor Cisco BroadWorks.
Nieuw in Webex voor Cisco BroadWorks: lees meer over de nieuwste functies en wat er binnenkort beschikbaar is.
Bekende problemen en beperkingen: lees meer over bekende problemen die we hebben geïdentificeerd in de Webex for Cisco BroadWorks-oplossing.
Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM: in dit artikel wordt beschreven hoe u partnerbeheerdersrollen toewijst voor partnerorganisaties die Webex voor Cisco BroadWorks aanbieden. Rollen worden gebruikt om beheerderstoegang toe te wijzen aan instellingen in Partnerhub en Control Hub.
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
Webex voor BroadWorks-ontwikkelaarshandleiding: bevat informatie voor ontwikkelaars die toepassingen maken die de Webex voor BroadWorks-API's gebruiken.
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:
Webex-vereisten: Het onboardsjabloon bevat de volgende instellingen:
|
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:
Webex-vereisten: Het onboardsjabloon bevat de volgende instellingen:
|
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:
Vereisten voor BroadWorks:
Webex-vereisten:
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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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.
|
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. |
| Verificatiemodus | BroadWorks | Webex |
| Primaire gebruikersidentiteit | BroadWorks-gebruikers-id | E-mailadres |
| Identiteitsprovider | BroadWorks.
| Cisco Common Identity |
| Meervoudige verificatie? | Nee | Vereist Customer IdP die meervoudige verificatie ondersteunt. |
Validatiepad gebruikergegevens
|
|
|
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-8ADP_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.
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
BroadWorks-exemplaar(en) met minimale versie R22. Zie de BroadWorks-softwarevereisten (in dit document) voor ondersteunde versies en patches. Voor meer informatie, zie Beleid voor de levenscyclus van BroadSoft-producten sectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.
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
Als u de Engelse versie van de Webex-app wilt downloaden, gaat u naar https://www.webex.com/webexfromserviceproviders-downloads.html. De Webex-app is beschikbaar op:
Windows-pc's/laptops
Apple-pc's/laptops met MacOS
iOS (Apple Store)
Android (Play store)
Webbrowsers (ga naar https://teams.webex.com/)
Gelokaliseerde versies
Gebruik een van de volgende koppelingen om een gelokaliseerde versie van de Webex-app te downloaden:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (Koreaans)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (Frans)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (Portugees)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (Traditioneel Chinees)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (vereenvoudigd Chinees)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Japan)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spanje)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (Duits)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italiaans)
Fysieke telefoons en accessoires
Cisco IP-telefoons:
Cisco IP-telefoon 6800-serie met Firmware voor meerdere platforms voor meerdere platforms
Cisco IP-telefoon 7800-serie met Firmware voor meerdere platforms voor meerdere platforms
Cisco IP-telefoon 8800-serie met Firmware voor meerdere platforms voor meerdere platforms
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html voor modellen en meer informatie.
We ondersteunen telefoons van derden op dezelfde manier als met andere BroadWorks-integraties. Ze hebben echter nog geen contacten en aanwezigheidsintegratie met Webex voor Cisco BroadWorks.
Adapters:
Analoge telefoonoplader voor meerdere platforms voor Cisco ATA 191
Analoge telefoonoplader voor meerdere platforms voor Cisco ATA 192
Zie https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html voor modellen en meer informatie.
Hoofdtelefoons:
Cisco-hoofdtelefoon 500-serie
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html voor modellen en meer informatie.
Apparaten met Room OS:
Webex Room- en Room Kit-serie
Webex Desk-serie
Webex Board-serie
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: Configuratiebestand: |
Sjabloon voor Webex-tablet |
Type identiteit/apparaatprofiel: Verbinding maken - tablet DTAF: Configuratiebestand: |
Webex Desktop-sjabloon |
Type identiteit/apparaatprofiel: Bedrijfscommunicator - PC DTAF: Configuratiebestand: |
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:
XSP|ADP AuthService Configuration' voor het configureren van de service op XSP|ADP.
'NPS-configuratie voor verificatie proxy instellen' om NPS te configureren voor het gebruik van de verificatieproxy.
CI-gebruikers-UUID synchroniseren' voor CI-gebruikers-UUID synchroniseren. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.
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 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:
(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 AuthenticationDe 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.
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 |
Moet gelezen worden | |
Moet gelezen worden | |
Domeinen en URL's die toegankelijk moeten zijn voor Webex-services | Moet gelezen worden |
Optioneel | |
Optioneel | |
Optioneel | |
Optioneel | |
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 |
|
| Verwijst naar LB1 (Site A) |
A |
|
| 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 |
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 |
|
| Clientdetectie van Xsi-interface |
SRV |
|
| Clientdetectie van Xsi-interface |
A |
|
| Verwijst naar LB1 (site A) |
A |
|
| 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 |
|
| Lastbalancer |
A | LB.voorbeeld.com |
| 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 |
|
| Verwijst naar LB1 (site A) |
A |
|
| 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:
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:
De client voert een SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">
Als de SRV-zoekopdracht een of meer A/AAAA-doelen retourneert:
De client zoekt A/AAAA op voor deze doelen en slaat de geretourneerde IP-adressen in de cache.
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).
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.
(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>Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.
Als deze bestaan, vergelijkt de client met het oorspronkelijke XSI-adres dat hij heeft ontvangen via de BroadWorks-clusterconfiguratie.
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.
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.
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. |
Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.
Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw versie:
Voor R22:
Voor R23:
Voor R24: geen patch vereist
Elke verwijzing naar XSP omvat XSP of ADP.Installeer de
AuthenticationServicetoepassing op elke XSP|ADP-service.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/authServiceVoer deze opdracht uit om de AuthenticationService te implementeren op de XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
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> getAls dit niet aanwezig is, voert u de volgende opdracht uit om de standaard Java-trusts te importeren:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrustU 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.
Configureer de identiteitsproviders door de volgende opdrachten uit te voeren op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> getset clientId client-Id-From-Step1set enabled trueset clientSecret client-Secret-From-Step1set ciResponseBodyMaxSizeInBytes 65536set issuerName <URL>—Voor deURLvoer de URL van de IssuerName in die van toepassing is op uw CI-cluster. Zie volgende tabel.set issuerUrl <URL>—Voor deURLvoer 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
EU
US-B
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".
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:userConfigureer identiteitsproviders voor Cisco Federation met de volgende opdrachten op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> getset flsUrl https://cifls.webex.com/federationset refreshPeriodInMinutes 60set refreshToken refresh-Token-From-Step1
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> GetConfigureer Tokenbeheer met de volgende opdrachten op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>set tokenIssuer BroadWorksset tokenDurationInHours 720
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.Selecteer één XSP|ADP om een sleutelpaar te genereren.
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)
De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeysHet geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere.keysbestand indien nodig.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 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:
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/authServiceVoeg de URL van de verificatieservice toe aan de container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authServiceHiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.
Controleer de parameter met
get.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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>Voer de opdracht in
get <interfaceIp> 443om 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).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-POLY1305in 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_POLY1305Raadpleeg 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.
Toepassingsserver configureren voor CTI-abonnementen
XSP|ADP's configureren voor mTLS geverifieerde CTI-abonnementen
Inkomende poorten openen voor veilige CTI-interface
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 |
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:
|
CTI TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp>om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>Voer de
getopdracht 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).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-POLY1305naar de CTI-interface gebruikt u:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305Raadpleeg 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:
Aanmelden bij Partnerhub .
Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om
CombinedCertChain2023.txtop 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.
Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txtOpenen
combinedcertchain2023.txtin een teksteditor.Selecteer en knip het eerste tekstblok, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----en plak het tekstblok in een nieuw bestand.Sla het nieuwe bestand op als
root2023.txt.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-----.
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txtMeld u aan bij de XSP|ADP en ga naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>(Optioneel) Uitvoeren
help updateTrustom de parameters en opdrachtindeling weer te geven.Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txtXSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Alle aliassen moeten een andere naam hebben.
webexclientroot2023enwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang alle ingangen uniek zijn.Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> getAlias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]Clients toestaan te verifiëren met certificaten:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
CTI-interface toevoegen en mTLS inschakelen
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
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> getVoer 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>
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 .
Mac-gebruikers: Klik op profielfoto en vervolgens op .
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.
Meld u aan bij cisco.com en zoek naar 'BWCallSettingsWeb' in het gedeelte software downloaden.
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.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).
Kopieer het .war-bestand naar een tijdelijke locatie op de XSP|ADP, zoals
/tmp/.Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.warDe BroadWorks-softwaremanager valideert en installeert het bestand.
[Optioneel] Verwijderen
/tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist).Activeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettingsDe 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.Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
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.
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.
Zorg ervoor dat u over de nieuwste configuratiesjablonen voor de Webex-app beschikt (zie Apparaatprofielen).
Het doel voor webgespreksinstellingen instellen op
csw:%WEB_CALL_SETTINGS_TARGET_WXT% cswStel 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.
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.
Zie de functiebeschrijving Pushserver voor VoIP in UCaaS voor meer informatie.
De BroadWorks-patches voor de functie zijn beschikbaar op: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Zie voor NPS-software en -patches het gedeelte Uw NPS voorbereiden op Webex voor Cisco BroadWorks.
Zoek en download de patch vanaf de downloadpagina van de software.
Meer informatie over de ADP-server vindt u op https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
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: XSP R22-patches: XSP R23-pleisters: | ||
| 3 | Activeer de toepassing Pushserver voor meldingen. | ||
| 4 | (Voor Android-meldingen) Schakel de FCM v1-API in op de NPS.
| ||
| 5 | (Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.
| ||
| 6 | Voeg een techsupport van de NPS XSP/ADP toe. | ||
| 7 | Op elke AS-server wordt het namedefs-bestand in 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
|
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:
Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u
| |||||||||||||||||||
| 3 | Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):
| |||||||||||||||||||
| 4 | (Voor Android-meldingen) Voeg de Android-toepassings-id toe aan de context van de FCM-toepassingen op de NPS.
| |||||||||||||||||||
| 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.
| |||||||||||||||||||
| 6 | Configureer de volgende NPS-URL's:
| |||||||||||||||||||
| 7 | Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:
| |||||||||||||||||||
| 8 | Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen: | |||||||||||||||||||
| 9 | Start de XSP|ADP opnieuw: | |||||||||||||||||||
| 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: wanneer u bestaande UCaaS-clients hebt en deze moet migreren om FCMv1 te gebruiken.
SaaS-clients migreren naar FCMv1: wanneer u bestaande SaaS-clients hebt en deze moet migreren om FCMv1 te gebruiken.
ADP-server bijwerken: wanneer u de NPS naar een ADP-server migreert.
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 . 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
|
Meld u aan bij FCM-beheerder SDK op http://console.firebase.google.com.
Selecteer de juiste Android-toepassing.
Noteer de project-ID op het tabblad Algemeen
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:
Klik op de blauwe knop om een nieuw serviceaccount aan te maken
Klik op de blauwe knop om een nieuwe privésleutel te genereren
Sleutel downloaden naar een veilige locatie
Een bestaand serviceaccount hergebruiken:
Klik op de blauwe tekst om bestaande serviceaccounts weer te geven.
Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.
Klik aan de rechterkant op het hamburgermenu en maak een nieuwe privésleutel aan.
Download het json-bestand dat de sleutel bevat en sla het op naar een veilige locatie.
Kopieer het json-bestand naar de XSP|ADP.
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 ********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_projectFCMv1 inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...DoneVoer het installatiebestand
bwrestartopdracht 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. |
FCM uitschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...DoneVoer het installatiebestand
bwrestartopdracht om de XSP|ADP opnieuw te starten.FCM inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...DoneVoer het installatiebestand
bwrestartopdracht 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.
Haal het JSON-bestand op van de Google Cloud-console:
Ga op de Google Cloud Console naar de pagina Service Accounts.
Klik op Selecteer een project, kies uw project en klik op Openen.
Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.
Selecteer een type Sleutel en klik op Aanmaken
Het bestand wordt gedownload.
FCM toevoegen aan de ADP-server:
Importeer het JSON-bestand naar de ADP-server met de
/bw/installopdracht.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:Voeg vervolgens de toepassing en de sleutel toe:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...DoneControleer 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:
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
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.
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.
(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.
Voeg uw URL's voor XSI-acties en XSI-gebeurtenissen toe.
Optioneel. Werk de DAS-URL bij met de URL van de apparaatactiveringsservice.
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.
Klik op Volgende.
Ga als volgt te werk op de pagina CTI-interface:
Voeg de CTI-URL en poort toe voor de CTI-interface waarmee u verbinding wilt maken.
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.
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.
Klik op Volgende.
Voeg de URL van uw verificatieservice toe.
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.
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.
Klik op Clusters weergeven en u moet uw nieuwe cluster zien en zien of de validatie is gelukt.
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
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
Klik op Clusters weergeven.
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.
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.
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
Klik op Sjabloon toevoegen.
Hiermee start u een wizard waarin u de configuratie kunt leveren voor klanten die deze sjabloon gebruiken.
Gebruik de vervolgkeuzelijst Cluster om het cluster te kiezen dat u met deze sjabloon wilt gebruiken.
Voer een sjabloonnaam in en klik op Volgende.
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.
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.
Optioneel. Schakel Gratis bellen via Cisco Webex uitschakelen in als u Webex-gesprekken wilt uitschakelen.
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.
Klik op Volgende.
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.
Klik op Volgende.
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).
Klik op Volgende.
Voor Voorkeuren configureert u het volgende:
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.
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.
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.
Zorg ervoor dat de schakelaar E-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties is ingeschakeld (de standaardinstelling is ingeschakeld).
Klik op Volgende.
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.
Klik op Sjablonen weergeven en u moet uw nieuwe sjabloon met andere sjablonen in de lijst zien.
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.
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)
Als u dit nog niet hebt gedaan, past u de volgende patch toe die van toepassing is op uw versie:.
Voor R22:
AP.as.22.0.1123.ap373197Voor R23:
AP.as.23.0.1075.ap373197Voor R24:
AP.as.24.0.944.ap384177
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.Wijzigen in de
Maintenance/ContainerOptionscontext.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.
Meld u aan bij Partner Hub en ga naar .
Klik op Sjablonen weergeven.
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.
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. |
Meld u aan bij de toepassingsserver en configureer de interface voor berichten.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURLAS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_nameAS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_passwordAS_CLI/Interface/Messaging> set enableSynchronization true
De geïntegreerde IMP-interface activeren:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
U moet de volledig gekwalificeerde naam invoeren voor de |
(Optie) Inrichtingsparameters per onderneming configureren op toepassingsserver
Open in de BroadWorks-gebruikersinterface de onderneming die u wilt configureren en ga naar Services > Geïntegreerde IM&P.
Selecteer Servicedomein gebruiken en voer een dummywaarde in (Webex negeert deze parameter. U kunt dit gebruiken
example.com).Selecteer Messaging Server gebruiken.
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
provisioningURLparameter, 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/hostsbestand op het AS.Voer in het veld Gebruikersnaam een naam in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.
Voer een wachtwoord in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.
Voor Standaard gebruikersidentiteit voor IM&P-id selecteert u Primair.
Klik op Toepassen.
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. |
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.
Open een serviceaanvraag met Cisco TAC. TAC moet een vertrouwensrelatie opbouwen tussen de externe identiteitsprovider en de Cisco Common Identity-service. .
Als uw IdP depassEmailInRequestin 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.Upload het CI-metagegevensbestand dat TAC aan uw identiteitsprovider heeft geleverd.
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.
Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.
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. |
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.
Configureer de omleidings-URI op de OpenID connect-id-provider.
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.
Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.
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-InfoSIP-koptekst:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork trueAS_CLI/Interface/SIP> set sendCallCorrelationIDAccess trueHet
enableCallCorrelationIDparameter 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 omenableCallCorrelationIDingeschakeld 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:
AP.as.22.0.1123.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
Voor R23:
AP.as.23.0.1075.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433Bij gebruik van XSP:
AP.xsp.23.0.1075.ap378585Bij gebruik van ADP:
Xsi-Events-23_2021.05_1.251.bwar
Voor R24:
AP.as.24.0.944.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
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:
Meld u aan bij Partnerhub op
admin.webex.com.Ga naar Instellingen en selecteer een bestaand cluster.
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.
Schakel het selectievakje Gespreksgeschiedenis inschakelen in.
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:
- Schakel Unified Call History in zoals beschreven in het vorige gedeelte.
- 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
- De functie moet geactiveerd worden via de AS CLI:
- AS_CLI/System/ActivatableFeature> 104112 activeren
- AS_CLI/System/StirShaken> enableVerification true instellen
- 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)
Aanmelden bij Partner Hub
Klik op Instellingen.
Klik op Cluster weergeven en selecteer het juiste BroadWorks-cluster.
Schakel de schakelaar Niet storen (NST) in.
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.
Als de validatie slaagt, klik dan op Save.
|
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
Gespreksopname
Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopname.
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. |
|
Altijd met onderbreken/hervatten | De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker kan een opname onderbreken en 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 |
|
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. |
|
Vereisten
Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:
Voor R22: AP.as.22.0.1123.ap377718
Voor R23: AP.as.23.0.1075.ap377718
Voor R24: AP.as.24.0.944.ap377718
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.
Haal de vereiste DTAF-bestanden op (zie Apparaatprofielen in het gedeelte Uw omgeving voorbereiden).
Controleer of u de juiste tagsets hebt in BroadWorks System > Resources > Device Management Tagsets.
Voor elke client die u inricht:
Download en pak het DTAF zip-bestand voor de specifieke client uit.
DTAF-bestanden importeren naar BroadWorks op System > Resources > Identity/Device Profile Types
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
Pas de sjablonen aan volgens uw omgeving (zie onderstaande tabel).
Sla het bestand op.
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
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 hun eigen merkaanpassingen toe te passen, kunnen klantbeheerders de procedures volgen bij Uw bedrijfsbranding toevoegen aan Webex.
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: |
| 2 | Klantorganisatie en gebruikers verifiëren in Control Hub: |
Gebruikerstests
| 1 | Download de Webex-app op twee verschillende machines. |
| 2 | Meld u aan als testgebruikers op de twee machines. |
| 3 | Voer testgesprekken. |
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:
Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.
Klik op Sjablonen weergeven.
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.
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.
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) |
|
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):
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
Gebruiker verplaatsen (met vertrouwd e-mailadres)
Als de onboardsjabloon vertrouwde e-mails gebruikt, kan de partnerbeheerder volgende gebruikers met dit proces verplaatsen:
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.
De gebruiker opent de e-mail en klikt op Account activeren. De gebruiker wordt omgeleid naar de Webex-consumentenportal.
Gebruiker meldt zich aan bij Webex.
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:
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.
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.
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.
Gebruiker meldt zich aan bij Webex.
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.
De gebruiker meldt zich aan bij de URL van de gebruikerstoegang met BroadWorks-aanmeldgegevens.
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.
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.
De gebruiker meldt zich aan bij de Consumentenportal.
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:
| ||
| 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.
|
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. |
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.
Verwijder alle Webex voor BroadWorks-werkplekken uit de organisatie. Gebruik de API Een BroadWorks-werkplek verwijderen.
Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de API Een BroadWorks-abonnee verwijderen.
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.
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:
|
| 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:
|
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 BroadWorks | Overeenkomstig kenmerk in Webex | Doel | Notities |
| BroadWorks-gebruikers-id | Geen | Primaire id | U 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-id | Gebruikers-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:
Wijzig de BroadWorks-gebruikers-id niet. Dit wordt niet ondersteund. |
| Alternatieve id | Geen | Hiermee schakelt u het authn van de gebruiker in, via e-mail en wachtwoord, met de BroadWorks-gebruikers-id | Moet 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:
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.
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:
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.
Zoek en selecteer de gebruiker in Control Hub.
- 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
| 1 | Gebruik de People API's om alle gebruikers uit de organisatie te verwijderen:
| ||
| 2 | Als adreslijstsynchronisatie is ingeschakeld, schakelt u deze uit. Dit kan via Partner Hub of via de openbare API. Adreslijstsynchronisatie uitschakelen via Partner Hub: 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 | ||
| 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:
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 | |||||||||
| 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:
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.
Meld u aan bij Partnerhub op admin.webex.com.
Kies Instellingen.
Klik op Sjabloon weergeven en kies de juiste onboardingsjabloon.
Klik op Cisco Webex Free Calling uitschakelen.
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:
Open CommPilot en ga naar de gebruikersconfiguratie.
Verwijder de geïntegreerde IM+P-service van de gebruiker en klik op OK.
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.
Gebruik de Een BroadWorks-abonnee-API verwijderen om de gebruiker te verwijderen.
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:
Aanwezigheid wordt niet ondersteund voor niet-CI Broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.
CI-gebruikers zonder Webex-cloudrechten of computertype accounts (werkplekken) geven alleen aanwezigheid 'in gesprek' en 'onbekend' weer. Er is geen status actief, overgaan, enz.
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.
Als u uw verbinding verliest, worden alle niet-Webex-gespreksstatussen bij het opnieuw verbinden teruggezet op 'onbekend'.
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.
Meld u aan bij BroadWorks CommPilot.
Ga voor een geselecteerde gebruiker naar Clienttoepassingen en configureer het Busy Lamp Field.
Voeg de URL van de BLF-lijst toe die wordt gecontroleerd.
Gebruik de zoekparameters om gebruikers te zoeken en toe te voegen aan de lijst Bewaakte gebruikers.
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:
ga naar het tabblad Algemeen van uw tabblad Instellingen in Windows of Voorkeuren op de Mac.
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).
Meld u aan bij Partnerhub ( https://admin.webex.com) en selecteer Klanten.
Selecteer de toepasselijke klantorganisatie.
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:
|
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 |
|
BroadWorks-factureringsrapporten weergeven | Wordt gebruikt om de rapporten weer te geven die beschikbaar zijn om te bekijken. | Leestoegang |
|
Een BroadWorks-factureringsrapport ophalen | Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen. | Leestoegang |
|
Een BroadWorks-factureringsrapport verwijderen | Wordt gebruikt om een gegenereerd rapport te verwijderen. | Schrijftoegang |
|
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.
|
|
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:
- Zorg ervoor dat u RSA-sleutels hebt gedeeld met alle XSP|ADP's.
- Zorg ervoor dat u op alle XSP|ADP's de AuthService-URL voor de webcontainer hebt opgegeven.
- 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.
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?
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
Meld u aan bij de Webex-app.
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.
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
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.
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)
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: 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 |
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.
|
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 | ||
Vereist voor adreslijstsynchronisatie | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereiste patch voor toepassingsserver | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereiste patch voor de functie Gespreksopname | ||
Vereiste patch voor doorstroominrichting | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Profielserver | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Platform | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
XSP|ADP | Vereist voor NPS-verificatieproxy | |
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereist voor NPS-verificatieproxy | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereist voor Unified Call History | ||
Overig | AP.xsa.22.0.1123.ap372757 | |
Versie R23
Server | Pleister | Aanvullende informatie |
|---|---|---|
Toepassingsserver | Vereist voor adreslijstsynchronisatie | |
App-server configureren | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor gespreksopname | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Profielserver | ||
Platform | ||
Vereist voor NPS-verificatieproxy | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
XSP|ADP | ||
Vereist voor NPS-verificatieproxy | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Overig | Bij gebruik van ADP... | Vereiste patch voor haakstatus (Presence) en Unified Call History |
Versie R24
Server | Pleister | Aanvullende informatie |
|---|---|---|
Toepassingsserver | Vereist voor Unified Messaging Server (UMS) | |
Vereist voor flowthrough-inrichting | ||
Vereist voor gespreksopname | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Overig | Vereiste patch voor haakstatus (Presence) en Unified Call History |
BroadWorks-tags vereist voor Webex
Raadpleeg de Webex voor Cisco BroadWorks-configuratiehandleiding voor informatie over de BroadWorks-systeemtags en aangepaste tags die u voor Webex moet configureren.
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
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.
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
De Webex-app lanceert een browser naar Cisco Common Identity (CI) zodat gebruikers hun e-mailadres kunnen invoeren.
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.)
De gebruiker voert zijn of haar BroadWorks-referenties in.
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).
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.
De Webex-app ontdekt de gespreksconfiguratie van BroadWorks en andere services van Webex.
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:
U downloadt en installeert de Webex-app.
Mogelijk hebt u de koppeling van uw serviceprovider ontvangen of kunt u de download vinden op de pagina Webex-downloads.
U voert uw e-mailadres in op het aanmeldscherm van Webex. Klik op Volgende.
U wordt meestal omgeleid naar een pagina met het merk Serviceprovider.
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.
Voer uw BroadWorks-wachtwoord in.
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
De client belt XSI om een apparaatbeheertoken en de URL naar het DMS op te halen.
De klant vraagt zijn apparaatprofiel aan bij DMS door het token van stap 1 voor te leggen.
De client leest het apparaatprofiel en haalt de SIP-referenties, adressen en poorten op.
Client verzendt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.
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:
Meld u aan bij Partner Hub en selecteer Klanten.
Selecteer de juiste klant.
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 WAVMS_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
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:
|
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:
-
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.)
-
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.)
-
Gebruik Partner Hub om Webex te verbinden met BroadWorks. (Zie Webex inzetten voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)
-
Gebruik Partner Hub om gebruikersvoorzieningen sjablonen voor te bereiden. (Zie Webex inzetten voor Cisco BroadWorks > Uw inwerksjablonen configureren in dit document.)
-
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.
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.
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.
|
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:
-
Categorie: Zendesk—Alleen premium
-
Categorie: Slack—Alleen premium
-
Microsoft Teams voor Webex-vergaderingen—Standaard of Premium
-
Microsoft Teams voor bellen—Ondersteund met alle pakketten
-
Kantoor 365Agenda (muziek)—Standaard of Premium
-
Google Agenda voor G Suite—Standaard of Premium
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
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
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:
-
Wanneer het installatieprogramma u vraagt,
Do you want to configure NTP?Voery. -
Wanneer het installatieprogramma u vraagt,
Is this server going to be a NTP server?Voern. -
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.

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.

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.

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.
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.
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.
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.
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:
-
Installeren Sjabloon: Navigatie Digimon22.0.1123.ap376508.
-
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevan het CLI inMaintenance/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:
-
Installeren Sjabloon: Navigatie Digimon23.0.1075.ap376509
-
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevan het CLI inMaintenance/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:
-
Installeren Sjabloon: Navigatie Digimon24.0.944.ap375100
-
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevan het CLI inMaintenance/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.
-
|
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
-
De clientversie die nodig is om deze functie te ondersteunen is 42.11 of hoger.
-
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
-
-
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:
-
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.
-
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.
-
-
|
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.
-
Breng uw eigen PSTN-oplossing voor Webex voor Cisco BroadWorks—Met deze oplossing kunnen serviceproviders telefoonnummers verstrekken die ze bezitten (in plaats van door Cisco verstrekte nummers) voor gebruikers die ze kunnen gebruiken wanneer ze deelnemen aan Webex-vergaderingen.
-
Webex voor Cisco BroadWorks configuratiegids—Beschrijft hoe u de Webex-app voor Webex voor Cisco BroadWorks configureert.
- Apparaatintegratiegids voor Webex voor Cisco BroadWorks—Beschrijft hoe u OS- en MPP-apparaten in de Ruimte aan boord en service kunt krijgen.
-
Webex voor Cisco BroadWorks Handleiding voor het oplossen van problemen—Bevat informatie over probleemoplossing voorWebex 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:
-
Webex voor Cisco BroadWorks Documentatie—Op de landingspagina staan technische documenten en optionele Webex-artikelen voor partnerbeheerders van Webex voor Cisco BroadWorks.
-
Wat is er nieuw met Webex voor Cisco BroadWorks—Lees over de nieuwste vrijgegeven functies samen met wat er binnenkort komt.
-
Bekende problemen en beperkingen—Lees over bekende problemen die we hebben geïdentificeerd in de Webex voor Cisco BroadWorks oplossing.
-
Partner Administrator Rollen voor Webex voor BroadWorks en Wholesale RTM—Dit artikel beschrijft hoe u partnerbeheerfuncties kunt toewijzen voor partnerorganisaties die Webex voor Cisco BroadWorks aanbieden. Rollen worden gebruikt om beheerstoegang toe te wijzen aan instellingen in Partner Hub en Control Hub.
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
-
Webex voor BroadWorks Developer Guide—Biedt informatie voor ontwikkelaars die applicaties maken die de Webex voor Cisco BroadWorks API's gebruiken.
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:
Webex-eisen: Het sjabloon Onboarding bevat de volgende instellingen:
|
|
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:
Webex-eisen: Het sjabloon Onboarding bevat de volgende instellingen:
|
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:
BroadWorks-vereisten:
Webex-vereisten:
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:
-
Installeren Sjabloon: Navigatie Digimon22.0.1123.ap376508.
-
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevan het CLI inMaintenance/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:
-
Installeren Sjabloon: Navigatie Digimon23.0.1075.ap376509
-
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevan het CLI inMaintenance/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:
-
Installeren Sjabloon: Navigatie Digimon24.0.944.ap375100
-
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevan het CLI inMaintenance/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.
|
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
-
BroadWorks-instantie(s) met minimale versie R22. Zie BroadWorks-softwarevereisten (in dit document) voor ondersteunde versies en patches. Voor meer informatie, zie BroadSoft producten lifecycle beleidsectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.
-
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
Om de Engelse versie van de Webex-app te downloaden, ga naar https://www.webex.com/webexfromserviceproviders-downloads.html. De Webex-app is beschikbaar op:
-
Windows-pc's/laptops
-
Apple pc's/laptops met MacOS
-
iOS (Apple Store)
-
Android (Play Store)
-
Webbrowsers (ga naar https://teams.webex.com/)
Gelokaliseerde versies
Om een gelokaliseerde versie van de Webex-app te downloaden, gebruikt u een van deze links:
-
https://www.webex.com/ko/webexfromserviceproviders-downloads.html(koreaans)
-
https://www.webex.com/fr/webexfromserviceproviders-downloads.html(Frans)
-
https://www.webex.com/pt/webexfromserviceproviders-downloads.html(Portugees)
-
https://www.webex.com/zh-tw/webexfromserviceproviders-downloads.html(Chinees traditioneel)
-
https://www.webex.com/zh-cn/webexfromserviceproviders-downloads.html(Vereenvoudigd Chinees)
-
https://www.webex.com/ja/webexfromserviceproviders-downloads.htmlPortaal: Japan
-
https://www.webex.com/es/webexfromserviceproviders-downloads.html(Spanje)
-
https://www.webex.com/de/webexfromserviceproviders-downloads.html(Duits)
-
https://www.webex.com/it/webexfromserviceproviders-downloads.html(Italiaans)
Fysieke telefoons en accessoires
-
Cisco IP-telefoons:
-
Cisco IP-telefoonserie 6800 met multiplatform-firmware
-
Cisco IP-telefoonserie 7800 met multiplatform-firmware
-
Cisco IP-telefoonserie 8800 met multiplatform-firmware
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.htmlvoor modellen en meer informatie.
-
-
We ondersteunen telefoons van derden op dezelfde manier als met andere BroadWorks-integraties. Zij hebben echter nog geen integratie met contactpersonen en aanwezigheid met Webex voor Cisco BroadWorks.
-
Adapters:
-
Cisco ATA 191 Multiplatform analoge telefoonadapter
-
Cisco ATA 192 Multiplatform analoge telefoonadapter
Zie https://www.cisco.com/c/en/us/products/unified-communications/ata-190-serie-analoog-telefoon-adapters/index.htmlvoor modellen en meer informatie.
-
-
Headsets:
-
Cisco Headset 500 Serie
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-serie/index.htmlvoor modellen en meer informatie.
-
-
OS-apparaten in de ruimte:
-
Webex kamer en kamer kit serie
-
Webex Desk-serie
-
Webex Board reeks
-
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: Configuratiebestand: |
|
Sjabloon van Webex-tablet |
Identiteits-/apparaatprofieltype: Verbinden - tablet DTAF: Configuratiebestand: |
|
Webex-sjabloon voor bureaublad |
Identiteits-/apparaatprofieltype: Business Communicator - PC DTAF: Configuratiebestand: |
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:
-
XSP|ADP AuthService Configuration' om de service op XSP|ADP te configureren.
-
'NPS-configuratie voor Auth-proxy-instelling' om NPS te configureren om authenticatieproxy te gebruiken.
-
CI-gebruiker UUID-synchronisatie' voor CI-gebruiker UUID-synchronisatie. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.
-
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:
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:
(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 AuthenticationDe 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.
|
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 |
|
Moet lezen | |
|
Moet lezen | |
|
Domeinen en URL's die toegankelijk moeten zijn voor Webex Services |
Moet lezen |
|
Optioneel | |
|
Optioneel | |
|
Optioneel | |
|
Optioneel | |
|
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.
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 |
|
|
Punten naar LB1 (Site A) |
|
A |
|
|
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.
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 |
|
|
Clientdetectie van de Xsi-interface |
|
SRV |
|
|
Clientdetectie van de Xsi-interface |
|
A |
|
|
Punten naar LB1 (site A) |
|
A |
|
|
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 |
|
|
Lastbalancer |
|
A |
LB.voorbeeld.com |
|
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 |
|
|
Punten naar LB1 (site A) |
|
A |
|
|
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:
-
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:
-
Klant voert een SRV-opzoeking uit voor _xsi-client._tcp.<xsi-domein>
-
Als de SRV-opzoeking een of meer A/AAAA-doelen oplevert:
-
De client doet een A/AAAA-zoekactie naar de teruggebrachte IP-adressen en caches van de klant.
-
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.
-
-
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.
-
-
(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>-
Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.
-
Als deze bestaan, wordt de client vergeleken met het oorspronkelijke XSI-adres dat het heeft ontvangen via de broadWorks-clusterconfiguratie.
-
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.
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.
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.
-
OAuth-referenties voor uw Webex voor Cisco BroadWorks verkrijgen.
-
Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw release:
-
Voor R22:
-
Voor R23:
-
Voor R24—geen pleister vereist
Elke verwijzing naar XSP omvat XSP of ADP.
-
-
Installeer de
AuthenticationServicetoepassing op elke XSP|ADP service.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/authServiceVoer dit commando uit om de AuthenticationService op de XSP|ADP te implementeren:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
-
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> getIndien niet aanwezig, voer dan het volgende commando uit om de standaard Java-trusts te importeren:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrustU 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.
-
-
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 deURL, voer de URL van de uitgiftenaam in die van toepassing is op uw CI-cluster. Zie volgende tabel. -
set issuerUrl <URL>—Voor deURL, 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/idbEU
https://idbroker-eu.webex.com/idbVS-B
https://idbroker-b-us.webex.com/idbCa
https://idbroker-ca.webex.com/idbCATEGORIE: SG
https://idbroker-sg.webex.com/idbINCH
https://idbroker-in.webex.com/idbCATEGORIE: AE
https://idbroker-ae.webex.com/idbAU
https://idbroker-au.webex.com/idbAls 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/authenticateAFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticateAORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticateCATEGORIE: ADXB
https://broadworks-idp-proxy-d.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticateCATEGORIE: 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".
-
-
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 -
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
-
-
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 -
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
-
-
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.
-
Selecteer één XSP|ADP om te gebruiken voor het genereren van een sleutelpaar.
-
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)
-
De locatie voor het opslaan van de sleutel kan niet worden geconfigureerd. Exporteert u de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeys -
Het geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP's, overschrijven van een oudere.keysbestand indien nodig. -
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:
-
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 -
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/authServiceHiermee kan Webex de verificatieservice gebruiken om de tokens die als aanmeldgegevens worden gepresenteerd, te valideren.
-
Controleer de parameter met
get. -
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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP-server TLS-interfaceconfiguratie lezen op de XSP|ADP
-
Meld u aan bij de XSP|ADP en navigeer naar
XSP|ADP_CLI/Interface/Http/HttpServer> -
Voer de
getgebruiken 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
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:
-
Meld u aan bij de XSP|ADP en navigeer naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols> -
Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al worden gebruikt in deze interface. -
Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
-
Meld u aan bij de XSP|ADP en navigeer naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers> -
Voer de opdracht in
get <interfaceIp> 443om 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). -
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-POLY1305naar de HTTP-serverinterface gebruikt u:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305Zie 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
De 'inmost to outmost' configuratieorder wordt hieronder vermeld. Het volgen van deze bestelling is niet verplicht.
-
Toepassingsserver configureren voor CTI-abonnementen
-
XSP|ADP's configureren voor mTLS Authenticated CTI-abonnementen
-
Inkomende poorten voor de beveiligde CTI-interface openen
-
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
-
Meld u aan bij de XSP|ADP en navigeer naar
XSP|ADP_CLI/Interface/CTI/CTIServer> Voer de
getgebruiken 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:
-
Meld u aan bij de XSP|ADP en navigeer naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols> -
Voer de opdracht in
get <interfaceIp>om te zien welke protocollen al worden gebruikt in deze interface. -
Voer de opdracht in
add <interfaceIp> TLSv1.2om 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:
-
Meld u aan bij de XSP|ADP en navigeer naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> -
Voer de
getopdracht 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). -
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-POLY1305naar de CTI-interface gebruikt u:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305Zie 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:
-
Meld u aan bij Partner Hub.
-
Ga naar Services > Additional links en klik op Download Webex CA Certificate om te krijgen
CombinedCertChain2023.txtop 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.
-
Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txt-
Openen
combinedcertchain2023.txtin een teksteditor. -
Selecteer en knip het eerste blok tekst, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----, en plak het tekstblok in een nieuw bestand. -
Sla het nieuwe bestand op als
root2023.txt. -
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-----.
-
-
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txt -
Meld u aan bij de XSP|ADP en navigeer naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> -
(Optioneel) Uitvoeren
help updateTrustom de parameters en opdrachtindeling te zien. -
Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txtXSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txtAlle aliassen moeten een andere naam hebben.
webexclientroot2023enwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen aliassen gebruiken zolang alle items uniek zijn. -
Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> getAlias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed] -
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
-
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
-
-
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> getVoer 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>
-
-
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 .
-
Mac-gebruikers: Klik op de profielfoto en vervolgens .
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.
-
Meld u aan bij cisco.com en zoek naar "BWCallSettingsWeb" in de sectie software downloaden.
-
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. -
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).
-
Kopieer het .war bestand naar een tijdelijke locatie op de XSP|ADP, zoals
/tmp/. -
Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.warDe BroadWorks-softwaremanager valideert en installeert het bestand.
-
[Optioneel] Verwijderen
/tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist). -
Activeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettingsDe 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. -
Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
-
-
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>
-
-
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.
-
Zorg ervoor dat je over de nieuwste configuratiesjablonen beschikt voor de Webex-app (zie Device Profiles).
-
Doel voor Webgespreksinstellingen instellen op
csw:%WEB_CALL_SETTINGS_TARGET_WXT% csw -
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.
-
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.
-
Voor meer informatie, zie de Push-server voor VoIP in UCaaS Functiebeschrijving.
-
De BroadWorks-patches voor de functie zijn beschikbaar op: https://software.cisco.com/download/home/286326302/type/286326345/vrijgave/RI.2022.04.
Voor NPS-software en patches, zie de sectie Prepare Your NPS for Webex for Cisco BroadWorks.
Zoek en download de patch van de software download pagina.
-
Meer informatie over de ADP server is te vinden op Cisco BroadWorks Application Delivery Platform.
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: XSP R22-pleisters: XSP R23-pleisters: |
| 3 |
Activeer de pushservertoepassing voor meldingen. |
| 4 |
(Voor Android-meldingen) Schakel de FCM v1 API in op de NPS.
|
| 5 |
(Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.
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:
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:
|
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:
Voer uit om te controleren of de waarden die u hebt ingevoerd, overeenkomen met wat u hebt gekregen
De CiscoCI issuerUrl moet ALTIJD een US CI-cluster zijn, ongeacht uw locatie en de standaard moet zijn:
| |||||||||||||||||||
| 3 |
Voer de NPS-proxy-URL in en stel het interval voor het vernieuwen van de token (30 minuten aanbevolen):
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:
US West:
Europa:
Saoedi-Arabië:
Australië:
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.
| |||||||||||||||||||
| 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.
| |||||||||||||||||||
| 6 |
Configureer de volgende NPS-URL's:
| |||||||||||||||||||
| 7 |
Configureer de volgende NPS-verbindingsparameters voor de aanbevolen waarden die worden weergegeven:
| |||||||||||||||||||
| 8 |
Controleer of de toepassingsserver een toepassings-id heeft, omdat u de Webex-apps mogelijk aan de lijst met toegestane toepassingen moet toevoegen: | |||||||||||||||||||
| 9 |
Herstart de XSP|ADP: | |||||||||||||||||||
| 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:
-
Migreer UC-One-clients naar FCMv1—Wanneer u bestaande UCaaS-clients hebt en ze moet migreren om FCMv te gebruiken1.
-
SaaS-clients naar FCMv migreren1—Wanneer u bestaande SaaS-clients hebt en ze moet migreren om FCMv te gebruiken1.
-
ADP-server bijwerken—Wanneer u de NPS migreert naar een ADP-server.
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 . 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>
-
Log in op FCM Admin SDK op http://console.firebase.google.com.
-
Selecteer de juiste Android-toepassing.
-
Op het tabblad General tabblad, registreer het project-ID
-
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:
-
Klik op de blauwe knop voor het maken van een nieuw serviceaccount
-
Klik op de blauwe knop om een nieuwe privésleutel te genereren
-
Sleutel downloaden naar een veilige locatie
Een bestaand serviceaccount opnieuw gebruiken:
-
Klik op de blauwe tekst om de bestaande serviceaccounts weer te krijgen.
-
Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.
-
Aan de rechterkant klikt u op het menu menu van het menu en maakt u een nieuwe privésleutel.
-
Download het JSON-bestand dat de sleutel bevat en sla het op een veilige locatie op.
-
-
Kopieer het json-bestand naar de XSP|ADP.
-
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 ******** -
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 -
FCMv inschakelen1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Voer het installatiebestand
bwrestartopdracht 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.
-
FCM uitschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done -
Voer het installatiebestand
bwrestartopdracht om de XSP|ADP opnieuw op te starten. -
FCM inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Voer het installatiebestand
bwrestartopdracht 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.
-
Haal het JSON-bestand op via de Google Cloud Console:
-
Ga op de Google Cloud Console naar de Service Accounts .
-
Klik op Select a project, kies uw project en klik op Open.
-
Zoek de rij van het service-account waarvoor u een sleutel wilt aanmaken, klik op de More verticale knop, klik dan op Create key.
-
Selecteer een Key typ en klik op Create
De bestandsdownloads.
-
-
FCM toevoegen aan de ADP-server:
-
Importeer het JSON-bestand naar de ADP-server met behulp van de
/bw/installOpdracht. -
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: -
Voeg daarna de toepassing en het sleutel toe:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done -
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:
-
Meld u aan bij Partner Hub op
admin.webex.com. -
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.
-
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.
-
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.
-
(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.
-
Voeg uw XSI Actions en XSI Events URL's.
-
Optioneel. Update de DAS URL met de URL van de Device Activation Service.
-
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.
-
-
Klik op Next.
-
Selecteer in het deelvenster CTI Interface pagina, doe het volgende:
-
Voeg de CTI URL en Port voor de CTI-interface waarmee je verbinding wilt maken.
-
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.
-
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.
-
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.
-
Klik op Next.
-
-
Voeg uw Authentication Service URL invoeren.
-
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.
-
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.
-
Klik op View Clusters en je moet je nieuwe cluster zien en zien of de validatie geslaagd is.
-
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
-
Meld u aan bij Partner Hub (admin.webex.com) met de aanmeldgegevens van uw partnerbeheerder.
-
Openen Services pagina van het zijmenu, en vind BroadWorks Calling kaart.
-
Klik op View Broadworks Calling.
-
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.
-
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.
-
Meld u aan bij de Partnerhuben selecteer Customers.
-
Klik op de Onboarding templates knop om de bestaande sjablonen te bekijken.
-
Klik op Create Template.
-
Op het tabblad Template Details venster, voeg de naam van het sjabloon, land of regio en standaard e-mailtaal toe.
-
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.
-
Op het tabblad Service Setting Gebruik het vervolgkeuzemenu Cluster om het cluster te kiezen dat u met dit sjabloon wilt gebruiken.
-
Voer een Template Name, klik dan op Next.
-
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.
-
-
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.
-
Optioneel. Controleren Disable Cisco Webex Free Calling als u Webex-oproepen wilt uitschakelen,.
-
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.
-
-
Klik op Next.
-
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.
-
-
Klik op Next.
-
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).
-
Klik op Next.
-
Voor Preferences, configureer het volgende:
-
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.
-
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.
-
Voer een Partner Admin.
Deze naam wordt gebruikt in de geautomatiseerde e-mailbericht Webex waarmee gebruikers worden uitgenodigd hun e-mailadres te valideren.
-
Zorg ervoor dat de knop E-mails voor admin-uitnodiging toestaan bij het koppelen aan bestaande organisaties Aan staat (de standaardinstelling is Aan).
-
Klik op Next.
-
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.
Klik op View Templates en je moet je nieuwe sjabloon zien opgelijst met andere sjablonen.
-
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.
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)
-
Als u dit nog niet hebt gedaan, breng dan de volgende pleister aan die van toepassing is op uw vrijlating:
-
Voor R22:
AP.as.22.0.1123.ap373197 -
Voor R23:
AP.as.23.0.1075.ap373197 -
Voor R24:
AP.as.24.0.944.ap384177
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.
-
-
Wijzigen in de
Maintenance/ContainerOptionsContext. -
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.
-
Meld je aan bij Partner Hub en ga naar .
-
Klik op View Templates.
-
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.
-
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.
-
Meld u aan bij de toepassingsserver en configureer de chatinterface.
-
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL -
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name -
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password -
AS_CLI/Interface/Messaging> set enableSynchronization true
-
-
Activeer de geïntegreerde IMP-interface:
-
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com -
/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
-
Open in BroadWorks UI de onderneming die u wilt configureren en ga naar Services > Integrated IM&P.
-
Selecteer Use service domain en voer een dummy waarde in (Webex negeert deze parameter. U kunt
example.com). -
Selecteer Gebruik Messaging Server.
-
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/hostsbestand op het AS. -
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.
-
Geef een wachtwoord op voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner hub.
-
Selecteer voor Default User Identity for IM&P ID Primary.
-
Klik op Toepassen.
-
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.
-
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.
-
Configureer de redirect-URI op de OpenID connect IDP.
-
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.
Zodra u de configuratie hebt voltooid, kunt u handmatig controleren of de Partner IdP Entity ID correct is ingesteld.
-
Betrek een klant die de template gebruikt en maak een nieuwe gebruiker aan in de klantorganisatie.
-
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
|
| 3 |
Upload het CI-metadata-bestand dat TAC heeft verstrekt naar uw IdP. |
| 4 |
Configureer een inwerksjabloon:
|
Zodra u de configuratie hebt voltooid, kunt u handmatig controleren of de Partner IdP Entity ID correct is ingesteld.
-
Betrek een klant die de template gebruikt en maak een nieuwe gebruiker aan in de klantorganisatie.
-
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 . |
| 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-InfoSIP-koptekst:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork trueAS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true -
Het bericht
enableCallCorrelationIDparameter geassocieerd met de Xsi-Actions-toepassing wordt gebruikt om de opname van call-correlatieinformatie in Xsi-Actions-logboeken te controleren. Het wordt aanbevolen omenableCallCorrelationIDingeschakeld 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:
-
AP.as.22.0.1123.ap378585—na installatie van de patch moet u de functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
Voor R23:
-
AP.as.23.0.1075.ap378585—na installatie van de patch moet u de functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433 -
Als u XSP gebruikt:
AP.xsp.23.0.1075.ap378585 -
Bij gebruik van ADP:
Xsi-Events-23_2021.05_1.251.bwar
Voor R24:
-
AP.as.24.0.944.ap378585—na installatie van de patch moet u de functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
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:
-
Meld u aan bij Partner Hub op
admin.webex.com. -
Ga naar Services.
-
Klik op View Broadworks Calling en selecteer de juiste BroadWorks cluster.
-
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.
-
Controleer de Enable call history in.
-
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:
- Schakel Unified Call History in zoals beschreven in de vorige sectie.
- 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
- De functie moet worden geactiveerd via de AS CLI:
- AS_CLI/Systeem/ActivatableFeature> activeren 104112
- AS_CLI/System/StirShaken> enableVerification true instellen
- 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.
Persoonlijke assistent-statussynchronisatie inschakelen (bestaand instrumentenbord)
-
Meld u aan bij Partner Hub met uw partner admin credentials op https://admin.webex.com.
-
Klik op Services.
-
Klik op View Broadworks Calling en selecteer de juiste BroadWorks cluster.
- Voer uw naam en e-mailadres in onder CTI Interface Schakel de knop Personal Assistant Status Sync in.
-
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.
-
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.

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:
-
Feature Access Codes (FAC): Specifieke codes voor elk van de drie opties van de beller-ID.
-
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.
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.
-
BWKS-5230 was de oorspronkelijke door de gebruiker te selecteren CLID-functie - het laat gebruikers (als het systeem correct is geconfigureerd) veranderen welk CLID-beleid van toepassing is. Zie FD hier: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/UserSelectionOfExternalCallingLineIDOptionFD-R250PDF-bestand
-
BWKS-9510 is een door het Webex-klantenteam gevraagde XSI-upgrade om het gemakkelijker te maken te ontdekken welke opties er voor een gebruiker beschikbaar zijn. Dit is nodig omdat de keuze van het CLID-beleid geen eenvoudige functie op gebruikersniveau is (zoals CFA) die direct controleerbaar is. Het hangt eerder af van verschillende systeemconfiguratie opties en de hiërarchie van "call processing policies". U kunt hier de details bekijken: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/XSIEnhancementToSupportUserSelectableCLIDFD-R250PDF-bestand
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)
-
Aanmelden bij Partner Hub
-
Klik op Services.
-
Klik op View Broadworks Calling en selecteer de juiste BroadWorks cluster.
-
Schakel de Do not disturb (DND) sync omschakelen.
-
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.
-
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
Gespreksopname
Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopnamen.
|
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. |
|
|
Altijd met onderbreken/hervatten |
Opname wordt automatisch gestart zodra de oproep tot stand is gekomen. De gebruiker kan de opname pauzeren en hervatten. |
|
|
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 |
|
|
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. |
|
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.
-
Voor R22: AP.as.22.0.1123.ap377718
-
Voor R23: AP.as.23.0.1075.ap377718
-
Voor R24: AP.as.24.0.944.ap377718
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 geven
x-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.
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. Met deze configuratie kan AS SIP URI-oproepen verwerken en INVITEs genereren na REFER. |
| 2 |
Netwerkserver (NS) configureren. |
| 3 |
Valideer de routetest: U kunt één van de volgende resultaten verwachten:
|
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:
-
Vastleggen ALS XS-logboeken.
-
Vastleggen van NS routing logs.
-
Controleer de internetverbinding van SBC.
-
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 . | ||||||||||
| 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
| ||||||||||
| 4 |
Configureer apparaatprofielen voor elke klant die u levert. | ||||||||||
| 5 |
Klik op Files and Authentication en selecteer vervolgens de optie om alle systeembestanden opnieuw te bouwen.
|
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: |
| 2 |
Klantorganisatie en gebruikers verifiëren in Control Hub: |
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. |
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:
-
Meld u aan bij Partner Hub en zoek de Customer List .
-
Klik op View Templates.
-
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.
-
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.
-
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):
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:
-
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.
-
-
Gebruiker opent de e-mail en klikt op Activate Account. De gebruiker wordt omgeleid naar de Webex-consumentenportal.
-
Gebruiker meldt zich aan bij Webex.
-
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:
-
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.
-
-
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.
-
-
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.
-
-
Gebruiker meldt zich aan bij Webex.
-
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.
-
De gebruiker meldt zich aan bij de URL van de gebruikerstoegangsportal met BroadWorks-aanmeldgegevens.
-
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.
-
-
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.
-
-
De gebruiker meldt zich aan bij de consumentenportal.
-
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:
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.
-
Als u geen toegang hebt tot de klantinstellingen in Control Hub, laat de klantbeheerder u dan externe beheerderstoegang verlenen door: Aanvraag externe beheerder goedkeuren.
-
Verwijder alle Webex voor BroadWorks-werkruimten uit de organisatie. Gebruik de Verwijder een BroadWorks-werkruimteAPI.
-
Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de Verwijder een BroadWorks-abonneeAPI.
-
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.
-
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:
|
| 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:
|
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:
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:
-
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.
-
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:
-
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.
-
Zoek de gebruiker in Control Hub en selecteer deze.
- 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
| 1 |
Gebruik de Personen-API's om alle gebruikers uit de organisatie 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: 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:
-
De Partner Admin kan navigeren naar de pagina "Hybride" Services op de Control Hub van de Klant.
-
Zoek de "BroadWorks Calling"-kaart.
-
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:
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:
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.
-
Meld u aan bij Partner Hub op admin.webex.com.
-
Kiezen Settings.
-
Klik op View Template en kies de gepaste Onboarding template.
-
Klik op Disable Cisco Webex Free Calling.
-
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:
-
Open CommPilot en ga naar de gebruikersconfiguratie.
-
Verwijder de Integrated IM+P service van de gebruiker en klik op OK.
-
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.
-
Gebruik de Verwijder een BroadWorks Subscriber APIom de gebruiker te verwijderen.
-
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:
-
Aanwezigheid wordt niet ondersteund voor niet-CI-broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.
-
CI-gebruikers zonder Webex-cloudrecht of machinetype van accounts (workspaces) tonen enkel ‘in-call’ en ‘onbekende’ aanwezigheid. Er is geen actieve status, rinkelen, etc.
-
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.
-
Het verliezen van uw verbinding betekent dat alle niet-Webex-in-call staten zullen worden teruggezet op ‘onbekend’ bij het opnieuw verbinden.
-
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.
-
Meld je aan bij BroadWorks CommPilot.
-
Ga voor een geselecteerde gebruiker naar Client Applications en configureer het veld Bezet Lamp.
-
Voeg de URL toe van de BLF-lijst die opgevolgd zal worden.
-
Gebruik de zoekparameters om gebruikers te vinden en toe te voegen aan de Monitored Users .
-
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).
-
Meld u aan bij Partner Hub ( https://admin.webex.com) en selecteer Customers.
-
Selecteer de toepasselijke klantorganisatie.
-
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
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 |
|
|
Lijst facturatierapporten van BroadWorks |
Gebruikt om een lijst te maken van de rapporten die beschikbaar zijn om te bekijken. |
Leestoegang |
|
|
Krijg een BroadWorks Billing Report |
Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen. |
Leestoegang |
|
|
Een BroadWorks Billing Report verwijderen |
Wordt gebruikt om een gegenereerd rapport te verwijderen. |
Schrijftoegang |
|
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.
|
-
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.0aan 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.0aan 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:
-
Zorg ervoor dat je RSA-sleutels gedeeld hebt over alle XSP|ADP's.
-
Zorg ervoor dat u AuthService URL aan de webcontainer op alle XSP|ADP's hebt verstrekt.
-
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.
-
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?
-
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
-
Meld je aan bij de Webex-app.
-
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.
-
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
-
Ondersteuning voor de versie van de BroadWorks-server volgt het beleid van BroadSoft, 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.
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)
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: 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 | ||
|
Vereist voor Directory Sync | ||
|
Vereist om te upgraden van V1 naar V2 Push Notifications | ||
|
Vereiste patch voor applicatieserver | ||
|
Vereist om te upgraden van V1 naar V2 Push Notifications | ||
|
Vereiste patch voor functie Call Recording | ||
|
Vereiste pleister voor doorstroomvoorziening | ||
|
Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis | ||
|
Profielserver | ||
|
Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis | ||
|
Platform | ||
|
Vereist voor NPS-authenticatieproxy | ||
|
Vereist voor NPS-authenticatieproxy | ||
|
Vereist voor de Auth-service met CI-token validatie | ||
|
Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis | ||
|
GEBRUIKER: XSP|ADP |
Vereist voor NPS-authenticatieproxy | |
|
Vereist voor de Auth-service met CI-token validatie | ||
|
Vereist voor NPS-authenticatieproxy | ||
|
Vereist om te upgraden van V1 naar V2 Push Notifications | ||
|
Vereist voor NPS-authenticatieproxy | ||
|
Vereist voor NPS-authenticatieproxy | ||
|
Vereist voor de Auth-service met CI-token validatie | ||
|
Vereist voor Unified Call History | ||
|
Overig |
AP.xsa.22.0.1123.ap372757 | |
Versie R23
|
Server |
Pleister |
Aanvullende informatie |
|---|---|---|
|
Toepassingsserver |
Vereist voor Directory Sync | |
|
Configuratie-app-server | ||
|
Vereist om te upgraden van V1 naar V2 Push Notifications | ||
|
Vereist voor oproepregistratie | ||
|
Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis | ||
|
Profielserver | ||
|
Platform | ||
|
Vereist voor NPS-authenticatieproxy | ||
|
Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis | ||
|
GEBRUIKER: XSP|ADP | ||
|
Vereist voor NPS-authenticatieproxy | ||
|
Vereist om te upgraden van V1 naar V2 Push Notifications | ||
|
Vereist voor NPS-authenticatieproxy | ||
|
Vereist voor NPS-authenticatieproxy | ||
|
Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis | ||
|
Overig |
Als u ADP gebruikt... |
Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis |
Versie R24
|
Server |
Pleister |
Aanvullende informatie |
|---|---|---|
|
Toepassingsserver |
Vereist voor Unified Messaging Server (UMS) | |
|
Vereist voor doorstroomvoorziening | ||
|
Vereist voor oproepregistratie | ||
|
Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis | ||
|
Overig |
Vereiste patch voor haakstatus (aanwezigheid) en uniforme oproepgeschiedenis |
BroadWorks-tags vereist voor Webex
Voor informatie over de BroadWorks systeemtags en aangepaste tags die u voor Webex moet configureren, verwijzen we naar de Webex voor Cisco BroadWorks configuratiegids.
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)
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
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.
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.
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
-
De Webex-app start een browser op via Cisco Common Identity (CI) om gebruikers toe te staan hun e-mailadres in te voeren.
-
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.)
-
De gebruiker voert zijn of haar BroadWorks-aanmeldgegevens in.
-
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).
-
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).
-
De Webex-app detecteert de belconfiguratie via BroadWorks en andere services van Webex.
-
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:
-
U downloadt en installeert de Webex-app.
-
Mogelijk hebt u de koppeling ontvangen van uw serviceprovider of vindt u de download op de Webex-downloadpagina.
-
U voert uw e-mailadres in op het aanmeldingsscherm van Webex. Klik op Next.
-
Gewoonlijk wordt u omgeleid naar een serviceprovider-merkpagina.
-
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.
-
Voer uw BroadWorks-wachtwoord in.
-
Als u zich met succes hebt aangemeld, wordt Webex geopend.
gespreksverloop- Bedrijfslijst
gespreksverloop: PSTN nummer
Presentatie en delen
Een vergadering in een ruimte starten
Interacties met klanten
Profiel ophalen uit DMS en SIP Register met AS
-
Client belt XSI om een token voor apparaatbeheer en de URL naar de DMS te krijgen.
-
De klant vraagt zijn apparaatprofiel aan in DMS door het token van stap 1 te presenteren.
-
De client leest het apparaatprofiel en haalt de SIP-aanmeldgegevens, -adressen en -poorten op.
-
Klant stuurt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.
-
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.
Een organisatie aan ontwerpen als een testorganisatie
Een organisatie aanwijzen als testorganisatie:
-
Meld je aan bij Partner Hub en selecteer Customers.
-
Selecteer de juiste klant.
-
Schakel in de rechter bedieningsbalk de Internal Test Organization omschakelen.
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
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:
-
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). -
Implementeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects>deploy application /authService
Duur van token configureren
-
Controleer de bestaande tokenconfiguratie (uren):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>get -
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.
-
Selecteer één XSP|ADP om te gebruiken voor het genereren van een sleutelpaar.
-
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)
-
De locatie van de sleutelwinkel is niet configureerbaar. Exporteert u de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeys -
Het geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP's, overschrijven van een oudere.keysbestand indien nodig. -
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:
-
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 -
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/authServiceHiermee kan Webex de verificatieservice gebruiken om de tokens die als aanmeldgegevens worden gepresenteerd, te valideren.
-
Controleer de parameter met
get. -
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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP-server TLS-interfaceconfiguratie lezen op de XSP|ADP
-
Meld u aan bij de XSP|ADP en navigeer naar
XSP|ADP_CLI/Interface/Http/HttpServer> -
Voer de
getgebruiken 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
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:
-
Meld u aan bij de XSP|ADP en navigeer naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols> -
Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al worden gebruikt in deze interface. -
Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
-
Meld u aan bij de XSP|ADP en navigeer naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers> -
Voer de opdracht in
get <interfaceIp> 443om 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). -
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-POLY1305naar de HTTP-serverinterface gebruikt u:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305Zie https://ciphersuite.info/om de suite met beide namen te vinden.
Vertrouwen voor verificatieservice configureren (met mTLS)
-
Meld u aan bij Control Hub met uw partnerbeheerdersaccount.
-
Ga naar en klik op Download Webex CA Certificate om te krijgen
CombinedCertChain2023.txtop 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. -
Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txt.-
Openen
combinedcertchain2023.txtin een teksteditor. -
Selecteer en knip het eerste blok tekst, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----, en plak het tekstblok in een nieuw bestand. -
Sla het nieuwe bestand op als
root2023.txt. -
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-----.
-
-
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijvoorbeeld,
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txt. -
Meld u aan bij de XSP|ADP en navigeer naar
/XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoerenUpdateTrustom de parameters en opdrachtindeling te zien. -
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.txtAlle aliassen moeten een andere naam hebben.
webexclientroot,webexclientroot2023,webexclientissuingenwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen aliassen gebruiken zolang alle vier ingangen uniek zijn. -
Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> getAlias 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.
-
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
-
Navigeren naar
XSP|ADP_CLI/Interface/Http/HttpServer>en voer degetgebruiken om de interfaces te bekijken. -
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 trueZie de XSP|ADP CLI documentatie voor meer informatie. In principe de eerste
truebeveiligt de interface met TLS (servercertificaat wordt gemaakt indien vereist) en de tweedetruedwingt 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.
-
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
-
Navigeren naar
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>en voer degetgebruiken om te zien welke toepassingen worden uitgevoerd. -
Een toepassing toevoegen en de clientverificatie vereisen (wat hetzelfde betekent als mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName trueZie de XSP|ADP CLI documentatie voor meer informatie. De toepassingsnamen worden daar geemigreerd. Het bericht
truein 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:
- Meld u aan bij Partner Hub op
admin.webex.com. -
Ga naar Services > Additional links.
-
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.
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 AuthenticationHoud 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. | |
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:
| 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.
| 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:
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.)
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.)
Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)
Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)
Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)
|
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.
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:
Zendesk—Alleen premium
Slack—Alleen premium
Microsoft Teams voor Webex Meetings—Standaard of Premium
Microsoft Teams for Calling: ondersteund met alle pakketten
Office 365-agenda—Standaard of Premium
Google-agenda voor G Suite—Standaard of Premium
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
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:
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:
Wanneer het installatieprogramma hierom vraagt,
Do you want to configure NTP?, voer iny.Wanneer het installatieprogramma hierom vraagt,
Is this server going to be a NTP server?, voer inn.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_SHA384TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_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_SHA384TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256TLS_DHE_RSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384TLS_DHE_RSA_WITH_AES_256_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256TLS_DHE_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHATLS_ECDHE_RSA_WITH_AES_256_CBC_SHATLS_DHE_RSA_WITH_AES_256_CBC_SHATLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHATLS_ECDHE_RSA_WITH_AES_128_CBC_SHATLS_DHE_RSA_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_256_GCM_SHA384TLS_DHE_PSK_WITH_AES_256_GCM_SHA384TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_PSK_WITH_AES_128_GCM_SHA256TLS_DHE_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_128_GCM_SHA256TLS_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_256_CBC_SHA256TLS_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384TLS_ECDHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_PSK_WITH_AES_256_CBC_SHA384TLS_DHE_PSK_WITH_AES_256_CBC_SHA384TLS_RSA_PSK_WITH_AES_256_CBC_SHATLS_DHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHATLS_PSK_WITH_AES_256_CBC_SHA384TLS_PSK_WITH_AES_256_CBC_SHATLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_128_CBC_SHA256TLS_DHE_PSK_WITH_AES_128_CBC_SHA256TLS_RSA_PSK_WITH_AES_128_CBC_SHATLS_DHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_WITH_AES_128_CBC_SHATLS_PSK_WITH_AES_128_CBC_SHA256TLS_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 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.
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.
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.
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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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
De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.
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
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:
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.
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.
|
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.
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.
Bring Your Own PSTN-oplossing voor Webex voor Cisco BroadWorks: met deze oplossing kunnen serviceproviders telefoonnummers inrichten die ze bezitten (in plaats van door Cisco geleverde nummers) voor gebruikers om te gebruiken wanneer ze deelnemen aan Webex Meetings.
Webex voor Cisco BroadWorks-configuratiehandleiding: beschrijft hoe u de Webex-app voor Webex voor Cisco BroadWorks configureert.
- Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks: beschrijft hoe u het besturingssysteem en de MPP-apparaten van de serviceruimte kunt onboarden en gebruiken.
Handleiding voor probleemoplossing van Webex voor Cisco BroadWorks: bevat informatie voor het oplossen van problemen met Webex voor Cisco BroadWorks.
Webex voor Cisco BroadWorks-artikelen
Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:
Documentatie van Webex voor Cisco BroadWorks: de landingspagina bevat technische documenten en optionele Webex-artikelen die zijn bedoeld voor partnerbeheerders van Webex voor Cisco BroadWorks.
Nieuw in Webex voor Cisco BroadWorks: lees meer over de nieuwste functies en wat er binnenkort beschikbaar is.
Bekende problemen en beperkingen: lees meer over bekende problemen die we hebben geïdentificeerd in de Webex for Cisco BroadWorks-oplossing.
Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM: in dit artikel wordt beschreven hoe u partnerbeheerdersrollen toewijst voor partnerorganisaties die Webex voor Cisco BroadWorks aanbieden. Rollen worden gebruikt om beheerderstoegang toe te wijzen aan instellingen in Partnerhub en Control Hub.
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
Webex voor BroadWorks-ontwikkelaarshandleiding: bevat informatie voor ontwikkelaars die toepassingen maken die de Webex voor BroadWorks-API's gebruiken.
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:
Webex-vereisten: Het onboardsjabloon bevat de volgende instellingen:
|
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:
Webex-vereisten: Het onboardsjabloon bevat de volgende instellingen:
|
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:
Vereisten voor BroadWorks:
Webex-vereisten:
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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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.
|
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. |
| Verificatiemodus | BroadWorks | Webex |
| Primaire gebruikersidentiteit | BroadWorks-gebruikers-id | E-mailadres |
| Identiteitsprovider | BroadWorks.
| Cisco Common Identity |
| Meervoudige verificatie? | Nee | Vereist Customer IdP die meervoudige verificatie ondersteunt. |
Validatiepad gebruikergegevens
|
|
|
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-8ADP_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.
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
BroadWorks-exemplaar(en) met minimale versie R22. Zie de BroadWorks-softwarevereisten (in dit document) voor ondersteunde versies en patches. Voor meer informatie, zie Beleid voor de levenscyclus van BroadSoft-producten sectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.
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
Als u de Engelse versie van de Webex-app wilt downloaden, gaat u naar https://www.webex.com/webexfromserviceproviders-downloads.html. De Webex-app is beschikbaar op:
Windows-pc's/laptops
Apple-pc's/laptops met MacOS
iOS (Apple Store)
Android (Play store)
Webbrowsers (ga naar https://teams.webex.com/)
Gelokaliseerde versies
Gebruik een van de volgende koppelingen om een gelokaliseerde versie van de Webex-app te downloaden:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (Koreaans)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (Frans)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (Portugees)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (Traditioneel Chinees)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (vereenvoudigd Chinees)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Japan)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spanje)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (Duits)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italiaans)
Fysieke telefoons en accessoires
Cisco IP-telefoons:
Cisco IP-telefoon 6800-serie met Firmware voor meerdere platforms voor meerdere platforms
Cisco IP-telefoon 7800-serie met Firmware voor meerdere platforms voor meerdere platforms
Cisco IP-telefoon 8800-serie met Firmware voor meerdere platforms voor meerdere platforms
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html voor modellen en meer informatie.
We ondersteunen telefoons van derden op dezelfde manier als met andere BroadWorks-integraties. Ze hebben echter nog geen contacten en aanwezigheidsintegratie met Webex voor Cisco BroadWorks.
Adapters:
Analoge telefoonoplader voor meerdere platforms voor Cisco ATA 191
Analoge telefoonoplader voor meerdere platforms voor Cisco ATA 192
Zie https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html voor modellen en meer informatie.
Hoofdtelefoons:
Cisco-hoofdtelefoon 500-serie
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html voor modellen en meer informatie.
Apparaten met Room OS:
Webex Room- en Room Kit-serie
Webex Desk-serie
Webex Board-serie
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: Configuratiebestand: |
Sjabloon voor Webex-tablet |
Type identiteit/apparaatprofiel: Verbinding maken - tablet DTAF: Configuratiebestand: |
Webex Desktop-sjabloon |
Type identiteit/apparaatprofiel: Bedrijfscommunicator - PC DTAF: Configuratiebestand: |
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:
XSP|ADP AuthService Configuration' voor het configureren van de service op XSP|ADP.
'NPS-configuratie voor verificatie proxy instellen' om NPS te configureren voor het gebruik van de verificatieproxy.
CI-gebruikers-UUID synchroniseren' voor CI-gebruikers-UUID synchroniseren. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.
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 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:
(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 AuthenticationDe 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.
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 |
Moet gelezen worden | |
Moet gelezen worden | |
Domeinen en URL's die toegankelijk moeten zijn voor Webex-services | Moet gelezen worden |
Optioneel | |
Optioneel | |
Optioneel | |
Optioneel | |
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 |
|
| Verwijst naar LB1 (Site A) |
A |
|
| 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 |
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 |
|
| Clientdetectie van Xsi-interface |
SRV |
|
| Clientdetectie van Xsi-interface |
A |
|
| Verwijst naar LB1 (site A) |
A |
|
| 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 |
|
| Lastbalancer |
A | LB.voorbeeld.com |
| 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 |
|
| Verwijst naar LB1 (site A) |
A |
|
| 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:
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:
De client voert een SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">
Als de SRV-zoekopdracht een of meer A/AAAA-doelen retourneert:
De client zoekt A/AAAA op voor deze doelen en slaat de geretourneerde IP-adressen in de cache.
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).
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.
(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>Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.
Als deze bestaan, vergelijkt de client met het oorspronkelijke XSI-adres dat hij heeft ontvangen via de BroadWorks-clusterconfiguratie.
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.
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.
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. |
Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.
Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw versie:
Voor R22:
Voor R23:
Voor R24: geen patch vereist
Elke verwijzing naar XSP omvat XSP of ADP.Installeer de
AuthenticationServicetoepassing op elke XSP|ADP-service.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/authServiceVoer deze opdracht uit om de AuthenticationService te implementeren op de XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
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> getAls dit niet aanwezig is, voert u de volgende opdracht uit om de standaard Java-trusts te importeren:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrustU 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.
Configureer de identiteitsproviders door de volgende opdrachten uit te voeren op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> getset clientId client-Id-From-Step1set enabled trueset clientSecret client-Secret-From-Step1set ciResponseBodyMaxSizeInBytes 65536set issuerName <URL>—Voor deURLvoer de URL van de IssuerName in die van toepassing is op uw CI-cluster. Zie volgende tabel.set issuerUrl <URL>—Voor deURLvoer 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
EU
US-B
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".
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:userConfigureer identiteitsproviders voor Cisco Federation met de volgende opdrachten op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> getset flsUrl https://cifls.webex.com/federationset refreshPeriodInMinutes 60set refreshToken refresh-Token-From-Step1
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> GetConfigureer Tokenbeheer met de volgende opdrachten op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>set tokenIssuer BroadWorksset tokenDurationInHours 720
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.Selecteer één XSP|ADP om een sleutelpaar te genereren.
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)
De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeysHet geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere.keysbestand indien nodig.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 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:
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/authServiceVoeg de URL van de verificatieservice toe aan de container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authServiceHiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.
Controleer de parameter met
get.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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>Voer de opdracht in
get <interfaceIp> 443om 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).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-POLY1305in 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_POLY1305Raadpleeg 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.
Toepassingsserver configureren voor CTI-abonnementen
XSP|ADP's configureren voor mTLS geverifieerde CTI-abonnementen
Inkomende poorten openen voor veilige CTI-interface
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 |
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:
|
CTI TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp>om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>Voer de
getopdracht 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).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-POLY1305naar de CTI-interface gebruikt u:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305Raadpleeg 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:
Aanmelden bij Partnerhub .
Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om
CombinedCertChain2023.txtop 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.
Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txtOpenen
combinedcertchain2023.txtin een teksteditor.Selecteer en knip het eerste tekstblok, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----en plak het tekstblok in een nieuw bestand.Sla het nieuwe bestand op als
root2023.txt.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-----.
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txtMeld u aan bij de XSP|ADP en ga naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>(Optioneel) Uitvoeren
help updateTrustom de parameters en opdrachtindeling weer te geven.Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txtXSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Alle aliassen moeten een andere naam hebben.
webexclientroot2023enwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang alle ingangen uniek zijn.Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> getAlias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]Clients toestaan te verifiëren met certificaten:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
CTI-interface toevoegen en mTLS inschakelen
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
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> getVoer 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>
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 .
Mac-gebruikers: Klik op profielfoto en vervolgens op .
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.
Meld u aan bij cisco.com en zoek naar 'BWCallSettingsWeb' in het gedeelte software downloaden.
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.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).
Kopieer het .war-bestand naar een tijdelijke locatie op de XSP|ADP, zoals
/tmp/.Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.warDe BroadWorks-softwaremanager valideert en installeert het bestand.
[Optioneel] Verwijderen
/tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist).Activeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettingsDe 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.Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
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.
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.
Zorg ervoor dat u over de nieuwste configuratiesjablonen voor de Webex-app beschikt (zie Apparaatprofielen).
Het doel voor webgespreksinstellingen instellen op
csw:%WEB_CALL_SETTINGS_TARGET_WXT% cswStel 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.
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.
Zie de functiebeschrijving Pushserver voor VoIP in UCaaS voor meer informatie.
De BroadWorks-patches voor de functie zijn beschikbaar op: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Zie voor NPS-software en -patches het gedeelte Uw NPS voorbereiden op Webex voor Cisco BroadWorks.
Zoek en download de patch vanaf de downloadpagina van de software.
Meer informatie over de ADP-server vindt u op https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
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: XSP R22-patches: XSP R23-pleisters: | ||
| 3 | Activeer de toepassing Pushserver voor meldingen. | ||
| 4 | (Voor Android-meldingen) Schakel de FCM v1-API in op de NPS.
| ||
| 5 | (Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.
| ||
| 6 | Voeg een techsupport van de NPS XSP/ADP toe. | ||
| 7 | Op elke AS-server wordt het namedefs-bestand in 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
|
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:
Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u
| |||||||||||||||||||
| 3 | Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):
| |||||||||||||||||||
| 4 | (Voor Android-meldingen) Voeg de Android-toepassings-id toe aan de context van de FCM-toepassingen op de NPS.
| |||||||||||||||||||
| 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.
| |||||||||||||||||||
| 6 | Configureer de volgende NPS-URL's:
| |||||||||||||||||||
| 7 | Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:
| |||||||||||||||||||
| 8 | Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen: | |||||||||||||||||||
| 9 | Start de XSP|ADP opnieuw: | |||||||||||||||||||
| 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: wanneer u bestaande UCaaS-clients hebt en deze moet migreren om FCMv1 te gebruiken.
SaaS-clients migreren naar FCMv1: wanneer u bestaande SaaS-clients hebt en deze moet migreren om FCMv1 te gebruiken.
ADP-server bijwerken: wanneer u de NPS naar een ADP-server migreert.
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 . 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
|
Meld u aan bij FCM-beheerder SDK op http://console.firebase.google.com.
Selecteer de juiste Android-toepassing.
Noteer de project-ID op het tabblad Algemeen
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:
Klik op de blauwe knop om een nieuw serviceaccount aan te maken
Klik op de blauwe knop om een nieuwe privésleutel te genereren
Sleutel downloaden naar een veilige locatie
Een bestaand serviceaccount hergebruiken:
Klik op de blauwe tekst om bestaande serviceaccounts weer te geven.
Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.
Klik aan de rechterkant op het hamburgermenu en maak een nieuwe privésleutel aan.
Download het json-bestand dat de sleutel bevat en sla het op naar een veilige locatie.
Kopieer het json-bestand naar de XSP|ADP.
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 ********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_projectFCMv1 inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...DoneVoer het installatiebestand
bwrestartopdracht 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. |
FCM uitschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...DoneVoer het installatiebestand
bwrestartopdracht om de XSP|ADP opnieuw te starten.FCM inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...DoneVoer het installatiebestand
bwrestartopdracht 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.
Haal het JSON-bestand op van de Google Cloud-console:
Ga op de Google Cloud Console naar de pagina Service Accounts.
Klik op Selecteer een project, kies uw project en klik op Openen.
Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.
Selecteer een type Sleutel en klik op Aanmaken
Het bestand wordt gedownload.
FCM toevoegen aan de ADP-server:
Importeer het JSON-bestand naar de ADP-server met de
/bw/installopdracht.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:Voeg vervolgens de toepassing en de sleutel toe:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...DoneControleer 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:
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
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.
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.
(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.
Voeg uw URL's voor XSI-acties en XSI-gebeurtenissen toe.
Optioneel. Werk de DAS-URL bij met de URL van de apparaatactiveringsservice.
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.
Klik op Volgende.
Ga als volgt te werk op de pagina CTI-interface:
Voeg de CTI-URL en poort toe voor de CTI-interface waarmee u verbinding wilt maken.
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.
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.
Klik op Volgende.
Voeg de URL van uw verificatieservice toe.
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.
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.
Klik op Clusters weergeven en u moet uw nieuwe cluster zien en zien of de validatie is gelukt.
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
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
Klik op Clusters weergeven.
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.
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.
Meld u aan bij de Partnerhub en selecteer Klanten.
Klik op de knop Onboarding templates om de bestaande templates te bekijken.
Klik op Template aanmaken.
Voeg in het venster Sjabloondetails de sjabloonnaam, het land of de regio en de standaardtaal van het e-mailadres toe.
Gebruik in het venster Service-instelling de vervolgkeuzelijst Cluster om het cluster te kiezen dat u met deze sjabloon wilt gebruiken.
Voer een sjabloonnaam in en klik op Volgende.
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.
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.
Optioneel. Schakel Gratis bellen via Cisco Webex uitschakelen in als u Webex-gesprekken wilt uitschakelen.
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.
Klik op Volgende.
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.
Klik op Volgende.
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).
Klik op Volgende.
Voor Voorkeuren configureert u het volgende:
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.
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.
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.
Zorg ervoor dat de schakelaar E-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties is ingeschakeld (de standaardinstelling is ingeschakeld).
Klik op Volgende.
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.
Klik op Sjablonen weergeven en u moet uw nieuwe sjabloon met andere sjablonen in de lijst zien.
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.
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)
Als u dit nog niet hebt gedaan, past u de volgende patch toe die van toepassing is op uw versie:.
Voor R22:
AP.as.22.0.1123.ap373197Voor R23:
AP.as.23.0.1075.ap373197Voor R24:
AP.as.24.0.944.ap384177
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.Wijzigen in de
Maintenance/ContainerOptionscontext.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.
Meld u aan bij Partner Hub en ga naar .
Klik op Sjablonen weergeven.
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.
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. |
Meld u aan bij de toepassingsserver en configureer de interface voor berichten.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURLAS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_nameAS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_passwordAS_CLI/Interface/Messaging> set enableSynchronization true
De geïntegreerde IMP-interface activeren:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
U moet de volledig gekwalificeerde naam invoeren voor de |
(Optie) Inrichtingsparameters per onderneming configureren op toepassingsserver
Open in de BroadWorks-gebruikersinterface de onderneming die u wilt configureren en ga naar Services > Geïntegreerde IM&P.
Selecteer Servicedomein gebruiken en voer een dummywaarde in (Webex negeert deze parameter. U kunt dit gebruiken
example.com).Selecteer Messaging Server gebruiken.
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
provisioningURLparameter, 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/hostsbestand op het AS.Voer in het veld Gebruikersnaam een naam in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.
Voer een wachtwoord in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.
Voor Standaard gebruikersidentiteit voor IM&P-id selecteert u Primair.
Klik op Toepassen.
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. |
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.
Open een serviceaanvraag met Cisco TAC. TAC moet een vertrouwensrelatie opbouwen tussen de externe identiteitsprovider en de Cisco Common Identity-service. .
Als uw IdP depassEmailInRequestin 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.Upload het CI-metagegevensbestand dat TAC aan uw identiteitsprovider heeft geleverd.
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.
Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.
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. |
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.
Configureer de omleidings-URI op de OpenID connect-id-provider.
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.
Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.
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-InfoSIP-koptekst:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork trueAS_CLI/Interface/SIP> set sendCallCorrelationIDAccess trueHet
enableCallCorrelationIDparameter 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 omenableCallCorrelationIDingeschakeld 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:
AP.as.22.0.1123.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
Voor R23:
AP.as.23.0.1075.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433Bij gebruik van XSP:
AP.xsp.23.0.1075.ap378585Bij gebruik van ADP:
Xsi-Events-23_2021.05_1.251.bwar
Voor R24:
AP.as.24.0.944.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
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:
Meld u aan bij Partnerhub op
admin.webex.com.Ga naar Instellingen en selecteer een bestaand cluster.
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.
Schakel het selectievakje Gespreksgeschiedenis inschakelen in.
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:
- Schakel Unified Call History in zoals beschreven in het vorige gedeelte.
- 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
- De functie moet geactiveerd worden via de AS CLI:
- AS_CLI/System/ActivatableFeature> 104112 activeren
- AS_CLI/System/StirShaken> enableVerification true instellen
- 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)
Aanmelden bij Partner Hub
Klik op Instellingen.
Klik op Cluster weergeven en selecteer het juiste BroadWorks-cluster.
Schakel de schakelaar Niet storen (NST) in.
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.
Als de validatie slaagt, klik dan op Save.
|
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
Gespreksopname
Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopname.
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. |
|
Altijd met onderbreken/hervatten | De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker kan een opname onderbreken en 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 |
|
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. |
|
Vereisten
Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:
Voor R22: AP.as.22.0.1123.ap377718
Voor R23: AP.as.23.0.1075.ap377718
Voor R24: AP.as.24.0.944.ap377718
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.
Haal de vereiste DTAF-bestanden op (zie Apparaatprofielen in het gedeelte Uw omgeving voorbereiden).
Controleer of u de juiste tagsets hebt in BroadWorks System > Resources > Device Management Tagsets.
Voor elke client die u inricht:
Download en pak het DTAF zip-bestand voor de specifieke client uit.
DTAF-bestanden importeren naar BroadWorks op System > Resources > Identity/Device Profile Types
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
Pas de sjablonen aan volgens uw omgeving (zie onderstaande tabel).
Sla het bestand op.
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
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 hun eigen merkaanpassingen toe te passen, kunnen klantbeheerders de procedures volgen bij Uw bedrijfsbranding toevoegen aan Webex.
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: |
| 2 | Klantorganisatie en gebruikers verifiëren in Control Hub: |
Gebruikerstests
| 1 | Download de Webex-app op twee verschillende machines. |
| 2 | Meld u aan als testgebruikers op de twee machines. |
| 3 | Voer testgesprekken. |
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:
Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.
Klik op Sjablonen weergeven.
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.
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.
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) |
|
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):
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
Gebruiker verplaatsen (met vertrouwd e-mailadres)
Als de onboardsjabloon vertrouwde e-mails gebruikt, kan de partnerbeheerder volgende gebruikers met dit proces verplaatsen:
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.
De gebruiker opent de e-mail en klikt op Account activeren. De gebruiker wordt omgeleid naar de Webex-consumentenportal.
Gebruiker meldt zich aan bij Webex.
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:
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.
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.
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.
Gebruiker meldt zich aan bij Webex.
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.
De gebruiker meldt zich aan bij de URL van de gebruikerstoegang met BroadWorks-aanmeldgegevens.
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.
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.
De gebruiker meldt zich aan bij de Consumentenportal.
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:
| ||
| 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.
|
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. |
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.
Verwijder alle Webex voor BroadWorks-werkplekken uit de organisatie. Gebruik de API Een BroadWorks-werkplek verwijderen.
Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de API Een BroadWorks-abonnee verwijderen.
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.
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:
|
| 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:
|
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 BroadWorks | Overeenkomstig kenmerk in Webex | Doel | Notities |
| BroadWorks-gebruikers-id | Geen | Primaire id | U 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-id | Gebruikers-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:
Wijzig de BroadWorks-gebruikers-id niet. Dit wordt niet ondersteund. |
| Alternatieve id | Geen | Hiermee schakelt u het authn van de gebruiker in, via e-mail en wachtwoord, met de BroadWorks-gebruikers-id | Moet 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:
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.
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:
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.
Zoek en selecteer de gebruiker in Control Hub.
- 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
| 1 | Gebruik de People API's om alle gebruikers uit de organisatie te verwijderen:
| ||
| 2 | Als adreslijstsynchronisatie is ingeschakeld, schakelt u deze uit. Dit kan via Partner Hub of via de openbare API. Adreslijstsynchronisatie uitschakelen via Partner Hub: 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 | ||
| 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:
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 | |||||||||
| 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:
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.
Meld u aan bij Partnerhub op admin.webex.com.
Kies Instellingen.
Klik op Sjabloon weergeven en kies de juiste onboardingsjabloon.
Klik op Cisco Webex Free Calling uitschakelen.
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:
Open CommPilot en ga naar de gebruikersconfiguratie.
Verwijder de geïntegreerde IM+P-service van de gebruiker en klik op OK.
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.
Gebruik de Een BroadWorks-abonnee-API verwijderen om de gebruiker te verwijderen.
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:
Aanwezigheid wordt niet ondersteund voor niet-CI Broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.
CI-gebruikers zonder Webex-cloudrechten of computertype accounts (werkplekken) geven alleen aanwezigheid 'in gesprek' en 'onbekend' weer. Er is geen status actief, overgaan, enz.
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.
Als u uw verbinding verliest, worden alle niet-Webex-gespreksstatussen bij het opnieuw verbinden teruggezet op 'onbekend'.
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.
Meld u aan bij BroadWorks CommPilot.
Ga voor een geselecteerde gebruiker naar Clienttoepassingen en configureer het Busy Lamp Field.
Voeg de URL van de BLF-lijst toe die wordt gecontroleerd.
Gebruik de zoekparameters om gebruikers te zoeken en toe te voegen aan de lijst Bewaakte gebruikers.
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:
ga naar het tabblad Algemeen van uw tabblad Instellingen in Windows of Voorkeuren op de Mac.
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).
Meld u aan bij Partnerhub ( https://admin.webex.com) en selecteer Klanten.
Selecteer de toepasselijke klantorganisatie.
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:
|
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 |
|
BroadWorks-factureringsrapporten weergeven | Wordt gebruikt om de rapporten weer te geven die beschikbaar zijn om te bekijken. | Leestoegang |
|
Een BroadWorks-factureringsrapport ophalen | Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen. | Leestoegang |
|
Een BroadWorks-factureringsrapport verwijderen | Wordt gebruikt om een gegenereerd rapport te verwijderen. | Schrijftoegang |
|
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.
|
|
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:
- Zorg ervoor dat u RSA-sleutels hebt gedeeld met alle XSP|ADP's.
- Zorg ervoor dat u op alle XSP|ADP's de AuthService-URL voor de webcontainer hebt opgegeven.
- 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.
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?
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
Meld u aan bij de Webex-app.
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.
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
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.
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)
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: 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 |
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.
|
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 | ||
Vereist voor adreslijstsynchronisatie | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereiste patch voor toepassingsserver | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereiste patch voor de functie Gespreksopname | ||
Vereiste patch voor doorstroominrichting | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Profielserver | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Platform | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
XSP|ADP | Vereist voor NPS-verificatieproxy | |
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereist voor NPS-verificatieproxy | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereist voor Unified Call History | ||
Overig | AP.xsa.22.0.1123.ap372757 | |
Versie R23
Server | Pleister | Aanvullende informatie |
|---|---|---|
Toepassingsserver | Vereist voor adreslijstsynchronisatie | |
App-server configureren | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor gespreksopname | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Profielserver | ||
Platform | ||
Vereist voor NPS-verificatieproxy | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
XSP|ADP | ||
Vereist voor NPS-verificatieproxy | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Overig | Bij gebruik van ADP... | Vereiste patch voor haakstatus (Presence) en Unified Call History |
Versie R24
Server | Pleister | Aanvullende informatie |
|---|---|---|
Toepassingsserver | Vereist voor Unified Messaging Server (UMS) | |
Vereist voor flowthrough-inrichting | ||
Vereist voor gespreksopname | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Overig | Vereiste patch voor haakstatus (Presence) en Unified Call History |
BroadWorks-tags vereist voor Webex
Raadpleeg de Webex voor Cisco BroadWorks-configuratiehandleiding voor informatie over de BroadWorks-systeemtags en aangepaste tags die u voor Webex moet configureren.
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
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.
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
De Webex-app lanceert een browser naar Cisco Common Identity (CI) zodat gebruikers hun e-mailadres kunnen invoeren.
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.)
De gebruiker voert zijn of haar BroadWorks-referenties in.
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).
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.
De Webex-app ontdekt de gespreksconfiguratie van BroadWorks en andere services van Webex.
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:
U downloadt en installeert de Webex-app.
Mogelijk hebt u de koppeling van uw serviceprovider ontvangen of kunt u de download vinden op de pagina Webex-downloads.
U voert uw e-mailadres in op het aanmeldscherm van Webex. Klik op Volgende.
U wordt meestal omgeleid naar een pagina met het merk Serviceprovider.
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.
Voer uw BroadWorks-wachtwoord in.
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
De client belt XSI om een apparaatbeheertoken en de URL naar het DMS op te halen.
De klant vraagt zijn apparaatprofiel aan bij DMS door het token van stap 1 voor te leggen.
De client leest het apparaatprofiel en haalt de SIP-referenties, adressen en poorten op.
Client verzendt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.
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:
Meld u aan bij Partner Hub en selecteer Klanten.
Selecteer de juiste klant.
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 WAVMS_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
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:
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).Implementeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects>deploy application /authService
Duur token configureren
Controleer de bestaande tokenconfiguratie (uren):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>getStel 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. |
Selecteer één XSP|ADP om een sleutelpaar te genereren.
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)
De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeysHet geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere.keysbestand indien nodig.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:
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/authServiceVoeg de URL van de verificatieservice toe aan de container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authServiceHiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.
Controleer de parameter met
get.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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>Voer de opdracht in
get <interfaceIp> 443om 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).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-POLY1305in 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_POLY1305Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.
Trust configureren voor verificatieservice (met mTLS)
Meld u aan bij Control Hub met uw partnerbeheerdersaccount.
Ga naar en klik op Webex CA-certificaat downloaden om
CombinedCertChain2023.txtop 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.Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txt.Openen
combinedcertchain2023.txtin een teksteditor.Selecteer en knip het eerste tekstblok, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----en plak het tekstblok in een nieuw bestand.Sla het nieuwe bestand op als
root2023.txt.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-----.
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txt.Meld u aan bij de XSP|ADP en ga naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoerenUpdateTrustom de parameters en opdrachtindeling weer te geven.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,webexclientissuingenwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang de vier ingangen uniek zijn.Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> getAlias 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.
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
Navigeren naar
XSP|ADP_CLI/Interface/Http/HttpServer>en voer degetopdracht om de raakvlakken te zien.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 trueZie de XSP|ADP CLI-documentatie voor meer informatie. In wezen de eerste
truebeveiligt de interface met TLS (servercertificaat wordt gemaakt indien nodig) en de tweedetruedwingt 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.
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
Navigeren naar
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>en voer degetom te zien welke toepassingen worden uitgevoerd.Een toepassing toevoegen en hiervoor clientverificatie vereisen (wat hetzelfde betekent als mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName trueZie de XSP|ADP CLI-documentatie voor meer informatie. Daar worden de toepassingsnamen opgesomd. Het
truein 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:
Ga naar Instellingen > BroadWorks Calling.
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 |
| |
07 maart 2024 | 2-111 |
| |
24 februari 2024 | 2-110 |
| |
20 februari 2024 | 2-109 |
| |
07 februari 2024 | 2-108 |
| |
25 januari 2024 | 2-107 |
| |
23 januari 2024 | 2-106 |
| |
10 januari 2024 | 2-105 |
| |
20 december 2023 | 2-104 |
| |
13 december 2023 | 2-103 |
| |
12 december 2023 | 2-102 |
| |
08 december 2023 | 2-101 |
| |
08 november 2023 | 2-100 |
| |
25 oktober 2023 | 2-99 |
| |
13 september 2023 | 2-98 |
| |
04 september 2023 | 2-97 |
| |
08 augustus 2023 | 2-96 |
| |
23 juni 2023 | 2-95 |
| |
30 mei 2023 | 2-94 |
| |
26 mei 2023 | 2-93 |
| |
24 mei 2023 | 2-92 |
| |
10 mei 2023 | 2-91 |
| |
09 mei 2023 | 2-90 |
| |
04 mei 2023 | 2-89 |
| |
27 april 2023 | 2-88 |
| |
14 april 2023 | 2-87 |
| |
17 maart 2023 | 2-86 |
| |
11 maart 2023 | 2-85 |
| |
10 maart 2023 | 2-84 |
| |
07 maart 2023 | 2-83 |
| |
28 februari 2023 | 2-82 |
| |
15 februari 2023 | 2-81 |
| |
10 februari 2023 | 2-80 |
| |
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:
| 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.
| 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:
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.)
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.)
Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)
Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)
Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)
|
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.
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:
Zendesk—Alleen premium
Slack—Alleen premium
Microsoft Teams voor Webex Meetings—Standaard of Premium
Microsoft Teams for Calling: ondersteund met alle pakketten
Office 365-agenda—Standaard of Premium
Google-agenda voor G Suite—Standaard of Premium
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
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:
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:
Wanneer het installatieprogramma hierom vraagt,
Do you want to configure NTP?, voer iny.Wanneer het installatieprogramma hierom vraagt,
Is this server going to be a NTP server?, voer inn.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_SHA384TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_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_SHA384TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256TLS_DHE_RSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384TLS_DHE_RSA_WITH_AES_256_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256TLS_DHE_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHATLS_ECDHE_RSA_WITH_AES_256_CBC_SHATLS_DHE_RSA_WITH_AES_256_CBC_SHATLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHATLS_ECDHE_RSA_WITH_AES_128_CBC_SHATLS_DHE_RSA_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_256_GCM_SHA384TLS_DHE_PSK_WITH_AES_256_GCM_SHA384TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_PSK_WITH_AES_128_GCM_SHA256TLS_DHE_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_128_GCM_SHA256TLS_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_256_CBC_SHA256TLS_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384TLS_ECDHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_PSK_WITH_AES_256_CBC_SHA384TLS_DHE_PSK_WITH_AES_256_CBC_SHA384TLS_RSA_PSK_WITH_AES_256_CBC_SHATLS_DHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHATLS_PSK_WITH_AES_256_CBC_SHA384TLS_PSK_WITH_AES_256_CBC_SHATLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_128_CBC_SHA256TLS_DHE_PSK_WITH_AES_128_CBC_SHA256TLS_RSA_PSK_WITH_AES_128_CBC_SHATLS_DHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_WITH_AES_128_CBC_SHATLS_PSK_WITH_AES_128_CBC_SHA256TLS_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 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.
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.
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.
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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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
De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.
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
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:
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.
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.
|
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.
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.
Bring Your Own PSTN-oplossing voor Webex voor Cisco BroadWorks: met deze oplossing kunnen serviceproviders telefoonnummers inrichten die ze bezitten (in plaats van door Cisco geleverde nummers) voor gebruikers om te gebruiken wanneer ze deelnemen aan Webex Meetings.
Webex voor Cisco BroadWorks-configuratiehandleiding: beschrijft hoe u de Webex-app voor Webex voor Cisco BroadWorks configureert.
- Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks: beschrijft hoe u het besturingssysteem en de MPP-apparaten van de serviceruimte kunt onboarden en gebruiken.
Handleiding voor probleemoplossing van Webex voor Cisco BroadWorks: bevat informatie voor het oplossen van problemen met Webex voor Cisco BroadWorks.
Webex voor Cisco BroadWorks-artikelen
Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:
Documentatie van Webex voor Cisco BroadWorks: de landingspagina bevat technische documenten en optionele Webex-artikelen die zijn bedoeld voor partnerbeheerders van Webex voor Cisco BroadWorks.
Nieuw in Webex voor Cisco BroadWorks: lees meer over de nieuwste functies en wat er binnenkort beschikbaar is.
Bekende problemen en beperkingen: lees meer over bekende problemen die we hebben geïdentificeerd in de Webex for Cisco BroadWorks-oplossing.
Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM: in dit artikel wordt beschreven hoe u partnerbeheerdersrollen toewijst voor partnerorganisaties die Webex voor Cisco BroadWorks aanbieden. Rollen worden gebruikt om beheerderstoegang toe te wijzen aan instellingen in Partnerhub en Control Hub.
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
Webex voor BroadWorks-ontwikkelaarshandleiding: bevat informatie voor ontwikkelaars die toepassingen maken die de Webex voor BroadWorks-API's gebruiken.
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:
Webex-vereisten: Het onboardsjabloon bevat de volgende instellingen:
|
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:
Webex-vereisten: Het onboardsjabloon bevat de volgende instellingen:
|
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:
Vereisten voor BroadWorks:
Webex-vereisten:
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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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.
|
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. |
| Verificatiemodus | BroadWorks | Webex |
| Primaire gebruikersidentiteit | BroadWorks-gebruikers-id | E-mailadres |
| Identiteitsprovider | BroadWorks.
| Cisco Common Identity |
| Meervoudige verificatie? | Nee | Vereist Customer IdP die meervoudige verificatie ondersteunt. |
Validatiepad gebruikergegevens
|
|
|
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-8ADP_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.
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
BroadWorks-exemplaar(en) met minimale versie R22. Zie de BroadWorks-softwarevereisten (in dit document) voor ondersteunde versies en patches. Voor meer informatie, zie Beleid voor de levenscyclus van BroadSoft-producten sectie in BroadSoft Lifecycle Policy en BroadWorks Software Compatibility Matrix.
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
Als u de Engelse versie van de Webex-app wilt downloaden, gaat u naar https://www.webex.com/webexfromserviceproviders-downloads.html. De Webex-app is beschikbaar op:
Windows-pc's/laptops
Apple-pc's/laptops met MacOS
iOS (Apple Store)
Android (Play store)
Webbrowsers (ga naar https://teams.webex.com/)
Gelokaliseerde versies
Gebruik een van de volgende koppelingen om een gelokaliseerde versie van de Webex-app te downloaden:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (Koreaans)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (Frans)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (Portugees)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (Traditioneel Chinees)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (vereenvoudigd Chinees)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Japan)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spanje)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (Duits)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italiaans)
Fysieke telefoons en accessoires
Cisco IP-telefoons:
Cisco IP-telefoon 6800-serie met Firmware voor meerdere platforms voor meerdere platforms
Cisco IP-telefoon 7800-serie met Firmware voor meerdere platforms voor meerdere platforms
Cisco IP-telefoon 8800-serie met Firmware voor meerdere platforms voor meerdere platforms
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html voor modellen en meer informatie.
We ondersteunen telefoons van derden op dezelfde manier als met andere BroadWorks-integraties. Ze hebben echter nog geen contacten en aanwezigheidsintegratie met Webex voor Cisco BroadWorks.
Adapters:
Analoge telefoonoplader voor meerdere platforms voor Cisco ATA 191
Analoge telefoonoplader voor meerdere platforms voor Cisco ATA 192
Zie https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html voor modellen en meer informatie.
Hoofdtelefoons:
Cisco-hoofdtelefoon 500-serie
Zie https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html voor modellen en meer informatie.
Apparaten met Room OS:
Webex Room- en Room Kit-serie
Webex Desk-serie
Webex Board-serie
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: Configuratiebestand: |
Sjabloon voor Webex-tablet |
Type identiteit/apparaatprofiel: Verbinding maken - tablet DTAF: Configuratiebestand: |
Webex Desktop-sjabloon |
Type identiteit/apparaatprofiel: Bedrijfscommunicator - PC DTAF: Configuratiebestand: |
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:
XSP|ADP AuthService Configuration' voor het configureren van de service op XSP|ADP.
'NPS-configuratie voor verificatie proxy instellen' om NPS te configureren voor het gebruik van de verificatieproxy.
CI-gebruikers-UUID synchroniseren' voor CI-gebruikers-UUID synchroniseren. Zie voor meer informatie over deze functie: Cisco BroadWorks-ondersteuning voor CI UUID.
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 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:
(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 AuthenticationDe 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.
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 |
Moet gelezen worden | |
Moet gelezen worden | |
Domeinen en URL's die toegankelijk moeten zijn voor Webex-services | Moet gelezen worden |
Optioneel | |
Optioneel | |
Optioneel | |
Optioneel | |
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 |
|
| Verwijst naar LB1 (Site A) |
A |
|
| 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 |
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 |
|
| Clientdetectie van Xsi-interface |
SRV |
|
| Clientdetectie van Xsi-interface |
A |
|
| Verwijst naar LB1 (site A) |
A |
|
| 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 |
|
| Lastbalancer |
A | LB.voorbeeld.com |
| 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 |
|
| Verwijst naar LB1 (site A) |
A |
|
| 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:
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:
De client voert een SRV-zoekopdracht uit voor _xsi-client._tcp.<xsi domain="">
Als de SRV-zoekopdracht een of meer A/AAAA-doelen retourneert:
De client zoekt A/AAAA op voor deze doelen en slaat de geretourneerde IP-adressen in de cache.
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).
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.
(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>Deze configuratieparameters hebben voorrang op elke configuratie in uw BroadWorks-cluster in Control Hub.
Als deze bestaan, vergelijkt de client met het oorspronkelijke XSI-adres dat hij heeft ontvangen via de BroadWorks-clusterconfiguratie.
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.
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.
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. |
Het verkrijgen van OAuth-referenties voor uw Webex voor Cisco BroadWorks.
Installeer de volgende patches op elke XSP|ADP-server. Installeer de patches die geschikt zijn voor uw versie:
Voor R22:
Voor R23:
Voor R24: geen patch vereist
Elke verwijzing naar XSP omvat XSP of ADP.Installeer de
AuthenticationServicetoepassing op elke XSP|ADP-service.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/authServiceVoer deze opdracht uit om de AuthenticationService te implementeren op de XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
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> getAls dit niet aanwezig is, voert u de volgende opdracht uit om de standaard Java-trusts te importeren:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrustU 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.
Configureer de identiteitsproviders door de volgende opdrachten uit te voeren op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> getset clientId client-Id-From-Step1set enabled trueset clientSecret client-Secret-From-Step1set ciResponseBodyMaxSizeInBytes 65536set issuerName <URL>—Voor deURLvoer de URL van de IssuerName in die van toepassing is op uw CI-cluster. Zie volgende tabel.set issuerUrl <URL>—Voor deURLvoer 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
EU
US-B
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".
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:userConfigureer identiteitsproviders voor Cisco Federation met de volgende opdrachten op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> getset flsUrl https://cifls.webex.com/federationset refreshPeriodInMinutes 60set refreshToken refresh-Token-From-Step1
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> GetConfigureer Tokenbeheer met de volgende opdrachten op elke XSP|ADP-server:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>set tokenIssuer BroadWorksset tokenDurationInHours 720
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.Selecteer één XSP|ADP om een sleutelpaar te genereren.
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)
De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeysHet geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere.keysbestand indien nodig.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 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:
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/authServiceVoeg de URL van de verificatieservice toe aan de container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authServiceHiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.
Controleer de parameter met
get.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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>Voer de opdracht in
get <interfaceIp> 443om 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).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-POLY1305in 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_POLY1305Raadpleeg 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.
Toepassingsserver configureren voor CTI-abonnementen
XSP|ADP's configureren voor mTLS geverifieerde CTI-abonnementen
Inkomende poorten openen voor veilige CTI-interface
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 |
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:
|
CTI TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp>om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>Voer de
getopdracht 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).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-POLY1305naar de CTI-interface gebruikt u:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305Raadpleeg 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:
Aanmelden bij Partnerhub .
Ga naar Instellingen > BroadWorks Calling en klik op Webex CA-certificaat downloaden om
CombinedCertChain2023.txtop 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.
Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txtOpenen
combinedcertchain2023.txtin een teksteditor.Selecteer en knip het eerste tekstblok, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----en plak het tekstblok in een nieuw bestand.Sla het nieuwe bestand op als
root2023.txt.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-----.
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txtMeld u aan bij de XSP|ADP en ga naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>(Optioneel) Uitvoeren
help updateTrustom de parameters en opdrachtindeling weer te geven.Upload de certificaatbestanden naar nieuwe vertrouwensankers - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txtXSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Alle aliassen moeten een andere naam hebben.
webexclientroot2023enwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang alle ingangen uniek zijn.Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> getAlias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]Clients toestaan te verifiëren met certificaten:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
CTI-interface toevoegen en mTLS inschakelen
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
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> getVoer 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>
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 .
Mac-gebruikers: Klik op profielfoto en vervolgens op .
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.
Meld u aan bij cisco.com en zoek naar 'BWCallSettingsWeb' in het gedeelte software downloaden.
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.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).
Kopieer het .war-bestand naar een tijdelijke locatie op de XSP|ADP, zoals
/tmp/.Navigeer naar de volgende CLI-context en voer de installatieopdracht uit:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.warDe BroadWorks-softwaremanager valideert en installeert het bestand.
[Optioneel] Verwijderen
/tmp/BWCallSettingsWeb_1.7.5_1.war(dit bestand is niet meer vereist).Activeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettingsDe 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.Implementeer de toepassing Gespreksinstellingen op het geselecteerde contextpad:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
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.
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.
Zorg ervoor dat u over de nieuwste configuratiesjablonen voor de Webex-app beschikt (zie Apparaatprofielen).
Het doel voor webgespreksinstellingen instellen op
csw:%WEB_CALL_SETTINGS_TARGET_WXT% cswStel 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.
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.
Zie de functiebeschrijving Pushserver voor VoIP in UCaaS voor meer informatie.
De BroadWorks-patches voor de functie zijn beschikbaar op: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Zie voor NPS-software en -patches het gedeelte Uw NPS voorbereiden op Webex voor Cisco BroadWorks.
Zoek en download de patch vanaf de downloadpagina van de software.
Meer informatie over de ADP-server vindt u op https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
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: XSP R22-patches: XSP R23-pleisters: | ||
| 3 | Activeer de toepassing Pushserver voor meldingen. | ||
| 4 | (Voor Android-meldingen) Schakel de FCM v1-API in op de NPS.
| ||
| 5 | (Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.
| ||
| 6 | Voeg een techsupport van de NPS XSP/ADP toe. | ||
| 7 | Op elke AS-server wordt het namedefs-bestand in 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
|
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:
Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u
| |||||||||||||||||||
| 3 | Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):
| |||||||||||||||||||
| 4 | (Voor Android-meldingen) Voeg de Android-toepassings-id toe aan de context van de FCM-toepassingen op de NPS.
| |||||||||||||||||||
| 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.
| |||||||||||||||||||
| 6 | Configureer de volgende NPS-URL's:
| |||||||||||||||||||
| 7 | Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:
| |||||||||||||||||||
| 8 | Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen: | |||||||||||||||||||
| 9 | Start de XSP|ADP opnieuw: | |||||||||||||||||||
| 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: wanneer u bestaande UCaaS-clients hebt en deze moet migreren om FCMv1 te gebruiken.
SaaS-clients migreren naar FCMv1: wanneer u bestaande SaaS-clients hebt en deze moet migreren om FCMv1 te gebruiken.
ADP-server bijwerken: wanneer u de NPS naar een ADP-server migreert.
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 . 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
|
Meld u aan bij FCM-beheerder SDK op http://console.firebase.google.com.
Selecteer de juiste Android-toepassing.
Noteer de project-ID op het tabblad Algemeen
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:
Klik op de blauwe knop om een nieuw serviceaccount aan te maken
Klik op de blauwe knop om een nieuwe privésleutel te genereren
Sleutel downloaden naar een veilige locatie
Een bestaand serviceaccount hergebruiken:
Klik op de blauwe tekst om bestaande serviceaccounts weer te geven.
Identificeer het te gebruiken serviceaccount. Serviceaccount heeft toestemming nodig firebaseadmin-sdk.
Klik aan de rechterkant op het hamburgermenu en maak een nieuwe privésleutel aan.
Download het json-bestand dat de sleutel bevat en sla het op naar een veilige locatie.
Kopieer het json-bestand naar de XSP|ADP.
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 ********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_projectFCMv1 inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...DoneVoer het installatiebestand
bwrestartopdracht 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. |
FCM uitschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...DoneVoer het installatiebestand
bwrestartopdracht om de XSP|ADP opnieuw te starten.FCM inschakelen:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...DoneVoer het installatiebestand
bwrestartopdracht 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.
Haal het JSON-bestand op van de Google Cloud-console:
Ga op de Google Cloud Console naar de pagina Service Accounts.
Klik op Selecteer een project, kies uw project en klik op Openen.
Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.
Selecteer een type Sleutel en klik op Aanmaken
Het bestand wordt gedownload.
FCM toevoegen aan de ADP-server:
Importeer het JSON-bestand naar de ADP-server met de
/bw/installopdracht.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:Voeg vervolgens de toepassing en de sleutel toe:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...DoneControleer 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:
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
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.
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.
(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.
Voeg uw URL's voor XSI-acties en XSI-gebeurtenissen toe.
Optioneel. Werk de DAS-URL bij met de URL van de apparaatactiveringsservice.
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.
Klik op Volgende.
Ga als volgt te werk op de pagina CTI-interface:
Voeg de CTI-URL en poort toe voor de CTI-interface waarmee u verbinding wilt maken.
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.
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.
Klik op Volgende.
Voeg de URL van uw verificatieservice toe.
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.
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.
Klik op Clusters weergeven en u moet uw nieuwe cluster zien en zien of de validatie is gelukt.
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
Meld u aan bij Partnerhub (admin.webex.com) met uw aanmeldgegevens voor partnerbeheerders.
Open de pagina Instellingen in het zijmenu en zoek de instellingen voor BroadWorks-gesprekken.
Klik op Clusters weergeven.
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.
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.
Meld u aan bij de Partnerhub en selecteer Klanten.
Klik op de knop Onboarding templates om de bestaande templates te bekijken.
Klik op Template aanmaken.
Voeg in het venster Sjabloondetails de sjabloonnaam, het land of de regio en de standaardtaal van het e-mailadres toe.
Gebruik in het venster Service-instelling de vervolgkeuzelijst Cluster om het cluster te kiezen dat u met deze sjabloon wilt gebruiken.
Voer een sjabloonnaam in en klik op Volgende.
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.
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.
Optioneel. Schakel Gratis bellen via Cisco Webex uitschakelen in als u Webex-gesprekken wilt uitschakelen.
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.
Klik op Volgende.
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.
Klik op Volgende.
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).
Klik op Volgende.
Voor Voorkeuren configureert u het volgende:
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.
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.
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.
Zorg ervoor dat de schakelaar E-mails met uitnodigingen voor beheerders toestaan bij het koppelen aan bestaande organisaties is ingeschakeld (de standaardinstelling is ingeschakeld).
Klik op Volgende.
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.
Klik op Sjablonen weergeven en u moet uw nieuwe sjabloon met andere sjablonen in de lijst zien.
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.
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)
Als u dit nog niet hebt gedaan, past u de volgende patch toe die van toepassing is op uw versie:.
Voor R22:
AP.as.22.0.1123.ap373197Voor R23:
AP.as.23.0.1075.ap373197Voor R24:
AP.as.24.0.944.ap384177
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.Wijzigen in de
Maintenance/ContainerOptionscontext.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.
Meld u aan bij Partner Hub en ga naar .
Klik op Sjablonen weergeven.
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.
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. |
Meld u aan bij de toepassingsserver en configureer de interface voor berichten.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURLAS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_nameAS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_passwordAS_CLI/Interface/Messaging> set enableSynchronization true
De geïntegreerde IMP-interface activeren:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
U moet de volledig gekwalificeerde naam invoeren voor de |
(Optie) Inrichtingsparameters per onderneming configureren op toepassingsserver
Open in de BroadWorks-gebruikersinterface de onderneming die u wilt configureren en ga naar Services > Geïntegreerde IM&P.
Selecteer Servicedomein gebruiken en voer een dummywaarde in (Webex negeert deze parameter. U kunt dit gebruiken
example.com).Selecteer Messaging Server gebruiken.
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
provisioningURLparameter, 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/hostsbestand op het AS.Voer in het veld Gebruikersnaam een naam in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.
Voer een wachtwoord in voor de inrichtingsbeheerder. Dit moet overeenkomen met de waarde in de sjabloon in Partner Hub.
Voor Standaard gebruikersidentiteit voor IM&P-id selecteert u Primair.
Klik op Toepassen.
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. |
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.
Open een serviceaanvraag met Cisco TAC. TAC moet een vertrouwensrelatie opbouwen tussen de externe identiteitsprovider en de Cisco Common Identity-service. .
Als uw IdP depassEmailInRequestin 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.Upload het CI-metagegevensbestand dat TAC aan uw identiteitsprovider heeft geleverd.
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.
Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.
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. |
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.
Configureer de omleidings-URI op de OpenID connect-id-provider.
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.
Maak een nieuwe gebruiker in een nieuwe klantorganisatie die de sjabloon gebruikt.
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-InfoSIP-koptekst:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork trueAS_CLI/Interface/SIP> set sendCallCorrelationIDAccess trueHet
enableCallCorrelationIDparameter 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 omenableCallCorrelationIDingeschakeld 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:
AP.as.22.0.1123.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
Voor R23:
AP.as.23.0.1075.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433Bij gebruik van XSP:
AP.xsp.23.0.1075.ap378585Bij gebruik van ADP:
Xsi-Events-23_2021.05_1.251.bwar
Voor R24:
AP.as.24.0.944.ap378585—na installatie van de patch moet u functie 25433 activeren. Bijvoorbeeld:AS_CLI/System/ActivatableFeature> activate 25433
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:
Meld u aan bij Partnerhub op
admin.webex.com.Ga naar Instellingen en selecteer een bestaand cluster.
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.
Schakel het selectievakje Gespreksgeschiedenis inschakelen in.
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:
- Schakel Unified Call History in zoals beschreven in het vorige gedeelte.
- 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
- De functie moet geactiveerd worden via de AS CLI:
- AS_CLI/System/ActivatableFeature> 104112 activeren
- AS_CLI/System/StirShaken> enableVerification true instellen
- 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)
Aanmelden bij Partner Hub
Klik op Instellingen.
Klik op Cluster weergeven en selecteer het juiste BroadWorks-cluster.
Schakel de schakelaar Niet storen (NST) in.
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.
Als de validatie slaagt, klik dan op Save.
|
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
Gespreksopname
Webex voor Cisco BroadWorks ondersteunt vier modi voor gespreksopname.
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. |
|
Altijd met onderbreken/hervatten | De opname wordt automatisch gestart wanneer het gesprek tot stand is gebracht. De gebruiker kan een opname onderbreken en 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 |
|
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. |
|
Vereisten
Als u deze functie wilt implementeren in Webex voor Cisco BroadWorks, moet u de volgende BroadWorks-patches implementeren:
Voor R22: AP.as.22.0.1123.ap377718
Voor R23: AP.as.23.0.1075.ap377718
Voor R24: AP.as.24.0.944.ap377718
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.
Haal de vereiste DTAF-bestanden op (zie Apparaatprofielen in het gedeelte Uw omgeving voorbereiden).
Controleer of u de juiste tagsets hebt in BroadWorks System > Resources > Device Management Tagsets.
Voor elke client die u inricht:
Download en pak het DTAF zip-bestand voor de specifieke client uit.
DTAF-bestanden importeren naar BroadWorks op System > Resources > Identity/Device Profile Types
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
Pas de sjablonen aan volgens uw omgeving (zie onderstaande tabel).
Sla het bestand op.
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
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 hun eigen merkaanpassingen toe te passen, kunnen klantbeheerders de procedures volgen bij Uw bedrijfsbranding toevoegen aan Webex.
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: |
| 2 | Klantorganisatie en gebruikers verifiëren in Control Hub: |
Gebruikerstests
| 1 | Download de Webex-app op twee verschillende machines. |
| 2 | Meld u aan als testgebruikers op de twee machines. |
| 3 | Voer testgesprekken. |
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:
Meld u aan bij Partner Hub en zoek de pagina Klantenlijst.
Klik op Sjablonen weergeven.
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.
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.
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) |
|
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):
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
Gebruiker verplaatsen (met vertrouwd e-mailadres)
Als de onboardsjabloon vertrouwde e-mails gebruikt, kan de partnerbeheerder volgende gebruikers met dit proces verplaatsen:
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.
De gebruiker opent de e-mail en klikt op Account activeren. De gebruiker wordt omgeleid naar de Webex-consumentenportal.
Gebruiker meldt zich aan bij Webex.
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:
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.
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.
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.
Gebruiker meldt zich aan bij Webex.
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.
De gebruiker meldt zich aan bij de URL van de gebruikerstoegang met BroadWorks-aanmeldgegevens.
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.
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.
De gebruiker meldt zich aan bij de Consumentenportal.
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:
| ||
| 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.
|
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. |
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.
Verwijder alle Webex voor BroadWorks-werkplekken uit de organisatie. Gebruik de API Een BroadWorks-werkplek verwijderen.
Verwijder alle Webex voor BroadWorks-abonnees uit de organisatie. Gebruik de API Een BroadWorks-abonnee verwijderen.
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.
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:
|
| 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:
|
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 BroadWorks | Overeenkomstig kenmerk in Webex | Doel | Notities |
| BroadWorks-gebruikers-id | Geen | Primaire id | U 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-id | Gebruikers-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:
Wijzig de BroadWorks-gebruikers-id niet. Dit wordt niet ondersteund. |
| Alternatieve id | Geen | Hiermee schakelt u het authn van de gebruiker in, via e-mail en wachtwoord, met de BroadWorks-gebruikers-id | Moet 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:
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.
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:
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.
Zoek en selecteer de gebruiker in Control Hub.
- 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
| 1 | Gebruik de People API's om alle gebruikers uit de organisatie te verwijderen:
| ||
| 2 | Als adreslijstsynchronisatie is ingeschakeld, schakelt u deze uit. Dit kan via Partner Hub of via de openbare API. Adreslijstsynchronisatie uitschakelen via Partner Hub: 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 | ||
| 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:
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 | |||||||||
| 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:
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.
Meld u aan bij Partnerhub op admin.webex.com.
Kies Instellingen.
Klik op Sjabloon weergeven en kies de juiste onboardingsjabloon.
Klik op Cisco Webex Free Calling uitschakelen.
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:
Open CommPilot en ga naar de gebruikersconfiguratie.
Verwijder de geïntegreerde IM+P-service van de gebruiker en klik op OK.
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.
Gebruik de Een BroadWorks-abonnee-API verwijderen om de gebruiker te verwijderen.
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:
Aanwezigheid wordt niet ondersteund voor niet-CI Broadworks-gebruikers, zelfs niet als ze in de BLF-lijst staan.
CI-gebruikers zonder Webex-cloudrechten of computertype accounts (werkplekken) geven alleen aanwezigheid 'in gesprek' en 'onbekend' weer. Er is geen status actief, overgaan, enz.
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.
Als u uw verbinding verliest, worden alle niet-Webex-gespreksstatussen bij het opnieuw verbinden teruggezet op 'onbekend'.
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.
Meld u aan bij BroadWorks CommPilot.
Ga voor een geselecteerde gebruiker naar Clienttoepassingen en configureer het Busy Lamp Field.
Voeg de URL van de BLF-lijst toe die wordt gecontroleerd.
Gebruik de zoekparameters om gebruikers te zoeken en toe te voegen aan de lijst Bewaakte gebruikers.
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:
ga naar het tabblad Algemeen van uw tabblad Instellingen in Windows of Voorkeuren op de Mac.
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).
Meld u aan bij Partnerhub ( https://admin.webex.com) en selecteer Klanten.
Selecteer de toepasselijke klantorganisatie.
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:
|
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 |
|
BroadWorks-factureringsrapporten weergeven | Wordt gebruikt om de rapporten weer te geven die beschikbaar zijn om te bekijken. | Leestoegang |
|
Een BroadWorks-factureringsrapport ophalen | Wordt gebruikt om een kopie van een gegenereerd rapport te verkrijgen. | Leestoegang |
|
Een BroadWorks-factureringsrapport verwijderen | Wordt gebruikt om een gegenereerd rapport te verwijderen. | Schrijftoegang |
|
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.
|
|
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:
- Zorg ervoor dat u RSA-sleutels hebt gedeeld met alle XSP|ADP's.
- Zorg ervoor dat u op alle XSP|ADP's de AuthService-URL voor de webcontainer hebt opgegeven.
- 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.
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?
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
Meld u aan bij de Webex-app.
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.
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
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.
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)
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: 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 |
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.
|
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 | ||
Vereist voor adreslijstsynchronisatie | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereiste patch voor toepassingsserver | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereiste patch voor de functie Gespreksopname | ||
Vereiste patch voor doorstroominrichting | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Profielserver | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Platform | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
XSP|ADP | Vereist voor NPS-verificatieproxy | |
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereist voor NPS-verificatieproxy | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor de verificatieservice met CI-tokenvalidatie | ||
Vereist voor Unified Call History | ||
Overig | AP.xsa.22.0.1123.ap372757 | |
Versie R23
Server | Pleister | Aanvullende informatie |
|---|---|---|
Toepassingsserver | Vereist voor adreslijstsynchronisatie | |
App-server configureren | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor gespreksopname | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Profielserver | ||
Platform | ||
Vereist voor NPS-verificatieproxy | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
XSP|ADP | ||
Vereist voor NPS-verificatieproxy | ||
Vereist om te upgraden van V1- naar V2-pushmeldingen | ||
Vereist voor NPS-verificatieproxy | ||
Vereist voor NPS-verificatieproxy | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Overig | Bij gebruik van ADP... | Vereiste patch voor haakstatus (Presence) en Unified Call History |
Versie R24
Server | Pleister | Aanvullende informatie |
|---|---|---|
Toepassingsserver | Vereist voor Unified Messaging Server (UMS) | |
Vereist voor flowthrough-inrichting | ||
Vereist voor gespreksopname | ||
Vereiste patch voor haakstatus (Presence) en Unified Call History | ||
Overig | Vereiste patch voor haakstatus (Presence) en Unified Call History |
BroadWorks-tags vereist voor Webex
Raadpleeg de Webex voor Cisco BroadWorks-configuratiehandleiding voor informatie over de BroadWorks-systeemtags en aangepaste tags die u voor Webex moet configureren.
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
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.
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
De Webex-app lanceert een browser naar Cisco Common Identity (CI) zodat gebruikers hun e-mailadres kunnen invoeren.
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.)
De gebruiker voert zijn of haar BroadWorks-referenties in.
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).
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.
De Webex-app ontdekt de gespreksconfiguratie van BroadWorks en andere services van Webex.
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:
U downloadt en installeert de Webex-app.
Mogelijk hebt u de koppeling van uw serviceprovider ontvangen of kunt u de download vinden op de pagina Webex-downloads.
U voert uw e-mailadres in op het aanmeldscherm van Webex. Klik op Volgende.
U wordt meestal omgeleid naar een pagina met het merk Serviceprovider.
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.
Voer uw BroadWorks-wachtwoord in.
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
De client belt XSI om een apparaatbeheertoken en de URL naar het DMS op te halen.
De klant vraagt zijn apparaatprofiel aan bij DMS door het token van stap 1 voor te leggen.
De client leest het apparaatprofiel en haalt de SIP-referenties, adressen en poorten op.
Client verzendt een SIP REGISTER naar SBC met behulp van de informatie uit stap 3.
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:
Meld u aan bij Partner Hub en selecteer Klanten.
Selecteer de juiste klant.
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 WAVMS_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
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:
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).Implementeer de toepassing:
XSP|ADP_CLI/Maintenance/ManagedObjects>deploy application /authService
Duur token configureren
Controleer de bestaande tokenconfiguratie (uren):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>getStel 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. |
Selecteer één XSP|ADP om een sleutelpaar te genereren.
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)
De locatie van de sleutelopslag kan niet worden geconfigureerd. Exporteer de sleutels:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>exportKeysHet geëxporteerde bestand kopiëren
/var/broadworks/tmp/authService.keysnaar dezelfde locatie op de andere XSP|ADP’s, overschrijven van een oudere.keysbestand indien nodig.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:
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/authServiceVoeg de URL van de verificatieservice toe aan de container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authServiceHiermee kan Webex de verificatieservice gebruiken om tokens te valideren die als aanmeldgegevens worden gepresenteerd.
Controleer de parameter met
get.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) |
|
| Transportprotocollen voor dit systeem |
|
| HTTP op dit systeem |
|
| Specifieke HTTP-serverinterfaces op dit systeem |
|
HTTP Server TLS-interfaceconfiguratie lezen op de XSP|ADP
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer>Voer de
getopdracht 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>Voer de opdracht in
get <interfaceIp> 443om te zien welke protocollen al gebruikt worden op deze interface.Voer de opdracht in
add <interfaceIp> 443 TLSv1.2om 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:
Meld u aan bij de XSP|ADP en ga naar
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>Voer de opdracht in
get <interfaceIp> 443om 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).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-POLY1305in 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_POLY1305Raadpleeg https://ciphersuite.info/ om de suite met een van beide namen te vinden.
Trust configureren voor verificatieservice (met mTLS)
Meld u aan bij Control Hub met uw partnerbeheerdersaccount.
Ga naar en klik op Webex CA-certificaat downloaden om
CombinedCertChain2023.txtop 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.Splits de certificaatketen op in twee certificaten -
combinedcertchain2023.txt.Openen
combinedcertchain2023.txtin een teksteditor.Selecteer en knip het eerste tekstblok, inclusief de regels
-----BEGIN CERTIFICATE-----en-----END CERTIFICATE-----en plak het tekstblok in een nieuw bestand.Sla het nieuwe bestand op als
root2023.txt.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-----.
Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u beveiligt, bijv.
/var/broadworks/tmp/root2023.txten/var/broadworks/tmp/issuing2023.txt.Meld u aan bij de XSP|ADP en ga naar
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>. (Optioneel) Help uitvoerenUpdateTrustom de parameters en opdrachtindeling weer te geven.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,webexclientissuingenwebexclientissuing2023zijn voorbeeldaliassen voor de vertrouwensankers; u kunt uw eigen gebruiken zolang de vier ingangen uniek zijn.Bevestig dat de ankers zijn bijgewerkt:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> getAlias 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.
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
Navigeren naar
XSP|ADP_CLI/Interface/Http/HttpServer>en voer degetopdracht om de raakvlakken te zien.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 trueZie de XSP|ADP CLI-documentatie voor meer informatie. In wezen de eerste
truebeveiligt de interface met TLS (servercertificaat wordt gemaakt indien nodig) en de tweedetruedwingt 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.
Meld u aan bij de XSP|ADP waarvan u de interface configureert.
Navigeren naar
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>en voer degetom te zien welke toepassingen worden uitgevoerd.Een toepassing toevoegen en hiervoor clientverificatie vereisen (wat hetzelfde betekent als mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName trueZie de XSP|ADP CLI-documentatie voor meer informatie. Daar worden de toepassingsnamen opgesomd. Het
truein 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:
Ga naar Instellingen > BroadWorks Calling.
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 |
| |
22 maart 2024 | 2-112 |
| |
07 maart 2024 | 2-111 |
| |
24 februari 2024 | 2-110 |
| |
20 februari 2024 | 2-109 |
| |
07 februari 2024 | 2-108 |
| |
25 januari 2024 | 2-107 |
| |
23 januari 2024 | 2-106 |
| |
10 januari 2024 | 2-105 |
| |
20 december 2023 | 2-104 |
| |
13 december 2023 | 2-103 |
| |
12 december 2023 | 2-102 |
| |
08 december 2023 | 2-101 |
| |
08 november 2023 | 2-100 |
| |
25 oktober 2023 | 2-99 |
| |
13 september 2023 | 2-98 |
| |
04 september 2023 | 2-97 |
| |
08 augustus 2023 | 2-96 |
| |
23 juni 2023 | 2-95 |
| |
30 mei 2023 | 2-94 |
| |
26 mei 2023 | 2-93 |
| |
24 mei 2023 | 2-92 |
| |
10 mei 2023 | 2-91 |
| |
09 mei 2023 | 2-90 |
| |
04 mei 2023 | 2-89 |
| |
27 april 2023 | 2-88 |
| |
14 april 2023 | 2-87 |
| |
17 maart 2023 | 2-86 |
| |
11 maart 2023 | 2-85 |
| |
10 maart 2023 | 2-84 |
| |
07 maart 2023 | 2-83 |
| |
28 februari 2023 | 2-82 |
| |
15 februari 2023 | 2-81 |
| |
10 februari 2023 | 2-80 |
| |
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:
| 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.
| 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:
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.)
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.)
Gebruik Partnerhub om Webex te verbinden met BroadWorks. (Zie Webex implementeren voor Cisco BroadWorks > Uw partnerorganisatie configureren in Partner Hub in dit document.)
Gebruik Partnerhub om gebruikersinrichtingssjablonen voor te bereiden. (Zie Webex implementeren voor Cisco BroadWorks > Uw sjablonen voor onboarding configureren in dit document.)
Test een klant en integreer deze door ten minste één gebruiker in te richten. (Zie Webex voor Cisco BroadWorks implementeren > Uw testorganisatie configureren.)
|
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.
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:
Zendesk—Alleen premium
Slack—Alleen premium
Microsoft Teams voor Webex Meetings—Standaard of Premium
Microsoft Teams for Calling: ondersteund met alle pakketten
Office 365-agenda—Standaard of Premium
Google-agenda voor G Suite—Standaard of Premium
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
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:
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:
Wanneer het installatieprogramma hierom vraagt,
Do you want to configure NTP?, voer iny.Wanneer het installatieprogramma hierom vraagt,
Is this server going to be a NTP server?, voer inn.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_SHA384TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_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_SHA384TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256TLS_DHE_RSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384TLS_DHE_RSA_WITH_AES_256_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256TLS_DHE_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHATLS_ECDHE_RSA_WITH_AES_256_CBC_SHATLS_DHE_RSA_WITH_AES_256_CBC_SHATLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHATLS_ECDHE_RSA_WITH_AES_128_CBC_SHATLS_DHE_RSA_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_256_GCM_SHA384TLS_DHE_PSK_WITH_AES_256_GCM_SHA384TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_AES_256_GCM_SHA384TLS_PSK_WITH_CHACHA20_POLY1305_SHA256TLS_RSA_PSK_WITH_AES_128_GCM_SHA256TLS_DHE_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_128_GCM_SHA256TLS_PSK_WITH_AES_128_GCM_SHA256TLS_RSA_WITH_AES_256_CBC_SHA256TLS_RSA_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384TLS_ECDHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_PSK_WITH_AES_256_CBC_SHA384TLS_DHE_PSK_WITH_AES_256_CBC_SHA384TLS_RSA_PSK_WITH_AES_256_CBC_SHATLS_DHE_PSK_WITH_AES_256_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHATLS_PSK_WITH_AES_256_CBC_SHA384TLS_PSK_WITH_AES_256_CBC_SHATLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256TLS_ECDHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_PSK_WITH_AES_128_CBC_SHA256TLS_DHE_PSK_WITH_AES_128_CBC_SHA256TLS_RSA_PSK_WITH_AES_128_CBC_SHATLS_DHE_PSK_WITH_AES_128_CBC_SHATLS_RSA_WITH_AES_128_CBC_SHATLS_PSK_WITH_AES_128_CBC_SHA256TLS_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 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.
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.
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.
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:
Installeer AP.as.22.0.1123.ap376508.
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Voor R23:
Installeer AP.as.23.0.1075.ap376509
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/ContainerOptions.Zie de patchnotities voor meer informatie https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Voor R24:
Installeer AP.as.24.0.944.ap375100
Stel na de installatie de eigenschap in
bw.msg.includeIsEnterpriseInOSSschematottruevanuit de CLI inMaintenance/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.
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
De clientversie die vereist is om deze functie te ondersteunen, is 42.11 of hoger.
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
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:
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.
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.
|
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.
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.
Bring Your Own PSTN-oplossing voor Webex voor Cisco BroadWorks: met deze oplossing kunnen serviceproviders telefoonnummers inrichten die ze bezitten (in plaats van door Cisco geleverde nummers) voor gebruikers om te gebruiken wanneer ze deelnemen aan Webex Meetings.
Webex voor Cisco BroadWorks-configuratiehandleiding: beschrijft hoe u de Webex-app voor Webex voor Cisco BroadWorks configureert.
- Handleiding voor apparaatintegratie voor Webex voor Cisco BroadWorks: beschrijft hoe u het besturingssysteem en de MPP-apparaten van de serviceruimte kunt onboarden en gebruiken.
Handleiding voor probleemoplossing van Webex voor Cisco BroadWorks: bevat informatie voor het oplossen van problemen met Webex voor Cisco BroadWorks.
Webex voor Cisco BroadWorks-artikelen
Partnerbeheerders kunnen de volgende optionele sites gebruiken voor meer informatie over Webex voor Cisco BroadWorks:
Documentatie van Webex voor Cisco BroadWorks: de landingspagina bevat technische documenten en optionele Webex-artikelen die zijn bedoeld voor partnerbeheerders van Webex voor Cisco BroadWorks.
Nieuw in Webex voor Cisco BroadWorks: lees meer over de nieuwste functies en wat er binnenkort beschikbaar is.
Bekende problemen en beperkingen: lees meer over bekende problemen die we hebben geïdentificeerd in de Webex for Cisco BroadWorks-oplossing.
Partnerbeheerdersrollen voor Webex voor BroadWorks en Wholesale RTM: in dit artikel wordt beschreven hoe u partnerbeheerdersrollen toewijst voor partnerorganisaties die Webex voor Cisco BroadWorks aanbieden. Rollen worden gebruikt om beheerderstoegang toe te wijzen aan instellingen in Partnerhub en Control Hub.
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
