Jabber:Server - Versionsgeschichte

Langweiler: /* Installation und Grundkonfiguration */

2015-04-10T19:24:16Z

Installation und Grundkonfiguration

← Nächstältere Version		Version vom 10. April 2015, 19:24 Uhr
Zeile 49:		Zeile 49:

	{domain_certfile, "<domain>", "/etc/ejabberd/<domain.pem>"}.		{domain_certfile, "<domain>", "/etc/ejabberd/<domain.pem>"}.

			Passwörter werden in der Standardeinstellung im Klartext abgespeichert und können so von den Administratoren abgefragt und im schlimmsten Fall von Angreifern entwendet werden. Um dies zu verhindern, aktivieren wir das SCRAM-Authentifizierungsverfahren:

			{auth_password_format, scram}.

	Benutzern soll es prinzipiell erlaubt sein, sich selbst mittels ihrer Klienten zu registrieren:		Benutzern soll es prinzipiell erlaubt sein, sich selbst mittels ihrer Klienten zu registrieren:

Langweiler: /* Installation und Grundkonfiguration */

2015-04-07T21:17:56Z

Installation und Grundkonfiguration

← Nächstältere Version		Version vom 7. April 2015, 21:17 Uhr
Zeile 46:		Zeile 46:
	]}		]}

	Falls wir ein eigenes TLS/SSL-Zertifikat für die Domain <domain> erstellt haben, konfigurieren wir dieses mit der folgenden zusätzlichen Zeile. Die PEM-Datei "<domain.pem>" enthält hierbei zuerst den privaten Schlüssel, gefolgt von dem eigentlichen Zertifikat. Bei der Installation ist darauf zu achten, dass die Datei root.ejabberd gehört und nicht für andere lesbar ist:		Falls wir ein eigenes TLS/SSL-Zertifikat für die Domain <domain> erstellt haben, konfigurieren wir dieses mit der folgenden zusätzlichen Zeile. Die PEM-Datei "<domain.pem>" enthält hierbei zuerst den privaten Schlüssel, gefolgt von dem eigentlichen Zertifikat. Bei der Installation ist darauf zu achten, dass die Datei ''root.ejabberd'' gehört und nicht für andere lesbar ist:

	{domain_certfile, "<domain>", "/etc/ejabberd/<domain.pem>"}.		{domain_certfile, "<domain>", "/etc/ejabberd/<domain.pem>"}.

Langweiler: /* Installation und Grundkonfiguration */

2015-04-07T21:17:28Z

Installation und Grundkonfiguration

← Nächstältere Version		Version vom 7. April 2015, 21:17 Uhr
Zeile 46:		Zeile 46:
	]}		]}

	~~Fall~~ wir ein eigenes TLS/SSL-Zertifikat für die Domain <domain> erstellt haben, konfigurieren wir dieses mit der folgenden zusätzlichen Zeile. Die PEM-Datei "<domain.pem>" enthält hierbei zuerst den privaten Schlüssel, gefolgt von dem eigentlichen Zertifikat. Bei der Installation ist darauf zu achten, dass die Datei root.ejabberd gehört und nicht für andere lesbar ist:		Falls wir ein eigenes TLS/SSL-Zertifikat für die Domain <domain> erstellt haben, konfigurieren wir dieses mit der folgenden zusätzlichen Zeile. Die PEM-Datei "<domain.pem>" enthält hierbei zuerst den privaten Schlüssel, gefolgt von dem eigentlichen Zertifikat. Bei der Installation ist darauf zu achten, dass die Datei root.ejabberd gehört und nicht für andere lesbar ist:

	{domain_certfile, "<domain>", "/etc/ejabberd/<domain.pem>"}.		{domain_certfile, "<domain>", "/etc/ejabberd/<domain.pem>"}.

Langweiler: /* Installation und Grundkonfiguration */

2015-04-07T21:17:12Z

Installation und Grundkonfiguration

← Nächstältere Version		Version vom 7. April 2015, 21:17 Uhr
Zeile 46:		Zeile 46:
	]}		]}

	Fall wir ein eigenes TLS/SSL-Zertifikat für die Domain <domain> erstellt haben, konfigurieren wir dieses mit der folgenden zusätzlichen Zeile. Die PEM-Datei "<domain>.pem" enthält hierbei zuerst den privaten Schlüssel, gefolgt von dem eigentlichen Zertifikat. Bei der Installation ist darauf zu achten, dass die Datei root.ejabberd gehört und nicht für andere lesbar ist:		Fall wir ein eigenes TLS/SSL-Zertifikat für die Domain <domain> erstellt haben, konfigurieren wir dieses mit der folgenden zusätzlichen Zeile. Die PEM-Datei "<domain.pem>" enthält hierbei zuerst den privaten Schlüssel, gefolgt von dem eigentlichen Zertifikat. Bei der Installation ist darauf zu achten, dass die Datei root.ejabberd gehört und nicht für andere lesbar ist:

	{domain_certfile, "<domain>", "/etc/ejabberd/<domain>.pem"}.		{domain_certfile, "<domain>", "/etc/ejabberd/<domain.pem>"}.

	Benutzern soll es prinzipiell erlaubt sein, sich selbst mittels ihrer Klienten zu registrieren:		Benutzern soll es prinzipiell erlaubt sein, sich selbst mittels ihrer Klienten zu registrieren:

Langweiler: /* Clustering */

2015-04-07T21:15:36Z

Clustering

← Nächstältere Version		Version vom 7. April 2015, 21:15 Uhr
Zeile 230:		Zeile 230:
	[[Datei:Ejabberd database.png]]		[[Datei:Ejabberd database.png]]

	Um den Cluster als solchen zu ~~nutzen~~ fehlt nur noch ein Round-Robin DNS-Eintrag für die gemeinsame Domain <joint_domain>, welcher auf ~~die beide~~ Knoten verweist ~~mittels ihrer IP~~-~~Adressen verweist~~.		Um den Cluster auch als solchen nutzen zu können, fehlt nur noch ein Round-Robin DNS-Eintrag für die gemeinsame Domain <joint_domain>, welcher auf alle Knoten verweist. Alternativ kann ein TCP-Proxy auf einem zentralen Router/Gateway installiert werden. Als dritte Möglichkeit können sich die Klienten explizit mit einem der Knoten über den entsprechenden Hostnamen verbinden ("Connection Host").

	= Datenbank zurücksetzen =		= Datenbank zurücksetzen =

Langweiler: /* Clustering */

2015-04-07T21:12:59Z

Clustering

← Nächstältere Version		Version vom 7. April 2015, 21:12 Uhr
Zeile 226:		Zeile 226:
	[[Datei:Ejabberd_nodes.png]]		[[Datei:Ejabberd_nodes.png]]

	Als letzte Tat wählen wir noch den Untermenü-Punkt ''Database'' für unseren neu installierten Knoten unter dem Hauptmenü-Punkt ''Nodes''. Standardmäßig werden die gemeinsamen Tabellen lediglich als "Remote Copy" vorgehalten und damit über das Netzwerk abgefragt. Um die Daten auch lokal und damit redundant zu sichern, passen wir den "Storage Type" den Einstellungen des primär installierten Knotens an. Eine Übersicht gibt das nachfolgende Bildschirmfoto:		Als letzte Tat wählen wir noch den Untermenü-Punkt ''Database'' für unseren neu installierten Knoten unter dem Hauptmenü-Punkt ''Nodes''. Standardmäßig werden die gemeinsamen Tabellen auf dem neuen Knoten lediglich als "Remote Copy" vorgehalten und damit über das Netzwerk abgefragt. Um die Daten auch lokal und damit redundant zu sichern, passen wir den "Storage Type" den Einstellungen des primär installierten Knotens an. Eine Übersicht gibt das nachfolgende Bildschirmfoto:

	[[Datei:Ejabberd database.png]]		[[Datei:Ejabberd database.png]]

Langweiler: /* Clustering */

2015-04-07T21:11:17Z

Clustering

← Nächstältere Version		Version vom 7. April 2015, 21:11 Uhr
Zeile 224:		Zeile 224:
	Ob wir erfolgreich waren, können wir bequem über die Web-Oberfläche von ''ejabberd'' abfragen. Hierzu öffnen wir den Link ''<nowiki>http://<domain>:5280/admin/</nowiki>'' und authentifizieren uns als Administrator. Unter dem Menü-Punkt ''Nodes'' sollten ab sofort zwei Knoten ähnlich dem folgenden Bildschirmfoto dargestellt werden:		Ob wir erfolgreich waren, können wir bequem über die Web-Oberfläche von ''ejabberd'' abfragen. Hierzu öffnen wir den Link ''<nowiki>http://<domain>:5280/admin/</nowiki>'' und authentifizieren uns als Administrator. Unter dem Menü-Punkt ''Nodes'' sollten ab sofort zwei Knoten ähnlich dem folgenden Bildschirmfoto dargestellt werden:

	[[~~File~~:Ejabberd_nodes.png]]		[[Datei:Ejabberd_nodes.png]]

			Als letzte Tat wählen wir noch den Untermenü-Punkt ''Database'' für unseren neu installierten Knoten unter dem Hauptmenü-Punkt ''Nodes''. Standardmäßig werden die gemeinsamen Tabellen lediglich als "Remote Copy" vorgehalten und damit über das Netzwerk abgefragt. Um die Daten auch lokal und damit redundant zu sichern, passen wir den "Storage Type" den Einstellungen des primär installierten Knotens an. Eine Übersicht gibt das nachfolgende Bildschirmfoto:

			[[Datei:Ejabberd database.png]]

	Um den Cluster als solchen zu nutzen fehlt nur noch ein Round-Robin DNS-Eintrag für die gemeinsame Domain <joint_domain>, welcher auf die beide Knoten verweist mittels ihrer IP-Adressen verweist.		Um den Cluster als solchen zu nutzen fehlt nur noch ein Round-Robin DNS-Eintrag für die gemeinsame Domain <joint_domain>, welcher auf die beide Knoten verweist mittels ihrer IP-Adressen verweist.

Langweiler: /* Installation und Grundkonfiguration */

2015-04-07T20:57:49Z

Installation und Grundkonfiguration

← Nächstältere Version		Version vom 7. April 2015, 20:57 Uhr
Zeile 45:		Zeile 45:
	register		register
	]}		]}

			Fall wir ein eigenes TLS/SSL-Zertifikat für die Domain <domain> erstellt haben, konfigurieren wir dieses mit der folgenden zusätzlichen Zeile. Die PEM-Datei "<domain>.pem" enthält hierbei zuerst den privaten Schlüssel, gefolgt von dem eigentlichen Zertifikat. Bei der Installation ist darauf zu achten, dass die Datei root.ejabberd gehört und nicht für andere lesbar ist:

			{domain_certfile, "<domain>", "/etc/ejabberd/<domain>.pem"}.

	Benutzern soll es prinzipiell erlaubt sein, sich selbst mittels ihrer Klienten zu registrieren:		Benutzern soll es prinzipiell erlaubt sein, sich selbst mittels ihrer Klienten zu registrieren:

Langweiler: /* Proxy zur Weiterleitung der Web-Oberfläche */

2015-04-04T18:56:21Z

Proxy zur Weiterleitung der Web-Oberfläche

← Nächstältere Version		Version vom 4. April 2015, 18:56 Uhr
Zeile 340:		Zeile 340:
	<nowiki>ProxyPass / https://<jabber_node>:5280/</nowiki>		<nowiki>ProxyPass / https://<jabber_node>:5280/</nowiki>
	<nowiki>ProxyPassReverse / https://<jabber_node>:5280/</nowiki>		<nowiki>ProxyPassReverse / https://<jabber_node>:5280/</nowiki>

	SetOutputFilter proxy-html		SetOutputFilter proxy-html
	<nowiki>ProxyHTMLURLMap https://<jabber_node>:5280 https://<jabber_domain></nowiki>		<nowiki>ProxyHTMLURLMap https://<jabber_node>:5280 https://<jabber_domain></nowiki>
	RequestHeader unset Accept-Encoding		RequestHeader unset Accept-Encoding
	</VirtualHost>		</VirtualHost>

Langweiler: /* Proxy zur Weiterleitung der Web-Oberfläche */

2015-04-04T18:56:04Z

Proxy zur Weiterleitung der Web-Oberfläche

← Nächstältere Version		Version vom 4. April 2015, 18:56 Uhr
Zeile 295:		Zeile 295:
	Ab sofort sollten auf dem Gateway eingehende Klienten- und Serververbindungen auf die Knoten verteilt werden.		Ab sofort sollten auf dem Gateway eingehende Klienten- und Serververbindungen auf die Knoten verteilt werden.

	== Proxy zur Weiterleitung der Web-Oberfläche ==		=Proxy zur Weiterleitung der Web-Oberfläche=
	Der ''ejabberd'' bietet eine komfortable Web-Oberfläche zur Administration und Registrierung von Benutzern. Da die Knoten im Normalfall jedoch innerhalb des Freifunknetzes laufen, ist diese nicht aus dem Internet zu erreichen. Eine weitere Limitierung ist, dass das Modul zur Registrierung von Benutzern immer den Hostnamen des HTTP-Requests verwendet. Entsprechend macht es Sinn auf dem gleichen Gateway, auf welchem auch der HAProxy läuft, einen ''Reverse Proxy'' einzurichten. Da im Normalfall bereits ein Aapache2 Web-Server vorhanden ist, werden wir diesen für die Einrichtung des ''Reverse Proxy'' verwenden.		Der ''ejabberd'' bietet eine komfortable Web-Oberfläche zur Administration und Registrierung von Benutzern. Da die Knoten im Normalfall jedoch innerhalb des Freifunknetzes laufen, ist diese nicht aus dem Internet zu erreichen. Eine weitere Limitierung ist, dass das Modul zur Registrierung von Benutzern immer den Hostnamen des HTTP-Requests verwendet. Entsprechend macht es Sinn, auf dem gleichen Gateway, auf welchem auch der HAProxy läuft, einen ''Reverse Proxy'' einzurichten. Da im Normalfall bereits ein Aapache2 Web-Server vorhanden ist, werden wir diesen für die Einrichtung des ''Reverse Proxy'' verwenden.
	Zunächst ~~aktivieren~~ wir das Modul ''~~mod_rewrite~~'':		Zunächst installieren wir das optionale Modul ''proxy-html'':

	a2enmod rewrite		apt-get install libapache2-mod-proxy-html

			Danach aktivieren wir das Modul ''rewrite'' sowie die Module ''proxy'' und ''proxy-html'' für die Proxy-Funktion:

			a2enmod rewrite proxy proxy-html

	Falls SSL noch nicht aktiviert wurde, benötigen wir zusätzlich:		Falls SSL noch nicht aktiviert wurde, benötigen wir zusätzlich:
Zeile 306:		Zeile 310:
	a2ensite default-ssl		a2ensite default-ssl

	Danach legen wir eine neue Site ''ejabberd'' unter ''/etc/apache2/sites-available'' an. In dieser erstellen wir zwei ''VirtualHosts'' für die Jabber-Domain ''<jabber_domain>''. Der ''VirtualHost'' auf Port 80 hat lediglich den Zweck, Anfragen via HTTP auf HTTPS umzuschreiben. Der ''VirtualHost'' auf Port 443 übernimmt dann die eigentliche Aufgabe der Weiterleitung auf den Jabber-Knoten ''<jabber_node>''. Die Wahl des Knoten ist hierbei beliebig, da sich die Knoten in einem Cluster befinden. Die Platzhalter für das SSL-Zertifikat ''<myssl.cert>'' und den SSL-Schlüssel ''<myssl.key>'' sind den lokalen Gegebenheiten anzupassen:		Danach legen wir eine neue Site ''ejabberd'' unter ''/etc/apache2/sites-available'' an. In dieser erstellen wir zwei ''VirtualHosts'' für die Jabber-Domain ''<jabber_domain>''. Der ''VirtualHost'' auf Port 80 hat lediglich den Zweck, Anfragen via HTTP auf HTTPS umzuschreiben. Der ''VirtualHost'' auf Port 443 übernimmt dann die eigentliche Aufgabe der Weiterleitung auf den Jabber-Knoten ''<jabber_node>''. Die Wahl des Knoten ist hierbei beliebig, da sich die Knoten in einem Cluster befinden. Die Platzhalter für das SSL-Zertifikat ''<myssl.cert>'' und den SSL-Schlüssel ''<myssl.key>'' sind den lokalen Gegebenheiten anzupassen. Der letzte Abschnitt dient dazu, absolute URLs umzuschreiben. Dies ist notwendig, um auf das Captcha zuzugreifen:

	<VirtualHost *:80>		<VirtualHost *:80>
Zeile 336:		Zeile 340:
	<nowiki>ProxyPass / https://<jabber_node>:5280/</nowiki>		<nowiki>ProxyPass / https://<jabber_node>:5280/</nowiki>
	<nowiki>ProxyPassReverse / https://<jabber_node>:5280/</nowiki>		<nowiki>ProxyPassReverse / https://<jabber_node>:5280/</nowiki>

			SetOutputFilter proxy-html
			<nowiki>ProxyHTMLURLMap https://<jabber_node>:5280 https://<jabber_domain></nowiki>
			RequestHeader unset Accept-Encoding
	</VirtualHost>		</VirtualHost>