Open-Xchange oxcs package

The oxcs package provides a bundle for authentiation, provisioning and proxy auth. This package is for special usage. If you do not know what oxcs is, you can stop reading here.

Setup

Installation on OX AppSuite

Debian GNU/Linux 7.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/DebianWheezy/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/updates/DebianWheezy/ /

and run

$ apt-get update
$ apt-get install open-xchange-oxcs

Debian GNU/Linux 8.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/DebianJessie/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/updates/DebianJessie/ /

and run

$ apt-get update
$ apt-get install open-xchange-oxcs

SUSE Linux Enterprise Server 11

Add the package repository using zypper if not already present:

$ zypper ar https://software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/SLES11 ox

If you have a valid maintenance subscription, please run the following command and add the ldb account data to the url so that the most recent packages get installed:

$ zypper ar https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/updates/SLES11 ox-updates

and run

$ zypper ref
$ zypper in open-xchange-oxcs

SUSE Linux Enterprise Server 12

Add the package repository using zypper if not already present:

$ zypper ar https://software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/SLE_12 ox

If you have a valid maintenance subscription, please run the following command and add the ldb account data to the url so that the most recent packages get installed:

$ zypper ar https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/updates/SLES11 ox-updates

and run

$ zypper ref
$ zypper in open-xchange-oxcs

RedHat Enterprise Linux 6

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/ox.repo

[ox]
name=Open-Xchange
baseurl=https://software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/RHEL6/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# [ox-updates]
# name=Open-Xchange Updates
# baseurl=https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/updates/RHEL6/
# gpgkey=https://software.open-xchange.com/oxbuildkey.pub
# enabled=1
# gpgcheck=1
# metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-oxcs

RedHat Enterprise Linux 7

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/ox.repo

[ox]
name=Open-Xchange
baseurl=https://software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/RHEL7/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# [ox-updates]
# name=Open-Xchange Updates
# baseurl=https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/updates/RHEL7/
# gpgkey=https://software.open-xchange.com/oxbuildkey.pub
# enabled=1
# gpgcheck=1
# metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-oxcs

CentOS 6

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/ox.repo

[ox]
name=Open-Xchange
baseurl=https://software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/RHEL6/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# [ox-updates]
# name=Open-Xchange Updates
# baseurl=https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/updates/RHEL6/
# gpgkey=https://software.open-xchange.com/oxbuildkey.pub
# enabled=1
# gpgcheck=1
# metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-oxcs

CentOS 7

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/ox.repo

[ox]
name=Open-Xchange
baseurl=https://software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/RHEL7/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# [ox-updates]
# name=Open-Xchange Updates
# baseurl=https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/private/4aea518e3cc15a687d6ce682dfef9a5b/updates/RHEL7/
# gpgkey=https://software.open-xchange.com/oxbuildkey.pub
# enabled=1
# gpgcheck=1
# metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-oxcs

Configuration

Authentication plugin

oxcs-authentication.properties

# URL of the LDAP server to connect to for authenticating users.
# ldaps is supported.
com.openexchange.authentication.oxcs.url= ldap://somehost:389

# Timeouts are useful to get quick responses for login requests. This timeout is 
# used if a new connection is established.
com.openexchange.authentication.oxcs.connect.timeout=10000

# This timeout only works since Java 6 SE to time out waiting for a response.
com.openexchange.authentication.oxcs.read.timeout=10000

# HTTP Header from which the brand name is fetched
com.openexchange.authentication.oxcs.header=host

# Regex to validate host HTTP Header value
com.openexchange.authentication.oxcs.host.regex= [0-9a-zA-Z.]*

#Regex to validate user name
com.openexchange.authentication.oxcs.user.regex= [0-9a-zA-Z.@]*

Proxy Servlet

oxcs-proxy-servlet.properties

# URL of the LDAP server to connect to for authenticating users.
# ldaps is supported.
com.openexchange.oxcs.proxy.servlet.url=ldap://somehost:389

# Timeouts are useful to get quick responses for login requests. This timeout is
# used if a new connection is established.
com.openexchange.oxcs.proxy.servlet.connect.timeout=10000

# This timeout only works since Java 6 SE to time out waiting for a response.
com.openexchange.oxcs.proxy.servlet.read.timeout=10000

# Regex to validate brandName value
com.openexchange.oxcs.proxy.servlet.brandName.regex= [0-9a-zA-Z.]*

#Regex to validate user name
com.openexchange.oxcs.proxy.servlet.uid.regex= [0-9a-zA-Z.@]*

Provisioning bundle

oxcs-provisioning.properties

# ldap server url
com.openexchange.oxcs.provisioning.ldapurl=ldap://somehost:389

# admin dn
com.openexchange.oxcs.provisioning.admindn=cn=oxadmin,o=oxcs

# admin dn password
com.openexchange.oxcs.provisioning.adminsecret= yourpassword

# tree for brands
com.openexchange.oxcs.provisioning.branddn=ou=brands,o=oxcs

# tree for other stuff like mailstores
com.openexchange.oxcs.provisioning.configdn=ou=config,o=oxcs

# tree for contexts
com.openexchange.oxcs.provisioning.contextdn=ou=contexts,o=oxcs