2016-05-05 20:10:58 +00:00
|
|
|
[[_create-realm]]
|
2020-06-18 01:54:58 +00:00
|
|
|
=== Creating a realm
|
2016-05-05 20:10:58 +00:00
|
|
|
|
2020-06-18 01:54:58 +00:00
|
|
|
As the admin in the master realm, you create the realms where administrators create users and applications.
|
2016-05-05 20:10:58 +00:00
|
|
|
|
2020-06-18 01:54:58 +00:00
|
|
|
.Prerequisites
|
2016-12-12 20:20:58 +00:00
|
|
|
|
2020-06-18 01:54:58 +00:00
|
|
|
* {project_name} is installed.
|
|
|
|
* You have the initial admin account for the admin console.
|
2016-05-05 20:10:58 +00:00
|
|
|
|
2020-06-18 01:54:58 +00:00
|
|
|
.Procedure
|
2016-05-05 20:10:58 +00:00
|
|
|
|
2020-06-18 01:54:58 +00:00
|
|
|
. Go to http://localhost:8080/auth/admin/ and log in to the {project_name} admin console using the admin account.
|
2016-05-05 20:10:58 +00:00
|
|
|
|
2020-06-18 01:54:58 +00:00
|
|
|
. From the *Master* menu, click *Add Realm*. When you are logged in to the master realm, this menu lists all other realms.
|
2016-05-05 20:10:58 +00:00
|
|
|
|
2020-06-18 01:54:58 +00:00
|
|
|
. Type `demo` in the *Name* field.
|
|
|
|
+
|
|
|
|
.A new realm
|
|
|
|
image:{project_images}/add-demo-realm.png[]
|
|
|
|
+
|
|
|
|
NOTE: The realm name is case-sensitive, so make note of the case that you use.
|
2016-05-05 20:10:58 +00:00
|
|
|
|
2020-06-18 01:54:58 +00:00
|
|
|
. Click *Create*.
|
|
|
|
+
|
|
|
|
The main admin console page opens with realm set to `demo`.
|
|
|
|
+
|
|
|
|
.Demo realm
|
|
|
|
image:{project_images}/demo-realm.png[]
|
2016-05-05 20:10:58 +00:00
|
|
|
|
2020-06-18 01:54:58 +00:00
|
|
|
. Switch between managing the `master` realm and the realm you just created by clicking entries in the *Select realm* drop-down list.
|