Oxcs bundles install

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

Install on OX AppSuite

Debian GNU/Linux 10.0

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

deb https://software.open-xchange.com/products/private/4aea518e3cc15a687d6ce682dfef9a5b/DebianBuster/ /
# 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/products/private/4aea518e3cc15a687d6ce682dfef9a5b/updates/DebianBuster/ /

and run

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

Debian GNU/Linux 11.0

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

deb https://software.open-xchange.com/products/private/4aea518e3cc15a687d6ce682dfef9a5b/DebianBullseye/ /
# 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/products/private/4aea518e3cc15a687d6ce682dfef9a5b/updates/DebianBullseye/ /

and run

$ apt-get update
$ apt-get 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