http://wiki.fhem.de/w/api.php?action=feedcontributions&feedformat=atom&user=BioSFHEMWiki - Benutzerbeiträge [de]2026-04-30T21:16:54ZBenutzerbeiträgeMediaWiki 1.43.6http://wiki.fhem.de/w/index.php?title=Jabber&diff=21680Jabber2017-06-08T20:27:35Z<p>BioS: libgpg-error-dev hinzugefügt (thx Ralf W)</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=Dieses Modul ermöglicht FHEM, sich mit dem Jabber-Netzwerk zu verbinden, um Nachrichten zu einem Jabber-Server zu senden oder von diesem zu empfangen.<br />
|ModType=d<br />
|ModCmdRef= <br />
|ModForumArea=Unterstuetzende Dienste<br />
|ModFTopic=18967<br />
|ModTechName=70_Jabber.pm<br />
|ModOwner=BioS ({{Link2FU|2021|Forum}})<br />
}}<br />
[[Jabber]] ist eine andere Beschreibung für "XMPP", ein Kommunikationsprotokoll für Nachrichtenorientierte "middleware", basierend auf XML.<br />
Fester bestandteil des Protokolls ist die Verschlüsselung zwischen Client und Server.<br />
Für den Benutzer ist es ähnlich anderer Chat-Plattformen wie zum Beispiel dem facebook Chat, ICQ oder Google Hangouts - jedoch frei Verfügbar, open Source und normalerweise Verschlüsselt (was Serverabhängig ist).<br />
<br />
Seit Version 1.5 kann dieses Modul in Multi-User-Channel (sogenannte MUC) beitreten und Off-the-Record (OTR) Ende-zu-Ende Verschlüsselung benutzen.<br />
OTR ist nochmal ein zusätzlicher Sicherheitsrelevater Punkt, da die Kommunikation wirklich von Endgerät zu FHEM verschlüsselt wird und man sich nicht auf die Jabber Server Transportverschlüsselung verlassen muss.<br />
<br />
<!--<br />
==Voraussetzungen==<br />
Für dieses Modul brauchst du einen Account auf einem Jabber Server. Kostenlose Accounts und Server findet man unter [https://jabber.org jabber.org]<br />
<br />
Auf dem FHEM-Server müssen folgende Perl-Module installiert sein:<br />
*Net::Jabber<br />
*Net::XMPP<br />
*Authen::SASL<br />
*XML::Stream<br />
*Net::SSLeay<br />
*Crypt::OTR (wenn OTR verwendet werden soll)<br />
<br />
==Definition==<br />
===define===<br />
<br />
;*define <name> Jabber <server> <port> <username> <password> <TLS> <SSL><br />
:Du benötigst natürlich echte Accountdaten.<br />
<br />
;Beispiel:<br />
<source lang="perl">define JabberClient1 Jabber jabber.org 5222 myusername mypassword 1 0</source><br />
<br />
<br />
===set===<br />
<br />
;*set <name> msg <username> <msg><br />
:Sendet eine Nachricht '''''msg''''' an den Jabberuser '''''username'''''<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msg myname@jabber.org It is working!</source><br />
<br />
<br />
;*set <name> msgmuc <channel> <msg><br />
:Sendet eine Nachricht '''''msg''''' an dieJabber-MUC-Gruppe '''''channel'''''<br />
:Dabei wird ein eventuell mitgegebener Nickname von "channel" entfernt, so kann man direkt das Reading LastMessageJID benutzen.<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msgmuc roomname@jabber.org Woot!</source><br />
<br />
<br />
;*set <name> msgotr <username> <msg><br />
:Sendet eine OTR verschlüsselte Nachricht an den '''''username'''''. Wenn keine aktive OTR Sitzung aufgebaut ist, wird versucht eine aufzubauen.<br />
:Wenn der Empfänger OTR nicht versteht, wird die Nachricht verworfen, d.h. sie wird auf keinen Fall im Klartext übertragen.<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msgotr myname@jabber.org Wir sehen uns heute um 18:00 Uhr :*</source><br />
<br />
<br />
;*set <name> subscribe <username><br />
:Frägt eine Authorisierung beim '''''username''''' an (normalerweise wird das nicht benötigt)<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 subscribe myname@jabber.org</source><br />
<br />
<br />
===Attribute===<br />
<br />
;*OnlineStatus available|unavailable<br />
:Setzt den Online-status, ob der Client anderen gegenüber Online ist (available) oder Offline erscheint (unavailable)<br />
:Es ist möglich dass einige Server eingehende Nachrichten trotzdem FHEM zustellen obwohl er "unavailable" ist<br />
<br />
:Standard: <code>available</code><br />
<br />
;*ResourceName <name><br />
:In der Jabber-Welt kann ein Client mit einem Usernamen öfter mit einem Server verbunden sein (z.b. Handy, Computer, FHEM).<br />
:Der '''resource name''' ergibt die finale Jabber-ID und macht die verschiedenen Verbindungen einzigartig (z.B. bios@jabber.org/FHEM).<br />
:Hier kannst du den '''resource name''' setzen.<br />
<br />
:Standard: <code>FHEM</code><br />
<br />
;*PollTimer <''seconds''><br />
:Dies ist der Intervall in der überprüft wird ob neue Nachrichten zur Verarbeitung beim Jabber Server anstehen.<br />
:Ebenfalls wird hiermit die Verbindung zum Server überprüft (Timeouts, DSL Disconnects etc.).<br />
:Setze es nicht über 10 Sekunden, die Verbindung kann sonst die ganze Zeit getrennt werden, Sie wird zwar wieder aufgebaut, aber nach 10 Sekunden brechen die meisten Server die Verbindung automatisch ab.<br />
<br />
:Standard: <code>2</code><br />
<br />
;*RecvWhitelist <Regex><br />
:Nur wenn die Jabber-ID einer privaten empfangenen Nachricht auf diese Regex zutrifft, akzeptiert FHEM die Nachricht und gibt sie an Notifys weiter. Alles andere wird verworfen.<br />
<br />
:Standard: <code>.*</code><br />
<br />
:Beispiele:<br />
:*<code>myname@jabber.org</code><br />
:*<code>(myname1@jabber.org|myname2@xmpp.de)</code><br />
<br />
;*MucJoin<br />
:Tritt dem MUC mit dem spezifizierten Nickname und dem optionalem Passwort bei.<br />
<br />
:Standard: nicht definiert<br />
<br />
:Beispiele:<br />
:*Einen Raum betreten: <code>channel1@server.com/mynick</code><br />
:*Mehrere Räume betreten: <code>channel1@server.com/mynick,channel2@server.com/myothernick</code><br />
:*Einen Raum mit Passwort betreten: <code>channel1@server.com/mynick:password</code><br />
<br />
;*MucRecvWhitelist <Regex><br />
:Selbe funktion wie RecvWhitelist, aber für Gruppenräume: Nur wenn die Regex zutrifft, wird die Nachricht verarbeitet. Alles andere wird ignoriert.<br />
<br />
:Standard: nicht definiert (keine Nachricht wird akzeptiert)<br />
<br />
:Beispiele:<br />
:*Alle Nachrichten aller betretenen Räume erlauben: <code>.*</code><br />
:*Alle Nachrichten bestimmter betretenen Räume erlauben: <code>mychannel@jabber.org</code><br />
:*Nur bestimmte User in bestimmten betretenen Räumen erlauben: <code>mychannel@jabber.org/NickOfFriend</code><br />
<br />
;*OTREnable 1|0<br />
:Schaltet die Verschlüsselungsfunktionen von Crypt::OTR für sichere Ende-zu-Ende Kummunikation in FHEM an oder aus.<br />
:Es muss zwangsläufig dafür Crypt::OTR installiert sein.<br />
:Ein Privater Schlüssel wird bei Erstbenutzung generiert, das kann mehr als 2 Stunden dauern! Dafür ist das eine einmalige Sache und FHEM wird dadurch nicht blockiert. Im Device sieht man im OTR_STATE wenn der Private Schlüssel fertig ist. Erst danach ist OTR aktiv.<br />
<br />
:Standard: nicht definiert (OTR deaktiviert)<br />
<br />
;*OTRSharedSecret aSecretKeyiOnlyKnow@@*<br />
:Optionales geheimes Passwort, dass man vom Endgerät an FHEM schicken kann um zu beweisen, dass es sich tatsächlich um FHEM handelt und nicht um einen Hacker der sich (z.b. bei dem Internetprovider) zwischengeschaltet hat. Normalerweise bekommt das Endgerät eine Warnung wenn sich an einer bereits verifizierten Verbindung etwas geändert hat.<br />
:Diese Warnung sollte man dann sehr ernst nehmen.<br />
<br />
:Standard: nicht definiert, setze hier dein geheimes Passwort.<br />
<br />
<br />
===Generierte Readings/Events===<br />
<br />
*Privat Nachrichten<br />
**Message - Komplette Nachricht inkl. JID und Text<br />
**LastMessage - Nur der Textteil der Nachricht<br />
**LastSenderJID - Nur die Sender-JID der Nachricht<br />
<br />
*Verschlüsselte Private Nachrichten (wenn OTREnable=1)<br />
**OTRMessage - Komplette entschlüsselte Nachricht inkl. JID und Text<br />
**OTRLastMessage - Nur der Textteil der Nachricht<br />
**OTRLastSenderJID - Nur die Sender-JID der Nachricht<br />
<br />
*MUC Raum Nachrichten (wenn MUCJoin gesetzt ist)<br />
**MucMessage - Komplette Nachricht (Raumname/Nickname und Text)<br />
**MucLastMessage - Nur der Textteil der Nachricht<br />
**MucLastSenderJID - Nur die Sender-JID der Nachricht<br />
--><br />
<br />
==Installation==<br />
Auf aktuellen Systemen gibt es leider Probleme mit den verwendeten XMPP Perl Modulen.<br />
<br />
Im speziellen benötigt man zwingend die folgende Perl-Modul Kombination, damit das Jabber Modul richtig funktionieren kann:<br />
*XML::Stream 1.23<br />
*Net::XMPP 1.02<br />
<br />
Seine Modulversionen kann mit mit diesen Kommandos überprüfen, dabei auf den "Installed:" Eintrag achten:<br />
<source lang="bash"><br />
cpan -D XML::Stream<br />
cpan -D Net::XMPP<br />
</source><br />
<br />
Wenn man OTR benutzen möchte sollte zusätzlich noch das Perl Modul Crypt::OTR installiert sein.<br />
<br />
Auf einem frisch installieren Ubuntu 16.04.02 LTS bedeutet das folgende Kommandos:<br />
<source lang="bash"><br />
apt-get remove libnet-xmpp-perl<br />
apt-get remove libxml-stream-perl<br />
apt-get remove libotr5 libotr5-dev<br />
<br />
apt-get install build-essential<br />
apt-get install libnet-jabber-perl<br />
wget http://ftp.de.debian.org/debian/pool/main/libn/libnet-xmpp-perl/libnet-xmpp-perl_1.02-3_all.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libx/libxml-stream-perl/libxml-stream-perl_1.23-2_all.deb<br />
dpkg -i libxml-stream-perl_1.23-2_all.deb<br />
dpkg -i libnet-xmpp-perl_1.02-3_all.deb<br />
</source><br />
<br />
Für OTR ist noch folgendes notwendig (64bit Intel Platform):<br />
<source lang="bash"><br />
apt-get install libgpg-error-dev<br />
cpan install Digest::SHA1<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-dev_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-bin_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libg/libgcrypt11/libgcrypt11_1.5.0-5+deb7u4_amd64.deb<br />
dpkg -i libgcrypt11_1.5.0-5+deb7u4_amd64.deb<br />
dpkg -i libotr2_3.2.1-1+deb7u2_amd64.deb<br />
dpkg -i libotr2-bin_3.2.1-1+deb7u2_amd64.deb<br />
dpkg -i libotr2-dev_3.2.1-1+deb7u2_amd64.deb<br />
<br />
cpan<br />
cpan> notest install Crypt::OTR<br />
</source><br />
<br />
OTR bei 32 bit (Intel Platform):<br />
<source lang="bash"><br />
apt-get install libgpg-error-dev<br />
cpan install Digest::SHA1<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-dev_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-bin_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libg/libgcrypt11/libgcrypt11_1.5.0-5+deb7u4_i386.deb<br />
dpkg -i libgcrypt11_1.5.0-5+deb7u4_i386.deb<br />
dpkg -i libotr2_3.2.1-1+deb7u2_i386.deb<br />
dpkg -i libotr2-bin_3.2.1-1+deb7u2_i386.deb<br />
dpkg -i libotr2-dev_3.2.1-1+deb7u2_i386.deb<br />
<br />
cpan<br />
cpan> notest install Crypt::OTR<br />
</source><br />
<br />
Wer keine Stunden auf die Keygenerierung warten will, kann noch das Programm "haveged" installieren, das kümmert sich um die entrophy generation, die OTR dringend braucht für seinen Privaten Schlüssel:<br />
* haveged<br />
<source lang="bash"><br />
apt-get install haveged<br />
</source><br />
<br />
==Beispiele==<br />
Mit folgendem [[Notify]]-Beispiel kannst du auf eingehende Nachrichten reagieren, dieses Beispiel schickt das Reading "Temperatur" des Sensors "BU_Temperatur" bei jeder ankommenden Nachricht an den Sender zurück:<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:Message.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msg ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
<br />
Auf MUC Nachrichten lässt sich folgend reagieren, Augenmerk darauf legen dass der Nickname aus $lastsender in der msgmuc Funktion entfernt wird, damit die Nachricht an den Raum geht<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:MucMessage.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msgmuc ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
<br />
Auf OTR Nachrichten wird reagiert, wie auf normale private Nachrichten auch, jedoch wird mit der msgotr Funktion geantwortet:<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:OTRMessage.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msgotr ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
==Weitere Beispiele und HowTos im Wiki==<br />
*[[FHEM_spricht_jabber]]<br />
*[[Prosody|Installieren eines eigenen XMPP-Servers]]<br />
<br />
==Weblinks==<br />
*[https://de.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol XMPP]<br />
*[https://jabber.org jabber.org]<br />
*[https://prosody.im/ Prosody Jabber Server]<br />
*[https://pidgin.im/ pidgin Jabber Client]</div>BioShttp://wiki.fhem.de/w/index.php?title=Jabber&diff=21667Jabber2017-06-03T20:31:26Z<p>BioS: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=Dieses Modul ermöglicht FHEM, sich mit dem Jabber-Netzwerk zu verbinden, um Nachrichten zu einem Jabber-Server zu senden oder von diesem zu empfangen.<br />
|ModType=d<br />
|ModCmdRef= <br />
|ModForumArea=Unterstuetzende Dienste<br />
|ModFTopic=18967<br />
|ModTechName=70_Jabber.pm<br />
|ModOwner=BioS ({{Link2FU|2021|Forum}})<br />
}}<br />
[[Jabber]] ist eine andere Beschreibung für "XMPP", ein Kommunikationsprotokoll für Nachrichtenorientierte "middleware", basierend auf XML.<br />
Fester bestandteil des Protokolls ist die Verschlüsselung zwischen Client und Server.<br />
Für den Benutzer ist es ähnlich anderer Chat-Plattformen wie zum Beispiel dem facebook Chat, ICQ oder Google Hangouts - jedoch frei Verfügbar, open Source und normalerweise Verschlüsselt (was Serverabhängig ist).<br />
<br />
Seit Version 1.5 kann dieses Modul in Multi-User-Channel (sogenannte MUC) beitreten und Off-the-Record (OTR) Ende-zu-Ende Verschlüsselung benutzen.<br />
OTR ist nochmal ein zusätzlicher Sicherheitsrelevater Punkt, da die Kommunikation wirklich von Endgerät zu FHEM verschlüsselt wird und man sich nicht auf die Jabber Server Transportverschlüsselung verlassen muss.<br />
<br />
<!--<br />
==Voraussetzungen==<br />
Für dieses Modul brauchst du einen Account auf einem Jabber Server. Kostenlose Accounts und Server findet man unter [https://jabber.org jabber.org]<br />
<br />
Auf dem FHEM-Server müssen folgende Perl-Module installiert sein:<br />
*Net::Jabber<br />
*Net::XMPP<br />
*Authen::SASL<br />
*XML::Stream<br />
*Net::SSLeay<br />
*Crypt::OTR (wenn OTR verwendet werden soll)<br />
<br />
==Definition==<br />
===define===<br />
<br />
;*define <name> Jabber <server> <port> <username> <password> <TLS> <SSL><br />
:Du benötigst natürlich echte Accountdaten.<br />
<br />
;Beispiel:<br />
<source lang="perl">define JabberClient1 Jabber jabber.org 5222 myusername mypassword 1 0</source><br />
<br />
<br />
===set===<br />
<br />
;*set <name> msg <username> <msg><br />
:Sendet eine Nachricht '''''msg''''' an den Jabberuser '''''username'''''<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msg myname@jabber.org It is working!</source><br />
<br />
<br />
;*set <name> msgmuc <channel> <msg><br />
:Sendet eine Nachricht '''''msg''''' an dieJabber-MUC-Gruppe '''''channel'''''<br />
:Dabei wird ein eventuell mitgegebener Nickname von "channel" entfernt, so kann man direkt das Reading LastMessageJID benutzen.<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msgmuc roomname@jabber.org Woot!</source><br />
<br />
<br />
;*set <name> msgotr <username> <msg><br />
:Sendet eine OTR verschlüsselte Nachricht an den '''''username'''''. Wenn keine aktive OTR Sitzung aufgebaut ist, wird versucht eine aufzubauen.<br />
:Wenn der Empfänger OTR nicht versteht, wird die Nachricht verworfen, d.h. sie wird auf keinen Fall im Klartext übertragen.<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msgotr myname@jabber.org Wir sehen uns heute um 18:00 Uhr :*</source><br />
<br />
<br />
;*set <name> subscribe <username><br />
:Frägt eine Authorisierung beim '''''username''''' an (normalerweise wird das nicht benötigt)<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 subscribe myname@jabber.org</source><br />
<br />
<br />
===Attribute===<br />
<br />
;*OnlineStatus available|unavailable<br />
:Setzt den Online-status, ob der Client anderen gegenüber Online ist (available) oder Offline erscheint (unavailable)<br />
:Es ist möglich dass einige Server eingehende Nachrichten trotzdem FHEM zustellen obwohl er "unavailable" ist<br />
<br />
:Standard: <code>available</code><br />
<br />
;*ResourceName <name><br />
:In der Jabber-Welt kann ein Client mit einem Usernamen öfter mit einem Server verbunden sein (z.b. Handy, Computer, FHEM).<br />
:Der '''resource name''' ergibt die finale Jabber-ID und macht die verschiedenen Verbindungen einzigartig (z.B. bios@jabber.org/FHEM).<br />
:Hier kannst du den '''resource name''' setzen.<br />
<br />
:Standard: <code>FHEM</code><br />
<br />
;*PollTimer <''seconds''><br />
:Dies ist der Intervall in der überprüft wird ob neue Nachrichten zur Verarbeitung beim Jabber Server anstehen.<br />
:Ebenfalls wird hiermit die Verbindung zum Server überprüft (Timeouts, DSL Disconnects etc.).<br />
:Setze es nicht über 10 Sekunden, die Verbindung kann sonst die ganze Zeit getrennt werden, Sie wird zwar wieder aufgebaut, aber nach 10 Sekunden brechen die meisten Server die Verbindung automatisch ab.<br />
<br />
:Standard: <code>2</code><br />
<br />
;*RecvWhitelist <Regex><br />
:Nur wenn die Jabber-ID einer privaten empfangenen Nachricht auf diese Regex zutrifft, akzeptiert FHEM die Nachricht und gibt sie an Notifys weiter. Alles andere wird verworfen.<br />
<br />
:Standard: <code>.*</code><br />
<br />
:Beispiele:<br />
:*<code>myname@jabber.org</code><br />
:*<code>(myname1@jabber.org|myname2@xmpp.de)</code><br />
<br />
;*MucJoin<br />
:Tritt dem MUC mit dem spezifizierten Nickname und dem optionalem Passwort bei.<br />
<br />
:Standard: nicht definiert<br />
<br />
:Beispiele:<br />
:*Einen Raum betreten: <code>channel1@server.com/mynick</code><br />
:*Mehrere Räume betreten: <code>channel1@server.com/mynick,channel2@server.com/myothernick</code><br />
:*Einen Raum mit Passwort betreten: <code>channel1@server.com/mynick:password</code><br />
<br />
;*MucRecvWhitelist <Regex><br />
:Selbe funktion wie RecvWhitelist, aber für Gruppenräume: Nur wenn die Regex zutrifft, wird die Nachricht verarbeitet. Alles andere wird ignoriert.<br />
<br />
:Standard: nicht definiert (keine Nachricht wird akzeptiert)<br />
<br />
:Beispiele:<br />
:*Alle Nachrichten aller betretenen Räume erlauben: <code>.*</code><br />
:*Alle Nachrichten bestimmter betretenen Räume erlauben: <code>mychannel@jabber.org</code><br />
:*Nur bestimmte User in bestimmten betretenen Räumen erlauben: <code>mychannel@jabber.org/NickOfFriend</code><br />
<br />
;*OTREnable 1|0<br />
:Schaltet die Verschlüsselungsfunktionen von Crypt::OTR für sichere Ende-zu-Ende Kummunikation in FHEM an oder aus.<br />
:Es muss zwangsläufig dafür Crypt::OTR installiert sein.<br />
:Ein Privater Schlüssel wird bei Erstbenutzung generiert, das kann mehr als 2 Stunden dauern! Dafür ist das eine einmalige Sache und FHEM wird dadurch nicht blockiert. Im Device sieht man im OTR_STATE wenn der Private Schlüssel fertig ist. Erst danach ist OTR aktiv.<br />
<br />
:Standard: nicht definiert (OTR deaktiviert)<br />
<br />
;*OTRSharedSecret aSecretKeyiOnlyKnow@@*<br />
:Optionales geheimes Passwort, dass man vom Endgerät an FHEM schicken kann um zu beweisen, dass es sich tatsächlich um FHEM handelt und nicht um einen Hacker der sich (z.b. bei dem Internetprovider) zwischengeschaltet hat. Normalerweise bekommt das Endgerät eine Warnung wenn sich an einer bereits verifizierten Verbindung etwas geändert hat.<br />
:Diese Warnung sollte man dann sehr ernst nehmen.<br />
<br />
:Standard: nicht definiert, setze hier dein geheimes Passwort.<br />
<br />
<br />
===Generierte Readings/Events===<br />
<br />
*Privat Nachrichten<br />
**Message - Komplette Nachricht inkl. JID und Text<br />
**LastMessage - Nur der Textteil der Nachricht<br />
**LastSenderJID - Nur die Sender-JID der Nachricht<br />
<br />
*Verschlüsselte Private Nachrichten (wenn OTREnable=1)<br />
**OTRMessage - Komplette entschlüsselte Nachricht inkl. JID und Text<br />
**OTRLastMessage - Nur der Textteil der Nachricht<br />
**OTRLastSenderJID - Nur die Sender-JID der Nachricht<br />
<br />
*MUC Raum Nachrichten (wenn MUCJoin gesetzt ist)<br />
**MucMessage - Komplette Nachricht (Raumname/Nickname und Text)<br />
**MucLastMessage - Nur der Textteil der Nachricht<br />
**MucLastSenderJID - Nur die Sender-JID der Nachricht<br />
--><br />
<br />
==Installation==<br />
Auf aktuellen Systemen gibt es leider Probleme mit den verwendeten XMPP Perl Modulen.<br />
<br />
Im speziellen benötigt man zwingend die folgende Perl-Modul Kombination, damit das Jabber Modul richtig funktionieren kann:<br />
*XML::Stream 1.23<br />
*Net::XMPP 1.02<br />
<br />
Seine Modulversionen kann mit mit diesen Kommandos überprüfen, dabei auf den "Installed:" Eintrag achten:<br />
<source lang="bash"><br />
cpan -D XML::Stream<br />
cpan -D Net::XMPP<br />
</source><br />
<br />
Wenn man OTR benutzen möchte sollte zusätzlich noch das Perl Modul Crypt::OTR installiert sein.<br />
<br />
Auf einem frisch installieren Ubuntu 16.04.02 LTS bedeutet das folgende Kommandos:<br />
<source lang="bash"><br />
apt-get remove libnet-xmpp-perl<br />
apt-get remove libxml-stream-perl<br />
apt-get remove libotr5 libotr5-dev<br />
<br />
apt-get install build-essential<br />
apt-get install libnet-jabber-perl<br />
wget http://ftp.de.debian.org/debian/pool/main/libn/libnet-xmpp-perl/libnet-xmpp-perl_1.02-3_all.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libx/libxml-stream-perl/libxml-stream-perl_1.23-2_all.deb<br />
dpkg -i libxml-stream-perl_1.23-2_all.deb<br />
dpkg -i libnet-xmpp-perl_1.02-3_all.deb<br />
</source><br />
<br />
Für OTR ist noch folgendes notwendig (64bit Intel Platform):<br />
<source lang="bash"><br />
cpan install Digest::SHA1<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-dev_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-bin_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libg/libgcrypt11/libgcrypt11_1.5.0-5+deb7u4_amd64.deb<br />
dpkg -i libgcrypt11_1.5.0-5+deb7u4_amd64.deb<br />
dpkg -i libotr2_3.2.1-1+deb7u2_amd64.deb<br />
dpkg -i libotr2-bin_3.2.1-1+deb7u2_amd64.deb<br />
dpkg -i libotr2-dev_3.2.1-1+deb7u2_amd64.deb<br />
<br />
cpan<br />
cpan> notest install Crypt::OTR<br />
</source><br />
<br />
OTR bei 32 bit (Intel Platform):<br />
<source lang="bash"><br />
cpan install Digest::SHA1<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-dev_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-bin_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libg/libgcrypt11/libgcrypt11_1.5.0-5+deb7u4_i386.deb<br />
dpkg -i libgcrypt11_1.5.0-5+deb7u4_i386.deb<br />
dpkg -i libotr2_3.2.1-1+deb7u2_i386.deb<br />
dpkg -i libotr2-bin_3.2.1-1+deb7u2_i386.deb<br />
dpkg -i libotr2-dev_3.2.1-1+deb7u2_i386.deb<br />
<br />
cpan<br />
cpan> notest install Crypt::OTR<br />
</source><br />
<br />
Wer keine Stunden auf die Keygenerierung warten will, kann noch das Programm "haveged" installieren, das kümmert sich um die entrophy generation, die OTR dringend braucht für seinen Privaten Schlüssel:<br />
* haveged<br />
<source lang="bash"><br />
apt-get install haveged<br />
</source><br />
<br />
==Beispiele==<br />
Mit folgendem [[Notify]]-Beispiel kannst du auf eingehende Nachrichten reagieren, dieses Beispiel schickt das Reading "Temperatur" des Sensors "BU_Temperatur" bei jeder ankommenden Nachricht an den Sender zurück:<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:Message.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msg ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
<br />
Auf MUC Nachrichten lässt sich folgend reagieren, Augenmerk darauf legen dass der Nickname aus $lastsender in der msgmuc Funktion entfernt wird, damit die Nachricht an den Raum geht<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:MucMessage.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msgmuc ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
<br />
Auf OTR Nachrichten wird reagiert, wie auf normale private Nachrichten auch, jedoch wird mit der msgotr Funktion geantwortet:<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:OTRMessage.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msgotr ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
==Weitere Beispiele und HowTos im Wiki==<br />
*[[FHEM_spricht_jabber]]<br />
*[[Prosody|Installieren eines eigenen XMPP-Servers]]<br />
<br />
==Weblinks==<br />
*[https://de.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol XMPP]<br />
*[https://jabber.org jabber.org]<br />
*[https://prosody.im/ Prosody Jabber Server]<br />
*[https://pidgin.im/ pidgin Jabber Client]</div>BioShttp://wiki.fhem.de/w/index.php?title=Jabber&diff=21664Jabber2017-06-03T20:12:48Z<p>BioS: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=Dieses Modul ermöglicht FHEM, sich mit dem Jabber-Netzwerk zu verbinden, um Nachrichten zu einem Jabber-Server zu senden oder von diesem zu empfangen.<br />
|ModType=d<br />
|ModCmdRef= <br />
|ModForumArea=Unterstuetzende Dienste<br />
|ModFTopic=18967<br />
|ModTechName=70_Jabber.pm<br />
|ModOwner=BioS ({{Link2FU|2021|Forum}})<br />
}}<br />
[[Jabber]] ist eine andere Beschreibung für "XMPP", ein Kommunikationsprotokoll für Nachrichtenorientierte "middleware", basierend auf XML.<br />
Fester bestandteil des Protokolls ist die Verschlüsselung zwischen Client und Server.<br />
Für den Benutzer ist es ähnlich anderer Chat-Plattformen wie zum Beispiel dem facebook Chat, ICQ oder Google Hangouts - jedoch frei Verfügbar, open Source und normalerweise Verschlüsselt (was Serverabhängig ist).<br />
<br />
Seit Version 1.5 kann dieses Modul in Multi-User-Channel (sogenannte MUC) beitreten und Off-the-Record (OTR) Ende-zu-Ende Verschlüsselung benutzen.<br />
OTR ist nochmal ein zusätzlicher Sicherheitsrelevater Punkt, da die Kommunikation wirklich von Endgerät zu FHEM verschlüsselt wird und man sich nicht auf die Jabber Server Transportverschlüsselung verlassen muss.<br />
<br />
<!--<br />
==Voraussetzungen==<br />
Für dieses Modul brauchst du einen Account auf einem Jabber Server. Kostenlose Accounts und Server findet man unter [https://jabber.org jabber.org]<br />
<br />
Auf dem FHEM-Server müssen folgende Perl-Module installiert sein:<br />
*Net::Jabber<br />
*Net::XMPP<br />
*Authen::SASL<br />
*XML::Stream<br />
*Net::SSLeay<br />
*Crypt::OTR (wenn OTR verwendet werden soll)<br />
<br />
==Definition==<br />
===define===<br />
<br />
;*define <name> Jabber <server> <port> <username> <password> <TLS> <SSL><br />
:Du benötigst natürlich echte Accountdaten.<br />
<br />
;Beispiel:<br />
<source lang="perl">define JabberClient1 Jabber jabber.org 5222 myusername mypassword 1 0</source><br />
<br />
<br />
===set===<br />
<br />
;*set <name> msg <username> <msg><br />
:Sendet eine Nachricht '''''msg''''' an den Jabberuser '''''username'''''<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msg myname@jabber.org It is working!</source><br />
<br />
<br />
;*set <name> msgmuc <channel> <msg><br />
:Sendet eine Nachricht '''''msg''''' an dieJabber-MUC-Gruppe '''''channel'''''<br />
:Dabei wird ein eventuell mitgegebener Nickname von "channel" entfernt, so kann man direkt das Reading LastMessageJID benutzen.<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msgmuc roomname@jabber.org Woot!</source><br />
<br />
<br />
;*set <name> msgotr <username> <msg><br />
:Sendet eine OTR verschlüsselte Nachricht an den '''''username'''''. Wenn keine aktive OTR Sitzung aufgebaut ist, wird versucht eine aufzubauen.<br />
:Wenn der Empfänger OTR nicht versteht, wird die Nachricht verworfen, d.h. sie wird auf keinen Fall im Klartext übertragen.<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msgotr myname@jabber.org Wir sehen uns heute um 18:00 Uhr :*</source><br />
<br />
<br />
;*set <name> subscribe <username><br />
:Frägt eine Authorisierung beim '''''username''''' an (normalerweise wird das nicht benötigt)<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 subscribe myname@jabber.org</source><br />
<br />
<br />
===Attribute===<br />
<br />
;*OnlineStatus available|unavailable<br />
:Setzt den Online-status, ob der Client anderen gegenüber Online ist (available) oder Offline erscheint (unavailable)<br />
:Es ist möglich dass einige Server eingehende Nachrichten trotzdem FHEM zustellen obwohl er "unavailable" ist<br />
<br />
:Standard: <code>available</code><br />
<br />
;*ResourceName <name><br />
:In der Jabber-Welt kann ein Client mit einem Usernamen öfter mit einem Server verbunden sein (z.b. Handy, Computer, FHEM).<br />
:Der '''resource name''' ergibt die finale Jabber-ID und macht die verschiedenen Verbindungen einzigartig (z.B. bios@jabber.org/FHEM).<br />
:Hier kannst du den '''resource name''' setzen.<br />
<br />
:Standard: <code>FHEM</code><br />
<br />
;*PollTimer <''seconds''><br />
:Dies ist der Intervall in der überprüft wird ob neue Nachrichten zur Verarbeitung beim Jabber Server anstehen.<br />
:Ebenfalls wird hiermit die Verbindung zum Server überprüft (Timeouts, DSL Disconnects etc.).<br />
:Setze es nicht über 10 Sekunden, die Verbindung kann sonst die ganze Zeit getrennt werden, Sie wird zwar wieder aufgebaut, aber nach 10 Sekunden brechen die meisten Server die Verbindung automatisch ab.<br />
<br />
:Standard: <code>2</code><br />
<br />
;*RecvWhitelist <Regex><br />
:Nur wenn die Jabber-ID einer privaten empfangenen Nachricht auf diese Regex zutrifft, akzeptiert FHEM die Nachricht und gibt sie an Notifys weiter. Alles andere wird verworfen.<br />
<br />
:Standard: <code>.*</code><br />
<br />
:Beispiele:<br />
:*<code>myname@jabber.org</code><br />
:*<code>(myname1@jabber.org|myname2@xmpp.de)</code><br />
<br />
;*MucJoin<br />
:Tritt dem MUC mit dem spezifizierten Nickname und dem optionalem Passwort bei.<br />
<br />
:Standard: nicht definiert<br />
<br />
:Beispiele:<br />
:*Einen Raum betreten: <code>channel1@server.com/mynick</code><br />
:*Mehrere Räume betreten: <code>channel1@server.com/mynick,channel2@server.com/myothernick</code><br />
:*Einen Raum mit Passwort betreten: <code>channel1@server.com/mynick:password</code><br />
<br />
;*MucRecvWhitelist <Regex><br />
:Selbe funktion wie RecvWhitelist, aber für Gruppenräume: Nur wenn die Regex zutrifft, wird die Nachricht verarbeitet. Alles andere wird ignoriert.<br />
<br />
:Standard: nicht definiert (keine Nachricht wird akzeptiert)<br />
<br />
:Beispiele:<br />
:*Alle Nachrichten aller betretenen Räume erlauben: <code>.*</code><br />
:*Alle Nachrichten bestimmter betretenen Räume erlauben: <code>mychannel@jabber.org</code><br />
:*Nur bestimmte User in bestimmten betretenen Räumen erlauben: <code>mychannel@jabber.org/NickOfFriend</code><br />
<br />
;*OTREnable 1|0<br />
:Schaltet die Verschlüsselungsfunktionen von Crypt::OTR für sichere Ende-zu-Ende Kummunikation in FHEM an oder aus.<br />
:Es muss zwangsläufig dafür Crypt::OTR installiert sein.<br />
:Ein Privater Schlüssel wird bei Erstbenutzung generiert, das kann mehr als 2 Stunden dauern! Dafür ist das eine einmalige Sache und FHEM wird dadurch nicht blockiert. Im Device sieht man im OTR_STATE wenn der Private Schlüssel fertig ist. Erst danach ist OTR aktiv.<br />
<br />
:Standard: nicht definiert (OTR deaktiviert)<br />
<br />
;*OTRSharedSecret aSecretKeyiOnlyKnow@@*<br />
:Optionales geheimes Passwort, dass man vom Endgerät an FHEM schicken kann um zu beweisen, dass es sich tatsächlich um FHEM handelt und nicht um einen Hacker der sich (z.b. bei dem Internetprovider) zwischengeschaltet hat. Normalerweise bekommt das Endgerät eine Warnung wenn sich an einer bereits verifizierten Verbindung etwas geändert hat.<br />
:Diese Warnung sollte man dann sehr ernst nehmen.<br />
<br />
:Standard: nicht definiert, setze hier dein geheimes Passwort.<br />
<br />
<br />
===Generierte Readings/Events===<br />
<br />
*Privat Nachrichten<br />
**Message - Komplette Nachricht inkl. JID und Text<br />
**LastMessage - Nur der Textteil der Nachricht<br />
**LastSenderJID - Nur die Sender-JID der Nachricht<br />
<br />
*Verschlüsselte Private Nachrichten (wenn OTREnable=1)<br />
**OTRMessage - Komplette entschlüsselte Nachricht inkl. JID und Text<br />
**OTRLastMessage - Nur der Textteil der Nachricht<br />
**OTRLastSenderJID - Nur die Sender-JID der Nachricht<br />
<br />
*MUC Raum Nachrichten (wenn MUCJoin gesetzt ist)<br />
**MucMessage - Komplette Nachricht (Raumname/Nickname und Text)<br />
**MucLastMessage - Nur der Textteil der Nachricht<br />
**MucLastSenderJID - Nur die Sender-JID der Nachricht<br />
--><br />
<br />
==Installation==<br />
Auf aktuellen Systemen gibt es leider Probleme mit den verwendeten XMPP Perl Modulen.<br />
<br />
Im speziellen benötigt man zwingend die folgende Perl-Modul Kombination, damit das Jabber Modul richtig funktionieren kann:<br />
*XML::Stream 1.23<br />
*Net::XMPP 1.02<br />
<br />
<br />
Wenn man OTR benutzen möchte sollte zusätzlich noch das Perl Modul Crypt::OTR installiert sein.<br />
<br />
Auf einem frisch installieren Ubuntu 16.04.02 LTS bedeutet das folgende Kommandos:<br />
<source lang="bash"><br />
apt-get remove libnet-xmpp-perl<br />
apt-get remove libxml-stream-perl<br />
apt-get remove libotr5 libotr5-dev<br />
<br />
apt-get install build-essential<br />
apt-get install libnet-jabber-perl<br />
wget http://ftp.de.debian.org/debian/pool/main/libn/libnet-xmpp-perl/libnet-xmpp-perl_1.02-3_all.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libx/libxml-stream-perl/libxml-stream-perl_1.23-2_all.deb<br />
dpkg -i libxml-stream-perl_1.23-2_all.deb<br />
dpkg -i libnet-xmpp-perl_1.02-3_all.deb<br />
</source><br />
<br />
Für OTR ist noch folgendes notwendig (64bit Intel Platform):<br />
<source lang="bash"><br />
cpan install Digest::SHA1<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-dev_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-bin_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libg/libgcrypt11/libgcrypt11_1.5.0-5+deb7u4_amd64.deb<br />
dpkg -i libgcrypt11_1.5.0-5+deb7u4_amd64.deb<br />
dpkg -i libotr2_3.2.1-1+deb7u2_amd64.deb<br />
dpkg -i libotr2-bin_3.2.1-1+deb7u2_amd64.deb<br />
dpkg -i libotr2-dev_3.2.1-1+deb7u2_amd64.deb<br />
<br />
cpan<br />
cpan> notest install Crypt::OTR<br />
</source><br />
<br />
OTR bei 32 bit (Intel Platform):<br />
<source lang="bash"><br />
cpan install Digest::SHA1<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-dev_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-bin_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libg/libgcrypt11/libgcrypt11_1.5.0-5+deb7u4_i386.deb<br />
dpkg -i libgcrypt11_1.5.0-5+deb7u4_i386.deb<br />
dpkg -i libotr2_3.2.1-1+deb7u2_i386.deb<br />
dpkg -i libotr2-bin_3.2.1-1+deb7u2_i386.deb<br />
dpkg -i libotr2-dev_3.2.1-1+deb7u2_i386.deb<br />
<br />
cpan<br />
cpan> notest install Crypt::OTR<br />
</source><br />
<br />
Wer keine Stunden auf die Keygenerierung warten will, kann noch das Programm "haveged" installieren, das kümmert sich um die entrophy generation, die OTR dringend braucht für seinen Privaten Schlüssel:<br />
* haveged<br />
<source lang="bash"><br />
apt-get install haveged<br />
</source><br />
<br />
==Beispiele==<br />
Mit folgendem [[Notify]]-Beispiel kannst du auf eingehende Nachrichten reagieren, dieses Beispiel schickt das Reading "Temperatur" des Sensors "BU_Temperatur" bei jeder ankommenden Nachricht an den Sender zurück:<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:Message.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msg ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
<br />
Auf MUC Nachrichten lässt sich folgend reagieren, Augenmerk darauf legen dass der Nickname aus $lastsender in der msgmuc Funktion entfernt wird, damit die Nachricht an den Raum geht<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:MucMessage.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msgmuc ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
<br />
Auf OTR Nachrichten wird reagiert, wie auf normale private Nachrichten auch, jedoch wird mit der msgotr Funktion geantwortet:<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:OTRMessage.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msgotr ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
==Weitere Beispiele und HowTos im Wiki==<br />
*[[FHEM_spricht_jabber]]<br />
*[[Prosody|Installieren eines eigenen XMPP-Servers]]<br />
<br />
==Weblinks==<br />
*[https://de.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol XMPP]<br />
*[https://jabber.org jabber.org]<br />
*[https://prosody.im/ Prosody Jabber Server]<br />
*[https://pidgin.im/ pidgin Jabber Client]</div>BioShttp://wiki.fhem.de/w/index.php?title=Jabber&diff=21663Jabber2017-06-03T20:04:23Z<p>BioS: Installationsinfos zu neueren Linux Systemen hinzugefügt</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=Dieses Modul ermöglicht FHEM, sich mit dem Jabber-Netzwerk zu verbinden, um Nachrichten zu einem Jabber-Server zu senden oder von diesem zu empfangen.<br />
|ModType=d<br />
|ModCmdRef= <br />
|ModForumArea=Unterstuetzende Dienste<br />
|ModFTopic=18967<br />
|ModTechName=70_Jabber.pm<br />
|ModOwner=BioS ({{Link2FU|2021|Forum}})<br />
}}<br />
[[Jabber]] ist eine andere Beschreibung für "XMPP", ein Kommunikationsprotokoll für Nachrichtenorientierte "middleware", basierend auf XML.<br />
Fester bestandteil des Protokolls ist die Verschlüsselung zwischen Client und Server.<br />
Für den Benutzer ist es ähnlich anderer Chat-Plattformen wie zum Beispiel dem facebook Chat, ICQ oder Google Hangouts - jedoch frei Verfügbar, open Source und normalerweise Verschlüsselt (was Serverabhängig ist).<br />
<br />
Seit Version 1.5 kann dieses Modul in Multi-User-Channel (sogenannte MUC) beitreten und Off-the-Record (OTR) Ende-zu-Ende Verschlüsselung benutzen.<br />
OTR ist nochmal ein zusätzlicher Sicherheitsrelevater Punkt, da die Kommunikation wirklich von Endgerät zu FHEM verschlüsselt wird und man sich nicht auf die Jabber Server Transportverschlüsselung verlassen muss.<br />
<br />
<!--<br />
==Voraussetzungen==<br />
Für dieses Modul brauchst du einen Account auf einem Jabber Server. Kostenlose Accounts und Server findet man unter [https://jabber.org jabber.org]<br />
<br />
Auf dem FHEM-Server müssen folgende Perl-Module installiert sein:<br />
*Net::Jabber<br />
*Net::XMPP<br />
*Authen::SASL<br />
*XML::Stream<br />
*Net::SSLeay<br />
*Crypt::OTR (wenn OTR verwendet werden soll)<br />
<br />
==Definition==<br />
===define===<br />
<br />
;*define <name> Jabber <server> <port> <username> <password> <TLS> <SSL><br />
:Du benötigst natürlich echte Accountdaten.<br />
<br />
;Beispiel:<br />
<source lang="perl">define JabberClient1 Jabber jabber.org 5222 myusername mypassword 1 0</source><br />
<br />
<br />
===set===<br />
<br />
;*set <name> msg <username> <msg><br />
:Sendet eine Nachricht '''''msg''''' an den Jabberuser '''''username'''''<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msg myname@jabber.org It is working!</source><br />
<br />
<br />
;*set <name> msgmuc <channel> <msg><br />
:Sendet eine Nachricht '''''msg''''' an dieJabber-MUC-Gruppe '''''channel'''''<br />
:Dabei wird ein eventuell mitgegebener Nickname von "channel" entfernt, so kann man direkt das Reading LastMessageJID benutzen.<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msgmuc roomname@jabber.org Woot!</source><br />
<br />
<br />
;*set <name> msgotr <username> <msg><br />
:Sendet eine OTR verschlüsselte Nachricht an den '''''username'''''. Wenn keine aktive OTR Sitzung aufgebaut ist, wird versucht eine aufzubauen.<br />
:Wenn der Empfänger OTR nicht versteht, wird die Nachricht verworfen, d.h. sie wird auf keinen Fall im Klartext übertragen.<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 msgotr myname@jabber.org Wir sehen uns heute um 18:00 Uhr :*</source><br />
<br />
<br />
;*set <name> subscribe <username><br />
:Frägt eine Authorisierung beim '''''username''''' an (normalerweise wird das nicht benötigt)<br />
<br />
Beispiel:<br />
<source lang="perl">set JabberClient1 subscribe myname@jabber.org</source><br />
<br />
<br />
===Attribute===<br />
<br />
;*OnlineStatus available|unavailable<br />
:Setzt den Online-status, ob der Client anderen gegenüber Online ist (available) oder Offline erscheint (unavailable)<br />
:Es ist möglich dass einige Server eingehende Nachrichten trotzdem FHEM zustellen obwohl er "unavailable" ist<br />
<br />
:Standard: <code>available</code><br />
<br />
;*ResourceName <name><br />
:In der Jabber-Welt kann ein Client mit einem Usernamen öfter mit einem Server verbunden sein (z.b. Handy, Computer, FHEM).<br />
:Der '''resource name''' ergibt die finale Jabber-ID und macht die verschiedenen Verbindungen einzigartig (z.B. bios@jabber.org/FHEM).<br />
:Hier kannst du den '''resource name''' setzen.<br />
<br />
:Standard: <code>FHEM</code><br />
<br />
;*PollTimer <''seconds''><br />
:Dies ist der Intervall in der überprüft wird ob neue Nachrichten zur Verarbeitung beim Jabber Server anstehen.<br />
:Ebenfalls wird hiermit die Verbindung zum Server überprüft (Timeouts, DSL Disconnects etc.).<br />
:Setze es nicht über 10 Sekunden, die Verbindung kann sonst die ganze Zeit getrennt werden, Sie wird zwar wieder aufgebaut, aber nach 10 Sekunden brechen die meisten Server die Verbindung automatisch ab.<br />
<br />
:Standard: <code>2</code><br />
<br />
;*RecvWhitelist <Regex><br />
:Nur wenn die Jabber-ID einer privaten empfangenen Nachricht auf diese Regex zutrifft, akzeptiert FHEM die Nachricht und gibt sie an Notifys weiter. Alles andere wird verworfen.<br />
<br />
:Standard: <code>.*</code><br />
<br />
:Beispiele:<br />
:*<code>myname@jabber.org</code><br />
:*<code>(myname1@jabber.org|myname2@xmpp.de)</code><br />
<br />
;*MucJoin<br />
:Tritt dem MUC mit dem spezifizierten Nickname und dem optionalem Passwort bei.<br />
<br />
:Standard: nicht definiert<br />
<br />
:Beispiele:<br />
:*Einen Raum betreten: <code>channel1@server.com/mynick</code><br />
:*Mehrere Räume betreten: <code>channel1@server.com/mynick,channel2@server.com/myothernick</code><br />
:*Einen Raum mit Passwort betreten: <code>channel1@server.com/mynick:password</code><br />
<br />
;*MucRecvWhitelist <Regex><br />
:Selbe funktion wie RecvWhitelist, aber für Gruppenräume: Nur wenn die Regex zutrifft, wird die Nachricht verarbeitet. Alles andere wird ignoriert.<br />
<br />
:Standard: nicht definiert (keine Nachricht wird akzeptiert)<br />
<br />
:Beispiele:<br />
:*Alle Nachrichten aller betretenen Räume erlauben: <code>.*</code><br />
:*Alle Nachrichten bestimmter betretenen Räume erlauben: <code>mychannel@jabber.org</code><br />
:*Nur bestimmte User in bestimmten betretenen Räumen erlauben: <code>mychannel@jabber.org/NickOfFriend</code><br />
<br />
;*OTREnable 1|0<br />
:Schaltet die Verschlüsselungsfunktionen von Crypt::OTR für sichere Ende-zu-Ende Kummunikation in FHEM an oder aus.<br />
:Es muss zwangsläufig dafür Crypt::OTR installiert sein.<br />
:Ein Privater Schlüssel wird bei Erstbenutzung generiert, das kann mehr als 2 Stunden dauern! Dafür ist das eine einmalige Sache und FHEM wird dadurch nicht blockiert. Im Device sieht man im OTR_STATE wenn der Private Schlüssel fertig ist. Erst danach ist OTR aktiv.<br />
<br />
:Standard: nicht definiert (OTR deaktiviert)<br />
<br />
;*OTRSharedSecret aSecretKeyiOnlyKnow@@*<br />
:Optionales geheimes Passwort, dass man vom Endgerät an FHEM schicken kann um zu beweisen, dass es sich tatsächlich um FHEM handelt und nicht um einen Hacker der sich (z.b. bei dem Internetprovider) zwischengeschaltet hat. Normalerweise bekommt das Endgerät eine Warnung wenn sich an einer bereits verifizierten Verbindung etwas geändert hat.<br />
:Diese Warnung sollte man dann sehr ernst nehmen.<br />
<br />
:Standard: nicht definiert, setze hier dein geheimes Passwort.<br />
<br />
<br />
===Generierte Readings/Events===<br />
<br />
*Privat Nachrichten<br />
**Message - Komplette Nachricht inkl. JID und Text<br />
**LastMessage - Nur der Textteil der Nachricht<br />
**LastSenderJID - Nur die Sender-JID der Nachricht<br />
<br />
*Verschlüsselte Private Nachrichten (wenn OTREnable=1)<br />
**OTRMessage - Komplette entschlüsselte Nachricht inkl. JID und Text<br />
**OTRLastMessage - Nur der Textteil der Nachricht<br />
**OTRLastSenderJID - Nur die Sender-JID der Nachricht<br />
<br />
*MUC Raum Nachrichten (wenn MUCJoin gesetzt ist)<br />
**MucMessage - Komplette Nachricht (Raumname/Nickname und Text)<br />
**MucLastMessage - Nur der Textteil der Nachricht<br />
**MucLastSenderJID - Nur die Sender-JID der Nachricht<br />
--><br />
<br />
==Installation==<br />
Auf aktuellen Systemen gibt es leider Probleme mit den verwendeten XMPP Perl Modulen.<br />
<br />
Im speziellen benötigt man zwingend die folgende Perl-Modul Kombination, damit das Jabber Modul richtig funktionieren kann:<br />
*XML::Stream 1.23<br />
*Net::XMPP 1.02<br />
<br />
<br />
Wenn man OTR benutzen möchte sollte zusätzlich noch das Perl Modul Crypt::OTR installiert sein.<br />
<br />
Auf einem frisch installieren Ubuntu 16.04.02 LTS bedeutet das folgende Kommandos:<br />
<source lang="bash"><br />
apt-get remove libnet-xmpp-perl<br />
apt-get remove libxml-stream-perl<br />
apt-get remove libotr5 libotr5-dev<br />
<br />
apt-get install build-essential<br />
apt-get install libnet-jabber-perl<br />
wget http://ftp.de.debian.org/debian/pool/main/libn/libnet-xmpp-perl/libnet-xmpp-perl_1.02-3_all.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libx/libxml-stream-perl/libxml-stream-perl_1.23-2_all.deb<br />
dpkg -i libxml-stream-perl_1.23-2_all.deb<br />
dpkg -i libnet-xmpp-perl_1.02-3_all.deb<br />
</source><br />
<br />
Für OTR ist noch folgendes notwendig (64bit Intel Platform):<br />
<source lang="bash"><br />
cpan install Digest::SHA1<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-dev_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-bin_3.2.1-1+deb7u2_amd64.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libg/libgcrypt11/libgcrypt11_1.5.0-5+deb7u4_amd64.deb<br />
dpkg -i libgcrypt11_1.5.0-5+deb7u4_amd64.deb<br />
dpkg -i libotr2_3.2.1-1+deb7u2_amd64.deb<br />
dpkg -i libotr2-bin_3.2.1-1+deb7u2_amd64.deb<br />
dpkg -i libotr2-dev_3.2.1-1+deb7u2_amd64.deb<br />
<br />
cpan<br />
cpan> notest install Crypt::OTR<br />
</source><br />
<br />
OTR bei 32 bit (Intel Platform):<br />
<source lang="bash"><br />
cpan install Digest::SHA1<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-dev_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libo/libotr/libotr2-bin_3.2.1-1+deb7u2_i386.deb<br />
wget http://ftp.de.debian.org/debian/pool/main/libg/libgcrypt11/libgcrypt11_1.5.0-5+deb7u4_i386.deb<br />
dpkg -i libgcrypt11_1.5.0-5+deb7u4_i386.deb<br />
dpkg -i libotr2_3.2.1-1+deb7u2_i386.deb<br />
dpkg -i libotr2-bin_3.2.1-1+deb7u2_i386.deb<br />
dpkg -i libotr2-dev_3.2.1-1+deb7u2_i386.deb<br />
<br />
cpan<br />
cpan> notest install Crypt::OTR<br />
</source><br />
<br />
<br />
<br />
==Beispiele==<br />
Mit folgendem [[Notify]]-Beispiel kannst du auf eingehende Nachrichten reagieren, dieses Beispiel schickt das Reading "Temperatur" des Sensors "BU_Temperatur" bei jeder ankommenden Nachricht an den Sender zurück:<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:Message.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msg ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
<br />
Auf MUC Nachrichten lässt sich folgend reagieren, Augenmerk darauf legen dass der Nickname aus $lastsender in der msgmuc Funktion entfernt wird, damit die Nachricht an den Raum geht<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:MucMessage.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msgmuc ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
<br />
Auf OTR Nachrichten wird reagiert, wie auf normale private Nachrichten auch, jedoch wird mit der msgotr Funktion geantwortet:<br />
<br />
<source lang="perl"><br />
define Jabber_Notify notify JabberClient1:OTRMessage.* {<br />
my $lastsender=ReadingsVal("JabberClient1","LastSenderJID","0");<br />
my $lastmsg=ReadingsVal("JabberClient1","LastMessage","0");<br />
my $temperature=ReadingsVal("BU_Temperatur","temperature","0");<br />
fhem("set JabberClient1 msgotr ". $lastsender . " Temp: ".$temperature);<br />
}<br />
</source><br />
<br />
==Weitere Beispiele und HowTos im Wiki==<br />
*[[FHEM_spricht_jabber]]<br />
*[[Prosody|Installieren eines eigenen XMPP-Servers]]<br />
<br />
==Weblinks==<br />
*[https://de.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol XMPP]<br />
*[https://jabber.org jabber.org]<br />
*[https://prosody.im/ Prosody Jabber Server]<br />
*[https://pidgin.im/ pidgin Jabber Client]</div>BioS