Keycloak: Keycloak temų struktūros supratimas

Ši dokumentacija yra Pritaikyti išvaizdą vadovo dalis. Visą vadovą rasite čia: Lengvai pritaikykite Keycloak prisijungimo puslapius, paskyros konsolę ir el. laiškus Stackhero platformoje: nustatykite savo spalvas, logotipą, tekstus ir netgi kurkite visiškai individualius šablonus naudodami integruotą internetinį redaktorių..

👋 Sveiki atvykę į Stackhero dokumentaciją!

Stackhero siūlo Keycloak cloud paslaugą, kuri leidžia paprastai įdiegti gamybai paruoštą tapatybės tiekėją vos per 2 minutes:

  • Neribotas naudotojų, realms ir klientų skaičius
  • Palaikomi OpenID Connect, OAuth 2.0, SAML 2.0, socialinis prisijungimas, LDAP ir Active Directory federacija
  • Individualus domeno vardas su integruotu HTTPS saugiam prisijungimui (pavyzdžiui, https://login.jusu-imone.lt)
  • Individualūs temos: lengvai pritaikykite prisijungimo puslapius, paskyros konsolę ir el. laiškus su integruotu internetiniu redaktoriumi
  • Dedikuotas el. pašto serveris su SPF, DKIM ir DMARC, todėl paskyros patvirtinimai ir slaptažodžio atstatymai bus tvarkomi automatiškai
  • Integruota PostgreSQL duomenų bazė, administravimo konsolė pasiekiama atskiru, uždaromu prievadu
  • Vieno paspaudimo atnaujinimai leidžia sistemą nuolat palaikyti atnaujintą be rankinio įsikišimo

Skirkite laiką kūrimui, o ne konfigūravimui: Stackhero Keycloak cloud sprendimą galite išbandyti vos per 5 minutes.

Tema yra katalogas, kuriame yra poaplankiai kiekvienam puslapio tipui:

themes/
  acme/
    login/                             # Naudotojo prisijungimo puslapiai
      theme.properties                 # Temos paveldėjimas ir CSS įtraukimas
      resources/css/stackhero.css      # Jūsų CSS
      resources/img/logo.svg           # Jūsų paveikslėliai
      messages/messages_en.properties  # Jūsų tekstai
    account/                           # Naudotojo profilio valdymas
    admin/                             # Administravimo konsolės išvaizda
    email/                             # El. laiškų šablonai

Temos paveldi iš standartinių Keycloak temų, perrašydamos tik tai, kas būtina. Tipinis login/theme.properties failas atrodo taip:

parent=keycloak.v2
styles=css/styles.css css/stackhero.css
  • parent nurodo bazinę temą.
  • styles išvardija CSS failus, kuriuos reikia įkelti. Savo CSS įrašykite paskutinį, kad pakeitimai būtų pritaikyti.

styles sąrašas pakeičia tėvinės temos sąrašą, o ne jį papildo. Visada įtraukite tėvinės temos stilių (css/styles.css), kitaip jūsų puslapis praras numatytąjį stilių.

FreeMarker šablonų (.ftl failų) reikia tik jei norite keisti HTML struktūrą. Spalvoms, logotipams, fonams, tekstams ir kalboms šablonų redaguoti nereikia. Daugiau informacijos rasite Keycloak temų dokumentacijoje.