Create Keycloak Mappers for Hogarama - Gepardec/Hogarama GitHub Wiki
Hogarama needs the following 4 informations from keycloak for identifying the user and further processing.
- name
- given name
- family name
Therefore mappers in the Keycloak client need to be defined. For now this process is not automated and this step has to be done manually at the moment.
Where is the mappers option in Keycloak for Hogarama?
-
Login to the Keycloak administration console (https://keycloak-hogarama.apps.steppe.gepaplexx.com/auth/admin/)
-
Go to
Clients
--> hogarama-frontend
- Go to the
Mappers
-Tab
Create the Mappers for Hogarama
Add Builtin mappers
Three of the informations mentioned at the beginning of this document can be mapped by builtin mappers.
- In the
Mappers
Tab click onAdd Builtin
- Choose
email
,family name
andgiven name
- Confirm with
Add selected
Create custom mapper
The name
property is not builtin and need to be configured manually.
- In the
Mappers
Tab click onCreate
- Create the Mapper with the following settings:
- Name:
name
- Mapper Type:
User Property
- Property:
username
- Token Claim Name:
name
- Name:
- Click on
Save
The following screenshot shows the properties described in step 2:
Analyze the Bearer Token
Hogarama shows your Bearer Token after the login. You can decode this Bearer Token on https://jwt.io/ to see the attributes in readable form. Look out for the attributes name
, given_name
, family_name
and email
.