FinesseサードパーティクライアントとSSOの統合

はじめに

このドキュメントでは、Unified Contact Center Enterprise(UCCE)またはUnified Contact Center Express(UCCX)で、カスタムデスクトップクライアントをシングルサインオン(SSO)と統合する方法について説明します。 

SSOは、Finesseでネイティブに使用できます。これは、Cisco Unified Contact Centerの重要な機能の1つです。 SSOは、ユーザが1つのアプリケーションにサインインし、ユーザクレデンシャルを再入力せずに他の承認済みアプリケーションに安全にアクセスできるようにする認証プロセスです。SSOを使用すると、シスコのスーパーバイザとエージェントは、ユーザ名とパスワードを使用して1回だけサインインするだけで、1つのブラウザインスタンス内でブラウザベースのシスコのすべてのアプリケーションとサービスにアクセスできます。

前提条件

要件

このドキュメントの内容は、特定のソフトウェアやハードウェアのバージョンに限定されるものではありません。

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。

• Ciscoアイデンティティサーバ(Id)12.5
• Finesse 12.5(1)ES1 
• ADFS 2012
• UCCE 12.5

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

背景説明

カスタムクライアントとして、API要求をFinesseサーバに送信するには、要求が承認されている必要があります。SSOのコンテキストでは、この認可はトークンを使用して提供されるため、最初にトークンを理解します。

トークンには次の 2 種類があります。

• アクセストークン：保護されたリソースにアクセスします。クライアントには、ユーザのID情報を含むアクセストークンが発行されます。ID情報はデフォルトで暗号化されます。
• Refresh Token：現在のアクセストークンの有効期限が切れる前に、新しいアクセストークンを取得します。IdSは更新トークンを生成します。

リフレッシュトークンとアクセストークンは、トークンのペアとして生成されます。アクセストークンを更新すると、トークンのペアによってセキュリティの層が追加されます。

更新トークンとアクセストークンの有効期限は、IdS管理で構成できます。更新トークンの有効期限が切れると、アクセストークンを更新できません。

アクセストークンの取得

新しいFinesse API実装では、Finesse URLで2つのクエリパラメータcc_usernameとreturn_refresh_toeknを使用して、アクセストークンを取得できます。

(11.6.(1)ES10、12.0(1)ES3、12.5(1)ES1以降のリリースで使用可能)。

（以前のリリースでは、セッションCookieにcc_usernameとトークンを保存していました。これはネイティブのFinesseデスクトップでも同じです）

例：

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

これにより、AD FS (IdP)ページにリダイレクトされます

ADFSからの認証に成功すると、トークンに直接リダイレクトされます。

このトークンを使用して、Bearerトークンとしてユーザの要求をFinesseに送信できます。

カスタムコードでは、認証ヘッダーとしてBearer <access token>を使用してください。

このサンプルでは、Postmanクライアントを使用します。

要求がアクセストークンとともに送信されると、200OKと対応する出力を含む応答が得られます。次の図は、現在の状態がフェッチされたことを示しています。

同様に、トークンを状態変更APIに使用して、エージェントの準備、受信不可、ログアウトなどを行ったり、カスタムクライアントで応答、発信などのダイアログAPIに使用したりできます。

アクセストークンの更新

アクセストークンに有効期限があります。このトークンは、有効期限が切れる前に更新する必要があります。

推奨事項に従います。

• サードパーティ製アプリケーションでは、トークンの有効期限の75 %が経過した後にアクセストークンを更新する必要があります。
• このAPIの呼び出しには、Cisco Identity ServerおよびCisco Identity Providerへのブラウザリダイレクトが含まれる場合があります。

アクセストークンを更新するには、次のURLを使用します。https://<fqdn>:8445/desktop/sso/token?cc_username=<agentid>&refresh-token=<refresh-token-value>

次の図に示すように、新しいアクセストークンを受信します。

この新しいトークンをアクセストークンとして使用し、Finesseサーバに要求を送信できます。