streamalism.org

1. Pregled

Keycloak možemo koristiti kao nezavisni poslužitelj za autorizaciju za upravljanje korisnicima naših web ili mobilnih aplikacija.

Iako je administratoru moguće dodati korisnike, Keycloak također ima mogućnost dopustiti korisnicima da se sami registriraju. Uz to, uz zadane atribute kao što su ime, prezime i e-pošta, možemo dodati i dodatne korisničke atribute specifične za potrebe naše aplikacije.

U ovom uputstvu ćemo vidjeti kako možemo omogućiti samoregistraciju na Keycloak-u i dodati prilagođena polja na stranici za registraciju korisnika.

Nadamo se prilagođavanju stranice za prijavu, pa bi bilo korisno prvo proći kroz nju za početno postavljanje.

2. Samostalni poslužitelj

Prvo ćemo vidjeti samoregistraciju korisnika za samostalni poslužitelj Keycloak.

2.1. Omogućavanje registracije korisnika

U početku moramo omogućiti Keycloak da omogući registraciju korisnika. Za to ćemo prvo trebati pokrenuti poslužitelj pokretanjem ove naredbe iz naše distribucije Keycloak-a kanta za smeće mapa:

./standalone.sh -Djboss.socket.binding.port-offset = 100

Zatim moramo otići na administratorsku konzolu i unijeti početni1/zaq1! QAZ vjerodajnice.

Dalje, u Prijaviti se na kartici Postavke carstva stranicu, prebacit ćemo Registracija korisnika dugme:

To je sve! Samo trebamo kliknuti Uštedjeti i omogućuje se samoregistracija.

Pa sad dobit ćemo vezu s imenom Registar na stranici za prijavu:

Opet se prisjetimo da stranica izgleda drugačije od zadane stranice za prijavu Keycloaka jer proširujemo prilagodbe koje smo radili ranije.

Poveznica registra vodi nas do Registar stranica:

Kao što vidimo, zadana stranica uključuje osnovne atribute korisnika Keycloak-a.

U sljedećem ćemo odjeljku vidjeti kako možemo dodati dodatne atribute po svom izboru.

2.2. Dodavanje korisničkih atributa korisnika

Nastavljajući s našom prilagođenom temom, kopirajmo postojeći predložak baza / prijava / registracija.ftl našem običaj / prijava mapu.

Sada ćemo pokušati dodati novo polje dob za Datum rođenja. Za to ćemo morati izmijeniti gore navedeno registar.ftl i dodajte ovo:

 Datum rođenja 

Sada kada na ovoj stranici registriramo novog korisnika, možemo unijeti njegovu Datum rođenja također:

Da bismo provjerili, otvorimo Korisnici stranicu na administratorskoj konzoli i pretraživanju Jane:

Dalje, idemo na Jane‘S Atributi i provjerite DOB:

Kao što je vidljivo, ovdje je prikazan isti datum rođenja kao što smo unijeli u obrazac za samoregistraciju.

3. Ugrađeni poslužitelj

Sada da vidimo kako možemo dodati prilagođene atribute za samoregistraciju za poslužitelj Keycloak ugrađen u aplikaciju Spring Boot.

Kao i prvi korak za samostalni poslužitelj, na početku moramo omogućiti registraciju korisnika.

To možemo učiniti postavljanjem registracijaDopušteno do pravi u našoj datoteci definicije carstva, baeldung-carstvo.json:

"registrationAllowed": istina,

Nakon toga trebamo dodati Datum rođenja do registar.ftl, potpuno na isti način kao i ranije.

Dalje, kopirajmo ovu datoteku u našu src / main / resources / themes / custom / login imenik.

Nakon pokretanja poslužitelja, naša stranica za prijavu sadrži vezu za registraciju. Evo stranice za samoregistraciju s našim prilagođenim poljem Datum rođenja:

Važno je imati na umu da korisnik dodan putem stranice za samoregistraciju za ugrađeni poslužitelj je privremen.

Budući da ovog korisnika nismo dodali u datoteku predkonfiguracije, neće biti dostupna pri ponovnom pokretanju poslužitelja. Međutim, ovo dobro dođe tijekom razvojne faze, kada provjeravamo samo dizajn i funkcionalnost.

Da bismo testirali, prije ponovnog pokretanja poslužitelja možemo provjeriti je li korisnik dodan s DOB kao prilagođeni atribut s administratorske konzole. Također se možemo pokušati prijaviti koristeći vjerodajnice novog korisnika.

4. Zaključak

U ovom vodiču, naučili smo kako omogućiti samoregistraciju korisnika u Keycloak-u. Također smo vidjeli kako dodati prilagođene atribute prilikom registracije kao novi korisnik.

Pregledali smo primjere kako to učiniti i za samostalnu i za ugrađenu instancu.

Kao i uvijek, izvorni kod dostupan je na GitHub-u. Za samostalni poslužitelj nalazi se na vodičima GitHub, a za ugrađenu instancu na OAuth GitHub.