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

Further server_name clarification

Browse source
This commit is contained in:
Richard van der Hoff 2018-08-29 09:36:50 +01:00
parent 08fba5de51
commit 78d8118846
1 changed files with 13 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

22
specification/server_server_api.rst
View file

@ -80,18 +80,22 @@ Resolving Server Names
Each matrix homeserver is identified by a server name consisting of a hostname Each matrix homeserver is identified by a server name consisting of a hostname
and an optional port, as described by the `grammar <../appendices.html#server-name>`_. and an optional port, as described by the `grammar <../appendices.html#server-name>`_.
If the port is present then the server is discovered by looking up an AAAA or If the hostname is an IP literal, then that IP address should be used, together
A record for the hostname and connecting to the specified TLS port. If the port with the given port number, or 8448 if no port is given.
is absent then the server is discovered by looking up a ``_matrix._tcp`` SRV
record for the hostname. If this record does not exist then the server is Otherwise, if the port is present, then an IP address is discovered by looking
discovered by looking up an AAAA or A record on the hostname and taking the up an AAAA or A record for the hostname, and the specified port is used.
default fallback port number of 8448.
If the hostname is not an IP literal and no port is given, the server is
discovered by first looking up a ``_matrix._tcp`` SRV record for the hostname,
which may give a hostname (to be looked up using AAAA or A queries) and port.
If the SRV record does not exist, then the server is discovered by looking up
an AAAA or A record on the hostname and taking the default fallback port number
of 8448.
Homeservers may use SRV records to load balance requests between multiple TLS Homeservers may use SRV records to load balance requests between multiple TLS
endpoints or to failover to another endpoint if an endpoint fails. endpoints or to failover to another endpoint if an endpoint fails.
If the DNS name is a literal IP address, the port specified or the fallback
port should be used.
When making requests to servers, use the DNS name of the target server in the When making requests to servers, use the DNS name of the target server in the
``Host`` header, regardless of the host given in the SRV record. For example, ``Host`` header, regardless of the host given in the SRV record. For example,
if making a request to ``example.org``, and the SRV record resolves to ``matrix. if making a request to ``example.org``, and the SRV record resolves to ``matrix.