Matrix v1.12 – Behandlung server_name > via Deprecation

[Johennes]

Abgespalten von #271.

Folgende Änderung soll im Hinblick auf TI-M bewertet und falls nötig behandelt werden:

• Deprecate the server_name query parameter on POST /_matrix/client/v3/join/{roomIdOrAlias} and POST /_matrix/client/v3/knock/{roomIdOrAlias}, as per MSC4156. (#1933)
• Add via query parameter on POST /_matrix/client/v3/join/{roomIdOrAlias} and POST /_matrix/client/v3/knock/{roomIdOrAlias}, as per MSC4156. (#1933)

[Johennes]

Da via vor v1.12 nicht existiert hat, verpflichtet Matrix Clients für < v1.12 Server den Parameter server_name zu verwenden. v1.12 Server unterstützen server_name weiterhin, verwerten den Parameter allerdings nur wenn via fehlt. Kompatibilitätsprobleme kann es hier daher nicht geben.

Matrix verpflichtet Clients allerdings nicht via für v1.12 Server zu verwenden.

Clients SHOULD use via when the homeserver they're talking to supports it. To do this, they MAY either detect server support through the supported spec versions in /_matrix/client/versions or always include both parameters with identical values.

Vorschlag: Zur Beschleunigung der Migration verpflichten wir TI-M Clients zur Verwendung von via sofern der Server es erlaubt.

A_1 – Verpflichtende Verwendung von via

TI-M Clients MÜSSEN bei den Requests POST /_matrix/client/v3/join/{roomIdOrAlias} und POST /_matrix/client/v3/knock/{roomIdOrAlias} den Parameter via verwenden sofern der Homeserver dies unterstützt.

Hinweis: via wurde in Matrix v1.12 eingeführt und ersetzt den als deprecated markierten Parameter server_name. Das in A_1 beschriebene Verhalten kann auch dadurch realisiert werden, dass immer beide Parameter mit identischen Werten gesetzt werden.