設定 OpenID Connect 提供者

OpenID Connect 外部識別提供者是遵循 OpenID Connect 規格 的服務。 OpenID Connect 引進了識別碼權杖的概念。 識別碼權杖是一個允許用戶端驗證使用者身份的安全性權杖。 它也會提供使用者的基本個人資料,稱為 宣告。

Power Pages 內建支援下列 OpenID Connect 提供者:Microsoft Entra 外部 ID、Microsoft Entra ID及具有多租用戶的 Microsoft Entra ID。 本文說明如何將其他 OpenID Connect 識別提供者新增至 Power Pages 網站。

Power Pages 中支援和不支援的驗證流程

  • 隱含授與
    • 此流程是 Power Pages 網站的預設驗證方法。
  • 授權碼
    • Power Pages 使用 client_secret_post 方法來與身分識別伺服器的權杖端點進行通訊。
    • Power Pages 也支援與憑證端點進行private_key_jwt驗證的方法。 詳情請參見 配置 private_key_jwt。
  • 混合式 (受限支援)
    • Power Pages 要求回覆中必須存在 id_token,因此不支援 response_type = 程式碼權杖。
    • Power Pages 中的混合式流程遵循與隱含授與相同的流程,並使用 id_token 直接登入使用者。

Note

變更網站的驗證設定可能需要幾分鐘的時間才能反應在網站上。 若要立即查看變更,請在系統管理中心重新啟動網站。

在 Power Pages 中設定 OpenID Connect 提供者

  1. 在您的 Power Pages 網站中,選擇安全>身份提供程式。

    如果沒有出現識別提供者,請檢查網站的一般驗證設定中的外部登入是否設定為開。

  2. 選擇 + 新增提供者。

  3. 在選取登入提供者底下,選取其他。

  4. 在通訊協定底下,選取 OpenID Connect。

  5. 輸入提供者的名稱。

    提供者名稱是使用者在登入頁面選取識別提供者時所見按鈕上的文字。

  6. 選取 下一步。

  7. 在回覆 URL 底下,選取複製。

    請勿關閉您的 Power Pages 瀏覽器索引標籤。您很快就會返回。

在識別提供者中建立應用程式註冊

  1. 使用 您複製的回覆網址,向您的身份提供者建立並註冊應用程式。

  2. 複製應用程式或用戶端識別碼及用戶端密碼。

  3. 尋找應用程式的端點,並複製 OpenID Connect 中繼資料文件 URL。

  4. 根據需要變更您識別提供者的其他設定。

在 Power Pages 中輸入網站設定

返回先前離開的 Power Pages 設定識別提供者頁面,然後輸入以下值。 或者,視需要變更其他設定。 完成後,選取確認。

  • 授權單位:按照以下格式輸入授權 URL: https://login.microsoftonline.com/<Directory (tenant) ID>/,其中<目錄 (租用戶) 識別碼>是您建立應用程式的目錄 (租用戶) 識別碼。 例如,如果 Azure 入口網站中的目錄(租戶)ID 是 aaaabbbb-0000-cccc-1111-dddd2222eeee,則權威 URL 為 https://login.microsoftonline.com/aaaabbbb-0000-cccc-1111-dddd2222eeee/​。

  • 用戶端識別碼:貼上您建立應用程式的應用程式或用戶端識別碼。

  • 重新導向 URL:如果您的網站自訂網域名稱,請輸入自訂 URL,否則請保留預設值。 請確定該值與您建立應用程式的重新導向 URI 完全相同。

  • 中繼資料位址:貼上您複製的 OpenID Connect 中繼資料文件 URL。

  • 範圍:輸入一個空格分隔或逗號分隔的範圍清單,使用 OpenID Connect scope 參數請求。 預設值為 openid。

    openid 值是必要的。 瞭解其他可以新增的宣告。

  • 回覆類型:輸入 OpenID Connect response_type 參數的值。 可能的值包括:code、code id_token、id_token、id_token token 和 code id_token token。 預設值為 code id_token。

  • 用戶端密碼:貼上提供者應用程式的用戶端密碼。 這也可能稱為應用程式密碼或消費者密碼。 若回覆類型為 code,則需要此設定。

  • 回覆模式:輸入 OpenID Connect response_mode 參數的值。 如果回覆類型為 query,則該值應為 code。 預設值為 form_post。

  • 外部登出:此設定可控制您的網站是否使用同盟登出。透過同盟登出,當使用者登出應用程式或網站時,他們也會登出所有使用相同識別提供者的應用程式和網站。 開啟此項目,以便在使用者從您的網站登出時將其重新導向至同盟登出流程。 將其關閉以讓使用者僅登出您的網站。

  • 登出後重新導向 URL:輸入識別提供者在使用者登出後應重新導向到的 URL。此位置應適當設定於識別提供者設定中。

  • RP 發起登出:此設定可控制依賴方 (OpenID Connect 用戶端應用程式) 是否可以登出使用者。 若要使用此設定,請開啟外部登出。

Power Pages 中的其他設定

其他設定可讓您更好地控制使用者如何透過 OpenID Connect 識別提供者進行驗證。 您不一定要設定這些值。 它們都是選用的。

  • 簽發者篩選條件:輸入以萬用字元為基礎的篩選條件,比對所有租用戶中的所有簽發者。 例如,使用 https://sts.windows.net/*/。 如果你使用的是 Microsoft Entra ID 認證提供者,發行者的 URL 過濾器是 https://login.microsoftonline.com/*/v2.0/。

  • 驗證對象:打開此設定可在權杖驗證期間驗證對象。

  • 有效對象:輸入以逗點分隔的對象 URL 清單。

  • 驗證簽發者:打開此設定可在權杖驗證期間驗證簽發者。

  • 有效簽發者:輸入以逗點分隔的簽發者 URL 清單。

  • 註冊宣告對應與登入宣告對應 :在使用者驗證中,宣告是描述使用者身分識別的資訊,如電子郵件地址或出生日期。 當您登入應用程式或網站時,它會建立權杖。 令牌包含關於您身份的資訊,包括與其相關的任何宣告。 當您存取應用程式或網站的其他部分,或連線到相同識別提供者的其他應用程式和網站時,會使用權杖來驗證您的身分。 宣告對應是變更權杖所包含資訊的方法。 它可以用來自訂應用程式或網站可用的資訊,並控對制功能或資料的存取。 註冊宣告對應會修改您註冊應用程式或網站時發出的宣告。 登入宣告對應可修改您登入應用程式或網站時發出的宣告。 深入了解聲明對應政策。

    你可以用兩種方式提供使用者資訊:

    • 識別碼權杖宣告 – 在權杖中包含基本使用者屬性,例如名字或電子郵件。
    • UserInfo 端點 – 可在驗證後傳回詳細使用者資訊的安全 API。

    若要使用 UserInfo 端點,請建立名為 Authentication/OpenIdConnect/{ProviderName}/UseUserInfoEndpointforClaims 的網站設定,並將值設定為 true。

    或者,建立名為 Authentication/OpenIdConnect/{ProviderName}/UserInfoEndpoint 的網站設定,並將值設定為 UserInfo 端點 URL。 如果未提供此設定,則 Power Pages 會嘗試在 OIDC 中繼資料中尋找端點。

    錯誤處理:

    • 如果未設定端點 URL 且 Power Pages 無法在中繼資料中找到端點,則登入會繼續並記錄警告。
    • 如果設定了 URL 但無法存取,登入將繼續但會顯示警告。
    • 如果端點傳回驗證錯誤 (如 401 或 403),登入將會繼續,並顯示包含錯誤訊息的警告。

    對應語法:

    若要在登入或註冊聲明對應中使用 UserInfo 聲明,請使用以下格式:

    fieldName = 使用者資訊.claimName

    如果未啟用 UseUserInfoEndpointforClaims,則會忽略使用 userinfo. 首碼的對應。

  • Nonce 存留期:輸入 Nonce 值的存留期 (以分鐘為單位)。 預設值為 10 分鐘。

  • 已啟用 Nonce:此設定控制是否對 OpenID Connect 通訊協定啟用 Nonce 驗證。 預設值是開啟。 將其關閉即可停用 Nonce 驗證 (不建議在正式環境中使用)。

  • 使用權杖存留期:此設定控制驗證工作階段存留期 (例如 Cookie) 是否應與驗證權杖的存留期相符。 如果您將其開啟,則此值會覆寫 Authentication/ApplicationCookie/ExpireTimeSpan 網站設定中的應用程式 Cookie 到期時間範圍值。

  • 連絡人與電子郵件的對應:此設定決定連絡人在登入時,是否對應到相應的電子郵件地址。

    • 開啟:將唯一的連絡人記錄關連至相符的電子郵件位址,然後在使用者成功登入後,自動指派外部識別提供者給連絡人。
    • 關閉

Note

UI_Locales要求參數會自動在驗證要求中傳送,並設定為在入口網站上選取的語言。

其他授權參數

使用下列授權參數,但不要在 Power Pages 的 OpenID Connect 提供者中設定這些參數:

  • acr_values:這個 acr_values 參數讓身份提供者能強制執行安全保證等級,例如多重驗證(MFA)。 此參數可讓應用程式指示所需的驗證層級。

    要使用這個acr_values參數,請建立一個名為 Authentication/OpenIdConnect/{ProviderName}/AcrValues 的網站設定,並設定你需要的值。 當你設定這個值時,Power Pages 會在授權請求中包含這個acr_values參數。

  • 動態授權參數:動態參數允許您為不同的使用情境 (例如內嵌應用程式或多租用戶案例) 自訂授權要求。

    • 提示參數:

      此參數控制是否出現登入頁面或同意畫面。 你可以用兩種方式配置:

      1. 網站設定(靜態):建立一個名為 Authentication/OpenIdConnect/{ProviderName}/Prompt 的網站設定,並將值設為以下支援的其中一個值。 此值適用於所有提供者的認證請求,並優先於動態參數。
      2. 動態(按請求):新增自訂,將其作為查詢字串參數傳送給外部登入端點。

      支持的價值觀:

      • none
      • login
      • 同意
      • 選擇帳戶
      • 建立

      Note

      設定提示網站設定時,其優先順序會高於透過查詢字串傳遞的動態提示參數。

      URL 格式:

      {PortalUrl}/Account/Login/ExternalLogin?ReturnUrl=%2F&provider={ProviderName}&prompt={value}

      Power Pages 在提示參數中將此值傳送給識別提供者。

    • 登入提示參數:

      此參數可讓您傳遞已知的使用者識別碼 (例如電子郵件) 來預先填入或繞過登入畫面。 要使用它,請新增自訂以將其作為查詢字串參數傳送到 ExternalLogin 端點。

      URL 格式:

      {PortalUrl}/Account/Login/ExternalLogin?ReturnUrl=%2F&provider={ProviderName}&login_hint={value}

      當使用者在同一會話中已透過其他身份登入時,這個參數很有幫助,例如Microsoft Entra ID或Microsoft 帳戶(MSA)。

  • 自訂授權參數:某些識別提供者支援特定授權行為的專屬參數。 Power Pages 可讓製作者安全地設定和傳遞這些參數。 若要使用這些參數,請新增自訂以將它們作為查詢字串參數傳送至 ExternalLogin 端點。

    建立名為 Authentication/OpenIdConnect/{Provider}/AllowedDynamicAuthorizationParameters 的網站設定,並將值設定為以逗號分隔的參數名稱清單,例如 param1,param2,param3。

    範例 URL 格式:

    {PortalUrl}/Account/Login/ExternalLogin?ReturnUrl=%2F&provider={ProviderName}&param1=value&param2=value&param3=value

    如果有任何參數 (param1、param2 或 param3) 不在允許參數清單中,則 Power Pages 會加以忽略。

    這個設定定義了一串自訂參數,你可以在授權請求中傳送。

    行為

    • 在 ExternalLogin 端點的查詢字串中傳遞參數。
    • Power Pages 只會將清單中的參數包含在授權要求中。
    • 預設參數 prompt如 、 login_hint、 ReturnUrl 都是允許的,且不需要列出。

    範例 URL 格式:

    {PortalUrl}/Account/Login/ExternalLogin?ReturnUrl=%2F&provider={ProviderName}&custom_param=value

    如果custom_param不在允許參數清單中,Power Pages 會忽略它。

設定 private_key_jwt

此 private_key_jwt 方法使用憑證的私鑰來簽署客戶端斷言。 身份提供者會使用對應的公鑰來驗證斷言。

在設定 Power Pages 之前,請確認身份提供者是否支援 private_key_jwt。 提供者的 OpenID Connect 中繼資料文件應在 token_endpoint_auth_methods_supported 陣列中包含 private_key_jwt。 你也必須向身份提供者註冊憑證的公開金鑰。

  1. 上傳你想用來簽署客戶聲明的自訂憑證。 上傳完成後複製憑證的指紋。

  2. 確定現場設置中使用的提供者名稱。 在 入口網站管理應用程式中,打開 網站設定 ,找到 OpenID Connect 提供者的現有設定,例如 認證/OpenIdConnect/OpenId_1/發行者。 設定名稱之間的 OpenIdConnect/ 值就是提供者名稱。 在此範例中,提供者名稱為 OpenId_1。

    網站設定路徑中的提供者名稱為內部識別碼,可能與登入頁面上的顯示名稱不同。 在所有設定中,服務提供者的大小寫都必須相同。

  3. 請建立以下 網站設定。 請將你在前一步中提到的提供者名稱替換 {ProviderName} 。

    場地設置 價值觀
    Authentication/OpenIdConnect/{ProviderName}/TokenEndPointAuthenticatedMethod private_key_jwt
    Authentication/OpenIdConnect/{ProviderName}/PrivateKeyJwt/CertificateObject {"kid":"{thumbprint}"},其中 {thumbprint} 是上傳至網站的自訂憑證的指紋。
  4. 在 Power Platform 管理中心重新啟動網站,讓 Power Pages 載入憑證。

如果遙測顯示啟動時沒有找到或載入憑證,請確認該值是否 kid 與上傳的自訂憑證的指紋相符,憑證包含私鑰,且所有網站設定使用相同的提供者名稱。

參見

使用 Power Pages 設定 Microsoft Entra 外部識別碼
使用 Microsoft Entra ID 設定 OpenID Connect 提供者
OpenID Connect 常見問題集