Documentation for Alt-N MDaemon

Remote Configuration

Setting up Remote Configuration. Using WebAdmin.

WebAdmin is an application designed to provide support for web-based remote administration of Alt-N Technologies software. WebAdmin includes extensive support for Alt-N's MDaemon® Server for Windows and MDaemon's integrated web-based email component, WorldClient®.

WebAdmin is a server application designed to run in the background on the same computer as the Alt-N Technologies software to be administered. To access WebAdmin you will simply open your browser and point it to the URL and port number on which WebAdmin resides (e.g. www.mywebadmin.com:1000). After providing your login credentials, you will be given access to various controls and settings within MDaemon and other Alt-N products. The type and number of settings to which you will have access is dependent upon the level of access given. There are three levels of access that can be provided to WebAdmin users: Global, Domain, and User.

• Global Administrators-Global administrators are users who have global access permission enabled under their account settings within MDaemon. Global access means that the user can see and configure every setting and control that is accessible via WebAdmin. Global administrators can add, edit, and delete users, domains, and mailing lists. They can edit product INI files, designate other users as Domain administrators, manage passwords, and do many other things; they have complete administrative control.
• Domain Administrators-Similar to Global administrators, Domain administrators have complete control over all users and product settings accessible via WebAdmin. Their administrative control, however, is limited to the domain or domains to which they have been given access. Domain administrators and the domains over which they have control are designated from within WebAdmin by a Global administrator, or by another Domain administrator with access to those domains.
• Users-The lowest possible level of WebAdmin access is User access. MDaemon users, for example, can sign in to WebAdmin and view their individual account settings as well as edit their MultiPOP entries, IMAP filters, auto responders, and so on. The type and number of settings that can be edited depends on the permissions given in each user's individual account settings.

For complete information on WebAdmin, see the WebAdmin User Manual. You can obtain the manual from www.altn.com.

WebAdmin

Properties

Enable WebAdmin server

Click this checkbox to enable the WebAdmin server. You may also enable/disable WebAdmin from the File menu or Statistics and Shortcuts frame of the main MDaemon GUI.

WebAdmin is running under IIS

When running WebAdmin under Internet Information Server (IIS) rather than the built-in web server, click this checkbox. This prevents certain GUI elements from being accessed which might otherwise cause conflicts with IIS.

For more information, see Running WebAdmin under IIS.

Run WebAdmin using this TCP port

This is the port on which WebAdmin will listen for connections from your web browser.

Sessions expire after xx inactive minutes

When you are logged in to WebAdmin, this is the amount of time that your session is allowed to be inactive before WebAdmin will close it.

Use cookies to remember logon name, theme, and other properties

Click this option if you want WebAdmin to store your logon name and certain other properties in a cookie on your local computer. Using this feature gives you a more customized login experience but requires that they have support for cookies enabled in your browser.

Require IP persistence throughout WebAdmin session

As an added security measure you can click this checkbox to cause WebAdmin to restrict each session to the IP address from which you connected when the session began. Thus, no one can "steal" the session since IP persistence is required. This configuration is more secure but could cause problems if you are using a proxy server or dial-up account that dynamically assigns and changes IP addresses.

Use HTTP Compression

Click this check box if you want to use HTTP compression in your WebAdmin sessions.

Bind WebAdmin's web server to these IPs only

If you wish to restrict the WebAdmin server to only certain IP addresses, specify those addresses here separated by commas. If you leave this field blank then WebAdmin will monitor all IP Addresses that you have designated for your Primary and Secondary Domains.

Restart WebAdmin (required when port or IIS value changes)

Click this button if you wish to restart the WebAdmin server. Note: when changing the port setting you must restart WebAdmin in order for the new setting to be recognized.

Running WebAdmin under IIS

WebAdmin is equipped with a built-in web server and therefore doesn't require Internet Information Server (IIS) to operate. However, it does support IIS, and can therefore function as an ISAPI DLL.

To configure WebAdmin 3.x to operate under IIS 5:

1. If WebAdmin is not yet installed, then during installation select the option, "I wish to use another web server for WebAdmin". If WebAdmin is already installed, then stop it from MDaemon's interface or using the "Stop WebAdmin" shortcut in the WebAdmin group under the Windows Start menu.
2. Open the IIS management program (Start Settings Control Panel Administrative Tools Internet Services Manager).
3. Right-click Default Website and then select New Virtual Directory.
4. Follow the Wizard as it takes you through the steps of creating a Virtual Directory. The following are suggested names and locations for data to be typed into the Wizard, but will vary depending on your installation of MDaemon and the location of WebAdmin.
5. 1. Alias: "WebAdmin". Click Next.
   2. Directory: "c:\mdaemon\webadmin\templates". Click Next.
   3. Click Next.
   4. Click Finish.
6. Set the Execute Permissions to Scripts Only.
7. Set the Application Protection to Low (IIS Process).
8. Click the Configuration button in the Application Settings section of the Virtual Directory tab.
9. On the Mappings tab click the Add.
10. In the Executable field enter "c:\mdaemon\webadmin\templates\WebAdmin.dll". Note: This field cannot contain any spaces. If the path contains a space it must be converted to 8.3 format. The dir /x command will show the 8.3 name for a file or directory.
11. In the Extension field enter ".wdm" and select the radio button for All Verbs.
12. Click the Script Engine box.
13. Click OK.
14. All other mappings can be removed if you choose, then click the OK.
15. On the Documents tab add login.wdm as a Default Document and remove all other entries from the list.
16. In MDaemon, go to Setup WebAdmin… and click Enable WebAdmin server and WebAdmin is running under IIS.
17. In WebAdmin URL type "/WebAdmin/login.wdm".
18. Click OK.

To configure WebAdmin 3.x to operate under IIS 6:

Create a new application pool for WebAdmin:

1. If WebAdmin is not yet installed, then during installation select the option, "I wish to use another web server for WebAdmin". If WebAdmin is already installed, then stop it from MDaemon's interface or using the "Stop WebAdmin" shortcut in the WebAdmin group under the Windows Start menu.
2. Open the IIS management program (Start Settings Control Panel Administrative Tools Internet Services Manager).
3. Right-click Application Pools.
4. Click New Application Pool.
5. In the Application pool ID field type "Alt-N" and click OK.
6. Right-click Alt-N
7. Click Properties.
8. Click Performance tab.
9. Clear "Shutdown worker processes after being idle for" and "Limit the kernel request queue".
10. Click Identity tab.
11. In the dropdown for Predefined, choose Local System.
12. Click OK.

13. Create a virtual directory for WebAdmin:

    1. Open the IIS management program (Start Settings Control Panel Administrative Tools Internet Services Manager).
    2. Right-click your web site and then select New Virtual Directory.
    3. Specify and alias for the virtual directory (for example, "WebAdmin).
    4. In the Path field, type the path to the WebAdmin Templates directory-for example, "C:\Program Files\Alt-N Technologies\WebAdmin\Templates".
    5. Leave the Read and Run Scripts options checked.
    6. Finish the wizard and right-click on the Virtual Directory that was created.

    7. Select Properties.

    8. On the Home Directory tab change the application pool to Alt-N.
    9. Click the Configuration button.
    10. Click Add to add an ISAPI extension mapping.
    11. In the Executable field enter the path to the WebAdmin.dll file. For example, "C:\Program Files\Alt-N Technologies\WebAdmin\Templates\WebAdmin.dll".
    12. In the Extension field enter ".wdm"
    13. Click the boxes for Script Engine and Verify the file exists.
    14. Click OK.
    15. All other mappings can be removed if you choose, then click the OK.
    16. Select the Documents tab.
    17. Ensure that Enable default content page is checked.
    18. Ensure that only "login.wdm" exists in the list.
    19. Click the Ok and exit the virtual directory properties dialog.

    20. Add .WDM to list of allowed web extensions:

        1. Click on the Web Service Extensions folder (in the IIS MMC).
        2. Click Add new web service extension.
        3. In the Extension name field enter "WebAdmin".
        4. Click Add and then browse to the WebAdmin ISAPI extension. For example: C:\Program Files\Alt-N Technologies\WebAdmin\Templates\WebAdmin.dll.
        5. Check Set extension status to allowed.
        6. Click OK.
        7. In MDaemon, go to Setup WebAdmin… and click Enable WebAdmin server and WebAdmin is running under IIS.
        8. In WebAdmin URL type "/WebAdmin/login.wdm".
        9. Click OK.
        

        WebAdmin's web server supports the Secure Sockets Layer (SSL) protocol. The SSL protocol, developed by Netscape Communications Corporation, is the standard method for securing server/client web communications. It provides server authentication, data encryption, and optional client authentication for TCP/IP connection. Further, because SSL is built into all current major browsers, simply installing a valid digital certificate on your server will activate the connecting client's SSL capabilities. If you choose not to run WebAdmin under IIS you now have this security built directly into WorldClient.

        

        The options for enabling and configuring WebAdmin to use SSL are located on the SSL & Certificates dialog (click Ctrl+L or Security SSL/TLS/Certificates… WebAdmin SSL). For your convenience, however, these options are also available on the WebAdmin dialog.