wholetrans/docs-matrix-spec
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Clarify when server name is used and link to definition (#1862)

Browse source 
* Clarify when server name is used and link to definition

* Changelog
This commit is contained in:
Hugh Nimmo-Smith 2024-06-14 12:34:35 +01:00 • committed by GitHub
parent f434fdfba7
commit 5f47b96240
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 5 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

1
changelogs/client_server/newsfragments/1862.clarification Normal file
View file

@ -0,0 +1 @@
Clarify when server name is used and link to the definition.

4
content/client-server-api/_index.md
View file

@ -355,9 +355,9 @@ as per the [CORS](#web-browser-clients) section in this specification.
The `.well-known` method uses a JSON file at a predetermined location to
specify parameter values. The flow for this method is as follows:
1. Extract the server name from the user's Matrix ID by splitting the
1. Extract the [server name](/appendices/#server-name) from the user's Matrix ID by splitting the
Matrix ID at the first colon.
2. Extract the hostname from the server name.
2. Extract the hostname from the server name as described by the [grammar](/appendices/#server-name).
3. Make a GET request to `https://hostname/.well-known/matrix/client`.
1. If the returned status code is 404, then `IGNORE`.
2. If the returned status code is not 200, or the response body is

4
content/client-server-api/modules/sso_login.md
View file

@ -123,8 +123,8 @@ authentication is successful, the browser will be redirected to that
For example, consider a web-based client at
`https://client.example.com`, which wants to initiate SSO login on
the homeserver at `server.example.org`. It does this by storing the
homeserver name in a query parameter for the `redirectUrl`: it
the homeserver with [server name](/appendices/#server-name) `server.example.org`. It does this by storing the
server name in a query parameter for the `redirectUrl`: it
redirects to
`https://server.example.org/login/sso/redirect?redirectUrl=https://client.example.com?hs=server.example.org`.