Keycloak: Struktura motywu Keycloak

Ta dokumentacja jest częścią przewodnika Dostosuj wygląd. Pełny przewodnik znajdziesz tutaj: Łatwo dostosuj strony logowania, konsolę konta oraz e-maile Keycloak na Stackhero: ustaw swoje kolory, logo, teksty, a nawet twórz w pełni własne motywy za pomocą wbudowanego edytora online..

👋 Witamy w dokumentacji Stackhero!

Stackhero oferuje usługę Keycloak cloud, która umożliwia szybkie wdrożenie gotowego do produkcji dostawcy tożsamości w zaledwie 2 minuty:

• Nieograniczona liczba użytkowników, realms i klientów
• Obsługa OpenID Connect, OAuth 2.0, SAML 2.0, logowania społecznościowego, federacji LDAP oraz Active Directory
• Własna nazwa domeny z wbudowanym HTTPS dla bezpiecznego dostępu (na przykład https://login.twoja-firma.com)
• Własne motywy: łatwo dostosuj strony logowania, konsolę konta i wiadomości email za pomocą wbudowanego edytora online
• Dedykowany serwer email z obsługą SPF, DKIM i DMARC – potwierdzenia konta i resetowanie hasła obsługiwane są automatycznie
• Wbudowana baza danych PostgreSQL, z konsolą administracyjną dostępną na osobnym, zamykanym porcie
• Aktualizacje jednym kliknięciem pozwalają utrzymać system zawsze aktualny bez ręcznej ingerencji

Skup się na rozwoju, nie na konfiguracji: możesz przetestować rozwiązanie Keycloak cloud od Stackhero w mniej niż 5 minut.

Motyw to katalog zawierający podkatalogi dla każdego typu strony:

themes/
  acme/
    login/                             # Strony logowania użytkownika
      theme.properties                 # Dziedziczenie motywu i dołączanie CSS
      resources/css/stackhero.css      # Twój CSS
      resources/img/logo.svg           # Twoje obrazy
      messages/messages_en.properties  # Twoje teksty
    account/                           # Zarządzanie profilem użytkownika
    admin/                             # Wygląd konsoli administracyjnej
    email/                             # Szablony e-maili

Motywy dziedziczą po standardowych motywach Keycloak, nadpisując tylko to, co potrzebne. Typowy plik login/theme.properties wygląda tak:

parent=keycloak.v2
styles=css/styles.css css/stackhero.css

• parent ustawia motyw bazowy.
• styles określa listę plików CSS do załadowania. Umieść swój CSS na końcu, aby mieć pewność, że zmiany zostaną zastosowane.

Lista styles zastępuje listę motywu nadrzędnego, nie rozszerza jej. Zawsze uwzględnij arkusz stylów rodzica (css/styles.css), w przeciwnym razie Twoja strona straci domyślny wygląd.

Szablony FreeMarker (.ftl) są potrzebne tylko, jeśli chcesz zmienić strukturę HTML. Do zmiany kolorów, logo, tła, tekstów i języków nie jest to wymagane. Więcej informacji znajdziesz w dokumentacji Keycloak dotyczącej motywów.