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

Switch to ordered list for server name resolution steps (#1623)

Browse source 
* Update server-server-api.md

I have updated the list of Resolving server names in step 3 from unordered list to ordered list. Because we care about its order

* Create 1567.clarification

* Delete 1567.clarification

* Create 1623.clarification

* Update 1623.clarification
This commit is contained in:
Mohit Kumar Patel 2023-08-20 03:12:59 +05:30 • committed by GitHub
parent c0babbfc13
commit 4f8b8a746c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 5 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

1
changelogs/server_server/newsfragments/1623.clarification Normal file
View file

@ -0,0 +1 @@
Switch to ordered list for server name resolution steps.

8
content/server-server-api.md
View file

@ -135,20 +135,20 @@ to send. The process overall is as follows:
to step 4. If the response is valid, the `m.server` property is to step 4. If the response is valid, the `m.server` property is
parsed as `<delegated_hostname>[:<delegated_port>]` and processed as parsed as `<delegated_hostname>[:<delegated_port>]` and processed as
follows: follows:
- If `<delegated_hostname>` is an IP literal, then that IP address 1. If `<delegated_hostname>` is an IP literal, then that IP address
should be used together with the `<delegated_port>` or 8448 if should be used together with the `<delegated_port>` or 8448 if
no port is provided. The target server must present a valid TLS no port is provided. The target server must present a valid TLS
certificate for the IP address. Requests must be made with a certificate for the IP address. Requests must be made with a
`Host` header containing the IP address, including the port if `Host` header containing the IP address, including the port if
one was provided. one was provided.
- If `<delegated_hostname>` is not an IP literal, and 2. If `<delegated_hostname>` is not an IP literal, and
`<delegated_port>` is present, an IP address is discovered by `<delegated_port>` is present, an IP address is discovered by
looking up CNAME, AAAA or A records for `<delegated_hostname>`. The looking up CNAME, AAAA or A records for `<delegated_hostname>`. The
resulting IP address is used, alongside the `<delegated_port>`. resulting IP address is used, alongside the `<delegated_port>`.
Requests must be made with a `Host` header of Requests must be made with a `Host` header of
`<delegated_hostname>:<delegated_port>`. The target server must `<delegated_hostname>:<delegated_port>`. The target server must
present a valid certificate for `<delegated_hostname>`. present a valid certificate for `<delegated_hostname>`.
- If `<delegated_hostname>` is not an IP literal and no 3. If `<delegated_hostname>` is not an IP literal and no
`<delegated_port>` is present, an SRV record is looked up for `<delegated_port>` is present, an SRV record is looked up for
`_matrix._tcp.<delegated_hostname>`. This may result in another `_matrix._tcp.<delegated_hostname>`. This may result in another
hostname (to be resolved using AAAA or A records) and port. hostname (to be resolved using AAAA or A records) and port.
@ -156,7 +156,7 @@ to send. The process overall is as follows:
a `Host` header containing the `<delegated_hostname>`. The a `Host` header containing the `<delegated_hostname>`. The
target server must present a valid certificate for target server must present a valid certificate for
`<delegated_hostname>`. `<delegated_hostname>`.
- If no SRV record is found, an IP address is resolved using CNAME, AAAA 4. If no SRV record is found, an IP address is resolved using CNAME, AAAA
or A records. Requests are then made to the resolve IP address or A records. Requests are then made to the resolve IP address
and a port of 8448, using a `Host` header of and a port of 8448, using a `Host` header of
`<delegated_hostname>`. The target server must present a valid `<delegated_hostname>`. The target server must present a valid