3. Configuration

The following reference shows the available settings for the OX Connector app.

3.1. App Settings

OX_SOAP_SERVER

Defines the server that has OX App Suite installed. Provide the protocol and the FQDN, for example https://ox-app-suite.example.com.

OX_SOAP_SERVER instructs the OX Connector app in the Docker container, where it must look for the OX App Suite system. The Docker container must resolve the FQDN.

Required	Type	Initial value
Yes	String	https://$hostname.$domainname

For secure connections with HTTPS the Docker container needs to validate the certificate.

Note

If the OX App Suite instance uses a self-signed certificate or a certificate it can’t validate, the OX Connector Docker container needs the root certificate for validation.

For example, to add a custom certificate, run the following commands on the UCS system, where OX Connector is installed:

$ univention-app shell ox-connector
/oxp # wget --no-check-certificate \
  https://ox-app-suite.example.com/root-ca.crt \
  -O /usr/local/share/ca-certificates/ox-app-suite.crt
/oxp # update-ca-certificates
"WARNING: ca-certificates.crt does not contain exactly one certificate or CRL: skipping"

Administrators can ignore the warning.

OX_IMAP_SERVER

Defines the default IMAP server for new users, if not explicitly set at the user object.

Required	Type	Initial value
Yes	String	imap://$hostname.$domainname:143

OX_SMTP_SERVER

Defines the SMTP server for new users, if not explicitly set at the user object.

Required	Type	Initial value
Yes	String	smtp://$hostname.$domainname:587

DEFAULT_CONTEXT

Defines the default context for users. The OX Connector doesn’t create the DEFAULT_CONTEXT automatically. You as administrator must ensure, the default context exists before the OX Connector provisions the first user. To create a context, see Contexts.

Required	Type	Initial value
Yes	Integer	10

OX_LANGUAGE

Defines the default language for new users

Required	Type	Initial value
Yes	String	de_DE

LOCAL_TIMEZONE

Defines the default timezone for new users

Required	Type	Initial value
Yes	String	Europe/Berlin

OX_MASTER_ADMIN

Defines the user for the OX App Suite administrator user, also called OX Admin user. This user can create, modify, and delete contexts. The user must already exist. The administrator defines the username for the OX Admin user during the installation of OX App Suite.

Required	Type	Initial value
Yes	String	oxadminmaster

OX_MASTER_PASSWORD

Defines the password for the OX Admin user.

Required	Type	Initial value
No	Password	N/A

3.2. Univention Configuration Registry variables

ox/context/id

The app setting DEFAULT_CONTEXT sets the value of the Univention Configuration Registry variable ox/context/id.

Upon installation of the app OX Connector, the OX Connector creates the extended attribute oxContext and uses the value from ox/context/id as initial value for the extended attribute oxContext.

When an administrator creates a new user account that the OX Connector synchronizes, UDM sets the OX context for the user account to value of the extended attribute oxContext.

Caution

The UCR variable ox/context/id isn’t for manual usage.

Changing the variable doesn’t change the OX context on existing user accounts.

Changing the value of the app setting DEFAULT_CONTEXT does neither change ox/context/id nor the extended attribute oxContext.