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.

Install on OX {{#if:|{{{version}}}| 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://{{#if:%7C{{{ldbaccount}}}@%7C}}software.open-xchange.com/{{#if:%7C{{{toplevel}}}%7Cproducts}}/private/4aea518e3cc15a687d6ce682dfef9a5b/DebianBuster/ /{{#if:||

# 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/{{#if:|{{{toplevel}}}|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://{{#if:%7C{{{ldbaccount}}}@%7C}}software.open-xchange.com/{{#if:%7C{{{toplevel}}}%7Cproducts}}/private/4aea518e3cc15a687d6ce682dfef9a5b/DebianBullseye/ /{{#if:||

# 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/{{#if:|{{{toplevel}}}|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