diff options
| author | Peter Scheu <32014443+peterscheu-aceart@users.noreply.github.com> | 2022-09-21 15:08:16 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-09-21 13:08:16 +0000 |
| commit | 16e1a9d9a7884967da390ef967b942a5e35e8f6c (patch) | |
| tree | f319efa71b467513c5f8334e93f29a7e0806176e /docs | |
| parent | Improve the `synapse.api.auth.Auth` mock used in unit tests. (#13809) (diff) | |
| download | synapse-16e1a9d9a7884967da390ef967b942a5e35e8f6c.tar.xz | |
Correct documentation for map_user_attributes of OpenID Mapping Providers (#13836)
Co-authored-by: David Robertson <davidr@element.io>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/sso_mapping_providers.md | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/docs/sso_mapping_providers.md b/docs/sso_mapping_providers.md index 817499149f..9f5e5fbbe1 100644 --- a/docs/sso_mapping_providers.md +++ b/docs/sso_mapping_providers.md @@ -73,8 +73,8 @@ A custom mapping provider must specify the following methods: * `async def map_user_attributes(self, userinfo, token, failures)` - This method must be async. - Arguments: - - `userinfo` - A `authlib.oidc.core.claims.UserInfo` object to extract user - information from. + - `userinfo` - An [`authlib.oidc.core.claims.UserInfo`](https://docs.authlib.org/en/latest/specs/oidc.html#authlib.oidc.core.UserInfo) + object to extract user information from. - `token` - A dictionary which includes information necessary to make further requests to the OpenID provider. - `failures` - An `int` that represents the amount of times the returned @@ -91,7 +91,13 @@ A custom mapping provider must specify the following methods: `None`, 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 `get_remote_user_id`) it cannot be updated. - - `displayname`: An optional string, the display name for the user. + - `confirm_localpart`: A boolean. If set to `True`, when a `localpart` + 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 `False`. + - `display_name`: An optional string, the display name for the user. + - `emails`: A list of strings, the email address(es) to associate with + this user. If omitted, defaults to an empty list. * `async def get_extra_attributes(self, userinfo, token)` - This method must be async. - Arguments: |