Synapse authentication module which allows for authenticating and registering using JWTs
Project description
Synapse Token Authenticator
Synapse Token Authenticator is a synapse auth provider which allows for token authentication (and optional registration) using JWTs (Json Web Tokens).
Table of Contents
Installation
TODO: requires publishing on pypi.
pip install synapse-token-authenticator
Configuration
Here are the available configuration options:
# provide only one of secret, keyfile
secret: symetrical secret
keyfile: path to asymetrical keyfile
# Algorithm of the tokens, defaults to HS512
#algorithm: HS512
# Allow registration of new users using these tokens, defaults to false
#allow_registration: false
# Require tokens to have an expiracy set, defaults to true
#require_expiracy: true
It is recommended to have require_expiracy
set to true
(default). As for allow_registration
, it depends on usecase: If you only want to be able to log in existing users, leave it at false
(default). If nonexistant users should be simply registered upon hitting the login endpoint, set it to true
.
Usage
First you have to generate a JWT with the correct claims. The sub
claim is the localpart or full mxid of the user you want to log in as. Be sure that the algorithm and secret match those of the configuration. An example of the claims is as follows:
{
"sub": "alice",
"exp": 1516239022
}
Next you need to post this token to the /login
endpoint of synapse. Be sure that the type
is com.famedly.login.token
and that identifier.user
is, again, either the localpart or the full mxid. For example the post body could look as following:
{
"type": "com.famedly.login.token",
"identifier": {
"type": "m.id.user",
"user": "alice"
},
"token": "<jwt here>"
}
Testing
The tests uses twisted's testing framework trial, with the development enviroment managed by hatch. Running the tests and generating a coverage report can be done like this:
hatch run cov
License
synapse-token-authenticator
is distributed under the terms of the
AGPL-3.0 license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for synapse_token_authenticator-0.3.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 61ba1f67d458e9081b6358a0f2d91b72c3aa6e0dd675913a77b9d2fd33b9276c |
|
MD5 | 87b5b18ba6c05642bb38ea247ab3ebe8 |
|
BLAKE2b-256 | 8eb423973276ff4bbf5aff9a38c94c93082a4d7affd67a6d8af5bad157abb10d |
Hashes for synapse_token_authenticator-0.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 139a01069b31dbd3afae995dd77e83749c95dcbdc065e4e676257c7e6884a9b6 |
|
MD5 | eb004fc2793781633084be6488596333 |
|
BLAKE2b-256 | 9af920f6481c8f723580e2e3615a90181818d23c0a96b82ac6cee284e0581081 |