2016-11-29 15:30:53 +00:00
[[_getting_started_hello_world_create_realm]]
2016-12-01 14:32:11 +00:00
=== Creating a Realm and a User
2016-06-17 00:14:05 +00:00
2016-11-15 21:34:20 +00:00
The first step is to create a realm and a user in that realm. The realm consists of:
2016-06-17 00:14:05 +00:00
* A single user
2016-11-29 15:30:53 +00:00
* A single client application, which then becomes a <<fake/../../../overview/terminology.adoc#_overview_terminology, resource server>> for which you need to enable authorization services.
2016-06-17 00:14:05 +00:00
2016-11-15 21:34:20 +00:00
To create a realm and a user complete the following steps:
2016-11-29 15:30:53 +00:00
. Create a realm with a name *hello-world-authz*. Once created, a page similar to the following is displayed:
+
2016-06-17 00:14:05 +00:00
.Realm hello-world-authz
2017-01-05 16:54:31 +00:00
image:../../../{{book.images}}/getting-started/hello-world/create-realm.png[alt="Realm hello-world-authz"]
2016-06-17 00:14:05 +00:00
2016-11-29 15:30:53 +00:00
. Create a user for your newly created realm. Click *Users*. The user list page opens.
2016-06-17 00:14:05 +00:00
2016-11-29 15:30:53 +00:00
. On the right side of the empty user list, click *Add User*.
2016-06-17 00:14:05 +00:00
2017-02-16 19:15:37 +00:00
. To create a new user with the username of *alice*, complete the *Username*, *Email*, *First Name*, and *Last Name* fields.
2017-02-16 18:54:45 +00:00
Click the *User Enabled* switch to *On*, and then click *Save*.
2016-11-29 15:30:53 +00:00
+
2016-06-17 00:14:05 +00:00
.Add User
2017-01-05 16:54:31 +00:00
image:../../../{{book.images}}/getting-started/hello-world/create-user.png[alt="Add User"]
2016-06-17 00:14:05 +00:00
2016-11-29 15:30:53 +00:00
. Set a password for the *alice* user by clicking the *Credentials* tab.
+
2016-06-17 00:14:05 +00:00
.Set User Password
2017-01-05 16:54:31 +00:00
image:../../../{{book.images}}/getting-started/hello-world/reset-user-pwd.png[alt="Set User Password"]
2016-06-17 00:14:05 +00:00
2016-11-29 15:30:53 +00:00
. Complete the *New Password* and *Password Confirmation* fields with a password and click the *Temporary* switch to *OFF*.
2016-11-15 21:34:20 +00:00
2017-02-16 18:54:45 +00:00
. Click *Reset Password* to set the user's password.