Difference between revisions of "MDaemon Integration"

[unchecked revision]

[checked revision]

Latest revision as of 16:34, 17 December 2020

In addition to adding users manually as described in chapter User Management, MailStore Server can synchronize its internal user database with the MDaemon Email Server of your organization.

During synchronization, user information, such as user names and email addresses, is copied from the MDaemon Email Server into MailStore Server's user database. That way, users can use their MDaemon Email Server credentials to also log on to MailStore Server and emails can be assigned to their corresponding user archives automatically, for example. No changes are made to the MDaemon Email Server itself by MailStore Server. The scope of the synchronization can be limited through filters.

Accessing the Directory Service Integration

Log on to MailStore Client as a MailStore Server administrator.
Click on Administrative Tools > Users and Archives > Directory Services.
In the Integration section, change the directory service type to MDaemon Email Server.

Connection to the MDaemon

For synchronization MailStore Server requires information on how to access the MDaemon App directory.

MDaemon App Directory
Enter the path to the App directory of your MDaemon installation. The App directory contains the files Userlist.dat and Groups.dat. If MailStore Server is installed on the same computer as the MDaemon Email Server, the MDaemon App directory is detected automatically.
If MailStore Server is not installed on the same machine, share the App directory of the MDaemon Email Server with the MailStore Server computer and enter the share's UNC path into the field MDaemon App Directory (e.g. \\MDAEMON\MDApp).

Please note: To access the MDaemon App directory through a network share it may be necessary to configure a connection to a network share for the MailStore Server Service.

Code Page
You only have to change this option if the encoding of the filesUserlist.dat and Groups.dat differs from the standard encoding of the MailStore Server computer.

User Database Synchronization

After configuring the connection settings as described above, you can specify filter criteria for the MDaemon user database synchronization in this section.

MDaemon Groups
Choose one or more groups to let only their members be created as MailStore Server Users. If no groups are selected, all users will be synchronized.

Authentication

To achieve this, you have to configure the following settings in the Authentication section:

MDaemon IMAP Server
Enter the IP address or the DNS name of the MDaemon Email Server against which authentication should be performed.
IMAP Server Access
Configure whether the IMAP connection to the MDaemon Email Server should be unencrypted or IMAP-TLS/IMAP-SSL encrypted.
Ignore SSL Security Warnings (only when using IMAP-TLS or IMAP-SSL)
Activate this option if a self-signed or non-public certificate is used for IMAP encryption on the MDaemon Email Server. Otherwise the authentication will permanently fail.

Important Notice: If your MDaemon users authenticate against an Active Directory, you must disable ... honor APOP & CRAM-MD5 under Setup > Default Domain / Servers > Default Domain & Servers > Servers in your MDaemon Email Server. Otherwise users will not be able to log on to MailStore Server.

Options

Automatically delete users in MailStore Server
Here you can choose whether users that have been deleted in the MDaemon Email Server will also be deleted in the MailStore Server user database by the synchronization. Users will also be deleted if they fall out of scope of the configured settings.
Only MailStore Server users that have their authentication method set to Directory Services will be deleted.
If the archive folder of such a user already contains archived emails, only the user entry but not its archive folder will be deleted in MailStore Server.

Assigning Default Privileges

By default, users that have been synchronized to MailStore Server from an MDaemon Email Server have the privilege to log on to MailStore Server as well as read access to their own user archive.
You can configure those default privileges before synchronization, for example, to assign the privilege Archive E-mail to all new users. To do this, click on Default Privileges...
More information on managing user privileges and their effects is available in the chapter Users, Folders and Settings which also has details on editing existing privileges.

Running Directory Services Synchronization

Click on Test Settings to check synchronization configuration and the results returned by the MDaemon Email Server without any changes to the MailStore Server user database being actually committed.

To finally run the synchronization, click on Synchronize now. The results are shown with any changes committed to the MailStore Server user database.

You can test the authentication for a user by first selecting him from the list and then clicking on the button on the lower left. You will now be asked for that user's password. Upon clicking OK you'll receive a message whether the authentication has been successful.

Login with MDaemon Credentials

After synchronization MailStore users can log on to MailStore Server with their MDaemon username and MDaemon password.

@@ Line 1: / Line 1: @@
-= Synchronizing User Accounts with an MDaemon User Database =
+{{DISPLAYTITLE:Synchronizing User Accounts with an MDaemon User Database}}
-In addition to adding users manually (which is described in chapter [[Users,_Folders_and_Settings#User_Management|User Management]]), MailStore can synchronize its internal user database with an MDaemon user database on the basis of the USERLIST.DAT of your MDaemon server.
+{{Directory Services Preamble|MDaemon Email Server}}
-During synchronization, user data and email addresses are gathered from the MDaemon user database and entered into MailStore. MailStore makes no changes to the MDaemon user database. Synchronization can be limited to individual or multiple groups.
+== Accessing the Directory Service Integration ==
+{{Directory Services Accessing Configuration|MDaemon Email Server|Mdaemon_sync_01.png}}
-== Opening the Directory Service Integration ==
+== Connection to the MDaemon ==
+For synchronization MailStore Server requires information on how to access the MDaemon App directory.
-* Using MailStore Client, log on as MailStore administrator.
+*'''MDaemon App Directory'''<br/>Enter the path to the App directory of your MDaemon installation. The App directory contains the files ''Userlist.dat'' and ''Groups.dat''. If MailStore Server is installed on the same computer as the MDaemon Email Server, the MDaemon App directory is detected automatically.<br/>If MailStore Server is not installed on the same machine, share the App directory of the MDaemon Email Server with the MailStore Server computer and enter the share's UNC path into the field ''MDaemon App Directory'' (e.g. <code>\\MDAEMON\MDApp</code>).
-* Click on ''Administrative Tools'' > ''Users and Privileges'' and then on ''Directory Services''.
-* Under ''Integration'', change the ''Directory Service Type'' to ''MDaemon USERLIST.DAT''.
-[[File:Mdaemon_sync_01.png|center|450px]]
+::<p class="msnote">'''Please note:''' To access the MDaemon App directory through a network share it may be necessary to configure  [[Using_Network_Attached_Storage_(NAS)|a connection to a network share]] for the MailStore Server Service.</p>
+*'''Code Page'''<br/>You only have to change this option if the encoding of the files''Userlist.dat'' and ''Groups.dat'' differs from the standard encoding of the MailStore Server computer.
-== Specifying Connection Settings ==
+== User Database Synchronization ==
+After configuring the connection settings as described above, you can specify filter criteria for the MDaemon user database synchronization in this section.
-Before the synchronization feature can be used, MailStore needs information on how to reach the MDaemon App Directory.
+*'''MDaemon Groups'''<br/>Choose one or more groups to let only their members be created as MailStore Server Users. If no groups are selected, all users will be synchronized.
-* '''MDaemon App Directory''' <br/> Enter the path to the app directory of your MDaemon installation. The app directory contains the files ''Userlist.dat'' and ''Groups.dat''. If MailStore Server is installed on the same computer as the MDaemon Server, the MDaemon app directory is recognized automatically.<br/><br/>If MailStore Server is not installed on the same machine, share the app directory of the MDaemon server with the MailStore Server computer and enter the UNC path for sharing the app directory into the field ''MDaemon App Directory'' (e.g. <code>\\MDAEMON\MDApp</code>).
+=== Authentication ===
+{{Directory Services MDaemon Authentication|MDaemon Email Server}}
-== Executing the Synchronization ==
+{{Directory Services Options|MDaemon Email Server}}
+{{Directory Services Assign Default Privileges|an MDaemon Email Server}}
-Once the connection settings have been specified (as described above), the MailStore user list can be synchronized with the MDaemon user database.
+{{Directory Services Run Synchronization|MDaemon Email Server}}[[File:ApplicationIntegration_sync_02.png|450px|center]]
-The synchronization can be limited to one or more MDaemon groups. To do so, click on the button next to the ''MDaemon Groups'' field and check the checkbox of each group that is to be synchronized. If no group is selected, all users are synchronized.
-Click on ''Test Settings'' to see a preview of what would happen when clicking ''Synchronize Now''. Click on ''Synchronize Now'' to start.
-[[File:Mdaemon_sync_02.png|center|450px]]
-= Login with MDaemon Access Data =
-By default, each user created in MailStore has his or her own password specifically for MailStore. The MailStore administrator can specify the password during setup of the user account. Users can later change their passwords in MailStore Client's ''Administrative Tools''.
-Alternatively, MailStore can be configured to allow users to log on to MailStore Server using their MDaemon passwords.
-== Specifying the Authentication Settings ==
-Before users can log on to MailStore Server using their MDaemon access data, the following settings need to be specified under ''Authentication'':
-* '''MDaemon IMAP Server''' - Enter the IP address or the host name of the MDaemon server an against which authentication is be executed.
-* '''IMAP Server Access''' - Specify if the connection to the IMAP server is to be unencrypted or IMAP-TLS/IMAP-SSL encrypted.
-*:''' Only when using IMAP-TLS and IMAP-SSL:''' Select the option to ''Ignore SSL security warnings'' if an unofficial certificate is used on the email server. Otherwise, authentication will fail permanently.
-<p class="msnote" style="color: red">'''Important Notice:''' If MDaemon is configured to authenticate users against an Active Directory, you must disable ''... honor APOP & CRAM-MD5'' under ''Setup'' > ''Default Domain / Servers'' > ''Default Domain & Servers'' > ''Servers'' in you MDaemon server to make the above configuration work for Active Directory users. Otherwise they will not be able to log in to MailStore.</p>
-== Procedure for Users Added via Synchronization with the MDaemon User Database ==
-If MailStore users were added using MDaemon Directory Service Synchronization as described in the previous section, no further actions are required. In this case, MailStore has already adjusted all necessary settings.
-== Procedure for Users Added Manually ==
-If MailStore users were added manually and if these users are to be able to log on using their MDaemon passwords, please proceed as follows:
-* Configure the MDaemon integration as described in chapter [[MDaemon_Integration#Synchronizing_User_Accounts_with_an_MDaemon_User_Database|Synchronizing User Accounts with an MDaemon User Database]].
-* Make sure that the MailStore users have the same names as the corresponding users in the MDaemon user database.
-* In the user properties menu under ''Authentication'', select ''Directory Services''.
-[[File:Maemon_sync_03.png|center|400px]]
+{{Directory Services Test Authentication}}
+{{Directory Services Login with Directory Services Credentials|MDaemon}}
 [[de:MDaemon-Integration]]
+[[en:MDaemon_Integration]]