Difference between revisions of "IceWarp Server Integration"

[unchecked revision][unchecked revision]
Line 1: Line 1:
 +
----
 +
This article is currently under revision.
 +
----
 +
 
= Synchronizing User Accounts with an IceWarp Server User Database =
 
= Synchronizing User Accounts with an IceWarp Server 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 IceWarp Server User Database. For this, MailStore requires IceWarp Server API version 10.4 or newer.  
+
In addition to adding users manually (which is described in chapter [[Users,_Folders_and_Settings#User_Management|User Management]]), MailStore Server can synchronize its internal user database with an IceWarp Server user database. For this, MailStore Server requires the IceWarp Server API version 10.4 or newer.  
  
During synchronization, user information and email addresses are taken from the IceWarp Server user database and entered into MailStore. MailStore makes no changes to the IceWarp Server user database itself. Synchronization can be limited to individual or multiple domains and groups.
+
During synchronization user information such as user names and email addresses are read from the IceWarp Server user database and recorded in MailStore Server's user database. MailStore Server makes no changes to the IceWarp Server user database itself. Synchronization can be limited to individual or multiple domains and groups.
  
 
== Accessing the Directory Service Integration ==
 
== Accessing the Directory Service Integration ==
  
* Log on to MailStore Client as MailStore administrator.  
+
*Log on to MailStore Client as a MailStore Server administrator.
* Click on ''Administrative Tools'' > ''Users and Privileges'' and then on ''Directory Services''.
+
*Click on ''Administrative Tools'' > ''Users and Privileges'' and then on ''Directory Services''.
* Under ''Integration'' change the ''Directory Service Type'' to ''IceWarp Server''.
+
*In the ''Integration'' section, change the directory service type to ''IceWarp Server''.
  
 
[[File:Icewarp_sync_01.png|center|450px]]
 
[[File:Icewarp_sync_01.png|center|450px]]
  
== Specifying Connection Settings ==
+
== Connection to the IceWarp Server ==
 
 
Before the synchronization feature can be used, MailStore requires information on how to reach the IceWarp server.
 
 
 
* '''Server Name''' - Name or IP address of the IceWarp server. If you use a self-signed SSL certificate on the IceWarp server, please set a checkmark next to ''Ignore SSL Security Warnings''.
 
* '''User Name''' - Name of a user with administrative privileges.
 
* '''Password''' -  Password of the user with administrative privileges.
 
 
 
== Specifying Standard Privileges ==
 
  
By default, users who were synchronized to MailStore from a directory service can log on to MailStore Server and  have access to their own user archives.  
+
For synchronization MailStore Server requires information on how to connect to the IceWarp Server.  
  
The standard privileges can be customized before synchronization, to grant all new users the ''Archive Emails'' privilege, for example. To do so, click on the ''Standard Privileges...'' button.
+
*'''Server Name'''<br/>DNS name or IP address of the IceWarp server. If you use a self-signed or non-public SSL certificate on the IceWarp server, please set a checkmark next to ''Ignore SSL Security Warnings''.
 +
*'''User Name'''<br/>Name of a user with administrative privileges on the IceWarp server.
 +
*'''Password'''<br/>Password of that user.
 +
*'''Timout'''<br/>The timout value for IceWarp API requests. For large IceWarp Server user databases it may be necessary to increase this value.
  
Additional Information about managing user privileges and their effects is available in chapter [[Users, Folders and Settings]]. There you can also find directions for customizing existing privileges.
+
== Synchronize ==
  
== Executing the Synchronization ==
+
After configuring the connection settings as described above, you can specify filter criteria for the IceWarp Server user database synchronization in this section.
  
After the connection settings have been specified (as described above), the MailStore user list can be synchronized with the IceWarp Server user database.
+
*'''Domains and Groups'''<br/>Choose one or more domains or groups to let only their members be created as MailStore Server Users. If no domains or groups are selected, all users will be synchronized.  
  
Synchronization can be limited to one or more domains and groups. To do so, click on the button next to the ''Domains and Groups'' field and place a checkmark in front of the domains and groups you want to synchronize. If no domains or groups are selected, all users will be synchronized.
+
{{:Includes:Directory_Services_Options|IceWarp Server}}
 
+
{{:Includes:Assign_Default_Privileges|an IceWarp Server}}
Click on ''Verify Settings'', to see what would happen when clicking on ''Synchronize now''. Click on ''Synchronize now'' to start.
+
{{:Includes:Run_Directory_Services_Synchronization|IceWarp Server}}
  
 
[[File:Icewarp_sync_02.png|center|450px]]
 
[[File:Icewarp_sync_02.png|center|450px]]
  
= Login with IceWarp Access Data =
+
{{:Includes:Login_with_Directory_Services_Credentials|IceWarp Server|[[IceWarp_Server_Integration#Synchronizing_User_Accounts_with_an_IceWarp_Server_User_Database|Synchronizing User Accounts with an IceWarp Server User Database]]|[[File:Icewarp_sync_03.png|center|400px]]}}
 
 
By default, each user created in MailStore has a password specifically for MailStore. The MailStore administrator can specify the password while setting up the user account. Users can later change their passwords in MailStore Client's ''Administrative Tools''. Alternatively, you can configure MailStore to allow users to log on to MailStore Server using their IceWarp passwords.
 
 
 
== Procedure for Users Added by Synchronizing with the IceWarp Server User Database ==
 
 
 
If the MailStore users were added using IceWarp Server Directory Service Synchronization, as described in the previous section, no further action is required. In this case, MailStore has already specified all necessary settings automatically.
 
 
 
== Procedure for Users Added Manually ==
 
 
 
If the MailStore users were added manually and if these users are to be able to log on using their IceWarp passwords, please proceed as follows:
 
 
 
* Configure the IceWarp Server Integration as described in section [[IceWarp_Server_Integration#Synchronizing_User_Accounts_with_an_IceWarp_Server_User_Database|Synchronizing User Accounts with an IceWarp Server User Database]].
 
* Make sure that the MailStore users have the same names as the corresponding users in the IceWarp Server user database.
 
* In the user properties menu under ''Authentication'', select ''Directory Services''.
 
 
[[File:Icewarp_sync_03.png|center|400px]]
 
  
 
[[de:IceWarp_Server-Integration]]
 
[[de:IceWarp_Server-Integration]]

Revision as of 12:26, 18 October 2013


This article is currently under revision.


Synchronizing User Accounts with an IceWarp Server User Database

In addition to adding users manually (which is described in chapter User Management), MailStore Server can synchronize its internal user database with an IceWarp Server user database. For this, MailStore Server requires the IceWarp Server API version 10.4 or newer.

During synchronization user information such as user names and email addresses are read from the IceWarp Server user database and recorded in MailStore Server's user database. MailStore Server makes no changes to the IceWarp Server user database itself. Synchronization can be limited to individual or multiple domains and groups.

Accessing the Directory Service Integration

  • Log on to MailStore Client as a MailStore Server administrator.
  • Click on Administrative Tools > Users and Privileges and then on Directory Services.
  • In the Integration section, change the directory service type to IceWarp Server.
Icewarp sync 01.png

Connection to the IceWarp Server

For synchronization MailStore Server requires information on how to connect to the IceWarp Server.

  • Server Name
    DNS name or IP address of the IceWarp server. If you use a self-signed or non-public SSL certificate on the IceWarp server, please set a checkmark next to Ignore SSL Security Warnings.
  • User Name
    Name of a user with administrative privileges on the IceWarp server.
  • Password
    Password of that user.
  • Timout
    The timout value for IceWarp API requests. For large IceWarp Server user databases it may be necessary to increase this value.

Synchronize

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

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

Includes:Directory Services Options Includes:Assign Default Privileges Includes:Run Directory Services Synchronization

Icewarp sync 02.png

Includes:Login with Directory Services Credentials