users

SUMMARY.adoc

@@ -10,7 +10,6 @@
  .. link:topics/concepts.adoc[Core Concepts and Terms]
  . link:topics/initialization.adoc[Server Initialization]
  . link:topics/admin-console.adoc[Admin Console]
- . link:topics/realms.adoc[Configuring Realms]
  .. link:topics/realms/master.adoc[The Master Realm]
  .. link:topics/realms/create.adoc[Creating a New Realm]
  .. link:topics/realms/ssl.adoc[Realm SSL Mode]
@@ -18,6 +17,10 @@
  .. link:topics/realms/cache.adoc[Clearing Server Caches]
  .. link:topics/realms/email.adoc[Email Settings]
  .. link:topics/realms/themes.adoc[Themes]
+ . link:topics/users.adoc[User Management]
+ .. link:topics/users/viewing.adoc[Viewing Users]
+ .. link:topics/users/create-user.adoc[Creating New Users]
+ .. link:topics/users/attributes.adoc[User Attributes]
  . link:topics/admin-permissions.adoc[Master Admin Access Control]
  . link:topics/per-realm-admin-permissions.adoc[Per Realm Admin Access Control]
  . link:topics/client-registration.adoc[Client Registration]

topics/users.adoc

@@ -0,0 +1,4 @@
+
+== User Management
+
+This section describes the administration functions for managing users.

topics/users/attributes.adoc

@@ -0,0 +1,11 @@
+
+=== User Attributes
+
+Beyond basic user metadata like name and email, you can store arbitrary user attributes.  Choose a user to manage
+then click on the `Attributes` tab.
+
+.Users
+image:../../{{book.images}}/user-attributes.png[]
+
+Enter in the attribute name and value in the empty fields and click the `Add` button next to it to add a new field.
+Note that any edits you make on this page will not be stored until you hit the `Save` button.

topics/users/create-user.adoc

@@ -0,0 +1,20 @@
+[[_create-new-user]]
+
+=== Creating New Users
+
+To create a user click on `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.
+
+
+
+

topics/users/viewing.adoc

@@ -0,0 +1,13 @@
+
+=== Searching For Users
+
+If you need to manage a specific user, click on `Users` in the left menu bar.  T
+
+.Users
+image:../../{{book.images}}/users.png[]
+
+This menu option brings you to the user list page.  In the search box you can type in a full name, last name, or email address
+you want to search for in the user database.  The query will bring up all users that match your criteria.  The `View all users` button
+will list every user in the system.  This can be a dangerous operation if you have tens of thousands of users stored.  Some backends
+like LDAP don't have a way to page through users and must return the whole user set!  So be careful before you execute a view all search.
+