Công cụ dành cho nhà phát triển giải pháp

Chạy Keycloak trên local với FlyEnv

Keycloak dùng Java và một cơ sở dữ liệu, với proxy cục bộ khi kiểm thử xác thực trên trình duyệt. FlyEnv quản lý các phụ thuộc cục bộ của dịch vụ danh tính đó.

Tải xuống FlyEnv Tài liệu chính thức

Stack dự án local

Các dịch vụ FlyEnv có thể quản lý cho Keycloak

Giới thiệu Keycloak

Keycloak là server quản lý danh tính và truy cập cho single sign-on, OAuth 2.0, OpenID Connect, SAML và identity brokering. Các khái niệm cốt lõi của nó là realm, client, user, role, group, scope và luồng xác thực, mà các ứng dụng tiêu thụ qua các giao thức chuẩn.

Phát triển Keycloak local chủ yếu xoay quanh issuer URL ổn định và redirect URI thực tế. Server phát triển có thể dùng cơ sở dữ liệu phát triển, trong khi PostgreSQL là điển hình cho realm local bền vững; liên kết user ngoài, SMTP và HTTPS reverse proxy chỉ nên được bổ sung khi các luồng đó đang được kiểm thử.

Các khả năng cốt lõi

Realm và client
OAuth 2.0 và OpenID Connect
SAML
Luồng xác thực
Identity brokering
Liên kết user

Các trường hợp sử dụng phổ biến

Single sign-on cho ứng dụng
Kiểm thử tích hợp OAuth/OIDC
Quản lý role tập trung
Liên kết identity provider

Kiểm thử Keycloak phụ thuộc vào issuer và URL chuyển hướng

Server auth và kho realm bền vững là thiết yếu; các dịch vụ khác xuất phát từ kịch bản xác thực.

Server Keycloak và nhập realm: Chạy identity provider và có thể tải các client, role và user kiểm thử có thể lặp lại.
PostgreSQL cho realm bền vững: Phổ biến cho dữ liệu danh tính local bền vững; chế độ phát triển có thể dùng tùy chọn hỗ trợ khác để thử nghiệm nhanh.
Tên miền HTTPS và redirect URI: Giúp client trình duyệt, cookie, CORS và xác thực callback hoạt động như một môi trường tích hợp.
SMTP hoặc IdP ngoài tùy chọn: Chỉ cần cho xác minh email, khôi phục mật khẩu hoặc luồng đăng nhập qua broker.

Tài nguyên dự án

Để xem các lệnh cài đặt, phiên bản hỗ trợ và cấu hình riêng của dự án, hãy tham khảo tài liệu chính thức của Keycloak .

Stack local điển hình

Các dịch vụ cụ thể phụ thuộc vào dự án, phiên bản phát hành và cấu hình local của nó. Đây là một thiết lập local phổ biến, không phải yêu cầu cố định.

Thành phần	Vai trò điển hình
Java	Chạy Java cho môi trường local của Keycloak.
PostgreSQL MySQL	Chạy PostgreSQL / MySQL cho môi trường local của Keycloak.
Nginx Caddy	Chạy Nginx / Caddy cho môi trường local của Keycloak.

FlyEnv giúp gì

Khớp runtime dự án
Chọn phiên bản runtime mà Keycloak yêu cầu.
Quản lý dịch vụ local
Chỉ khởi động cơ sở dữ liệu, cache và các dịch vụ khác khi dự án cần.
Giữ dự án tách biệt
Để mỗi dự án dùng các phiên bản và cấu hình dịch vụ riêng.
Cấu hình tên miền local
Truy cập dự án qua tên miền local và HTTPS khi cần.

Thiết lập môi trường local

Việc cài đặt dự án vẫn thuộc tài liệu chính thức của dự án. FlyEnv quản lý các runtime, cơ sở dữ liệu, web server và các dịch vụ hỗ trợ xung quanh nó.