רישום עצמי של משתמש Keycloak
1. סקירה כללית
אנו יכולים להשתמש ב- Keycloak כשרת הרשאות של צד שלישי לניהול משתמשים ביישומי האינטרנט או הסלולר שלנו.
למרות שמנהל יכול להוסיף משתמשים, ל- Keycloak יש גם אפשרות לאפשר למשתמשים להירשם בעצמם. בנוסף, יחד עם מאפייני ברירת מחדל כגון שם פרטי, שם משפחה ודואר אלקטרוני, אנו יכולים גם להוסיף תכונות משתמש נוספות ספציפיות לצורך היישום שלנו.
במדריך זה נראה כיצד נוכל לאפשר רישום עצמי ב- Keycloak ולהוסיף שדות מותאמים אישית בדף רישום המשתמשים.
אנו בונים על התאמה אישית של דף הכניסה, כך שיעזור לעבור עליו תחילה לצורך ההתקנה הראשונית.
2. שרת עצמאי
ראשית נראה רישום עצמי של משתמשים לשרת Keycloak עצמאי.
2.1. הפעלת רישום משתמשים
בתחילה עלינו לאפשר ל- Keycloak לאפשר רישום משתמשים. לשם כך, ראשית נצטרך להפעיל את השרת על ידי הפעלת פקודה זו ממפיצות Keycloak שלנו פַּח תיקיה:
./standalone.sh -Djboss.socket.binding.port-offset = 100ואז עלינו לעבור למסוף הניהול ולהכניס את ה- ראשוני 1/zaq1! QAZ אישורים.
הבא, ב התחברות הכרטיסייה על הגדרות תחום בדף, נעבור בין רישום משתמשים לַחְצָן:
זה הכל! אנחנו רק צריכים ללחוץ להציל והרשמה עצמית מופעלת.
אז עכשיו נקבל קישור בשם להירשם בדף הכניסה:
שוב, זכור כי הדף נראה שונה מדף הכניסה המוגדר כברירת מחדל של Keycloak מכיוון שאנו מרחיבים את ההתאמות האישיות שעשינו קודם.
קישור ההרשמה לוקח אותנו אל להירשם עמוד:
כמו שאנו יכולים לראות, דף ברירת המחדל כולל את התכונות הבסיסיות של משתמש Keycloak.
בחלק הבא נראה כיצד נוכל להוסיף תכונות נוספות לבחירתנו.
2.2. הוספת תכונות משתמש מותאמות אישית
בהמשך לנושא המותאם אישית שלנו, בואו להעתיק את התבנית הקיימת base / login / register.ftl שלנו מותאם אישית / כניסה תיקיה.
כעת ננסה להוסיף שדה חדש dob ל תאריך לידה. לשם כך נצטרך לשנות את האמור לעיל register.ftl והוסף את זה:
תאריך לידה עַכשָׁיו כאשר נרשם משתמש חדש בדף זה, אנו יכולים להזין אותו תאריך לידה גם כן:
כדי לאמת, בוא נפתח את משתמשים בדף במסוף הניהול ובחיפוש ג'יין:
הבא, בוא נלך אל ג'ייןשל תכונות ובדוק את DOB:
כפי שניכר, אותו תאריך לידה מוצג כאן כפי שהזנו בטופס הרישום העצמי.
3. שרת מוטבע
עכשיו בואו נראה כיצד נוכל להוסיף תכונות מותאמות אישית לרישום עצמי לשרת Keycloak המוטמע ביישום Spring Boot.
זהה לשלב הראשון עבור השרת העצמאי, עלינו לאפשר רישום משתמשים בהתחלה.
אנו יכולים לעשות זאת על ידי הגדרה רישום מותר ל נָכוֹן בקובץ הגדרת התחום שלנו, baeldung-realm.json:
"registrationAllowed": נכון,אחרי זה, אנחנו צריכים לְהוֹסִיף תאריך לידה ל register.ftl, בדיוק באותה דרך כמו שנעשתה בעבר.
לאחר מכן, בואו נעתיק את הקובץ הזה ל src / main / resources / theme / custom / login מַדרִיך.
כעת עם הפעלת השרת, דף הכניסה שלנו נושא את קישור ההרשמה. הנה דף הרישום העצמי עם השדה המותאם אישית שלנו תאריך לידה:
חשוב לזכור כי המשתמש שנוסף באמצעות דף הרישום העצמי של השרת המוטמע הוא חולף.
מכיוון שלא הוספנו משתמש זה לקובץ התצורה מראש, הוא לא יהיה זמין בהפעלה מחדש של השרת. עם זאת, זה שימושי בשלב הפיתוח, כאשר אנו בודקים רק עיצוב ופונקציונליות.
כדי לבדוק, לפני הפעלה מחדש של השרת, אנו יכולים לוודא שהמשתמש מתווסף אליו DOB כתכונה מותאמת אישית מקונסולת הניהול. אנו יכולים גם לנסות להתחבר באמצעות אישורי המשתמש החדש.
4. מסקנה
במדריך זה, למדנו כיצד לאפשר רישום עצמי של משתמשים ב- Keycloak. ראינו גם כיצד להוסיף תכונות מותאמות אישית בזמן ההרשמה כמשתמש חדש.
בדקנו דוגמאות כיצד לעשות זאת הן למצב עצמאי והן למופע משובץ.
כמו תמיד, קוד המקור זמין ב- GitHub. עבור השרת העצמאי, זה נמצא במדריכי GitHub ובמופע המוטמע ב- OAuth GitHub.
