設定 SAML IDP

私有雲 v4.18.01 的邊緣

啟用 SAML 後,主體 (Edge UI 使用者) 就會要求存取服務供應商 (Edge SSO)。接著,Edge SSO 會要求並取得 SAML 識別資訊提供者 (IDP) 的身分宣告,並使用該宣告來建立存取 Edge UI 所需的 OAuth2 權杖。接著,系統會將使用者重新導向至 Edge UI。

Edge 支援許多 IDP,包括 Okta 和 Microsoft Active Directory 同盟服務 (ADFS)。如要瞭解如何設定 ADFS 以與 Edge 搭配使用,請參閱「在 ADFS IDP 中將 Edge 設為 Relying Party」。如果是 Okta,請參閱下一節。

Edge 必須提供電子郵件地址才能識別使用者,才能設定 SAML IDP。因此,識別資訊提供者必須在身分斷言中傳回電子郵件地址。

此外,您可能還需要下列部分或所有要求:

設定 說明
中繼資料網址

SAML IDP 可能會要求 Edge SSO 的中繼資料網址。中繼資料網址的格式為:

protocol://apigee_sso_IP_DNS:port/saml/metadata

例如:

http://apigee_sso_IP_or_DNS:9099/saml/metadata

Assertion Consumer Service URL (宣告客戶服務網址)

使用者輸入自己的 IdP 憑證後,可做為重新導向網址,使用,格式如下:

protocol://apigee_sso_IP_DNS:port/saml/SSO/alias/apigee-saml-login-opdk

例如:

http://apigee_sso_IP_or_DNS:9099/saml/SSO/alias/apigee-saml-login-opdk

單一登出網址

您可以將 Edge SSO 設為支援單一登出功能。詳情請參閱「透過 Edge UI 設定單一登入功能」一文。Edge SSO 單一登出網址格式如下:

protocol://apigee_sso_IP_DNS:port/saml/SingleLogout/alias/apigee-saml-login-opdk

例如:

http://apigee_sso_IP_DNS:9099/saml/SingleLogout/alias/apigee-saml-login-opdk

SP 實體 ID (或目標對象 URI)

邊緣單一登入 (SSO):

apigee-saml-login-opdk

設定 Okta

如要設定 Okta:

  1. 登入 Okta。
  2. 選取「Applications」,然後選取 SAML 應用程式。
  3. 選取「Assignments」分頁標籤,將任何使用者新增至應用程式。這些使用者將可登入 Edge UI 並發出 Edge API 呼叫。不過,您必須先將每位使用者新增至 Edge 機構,並指定該使用者的角色。詳情請參閱「註冊新的 Edge 使用者」。
  4. 選取「Sign on」分頁標籤,取得識別資訊提供者中繼資料網址。您必須儲存該網址,才能設定 Edge。
  5. 選取「General」分頁標籤以設定 Okta 應用程式,如下表所示:
設定 說明
網址單一登入 將重新導向網址指定回 Edge,以供使用者輸入 Okta 憑證後使用。網址的格式如下:

http://apigee_sso_IP_DNS:9099/saml/SSO/alias/apigee-saml-login-opdk,或是你打算在 apigee-sso 啟用傳輸層安全標準 (TLS):

https://apigee_sso_IP_DNS:9099/saml/SSO/alias/apigee-saml-login-opdk,其中 apigee_sso_IP_DNS 是代管 apigee-sso 的 IP 位址或 DNS 名稱。請注意,這個網址會區分大小寫,且 SSO 必須以大寫開頭。

如果負載平衡器位於 apigee-sso,並指定透過負載平衡器參照的 apigee-sso 的 IP 位址或 DNS 名稱。

用於收件者網址和到達網頁網址 請勾選這個核取方塊。
目標對象 URI (SP 實體 ID) 設為 apigee-saml-login-opdk
預設 RelayState 可留空。
名稱 ID 格式 指定「EmailAddress」EmailAddress
應用程式使用者名稱 指定 Okta 使用者名稱
屬性陳述式 (選用) 指定「FirstName」、「LastName」和「Email」,如下圖所示。FirstNameFirstNameFirstName

完成後,SAML 設定對話方塊會如下所示: