設定認證提供者
在 Ping64 中,認證提供者用於為業務應用程式設定認證接入參數。統一身分管理支援透過 OAuth 2.0 / OpenID Connect(OIDC)提供應用程式認證;完成提供者設定後,仍須將其關聯至應用程式,並在業務應用程式端完成設定及驗證。
認證提供者與目錄身分來源的用途不同:身分來源用於連接或管理身分資料;認證提供者用於應用程式認證接入。儲存提供者不代表應用程式已完成接入,也不代表所有使用者均可存取該應用程式。
目標應用程式已有符合需求的提供者時,應先確認並沿用;尚未關聯時,可選擇設定合適且未被其他應用程式占用的既有提供者。提供者不能同時繫結多個應用程式;已被其他應用程式占用時,應另行準備合適的提供者,不要未經評估解除原有關聯。修改驗證設定前還須確認應用程式相依性和復原方案。
設定前準備
- 使用具備統一身分管理檢視及設定權限的管理員帳號。刪除提供者需要相應操作權限。
- 與應用程式負責人確認用戶端類型、登入回呼位址、登出後重新導向位址、所需作用域及使用者識別要求。
- 在統一身分管理的「證書」中準備可用的簽章金鑰,並準備測試應用程式及具備、未具備存取權限的測試帳號。
- 用戶端 Secret 屬敏感憑證,應透過組織核准的安全管道保管與交付,不應寫入一般工單、螢幕截圖或公開文件。
建立提供者
- 在控制台切換至「統一身分管理」,開啟「認證配置」下的「認證提供者」,選擇新增。
- 在「基本資訊」填寫名稱,並依需要填寫描述。名稱為必填項目。
- 在「通訊協定設定」選擇「用戶端類型」:機密適用於能安全保存用戶端 Secret 的應用程式;公開適用於無法安全保存共用 Secret 的用戶端。建立時預設選擇機密用戶端,應依應用程式的實際接入方式確認。
- 核對自動產生的用戶端 ID。機密用戶端也會顯示用戶端 Secret;若需重新產生 ID 或 Secret,應評估對應用程式接入的影響,並以安全方式同步新憑證。
- 填寫「重定向 URI」:至少一筆、最多十筆,位址須以
http://或https://開頭,並與應用程式實際使用的登入回呼位址一致。依需要新增「登出重定向 URI」,最多十筆。 - 選擇可用的「簽章金鑰」。在「進階通訊協定設定」選擇作用域、Subject 模式及 Issuer 模式,並與應用程式負責人核對。作用域限制應用程式要求的身分資訊範圍;Subject 模式影響應用程式接收的使用者識別。不要授予不必要的作用域。
- 儲存並檢查成功或失敗提示。返回清單不一定表示儲存成功;應重新開啟提供者,核對名稱、用戶端 ID、回呼位址及其他設定。
登入回呼須填寫應用程式實際使用的完整位址,包括路徑、結尾斜線及查詢參數;授權與交換授權碼時使用的回呼也應一致,不能只填網域。若應用程式在登出時要求重新導向,須先在登出重新導向 URI 登錄對應完整位址;未登錄的位址會遭拒絕。不使用登出後重新導向時,可以不新增該位址。
設定頁面接受 http:// 位址,不代表該位址適合正式環境,也不代表網路傳輸已受到保護。正式環境應依組織安全要求評估傳輸方式與回呼位址。
**選擇與驗證範圍:**頁面提供 openid、profile、email 與 offline_access。此處選擇的是允許應用程式要求的範圍;應用程式也必須在登入要求中實際要求所需範圍,要求至少包含一項,且不得超出允許範圍。使用 OIDC 登入時,依應用程式接入需求選擇 openid;若需從使用者資訊取得名稱或電子郵件,應分別確認 profile 或 email 已獲允許且實際提出要求。電子郵件資訊也取決於帳號是否已填寫電子郵件。offline_access 與重新整理權杖有關,但選擇它不保證重新整理可用:透過此頁儲存的設定不允許使用重新整理權杖方式。不能僅憑探索資訊或收到重新整理權杖判定後續重新整理一定成功。若業務依賴持續登入,應先與應用程式負責人及技術支援確認可用方案,並在上線前驗證權杖到期後的實際行為。
關聯應用程式並驗證
若既有提供程式符合需求且已關聯目標應用程式,可跳過步驟 1 與 2,從步驟 3 確認後繼續驗證;僅在需要新增應用程式或調整關聯時才執行步驟 1 與 2。調整前評估對其他應用程式和使用者的影響,並準備復原方案。
- 在「應用與存取」開啟應用程式,新增或編輯現有應用程式。
- 在應用程式設定的提供者欄位開啟選擇視窗,選取適用且可用的提供者,完成其他必要設定後儲存。依實際使用要求設定存取範圍;關聯提供者本身不等於使用者已取得存取權限。
- 返回「認證提供者」,選擇提供者名稱進入詳細資料,核對關聯應用程式、用戶端 ID、回呼位址及頁面顯示的 OpenID 設定資訊。
- 先確認業務應用程式端的接入參數;僅在不符合需求時,由應用程式負責人依核准方案調整。使用受控測試帳號分別驗證允許及不允許存取的情況,並檢查登入與登出後的實際重新導向。
- 核對應用程式要求的作用域、使用者識別及簽章驗證是否符合預期。Issuer 模式應結合實際探索文件、權杖與應用程式整合測試結果核對,不應只依頁面選項說明判斷實際簽發者。
- 與應用程式負責人確認應用程式使用授權碼方式接入。機密用戶端使用 Secret 時,應透過安全管道確認雙方設定一致;選擇公開用戶端時,應用程式必須支援 PKCE,並在授權及交換授權碼時使用相互匹配的驗證參數,優先採用
S256。應用程式不支援 PKCE 或驗證參數不匹配時,驗證可能失敗;不要改用機密用戶端來繞過應用程式無法安全儲存 Secret 的限制。
修改與刪除
在提供者清單選擇目標項目的編輯操作可調整設定。編輯時若未重新產生 Secret,頁面可能顯示遮罩;不要將遮罩當成實際 Secret。用戶端 ID、Secret、重定向 URI、簽章金鑰或使用者識別模式變更均可能影響已接入的應用程式。調整前應安排變更時段與復原方案,變更後重新驗證關聯應用程式。
刪除前先確認應用程式相依關係及移轉方案。刪除提供者會移除其應用程式關聯,並影響相關認證憑證,可能導致使用者無法繼續使用相關認證流程;刪除後不要假設關聯會自動復原。
常見問題
- **找不到提供者:**名稱搜尋可能遺漏現有項目。先清除關鍵字,在清單核對名稱及帳號權限。
- **儲存失敗:**檢查名稱、回呼位址、簽章金鑰、作用域及其他必填項目,並留意頁面提示。返回清單不等於儲存成功。
- **登入回呼失敗:**核對應用程式實際使用的回呼位址與提供者設定、用戶端類型及應用程式端參數;應完整核對雙方位址。
- **權杖或使用者識別不符合預期:**檢查作用域、Subject、實際 Issuer 及簽章金鑰,並結合應用程式記錄進行整合測試。
- **變更後應用程式無法登入:**檢查關聯、用戶端 ID、Secret、簽章金鑰及應用程式狀態,依事先核准的復原方案處理。
更新時間