Zahtevi za zajedničko rezidenciju

• Servis za autentifik aciju mora biti surezident sa Xsi aplikacijama, jer ti interfejsi moraju prihvatiti dugotrajne tokene za autorizaciju usluge. Za potvrdu tih tokena potrebna je usluga autentifikacije.

• Usluga autentifikacije i Kssi mogu da se pokreću na istom portu ako je potrebno.

• Ostale usluge/aplikacije možete razdvojiti po potrebi za vašu vagu (namensko upravljanje uređajima KSSP | ADP farma, na primer).

• Možete zajedno locirati aplikacije Kssi, CTI, Servis za autentifikaciju i DMS.

• Ne instalirajte druge aplikacije ili usluge na XSP|ADP-ove koji se koriste za integraciju BroadVorks-a sa Vebek-om.

• Ne locirajte NPS aplikaciju sa bilo kojom drugom aplikacijom.

Kssi interfejsi

Instalirajte i konfigurišite aplikacije Kssi-Actions i Xsi-Events kako je opisano u Vodiču za konfiguraciju interfejsa Cisco BroadVorks Kstended Services.

Samo jedna instanca XSI-Events aplikacija treba da bude raspoređena na XSP|AD P koji se koristi za CTI interfejs.

Svi XSI-događaji koji se koriste za integraciju Broadvork-a sa Vebek-om moraju imati isti CallControlApplicationName definisan u odeljku Applications/XSI-Events/Opšta podešavanja. Na primer:

ADP_CLI/Applications/KSSI-Events/Opšta podešavanja> dobiti

CallControlApplicationName = com.broadsoft.kssi-events

Kada je korisnik uključen u Vebek, Vebek kreira pretplatu za korisnika na AS-u kako bi primao telefonijske događaje za prisustvo i istoriju poziva. Pretplata je povezana sa nazvom CallControlApplicationName i AS ga koristi da bi znao na koje Xsi-Events šalje telefonske događaje.

Konfigurišite uslugu autentifikacije (sa potvrdom CI tokena)

Koristite ovu proceduru da biste konfigurisali uslugu autentifikacije da koristi validaciju CI tokena sa TLS-om. Ovaj metod autentifikacije se preporučuje ako koristite R22 ili noviji i vaš sistem ga podržava.

1. Dobijanje OAuth akreditiva za vaš Vebek za Cisco BroadVorks.

2. Instalirajte sledeće zakrpe na svaki XSP|ADP server. Instalirajte zakrpe koje odgovaraju vašem izdanju:

   • Za R22:

     AP.Platform.22.0.1123.AP376508

     Ap.KSSP.22.0.1123.AP376508

     AP.KSSP.22.0.1123.AP368601

   • Za R23:

     Ap.KSSP.23.0.1075.AP376509

     AP.Platform.23.0.1075.AP376509

   • Za R24 - nije potrebna zakrpa

   Svaka referenca na KSP uključuje ili KSSP ili ADP.

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

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

      KSSP|ADP_CLI/Održavanje/UpravljanjeObjects> aktiviranje usluge autentifikacije aplikacije 22.0_1.1123/AuthService

   2. Pokrenite ovu komandu da biste primenili Uslugu autentifikacije na KSSP|ADP:

      KSP | ADP_CLI/Održavanje/UpravljanjeObjects> implementiranje aplikacije /AuthServiceBroadVorks SV Manager implementacija/AuthService...

4. Počevši od Broadvorks build 2022.10, autoriteti za sertifikate koji dolaze sa Javom više se ne uključuju automatski u prodavnicu poverenja BroadVorks prilikom prelaska na novu verziju jave. Usluga autentifikacije otvara TLS vezu sa Vebekom da bi preuzela pristupni token i mora da ima sledeće u svojoj prodavnici poverenja da bi potvrdio IDBroker i Vebek URL:

   • Identrust komercijalni koren CA 1

   • Go Daddi Root Certificate Authority - G2

   Proverite da li su ovi sertifikati prisutni pod sledećim CLI

   ADP_CLI/Sistem/SSLCommonSettings/Trusts/Defaults> dobiti

   Ako nije prisutan, pokrenite sledeću naredbu da biste uvezli podrazumevane Java poverenja:

   ADP_CLI/Sistem/SSLCommonSettings/Trusts/Defaults> ImportJavaCatRust

   Alternativno, ove sertifikate možete ručno dodati kao sidra poverenja sledećom naredbom:

   ADP_CLI/Sistem/SSLCommonSettings/Trusts/Broadvorks> UpdateTrust <alias><trustAnchorFile>

   Ako je ADP nadograđen iz prethodnog izdanja, tada se organi sertifikata iz starog izdanja automatski uvoze u novo izdanje i nastaviće da se uvoze sve dok se ručno ne uklone.

   Aplikacija AuthenticationService je izuzeta od postavke ValidatePeerIdentiti pod ADP_CLI/Sistem/SSLCommonSettings/GeneralSettings i uvek potvrđuje identitet vršnjaka. Pogledajte FD za validaciju sertifikata Cisco Broadvorks Ks509 za više informacija o ovom podešavanju.

5. Konfigurišite provajdere identiteta pokretanjem sledećih komandi na svakom XSP|ADP serveru:

   KSSP | ADP_CLI/Aplikacije/Servis za autentifikaciju/Provajderi identiteta/CISCO> dobiti

   • podesite ClientID Client-ID-od-korak1

   • podešavanje omogućeno tačno

   • podesite ClientSecret Client-Secret-from-Step1

   • podesite CIResponseBodiMakSizeInBites 65536

   • podesite IssuerName <URL>— Za URL unesite URL issuerName koji se odnosi na vaš CI klaster. Pogledajte sledeću tabelu.

   • podesite IssuerURL <URL>—Za URL unesite IssuerURL koji se odnosi na vaš CI klaster. Pogledajte sledeću tabelu.

   • podesite TokenInFourl <IdPProxy URL>— Unesite URL adresu iDP prokija koji se primenjuje na klaster timova. Pogledajte drugu tabelu koja sledi.

   Tabela 1. Podesite 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 detalja o kupcu u prikazu Help Desk-a u Control Hub-u.

   Tabela 2. Set TokenInFourl

   Ako je klaster timova...	Podesite TokenInFourl na... (IdP proki 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 detalja o kupcu u prikazu Help Desk u Control Hubu. Za testiranje možete proveriti da li je TokenInFourl validan tako što ćete zameniti deo URL-a "idp/autentifikacija" sa "ping“.

6. Navedite Vebek pravo koje mora biti prisutno u korisničkom profilu u Vebek-u pokretanjem sledeće naredbe:

   KSP | ADP_CLI/Aplikacije/AutentifikacijaService/Provajderi identiteta/CISCO/Opse> podesite opseg širokog obima - konektor: korisnik

7. Konfigurišite provajdere identiteta za Cisco Federaciju koristeći sledeće komande na svakom KSSP|ADP serveru:

   KSSP | ADP_CLI/Aplikacije/Servis za autentifikaciju/provajderi identiteta/CISCO/Federacija> dobiti

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

   • podesite Period osvežavanjaMinutes 60

   • podesite RefreshToken Refresh-Token-from-Step1

8. Pokrenite sledeću komandu da biste potvrdili da vaša FLS konfiguracija radi. Ova naredba će vratiti listu provajdera identiteta:

   KSSP | ADP_CLI/Aplikacije/AuthService/IdentitiProviders/CISCO/Federacija/ClusterMap> Preuzmi

9. Konfigurišite upravljanje tokenima koristeći sledeće komande na svakom XSP| ADP serveru:

   • KSSP | ADP_CLI/Aplikacije/Usluga autentifikacije/Upravljanje tokenom>

   • set žetonIzdavač BroadVorks

   • podesite tokEndurationInhours 720

10. Generišite i delite RSA ključeve. Morate da generišete ključeve na jednom XSP|ADP, a zatim ih kopirate na sve ostale XSP|ADP. To je zbog sledećih faktora:

    • Morate koristiti iste parove javnih/privatnih ključeva za šifrovanje/dešifrovanje tokena u svim instancama usluge autentifikacije.

    • Par ključeva generiše servis za autentifikaciju kada je prvo potrebno izdati token.

    Ako ciklusite tastere ili promenite dužinu tastera, morate ponoviti sledeću konfiguraciju i ponovo pokrenuti sve KSSP | ADP-ove.

    1. Izaberite jedan XSP|ADP koji ćete koristiti za generisanje para ključeva.

    2. Koristite klijenta da zatražite šifrovani token iz tog XSP|ADP-a, tako što ćete tražiti sledeći URL od pregledača klijenta:

       https://<XSP|ADP-IPAddress>/authService/token? Kei = base64 URL (ClientPublicKei)

       (Ovo generiše privatni/javni par ključeva na KSSP | ADP, ako ga već nije bilo)

    3. Lokacija prodavnice ključeva nije podesiva. Izvezite ključeve:

       KSSP | ADP_CLI/Aplikacije/Usluga autentifikacije/Upravljanje ključevima > Izvozni ključevi

    4. Kopirajte izvezenu datoteku /var/Broadvorks/TMP/AuthService.keys na istu lokaciju na drugom XSP|ADPS-u, prepisujući stariju datoteku.keys ako je potrebno.

    5. Uvezite tastere na svakom drugom KSSP|ADP-u:

       KSP | ADP_CLI/Aplikacije/Usluga autentifikacije/Upravljanje ključevima > Uvoz ključeva/var/Broadvorks/TMP/AuthService.keis

11. Navedite URL AuthService u veb kontejner. KSP|ADP-ovom veb kontejneru je potreban AuthService URL kako bi mogao da potvrdi tokene. Na svakom od KSSP | ADP-ova:

    1. Dodajte URL usluge autentifikacije kao uslugu spoljne autentifikacije za uslužni program BroadVorks Communications:

       KSSP | ADP_CLI/Sistem/Komunikaciona usluga/DefaultSettings/EksternalAuthentication/AuthService> set url http://127.0.0.1:80/authService

    2. Dodajte URL usluge autentifikacije u kontejner:

       KSSP|ADP _CLI/Održavanje/Opcije kontejnera> dodajte tomcat bv.authservice.authserviceURL http://127.0.0.1:80/authService

       Ovo omogućava Vebek-u da koristi uslugu autentifikacije za potvrdu tokena predstavljenih kao akreditivi.

    3. Proverite parametar pomoću get.

    4. Ponovo pokrenite KSSP | ADP.

Uklonite zahtev za autentifikaciju klijenta za uslugu autorizacije (samo R24)

Ako imate uslugu autentifikacije konfigurisanu sa potvrdom CI tokena na R24, takođe morate da uklonite zahtev za autentifikaciju klijenta za uslugu autentifikacije. Pokrenite sledeću CLI komandu:

ADP_CLI/Interface/HTTP/SSLCommonSettings/Autentifikacija klijenta/VebApps> podesite autentifikacijuUsluga klijentAuthrek false <interfaceIp><port>

Konfigurisan je TLS-a i šifra na HTTP interfejsima (za KSSI i uslugu autentifikacije)

Aplikacije Servis za autentifikaciju, Xsi-Actions i Xsi-Ev ents koriste interfejse HTTP servera. Nivoi TLS konfiguracije za ove aplikacije su sledeći:

Najopštije = Sistem > Transport > HTTP > HTTP interfejs servera = Najspecifičniji

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

Čitanje konfiguracije TLS interfejsa HTTP servera na KSSP | ADP

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

2. Unesite naredbu get i pročitajte rezultate. Trebalo bi da vidite interfejse (IP adrese) i, za svaki, da li su sigurni i da li zahtevaju autentifikaciju klijenta.

Apache tomcat nalaže sertifikat za svaki bezbedni interfejs; sistem generiše samopotpisani sertifikat ako mu je potreban.

XSP|ADP_CLI/Interface/Http/HttpServer> get

Dodavanje TLS 1.2 protokola u interfejs HTTP servera

HTTP interfejs koji je u interakciji sa Vebek Cloud mora biti konfigurisan za TLSv1.2. Oblak ne pregovara o ranijim verzijama TLS protokola.

Da biste konfigurisali protokol TLSv1.2 na interfejsu HTTP servera:

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

2. Unesite komandu get 443 <interfaceIp>da biste videli koji protokoli se već koriste na ovom interfejsu.

3. Unesite komandu dodaj 443 TLSv1.2 <interfaceIp>da biste osigurali da interfejs može da koristi TLS 1.2 prilikom komunikacije sa oblakom.

Uređivanje konfiguracije TLS šifre na interfejsu HTTP servera

Da biste konfigurisali potrebne šifre:

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

2. Unesite komandu get 443 <interfaceIp>da biste videli koje šifre se već koriste na ovom interfejsu. Mora postojati najmanje jedan od Cisco preporuč enih paketa (pogledajte KSSP|ADP zahtevi za identitet i bezbed nost u odeljku Pregled).

3. Unesite nared bu dodaj 443 <interfaceIp><cipherName>da biste dodali šifru interfejsu HTTP servera .

   KSP|ADP CLI zahteva IANA standardno ime šifrnog paketa, a ne ime OpenSSL šifrnog paketa. Na primer, da biste dodali OpenSSL šifru ECD HE-ECDSA-CHACHA20-POLI1305 u interfejs HTTP servera, koristili biste: KSSP|ADP_CLI/Interface/HTTP/HTTPServer/SSLSettings/Ciphers> dodajte 192.0.2.7 443 TLS_ECDHE_ECDSA_VITH_CHACHA20_POLI1305

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

Konfigurišite upravljanje uređajima na KSSP | ADP, aplikacionom serveru i serveru profila

Server profila i XSP|ADP su obavezni za upravljanje uređajima. Moraju biti konfigurisani u skladu sa uputstvima u V odiču za konfiguraciju upravljanja uređajima Broad Vorks.