管理驗證簽章憑證
統一身分管理中的「憑證」用於管理驗證簽章金鑰;驗證提供者可選擇可用的簽章金鑰。建立金鑰、設定提供者與驗證應用程式是不同步驟,清單上出現項目不代表應用程式已完成驗證串接。
可下載的憑證為自我簽署憑證,不應視為由公眾信任機構簽發,也不等同網站的 HTTPS 伺服器憑證。應用程式如何信任及驗證結果,應由負責人依實際串接方式確認。
操作前準備
- 確認管理員具備檢視與維護統一身分設定的權限;建立與刪除可能需要不同權限。
- 確定金鑰用途、演算法相容性、有效期,以及依賴它的驗證提供者與應用程式。準備受控測試帳戶、變更時段與復原方案。
- 私密金鑰屬高度敏感憑據,僅在確有需要且獲授權時下載;依組織認可的安全程序儲存、傳遞及清理副本,不要貼到工單、聊天或公開資料。
建立並選擇簽章金鑰
- 在統一身分管理的「認證配置」中開啟「證書」;頁面標題為「憑證」。選擇新增。
- 填寫名稱與「有效天數」,選擇「金鑰類型」。頁面提供 RSA 和 ECDSA;選擇前確認串接應用程式支援的演算法。
- 需要明確金鑰到期時間時,填寫正整數天數並儲存。輸入
0不會設定明確的金鑰到期時間;即使金鑰沒有設定到期時間,下載憑證本身仍有有效期,應以實際憑證為準。 - 返回清單後核對名稱、類型與到期資訊。返回清單本身不足以證明建立成功;若項目未出現或請求異常,應聯絡管理員查核。
- 開啟需要使用金鑰的驗證提供者,在「通訊協定設定」選擇「簽章金鑰」,核對其他串接參數並儲存。清單僅列目前可用且未到期的金鑰;若新金鑰未出現,可重新開啟設定並檢查狀態及到期情況。
- 依應用程式負責人的串接要求設定應用程式端信任,使用試點帳戶進行受控登入與驗證結果檢查。分別確認提供者、應用程式存取授權及自身設定;不能僅憑儲存成功判斷驗證可用。
檢視及下載
- 在憑證清單找到目標項目,展開該列檢視憑證主體及指紋等資訊。
- 依需要選擇「下載憑證」或「下載金鑰」。前者匯出憑證,後者匯出私密金鑰,須依更嚴格的憑據管理要求處理。交付前確認收件人、用途及檔案完整性。
- 頁面詳細資料與下載分別產生憑證,頁面指紋可能與之後下載的檔案不同。核驗交付品時應檢查實際交付的檔案,不以先前頁面指紋取代檔案檢查。
下載的私密金鑰檔案本身未加密,不應假設開啟檔案需要密碼。下載前確認受控的儲存位置與接收人;限制檔案及其副本的存取,使用組織認可的安全方式傳遞,並在不再需要時依規定清理。
更換與刪除
- **編輯名稱:**在項目操作選擇編輯。此操作只變更名稱,不會產生新金鑰或完成輪替;儲存後核對清單。
- **更換金鑰:**先建立新金鑰並核對應用程式相容性;在受控變更中調整提供者選擇及應用程式端信任,再驗證實際登入與驗證結果。舊金鑰的保留與清理時間應依既有驗證結果的檢查需要及組織規定決定。
- **刪除金鑰:**先確認沒有提供者或應用程式繼續依賴該金鑰,完成移轉及驗證。刪除可能導致驗證簽發或檢查失敗,不應假設自動切換或可還原金鑰。
**演算法相容性:**頁面中的 RSA 對應 RS256,ECDSA 對應 ES256。應用程式應依實際接入設定驗證簽章演算法與公開金鑰;目前認證探索資訊公布的簽章演算法為 RS256,不能僅因頁面可選 ECDSA 就認為應用程式會依探索資訊自動接受 ES256。如需使用 ECDSA,應先與應用程式負責人驗證實際簽發及驗證結果;無法確認時,先評估應用程式是否可使用 RSA。
**輪替時驗證既有認證:**提供者改選新金鑰後,發布給應用程式的公開金鑰會隨之切換;即使舊金鑰仍在憑證清單中,也不能假設提供者仍會同時提供舊公開金鑰。需要舊公開金鑰驗證尚未到期認證結果的應用程式可能受到影響。變更前與應用程式負責人確認既有認證結果的有效期、應用程式取得及快取公開金鑰的方式,以及可行的過渡安排;變更後分別測試新認證及仍在有效期內的舊認證結果。不要僅憑舊金鑰未刪除或新登入成功判定輪替完成。
常見問題
- **無法建立或清單沒有新項目:**檢查名稱、有效天數、金鑰類型及權限;重新核對清單並依頁面提示處理。
- **提供者無法選擇目標金鑰:**檢查金鑰是否可用、到期及提供者設定;必要時重新開啟設定或聯絡管理員。
- **編輯後金鑰沒有變更:**編輯只變更名稱;更換須另行建立金鑰、調整提供者並驗證應用程式。
- **驗證或簽章檢查失敗:**核對提供者選擇、金鑰有效期、應用程式端信任及存取授權,再依實際串接流程排查。
- **詳細資料指紋與下載檔案不同:**以實際交付檔案的檢查結果為準,不以頁面詳細資料取代檔案核驗。
更新時間