2023-02-20 12:58:57 +00:00
== Log in to the Admin Console
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
. Go to the {links-admin-console}.
. Log in with the username and password you created earlier.
2023-02-09 09:29:41 +00:00
2023-02-13 07:40:02 +00:00
== Create a realm
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
A realm in Keycloak is equivalent to a tenant. Each realm allows an administrator to create isolated groups of applications and users. Initially, Keycloak
includes a single realm, called `master`. Use this realm only for managing Keycloak and not for managing any applications.
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
Use these steps to create the first realm.
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
. Open the {links-admin-console}.
2023-08-16 19:35:03 +00:00
. Click the word *master* in the top-left corner, then click *Create Realm*.
2023-02-20 12:58:57 +00:00
. Enter `myrealm` in the *Realm name* field.
. Click *Create*.
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
image::add-realm.png[Add realm]
2023-02-09 09:29:41 +00:00
2023-02-13 07:40:02 +00:00
== Create a user
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
Initially, the realm has no users. Use these steps to create a user:
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
. Open the {links-admin-console}.
2023-08-16 19:35:03 +00:00
. Click the word *master* in the top-left corner, then click *myrealm*.
2023-02-20 12:58:57 +00:00
. Click *Users* in the left-hand menu.
2023-08-16 19:35:03 +00:00
. Click *Add user*.
2023-02-09 09:29:41 +00:00
. Fill in the form with the following values:
2023-02-20 12:58:57 +00:00
** *Username*: `myuser`
** *First name*: any first name
** *Last name*: any last name
. Click *Create*.
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
image::add-user.png[Create user]
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
This user needs a password to log in. To set the initial password:
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
. Click *Credentials* at the top of the page.
. Fill in the *Set password* form with a password.
. Toggle *Temporary* to *Off* so that the user does not need update this password at the first login.
2023-02-09 09:29:41 +00:00
2023-02-20 12:58:57 +00:00
image::set-password.png[Set password]
