Zahtjevi za zajedničku rezidenciju

• Usluga provjere autentičnosti mora biti surezident s Xsi aplikacijama, jer ta sučelja moraju prihvatiti dugotrajne tokene za autorizaciju usluge. Usluga provjere autentičnosti potrebna je za potvrdu tih tokena.

• Usluga provjere autentičnosti i Xsi mogu se pokrenuti na istom priključku ako je potrebno.

• Ostale usluge/aplikacije možete odvojiti prema potrebi za vašu vagu (na primjer, namjensko upravljanje uređajima XSP|ADP farma).

• Možete zajedno locirati Xsi, CTI, uslugu provjere autentičnosti i DMS aplikacije.

• Nemojte instalirati druge aplikacije ili usluge na XSP|ADP-ove koji se koriste za integraciju BroadWorksa s Webexom.

• Ne locirajte NPS aplikaciju s bilo kojom drugom aplikacijom.

Xsi sučelja

Instalirajte i konfigurirajte aplikacije Xsi-Actions i Xsi-Events kako je opisano u Vodiču za konfiguraciju sučelja Cisco Broad Works Xtended Services.

Samo jedna instanca XSI-Events aplikacija trebala bi biti postavljena na XSP|AD P koji se koristi za CTI sučelje.

Svi XSI-događaji koji se koriste za integraciju Broadworksa s Webexom moraju imati isti CallControlApplicationName definiran u odjeljku Applications/XSI-Events/Općenite postavke. Na primjer:

ADP_CLI/Aplikacije/XSI-događaji/Opće postavke> dobiti

CallControlApplicationName = com.broadsoft.xsi-događaji

Kada je korisnik uključen u Webex, Webex stvara pretplatu za korisnika na AS-u kako bi primao telefonske događaje za prisutnost i povijest poziva. Pretplata je povezana s nazvom CallControlApplicationName i AS ga koristi kako bi znao na koje Xsi-Events šalje telefonske događaje.

Konfigurirajte uslugu provjere autentičnosti (s potvrdom potvrde CI tokena)

Pomoću ovog postupka konfigurirajte uslugu provjere autentičnosti da koristi provjeru valjanosti CI tokena s TLS-om. Ova metoda provjere autentičnosti preporučuje se ako koristite R22 ili noviji i vaš sustav ga podržava.

1. Dobivanje OAuth vjerodajnica za vaš Webex za Cisco BroadWorks.

2. Instalirajte sljedeće zakrpe na svaki XSP|ADP poslužitelj. Instalirajte zakrpe koje odgovaraju vašem izdanju:

   • Za R22:

     AP.Platform.22.0.1123.AP376508

     AP.XSP.22.0.1123.AP376508

     AP.XSP.22.0.1123.AP368601

   • Za R23:

     AP.XSP.23.0.1075.AP376509

     AP.Platform.23.0.1075.AP376509

   • Za R24 - nije potrebna zakrpa

   Svaka referenca na XSP uključuje XSP ili ADP.

3. Instalirajte aplikaciju AuthenticationService na svaku XSP|ADP uslugu.

   1. Pokrenite sljedeću naredbu da biste aktivirali aplikaciju AuthenticationService na XSP|ADP na kontekstnu putanju /AuthService.

      XSP|ADP_CLI/Održavanje/ManagedObjects> aktiviraj autentifikaciju aplikacije 22.0_1.1123/AuthService

   2. Pokrenite ovu naredbu da biste implementirali AuthenticationService na XSP|ADP:

      XSP|ADP_CLI/ Održavanje/ManagedObjects> implementiranje aplikacije /AuthServiceBroadworks SW Manager implementacija/AuthService...

4. Počevši od Broadworks build 2022.10, vlasti za certifikate koje dolaze s Javom više se ne uključuju automatski u trgovinu povjerenja BroadWorks prilikom prelaska na novu verziju jave. Usluga autentifikacije otvara TLS vezu s Webexom kako bi preuzela pristupni token i mora imati sljedeće u svojoj trgovini pouzdanosti kako bi potvrdio IDBroker i Webex URL:

   • iTrust komercijalni korijen CA 1

   • Idi Daddy Root Certificate Authority - G2

   Provjerite jesu li ti certifikati prisutni pod sljedećim CLI-om

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> dobiti

   Ako nije prisutan, pokrenite sljedeću naredbu za uvoz zadanih Java trustova:

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> ImportJavaCatRust

   Alternativno, ove certifikate možete ručno dodati kao sidra povjerenja sljedećom naredbom:

   ADP_CLI/System/SSLCommonSettings/Trusts/Broadworks> UpdateTrust <alias><trustAnchorFile>

   Ako je ADP nadograđen iz prethodnog izdanja, tada se tijela za certifikate iz starog izdanja automatski uvoze u novo izdanje i nastavit će se uvoziti sve dok se ručno ne uklone.

   Aplikacija AuthenticationService izuzeta je od postavke ValidatePeerIdentity pod ADP_CLI/System/SSLCommonSettings/GeneralSettings i uvijek potvrđuje identitet vršnjaka. Za više informacija o ovoj postavci pogledajte Cisco Broadworks X509 Certificate Validation FD.

5. Konfigurirajte pružatelje identiteta pokretanjem sljedećih naredbi na svakom XSP|ADP poslužitelju:

   XSP | ADP_CLI/Aplikacije/Usluga autentičnosti/Pružatelji identiteta/CISCO> dobiti

   • postavite ClientID Client-ID-od-korak1

   • postavljanje omogućeno istinito

   • postavite ClientSecret Client-Secret-from-Step1

   • postavite CIResponseBodyMaxSizeInBytes 65536

   • postavite IssuerName <URL>—Za URL unesite URL is suerName koji se odnosi na vaš CI klaster. Pogledajte sljedeću tablicu.

   • postavite IssuerURL <URL>—Za URL unesite Issuer URL koji se odnosi na vaš CI klaster. Pogledajte sljedeću tablicu.

   • set TokenInFourl <IdPProxy URL>— Unesite URL iDP proxyja koji se primjenjuje na klaster timova. Pogledajte drugu tablicu koja slijedi.

   Tablica 1. Postavite ime izdavača i URL izdavača

   Ako je CI klaster...	Postavite IssuerName i IssuerURL na...
   US-A	https://idbroker.webex.com/idb
   EU	https://idbroker-eu.webex.com/idb
   US-B	https://idbroker-b-us.webex.com/idb
   Ako ne poznajete svoj CI klaster, informacije možete dobiti iz Pojedinosti o kupcu u prikazu službe za pomoć u Control Hubu.

   Tablica 2. Set TokenInFourl

   Ako je klaster timova...	Postavite TokenInFourl na... (IdP proxy URL)
   ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AFRA	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   Ako ne poznajete svoj klaster timo va, informacije možete dobiti iz podataka o kupcu u prikazu Help Desk u Control Hubu. Za testiranje možete provjeriti je li TokenInFourl valjan zamjenom dijela URL-a "idp/autentifikacija" s "ping".

6. Navedite Webex pravo koje mora biti prisutno u korisničkom profilu u Webexu pokretanjem sljedeće naredbe:

   XSP | ADP_CLI/ApplicationService/AuthenticationService/Pružatelji identiteta/CISCO/Opse> podesite opseg širokih radnih uređaja - konektor: korisnik

7. Konfigurirajte pružatelje identiteta za Cisco Federation pomoću sljedećih naredbi na svakom XSP|ADP poslužitelju:

   XSP | ADP_CLI/Aplikacije/AutentifikacijaService/Pružatelji identiteta/CISCO/Federacija> dobiti

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

   • postavite RefreshPeriodInMinutes 60

   • postavite RefreshToken Refresh-Token-from-Step1

8. Pokrenite sljedeću naredbu da biste potvrdili radi li vaša FLS konfiguracija. Ova naredba će vratiti popis pružatelja identiteta:

   XSP | ADP_CLI/Aplikacije/AuthService/Pružatelji identiteta/CISCO/Federacija/Clustermap> Preuzmi

9. Konfigurirajte upravljanje tokenima pomoću sljedećih naredbi na svakom XSP| ADP poslužitelju:

   • XSP | ADP_CLI/Aplikacije/Usluga provjere autentičnosti/Upravljanje tokenom>

   • set žetonEisbiter BroadWorks

   • set tokEndurationInHours 720

10. Generirajte i dijelite RSA ključeve. Morate generirati ključeve na jednom XSP|ADP-u, a zatim ih kopirati na sve ostale XSP|ADP. To je zbog sljedećih čimbenika:

    • Morate koristiti iste parove javnih/privatnih ključeva za šifriranje/dešifriranje tokena u svim instancama usluge provjere autentičnosti.

    • Par ključeva generira usluga provjere autentičnosti kada je prvo potrebno izdati token.

    Ako ciklirate tipke ili promijenite duljinu tipke, morate ponoviti sljedeću konfiguraciju i ponovno pokrenuti sve XSP | ADP-ove.

    1. Odaberite jedan XSP|ADP koji ćete koristiti za generiranje para ključeva.

    2. Pomoću klijenta zatražite šifrirani token iz tog XSP|ADP-a tako što ćete tražiti sljedeći URL iz klijentovog preglednika:

       https://<XSP|ADP-IPAddress>/authService/token? ključ = base64 URL (klijentPublicKey)

       (Ovo generira par privatnih/javnih ključeva na XSP | ADP, ako ga već nije bilo)

    3. Mjesto skladišta ključeva nije moguće konfigurirati. Izvoz ključeva:

       XSP | ADP_CLI/Aplikacije/Usluga provjere autentičnosti/Upravljanje ključevom> Izvozni ključevi

    4. Kopirajte izvezenu datoteku /var/Broadworks/tmp/AuthService.keys na isto mjesto na drugom XSP|ADPS-u, prepisujući stariju datoteku.keys ako je potrebno.

    5. Uvezite tipke na svakom drugom XSP|ADP-u:

       XSP | ADP_CLI/Aplikacije/Usluga provjere autentičnosti/Upravljanje ključevom> Uvoz ključeva/var/Broadworks/TMP/AuthService.keys

11. Navedite URL AuthService u web spremnik. Web spremnik XSP | ADP treba AuthService URL kako bi mogao potvrditi tokene. Na svakom od XSP | ADP-ova:

    1. Dodajte URL usluge provjere autentičnosti kao uslugu vanjske provjere autentičnosti za BroadWorks Communications Utility:

       XSP | ADP_CLI/System/Komunikacijska uslužna/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1:80/authService

    2. Dodajte URL usluge provjere autentičnosti u spremnik:

       XSP|ADP _CLI/Održavanje/Opcije spremnika> dodaj tomcat bw.authservice.authserviceURL http://127.0.0.1:80/authService

       To omogućuje Webexu da koristi uslugu provjere autentičnosti za provjeru tokena predstavljenih kao vjerodajnice.

    3. Provjerite parametar pomoću get.

    4. Ponovo pokrenite XSP | ADP.

Ukloni zahtjev za provjeru autentičnosti klijenta za Auth uslugu (samo R24)

Ako imate uslugu provjere autentičnosti konfiguriranu s potvrdom potvrde CI tokena na R24, također morate ukloniti Zahtjev za provjeru autentičnosti klijenta za uslugu provjere autentičnosti. Pokrenite sljedeću naredbu CLI:

ADP_CLI/Interface/HTTP/SSLCommonSettings/Autentifikacija klijenta/WebApps> postavite autentifikacijuUsluga klijentAuthReq false <interfaceIp><port>

Konfiguriranje TLS-a i šifra na HTTP sučeljima (za XSI i uslugu provjere autentičnosti)

Aplikacije Usluga provjere autentičnosti, Xsi-Actions i Xsi-Ev ents koriste sučelja HTTP poslužitelja. Razine TLS-a konfiguribilnosti za ove aplikacije su sljedeće:

Najopćenitije = Sustav > Prijevoz > HTTP > HTTP sučelje poslužitelja = Najspecifičnije

CLI konteksti koje koristite za pregled ili izmjenu različitih SSL postavki su:

Čitanje konfiguracije TLS sučelja HTTP poslužitelja na XSP|ADP

1. Prijavite se na XSP | ADP i idite na XSP | ADP_CLI/Interface/HTTP/HTTPServer>

2. Unesite naredbu get i pročitajte rezultate. Trebali biste vidjeti sučelja (IP adrese) i, za svako, jesu li sigurna i zahtijevaju li provjeru autentičnosti klijenta.

Apache tomcat nalaže certifikat za svako sigurno sučelje; sustav generira samopotpisani certifikat ako mu je potreban.

XSP|ADP_CLI/Interface/Http/HttpServer> get

Dodavanje protokola TLS 1.2 na sučelje HTTP poslužitelja

HTTP sučelje koje je u interakciji s Webex oblakom mora biti konfigurirano za TLSv1.2. Oblak ne pregovara o ranijim verzijama TLS protokola.

Da biste konfigurirali protokol TLSv1.2 na sučelju HTTP poslužitelja:

1. Prijavite se na XSP | ADP i idite na XSP | ADP_CLI/Interface/HTTP/HTTPServer/SSLSettings/Protocols>

2. Unesite naredbu get 443 <interfaceIp>da biste vidjeli koji se protokoli već koriste na ovom sučelju.

3. Unesite naredbu dodaj 443 TLSv1.2 kako biste <interfaceIp>osigurali da sučelje može koristiti TLS 1.2 prilikom komunikacije s oblakom.

Uređivanje konfiguracije TLS šifre na sučelju HTTP poslužitelja

Da biste konfigurirali potrebne šifre:

1. Prijavite se na XSP | ADP i idite na XSP | ADP_CLI/Interface/HTTP/HTTPServer/SSLSettings/Ciphers>

2. Unesite naredbu get 443 <interfaceIp>da biste vidjeli koje se šifre već koriste na ovom sučelju. Mora postojati barem jedan od Ciscovih preporuč enih paketa (pogledajte XSP|ADP zahtjevi identiteta i sigurnosti u odjeljku Pregled).

3. Unesite naredbu dodaj 443 <interfaceIp><cipherName>da biste dodali šifru sučelju HTTP poslužitelja .

   XSP|ADP CLI zahtijeva IANA standardni naziv šifrnog paketa, a ne naziv OpenSSL šifrnog paketa. Na primjer, da biste dodali OpenSSL šifru ECD HE-ECDSA-CHACHA20-POLY1305 na sučelje HTTP poslužitelja, upotrijebili biste: XSP|ADP_CLI/Interface/HTTP/HTTPServer/SSLSettings/Ciphers> dodajte 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

   Pogledajte https://ciphersuite.info/ da biste pronašli paket po bilo kojem imenu.

Konfigurirajte upravljanje uređajima na XSP | ADP, poslužitelju aplikacija i poslužitelju profila

Poslužitelj profila i XSP|ADP obvezni su za upravljanje uređajima. Moraju biti konfigurirani prema uputama u V odiču za konfiguraciju upravljanja uređajima BroadWor ks.