geek-cookbook/manuscript/recipes/keycloak/create-user.md

Create KeyCloak Users

This is not a complete recipe - it's an optional component of the [Keycloak recipe](https://geek-cookbook.funkypenguin.co.nz/recipes/keycloak/), but has been split into its own page to reduce complexity.

Unless you plan to authenticate against an outside provider (OpenLDAP, below, for example), you'll want to create some local users..

Ingredients

Existing:

* [X] [KeyCloak](https://geek-cookbook.funkypenguin.co.nz/recipes/keycloak/) recipe deployed successfully

Create User

Within the "Master" realm (no need for more realms yet), navigate to Manage -> Users, and then click Add User at the top right:

Populate your new user's username (it's the only mandatory field)

Set User Credentials

Once your user is created, to set their password, click on the "Credentials" tab, and procede to reset it. Set the password to non-temporary, unless you like extra work!

Summary

We've setup users in KeyCloak, which we can now use to authenticate to KeyCloak, when it's used as an OIDC Provider, potentially to secure vulnerable services using Traefik Forward Auth.

Created:

* [X] Username / password to authenticate against [KeyCloak](https://geek-cookbook.funkypenguin.co.nz/recipes/keycloak/)