| This manual is deprecated. Please visit https://groupoffice.readthedocs.io for the latest documentation. |
Difference between revisions of "IMAP or LDAP authentication"
| Line 36: | Line 36: | ||
The mailbox root. In most cases you can leave this value empty. It could be that you must enter “INBOX” or “mail” here. | The mailbox root. In most cases you can leave this value empty. It could be that you must enter “INBOX” or “mail” here. | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | <b>smtp_host</b> | ||
| + | |||
| + | The SMTP host to configure for new accounts | ||
| + | |||
| + | <b>smtp_port</b> | ||
| + | |||
| + | The SMTP port to configure for new accounts | ||
| + | |||
| + | <b>smtp_encryption</b> | ||
| + | |||
| + | The Encryption to use on SMTP connections: | ||
| + | 8=No encryption<br /> | ||
| + | 2=TLS<br /> | ||
| + | 4=SSL | ||
| + | |||
| + | <b>smtp_username</b> | ||
| + | |||
| + | The username for SMTP authentication | ||
| + | |||
| + | <b>smtp_password</b> | ||
| + | |||
| + | The password for SMTP authentication | ||
| + | |||
| + | |||
| + | |||
| + | |||
<b>remove_domain_from_username</b> | <b>remove_domain_from_username</b> | ||
Revision as of 13:12, 16 February 2009
Group-Office supports IMAP authentication. This means it will check an IMAP server for a valid account and will add/update the corresponding Group-Office account. To set this up you must install the "imapauth" module and rename "imapauth.config.php.example" to "imapauth.config.php" and put that file in the same directory as where your config.php file is.
When a user logs in it must login with the full e-mail address. When Group-Office finds a configuration it will attempt IMAP authentication. If it fails it will fall back on Group-Office authentication.
Then you must edit the values in the file. Below a list of parameters.
It's easy to implement other authentication plugins. Read more about it here: http://www.group-office.com/wiki/Event_handling
Parameters
proto
The protocol. Can be IMAP or POP-3. IMAP is highly recommended. POP-3 is slow and doesn't offer the use of multiple e-mail folders.
domains
The domains this mail server configuration is valid for. It can be a comma separated list of domains (eg. "intermesh.nl,group-office.com"). You can also use * to match all domains.
host
The hostname of the machine where the mailserver runs.
port
The port. For IMAP usually 143 and for POP-3 usually 110.
ssl
SSL mode on or off
novalidate_cert
Validate the SSL certificate yes or no. with some mailservers you must enable this feature always even if you don't use SSL.
mbroot
The mailbox root. In most cases you can leave this value empty. It could be that you must enter “INBOX” or “mail” here.
smtp_host
The SMTP host to configure for new accounts
smtp_port
The SMTP port to configure for new accounts
smtp_encryption
The Encryption to use on SMTP connections:
8=No encryption
2=TLS
4=SSL
smtp_username
The username for SMTP authentication
smtp_password
The password for SMTP authentication
remove_domain_from_username
Enable this option if you want to remove the domain to the e-mail address. When you enable a user with e-mail john@example.com will login with "john@example.com" but GO will send "john" to the IMAP server.
create_email_account
If you want to create an e-mail account in Group-Office automatically when a user logs in the first time enable this option.
groups
Add the new users to these user groups automatically.
visible_groups
Make new users automatically visible to these user groups.
modules_read
Grant new users read permissions to these modules.
modules_write
Grant new users administrator permissions to these modules.
