Sv translation

language	en

Remarque
This page is no longer being updated. From BlueMind 4.8, please refer to the new BlueMind documentation

Introduction

The XMPP server is built on a Tigase XMPP server. Most development add-ons are Tigase-related plugins to enable integration with the BlueMind solution.

Volet

borderWidth	3

On this page:

Sommaire

maxLevel	2

Related:

Installation

The bm-xmpp package allows you to install the BlueMind XMPP server comprehensively.

Integration with BlueMind services

The "bm-xmpp" package adds the functionalities below to BlueMind:

integrated authentication with bm-core
XMPP server for all domains monitored by BlueMind
support of vCard contact information and avatars from the data in the BlueMind address book
default user email addresses match their jabber ID

Service inter-dependencies

"bm-xmpp" depends on the following BlueMind services:

bm-locator to locate BlueMind services
bm-mq to keep the list of domains monitored by BlueMind up to date
bm-core for vCard authentication and generation
bm-elasticsearch for archiving and searching conversations

Enabling the instant messaging service

To enable the instant messaging service, connect to BlueMind as admin0 and:

go to System Management > Application's servers
select the server > "Server roles"
tick "Instant messaging indexing server"
click "Save"

Next go back to the admin console home page and:

go to System Management > Supervised domains
select the domain concerned
in the "BM Server" tab: assign the XMPP server
in the "Instant messaging" tab, define accesses
click "Save"

Finally, for users to be able to access the instant messaging service, they must be given the appropriate role for the application:

either via the user's management page > General tab
or via the group roles management page > Roles tab

To find out more about enabling this role, go to the dedicated page: Les roles : droits d acces et d administration

Changing SSL certificates

SSL certificates are generated automatically by bm-xmpp when a new domain is used. As self-signed certificates, they must be replaced by valid certificates.

To replace a domain's certificate, simply replace the appropriate files in /usr/share/bm-xmpp/certs/.

Connecting the XMPP server to the internet

By allowing the XMPP server to connect to the internet, the server is able to connect to other XMPP servers or to allow external users to connect to BlueMind's XMPP server. BlueMind users are then able to add non-BlueMind contacts to their instant messaging's contact list (displayed in the roaster).

Finding an externally-accessible DNS address

For example, if an XMPP server's DNS is "xmpp.mydomain.com", this DNS name must be resolved externally, from the internet, and not only internally.

Communication ports

The ports below must be accessible externally on the server "xmpp.mydomain.com" (see also Les services):

5222 from the client to the server for client-server communications
5223 from the client to the server for client-server SSL communications
5269, used for server-to-server communications

If "bm-xmpp" is not installed on the server whose DNS name is "xmpp.mydomain.com" (e.g. in the case of a proxy), these ports' data flows must be redirected to the server hosting "bm-xmpp".

Adding DNS SRV records

The DNS configuration of the domain "mydomain.com" must be edited to allow the external network to recognize "xmpp.mydomain.com" as the XMPP server for the domain "mydomain.com".

The following SRV records must be added:

Key

Example

Description

Pas de format

nopanel	true

_xmpp-client._tcp.DOMAIN.

Pas de format

nopanel	true

_xmpp-client._tcp.mydomain.com.  86400  IN  SRV  5 0 5222  xmpp.mydomain.com

Client-server communications

Pas de format

nopanel	true

_xmpp-server._tcp.DOMAIN.

Pas de format

nopanel	true

_xmpp-server._tcp.mydomain.com.  86400  IN  SRV  5 0 5269  xmpp.mydomain.com

Server-server communications

Checking DNS records

You can use the command-line tool "dig" to check DNS records. For example, to find out which server to use for the domain "gmail.com":

Pas de format

nopanel	true

root@prec:~# dig SRV _xmpp-client._tcp.gmail.com

; <<>> DiG 9.8.1-P1 <<>> SRV _xmpp-client._tcp.gmail.com
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 56538
;; flags: qr rd ra; QUERY: 1, ANSWER: 5, AUTHORITY: 0, ADDITIONAL: 10

;; QUESTION SECTION:
;_xmpp-client._tcp.gmail.com.	IN	SRV

;; ANSWER SECTION:
_xmpp-client._tcp.gmail.com. 5	IN	SRV	5 0 5222 xmpp.l.google.com.
_xmpp-client._tcp.gmail.com. 5	IN	SRV	20 0 5222 alt1.xmpp.l.google.com.
_xmpp-client._tcp.gmail.com. 5	IN	SRV	20 0 5222 alt2.xmpp.l.google.com.
_xmpp-client._tcp.gmail.com. 5	IN	SRV	20 0 5222 alt3.xmpp.l.google.com.
_xmpp-client._tcp.gmail.com. 5	IN	SRV	20 0 5222 alt4.xmpp.l.google.com.

;; ADDITIONAL SECTION:
xmpp.l.google.com.	5	IN	A	74.125.132.125
xmpp.l.google.com.	5	IN	AAAA	2a00:1450:400c:c06::7d
alt1.xmpp.l.google.com.	5	IN	A	173.194.70.125
alt1.xmpp.l.google.com.	5	IN	AAAA	2a00:1450:4001:c02::7d
alt2.xmpp.l.google.com.	5	IN	A	173.194.69.125
alt2.xmpp.l.google.com.	5	IN	AAAA	2a00:1450:4008:c01::7d
alt3.xmpp.l.google.com.	5	IN	A	74.125.135.125
alt3.xmpp.l.google.com.	5	IN	AAAA	2404:6800:4001:c01::7d
alt4.xmpp.l.google.com.	5	IN	A	74.125.128.125
alt4.xmpp.l.google.com.	5	IN	AAAA	2404:6800:4005:c00::7d

;; Query time: 572 msec
;; SERVER: 172.16.45.2#53(172.16.45.2)
;; WHEN: Tue Sep  3 01:28:26 2013
;; MSG SIZE  rcvd: 470

Sv translation

language	de

Remarque
Diese Seite ist nicht mehr aktuell. Ab der Version BlueMind 4.8 finden Sie alle Infos in der neuen Dokumentation

Präsentation

Der XMPP-Server ist um den Tigase XMPP-Server herum aufgebaut. Die meisten der eingebrachten Entwicklungen sind Plugins rund um Tigase, um ihn mit der BlueMind-Lösung zu integrieren.

Volet

borderWidth	3

Auf dieser Seite:

Sommaire

maxLevel	2

Verwandt:

Installation

Das Paket bm-xmpp ermöglicht die vollständige Installation des BlueMind XMPP-Servers.

Integration mit BlueMind-Diensten

Die folgenden Funktionen werden durch das Paket bm-xmpp zu BlueMind hinzugefügt:

Integrierte Authentifizierung mit bm-core
XMPP-Server für alle von BlueMind überwachten Domains
Unterstützung von Kontaktinformationen durch vCard und Avatare aus BlueMind-Adressbuchdaten
die Standard-E-Mail-Adresse der Benutzer stimmt mit ihren Jabber-Anmeldedaten überein

Abhängigkeiten zwischen Diensten

bm-xmpp hängt von den folgenden BlueMind-Diensten ab:

bm-locator zum Auffinden der verschiedenen BlueMind-Dienste
bm-mq, um eine aktuelle Liste der von BlueMind überwachten Domains zu führen
bm-core für Authentifizierung und vCard-Generierung
bm-elasticsearch zum Archivieren und Abrufen von Konversationen

Aktivieren von Instant Messaging

Um den Instant-Messaging-Dienst zu aktivieren, melden Sie sich bei BlueMind als admin0 an und:

gehen Sie zu Systemadministration > Application Servers
wählen Sie den Server > Registerkarte "Server-Rollen"
aktivieren Sie "Indizierungsserver für Instant Messaging und XMPP-Server"
klicken Sie auf "Speichern"

Kehren Sie dann zur Startseite der Administrationskonsole zurück:

gehen Sie zu Systemadministration > Überwachte Domains
wählen Sie den entsprechenden Bereich
in der Registerkarte "BM Service": den XMPP-Server zuweisen
in der Registerkarte Instant Messaging: die Zugänge definieren
klicken Sie auf "Speichern"

Damit Benutzer Zugriff auf Instant Messaging haben, muss ihnen die der Anwendung entsprechende Rolle zugewiesen werden:

entweder über die Verwaltung des Benutzerstammsatzes > Registerkarte Allgemein
oder über die Gruppenrollenverwaltung > Registerkarte Rollen

Weitere Informationen über die Aktivierung dieser Rolle finden Sie auf der entsprechenden Seite: Les roles : droits d acces et d administration

Ändern des SSL-Zertifikats

Die verwendeten SSL-Zertifikate werden von bm-xmpp automatisch generiert, wenn eine neue Domain verwendet wird. Diese selbstsignierten Zertifikate müssen durch gültige Zertifikate ersetzt werden.

Um das Zertifikat einer Domain zu ersetzen, ersetzen Sie einfach die entsprechenden Dateien in /usr/share/bm-xmpp/certs/.

Die Zertifikatsdatei muss in dieser Reihenfolge Folgendes enthalten: das Zertifikat, den privaten Schlüssel und die CA-Zertifikate, gefolgt von der Kette zum Root, falls erforderlich.

Verbinden des XMPP-Servers mit dem Internet

Indem Sie dem XMPP-Server erlauben, sich mit dem Internet zu verbinden kann der Server sich mit anderen XMPP-Servern verbinden oder externen Benutzern erlauben, sich mit dem BlueMind XMPP-Server zu verbinden. BlueMind-Benutzer können dann Kontakte von außerhalb von BlueMind zu ihrer Instant-Messaging-Kontaktliste hinzufügen (die im "Roaster“ angezeigt wird).

Suchen Sie eine aus dem Internet erreichbare DNS-Adresse

Wenn der XMPP-Server z. B. eine DNS-Adresse xmpp.mydomain.com hat, muss dieser DNS-Name extern und nicht nur vom internen Netzwerk aufgelöst werden.

Kommunikationsanschlüsse

Die folgenden Ports müssen auf dem Server xmpp.mydomain.com von außen erreichbar sein (siehe auch)Les services:

5222 vom Client zu Server für die Client-Server-Kommunikation
5269 wird für die Kommunikation zwischen Servern verwendet

Wenn bm-xmpp nicht auf dem Server mit dem DNS-Namen xmpp.mydomain.com installiert ist (z.B. im Falle eines Proxys), müssen Streams von diesen Ports auf den Server umgeleitet werden, der bm-xmpp hostet.

Hinzufügen von DNS-Einträgen vom Typ SRV

Die DNS-Konfiguration der Domain mydomain.com muss geändert werden, damit das externe Netzwerk den Server xmpp.mydomain.com als XMPP-Server für die Domain mydomain.com erkennen kann.

Die folgenden Einträge vom Typ VRS sind hinzuzufügen:

Schlüssel

Beispiel

Beschreibung

Pas de format

nopanel	true

_xmpp-client._tcp.DOMAIN.

Pas de format

nopanel	true

_xmpp-client._tcp.mydomain.com.  86400  IN  SRV  5 0 5222  xmpp.mydomain.com

Client-Server-Kommunikation

Pas de format

nopanel	true

_xmpp-server._tcp.DOMAIN.

Pas de format

nopanel	true

_xmpp-server._tcp.mydomain.com.  86400  IN  SRV  5 0 5269  xmpp.mydomain.com

Server-zu-Server-Kommunikation

Prüfen von DNS-Einträgen

Es ist möglich, das Kommandozeilen-Tool dig zu verwenden, um DNS-Einträge zu überprüfen. Zum Beispiel, um herauszufinden, welcher Server für die Domain gmail.com zu verwenden ist:

Pas de format

nopanel	true

root@prec:~# dig SRV _xmpp-client._tcp.gmail.com

; <<>> DiG 9.8.1-P1 <<>> SRV _xmpp-client._tcp.gmail.com
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 56538
;; flags: qr rd ra; QUERY: 1, ANSWER: 5, AUTHORITY: 0, ADDITIONAL: 10

;; QUESTION SECTION:
;_xmpp-client._tcp.gmail.com.	IN	SRV

;; ANSWER SECTION:
_xmpp-client._tcp.gmail.com. 5	IN	SRV	5 0 5222 xmpp.l.google.com.
_xmpp-client._tcp.gmail.com. 5	IN	SRV	20 0 5222 alt1.xmpp.l.google.com.
_xmpp-client._tcp.gmail.com. 5	IN	SRV	20 0 5222 alt2.xmpp.l.google.com.
_xmpp-client._tcp.gmail.com. 5	IN	SRV	20 0 5222 alt3.xmpp.l.google.com.
_xmpp-client._tcp.gmail.com. 5	IN	SRV	20 0 5222 alt4.xmpp.l.google.com.

;; ADDITIONAL SECTION:
xmpp.l.google.com.	5	IN	A	74.125.132.125
xmpp.l.google.com.	5	IN	AAAA	2a00:1450:400c:c06::7d
alt1.xmpp.l.google.com.	5	IN	A	173.194.70.125
alt1.xmpp.l.google.com.	5	IN	AAAA	2a00:1450:4001:c02::7d
alt2.xmpp.l.google.com.	5	IN	A	173.194.69.125
alt2.xmpp.l.google.com.	5	IN	AAAA	2a00:1450:4008:c01::7d
alt3.xmpp.l.google.com.	5	IN	A	74.125.135.125
alt3.xmpp.l.google.com.	5	IN	AAAA	2404:6800:4001:c01::7d
alt4.xmpp.l.google.com.	5	IN	A	74.125.128.125
alt4.xmpp.l.google.com.	5	IN	AAAA	2404:6800:4005:c00::7d

;; Query time: 572 msec
;; SERVER: 172.16.45.2#53(172.16.45.2)
;; WHEN: Tue Sep  3 01:28:26 2013
;; MSG SIZE  rcvd: 470

Arborescence des pages

Comparaison des versions

Ancienne version 42

Nouvelle version Actuel

Légende

Introduction

Installation

Integration with BlueMind services

Service inter-dependencies

Enabling the instant messaging service

Changing SSL certificates

Connecting the XMPP server to the internet

Finding an externally-accessible DNS address

Communication ports

Adding DNS SRV records

Checking DNS records

Präsentation

Installation

Integration mit BlueMind-Diensten

Abhängigkeiten zwischen Diensten

Aktivieren von Instant Messaging

Ändern des SSL-Zertifikats

Verbinden des XMPP-Servers mit dem Internet

Suchen Sie eine aus dem Internet erreichbare DNS-Adresse

Kommunikationsanschlüsse

Hinzufügen von DNS-Einträgen vom Typ SRV

Prüfen von DNS-Einträgen

Arborescence des pages

Historique de la page

Comparaison des versions

Ancienne version 42

Nouvelle version Actuel

Légende

Introduction

Installation

Integration with BlueMind services

Service inter-dependencies

Enabling the instant messaging service

Changing SSL certificates

Connecting the XMPP server to the internet

Finding an externally-accessible DNS address

Communication ports

Adding DNS SRV records

Checking DNS records

Präsentation

Installation

Integration mit BlueMind-Diensten

Abhängigkeiten zwischen Diensten

Aktivieren von Instant Messaging

Ändern des SSL-Zertifikats

Verbinden des XMPP-Servers mit dem Internet

Suchen Sie eine aus dem Internet erreichbare DNS-Adresse

Kommunikationsanschlüsse

Hinzufügen von DNS-Einträgen vom Typ SRV

Prüfen von DNS-Einträgen