Authentication IMAP Plugin description
Open-Xchange imap authentication module
Introduction
The Open-Xchange imap authentication module is used to perform the Open-Xchange authentication against a IMAP server. During log in, a imap connection is opened with the users credentials given through the Open-Xchange login mask. If that IMAP connect succeeds, the users is authenticated and finally logged in to Open-Xchange.
The module does replace the database authentication module installed by default.
Imap Authentication Matrix
The IMAP authentication module has configuration parameters which do influence the username which is used for the IMAP connect during log in. The parameters are:
com.openexchange.mail.loginSource USE_FULL_LOGIN_INFO USE_MULTIPLE
The following examples make the behaviour of that parameters visible. The log in string, passed as example to the Open-Xchange log in mask is
user@domain.tld
during user provisioning, following attributes are set for the context via the createcontext call:
| attribute | value |
| contextname | domain.tld |
and following parameters via the creatuser call:
| attribute | value |
| imaplogin | user1337 |
| username | user |
| exampleuser@otherdomain.tld |
com.openexchange.mail.loginSource=login
| Property/Property | USE_FULL_LOGIN_INFO | ||
|---|---|---|---|
| true | false | ||
| USE_MULTIPLE | true | user1337 | user1337 |
| false | user@domain.tld | user | |
com.openexchange.mail.loginSource=mail
| Property/Property | USE_FULL_LOGIN_INFO | ||
|---|---|---|---|
| true | false | ||
| USE_MULTIPLE | true | exampleuser@otherdomain.tld | exampleuser@otherdomain.tld |
| false | user@domain.tld | user | |
com.openexchange.mail.loginSource=name
| Property/Property | USE_FULL_LOGIN_INFO | ||
|---|---|---|---|
| true | false | ||
| USE_MULTIPLE | true | user@domain.tld | user |
| false | user@domain.tld | user | |
Install on OX AppSuite
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/stable/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/stable/updates/DebianBullseye/ /
and run
$ apt-get update $ apt-get install open-xchange-authentication-imap
Debian GNU/Linux 12.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/stable/DebianBookworm/ /
# 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/stable/updates/DebianBookworm/ /
and run
$ apt-get update $ apt-get install open-xchange-authentication-imap