# 設定認證提供者

Canonical: https://www.nsecsoft.com/tw/docs/ping64-identity-access/iam/authentication/configure-authentication-provider/

Language: zh-TW

Updated: 2026-11-15T04:09:22.240409Z

在 Ping64 中，認證提供者用於為業務應用程式設定認證接入參數。統一身分管理支援透過 OAuth 2.0 / OpenID Connect（OIDC）提供應用程式認證；完成提供者設定後，仍須將其關聯至應用程式，並在業務應用程式端完成設定及驗證。

認證提供者與目錄身分來源的用途不同：身分來源用於連接或管理身分資料；認證提供者用於應用程式認證接入。儲存提供者不代表應用程式已完成接入，也不代表所有使用者均可存取該應用程式。

目標應用程式已有符合需求的提供者時，應先確認並沿用；尚未關聯時，可選擇設定合適且未被其他應用程式占用的既有提供者。提供者不能同時繫結多個應用程式；已被其他應用程式占用時，應另行準備合適的提供者，不要未經評估解除原有關聯。修改驗證設定前還須確認應用程式相依性和復原方案。

## 設定前準備

-   使用具備統一身分管理檢視及設定權限的管理員帳號。刪除提供者需要相應操作權限。
-   與應用程式負責人確認用戶端類型、登入回呼位址、登出後重新導向位址、所需作用域及使用者識別要求。
-   在統一身分管理的「證書」中準備可用的簽章金鑰，並準備測試應用程式及具備、未具備存取權限的測試帳號。
-   用戶端 Secret 屬敏感憑證，應透過組織核准的安全管道保管與交付，不應寫入一般工單、螢幕截圖或公開文件。

## 建立提供者

1.  在控制台切換至「統一身分管理」，開啟「認證配置」下的「認證提供者」，選擇新增。
2.  在「基本資訊」填寫名稱，並依需要填寫描述。名稱為必填項目。
3.  在「通訊協定設定」選擇「用戶端類型」：**機密**適用於能安全保存用戶端 Secret 的應用程式；**公開**適用於無法安全保存共用 Secret 的用戶端。建立時預設選擇機密用戶端，應依應用程式的實際接入方式確認。
4.  核對自動產生的用戶端 ID。機密用戶端也會顯示用戶端 Secret；若需重新產生 ID 或 Secret，應評估對應用程式接入的影響，並以安全方式同步新憑證。
5.  填寫「重定向 URI」：至少一筆、最多十筆，位址須以 `http://` 或 `https://` 開頭，並與應用程式實際使用的登入回呼位址一致。依需要新增「登出重定向 URI」，最多十筆。
6.  選擇可用的「簽章金鑰」。在「進階通訊協定設定」選擇作用域、Subject 模式及 Issuer 模式，並與應用程式負責人核對。作用域限制應用程式要求的身分資訊範圍；Subject 模式影響應用程式接收的使用者識別。不要授予不必要的作用域。
7.  儲存並檢查成功或失敗提示。返回清單不一定表示儲存成功；應重新開啟提供者，核對名稱、用戶端 ID、回呼位址及其他設定。

登入回呼須填寫應用程式實際使用的完整位址，包括路徑、結尾斜線及查詢參數；授權與交換授權碼時使用的回呼也應一致，不能只填網域。若應用程式在登出時要求重新導向，須先在登出重新導向 URI 登錄對應完整位址；未登錄的位址會遭拒絕。不使用登出後重新導向時，可以不新增該位址。

設定頁面接受 `http://` 位址，不代表該位址適合正式環境，也不代表網路傳輸已受到保護。正式環境應依組織安全要求評估傳輸方式與回呼位址。

\*\*選擇與驗證範圍：\*\*頁面提供 `openid`、`profile`、`email` 與 `offline_access`。此處選擇的是允許應用程式要求的範圍；應用程式也必須在登入要求中實際要求所需範圍，要求至少包含一項，且不得超出允許範圍。使用 OIDC 登入時，依應用程式接入需求選擇 `openid`；若需從使用者資訊取得名稱或電子郵件，應分別確認 `profile` 或 `email` 已獲允許且實際提出要求。電子郵件資訊也取決於帳號是否已填寫電子郵件。`offline_access` 與重新整理權杖有關，但選擇它不保證重新整理可用：透過此頁儲存的設定不允許使用重新整理權杖方式。不能僅憑探索資訊或收到重新整理權杖判定後續重新整理一定成功。若業務依賴持續登入，應先與應用程式負責人及技術支援確認可用方案，並在上線前驗證權杖到期後的實際行為。

## 關聯應用程式並驗證

若既有提供程式符合需求且已關聯目標應用程式，可跳過步驟 1 與 2，從步驟 3 確認後繼續驗證；僅在需要新增應用程式或調整關聯時才執行步驟 1 與 2。調整前評估對其他應用程式和使用者的影響，並準備復原方案。

1.  在「應用與存取」開啟應用程式，新增或編輯現有應用程式。
2.  在應用程式設定的提供者欄位開啟選擇視窗，選取適用且可用的提供者，完成其他必要設定後儲存。依實際使用要求設定存取範圍；關聯提供者本身不等於使用者已取得存取權限。
3.  返回「認證提供者」，選擇提供者名稱進入詳細資料，核對關聯應用程式、用戶端 ID、回呼位址及頁面顯示的 OpenID 設定資訊。
4.  先確認業務應用程式端的接入參數；僅在不符合需求時，由應用程式負責人依核准方案調整。使用受控測試帳號分別驗證允許及不允許存取的情況，並檢查登入與登出後的實際重新導向。
5.  核對應用程式要求的作用域、使用者識別及簽章驗證是否符合預期。Issuer 模式應結合實際探索文件、權杖與應用程式整合測試結果核對，不應只依頁面選項說明判斷實際簽發者。
6.  與應用程式負責人確認應用程式使用授權碼方式接入。機密用戶端使用 Secret 時，應透過安全管道確認雙方設定一致；選擇公開用戶端時，應用程式必須支援 PKCE，並在授權及交換授權碼時使用相互匹配的驗證參數，優先採用 `S256`。應用程式不支援 PKCE 或驗證參數不匹配時，驗證可能失敗；不要改用機密用戶端來繞過應用程式無法安全儲存 Secret 的限制。

## 修改與刪除

在提供者清單選擇目標項目的編輯操作可調整設定。編輯時若未重新產生 Secret，頁面可能顯示遮罩；不要將遮罩當成實際 Secret。用戶端 ID、Secret、重定向 URI、簽章金鑰或使用者識別模式變更均可能影響已接入的應用程式。調整前應安排變更時段與復原方案，變更後重新驗證關聯應用程式。

刪除前先確認應用程式相依關係及移轉方案。刪除提供者會移除其應用程式關聯，並影響相關認證憑證，可能導致使用者無法繼續使用相關認證流程；刪除後不要假設關聯會自動復原。

## 常見問題

-   \*\*找不到提供者：\*\*名稱搜尋可能遺漏現有項目。先清除關鍵字，在清單核對名稱及帳號權限。
-   \*\*儲存失敗：\*\*檢查名稱、回呼位址、簽章金鑰、作用域及其他必填項目，並留意頁面提示。返回清單不等於儲存成功。
-   \*\*登入回呼失敗：\*\*核對應用程式實際使用的回呼位址與提供者設定、用戶端類型及應用程式端參數；應完整核對雙方位址。
-   \*\*權杖或使用者識別不符合預期：\*\*檢查作用域、Subject、實際 Issuer 及簽章金鑰，並結合應用程式記錄進行整合測試。
-   \*\*變更後應用程式無法登入：\*\*檢查關聯、用戶端 ID、Secret、簽章金鑰及應用程式狀態，依事先核准的復原方案處理。
