summary refs log tree commit diff
path: root/develop/print.html
diff options
context:
space:
mode:
authorDMRobertson <DMRobertson@users.noreply.github.com>2022-09-21 13:09:00 +0000
committerDMRobertson <DMRobertson@users.noreply.github.com>2022-09-21 13:09:00 +0000
commit574ed416933067fb3dcc72b59351e5e8264e4cb1 (patch)
tree2e15692435b5295d784fe49eabd81b3d31b98965 /develop/print.html
parentdeploy: 2b522cceb6cb4919a3a92e99917e7199d9feaeb1 (diff)
downloadsynapse-574ed416933067fb3dcc72b59351e5e8264e4cb1.tar.xz
deploy: 16e1a9d9a7884967da390ef967b942a5e35e8f6c
Diffstat (limited to 'develop/print.html')
-rw-r--r--develop/print.html12
1 files changed, 9 insertions, 3 deletions
diff --git a/develop/print.html b/develop/print.html
index eeb26a2ccb..f704075264 100644
--- a/develop/print.html
+++ b/develop/print.html
@@ -7549,8 +7549,8 @@ for the user. Commonly the <code>sub</code> claim of the response.</li>
 <li>This method must be async.</li>
 <li>Arguments:
 <ul>
-<li><code>userinfo</code> - A <code>authlib.oidc.core.claims.UserInfo</code> object to extract user
-information from.</li>
+<li><code>userinfo</code> - An <a href="https://docs.authlib.org/en/latest/specs/oidc.html#authlib.oidc.core.UserInfo"><code>authlib.oidc.core.claims.UserInfo</code></a>
+object to extract user information from.</li>
 <li><code>token</code> - A dictionary which includes information necessary to make
 further requests to the OpenID provider.</li>
 <li><code>failures</code> - An <code>int</code> that represents the amount of times the returned
@@ -7570,7 +7570,13 @@ with failures=1. The method should then return a different
 <code>None</code>, the user is prompted to pick their own username. This is only used
 during a user's first login. Once a localpart has been associated with a
 remote user ID (see <code>get_remote_user_id</code>) it cannot be updated.</li>
-<li><code>displayname</code>: An optional string, the display name for the user.</li>
+<li><code>confirm_localpart</code>: A boolean. If set to <code>True</code>, when a <code>localpart</code>
+string is returned from this method, Synapse will prompt the user to
+either accept this localpart or pick their own username. Otherwise this
+option has no effect. If omitted, defaults to <code>False</code>.</li>
+<li><code>display_name</code>: An optional string, the display name for the user.</li>
+<li><code>emails</code>: A list of strings, the email address(es) to associate with
+this user. If omitted, defaults to an empty list.</li>
 </ul>
 </li>
 </ul>