登入 Admin Console，前往設定 > 身分 > 目錄，然後選取建立目錄。
上次更新時間
2026年11月2日
設定 KeyCloak 作為 SAML 身分提供者 (IdP)，讓您的使用者可以用組織認證登入 Adobe 應用程式和服務。
開始之前
請確保您具備以下條件：
- Adobe Admin Console 中的系統管理員角色
- 對驗證您 Adobe 使用者的 KeyCloak realm 擁有管理員存取權
- 您可以驗證並新增至目錄的網域
秘訣
請確保每位使用者的電子郵件都屬於已在Admin Console中聲明的網域。KeyCloak 會使用電子郵件作為使用者識別碼。
建立目錄並下載 Adobe 中繼資料
輸入目錄名稱，選取 Federated ID，然後選取下一步。
選取其他 SAML 提供者，然後選取下一步。
在設定 IdP畫面中，選取下載 Adobe 中繼資料檔案。請保持此畫面開啟，以進行下一步。
將 Adobe 用戶端匯入 KeyCloak
登入 KeyCloak Admin Console，並選取用來驗證 Adobe 使用者的 realm。
選取用戶端 > 匯入用戶端。
在資源檔案下方，選取瀏覽並上傳 Adobe 中繼資料檔案。KeyCloak 會從該檔案自動填入 Adobe 的實體 ID、ACS URL、憑證及其他 SAML 設定。
備註
請匯入 Adobe 中繼資料檔案，而非手動建立用戶端。這樣可確保 KeyCloak 使用 Adobe 準確的 SAML 設定。
在名稱中，輸入 Adobe Identity Management – <您的組織名稱>，然後選取儲存。
請驗證匯入的設定:
- 有效的重新導向 URI會顯示 Adobe ACS URL。
- 名稱 ID 格式為 email。
- 已在簽章和加密下方開啟簽署功能。
- 金鑰分頁會顯示 Adobe 的憑證。
對應使用者屬性
Adobe 要求 SAML assertion 中包含使用者的電子郵件地址、名字和姓氏。建立可傳送這些屬性的用戶端範圍。
在導覽面板中，選取 用戶端範圍 > 建立用戶端範圍。
輸入 Adobe Identity Scope 作為名稱，選取 SAML 作為通訊協定，然後選取 儲存。
在「對應程式」標籤中，選取 設定新的對應程式 (或 新增對應程式 > 依設定)，然後選取 使用者屬性。
請在下表中輸入第一個屬性的值。將 SAML Attribute NameFormat 保留為 Unspecified，並將 彙總屬性值 保持關閉，然後選取 儲存。
請對表格中的每個屬性重複步驟 3 和 4。
備註
CountryCode 並非 KeyCloak 內建屬性。若要傳送此屬性，請先在 Realm 設定 > 使用者設定檔 中新增用於儲存兩字母 ISO 3166-1 國家代碼的自訂使用者屬性。
選取 用戶端，選取 Adobe 用戶端，然後選取「用戶端範圍」標籤。
選取 新增用戶端範圍，選取 Adobe Identity Scope，然後選取 新增 > 預設。
將 KeyCloak 中繼資料上傳至 Admin Console
在 KeyCloak 中，前往 Realm 設定 > 一般 > 端點，然後選取 SAML 2.0 Identity Provider Metadata。
將開啟的 XML 另存為檔案，例如 keycloak-idp-metadata.xml。
返回 Adobe Admin Console 中的設定 IdP 畫面，上傳 KeyCloak 中繼資料檔案，然後選取下一步。
請將自動建立帳戶功能保持開啟。如果您的組織是以手動方式佈建使用者，請關閉此設定。
在「屬性對應」下，選取預設國家，然後選取 完成。
測試單一登入
在 Admin Console 中，前往設定 > 身分 > 目錄，然後選取您的目錄。
在目錄詳細資料面板中，選取 測試。
以 KeyCloak 使用者身分登入。確認 IdP 驗證成功 頁面列出每個屬性的預期值。
如果屬性遺失，請檢查其對應器，並確認 Adobe Identity Scope 是 Adobe 用戶端上的預設範圍。如需其他問題，請參閱解決 Federated ID (SSO) 登入錯誤，或執行 SAML 追蹤。如需設定方面的協助，請前往 Admin Console > 支援 聯絡 Adobe 客戶服務。
