Views

How to create an XMPP account

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search

Introduction

The XMPP protocol in OpenScape Office V3 is designed to allow messaging and presence exchange between an OSO user on one side and an external XMPP client on the other side. XMPP is supported by the following clients of the communication system:

  • myPortal for Desktop
  • myPortal for Outlook

An external XMPP communication partner may be a Google Talk user, for example. OSO’s integrated XMPP server is addressed via port 5269 by default. The port is available only for XMPP server-to-server connection. This means that an external XMPP client cannot register directly to OSO’s integrated XMPP server. Here’s a typical XMPP communication example: OSO client <--> OSO XMPP server <--> GoogleTalk Server <--> GoogleTalk client

XMPP IDs of external communication partners must conform to the pattern xmpp:john.public@oso.example-for-a-domain.com and may be present at the following locations:

  • external directory
  • External offline directory (LDAP)
  • Personal directory (myPortal for Desktop)
  • Outlook contacts (myPortal for Outlook) -> IM address field


Activating XMPP in the admin portal (global XMPP configuration)

In OpenScape Office, XMPP is disabled by default and can be configured by the administrator. Prerequisites The communication system has a connection to the Internet. The communication system can be accessed reached from the Internet under a name, e.g., oso.example-for-a-domain.com. You are logged in to OpenScape Office Assistant with the Expert profile.

Go to Expert Mode > Application Suite > WebServices > Instant Messaging Select the XMPP Mode on check box. Select one of the following options:

  • If you run a standalone OSO, select the option XMPP Standalone.
  • If you run a networked OSO, select the option XMPP in the network.

In a standalone OSO and in the master node of a networked OSO, you must enter the domain name under which the communication system can be reached via the Internet. Typically, this domain name is identical to the configured DynDNS name of the OSO. Format: oso-sample-domain.com.

Important: Please ensure that your system is really accessible from the internet via this domain name!!


Activating a NAT rule for XMPP port Go to Expert Mode > Routing > NAT > XMPP-Server Activate the NAT rule and enter the local IP address.


XMPP configuration per OSO client

Now, open myPortal (or the Outlook client).

Go to Setup > My Personal Details Choose your individual XMPP ID (user part only – the domain is common for all OSO users). Example Entering mad.max will result in an XMPP ID mad.max@oso-sample-domain.com

Now you are ready to get in contact with external XMPP partners. To test it, open a personal contact and add the XMPP ID of the contact. Format: xmpp:user@external-domain Example: xmpp:charly@googletalk.com Save the changes and add this contact to your favorites. In the favorite’s context menu, you can send out an XMPP subscription. Or the external XMPP partner can send a subscription to you. In each case, the subscription request has to be accepted by the receiving partner before you can start exchanging presence, etc.