Finesse-clientintegratie van derden met SSO

Inleiding

Dit document beschrijft hoe u de aangepaste desktopclient kunt integreren met Single Sign-On (SSO) in Unified Contact Center Enterprise (UCCE) of Unified Contact Center Express (UCCX). 

SSO is alleen beschikbaar bij Finesse. Het is een van de belangrijkste functies van het Cisco Unified Contact Center. SSO is een verificatieproces dat gebruikers in staat stelt om in te loggen op één toepassing en vervolgens veilig toegang te krijgen tot andere geautoriseerde toepassingen zonder dat ze gebruikersreferenties hoeven terug te geven. SSO staat toe dat Cisco-supervisors en -agents slechts eenmaal met een gebruikersnaam en wachtwoord inloggen om toegang te krijgen tot al hun op browser gebaseerde Cisco-toepassingen en -services in één browserinstantie.

Voorwaarden

Vereisten

Dit document is niet beperkt tot specifieke software- en hardware-versies.

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

• Cisco Identity Server (ID’s) 12.5
• Finesse 12.5(1)ES1 
• ADFS 2012
• UCS 12,5

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Achtergrondinformatie

Als een aangepaste client, om API-aanvragen naar Finesse-server te verzenden, moeten uw aanvragen worden geautoriseerd. In de context van de veiligheidsinformatieverplichting wordt deze vergunning verleend met behulp van penningen dus eerst penningen begrijpen.

Er zijn twee soorten tokens:

• Access Token - deze maakt toegang tot beschermde bronnen. De cliënten worden uitgegeven een toegangsteken dat identiteitsinformatie voor de gebruiker bevat. De identiteitsinformatie wordt standaard versleuteld.
• Vernieuwingstoken - hiermee wordt een nieuw toegangstoken verkregen voordat het huidige toegangstoken verloopt. De ID’s genereren het verversingtoken.

De refresh en access tokens worden als een paar tokens gegenereerd. Wanneer u het toegangsteken ververst, biedt het paar penningen een extra beveiligingslaag.

U kunt de verlooptijd van het verversen token en het toegangstoken configureren in de IDs administratie. Wanneer het verversen token verloopt, kunt u het toegangstoken niet verversen.

Fetch Access Token

Met de nieuwe Finesse API implementaties, kunt u twee query parameters cc_username en return_refresh_to gebruiken in de Finesse URL om het access-token te krijgen.

(Verkrijgbaar met 11.6.(1)ES10, 12.0(1)ES3, 12.5(1)ES1 en latere releases).

(In oudere releases hebben we de cc_username en tokens opgeslagen in sessiecookies en het is nog steeds hetzelfde met de eigen Finesse Desktop)

Voorbeeld:

https://<fqdn>:845/desktop/sso/token?cc_username=<agentid>&return_refresh_token=true

Hierdoor wordt u doorgestuurd naar de pagina AD FS (IdP)

Na succesvolle verificatie van ADFS wordt u rechtstreeks naar het token doorgestuurd.

U kunt dit token gebruiken om aanvragen naar Finesse te sturen voor de gebruiker als Bearer-token.

Gebruik de autorisatiekop als drager <access token>in uw aangepaste code.

Deze steekproef gebruikt de Postman-client.

Wanneer het verzoek met Access Token wordt verzonden, krijgt u het antwoord met 200OK en de bijbehorende uitvoer. Deze afbeelding laat zien dat de huidige status is opgehaald.

Op dezelfde manier kan het token worden gebruikt voor State Change API's om Agent Klaar te maken, Niet Klaar, Uitloggen, etc, en voor Dialoogvenster API's voor antwoorden, Make Call, etc in de aangepaste client.

Refresh Access Token

Een toegangsteken heeft een vervaltijd. U moet deze token opnieuw genereren voordat deze verloopt.

In de aanbeveling staat:

• Toepassingen van derden moeten het toegangsteken vernieuwen nadat 75% van de wachttijd is verstreken.
• Als u deze API aanhaalt, wordt de browser mogelijk doorgestuurd naar Cisco Identity Server en Cisco Identity Provider.

U kunt het toegangstoken als volgt wijzigen: https://<fqdn>:845/desktop/sso/token?cc_username=<agentid>&refresh-token=<refresh-token-value>

U ontvangt het nieuwe toegangstoken zoals in de afbeelding.

U kunt dit nieuwe token nu ook gebruiken als toegangsteken om een aanvraag naar de Finesse-server te sturen.