Skip to content

Jitsi Meet - Secure, Simple and Scalable Video Conferences that you use as a standalone app or embed in your web application.

11.5 KB
Raw Blame
-- Token authentication
-- Copyright (C) 2021-present 8x8, Inc.

local formdecode = require "util.http".formdecode;
local generate_uuid = require "util.uuid".generate;
local new_sasl = require "util.sasl".new;
local sasl = require "util.sasl";
local token_util = module:require "token/util".new(module);
local sessions = prosody.full_sessions;

-- no token configuration
if token_util == nil then
    return;
end

module:depends("jitsi_session");

local measure_pre_fetch_fail = module:measure('pre_fetch_fail', 'counter');
local measure_verify_fail = module:measure('verify_fail', 'counter');
local measure_success = module:measure('success', 'counter');
local measure_ban = module:measure('ban', 'counter');
local measure_post_auth_fail = module:measure('post_auth_fail', 'counter');
local measure_resume_room_mismatch = module:measure('resume_room_mismatch', 'counter');

-- The JWT-derived authorization state that c2s-session-updated refreshes from
-- the connection that resumes a hibernating session.
local TOKEN_CLAIM_FIELDS = {
    'auth_token';
    'jitsi_meet_context_user';
    'jitsi_meet_context_group';
    'jitsi_meet_context_features';
    'jitsi_meet_context_room';
    'jitsi_meet_room';
    'jitsi_meet_str_tenant';
    'jitsi_meet_domain';
    'jitsi_meet_tenant_mismatch';
    'jitsi_meet_auth_issuer';
};

-- define auth provider
local provider = {};

local host = module.host;

module:hook("pre-resource-unbind", function (e)
    local error, session = e.error, e.session;

    prosody.events.fire_event('jitsi-pre-session-unbind', {
        jid = session.full_jid,
        session = session,
        error = error
    });
end, 11);

function provider.test_password(username, password)
    return nil, "Password based auth not supported";
end

function provider.get_password(username)
    return nil;
end

function provider.set_password(username, password)
    return nil, "Set password not supported";
end

function provider.user_exists(username)
    return nil;
end

function provider.create_user(username, password)
    return nil;
end

function provider.delete_user(username)
    return nil;
end

function first_stage_auth(session)
    -- retrieve custom public key from server and save it on the session
    local pre_event_result = prosody.events.fire_event("pre-jitsi-authentication-fetch-key", session);
    if pre_event_result ~= nil and pre_event_result.res == false then
        module:log("warn",
            "Error verifying token on pre authentication stage:%s, reason:%s", pre_event_result.error, pre_event_result.reason);
        session.auth_token = nil;
        measure_pre_fetch_fail(1);
        return  pre_event_result;
    end

    local res, error, reason = token_util:process_and_verify_token(session);
    if res == false then
        module:log("warn",
            "Error verifying token err:%s, reason:%s tenant:%s room:%s user_agent:%s",
                error, reason, session.jitsi_web_query_prefix, session.jitsi_web_query_room,
                session.user_agent_header);
        session.auth_token = nil;
        measure_verify_fail(1);
        return  { res = res, error = error, reason = reason };
    end

    local shouldAllow = prosody.events.fire_event("jitsi-access-ban-check", session);
    if shouldAllow == false then
        module:log("warn", "user is banned")
        measure_ban(1);
        return  { res = false, error = "not-allowed", reason = "user is banned" };
    end

    return { verify_result = res, custom_username = prosody.events.fire_event("pre-jitsi-authentication", session) };
end

function second_stage_auth(session)
    local post_event_result = prosody.events.fire_event("post-jitsi-authentication", session);
    if post_event_result ~= nil and post_event_result.res == false then
        module:log("warn",
            "Error verifying token on post authentication stage :%s, reason:%s", post_event_result.error, post_event_result.reason);
        session.auth_token = nil;
        measure_post_auth_fail(1);
        return post_event_result;
    end
end

function provider.get_sasl_handler(session)

    local function get_username_from_token(self, message)

        local s1_result = first_stage_auth(session);
        if s1_result.res == false then
            return s1_result.res, s1_result.error, s1_result.reason;
        end

        if s1_result.custom_username then
            self.username = s1_result.custom_username;
        elseif session.previd ~= nil then
            for _, session1 in pairs(sessions) do
                if (session1.resumption_token == session.previd) then
                    self.username = session1.username;
                    break;
                end
            end
        else
            self.username = message;
        end

        local s2_result = second_stage_auth(session);
        if s2_result and s2_result.res ~= nil then
            return s2_result.res, s2_result.error, s2_result.reason;
        end

        measure_success(1);
        session._jitsi_auth_done = true;
        return s1_result.verify_result;
    end

    return new_sasl(host, { anonymous = get_username_from_token });
end

module:provides("auth", provider);

local function anonymous(self, message)

    local username = generate_uuid();

    -- This calls the handler created in 'provider.get_sasl_handler(session)'
    local result, err, msg = self.profile.anonymous(self, username, self.realm);

    if result == true then
        if (self.username == nil) then
            self.username = username;
        end
        return "success";
    else
        return "failure", err, msg;
    end
    end

sasl.registerMechanism("ANONYMOUS", {"anonymous"}, anonymous);

-- The <resume> is processed on the async runner of the resuming connection (from_session),
-- and the handler below can wait on it (fetching an ASAP public key that is not cached).
-- While waiting the runner pauses the connection of the session it was created for, and
-- resumes it once done, but by then update_session() has retired from_session and moved
-- the connection to the hibernating session, so the connection stays paused and nothing
-- more is read from it. Point the runner at the session that now owns the connection.
module:hook_global('c2s-session-updated', function (event)
    local session, from_session = event.session, event.from_session;
    local thread = from_session.thread;

    if type(thread) == 'table' and thread.data == from_session then
        thread.data = session;
    end
end, 1000);

-- Fired by Prosody's sessionmanager.update_session() during smacks (XEP-0198) session
-- resumption. The naming can be counter-intuitive:
--   event.session      (session)      – the OLD hibernating session being kept alive.
--                                       It holds all MUC state, auth state, and custom
--                                       fields accumulated during the call.
--   event.from_session (from_session) – the NEW incoming TCP session being absorbed and
--                                       then retired.  It has JWT fields freshly extracted
--                                       from the reconnect URL by mod_jitsi_session, but
--                                       no MUC state (it never joined a room).
-- The copies below refresh the old session's JWT claims with the latest values from the
-- new connection (useful when the client reconnects with a rotated token).  Fields that
-- represent runtime MUC state (e.g. jitsi_breakout_main_jid, set by
-- mod_muc_breakout_rooms when the session joins the main room) must NOT be copied here —
-- from_session will have nil for those, which would silently overwrite the valid value
-- on the old session.
module:hook_global('c2s-session-updated', function (event)
    local session, from_session = event.session, event.from_session;

    if not from_session.auth_token then
        return;
    end

    -- The room claim is scoped to a conference on muc-room-pre-create and
    -- muc-occupant-pre-join, which do not run again for a session that is past
    -- its join, so the claims coming from the resuming connection are scoped
    -- here instead: the ones verified on join are snapshotted before anything
    -- below mutates the session, and are kept when the refreshed ones do not
    -- cover the conference the session is in. The check belongs to whichever
    -- module owns room verification (mod_token_verification, on the MUC
    -- component); with nothing answering the event the claims are refreshed
    -- as they come, the same way a join is not room-checked without it.
    local reverify_rooms = session.auth_token ~= from_session.auth_token;
    local verified_claims = {};

    if reverify_rooms then
        for _, field in ipairs(TOKEN_CLAIM_FIELDS) do
            verified_claims[field] = session[field];
        end
    end

    -- we care to handle sessions from other hosts (anonymous hosts)
    -- Skip if from_session was already authenticated by its own token-auth module
    -- (indicated by _jitsi_auth_done=true), to avoid a second module instance
    -- on a different VirtualHost (e.g. hs256.localhost) incorrectly re-verifying
    -- a token signed for the original host and then closing the session.
    if module.host ~= event.from_session.host and not from_session._jitsi_auth_done then
        -- Handle session updates (e.g., when a session is resumed on some anonymous host with a token we need to do all the checks here)
        session.auth_token = event.from_session.auth_token;

        local s1_result = first_stage_auth(session);
        if s1_result.res == false then
            event.session:close();
            return;
        end

        local s2_result = second_stage_auth(session);
        if s2_result and s2_result.res == false then
            event.session:close();
            return;
        end
        session._jitsi_auth_done = true;
    end

    if not session._jitsi_auth_done then
        module:log('warn', 'Impossible case hit where session did not pass auth flow');
        event.session:close();
        return;
    end

    -- copy all the custom fields we set in the session, but only when from_session carries
    -- them: a connection resumed on an anonymous host holds just the raw token (put there
    -- by mod_jitsi_session) and no claims, so copying would discard the ones the
    -- verification above has just put on the session.
    if from_session._jitsi_auth_done then
        session.auth_token = from_session.auth_token;
        session.jitsi_meet_context_user = from_session.jitsi_meet_context_user;
        session.jitsi_meet_context_group = from_session.jitsi_meet_context_group;
        session.jitsi_meet_context_features = from_session.jitsi_meet_context_features;
        session.jitsi_meet_context_room = from_session.jitsi_meet_context_room;
        session.jitsi_meet_room = from_session.jitsi_meet_room;
        session.jitsi_meet_str_tenant = from_session.jitsi_meet_str_tenant;
        session.jitsi_meet_domain = from_session.jitsi_meet_domain;
        session.jitsi_meet_tenant_mismatch = from_session.jitsi_meet_tenant_mismatch;
    end

    if reverify_rooms then
        local result = prosody.events.fire_event('jitsi-verify-session-rooms', { session = session; });

        if result and result.res == false then
            module:log('warn',
                'Token presented on resume does not authorize room:%s err:%s reason:%s, keeping claims from join',
                result.room, result.error, result.reason);
            measure_resume_room_mismatch(1);

            for _, field in ipairs(TOKEN_CLAIM_FIELDS) do
                session[field] = verified_claims[field];
            end
        end
    end
end, 1);