From f46978e0a9983f7b38ea120b83d341b4230f1d86 Mon Sep 17 00:00:00 2001
From: Jeff Ohrstrom <johrstrom@osc.edu>
Date: Fri, 22 Nov 2024 12:04:22 -0500
Subject: [PATCH] add docs on uid mapping (#1026)

---
 source/authentication/overview/map-user.rst | 5 +++++
 source/release-notes/v4.0-release-notes.rst | 8 ++++++++
 2 files changed, 13 insertions(+)

diff --git a/source/authentication/overview/map-user.rst b/source/authentication/overview/map-user.rst
index 3ced63b90..1a2332659 100644
--- a/source/authentication/overview/map-user.rst
+++ b/source/authentication/overview/map-user.rst
@@ -19,6 +19,11 @@ Since 2.0 you should use the simpler and faster :ref:`user_map_match <ood-portal
 
 Both with variations will be discussed here.
 
+.. tip::
+
+  Since 4.0 user mapping also accepts UIDs to be returned as well as usernames.
+  This can be helpful at centers where duplicate usernames and/or have multiple
+  domains.
 
 Remote User
 -----------
diff --git a/source/release-notes/v4.0-release-notes.rst b/source/release-notes/v4.0-release-notes.rst
index a4d2f270f..3d245497c 100644
--- a/source/release-notes/v4.0-release-notes.rst
+++ b/source/release-notes/v4.0-release-notes.rst
@@ -15,6 +15,7 @@ New Features
 - `noVNC quality and compression defaults`_
 - `Batch connect sessions poll delay`_
 - `System Status application`_
+- `User mapping now accepts UIDs`
 
 Thanks!
 -------
@@ -159,3 +160,10 @@ update the page. The default is 10 seconds. See :ref:`the documentation on statu
 for more details.
 
 Visit :ref:`disabling_applications` to disable this application.
+
+User mapping now accepts UIDs
+.............................
+
+User mapping scripts can now return a UID instead of a username.
+This can be helpful for centers that have multiple domains and possible
+username collisions.