Skip to content

Prosodoy module to externalize MUC authorization via HTTP

Notifications You must be signed in to change notification settings

SeveFP/mod_muc_http_auth

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 

Repository files navigation

Introduction

This module externalizes MUC authorization via HTTP.
Whenever a user wants to join a MUC, an HTTP GET request is made to authorization_url with the user bare jid (userJID) and the MUC jid (mucJID) as GET parameters.
Example:
https://www.prosody.im/users/can-join/[email protected]&[email protected]

This allows an external service to decide whether a user is authorized to join a MUC or not.

When a user is authorized to join a MUC, this module expects the following JSON payload:

{
    allowed: true,
    error: "",
}

Otherwise, either the user not being authorized or some failure in the external service:

{
    allowed: false,
    error: "Some error message to be displayed in this module's logs",
}

Configuring

Enabling

Component "rooms.example.net" "muc"

modules_enabled = {
    "muc_http_auth";
}

Settings

Name Description Default
muc_http_auth_url URL of the external HTTP service to which send userJID and mucJID in a GET request ""
muc_http_auth_enabled_for List of MUC names (node part) to enable this module for nil
muc_http_auth_disabled_for List of MUC names (node part) to disable this module for nil
muc_http_auth_insecure Disable certificate verification for request. Only intended for development of the external service. false
muc_http_auth_authorization_header Value of the Authorization header if requested by the external HTTP service. Example: Basic dXNlcm5hbWU6cGFzc3dvcmQ= nil

This module can be enabled/disabled for specific rooms. Only one of the following settings must be set.

-- muc_http_auth_enabled_for = {"teaparty"}
-- muc_http_auth_disabled_for = {"teaparty"}

If none is set, all rooms in the MUC component will have this module enabled.

Note: Use the node part of the MUC jid for these lists. Example:

Wrong: muc_http_auth_enabled_for = {"[email protected]"}

Correct: muc_http_auth_enabled_for = {"teaparty"}

About

Prosodoy module to externalize MUC authorization via HTTP

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages