diff options
author | DMRobertson <DMRobertson@users.noreply.github.com> | 2022-09-21 13:09:00 +0000 |
---|---|---|
committer | DMRobertson <DMRobertson@users.noreply.github.com> | 2022-09-21 13:09:00 +0000 |
commit | 574ed416933067fb3dcc72b59351e5e8264e4cb1 (patch) | |
tree | 2e15692435b5295d784fe49eabd81b3d31b98965 /develop/print.html | |
parent | deploy: 2b522cceb6cb4919a3a92e99917e7199d9feaeb1 (diff) | |
download | synapse-574ed416933067fb3dcc72b59351e5e8264e4cb1.tar.xz |
deploy: 16e1a9d9a7884967da390ef967b942a5e35e8f6c
Diffstat (limited to 'develop/print.html')
-rw-r--r-- | develop/print.html | 12 |
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> |