diff --git a/proposals/1708-well-known-for-federation.md b/proposals/1708-well-known-for-federation.md index d23c0e2f..c9f90631 100644 --- a/proposals/1708-well-known-for-federation.md +++ b/proposals/1708-well-known-for-federation.md @@ -44,8 +44,8 @@ redirect loops). If the request does not return a 200, continue to step 4, otherwise: The response must be valid JSON which follows the structure documented -below. Otherwise, the request is aborted. It is NOT necessary for the response -to have a `Content-Type` of `application/json`. +below. Otherwise, continue to the next step in the discovery process. It is +NOT necessary for the response to have a `Content-Type` of `application/json`. If the response is valid, the `m.server` property is parsed as `[:]`, and processed as follows: diff --git a/specification/server_server_api.rst b/specification/server_server_api.rst index 17f3e646..8de5ecc5 100644 --- a/specification/server_server_api.rst +++ b/specification/server_server_api.rst @@ -109,14 +109,14 @@ The process overall is as follows: 1. If the hostname is an IP literal, then that IP address should be used, together with the given port number, or 8448 if no port is given. The target server must present a valid certificate for the IP address. - Requests must be made with a ``Host`` header containing the IP address, - without port. + The ``Host`` header in the request should be set to the server name, + including the port if the server name included one. -2. If the hostname is not an IP literal, and the server name includes an explicit port, - resolve the IP address using AAAA or A records. Requests are made to - the resolved IP address and given port with a ``Host`` header of the - original hostname (with port). The target server must present a valid - certificate for the hostname. +2. If the hostname is not an IP literal, and the server name includes an + explicit port, resolve the IP address using AAAA or A records. Requests + are made to the resolved IP address and given port with a ``Host`` header + of the original server name (with port). The target server must present a + valid certificate for the hostname. 3. If the hostname is not an IP literal, a regular HTTPS request is made to ``https:///.well-known/matrix/server``, expecting the @@ -130,39 +130,38 @@ The process overall is as follows: recommended. Errors are recommended to be cached for up to an hour, and servers are encouraged to exponentially back off for repeated failures. The schema of the ``/.well-known`` request is later in this - section. If the response is invalid (bad JSON, missing properties, etc), - attempts to connect to the target server are aborted - no connections - should be attempted. If the response is valid, the ``m.server`` property - is parsed as ``[:]`` and processed - as follows: + section. If the response is invalid (bad JSON, missing properties, non-200 + response, etc), skip to step 4. If the response is valid, the ``m.server`` + property is parsed as ``[:]`` and + processed as follows: - * If ```` is an IP literal, then that IP address + * If ```` is an IP literal, then that IP address should be used together with the ```` or 8448 if no port is provided. The target server must present a valid TLS certificate for the IP address. Requests must be made with a ``Host`` header containing - the IP address, with port. + the IP address, including the port if one was provided. - * If ```` is not an IP literal, and ```` + * If ```` is not an IP literal, and ```` is present, an IP address is disovered by looking up an AAAA or A - record for ````. The resulting IP address is - used, alongside the ````, to make requests with a - ``Host`` header of ``:``. The - target server must present a valid certificate for ````. + record for ````. The resulting IP address is + used, alongside the ````. Requests must be made with a + ``Host`` header of ``:``. The + target server must present a valid certificate for ````. - * If ```` is not an IP literal and no + * If ```` is not an IP literal and no ```` is present, an SRV record is looked up for - ``_matrix._tcp.``. This may result in another + ``_matrix._tcp.``. This may result in another hostname (to be resolved using AAAA or A records) and port. Requests should be made to the resolved IP address and port with a ``Host`` - header containing the ````. The target server - must present a valid certificate for ````. + header containing the ````. The target server + must present a valid certificate for ````. * If no SRV record is found, an IP address is resolved using AAAA or A records. Requests are then made to the resolve IP address - and a port of 8448, using a ``Host`` header of ````. - The target server must present a valid certificate for ````. + and a port of 8448, using a ``Host`` header of ````. + The target server must present a valid certificate for ````. -4. If the `/.well-known` request did not result in a 200 response, a server +4. If the `/.well-known` request resulted in an error response, a server is found by resolving an SRV record for ``_matrix._tcp.``. This may result in a hostname (to be resolved using AAAA or A records) and port. Requests are made to the resolved IP address and port, using 8448