Configuring Auto Login For Webmail
Posted by Gary Garber, Last modified by Milan Sykora on 27 June 2017 06:52 AM

Auto Login For Webmail

 

External login allows you to configure your Webmail in such configuration, that your login form (username & password) could be formatted into any page. For example like quick login from your main website (Ex. www.icewarp.com)

Please note, that bellow information is related to new external login for Webmail which is officially released in version 9.2 of IceWarp server.

 

External login kit

All you need for external login configuration is since beta version 9.1.1+ in folder: Icewarp\html\webmail\client\_external\

 

Files location

All files from Icewarp/html/webmail/client/_external/ should be placed in your external site folder structure.

 

 

External login configuration

 

login.html

Include the code of this file to the web page you wish to externally log in from into the WebMail Pro interface. No modifications of this file are required.

login.js

Edit only the line beginning with:
this.sClientUrl = 'http://localhost:32000/ 
where http://localhost:32000/ should be replaced by URL where Webmail is running and accessible.

 

login_auto.html

ONLY for IceWarp partners and resellers. Allows users to automatically login into demo accounts (disabled by default).

 

proxy.php.safe

For security reasons, this file has to be renamed to proxy.php.

This file is crucial for external login to work. If this file is not configured correctly, you will not be able to successfully login into WebMail Pro externally.
This file provides redirection from an external site to a running WebMail Pro site.
Lines you need to modify:
$host = "Icewarpdemo.com";

$path = "/webmail/server/webmail.php";
$port = 32000;
For $host, enter a short address (hostname) of your WebMail Pro installation (e.g. 127.0.0.1, domain.com).
For $path, enter the correct path to webmail/server/webmail.php file. If WebMail is running directly on the host address (domain.com/webmail), leave the default /webmail/server/webmail.php.
Parameter port is self-explanatory, enter the correct port for your webserver where WebMail Pro is running.

 

rsa.js

No modifycations to this file are required.

]]> -

- - - - - - - - - - <![CDATA[

How to manage skins in WebMail ?

 

Since version 9.2.

For purposes, when you i.e. would like to use individual logo for each domain running on your IceWarp server, you should follow next steps.

 

Managing skins in folder structure

go to IceWarp server installation folder\html\webmail\client\skins\skins.xml

If this file is not present in skins directory, please, create one similar to following:

<skins>
<item>
<default>Default</default>
</item>
</skins>

for adding new skin, you should add new line between <item></item> accordingly to folder name, which represents first tag and name is between.

Example:

<skins>
<item>
<default>Default</default>
<customSkinFolder>Custom Skin Name</customSkinFolder>

</item>
</skins>

In above mentioned example, I have added new skin, existing in "html\webmail\client\skins\customSkinFolder" folder and named "Custom Skin Name"

 

WebMail configuration part

After creating an association in folders structure of IceWarp Server installation folder, go to WebMail PRO administration interface and set there new skin in:

Options > Administrator Options > General tab > Global Settings > Skin

 

 

For IceWarp Server Version 12 please visit:

https://icewarp.zendesk.com/hc/en-us/articles/115009639688-External-login

 

Updated 05.08.2014, by Valentin