> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dbiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Xem trước các màn hình đăng nhập của Keycloak

> Keycloak không có chế độ xem trước theme. Mở thẳng các trang đăng nhập, quên mật khẩu, đăng xuất, lỗi, và dùng required actions để xem các bước còn lại.

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.

> [!TIP]
>
> 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 | URL |
| - | - |
| Đăng nhập | `https://<id-host>/realms/<realm>/account` (tự chuyển sang trang đăng nhập) |
| Quên mật khẩu | `https://<id-host>/realms/<realm>/login-actions/reset-credentials?client_id=account-console` |
| Đăng ký (chỉ khi realm bật đăng ký) | `https://<id-host>/realms/<realm>/protocol/openid-connect/registrations?client_id=account-console&response_type=code&scope=openid&redirect_uri=https%3A%2F%2F<id-host>%2Frealms%2F<realm>%2Faccount%2F` |
| Hỏi xác nhận đăng xuất | `https://<id-host>/realms/<realm>/protocol/openid-connect/logout` |
| Trang lỗi | `https://<id-host>/realms/<realm>/protocol/openid-connect/auth?client_id=khong-ton-tai&response_type=code` |
| Trang tài khoản (account console) | Đăng nhập xong ở link đầu tiên |

## 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.

```bash keycloak-dev.sh theme={null}
docker run --rm -p 8080:8080 \
  -e KC_BOOTSTRAP_ADMIN_USERNAME=admin -e KC_BOOTSTRAP_ADMIN_PASSWORD=admin \
  -v "$PWD/themes/<ten-theme>:/opt/keycloak/themes/<ten-theme>" \
  quay.io/keycloak/keycloak:<phien-ban> start-dev
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.