Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-04-20 18:04:10 +02:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

spec that we follow redirects

Browse source
This commit is contained in:
Richard van der Hoff 2019-01-08 12:50:42 +00:00
parent f1ebbc358b
commit 5812450299
1 changed files with 4 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
proposals/1708-well-known-for-federation.md
View file

@ -35,14 +35,12 @@ is as follows:
4. Finally, the server is discovered by looking up an AAAA or A record on the 4. Finally, the server is discovered by looking up an AAAA or A record on the
hostname, and taking the default fallback port number of 8448. hostname, and taking the default fallback port number of 8448.
We insert the following between Steps 3 and 4: We insert the following between Steps 3 and 4.
If the SRV record does not exist, the requesting server should make a `GET` If the SRV record does not exist, the requesting server should make a `GET`
request to `https://<server_name>/.well-known/matrix/server`, with normal request to `https://<server_name>/.well-known/matrix/server`, with normal X.509
X.509 certificate validation. If the request does not return a 200, continue certificate validation, and following 30x redirects. If the request does not
to step 4, otherwise: return a 200, continue to step 4, otherwise:
XXX: should we follow redirects?
The response must have a `Content-Type` of `application/json`, and must be The response must have a `Content-Type` of `application/json`, and must be
valid JSON which follows the structure documented below. Otherwise, the valid JSON which follows the structure documented below. Otherwise, the
@ -114,14 +112,6 @@ must be taken that a single 500 error or connection failure should not break
federation for an extended period. A short cache time of about an hour might be federation for an extended period. A short cache time of about an hour might be
appropriate; alternatively, servers might use an exponential backoff. appropriate; alternatively, servers might use an exponential backoff.
### Outstanding questions
Should we follow 30x redirects for the .well-known file? On the one hand, there
is no obvious usecase and they add complexity (for example: how do they
interact with caches?). On the other hand, we'll presumably be using an HTTP
client library to handle some of the caching stuff, and they might be useful
for something?
## Problems ## Problems
It will take a while for `.well-known` to be supported across the ecosystem; It will take a while for `.well-known` to be supported across the ecosystem;