Integration with hMailServer (WebMail Pro 5 .NET)

WebMail Pro (ASP.NET) supports integration with hMailServer. This integration allows users to change passwords for their email accounts from within WebMail Pro interface. It also allows for using autoresponder feature.

Configuring access to hMailServer

The configuration file found at App_Data\settings\hmailserver.txt holds only two lines:

userpassword

Username and password of hMailServer administrative account should be supplied there. Default username is Administrator, password is supplied during hMailServer installation.

Deploying hMailServer DLL

Interop.hMailServer.dll (by default, found at C:\Program Files\hMailServer\Bin\) should be copied to bin subfolder of WebMail Pro.

Setting access permissions for the DLL

WebMail Pro is using COM object provided by Interop.hMailServer.dll mentioned above. The problem is that by default COM object can only activated by the following accounts:

• Administrator
• System
• Interactive

When you are running your ASP.NET account on Windows XP, your web application is running as the ASPNET account. The way to resolve this issue is to edit the DCOM configuration settings for the object.

• Go to the Start-Run menu item.
• Type in "DCOMCNFG" and hit enter.
• This should load the "Component Services" MMC (you can also load from "Administrative Tools - Component Services")
• Expand "Component Services"
• Expand "Computers"
• Expand "My Computer"
• Select the "DCOM Config" item
• Select the "hMailServer" item.
• Right click and select Properties
• Select the Security Tab and you should see the following:

• Under "Launch and Activation Permissions" select the "Customize" option.
• Click the "Edit" button

• Click the "Add" button to add a new account to the list.
• On the dialog that is displayed click the Locations button

(this is because by default your domain will be selected and we need a local account)

In this dialog scroll the list to the top (sometimes the first item is not visible) but scroll to the top and select the first item which is your computer name.

• Click the OK button
• On the dialog that is displayed enter "ASPNET" as the account name (make sure location is set to the name of the computer that IIS is on) on Windows XP or if you are running on Windows 2003 Server you must enter the account that the Application Pool is running as, by default "Network Service"

Note: A quicker way on Windows XP is to just enter the computer name and the account (ComputerName\ASPNET)

• Click the OK button
• Now make sure you select the following options for the "ASP.NET Machine Account" or the account that is the application pool identity ( by default Network Service)
  • Local Launch  : Allow
  • Remote Launch  : [blank]
  • Local Activation  : Allow
  • Remote Activation  : [blank]

These settings can be seen below:

• Click the OK button and make sure everything works fine.

Remember if you are running on Windows 2003 Server you must use the application pool identity as the account and not the ASPNET account.

WebMail Pro .NET

System Requirements ? Installation Instructions ? Upgrading Instructions ? FAQ ? Troubleshooting

Administration

Login Screen ? Domains ? Users ? Security ? Subadmins ? Licensing

WebMail

Common Settings ? Interface Settings ? Login Settings ? Database Settings ? Address Book Settings ? Calendar Settings ?Debug Settings

Integration

Visual integration with your web application ? Creating user accounts and logging in programmatically ? Integration with hMailServer ? How to configure reminders ? Outlook Sync Add-in

Customization

Creating your own skin ? Modifying columns in message list ? Adding toolbar buttons ? Adding menu item ? Adding language constant ? Translating to another language

Miscellaneous

Keyboard Shortcuts ? Support ? Credits ? License Agreement