Cấu hình KeyCloak để sử dụng với Adobe SSO

Cập nhật gần đây nhất vào 29 thg 10, 2026

Thiết lập KeyCloak làm nhà cung cấp danh tính (IdP) SAML để người dùng của bạn có thể đăng nhập vào các ứng dụng và dịch vụ Adobe bằng thông tin xác thực của tổ chức.

Trước khi bắt đầu

Đảm bảo bạn có:

  • Vai trò quản trị hệ thống trong Adobe Admin Console
  • Quyền truy cập quản trị viên vào realm KeyCloak xác thực người dùng Adobe của bạn
  • Một miền mà bạn có thể xác minh và thêm vào thư mục
Mẹo

Đảm bảo địa chỉ email của mỗi người dùng thuộc về một miền đã được xác nhận trong Admin Console. KeyCloak sử dụng địa chỉ email làm định danh người dùng.

Tạo thư mục và tải xuống siêu dữ liệu Adobe

Đăng nhập vào Admin Console, di chuyển đến Thiết đặt > Identity > Directories, và chọn Create Directory.

Nhập tên thư mục, chọn Federated ID, sau đó chọn Tiếp theo.

Chọn Nhà cung cấp SAML khác, sau đó chọn Tiếp theo.

Trên màn hình Thiết lập IdP, chọn Tải xuống tệp siêu dữ liệu Adobe.Giữ màn hình này mở để thực hiện bước tiếp theo.

Nhập ứng dụng khách Adobe vào KeyCloak

Đăng nhập vào KeyCloak Admin Console và chọn realm xác thực người dùng Adobe của bạn.

Chọn Ứng dụng khách > Nhập ứng dụng khách.

Trong Tệp tài nguyên, chọn Duyệt và tải lên tệp siêu dữ liệu Adobe.KeyCloak điền ID thực thể, ACS URL, chứng nhận và các thiết đặt SAML khác của Adobe từ tập tin này.

Ghi chú

Nhập tập tin siêu dữ liệu Adobe thay vì tạo ứng dụng khách theo cách thủ công. Điều này đảm bảo KeyCloak sử dụng chính xác các thiết đặt SAML của Adobe.

Trong Tên, nhập Adobe Identity Management – <tên tổ chức của bạn>, sau đó chọn Lưu.

Xác minh các thiết đặt đã nhập:

  • Các URI chuyển hướng hợp lệ hiển thị URL ACS của Adobe.
  • Định dạng Name ID là email.
  • Chức năng ký đã được bật trong mục Signature and Encryption.
  • Tab Keys hiển thị Chứng nhận của Adobe.

Ánh xạ thuộc tính người dùng

Adobe yêu cầu địa chỉ email, tên và họ của người dùng trong xác nhận SAML. Tạo một client scope để gửi các thông tin này.

Trong bảng điều hướng, chọn Client scopes > Create client scope.

Nhập Adobe Identity Scope làm tên, chọn SAML làm giao thức, sau đó chọn Save.

Trên tab Mappers, chọn Configure a new mapper (hoặc Add mapper > By configuration), sau đó chọn User Attribute.

Nhập giá trị cho thuộc tính đầu tiên trong bảng sau. Để SAML Attribute NameFormat ở mức Unspecified và tắt Aggregate attribute values, sau đó chọn Save.

Nhập thuộc tính người dùng
Nhập thuộc tính người dùng.

Lặp lại bước 3 và 4 cho từng thuộc tính trong bảng.

 

Ghi chú

CountryCode không phải là thuộc tính có sẵn trong KeyCloak. Để gửi thuộc tính này, trước tiên hãy thêm một thuộc tính người dùng tùy chỉnh trong Realm settings > User profile để lưu mã quốc gia ISO 3166-1 gồm hai chữ cái.

Chọn Clients, chọn client của Adobe, sau đó chọn tab Client scopes.

Chọn Add client scope, chọn Adobe Identity Scope, sau đó chọn Add > Default.

Tải lên metadata của KeyCloak vào Admin Console

Trong KeyCloak, chuyển đến Realm settings > General > Endpoints và chọn SAML 2.0 Identity Provider Metadata.

Lưu tập tin XML mở ra, chẳng hạn như keycloak-idp-metadata.xml.

Quay lại màn hình Set up IdP trong Adobe Admin Console, tải lên tập tin metadata của KeyCloak, sau đó chọn Next.

Giữ tính năng tự động tạo tài khoản ở trạng thái bật.Nếu tổ chức của bạn cấp người dùng theo cách thủ công, hãy tắt thiết đặt này.

Trong Attribute mappings, chọn quốc gia mặc định, sau đó chọn Done.

Tiếp theo, xác minh quyền sở hữu miền và thêm miền vào thư mục nếu bạn chưa thực hiện.

Kiểm tra đăng nhập một lần

Trong Admin Console, chuyển đến Thiết đặt > Nhận dạng > Thư mục, sau đó chọn thư mục của bạn.

Trong bảng thông tin chi tiết thư mục, chọn Kiểm tra.

Đăng nhập với vai trò người dùng KeyCloak. Xác nhận rằng trang Xác thực IdP thành công hiển thị các giá trị dự kiến cho từng thuộc tính.

Trang xác thực IdP thành công của Admin Console
Xác nhận xác thực IdP thành công.

Nếu thiếu thuộc tính, hãy kiểm tra mapper của thuộc tính đó và xác nhận rằng Adobe Identity Scope là phạm vi mặc định trên ứng dụng khách Adobe. Đối với các vấn đề khác, hãy xem Khắc phục lỗi đăng nhập Federated ID (SSO) hoặc thực hiện truy vết SAML. Để được hỗ trợ về cấu hình, hãy chuyển đến Admin Console > Hỗ trợ để liên hệ với Adobe Customer Care.