Step by Step Dev

Configure Transcriber Authentication

Prosody Config

I wrote this guide based on my setup, where the hostname of my Jitsi server was http://alexjit.dev2dev.net . When you copy paste code, you can replace ‘alexjit.dev2dev.net’ with your own hostname

$(hostname -f) will evaluate to your hostname

Add VirtualHost

Add a VirtualHost recorder to the prosody config file:

$ micro /etc/prosody/conf.d/$(hostname -f).cfg.lua

Inside config file, append a Virtual Host (See this Jitsi community thread for more details)

The ‘internal.auth’ component should already be present in the config file. I left it in the code block below for context.

...
Component "internal.auth.alexjit.dev2dev.net" "muc"
    modules_enabled = {
      "ping";
    }
    storage = "null"
    muc_room_cache_size = 1000
VirtualHost "recorder.alexjit.dev2dev.net"
    modules_enabled = {
      "ping";
    }
    authentication = "internal_plain"
...

Next, uncomment https-ports (near the top of the file). Optionally, you can add an interfaces property:

cross_domain_bosh = false;
consider_bosh_secure = true;
https_ports = { }; -- Remove this line to prevent listening on port 5284
interfaces = { "*" };
...

The "*" in interfaces = { "*"} tells prosody to listen to all interfaces. See prosody docs for more details.

Add Users

Add a transcriber user using prosody, specifically to recorder.alexjit.dev2dev.net (or more generally, recorder.yourdomainname.whatever)

$ prosodyctl register transcriber recorder.alexjit.dev2dev.net ai3eiSha2nae

Also, change the password of the auth user:

$ prosodyctl passwd jigasi@auth.alexjit.dev2dev.net

This will prompt you to enter a new password (my password was vixohv2geeNa). If you want to see the prosody accounts go to: $ cd /var/lib/prosody/ , then cd into the relevant directory.

Convert the password you just entered (my password was vixohv2geeNa) to base64. The easiest way is to use an online base64 encoder, but you could also use Python:

>>> import base64
>>> base64.b64encode(b'vixohv2geeNa')
b'dml4b2h2MmdlZU5h'
>>> exit()

Jigasi Config

Put the base64 password in the Jigasi Properties file:

...
net.java.sip.communicator.impl.protocol.jabber.acc-xmpp-1.PASSWORD=dml4b2h2MmdlZU5h
...

Then add the transcriber user. The relevant properties are commented by default, so uncomment them and change the values:

...
org.jitsi.jigasi.xmpp.acc.USER_ID=transcriber@recorder.alexjit.dev2dev.net
org.jitsi.jigasi.xmpp.acc.PASS=ai3eiSha2nae
org.jitsi.jigasi.xmpp.acc.ANONYMOUS_AUTH=false
...

Jicofo Config

Next, append authentication info to the Jicofo Properties:

org.jitsi.jicofo.jigasi.BREWERY=JigasiBrewery@internal.auth.alexjit.dev2dev.net

Next Steps

This is the end of this section.