Skip to main content
Trang quản trị Keycloak chỉ cho chọn theme cho từng loại (Realm settings, tab Themes: login, account, email, admin), không có chỗ xem trước các màn hình. Muốn kiểm giao diện sau khi đổi theme, hãy mở thẳng từng trang của realm theo hướng dẫn dưới đây.
Mở các link trong cửa sổ ẩn danh để không dính phiên đang đăng nhập.

Màn hình mở thẳng được

Màn hình nằm giữa luồng đăng nhập

Các màn hình cài OTP, đổi mật khẩu, xác minh email, cập nhật hồ sơ chỉ hiện khi người dùng có việc cần làm. Dùng một tài khoản thử để gọi chúng ra:
1

Tạo tài khoản thử

Trong trang quản trị, vào Users và tạo một user dùng để thử.
2

Gắn required actions

Mở user đó, ở Required user actions chọn các bước cần xem: Configure OTP, Update Password, Verify Email, Update Profile.
3

Đăng nhập bằng user thử

Đăng nhập ở link đăng nhập trên. Keycloak lần lượt hiện từng màn hình đã chọn.

Email

Vào Realm settings, tab Email, bấm Test connection để gửi một email mẫu bằng theme email đang chọn. Tài khoản quản trị đang dùng phải có email thì mới thử được. Các email khác (quên mật khẩu, xác minh email) chỉ thấy khi chạy đúng luồng ở phần trên.

Khi đang phát triển theme

Keycloak chạy chế độ production có bộ đệm theme, nên mỗi lần sửa theme phải đóng gói lại và khởi động lại Keycloak mới thấy. Để xem nhanh khi đang sửa:
  • Chạy Keycloak trên máy với start-dev, gắn thư mục theme vào /opt/keycloak/themes. Chế độ dev không đệm theme nên tải lại trang là thấy thay đổi.
  • Nếu theme làm bằng Keycloakify, dùng Storybook có sẵn của nó để xem gần như mọi trang đăng nhập mà không cần chạy Keycloak.
keycloak-dev.sh