管理與 Okta 的聯合

Okta只是可用於NiCE CXone的支援外部身分識別提供者 (IdP) 之一。 本頁將逐步指導您使用 NiCE CXone 為 Okta 系統設定驗證。

如果您正在為您的NiCE CXone系統進行初次實作,還需考慮完成其他步驟。 我們建議您閱讀以下線上說明頁面,其中包含這些注意事項:

管理Okta與SAML 2.0的聯合

本頁將逐步指導您使用 NiCE CXone 作為外部身分識別提供者 (IdP) 為 Onelogin 系統設定驗證。

按照給定的順序完成每一個任務。

在開始之前,請確保您可以存取 Okta。 您將需要建立應用程式。

設定轉接狀態值

在下一個工作中設定 SAML Okta 應用程式時,需要使用轉送狀態值。請使用與您的環境對應的值。

依環境劃分的 Relay State 值

以下表格列出目前支援的環境:

環境 中繼狀態值
生產 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
FedRAMP {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
AUSOV1 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
EUSOV1 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
UKSOV1 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
UKSOV2 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}

雖然 Relay State 值目前在所有環境中都相同,但每個環境皆有其獨有的客戶 ID。未來的環境可能會使用不同的值。請務必使用為您的環境所列出的值,以確保向前相容性。

  1. 識別您組織所使用的環境。

  2. 從表格中複製相應的 Relay State 值。

  3. 在下一個工作中設定 SAML Okta 應用程式時,請使用此值。

Create and Configure an Okta Application with SAML 2.0

  1. 登入 Okta 管理帳戶。
  2. 按一下應用程式選單 > Create App Integration。
  3. 選擇 SAML 2.0 作為方法,並且點擊下一步。
  4. 輸入您想用來識別這個整合的名稱,然後點擊下一步。
  5.  Configure SAML:
    1. 在Single sign-on URL欄位中,Enter一個類似https://need_to_change的預留位置URL。您將從您的NiCE CXone登入驗證器,在稍後的步驟中取得實際的Assertion Consumer Service(ACS)URI。
    2. 選取 將此用於接收者 URL 及目標 URL。
    3. Enter a placeholder URL like https://need_to_change in the Audience URI (SP Entity ID)。在稍後的步驟中,您將以NiCE CXone登入驗證器的實體 ID 取代該預留位置。
    4. 請輸入您在上一步驟中生成的Default Relay State值。
    5. 指定Name ID format及Application username,以配合您想要向NiCE CXone識別使用者的方式。選擇要用作 name ID 的屬性,例如Okta使用者名稱或電郵地址。您在此處的選擇,決定您在各NiCE CXone使用者的員工設定檔中「外部 ID」欄位所使用的內容,而此設定您可在稍後的步驟中進行設定。
    6. 按一下顯示進階設定。
    7. 簽署演算法。建議使用RSA_SHA256。

    8. 將Assertion Signature變更為Unsigned。 將回應保留位已簽名。
    9. 確保判斷提示加密為未加密。
  6. 點擊下一步,完成回饋,然後點擊「回饋」標籤上的完成。
  7. Click View SAML setup instructions to open a new tab, then:
    1. 按一下 下載證書 以下載簽署證書。 為您的 NiCE CXone 配置保留此檔案。
    2. 關閉「SAML 設定指引」分頁。 讓「配置 SAML」標籤保持打開狀態。 您將根據在後面步驟中取得的NiCE CXone設定,對您的配置進行變更。

設定位置

所需權限:位置管理 建立

如果您想要求使用者從特定 IP 位址登入,請用您允許的 IP 位址、IP 位址範圍或 IP 位址子網路建立一個位置。 當您需要為使用者配置位置時,該使用者必須擁有正確的認證和 IP 位址才能登入。 否則,他們的登入嘗試將會失敗並收到錯誤訊息。 您一次最多可以有 20 個位置,每個位置最多 10 個規則。

  1. 按一下應用程式選擇器 icon of app selector 並選取Admin。
  2. 前往 位置 > 位置定義。
  3. 點擊新位置。
  4. 為位置提供描述性名稱。 如果要新增有關位置的更多詳細資訊,請輸入說明。
  5. 您可以選擇設定為預設位置或遠端位置以指示位置類型。 您只能有一個預設位置。 這些欄位目前不會影響任何功能,選擇它們僅供您自己參考。
  6. 使用其餘欄位新增您想要的任何其他資訊,包括實際地址、國家/地區、GPS 座標、時區或指派的群組。 這些欄位目前不會有任何影響,其中輸入的資訊僅供您參考。

    如果您在指派的群組欄位中新增組,則屬於該些群組的使用者會顯示在「已獲指派使用者」分頁上。 但是,不對其套用位置設定。 如果您為登入驗證器指派位置,則該位置套用於被指派到該登入驗證器的使用者,並根據其 IP 位址限制其登入能力。 但是,這些使用者不會出現在「已指派使用者」標籤上。

  7. 按一下位於位置名稱欄位旁的部門下拉式選單。

  8. 在位置定義頁上,選擇部門篩選器,以僅檢視指派至該部門的位置。清除篩選器可再次檢視所有位置。

    您只可將位置從預設部門移動至特定部門一次。將位置指派至某個部門並儲存後,便不能再移動至其他部門。如該位置已從預設部門移動,此下拉式選單將會停用,無法修改。

  9. 點擊儲存。

  10. 返回位置定義頁後,按一下您剛建立的位置以開啟它。

  11. 按一下自動偵測規則標籤。

  12. 建立新規則。 為此:

    1. 點擊新建規則。

    2. 為規則提供描述性名稱。

    3. 從下列選項中選擇規則類型:

      • 列表:該位置允許使用的特定 IP 位址的清單。 例如,100.0.1.100、100.0.1.101 與 100.0.1.102。

      • 範圍:此位置允許的 IP 位址範圍。 例如,100.0.1.100-100.0.1.125。

      • 子網路:此位置允許的子網路。 例如,100.0.0.1/32。

    4. 將 IP 版本指定為以下之一:

      • IPV4:32 位元 IP 位址

      • IPV6:128 位元十六進位位址。

    5. 在規則定義欄位輸入實際 IP 位址、範圍或子網路,採用前面步驟中範例的格式。 如果您選擇了清單,則最多可以輸入 100 個 IP 位址。 如果選擇了範圍或子網路,則只能輸入一個值。

    6. 點擊確認。

  13. 根據需要新增更多規則。 您最多可以有 10 個規則。

  14. 點擊儲存。

透過 SAML 2.0 設定 NiCE CXone 登入驗證器

必填權限:登入驗證器建立

  1. 按一下應用程式選擇器 icon of app selector 並選取管理。
  2. 按一下 安全性 > 登入驗證器。
  3. 點擊新建登入認證器。
  4. 輸入登入認證器的名稱和描述。 描述請僅使用純文字。 URL 或標記(例如 html)將不會被儲存。
  5. 選擇 SAML 作為 驗證類型。
  6. 如果您希望要求使用者從某個 IP 位址登入,請選擇您在上一部分中設定的位置。

  7. 點擊選擇檔案,然後選擇您在上一個任務中從 Okta 下載的公共簽署憑證。 該憑證必須是 PEM 檔案。 這將是一個文字檔案,第一行將包含 BEGIN CERTIFICATE 與一些額外文字。
  8. 選擇已指派的使用者標籤。 選擇要指派給正在建立的登入身份驗證器的使用者。 您也可以在 員工設定檔中直接將使用者指派給登入驗證器。

  9. 點擊儲存並啟用。
  10. 開啟登入驗證器。
  11. 您會留意到另外顯示了兩個唯讀欄位:實體 ID及ACS URL。 記錄這些值。 您將在新增NiCE CXone值至Okta工作中需要它們。

配置 NiCE CXone 使用者

在 NiCE CXone 中為所有需要透過 Okta 進行單一登入的 NiCE CXone 使用者完成此作業。您亦可使用批量上載範本完成此步驟。

  1. 在NiCE CXone中,按一下應用程式選取器Icon of three-by-three grid of white squares on a blue background,然後選取 管理。

  2. 點擊員工。

  3. 選取要修改的員工設定檔,然後按一下 Edit。

  4. 如果您尚未執行此操作,請前往「安全性」分頁,然後選取您先前建立的登入驗證器。

  5. 請確保外部身份 已設定為正確的值。該值必須與Okta中的唯一使用者識別碼完全相符。

  6. 儲存您的變更。

新增NiCE CXone值至Okta

  1. 回到您的Okta應用程式,進入「常規」標籤。
  2. 在「SAML 設定」視窗點擊編輯,然後點擊下一步。
  3. 對於單一登入 URL,輸入 登入驗證器中的 ACS URLNiCE CXone 值。
  4. 對於受眾 URI(SP 實體 ID),請在您的NiCE CXone登入驗證器中輸入實體 ID的值。
  5. 點擊下一步,然後點擊完成來完成變更。

測試 SAML 整合

在NiCE CXone中將 SAML 登入驗證器指派給使用者之前,您應測試 SAML 整合。如果測試失敗,請審視您的配置並對設定進行變更。

  1. 從 Okta 儀表板啟動登入。
  2. 驗證 SAML 驗證流程是否如您所預期般運作。

使用 Okta 單一登入確認使用者存取

  1. 請一位或多位測試使用者使用最新的登入 URL(https://cxone.niceincontact.com)登入。 對於 FedRAMP,使用 https://cxone-gov.niceincontact.com。 輸入他們的使用者名稱後,如果需要,會將他們將引導到 Okta。

  2. 準備就緒後,向所有員工推出 Okta 單一登入。

這是管理與 SAML 2.0 之聯合的最後一個步驟。

使用 OpenID Connect 管理與 Okta 的聯盟

按照給定的順序完成每一個任務。

設定具有 OpenID Connect 的 Okta 應用程式

  1. 登入 Okta 管理帳戶。
  2. 按一下應用程式選單 > Create App Integration。
  3. 選取OIDC - OpenID Connect作為Sign-in method。
  4. 選擇Web 應用程式作為應用程式類型,然後點擊下一步。
  5. 在應用程式整合名稱欄位中,輸入您要用於識別此整合的名稱。
  6. 您需要提供一個登入重新導向 URI,而此時您尚未得知此項資訊。 將 https://cxone.niceincontact.com/need_to_change 預留位置。 您將把這個值變更為以後收到的 URI。
  7. 您或許需要提供一個登出重新導向 URI,而您目前尚不知道這個 URI。 將 https://cxone.niceincontact.com/need_to_change 預留位置。 您將把這個值變更為以後收到的 URI。
  8. 在受控存取下拉清單中,選擇立即跳過群組指派。
  9. 點擊儲存。
  10. 在一般標籤上的用戶端憑證下,選擇用戶端驗證。
  11. Select one of the following authentication methods:
    1. client_secret_basic: client credentials are passed in a basic header during authentication. After selecting this method, configure the following:
      1. 選擇用戶端驗證為用戶端密碼。
      2. 複製用戶端 ID 和用戶端秘密並將其貼上到裝置上的安全位置。 當您在NiCE CXone中配置登入驗證器時,您將需要使用它們。
    2. client_secret_post: client credentials are passed in a body during authentication. After selecting this method, configure the following:
      1. 選擇用戶端驗證為用戶端密碼。
      2. 複製用戶端 ID 和用戶端秘密並將其貼上到裝置上的安全位置。 當您在NiCE CXone中配置登入驗證器時,您將需要使用它們。
    3. client_secret_jwt: JWT bearer tokens are used for client authentication. After selecting this method, configure the following:
      1. 選擇用戶端驗證作為用戶端密碼。
      2. 複製用戶端 ID 和用戶端秘密並將其貼上到裝置上的安全位置。 當您在NiCE CXone中配置登入驗證器時,您將需要使用它們。
    4. private_key_jwt: JWT bearer tokens are used for client authentication. The JWT is signed by the Client Private Key that you will provide in later steps. After selecting this method, configure the following:
      1. 選取用戶端驗證作為公共金鑰/私人金鑰。
      2. 在新增公共金鑰欄位中,Enter一個預留位置公共金鑰。配置登入驗證器時,您需要將此預留位置替換為NiCE CXone提供的金鑰。
  12. 在「指派」標籤上,點擊指派,然後點擊指派給人員。
  13. 將使用者指派給該應用程式。

設定位置

所需權限:位置管理 建立

如果您想要求使用者從特定 IP 位址登入,請用您允許的 IP 位址、IP 位址範圍或 IP 位址子網路建立一個位置。 當您需要為使用者配置位置時,該使用者必須擁有正確的認證和 IP 位址才能登入。 否則,他們的登入嘗試將會失敗並收到錯誤訊息。 您一次最多可以有 20 個位置,每個位置最多 10 個規則。

  1. 按一下應用程式選擇器 icon of app selector 並選取Admin。
  2. 前往 位置 > 位置定義。
  3. 點擊新位置。
  4. 為位置提供描述性名稱。 如果要新增有關位置的更多詳細資訊,請輸入說明。
  5. 您可以選擇設定為預設位置或遠端位置以指示位置類型。 您只能有一個預設位置。 這些欄位目前不會影響任何功能,選擇它們僅供您自己參考。
  6. 使用其餘欄位新增您想要的任何其他資訊,包括實際地址、國家/地區、GPS 座標、時區或指派的群組。 這些欄位目前不會有任何影響,其中輸入的資訊僅供您參考。

    如果您在指派的群組欄位中新增組,則屬於該些群組的使用者會顯示在「已獲指派使用者」分頁上。 但是,不對其套用位置設定。 如果您為登入驗證器指派位置,則該位置套用於被指派到該登入驗證器的使用者,並根據其 IP 位址限制其登入能力。 但是,這些使用者不會出現在「已指派使用者」標籤上。

  7. 按一下位於位置名稱欄位旁的部門下拉式選單。

  8. 在位置定義頁上,選擇部門篩選器,以僅檢視指派至該部門的位置。清除篩選器可再次檢視所有位置。

    您只可將位置從預設部門移動至特定部門一次。將位置指派至某個部門並儲存後,便不能再移動至其他部門。如該位置已從預設部門移動,此下拉式選單將會停用,無法修改。

  9. 點擊儲存。

  10. 返回位置定義頁後,按一下您剛建立的位置以開啟它。

  11. 按一下自動偵測規則標籤。

  12. 建立新規則。 為此:

    1. 點擊新建規則。

    2. 為規則提供描述性名稱。

    3. 從下列選項中選擇規則類型:

      • 列表:該位置允許使用的特定 IP 位址的清單。 例如,100.0.1.100、100.0.1.101 與 100.0.1.102。

      • 範圍:此位置允許的 IP 位址範圍。 例如,100.0.1.100-100.0.1.125。

      • 子網路:此位置允許的子網路。 例如,100.0.0.1/32。

    4. 將 IP 版本指定為以下之一:

      • IPV4:32 位元 IP 位址

      • IPV6:128 位元十六進位位址。

    5. 在規則定義欄位輸入實際 IP 位址、範圍或子網路,採用前面步驟中範例的格式。 如果您選擇了清單,則最多可以輸入 100 個 IP 位址。 如果選擇了範圍或子網路,則只能輸入一個值。

    6. 點擊確認。

  13. 根據需要新增更多規則。 您最多可以有 10 個規則。

  14. 點擊儲存。

在 NiCE CXone 中使用 OpenID Connect 設定登入驗證器

  1. 按一下應用程式選擇器 icon of app selector 並選取Admin

  2. 前往「安全性設定」>「登入驗證器」。

  3. 按一下新增登入驗證器,或選取您要編輯的登入驗證器。
  4. 輸入登入驗證器的 名稱和描述。
  5. 選擇 OIDC 作為 驗證類型。
  6. 如果您希望要求使用者從某個 IP 位址登入,請選擇您在上一部分中設定的位置。

  7. 如果您有來自 Okta 的發現端點,請點擊 發現設定。 輸入您的發現端點並點擊發現。 發現設定不適用於Salesforce發現端點。 其餘欄位已為您填入。
  8. 輸入您的用戶端識別元和用戶端密碼。 在Client Confirm Password中重新輸入密碼。 用戶端識別碼是Okta指派給您的帳戶的登入 ID。
  9. 如果您沒有 Okta 的發現端點,請輸入 Okta 提供的簽發者、JsonWebKeySet 端點、授權端點、權杖端點、UserInfo 端點和撤銷端點。

  10. 選擇 用戶端驗證方法。 您選擇的方法必須與您在上一個任務中設定的方法相符。 此方法必須是Okta支援的驗證方法。 若您選取private_key_jwt,則必須輸入您的Client Private Key。
  11. 您可以選擇啟用 FICAM 設定檔以開啟美國政府特定的設定。 此步驟僅適用於 FedRAMP 使用者。
  12. 選擇已指派的使用者標籤。 選擇要指派給正在建立的登入身份驗證器的使用者。 您也可以在 員工設定檔中直接將使用者指派給登入驗證器。

  13. 按一下儲存並啟用以驗證所提供的資訊,並將您的NiCE CXone帳戶連結至您的Okta帳戶。
  14. 開啟登入驗證器。
  15. 請注意登入重定向 URI和登出重定向 URI。 您將需要這些網址來更新您的Okta設定。

  16. 更新您的Okta設定,將上一個任務中使用的佔位符替換為您剛剛記下的值。

  17. 確保每個使用登入驗證器的使用者的NiCE CXone外部身份設定為正確的值。 此欄位可於員工設定檔的安全性部分中存取。

    Okta確定必須使用的值。 它可以在Okta中的使用者設定檔中找到。 該值必須與您在 中的外部身份NiCE CXone欄位中輸入的值的完全匹配。 此欄位的值必須為以下格式:claim(email):{由您的 IdP 配置的電郵}。 例如,如果 IdP 中使用者的電郵是 nick.carraway@classics.com,則應輸入 claim(email):nickcarraway@classics.com。

  18. 讓使用者登入NiCE CXone。 他們必須使用最新的登入 URL。 輸入他們的使用者名稱後,如果需要,會將他們將引導到 Okta。

  19. 當Okta要求您驗證自己的帳戶時,請以您希望與目前登入的 NiCE CXone 帳戶關聯的使用者身分進行驗證。
  20. 如果您在 NiCE CXone 的 OpenID Connect 設定未顯示為已驗證,請使用 Okta 的日誌診斷問題。

新增 NiCE CXone 值到 Okta

  1. 回到您的Okta應用程式,進入「常規」標籤。
  2. 在「SAML 設定」視窗點擊編輯,然後點擊下一步。
  3. 對於單一登入 URL,輸入 登入驗證器中的 ACS URLNiCE CXone 值。
  4. 對於受眾 URI(SP 實體 ID),enter 來自您的NiCE CXone登入驗證器的實體 ID值。
  5. 點擊下一步,然後點擊完成來完成變更。

使用 Okta 單一登入確認使用者存取

  1. 確保每位使用登入驗證器的員工的外部身份已設定為正確的值。 該值必須與 NiCE CXone 中的 External Identity 完全相符。 外部身份欄位區分大小寫。

  2. 請一位或多位測試使用者使用最新的登入 URL 登入,即 https://cxone.niceincontact.com。 對於 FedRAMP,使用 https://cxone-gov.niceincontact.com。 輸入他們的使用者名稱後,如果需要,會將他們將引導到 Okta。

  3. 準備就緒後,向所有員工推出 Okta 單一登入。