====== IceWarp Connector ======
This connector can be used to connect to email client IceWarp. Communication is via API which is provided by the end system.
Implemented and tested on IceWarp Server version 12.1.1.4 RHEL7 x64.
===== Configuration =====
Connector has few settings which need to be configured before you used it.

=== Host ===
Adress where email client is running.

=== Username ===
Username for account which will be used for communication with the end system.

=== Password ===
Password for account.

=== Domain ===
Domain on IceWarp server where users are stored. If you want to connect more than one domain in same IceWarp server you should create new system connection for every domain.

=== Type of objectClass === 
There are two types of object which are supported in current version of connector.
\_\_ACCOUNT\_\_ for users and \_\_GROUP\_\_ for roles
If you want connect both types make two systems in IdM, with different configuration.

=== Debug mode ===
You can activate debug mode by this property to see xml requests in log.
This will only work if logging is configured in logback-spring.xml.
Find your active profile in this file and check for this configuration:
<code>
<logger name="eu.bcvsolutions" level="INFO"/>
</code>
(when using "production" profile, idm choose "default" profile because there is no production configuration)

== Log example: ==
<code>
2019-01-08 10:52:12.509  INFO 2729 --- [nio-8080-exec-2] e.b.idm.connector.IceWarpConnector       : ICEWARP REQUEST XML BODY
2019-01-08 10:52:12.510  INFO 2729 --- [nio-8080-exec-2] e.b.idm.connector.IceWarpConnector       : <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<iq sid="">
    <query xmlns="admin:iq:rpc">
        <commandname>logout</commandname>
        <commandparams xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="logout"/>
    </query>
</iq>
</code>

===== Scheme generation =====
Schema generation is supported by connector. It will generate these schemas:

**\_\_ACCOUNT\_\_**

{{:devel:documentation:systems:dev:icewarp_account_scheme.png?600|}}

**\_\_GROUP\_\_**

{{:devel:documentation:systems:dev:icewarp_group_scheme.png?600|}}

===== Managed user attributes =====

- **firstname**
- **lastname**
- **email** – email address
- **displayemail** – same as email
- **accounttype** - managed values: 0 = User, 7 = Group //(possible values: 0 - User, 1 - Mailing list, 2 - Executable, 3 - Notification, 4 - Static Route, 5 - Catalog, 6 - List server, 7 - Group)//
- **accountstate** – 0 = enabled, 1 = disabled (login), 2 = disabled (login, receive), 3 = spam trap
- **admintype** – user / admin:  0 = normal user, 1 = admin. It's important to add EAV selectbox "adminType" for using this attribute.

===== Supported operations =====

^ Object   ^ Operations  ^
| \_\_ACCOUNT\_\_  | CREATE, UPDATE, READ  |
| \_\_GROUP\_\_    | READ                  |