From 264862879d3fee42cc8f58be87be2899f52b14e1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Torjus=20H=C3=A5kestad?= <torjus@usit.uio.no>
Date: Sun, 8 Feb 2026 15:02:12 +0100
Subject: [PATCH] docs: add verified user creation example

Add complete example workflow and note password minimum (10 chars).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/user-management.md | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/docs/user-management.md b/docs/user-management.md
index 2026915..3ed128f 100644
--- a/docs/user-management.md
+++ b/docs/user-management.md
@@ -32,18 +32,33 @@ kanidm person create <username> "<Display Name>"
 
 # Add to groups
 kanidm group add-members ssh-users <username>
-kanidm group add-members users <username>
 
-# Enable POSIX (UID is auto-assigned from Kanidm's range)
+# Enable POSIX (UID is auto-assigned)
 kanidm person posix set <username>
 
-# Set UNIX password (required for SSH login)
+# Set UNIX password (required for SSH login, min 10 characters)
 kanidm person posix set-password <username>
 
 # Optionally set login shell
 kanidm person posix set <username> --shell /bin/zsh
 ```
 
+### Example: Full User Creation
+
+```bash
+kanidm person create testuser "Test User"
+kanidm group add-members ssh-users testuser
+kanidm person posix set testuser
+kanidm person posix set-password testuser
+kanidm person get testuser
+```
+
+After creation, verify on a client host:
+```bash
+getent passwd testuser
+ssh testuser@testvm01.home.2rjus.net
+```
+
 ### Viewing User Details
 
 ```bash