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

Draft login token spec

Browse source
This commit is contained in:
Erik Johnston 2015-09-28 09:29:35 +01:00
parent ca9f30a7fd
commit 317c2f20d3
1 changed files with 24 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
specification/1-client_server_api.rst
View file

@ -197,6 +197,7 @@ This specification defines the following login types:
- ``m.login.recaptcha``
- ``m.login.oauth2``
- ``m.login.email.identity``
- ``m.login.token``
- ``m.login.dummy``
Password-based
@ -228,6 +229,29 @@ To respond to this type, reply with an auth dict as follows::
"response": "<captcha response>"
}
Token-based
~~~~~~~~~~~
:Type:
``m.login.token``
:Description:
The client submits a username and token that was generated by the server.
To respond to this type, reply with an auth dict as follows::
{
"type": "m.login.token",
"user": "<user_id or user localpart>",
"token": "<token>",
"nonce": "<client generated nonce>"
}
The ``nonce`` should be a random string generated by the client for the
request. The same ``nonce`` should be used if retrying the request.
The ``token`` may be discovered from e.g. an email or dynamically generated QR
code.
OAuth2-based
~~~~~~~~~~~~
:Type: