diff --git a/README.md b/README.md index b62f9d9..b031f6b 100644 --- a/README.md +++ b/README.md @@ -141,7 +141,9 @@ Once in the container, run the following command to create a user: ``prosodyctl --config /config/prosody.cfg.lua register user meet.jitsi password`` #### Authentication using JWT tokens -You can also use JWT tokens to authenticate users. To enable it you have to enable authentication via both `ENABLE_AUTH` & `JWT_ENABLE_TOKEN_AUTH` environment variables and configure the settings you can see below. + +You can also use JWT tokens to authenticate users. To enable it you have to enable authentication via both +`ENABLE_AUTH` & `JWT_ENABLE_TOKEN_AUTH` environment variables and configure the settings you can see below. Variable | Description | Example --- | --- | --- @@ -151,6 +153,24 @@ Variable | Description | Example `JWT_ACCEPTED_ISSUERS` | (Optional) Set asap_accepted_issuers as a comma separated list | my_web_client,my_app_client `JWT_ACCEPTED_AUDIENCES` | (Optional) Set asap_accepted_audiences as a comma separated list | my_server1,my_server2 +This can be tested using the [jwt.io] debugger. Use the following samople payload: + +``` +{ + "context": { + "user": { + "avatar": "https://robohash.org/john-doe", + "name": "John Doe", + "email": "jdoe@example.com" + } + }, + "aud": "my_jitsi_app_id", + "iss": "my_jitsi_app_id", + "sub": "meet.jitsi", + "room": "*" +} +``` + ### Advanced configuration These configuration options are already set and generally don't need to be changed. @@ -217,3 +237,5 @@ option. [Jigasi]: https://github.com/jitsi/jigasi [ICE]: https://en.wikipedia.org/wiki/Interactive_Connectivity_Establishment [STUN]: https://en.wikipedia.org/wiki/STUN +[jwt.io]: https://jwt.io/#debugger-io +