Edge for Private Cloud 4.18.01 版
啟用 SAML 後,主體 (Edge UI 使用者) 會要求存取服務供應商 (Edge SSO)。接著,Edge SSO 會向 SAML 識別資訊提供者 (IDP) 要求並取得識別資訊主張,並使用該主張建立存取 Edge UI 所需的 OAuth2 權杖。接著,系統會將使用者重新導向至 Edge UI。
Edge 支援多種 IDP,包括 Okta 和 Microsoft Active Directory Federation Services (ADFS)。如要瞭解如何設定 ADFS 以搭配 Edge 使用,請參閱「在 ADFS IDP 中將 Edge 設為信賴憑證者」。如需 Okta 的相關資訊,請參閱下一節。
如要設定 SAML IDP,Edge 需要電子郵件地址來識別使用者。因此,識別資訊提供者必須在身分聲明中傳回電子郵件地址。
此外,您可能需要下列部分或所有項目:
| 設定 | 說明 |
|---|---|
| Metadata URL |
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 憑證後,可做為重新導向回 Edge 的網址,格式如下: 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) |
Edge SSO: apigee-saml-login-opdk |
設定 Okta
如要設定 Okta,請按照下列步驟操作:
- 登入 Okta。
- 依序選取「Applications」和 SAML 應用程式。
- 選取「Assignments」分頁標籤,將使用者新增至應用程式。這些使用者可以登入 Edge UI 並發出 Edge API 呼叫。不過,您必須先將每位使用者新增至 Edge 組織,並指定使用者的角色。詳情請參閱「註冊新的 Edge 使用者」。
- 選取「Sign on」分頁標籤,取得識別資訊提供者中繼資料網址。請儲存該網址,因為設定 Edge 時會用到。
- 選取「General」(一般) 分頁標籤,設定 Okta 應用程式,如下表所示:
| 設定 | 說明 |
|---|---|
| 單一登入網址 |
指定使用者輸入 Okta 憑證後,重新導向回 Edge 的網址。這個網址的格式如下:
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 名稱。 |
| Use this for Recipient URL and Destination URL | 勾選這個核取方塊。 |
| Audience URI (SP Entity ID) | 設為 apigee-saml-login-opdk |
| 預設 RelayState | 可以留空。 |
| 名稱 ID 格式 | 指定 EmailAddress。 |
| 應用程式使用者名稱 | 指定 Okta 使用者名稱。 |
| 屬性陳述式 (選用) | 指定 FirstName、LastName 和 Email,如下圖所示。 |
完成後,SAML 設定對話方塊應如下所示:
