Configuring Open-Xchange Plug-ins

Configure the Open-Xchange plug-ins.

1. Configure the Open-Xchange and CloudBlue Commerce anti-spam functionality:
   1. Edit /opt/open-xchange/etc/groupware/imap.properties file.
   2. Set the SpamAssassin value of the com.openexchange.imap.spamHandler property.

      Example:

      # Define the registration name of the appropriate spam handler to use
      com.openexchange.imap.spamHandler=SpamAssassin

   3. Save the file.
   4. Edit /opt/open-xchange/etc/groupware/spamassassin.properties file.
   5. Set the true value of the com.openexchange.spamhandler.spamassassin.spamd property.

      Example:

      # Choose if a mail should be send to spamd afterwards
      
      com.openexchange.spamhandler.spamassassin.spamd=true

   6. Save the file.
   7. Obtain the CloudBlue Commerce Public API parameters from provider control panel, System > Settings > Public API in the Integration group.

      Note: To learn more about CloudBlue Commerce Public API, refer to Operations Provider's Guide >> Configuring CloudBlue Commerce Public API chapter.

      In the Public API Manager, add the BackNet IP Address of the Open-Xchange host to the Allowed Networks list, if it is required.

   8. Open the /opt/open-xchange/etc/groupware/parallels.properties file and add the following properties:

      ## OpenAPI properties for managing Black&White Lists via OX GUI
      #
      # This property defines the URL to the HTTP OpenAPI interface of CloudBlue Commerce
      com.openexchange.custom.parallels.openapi.interface_url=http://192.0.0.1:8440/
      
      #
      # This property defines if OpenAPI calls should be made with http basic auth
      com.openexchange.custom.parallels.openapi.auth_enabled=false
      
      #
      # This property defines OpenAPI http basic auth credentials auth id
       com.openexchange.custom.parallels.openapi.auth_id=openapi_user_id
      
      #
      # This property defines OpenAPI http basic auth credentials auth password
      com.openexchange.custom.parallels.openapi.auth_password=openapi_password
      
      #
      # The property defines the mount point of the OX OpenAPI servlet implementation.
      # Typically, no need to change it.
      com.openexchange.custom.parallels.openapi_servlet=/ajax/parallels/openapi

   9. Substitute the appropriate values of CloudBlue Commerce Public API properties and save the file.
   10. On the SpamAssassin host, add the BackNet IP Address of the Open-Xchange host to the list of allowed IP addresses. See the https://kb.cloudblue.com/113343 KB article for the detailed instructions.
2. Configure branding:
   1. Edit /opt/open-xchange/etc/groupware/parallels.properties file.
   2. Set the hostname of Open-Xchange UI having default skin/theme as value of the com.openexchange.custom.parallels.branding.fallbackurl property.

      Example:

      com.openexchange.custom.parallels.branding.fallbackurl=oxui.example.com

   3. Save the file.
   4. Edit /opt/open-xchange/etc/groupware/notification.properties file.
   5. Set the http://OX_UI_HOSTNAME/#m=[module]&i=[object]&f=[folder] value of the object_link property.

      where the OX_UI_HOSTNAME parameter is the hostname of Open-Xchange UI having the default theme/skin.

      Example:

      object_link=http://oxui.example.com/#m=[module]&i=[object]&f=[folder]

   6. Save the file.
3. Edit /opt/open-xchange/etc/admindaemon/plugin/hosting.properties file.
4. Set the [$%:\\.+a-zA-Z0-9@_\\/\\|-] value of the CHECK_CONTEXT_LOGIN_MAPPING_REGEXP property.

   Example:

   # pattern of allowed chars in login mapping names
   CHECK_CONTEXT_LOGIN_MAPPING_REGEXP=[$%:\\.+a-zA-Z0-9@_\\/\\|-]

5. Save the file.
6. Edit /opt/open-xchange/etc/admindaemon/User.properties file.
7. Set the true value of the USERNAME_CHANGEABLE property.

   Example:

   USERNAME_CHANGEABLE=true

8. Set the false value of the PRIMARY_MAIL_UNCHANGEABLE property.

   Example:

   PRIMARY_MAIL_UNCHANGEABLE=false

9. Save the file.
10. Make sure that user and group of the /opt/open-xchange/etc/groupware/osgi/org.eclipse.osgi directory are the open-xchange user and open-xchange group correspondingly:

    /opt/open-xchange/etc/groupware/osgi/ | grep org.eclipse.osgi
     drwx--x--x 4 open-xchange open-xchange 4096 Jun 16 22:58 org.eclipse.osgi

    If required, adjust the user and group with the help of the chown -R command.

    Set com.openexchange.easylogin.allowInsecureTransmission = true in the configuration file located in /opt/open-xchange/etc/groupware/easylogin.properties.

    Set com.openexchange.sessiond.autologin:true in the configuration file located in /opt/open-xchange/etc/groupware/sessiond.properties. This will create a cookie which enforces refresh behavior for Open-Xchange UI. When true, any attempt to refresh the page will refresh only the Open-Xchange UI, otherwise the whole page is refreshed and the user is returned to the login page.

11. Restart Open-Xchange services using the following commands (mind the sequence):

    service open-xchange-admin stop

    service open-xchange-admin start

    service open-xchange-groupware stop

    service open-xchange-groupware start