Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-01-12 10:33:43 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Federation: Document the Host header; Clarify how literal IP addresses are handled

Browse source 
Fixes https://github.com/matrix-org/matrix-doc/issues/1161

The IP address clarification is to add an explicit mention of how to handle the case. The prior documentation assumed that all servers would be resolvable with DNS, and does technically have a fallback to use the fallback port, however making it clear feels like a good idea.
This commit is contained in:
Travis Ralston 2018-08-03 13:10:24 -06:00
parent 329baa1b9d
commit 5fbaa1deb5
1 changed files with 9 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
specification/server_server_api.rst
View file

@ -98,6 +98,15 @@ default fallback port number of 8448.
Homeservers may use SRV records to load balance requests between multiple TLS
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
``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.
example.org``, the ``Host`` header in the request should be ``example.org``. The
port number for target server should not appear in the ``Host`` header.
Server implementation
~~~~~~~~~~~~~~~~~~~~~~