Mengganti Email Template Keycloak

Hay Teman- teman kali ini saya akan share tentang mengganti email keycloak. Sebelum itu apa sih keycloak itu.

Keycloak adalah sebuah software buatan RedHat untuk kepentingan oauth atau tempat menyimpan data user untuk login dan sebagainya. Keycloak ini lumayan lengkap fiturnya di antaranya yaitu Single Sign on yaitu user bisa login di beberapa device tanpa mengeluarkan user dari salah satu device dengan akses token yang berbeda namun keamana masih terjamin.

Dan salah satu fiture Keycloak juga adanya fiture verifikasi akun lewat email. Email keycloak ini kita dapat atur di admin consule dan masuk ke realm dan pilih ke menu email di situ dapat mengatur email yang akan gunakan sebagai sender

untuk tampilan depan keycloak menggunakan html ,css,js dan di satukan dengan freemaker template atau .ftl . Freemaker template ini adalah sebuah Bahasa templating yang dapat memasukan objecting object java ke dalam Bahasa html,css dan java script.

Setelah sekilas tentang keycloak kita coba untuk konfigurasi untuk merubah template email keycloak

Pertama kita rubah konfigurasi standalone.xml nya agar tidak tercache configurasi yang lama

Caranya masuk ke

keycloak-3.1.0.Final/standalone/configuration

setelah itu masuk ke file standalone.xml

cari di bagian

 <theme>  
    <staticMaxAge>2592000</staticMaxAge>  
    <cacheThemes>true</cacheThemes>  
    <cacheTemplates>true</cacheTemplates>    
    <dir>${jboss.home.dir}/themes</dir>       
 </theme>  

setelah itu di ganti menjadi:

 <theme>  
       <staticMaxAge>-1</staticMaxAge>  
       <cacheThemes>false</cacheThemes>  
       <cacheTemplates>false</cacheTemplates>              
     <dir>${jboss.home.dir}/themes</dir>              
  </theme>  

Setelah di ganti kita save .

Kemudian kita bisa rubah konfigurasi template emailnya dan halaman aktivasi

Pertama kita rubah dulu halaman aktivasi akun login caranya

Kita ke folder

keycloak-3.1.0.Final/themes

di dalam folder themes ada folder atau package base dan keycloak untuk merubah tampilan untuk itu kita copy package yang ada di dalam folder themes. Rubah nama keycloak yang telah di copy menjadi nama theme yang akan di gunakan misal cari-parkir.

Setelah itu masuk ke folder

 keycloak-3.1.0.Final/themes/cari-parkir/login/resources/css

terdapat login.css, buka foldernya rubah css sedikit untuk coustume css nya bisa di lihat di link ini  dan costume image di  sini. Setelah itu save lalu jalankan keycloak dengan cara

masuk ke folder

 keycloak-3.1.0.Final/bin

lalu jalankan dengan cara  

./standalone.sh

 setelah itu masuk ke admin consule dengan cara ketik localhost:8080 di browser

login dan masuk ke realms yang digunakan lalu pilih ke menu theme rubah Login Theme menjadi theme cari-parkir

setelah itu save dan coba logout maka tapilannya akan seperti ini

setelah tampilan login di buat maka kita akan merubah template email nya

caranya masuk ke folder theme lalu copy package base dan beri nama cari-parkir-email

lalu masuk ke folder

keycloak-3.1.0.Final/themes/cari-parkir-email/email/html

lalu buka file

 executeActions.ftl

rubah tampilan dengan costume yang sudah di buat saya menggunakan costume di link ini. Copykan fie ke executeAction.ftl setelah itu save lalu rubah theme email di admin consule

 setelah itu coba untuk menambahkan user dengan service backend

maka akan muncul di email

Referensi:

~ http://www.keycloak.org/docs/latest/server_development/index.html#theme-properties