aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorKyle D <kdumontnu@gmail.com>2024-01-03 16:48:20 -0800
committerGitHub <noreply@github.com>2024-01-03 18:48:20 -0600
commit54acf7b0d4b57907a6d8a2ac470744f185adf0b5 (patch)
treea9c6a5df44c445b5301ad8f7e3e3218f68fde5f7 /docs
parent657b23d6359bbbb25b3dcfee233cae0735997188 (diff)
downloadgitea-54acf7b0d4b57907a6d8a2ac470744f185adf0b5.tar.gz
gitea-54acf7b0d4b57907a6d8a2ac470744f185adf0b5.zip
Normalize oauth email username (#28561)
Diffstat (limited to 'docs')
-rw-r--r--docs/content/administration/config-cheat-sheet.en-us.md10
1 files changed, 7 insertions, 3 deletions
diff --git a/docs/content/administration/config-cheat-sheet.en-us.md b/docs/content/administration/config-cheat-sheet.en-us.md
index e111ff6db6..c11b4012a5 100644
--- a/docs/content/administration/config-cheat-sheet.en-us.md
+++ b/docs/content/administration/config-cheat-sheet.en-us.md
@@ -596,9 +596,13 @@ And the following unique queues:
- `OPENID_CONNECT_SCOPES`: **_empty_**: List of additional openid connect scopes. (`openid` is implicitly added)
- `ENABLE_AUTO_REGISTRATION`: **false**: Automatically create user accounts for new oauth2 users.
- `USERNAME`: **nickname**: The source of the username for new oauth2 accounts:
- - userid - use the userid / sub attribute
- - nickname - use the nickname attribute
- - email - use the username part of the email attribute
+ - `userid` - use the userid / sub attribute
+ - `nickname` - use the nickname attribute
+ - `email` - use the username part of the email attribute
+ - Note: `nickname` and `email` options will normalize input strings using the following criteria:
+ - diacritics are removed
+ - the characters in the set `['ยด\x60]` are removed
+ - the characters in the set `[\s~+]` are replaced with `-`
- `UPDATE_AVATAR`: **false**: Update avatar if available from oauth2 provider. Update will be performed on each login.
- `ACCOUNT_LINKING`: **login**: How to handle if an account / email already exists:
- disabled - show an error