first realm

SUMMARY.adoc

@@ -11,6 +11,10 @@
  .. link:topics/first-boot/boot.adoc[Boot Server]
  .. link:topics/first-boot/initial-user.adoc[Create Admin Account]
  .. link:topics/first-boot/admin-console.adoc[Login Into Admin Console]
- . link:topics/first-realm-user.adoc[Creating Your First Realm and User]
+ . link:topics/first-realm.adoc[Creating Your First Realm and User]
+ .. link:topics/first-realm/before.adoc[Before You Start]
+ .. link:topics/first-realm/realm.adoc[Create a New Realm]
+ .. link:topics/first-realm/user.adoc[Create a New User]
+ .. link:topics/first-realm/account.adoc[User Account Service]
  . link:topics/first-jboss-servlet.adoc[Securing a JBoss Servlet Application]
  .. link:topics/installation/system-requirements.adoc[System Requirements]

topics/first-boot.adoc

@@ -1,3 +1,5 @@
+[[_install-boot]]
+
 == Install and Boot
 
 This very short tutorial walks you through booting up the server in standalone mode, setting up the initial admin user,

topics/first-realm.adoc

@@ -0,0 +1,6 @@
+
+== Create a Realm and User
+
+This short tutorial walks you through creating a new realm within the {{book.project.name}} Admin Console and adding
+a new user to that realm.  With that new user you will log into your new realm and visit the built-in User Account
+service that all users have access to.

topics/first-realm/account.adoc

@@ -0,0 +1,24 @@
+
+== User Account Service
+
+After creating the user, logout of the management console by clicking the right hand drop down menu and selecting `Sign Off`.
+Next, login to the User Account Service of your `demo` realm with the user you just created by clicking this link:
+
+User Account Link::
+  http://localhost:8080/auth/realms/demo/account
+
+Enter in the username and temporary password you created.  You will be asked to change and create a permanent password after you
+successfully login.
+
+.Update Password
+image:../../{{book.images}}/update-password.png[]
+
+Finally, you will be brought to the User Account Service.  Every user in a realm has access to this Account Service by default.
+It allows you to update profile information and change or add additional credentials.  More information on this service is provided
+in the link:{{book.adminguide.link}}[{{book.adminguide.name}}].
+
+
+
+
+
+

topics/first-realm/before.adoc

@@ -0,0 +1,6 @@
+
+=== Before You Start
+
+Before you can participate in this tutorial, you need to complete the installation of {{book.project.name}} and create the
+initial admin user as shown in the <<fake/../../first-boot.adoc#_install-boot, Install and Boot>> tutorial.
+

topics/first-realm/realm.adoc

@@ -0,0 +1,29 @@
+[[_create-realm]]
+
+=== Create a New Realm
+
+Login to the {{book.project.name}} Admin Console using the account you created in the
+<<fake/../../first-boot.adoc#_install-boot, Install and Boot>> tutorial.
+
+Admin Console Link::
+  http://localhost:8080/auth/admin/
+
+Mouse over the top left corner drop down menu that is titled with `Master`.  If you are logged in the master realm
+this drop down menu lists all the realms created.  The last entry of this drop down menu is always `Add Realm`.  Click
+this to add a realm.
+
+.Add Realm Menu
+image:../../{{book.images}}/add-realm-menu.png[]
+
+This menu option will bring you to the `Add Realm` page.  You will be creating a brand new realm from scratch so
+enter in `demo` for the realm name and click `Create`.
+
+.Create Realm
+image:../../{{book.images}}/create-realm.png[]
+
+After creating the realm you are brought back to the main Admin Console page. The current realm will now be set to
+`demo`.  You can switch between managing the `master` realm and the realm you just created by doing a mouse over on the
+top left corner drop down menu.
+
+
+

topics/first-realm/user.adoc

@@ -0,0 +1,30 @@
+
+=== Create a New User
+
+In this section you are going to create a new user in the `demo` realm as well as a temporary password for that account.
+The first step is to click on the `Users` in the left menu bar.
+
+.Users
+image:../../{{book.images}}/users.png[]
+
+This menu option brings you to the user list page.  On the right side of the empty user list, you should see an `Add User`
+button.  Click that to start creating your new user.
+
+.Add User
+image:../../{{book.images}}/add-user.png[]
+
+The only required field is `Username`.  Click save.  This will bring you to the management page for your new user.
+
+The next step is to define a temporary password for your new user.  Click on the `Credentials` tab to bring you to
+the page that will allo you to do this.
+
+.Set Temporary Password
+image:../../{{book.images}}/credentials.png[]
+
+Enter in a new password and retype it within the `Password Confirmation` field.  Once you do this a red `Reset Password`
+button should reappear.  Clicking on that will reset the user's password to the new one you specified.  Please note that
+this is a temporary password and the user will be required to change it after they first log in.  You can make it permanent
+by flipping the `Temporary` switch from `On` to `Off` before you click the `Reset Password` button.
+
+
+

topics/overview.adoc

@@ -1,3 +1,4 @@
+
 == Overview
 
 The purpose of this guide is to get you up and running as quickly as possible so that you can