管理與 Azure 的聯合
Azure只是可用於NiCE CXone的支援外部身分識別提供者 (IdP) 之一。 本頁將逐步指導您使用 NiCE CXone 為 Azure 系統設定驗證。
如果您正在為您的NiCE CXone系統進行初次實作,還需考慮完成其他步驟。 建議您閱讀以下線上說明頁面,其中包含了這些注意事項:
Microsoft Azure ID 管理主控台。在開始之前,請確保您有該主控台的存取權。 您將需要建立應用程式。
管理 Azure 與SAML 2.0的聯合
按照給定的順序完成每一個任務。
設定轉送狀態值
在下一個工作中設定 SAML Okta 應用程式時,需要提供轉送狀態值。請使用與您的環境相對應的值。
依環境劃分的 Relay State 值
以下表格列出目前支援的環境:
| 環境 | 中繼狀態值 |
|---|---|
| 生產 | eyJjbGllbnRJZCI6IjBiNjk3ZWJiLTRlYTItNDA1Mi1iMTJiLWQzY2YxMmE1M2VjYSJ9 |
| FedRAMP | eyJjbGllbnRJZCI6IjBiNjk3ZWJiLTRlYTItNDA1Mi1iMTJiLWQzY2YxMmE1M2VjYSJ9 |
| 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。未來的環境可能會使用不同的值。請務必使用為您的環境所列出的值,以確保日後的相容性。
建立及設定具有SAML 2.0的Azure應用程式
- 使用您的 Azure AD 管理員帳戶登入您的 Azure AD 管理帳戶。
- Create an application:
- 按一下 企業應用程式 > New Application。
- 點擊建立自己的應用程式。
- Enter 名稱(例如 NiCE CXone)。
- 選擇整合未在圖庫中找到的任何其他應用程式(非圖庫)。
- 點擊建立。
- 請視需要將使用者和群組指派至應用程式。前往「使用者和群組」分頁,並按一下新增使用者/群組。
- 在應用程式的管理頁中,找到管理部分。 在設定單一登入下,點擊開始,然後選擇 SAML。
- On the Basic SAML Configuration panel, click Edit and configure SAML:
- 點擊保存並關閉「基本 SAML 配置」面板。
- 在Attributes & Claims部分中,選取正確的Unique User Identifier。您所選擇的值將會是NiCE CXone中的外部身份。
- Azure AD 應該自動建立 SAML 簽署憑證。 下載名為 Certificate (Base64) 的憑證。 您將在稍後的步驟中,將此憑證上傳至NiCE CXone的登入驗證器。
- On the SAML Signing Certificate panel, click Edit and then:
- Choose a 選項。
- 按一下儲存並關閉 SAML 簽署證書面板。請保留此檔案,以便在後續步驟中用於您的 NiCE CXone 設定。
- 如果您想啟用SP啟動的登入,請完成此步驟。 在設定 <應用程式名稱> 部分中,複製 登入 URL 值。 為您的 NiCE CXone 配置保留此值。
- 保留您的視窗開啟狀態。 您將根據下一個任務中收到的值對 Azure 應用程式設定進行變更。
設定位置
所需權限:位置管理 建立
如果您想要求使用者從特定 IP 位址登入,請用您允許的 IP 位址、IP 位址範圍或 IP 位址子網路建立一個位置。 當您需要為使用者配置位置時,該使用者必須擁有正確的認證和 IP 位址才能登入。 否則,他們的登入嘗試將會失敗並收到錯誤訊息。 您一次最多可以有 20 個位置,每個位置最多 10 個規則。
- 按一下應用程式選擇器
並選取Admin。 - 前往 位置 > 位置定義。
- 點擊新位置。
- 為位置提供描述性名稱。 如果要新增有關位置的更多詳細資訊,請輸入說明。
- 您可以選擇設定為預設位置或遠端位置以指示位置類型。 您只能有一個預設位置。 這些欄位目前不會影響任何功能,選擇它們僅供您自己參考。
-
使用其餘欄位新增您想要的任何其他資訊,包括實際地址、國家/地區、GPS 座標、時區或指派的群組。 這些欄位目前不會有任何影響,其中輸入的資訊僅供您參考。
如果您在指派的群組欄位中新增組,則屬於該些群組的使用者會顯示在「已獲指派使用者」分頁上。 但是,不對其套用位置設定。 如果您為登入驗證器指派位置,則該位置套用於被指派到該登入驗證器的使用者,並根據其 IP 位址限制其登入能力。 但是,這些使用者不會出現在「已指派使用者」標籤上。
-
按一下位於位置名稱欄位旁的部門下拉式選單。
-
在位置定義頁上,選擇部門篩選器,以僅檢視指派至該部門的位置。清除篩選器可再次檢視所有位置。
您只可將位置從預設部門移動至特定部門一次。將位置指派至某個部門並儲存後,便不能再移動至其他部門。如該位置已從預設部門移動,此下拉式選單將會停用,無法修改。
-
點擊儲存。
-
返回位置定義頁後,按一下您剛建立的位置以開啟它。
-
按一下自動偵測規則標籤。
-
建立新規則。 為此:
-
點擊新建規則。
-
為規則提供描述性名稱。
-
從下列選項中選擇規則類型:
-
列表:該位置允許使用的特定 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。
-
-
將 IP 版本指定為以下之一:
-
IPV4:32 位元 IP 位址
-
IPV6:128 位元十六進位位址。
-
-
在規則定義欄位輸入實際 IP 位址、範圍或子網路,採用前面步驟中範例的格式。 如果您選擇了清單,則最多可以輸入 100 個 IP 位址。 如果選擇了範圍或子網路,則只能輸入一個值。
-
點擊確認。
-
-
根據需要新增更多規則。 您最多可以有 10 個規則。
-
點擊儲存。
透過 SAML 2.0 在 NiCE CXone 中設定登入驗證器
必要權限:建立登入驗證器
- 按一下應用程式選擇器
並選取管理。 - 前往安全性設定 > 登入驗證器。
- 點擊新建登入認證器。
- 輸入登入認證器的名稱和描述。 說明部分請僅使用純文字。 URL 或 html 等標記將不會被儲存。
- 選擇 SAML 作為認證類型。
-
如果您希望要求使用者從某個 IP 位址登入,請選擇您在上一部分中設定的位置。
- 點擊選擇檔案,然後選擇您在上一個任務中從 Azure 下載的公共簽署憑證。 該檔案必須採用 PEM 檔案。 這將是一個文字檔案,第一行將包含 BEGIN CERTIFICATE 與一些額外文字。
-
```
選擇已指派的使用者標籤。 選擇要指派給正在建立的登入身份驗證器的使用者。 您也可以在 員工設定檔中直接將使用者指派給登入驗證器。
``` - 按一下Save & Activate。
- 開啟登入驗證器。
-
您會注意到有兩個額外的唯讀欄位顯示出來,即實體 Id及ACS URL。 記錄這些值。 您在將NiCE CXone值新增至Azure工作中將需要這些資料。
Configure NiCE CXone Users
為所有需要透過 Azure 進行單一登入的 NiCE CXone 使用者,在 NiCE CXone 中完成此作業。您亦可使用批量上載範本完成此步驟。
-
在NiCE CXone中,按一下應用程式選取器
,然後選取 管理。 -
點擊員工。
-
select the employee profile to modify and click Edit. 選取要修改的員工設定檔,然後按一下Edit。
-
如果您尚未執行此操作,請前往「安全性」分頁,然後選擇您先前建立的登入驗證器。
-
請確保 外部身份 設定為正確的值。該值必須與 Azure 中的 Unique User Identifier 完全相符。如果電郵 ID 已配置為外部 ID,請確保將其格式設定正確。在 Azure 中,電郵 ID 格式為 firstname.lastname@domain.com,並區分大小寫。
-
儲存您的變更。
將 NiCE CXone 值新增至 Azure
- 回到 Azure 應用程式,並在「基本 SAML 配置」面板上,點擊編輯。
- 對於識別碼(實體 ID),請輸入您的 NiCE CXone 登入驗證器中的實體 ID 值。
- 對於「回覆 URL」,請輸入來自您的 NiCE CXone 登入驗證器的 ACS URL 值。
- 點擊保存並關閉「基本 SAML 配置」面板。
測試 SAML 整合
在NiCE CXone中將SAML登入驗證器指派給使用者之前,您應該測試SAML整合。如果測試失敗,請審視您的配置並對設定進行變更。
- 從 Azure 儀表板啟動登入。
- 確認 SAML 驗證流量能按您的預期運作。
使用 Azure 單一登入確認使用者存取
-
讓一位或多位測試使用者使用最新的登入 URL 登入。 輸入他們的使用者名稱後,如果需要,會將他們將引導到 Azure。
-
準備就緒後,向所有員工推出 Azure 單一登入。
這是使用 SAML 2.0 設定聯盟(Federation)的最後一個步驟。
Manage Federation with Azure with OpenID Connect
按照給定的順序完成每一個任務。
使用 OpenID Connect 配置 Azure 應用程式
-
登入 Azure 管理帳戶。
-
在應用程式註冊下,點擊新註冊。
-
前往 驗證 > Web。
-
您將需要提供Redirect URIs,但您目前並不知道這些資訊。 將 https://cxone.niceincontact.com/need_to_change 預留位置。
-
點擊憑證和秘密。
-
選擇client_secret_basic或client_secret_post作為您的驗證方法。 The authentication method, private_key_jwt, is not currently supported in NiCE CXone.
-
在用戶端秘密欄位中,選擇新用戶端秘密。
-
新增說明並選擇過期。
-
複製用戶端 ID 和用戶端秘密並將其貼上到裝置上的安全位置。 當您在NiCE CXone中配置登入驗證器時,您將需要使用它們。
-
前往 權杖配置 > 可选宣告。
-
按一下新增可選聲明。
-
選擇 ID 作為您的權杖類型。
-
選擇電郵並新增您的電郵地址。
-
點擊儲存。
設定位置
所需權限:位置管理 建立
如果您想要求使用者從特定 IP 位址登入,請用您允許的 IP 位址、IP 位址範圍或 IP 位址子網路建立一個位置。 當您需要為使用者配置位置時,該使用者必須擁有正確的認證和 IP 位址才能登入。 否則,他們的登入嘗試將會失敗並收到錯誤訊息。 您一次最多可以有 20 個位置,每個位置最多 10 個規則。
- 按一下應用程式選擇器
並選取Admin。 - 前往 位置 > 位置定義。
- 點擊新位置。
- 為位置提供描述性名稱。 如果要新增有關位置的更多詳細資訊,請輸入說明。
- 您可以選擇設定為預設位置或遠端位置以指示位置類型。 您只能有一個預設位置。 這些欄位目前不會影響任何功能,選擇它們僅供您自己參考。
-
使用其餘欄位新增您想要的任何其他資訊,包括實際地址、國家/地區、GPS 座標、時區或指派的群組。 這些欄位目前不會有任何影響,其中輸入的資訊僅供您參考。
如果您在指派的群組欄位中新增組,則屬於該些群組的使用者會顯示在「已獲指派使用者」分頁上。 但是,不對其套用位置設定。 如果您為登入驗證器指派位置,則該位置套用於被指派到該登入驗證器的使用者,並根據其 IP 位址限制其登入能力。 但是,這些使用者不會出現在「已指派使用者」標籤上。
-
按一下位於位置名稱欄位旁的部門下拉式選單。
-
在位置定義頁上,選擇部門篩選器,以僅檢視指派至該部門的位置。清除篩選器可再次檢視所有位置。
您只可將位置從預設部門移動至特定部門一次。將位置指派至某個部門並儲存後,便不能再移動至其他部門。如該位置已從預設部門移動,此下拉式選單將會停用,無法修改。
-
點擊儲存。
-
返回位置定義頁後,按一下您剛建立的位置以開啟它。
-
按一下自動偵測規則標籤。
-
建立新規則。 為此:
-
點擊新建規則。
-
為規則提供描述性名稱。
-
從下列選項中選擇規則類型:
-
列表:該位置允許使用的特定 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。
-
-
將 IP 版本指定為以下之一:
-
IPV4:32 位元 IP 位址
-
IPV6:128 位元十六進位位址。
-
-
在規則定義欄位輸入實際 IP 位址、範圍或子網路,採用前面步驟中範例的格式。 如果您選擇了清單,則最多可以輸入 100 個 IP 位址。 如果選擇了範圍或子網路,則只能輸入一個值。
-
點擊確認。
-
-
根據需要新增更多規則。 您最多可以有 10 個規則。
-
點擊儲存。
設定具有 OpenID Connect 的 NiCE CXone 登入驗證器
-
按一下應用程式選擇器
並選取Admin。 -
前往安全性設定 > 登入驗證器。
- 按一下新增登入驗證器,或選取您要編輯的登入驗證器。
- 輸入登入驗證器的 名稱和描述。
- 選擇 OIDC 作為 驗證類型。
-
如果您希望要求使用者從某個 IP 位址登入,請選擇您在上一部分中設定的位置。
- 如果您有來自 Azure 的發現端點,請點擊 發現設定。 輸入您的發現端點並點擊發現。 其餘欄位會自動為您填入。發現設定不適用於Salesforce發現端點。
- 輸入您的用戶端識別元和用戶端密碼。 在Client Confirm Password中重新輸入密碼。 用戶端識別碼是Azure指派給您的帳戶的登入 ID。
-
如果您沒有 Azure 的發現端點,請輸入 Azure 提供的簽發者、JsonWebKeySet 端點、授權端點、權杖端點、UserInfo 端點、撤銷端點和結束會話端點。
了解更多此步驟中的欄位相關資訊
欄位
詳細資料
簽發者 Azure 的 URL,不含任何參數。
JsonWebKeySet 端點 Azure 的 JWK 集的 URL。 授權端點 Azure 的 OAuth2.0 授權端點的 URL。 權杖端點 Azure 的 OAuth2.0 權杖端點的 URL。 UserInfo 端點 Azure 的 UserInfo 端點的 URL。 撤銷端點 Azure 的撤銷端點的 URL。 結束工作階段終點 Azure 的結束會話端點的 URL。 此欄位可讓您為使用者建立單一登出體驗。 如果配置,當使用者登出NiCE CXone 時,使用者也將登出其 Azure 帳戶。 若要讓單一登出正常使用,您必須將 Azure 中的登出重定向 URI 列入白名單。
如果 Salesforce 是您的 IdP,則您需要在 Salesforce 中設定登出 URL。 若要執行此操作,請前往設定 > 安全性 > Session Settings > 登出頁設定。 更新登出 URL 欄位。 您將使用此 URL 作為您的結束會話端點。
- 選擇 用戶端驗證方法。 您選擇的方法必須與您在上一個任務中設定的方法相符。 此方法必須是Azure支援的驗證方法。
- 您可以選擇啟用 FICAM 設定檔以開啟美國政府特定的設定。 此步驟僅適用於 FedRAMP 使用者。
-
選擇已指派的使用者標籤。 選擇要指派給正在建立的登入身份驗證器的使用者。 您也可以在 員工設定檔中直接將使用者指派給登入驗證器。
- 按一下 儲存並啟用,以驗證所提供的資訊,並將您的NiCE CXone帳戶連結至您的Azure帳戶。
- 開啟登入驗證器。
-
請注意登入重定向 URI和登出重定向 URI。 當您更新 Azure 設定時,您將需要這些網址。
-
更新您的Azure設定,將上一個任務中使用的佔位符替換為您剛剛記下的值。
-
確保每個使用登入驗證器的使用者的NiCE CXone外部身份設定為正確的值。 此欄位可於員工設定檔的安全性部分中存取。
Azure確定必須使用的值。 它可以在Azure中的使用者設定檔中找到。 該值必須與您在 中的外部身份NiCE CXone欄位中輸入的值的完全匹配。 此欄位的值必須為以下格式:claim(email):{由您的 IdP 配置的電郵}。 例如,如果 IdP 中使用者的電郵是 nick.carraway@classics.com,則應輸入 claim(email):nickcarraway@classics.com。
-
讓使用者登入NiCE CXone。 他們必須使用最新的登入 URL。 輸入他們的使用者名稱後,如果需要,會將他們將引導到 Azure。
- 當Azure要求您驗證自己的帳戶時,請以您希望與目前登入的Azure帳戶關聯的NiCE CXone中使用者身分進行驗證。
- 如果您在NiCE CXone中的OpenID Connect設定未顯示為已驗證,請使用Azure的日誌來診斷問題。
新增 NiCE CXone 值到 Azure
- 回到 Azure 應用程式,並在「基本 SAML 配置」面板上,點擊編輯。
- 對於識別碼(實體識別碼),請輸入來自 NiCE CXone 登入驗證器的實體識別碼值。
- Reply URL中,請Enter來自您NiCE CXone登入驗證器的ACS URL值。
- 點擊保存並關閉「基本 SAML 配置」面板。
-
確保每個使用登入驗證器的使用者的外部身份設定為正確的值。
-
您的身分識別提供者會決定必須使用的值。 該值必須與 中的唯一使用者識別碼Azure和 中的外部身份NiCE CXone完全一致。
-
-
讓使用者登入。 他們必須使用最新的登入 URL。 輸入他們的使用者名稱後,如果需要,會將他們將引導到身分識別提供者。
使用 Azure 單一登入確認使用者存取
-
請確保使用登入驗證器的每位員工的外部身份均設定為正確的值。 該值必須與 中的唯一使用者識別碼Azure和 中的外部身份NiCE CXone完全一致。
-
讓一位或多位測試使用者使用最新的登入 URL 登入。 輸入他們的使用者名稱後,如果需要,會將他們將引導到 Azure。
-
準備就緒後,向所有員工推出 Azure 單一登入。