單一登入功能與 Webex Control Hub

單一登入 (SSO) 是階段作業或使用者驗證程序,允許使用者提供認證來存取一或多個應用程式。 此程序會針對使用者取得權限的所有應用程式,進行使用者驗證。 如果使用者在特定階段作業期間切換應用程式,則此程序會消除進一步的提示。

「安全性聲明標記語言 (SAML 2.0) 同盟通訊協定」用於在 Cisco Webex 雲端和您的身分識別提供者 (IdP) 之間提供 SSO 驗證。

設定檔

Cisco Webex Teams 僅支援 Web 瀏覽器 SSO 設定檔。 在 Web 瀏覽器 SSO 設定檔中,Cisco Webex Teams 支援下列繫結:

  • SP 起始的 POST -> POST 連結

  • SP 起始的 REDIRECT -> POST 連結

NameID 格式

「SAML 2.0 通訊協定」支援特定使用者採用數種 NameID 格式進行通訊。 Cisco Webex Teams 支援下列 NameID 格式。

  • urn:oasis:names:tc:SAML:2.0:nameid-format:transient

  • urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified

  • urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

在您從 IdP 載入的中繼資料中,第一個項目已設定用於 Cisco Webex。

SingleLogout

Cisco Webex Teams 支援單一登出設定檔。 在 Cisco Webex Teams 應用程式中,使用者可以登出應用程式,這將使用「SAML 單一登出」通訊協定來結束階段作業並向您的 IdP 確認該登出。 請確保為 SingleLogout 設定了 IdP。

將 Cisco Webex Control Hub 與 ADFS 整合


該設定指南顯示 SSO 整合的特定範例,但不提供所有可能性的詳盡設定。 例如,會記錄 nameid-format urn:oasis:names:tc:SAML:2.0:nameid-format:transient 的整合步驟。 諸如 urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified 或 urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress 之類的其他格式將適用於 SSO 整合,但不在我們的文檔討論範圍之內。

為 Cisco Webex 組織(包括 Cisco Webex Teams、Cisco Webex Meetings 及在 Cisco Webex Control Hub 中管理的其他服務)中的使用者設定此整合。 如果 Webex 網站已整合在 Cisco Webex Control Hub 中,則 Webex 網站會繼承使用者管理。 如果您無法以此方式存取 Cisco Webex Meetings 且它未在 Cisco Webex Control Hub 中進行管理,則您必須執行單獨整合才能為 Cisco Webex Meetings 啟用 SSO。 (如需相關資訊,請在網站管理的 SSO 整合中參閱為 Webex 設定單一登入。)

根據 ADFS 中的驗證機制所設定的內容,預設情況下可啟用 Integrated Windows Authentication (IWA)。 啟用之後,透過 Windows 啟動的應用程式(例如 Webex Teams 和 Cisco 目錄連接器)會以登入的使用者身分來驗證,這與起始電子郵件提示期間輸入的電子郵件地址無關。

將 Cisco Webex 中繼資料下載至本地系統

1

https://admin.webex.com 的客戶視圖中,移至設定,然後捲動至驗證

2

按一下修改,按一下「整合協力廠商身分識別提供者」。 (進階),然後按下一步

3

下載中繼資料檔案。

Cisco Webex 中繼資料檔名為 idb-meta-<org-ID>-SP.xml

在 ADFS 中安裝 Cisco Webex 中繼資料

開始之前

Cisco Webex Control Hub 支援 ADFS 2.x 或較新版本。

Windows 2008 R2 僅包含 ADFS 1.0。 必須至少安裝 Microsoft 提供的 ADFS 2.x。

對於 SSO 和 Cisco Webex 服務,身分識別提供者 (IdP) 必須符合下列 SAML 2.0 規格:

  • 將 NameID 格式屬性設定成 urn:oasis:names:tc:SAML:2.0:nameid-format:transient

  • 在 IdP 上設定宣告以包括 uid 屬性名稱和一個值,該值對映至在 Cisco Directory Connector 中選擇的屬性或符合在 Cisco Webex 身分服務中所選屬性的使用者屬性。 (例如,此屬性可為 E-mail-Addresses 或 User-Principal-Name。) 如需相關指引,請參閱 https://www.cisco.com/go/hybrid-services-directory 中的客戶屬性資訊。

1

以管理員權限登入 ADFS 伺服器。

2

開啟 ADFS 管理主控台並瀏覽至信任關係 > 依賴方信任 > 新增依賴方信任

3

新增依賴方信任精靈視窗中,選取啟動

4

對於選取資料來源,選取從檔案匯入關於依賴方的資料,然後瀏覽至您下載的 Cisco Webex Control Hub 中繼資料檔,並選取下一步

5

對於指定顯示名稱,給此依賴方信任建立顯示名稱(例如 Cisco Webex),然後選取下一步

6

對於選擇發行授權規則,選取允許所有使用者存取此依賴方,然後選取下一步

7

對於準備新增信任,選取下一步並完成將依賴信任新增至 ADFS。

建立宣告規則以允許從 Cisco Webex 進行驗證

1

在 ADFS 窗格中,選取您所建立的信任關係,然後選取編輯宣告規則。 在「發行轉換規則」標籤上,選取新增規則

2

在「選擇規則類型」步驟中,選取將 LDAP 屬性作為宣告傳送,然後選取下一步

  1. 輸入宣告規則名稱

  2. 選取 Active Directory 作為屬性存放區。

  3. E-mail-Addresses LDAP 屬性對映至 uid 傳出宣告類型。

    此規則告知 ADFS 哪些欄位要對映至 Cisco Webex 以識別使用者。 完全按所示的那樣拼寫傳出的宣告類型。

  4. 儲存變更。

3

再次選取新增規則,選取使用自訂規則來傳送宣告,然後選取下一步

此規則向 ADFS 提供「spname qualifier」屬性,而 Cisco Webex 並不另行提供。

  1. 開啟文字編輯器並複製下列內容。

    c:[Type == "http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname"] => issue(Type = "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier", Issuer = c.Issuer, OriginalIssuer = c.OriginalIssuer, Value = c.Value, ValueType = c.ValueType, Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/format"] = "urn:oasis:names:tc:SAML:2.0:nameid-format:transient", Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/namequalifier"] = "<!--SajanXliffTagPlaceHolder:1:SajanXliffTagPlaceHolder-->URL1<!--SajanXliffTagPlaceHolder:2:SajanXliffTagPlaceHolder-->", Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/spnamequalifier"] = "<!--SajanXliffTagPlaceHolder:3:SajanXliffTagPlaceHolder-->URL2<!--SajanXliffTagPlaceHolder:4:SajanXliffTagPlaceHolder-->");

    取代下列文字中的 URL1 和 URL2:
    • URL1 是您所下載 ADFS 中繼資料檔案中的 entityID。

      例如,下列是您看到的內容範例: <EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID="http://ad0a.identitylab20.ciscolabs.com/adfs/services/trust" ID="_55515dde-8147-4183-8a85-b704d26b5dba">

      僅複製 ADFS 中繼資料檔中的 entityID 並將其貼到文字檔以取代 URL1

    • URL2 位於您所下載 Cisco Webex 中繼資料檔的第一行。

      例如,下列是您看到的內容範例: <EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID=" https://idbroker.webex.com/35a15b0a-0eg1-4029-9f63-a8c54df5df59">

      僅複製 Cisco Webex 中繼資料檔中的 entityID 並將其貼到文字檔以取代 URL2。

  2. 藉由更新的 URL,從文字編輯器複製規則(開頭為「c:」),並貼到 ADFS 伺服器上的自訂規則方塊中。

    完成的規則看起來應該類似如下:
  3. 選取完成以建立規則,然後結束「編輯宣告規則」視窗。

4

選取主視窗中的依賴方信任,然後選取右面板中的內容

5

當「內容」視窗出現時,瀏覽至進階標籤、SHA-256,然後選取確定來儲存變更。

6

瀏覽至內部 ADFS 伺服器上的下列 URL 以下載檔案: https://<AD_FS_Server>/FederationMetadata/2007-06/FederationMetadata.xml


 

您可能需要用滑鼠右鍵按一下頁面,然後檢視頁面原始碼以取得正確格式化的 XML 檔。

7

將檔案儲存至本端機器。

下一步

您已準備好從管理入口網站將 ADFS 中繼資料匯入回至 Cisco Webex。

匯入 IdP 中繼資料並在測試後啟用單一登入

匯出 Cisco Webex 中繼資料後,設定 IdP,然後將 IdP 中繼資料下載至本地系統,您便可以將中繼資料從管理入口網站匯入至 Cisco Webex 組織。

開始之前

請勿從身分識別提供者 (IdP) 介面測試 SSO 整合。 我們只支援由服務提供者發起(即由 SP 發起)的流程,因此您必須對此整合使用 Control Hub SSO 測試。

1

選擇一個:

  • 在瀏覽器中回到「Cisco Webex Control Hub – 匯出目錄中繼資料」頁面,然後按下一步
  • 如果 Control Hub 不再於瀏覽器標籤中開啟,請從 https://admin.webex.com 的客戶檢視中,轉至設定,捲至驗證,選擇整合協力廠商身分識別提供者(進階),然後在信任的中繼資料檔案頁面上按下一步(因為您之前已經這樣做)。
2

在「匯入 IdP 中繼資料」頁面上,將 IdP 中繼資料檔案拖放到頁面上,或者使用檔案瀏覽器選項來尋找並上傳中繼資料檔。 按下一步

如果未簽署中繼資料、使用自簽憑證簽署了中繼資料,或使用專用企業憑證授權單位 (CA) 簽署了中繼資料,則建議您使用在中繼資料中需要由憑證授權單位簽署的憑證(更安全)。 如果是自簽憑證,您需要選擇不太安全選項。

3

選取測試 SSO 連線,然後當新的瀏覽器標籤開啟時,請透過登入,向 IdP 驗證。


 

如果您收到驗證錯誤,則憑證可能有問題。 檢查使用者名稱和密碼並再試一次。

Webex Teams 錯誤通常表示 SSO 設定有問題。 在這種情況下,再次執行這些步驟,尤其是複製 Control Hub 中繼資料並貼至 IdP 設定的步驟。

4

回到 Control Hub 瀏覽器標籤。

  • 如果測試成功,請選取此測試已成功。 啟用「單一登入」選項並按下一步
  • 如果測試失敗,請選取此測試已失敗。 停用單一登入選項,並按下一步

下一步

您可以遵循隱藏自動傳送的電子郵件中的程序以停用傳送至您組織中的新 Webex Teams 使用者的電子郵件。 文件還包含將通訊傳送給您組織中的使用者的最佳做法。

在 AD FS 中更新 Cisco Webex 依賴方信任

此任務特別是從 Cisco Webex 中使用新的 SAML 中繼資料更新 AD FS。 如果您需要 使用 AD FS 設定 SSO,或者您需要為 新的 Webex SSO 憑證更新 SAML 中繼資料的相關文章,則會出現相關文章

開始之前

您必須先從 Control Hub 匯出 SAML 中繼資料檔案,然後才能在 AD FS 中更新 Cisco Webex 依賴方信任。

1

以管理員權限登入 AD FS 伺服器。

2

將 SAML 中繼資料檔案從 Webex 上傳到 AD FS 伺服器上的臨時本機資料夾,例如。 ADFS_servername<org-ID>/temp/idb-meta--SP

3

開啟 Powershell。

4

請執行 Get AdfsRelyingPartyTrust 以讀取所有依賴方信任。

請注意 Cisco Webex 信賴方信任的 TargetName 參數。 我們使用範例「Cisco Webex」,但在您的 AD FS 中可能有所不同。

5

執行 更新-AdfsRelyingPartyTrust-MetadataFile "//ADFS_servername/temp/idb-meta-<org-ID>-SP .xml"-TargetName "Cisco Webex"

請確保將檔案名和目標名稱替換為您環境中的正確值。

請參閱https://docs.microsoft.com/powershell/module/adfs/update-adfsrelyingpartytrust
6

登入 Control Hub,然後測試 SSO 整合:

  1. 移至 設定,滾動至 驗證,按一下 修改

  2. 選取 整合協力廠商身分識別提供者(高級) ,然後按 下一步

  3. 下一步 以跳過匯入 IdP 中繼資料頁。

    您無需重複此步驟,因為先前已匯入 IdP 中繼資料。

  4. 按一下 測試 SSO Connection

    隨即開啟一個新的瀏覽器視窗,將您重新導向至「IdP 質詢」頁。

  5. 登入以完成測驗。

ADFS 疑難排解

Windows 記錄中的 ADFS 錯誤

在 Windows 記錄中,可以看到 ADFS 事件記錄錯誤碼 364。 事件詳細資料識別無效的憑證。 在這些情況下,不允許 ADFS 主機透過防火牆上的埠 80 來驗證憑證。

同盟 ID

「同盟 ID」區分大小寫。 如果這是您的組織電子郵件地址,請完全按 ADFS 所傳送的內容輸入,否則 Cisco Webex 無法找到相符的使用者。

傳送 LDAP 屬性之前,無法撰寫自訂宣告規則來正規化 LDAP 屬性。

從您在環境中設定的 ADFS 伺服器匯入中繼資料。

如果需要的話,則可以在「ADFS 管理」中導覽至服務 > 端點 > 中繼資料 > 類型:同盟中繼資料以驗證 URL。

時間同步

確保 ADFS 伺服器的系統時鐘會同步至使用「網路時間通訊協定 (NTP)」的可靠網際網路時間來源。 使用下列 PowerShell 指令,僅對於「Cisco Webex 依賴方信任」關係,產生時鐘偏差。

Set-ADFSRelyingPartyTrust -TargetIdentifier "https://idbroker.webex.com/$ENTITY_ID_HEX_VALUE" -NotBeforeSkew 3

此十六進位值對於您的環境而言是唯一的。 請取代 Cisco Webex 中繼資料檔中的 SP EntityDescriptor ID 值。 例如:

<EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID=" https://idbroker.webex.com/c0cb726f-a187-4ef6-b89d-46749e1abd7a">