Einwahl in Jitsi Meet Konferenzen

Jitsi Meet ist eine Open-Source-Plattform für Videokonferenzen, die Sie auch selbst betreiben können. Die Lösung erlaubt es auch, dass Teilnehmer per Telefon an den Konferenzen teilnehmen. Die IPTAM^@ PBX unterstützt die Telefoneinwahl in Jitsi Meet Konferenzen durch ein Sprachmenü zur Eingabe der Konferenznummer und einer optionalen PIN.

Funktionsweise

Die Telefoneinwahl in den Jitsi Meet Server erfolgt über eine SIP-Verbindung zwischen Jitsi Meet Server und der IPTAM^@ PBX. Dazu dient auf der Jitsi Meet Seite der Dienst „jigasi“, der sich bei der IPTAM^@ PBX wie ein Telefon registriert. Auf der Seite der IPTAM^@ PBX wird dazu ein Anwender-Konto umgewidmet. Anrufe an die Nebenstelle dieses Anwenders gelangen zu einem Sprachmenü. Anschließend wird der Anrufer mit der Konferenz im Jitsi Meet Server verbunden. Bei entsprechender Konfiguration können aus einer Jitsi Meet Konferenz heraus weiterere Teilnehmer hinzu gerufen werden.

Konfiguration in der IPTAM^@ PBX

Zunächst benötigen Sie einen Anwender, dessen Konto für die Konferenzeinwahl genutzt werden soll. Da das Konto nicht zu normalen Telefonzwecken benutzt werden kann legen Sie gegebenenfalls zunächst ein Neues an. Damit aus einer Konferenz auch ausgehende externe Gespräche möglich sind achten Sie auf eine geeignete Berechtigungsklasse. Schränken Sie die Rechte ggf. ein, um unnötige Kosten zu vermeiden.

Zur Einrichtung der Einwahl in Jitsi Meet Konferenzen gehen Sie in das Menü Dienste►Jitsi-Einwahl. Sie sehen das links dargestellte Formular. Unter „Verwendete Anwender wählen Sie aus der Ausklappliste den Anwender aus, dessen Konto für die Kopplung zum Jitsi-Server verwendet werden soll. Bei „Server / Domain“ tragen Sie den FQDN des Jitsi-Servers ein, beispielsweise „jitsi-meet.firma.de“. Die Auswahl zur „HD-Telefonie“ erscheint nur, wenn Sie die HD-Telefonie vorgesehen haben. Aktivieren Sie diese Option nur, wenn der Jitsi Server diesen Codec ebenfalls unterstützt. Die Einstellung „Einwahl-Prüfung“ wechselt zwischen den links und rechts dargestellten Dialogen. Nähere Informationen folgen in den Abschnitten zu den Einwahloptionen weiter unten.

Konfiguration Jitsi Meet Server

Zunächst prüfen Sie, ob die Komponente „jigasi“ in Ihrem Jitsi-Server installiert ist. Falls nicht holen Sie das nach. Die SIP-Zugangsinformationen werden in zwei Konfigurationsdateien benötigt. Ausgehend vom Konfigurationsverzeichnis Ihres Jitsi-Servers liegen die beiden Dateien im Verzeichnis „jigasi“. In der Datei „config“ erfolgen die Einstellungen:

JIGASI_SIPUSER=sip-account@iptam-ip
JIGASI_SIPPWD=passwort (base64)
JIGASI_OPTS=""
JIGASI_HOSTNAME=FQDN

Bei „JIGASI_SIPUSER“ tragen Sie den Account Ihres Anwenders sowie die IP-Adresse (oder den Hostnamen) Ihrer IPTAM^@ PBX ein. Das Passwort bei „JIGASI_SIPPWD“ muss als base64Auf der Unix oder Linux-Konsole mit „echo passwort | base64“ zu bestimmen.
codierter Wert eingetragen werden. Bei „JIGASI_HOSTNAME“ sollte bereits der FQDN Ihres Jitsi-Servers durch die Installation eingetragen sein.

In der Datei „sip-communicator.properties“ suchen Sie die erste Eintragung „net.java.sip.communicator.impl.protocol.sip“ zu Beginn der Datei. Es folgen eine ganze Reihe Zeilen mit diesem Text am Anfang. Entscheidend sind die Schlüsselworte vor dem „=“-Zeichen.

ACCOUNT_UID=SIP\:sip-account@iptam-ip
PASSWORD=passwort (base64)
SERVER_ADDRESS=iptam-ip
USER_ID=sip-account@iptam-ip

Hier werden die Werte wie oben beschrieben eingetragen.

Nach dem Ändern der Dateien starten Sie den Dienst „jigasi“ neu. Sie sollten dann in der Diagnose►SIP-Registry der Telefonanlage sehen, dass der Account registriert ist.

Option in der Telefonanlage „Einwahl-Prüfung intern“

Rufen Sie in der Konferenz den Einladungsdialog auf (Beispiel links). Im oberen Abschnitt können Sie aus der Konferenz weitere Teilnehmer anrufen (interne Anwender der IPTAM^@ PBX und externe Teilnehmer je nach eingestellter Berechtigungsklasse). Im unteren Abschnitt sehen Sie die Einwahldaten für Anrufer (intern und extern). Darunter sehen Sie die PIN. Teilen Sie den betreffenden Personen die Rufnummer und die PIN mit. Wenn diese sich einwählen und die PIN korrekt eingegeben haben werden Sie der Konferenz hinzu geschaltet. Damit Sie diese Einwahlmethode verwenden können, muss der Jitsi-Server die Telefonanlage per HTTPS erreichen können und passend konfiguriert sein.

Im Jitsi-Server müssen zwei URLs konfiguriert werden, die der Jitsi-Server in der IPTAM^@ PBX aufruft. Die erste dient dazu, die Einwahldaten abzufragen, die zweite dazu die PIN zu generieren und dann zur Anzeige zu bringen.

Ausgehend vom Konfigurationsverzeichnis Ihres Jitsi-Servers editieren Sie die Datei im Verzeichnis „meet“ mit dem Namen „FQDN-config.js“, wobei FQDN derjenige Ihres Jitsi-Servers ist (Dateiname z.B. jitsi-meet.iptam-pbx.de-config.js). Suchen Sie nach dem Eintrag „dialInNumbersUrl“ (meist auskommentiert). Tragen Sie darunter die beiden Zeilen ein:

dialInNumbersUrl: 'https://iptam-pbx-fqdn/jitsi/dialin',
dialInConfCodeUrl: 'https://iptam-pbx-fqdn/jitsi/conf-mapper',

Achten Sie auf das Komma am Zeilenende. Ersetzen Sie „iptam-pbx-fqdn“ durch den Namen Ihrer Telefonanlage in der Form, wie er auch im Zertifikat der IPTAM^@ PBX genannt ist. Starten Sie den Dienst anschließend neu. Sobald Sie den Einladungsdialog aufrufen, erscheinen die Einwahldaten wie im Bild gezeigt.

Option in der Telefonanlage „Einwahl-Prüfung Jitsi-Server (extern)“

Wählen Sie diese Option, wenn das zuvor beschrieben Verfahren für Ihre Installation nicht in Frage kommt (z.B. weil keine HTTPS-Kommunikation vom Jitsi-Server zur Telefonanlage möglich ist).

Ihre Konferenzen, die per Telefoneinwahl erreicht werden sollen, benötigen einen rein numerischen Wert (ggf. ergänzt um einen festen Präfix, also z.B. konferenz-1234). Den Präfix tragen Sie dann im Feld „Präfix für Konferenzen“ ein. Bei einer Einwahl hören Anrufer die Aufforderung die Konferenznummer einzugeben, optional gefolgt von einer PIN. Beide eingegebenen Daten werden im folgenden Anruf an den Jitsi-Server in dafür vorgesehene Header-Elementen übergeben. Die Prüfung, ob die PIN korrekt ist muss extern erfolgen. Wenn keine Ablehnung erfolgt, wird der Anrufer der Konferenz hinzugefügt. Ohne eine externe Prüfung gelangen Anrufer ungeprüft in Ihre Konferenzen!.