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

Add way to get the HS to bind/unbind existing 3pids

Browse source
This commit is contained in:
David Baker 2019-07-05 18:11:42 +01:00
parent 30dcc28f9b
commit bf8a1e5d5f
1 changed files with 20 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
proposals/2140-terms-of-service-2.md
View file

@ -41,8 +41,14 @@ following convention from
[MSC2134](https://github.com/matrix-org/matrix-doc/issues/2134). [MSC2134](https://github.com/matrix-org/matrix-doc/issues/2134).
This proposal introduces: This proposal introduces:
* A v2 API prefix, with authentication, for the Identity Service
* The `$prefix/terms` endpoint * The `$prefix/terms` endpoint
* The `m.accepted_terms` section in account data * The `m.accepted_terms` section in account data
* `POST /_matrix/client/r0/account/3pid/unbind` endpoints on the client/server
API
This proposal removes:
* The `bind_email` and `bind_msisdn` on the Homeserver `/register` endpoint
This proposal relies on both Integration Managers and Identity Servers being This proposal relies on both Integration Managers and Identity Servers being
able to identity users by their MXID and store the fact that a given MXID has able to identity users by their MXID and store the fact that a given MXID has
@ -252,6 +258,20 @@ in the current login sessions is:
* If the set of documents pending agreement was non-empty, Perform a * If the set of documents pending agreement was non-empty, Perform a
`POST $prefix/terms` request to the servcie with these documents. `POST $prefix/terms` request to the servcie with these documents.
### `POST /_matrix/client/r0/account/3pid/unbind`
A client uses this client/server API endpoint to request that the Homeserver
removes the given 3PID from the given Identity Server, or all Identity Servers.
Takes parameters the same parameters as
`POST /_matrix/client/r0/account/3pid/delete`, ie. `id_server`, `medium`,
`address` and the newly added `is_token`.
Returns the same as `POST /_matrix/client/r0/account/3pid/delete`.
Clients may add IS bindings for 3PIDs that already exist on the user's
Homeserver account by using the `POST /_matrix/client/r0/account/3pid`
to re-add the 3PID.
## Tradeoffs ## Tradeoffs
The Identity Service API previously did not require authentication, and OpenID The Identity Service API previously did not require authentication, and OpenID