Add identity to JitsiParticipant

JitsiConference.js

@@ -1342,7 +1342,7 @@ JitsiConference.prototype.onMemberJoined = function(
     }
 
     const participant
-        = new JitsiParticipant(jid, this, nick, isHidden, statsID, status);
+        = new JitsiParticipant(jid, this, nick, isHidden, statsID, status, identity);
 
     participant._role = role;
     participant._botType = botType;

JitsiParticipant.js

@@ -28,8 +28,9 @@ export default class JitsiParticipant {
      * represent a hidden participant; otherwise, false.
      * @param {string} statsID - optional participant statsID
      * @param {string} status - the initial status if any.
+     * @param {object} identity - the xmpp identity
      */
-    constructor(jid, conference, displayName, hidden, statsID, status) {
+    constructor(jid, conference, displayName, hidden, statsID, status, identity) {
         this._jid = jid;
         this._id = Strophe.getResourceFromJid(jid);
         this._conference = conference;
@@ -42,6 +43,7 @@ export default class JitsiParticipant {
         this._statsID = statsID;
         this._connectionStatus = ParticipantConnectionStatus.ACTIVE;
         this._properties = {};
+        this._identity = identity;
     }
 
     /* eslint-enable max-params */

doc/tokens.md

@@ -38,6 +38,18 @@ In addition to the basic claims used in authentication, the token can also provi
   - 'name' is the display name of the 'callee' user
   - 'avatar' is the URL of the avatar of the 'callee'
 
+#### Access token identifiers / context
+To access the data in lib-jitsi-meet you have to enable the prosody module `mod_presence_identity` in your config.
+
+```lua
+VirtualHost "jitmeet.example.com"
+    modules_enabled = { "presence_identity" }
+```
+
+The data is now available as the identity in the JitsiParticipant class. You can access them by e.g. listening to the `USER_JOINED` event.
+
+NOTE: The values in the token shall always be valid values. If you define e.g. the avatar as `null` it will throw an error.
+
 ### Example Token
 #### Headers (using RS256 public key validation)
 ```