AppSuite:Architecture Overview: Difference between revisions
Karsten.will (talk | contribs) |
|||
Line 73: | Line 73: | ||
A <span style="background:#E5E594">subscription based plugin system</span> allows to access data from external systems like webmail systems or social messaging. The underlying concept is called [[SocialOX]], a list of some plugins can be found here: [[SupportedCrawler]] The integrations of messaging, contacts and calendars are done via the official API of the respective 3rd-party-service wherever there is one. For authentication OAuth is used wherever available for security and privacy control. All plugins use HTTP(S) connections to the external service only. Access to the external email systems is done via IMAP(S), POP3(S), depending on the service. | A <span style="background:#E5E594">subscription based plugin system</span> allows to access data from external systems like webmail systems or social messaging. The underlying concept is called [[SocialOX]], a list of some plugins can be found here: [[SupportedCrawler]] The integrations of messaging, contacts and calendars are done via the official API of the respective 3rd-party-service wherever there is one. For authentication OAuth is used wherever available for security and privacy control. All plugins use HTTP(S) connections to the external service only. Access to the external email systems is done via IMAP(S), POP3(S), depending on the service. | ||
*'''31''' For subscription to an external calendar | *'''31''' For subscription to an external calendar a plugin to subscribe to Google Calendar is available. | ||
*'''32''' External messaging services (Facebook, Twitter, SMS/MMS) | *'''32''' External messaging services (Facebook, Twitter, SMS/MMS) | ||
Line 80: | Line 80: | ||
*'''34''' External email accounts can be integrated (POP3, IMAP) | *'''34''' External email accounts can be integrated (POP3, IMAP) | ||
** preconfigured for mail-account plugin: google, Yahoo, msn/WindowsLive, gmx.com , gmx.de , web.de , freenet.de | ** preconfigured for mail-account plugin: google, Yahoo, msn/WindowsLive, gmx.com, gmx.de, web.de, freenet.de | ||
** [[Install and configure the mail-account plugin]] | ** [[Install and configure the mail-account plugin]] | ||
Revision as of 12:29, 24 May 2013
This page gives an overview of the most important internal components, plugin capabilities, public interfaces (APIs) and data communication streams of the Open-Xchange server.
User and client based communication flow
- 1 All communication from and to the users client is purely based on HTTP. It is strongly recommended to use only encrypted HTTPS. For security reasons, some modules require HTTPS connections in the default configuration. The HTTP(S) communication is terminated at Apache.
- 2 Within Apache, the mod_proxy_http module is used to forward the request to the OX server. Apache can also be used to configure session stickiness and load balancing in clustered environments.
- 3 OX Web UI
- The HTTP API is the core API for all user functionality. Every function of the Web UI is using this API. In addition to that, all possible user functionality is available via this API and can be used from external applications as well. It is based on JSON via HTTP(S).
- Requirements Web UI
- Programming Example, how to use this API to build an Email widget, accessing the HTTP API
- 4 The OXtender for Business Mobility is a server based Active Sync Implementation. The "Microsoft Exchange Active Sync" protocol supports Push via HTTPS, therefore the email backend needs to send push events to the OX server. Details, see: OXtender for Business Mobility Installation Guide and Email Push Introduction. Serverside, the synchronization makes use of the "Universal Sync Module (USM)", which is a server bundle containing the synchronization logic for several clients. It also communicates via HTTP(S) transporting JSON objects.
- 5 The OXtender 2 for Microsoft Outlook is a MAPI plugin, installed in the Outlook client to synchronize data between Outlook and the OX server. It makes use of the same HTTP(S) and JSON based communication to the Universal Sync Module (USM), like Active Sync.
- 6 CalDAV and CardDAV interfaces are available to synchronize calendars and address books with Apple OS X and iOS applications as well as Thunderbird: CalDAV Clients and CardDAV Clients.
- 7 A WebDAV implementation provides the possibility to access the documents in the Files-module directly via any WebDAV client, like the Windows Explorer.
- 11 Data Migration and Im-/Export of user data can be done via automated tools, using these interfaces:
- Using the import servlet, Building an importer
- Using the export servlet, Building an exporter, iCal/vCard
- A tool is available to upload data from Outlook profiles or PST files to OX: Outlook Uploader
- 12 All provisioning tasks, like creating and editing users can be done with Commandline tools. The command line tools make use of the Java RMI API internally.
- 13 The native, central provisioning API is available via Java RMI and split into the Core API and the HostingAPI.
- 14 Central control panels and billing systems, which are not implemented in Java, can use the RMI API via the SOAP API, examples of its usage can be found here.
- Standard integration via SOAP is available for OPWV Directory
- for Parallels Operations Automation see POA integration guide
- for Parallels Plesk Panel see Plesk OXtender installation
- for cPanel see cPanel installation
- 15 Authentication is implementable via highly customizable plugins, different standard and custom implementations are available
- IMAP
- LDAP
- Database
- custom
- 16 Monitoring the OX application is done via JMX, for a description see OX monitoring interface, or a commandline tool
- An example how to use the monitoring interface is available as pre-built Scripts for the monitoring tool Munin: OX munin scripts
- 21 All OX-internal data - users, contacts, calendars, tasks and document metadata is stored in a MySQL Database, accessed via JDBC
- 22 Native MySQL contacts storage
- 23 Other sources for contacts than the MySQL storage can also be used. For this an OSGi bundle needs to be implemented, overriding the standard contact storage.
- An implementation using LDAP is publicly available
- Several custom implementations are available on request or can be implemented by partners
- 24 Email storage is accessed through the pluggable Mail Abstraction Layer API
- The default implementation uses IMAP
- Sending Emails is done via SMTP
- For Openwave Email MX, Stateless Edition see OPWV MX
- For Active Sync or Outlook the email backend needs to send push requests to the OX server, for details see Email Push Introduction
- Several custom implementations are available on request or can be implemented by partners
- 25 Documents in the Files module are accessed via an API, which allows customized implementations.
- The default in large environments is to use NFS
- In small environments the local filesystem is used
- Scality si also available
- Several custom implementations are available on request or can be implemented by partners
A subscription based plugin system allows to access data from external systems like webmail systems or social messaging. The underlying concept is called SocialOX, a list of some plugins can be found here: SupportedCrawler The integrations of messaging, contacts and calendars are done via the official API of the respective 3rd-party-service wherever there is one. For authentication OAuth is used wherever available for security and privacy control. All plugins use HTTP(S) connections to the external service only. Access to the external email systems is done via IMAP(S), POP3(S), depending on the service.
- 31 For subscription to an external calendar a plugin to subscribe to Google Calendar is available.
- 32 External messaging services (Facebook, Twitter, SMS/MMS)
- 33 Contacts integration (Xing, LinkedIn, MSN/Windows Live, Yahoo, Facebook, google, gmx.de, web.de)
- 34 External email accounts can be integrated (POP3, IMAP)
- preconfigured for mail-account plugin: google, Yahoo, msn/WindowsLive, gmx.com, gmx.de, web.de, freenet.de
- Install and configure the mail-account plugin
- 35 RSS are loaded remotely, filtered for exploits and can be read in the UI
- 36 Image services like Flickr and Tumblr are integrated directly into the UI, bypassing the backend completely. Authentication is handled via OAuth.
Public Available Plugins
- An overview of the existing public plugins can be found here: Open-Xchange Plugin Overview. Many others are available on request or through partners.