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

Dirty replace of DNS name -> hostname

Browse source
This commit is contained in:
Will Hunt 2018-07-05 11:37:06 +01:00
parent 442ad99727
commit 92f3989f2b
1 changed files with 10 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
specification/server_server_api.rst
View file

@ -73,22 +73,22 @@ Server Discovery
Resolving Server Names Resolving Server Names
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~
Each matrix homeserver is identified by a server name consisting of a DNS name Each matrix homeserver is identified by a server name consisting of a hostname
and an optional TLS port. and an optional TLS port.
.. code:: .. code::
server_name = dns_name [ ":" tls_port] server_name = hostname [ ":" tls_port]
dns_name = <host, see [RFC 3986], Section 3.2.2> dns_name = <host, see [RFC 3986], Section 3.2.2>
tls_port = *DIGIT tls_port = *DIGIT
.. ** .. **
If the port is present then the server is discovered by looking up an AAAA or If the port is present then the server is discovered by looking up an AAAA or
A record for the DNS name and connecting to the specified TLS port. If the port A record for the hostname and connecting to the specified TLS port. If the port
is absent then the server is discovered by looking up a ``_matrix._tcp`` SRV is absent then the server is discovered by looking up a ``_matrix._tcp`` SRV
record for the DNS name. If this record does not exist then the server is record for the hostname. If this record does not exist then the server is
discovered by looking up an AAAA or A record on the DNS name and taking the discovered by looking up an AAAA or A record on the hostname and taking the
default fallback port number of 8448. 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.
@ -165,7 +165,7 @@ events sent by that server can still be checked.
==================== =================== ====================================== ==================== =================== ======================================
Key Type Description Key Type Description
==================== =================== ====================================== ==================== =================== ======================================
``server_name`` String DNS name of the homeserver. ``server_name`` String hostname of the homeserver.
``verify_keys`` Object Public keys of the homeserver for ``verify_keys`` Object Public keys of the homeserver for
verifying digital signatures. verifying digital signatures.
``old_verify_keys`` Object The public keys that the server used ``old_verify_keys`` Object The public keys that the server used
@ -273,7 +273,7 @@ at ``/_matrix/key/v1``.
==================== =================== ====================================== ==================== =================== ======================================
Key Type Description Key Type Description
==================== =================== ====================================== ==================== =================== ======================================
``server_name`` String DNS name of the homeserver. ``server_name`` String hostname of the homeserver.
``verify_keys`` Object Public keys of the homeserver for ``verify_keys`` Object Public keys of the homeserver for
verifying digital signatures. verifying digital signatures.
``signatures`` Object Digital signatures for this object ``signatures`` Object Digital signatures for this object