Home

MailGate User Manual

1. 3 4 5 6 Set the Host Name to the required host site address Set the User ID and Password as required to access the host Check Use Firewall on the Firewall Tab Set the Host Name on the Firewall tab to the IP address or name of your MailGate server Set the Port on the Firewall tab to the port used by the MailGate proxy Select the USER with no logon firewall type More Information Check our web site www mailgate com for more detailed information on configuring clients MAILGATE MANUAL Configuring Clients for MailGate 8 8 News Client Configuration News Client Configuration You use a News client to connect to a news server to make use of Internet Newsgroups News Proxy You will need to setup and enable a new Custom Proxy or modify the NNTP proxy installed with MailGate to be able to connect to your chosen news server first See NNTP Proxy on page 2 23 for more information This section covers setting up some common News programs to use the MailGate Server See the pages below for more information on how to configure that program Bal Anawave Gravity below Bal Forte Agent Free Agent below Bal News Stand below Bal Virtual Access on page 8 10 Anawave Gravity Configuration Select the View Menu and click on Options Select the Setup tab Enter the IP address or name of your MailGate server generally mailgate Enter name of your mail server Agent Free Agent News Configuration
2. Every DWORD MinRedial DWORD StartTime DWORD Type DWORD MAILGATE MANUAL Technical Reference Flag value indicating days of week that the schedule is active on with flag values as follows 1 Sunday 2 Monday 4 Tuesday 8 Wednesday 16 Thursday 32 Friday 64 Saturday Indicates whether the schedule is enabled or not O disabled 1 enabled Time the schedules active period ends value given as minutes from midnight Number of minutes between email collection sessions during the active period of the schedule Minimum time between redials in seconds Time the schedules active period starts value given as minutes from midnight Type of schedule as follows O Email transfer 1 Enable web proxy 3 Enable ftp gateway 4 Enable priority email trigger 5 Enable socks gateway 6 Enable RealAudio proxy 7 Outgoing email trigger 8 Liquid audio proxy 9 Connect permanently 10 Transfer email if present 11 Timeout override 9 40 Collection The collection key is used to store the list of pop servers to collect email from Under the schedules key Mailgate creates a key for each Pop collection entered These keys are named Collectiono Collection1 and so on for the required number of pop collection The data stored in each of these keys is the same as follows Value Name Data Type Account String Command String CmdMode CmdWait Field String
3. New Displays a sub menu for creating new Schedule Mailbox Url Filter and Custom Proxy list entries Enabled Check to enable the currently highlighted list entry Edit Edit the currently highlighted list entry Info Display information about the currently highlighted list entry Delete Delete the currently highlighted list entry Move up Move the currently highlighted list entry up in the list Move down Move the currently highlighted list entry down in the list MAILGATE MANUAL Using MailGate 2 2 Logging Menu The Logging menu contains options to manage your log files Purging Set how much historical data you wish to keep page 3 37 View Logs Start the MailGate log file viewer utility Logging Options Check options to define what data is written to the log files page 3 37 View Menu The View menu contains settings to customize your Administrator display Toolbar Check to display the Toolbar Status Bar Check to display the Status Bar Help Menu The Help menu contains items to help you use MailGate MailGate Help Access the help system Registration Display the MailGate Registration dialog page 4 1 Email for Support MailGate s in built email creator for support requests page 4 2 MailGate on the Web Some useful URL s page 4 3 About MailGate Display the About Screen MailGate Administrator Window Icons Manual Connection Icons e Click on this icon to force
4. Note Outgoing mail is stored in the QUEUE subdirectory under the MailGate system directory MAILGATE MANUAL Using MailGate 2 16 Using the Proxy Gateways Proxy Gateway Overview MailGate supports the following standard proxies e Web World Wide Web proxy and cache FTP File Transfer Protocol SOCKS version 4 and version 5 DNS Relay RealTime Audio Visual Liquid Audio In addition you can configure any number of Custom Proxies to provide a proxy capability for other applications For further information on using the proxies click see below 22 Using the Web Proxy below 22 Using URL Filters on page 2 18 Ba Using the FTP Gateway on page 2 19 Ba Using the SOCKS Gateway on page 2 19 23 Using DNS Relay on page 2 20 22 Using RealTime Audio Visual on page 2 21 22 Using Liquid Audio on page 2 22 Bal Using a Custom Proxy on page 2 22 Using the Web Proxy The Web proxy will pass HTTP protocol or browser requests to the Internet To use the Web proxy you should set your workstation browsers to Use a proxy server and specify the MailGate machine address to identify the proxy See the section on Configuring Clients on page 8 1 for guidelines You can control your users access to this service in a number of ways See the pages below on how this may be done 22 Require User Authentication on page 3 16 22 Using URL Filters on page 2 18 23 Setting Advanced Security on page 3 25 221 Using the Scheduler on page 2 25 MAI
5. Check the Enable DNS button if not already checked If you have Windows NT Server and DNS domains already setup please contact your system administrator for the name you should enter here If you enter a domain name here and do not have a DNS Server Wino5 will become confused and often ask to dial out for local machines It is recommended that you leave the domain name blank for peer to peer networks MAILGATE MANUAL Network Preparation 7 5 Setup LMHOSTS and HOSTS files for Windows 95 98 The LMHOSTS and HOSTS files are used to map specific IP addresses to a machine name In a simple network setup these contain the same information but are used by different programs If you are using static addressing using just IP numbers then you can ignore these settings LMHOSTS is used by the NetBEUI protocol to map machine names and IP addresses HOSTS is used by the TCP IP protocol to map machine names and IP addresses Note the HOSTS files may have multiple names for the same IP address These files are located in the directory where you have installed Windows 95 There are sample files in this directory called LMHOSTS SAM and HOSTS SAM for you to refer to Setup peHOS TS and HOSTS Create the LMHOST and HOSTS files on one machine as described below 2 Make sure the HOSTS file has the extra line for localhost and MailGate machine as described below 3 Copy the LMHOST and HOSTS file to all other machines in the network Windows NT
6. FilterEx String Array LeaveDays DWORD Mapping String Password String RemoveString String Server String MAILGATE MANUAL Technical Reference Description Pop account to collect from stored as an encrypted string External command to run during collection process or blank string if no command to run When the command is to run values as follows o Run before starting pop collection 1 Run after pop collection 2 Run instead of pop collection Controls whether or not Mailgate waits for the external command to complete before continuing with collection process 0 Don t wait 1 wait Custom routing field in message headers to search for or blank if standard Mailgate routing logic to be used List of wildcard pattern match strings to filter email addresses against Email addresses that don t match any of the pattern strings are dropped Number of days to leave collected email on the pop server before deleting it String to map email address or domain part of address to the given string Password for the pop account to collect from Stored as an encrypted string String to be removed from the email addresses extracted during collection Ip address or name of the pop server to collect email from 9 41 Proxies The proxies key is used to store the list of custom proxies configured in Mailgate Under the proxies key Mailgate creates a key for each custom proxy configured These
7. I O function operates in text mode the default the source or destination stream is assumed to be a sequence of multibyte characters Therefore the Unicode stream input functions convert multibyte characters to wide characters as if by a call to the class op gt mbtowc function For the same reason the Unicode stream output functions convert wide characters to multibyte characters as if by a call to the class op gt wctomb function class op b Open in binary untranslated mode translations involving carriage return and linefeed characters are suppressed Controls sharing of the file with other processes whilst open by the calling process Can be one of the following values o or 16 deny read and write access 32 deny write access 48 deny read access 64 deny none Return Type Integer Operation Opens the file and returns a value to be used as the file handle in the other file functions Returns zero if error MAILGATE MANUAL Technical Reference 9 17 Function Fclose lt Handle gt Parameters A file handle value returned by the fopen function Return Type Logical Integer Operation Closes the file Note that all files opened by a script will automatically be closed when the script session terminates Function Feof lt Handle gt Parameters A file handle value returned by the fopen function Return Type Logical Integer Operation Checks if at the end of the passed file Returns
8. LiquidAudioWriteTimeout DWORD LocalDomainsEx Multi String LogFilePurgeDays LogFilePurgeEnabled Logging DWORD MAILGATE MANUAL Technical Reference Sets the maximum number of requests that a http socket session will allow using keep alive Default value is 5 Last message id used for internally generated email messages Value is incremented after each auto generated message The license key for this installation of Mailgate Binding setting for Liquid Audio proxy service O no interface binding any other value stores the interface address as a 32 bit binary value List of name or ip address pattern match strings indicating which clients are denied access to the Liquid Audio service List of name or ip address pattern match strings indicating which clients are permitted access to the Liquid Audio service Timeout for socket read operations by the Liquid Audio proxy service value given in seconds Idle disconnect time for the Liquid Audio proxy value in seconds Timeout for socket write operations by the Liquid Audio proxy service value given in seconds List of email domains to be treated as local Indicates the number of days log files remain in the log directory before being auto deleted Indicates whether log file purging option is enabled or disabled o disabled non zero enabled Set of bit flags indicating what information is to be written to the log file 1 Errors 2 Warnings 4 In
9. MAILGATE MANUAL 4 Select the Options menu and click on General Preferences Select the System tab Enter the IP address or name of MailGate server generally mailgate Enter name of your mail server More Information Check our web site www mailgate com for more detailed information on configuring clients Configuring Clients for MailGate 8 9 News Stand Configuration 1 Select the Tools menu and click on Options 2 On the Connections tab select Use a LAN connection 3 On the Network tab under the Host News Server entry enter the MailGate server IP address or name generally mailgate Virtual Access News Configuration In version 4 0 configure your main ISP connection 1 Select the File menu and click on Comms Settings 2 Select your ISP from the service list 3 Onthe NEWS tab enter the IP address or name of your MailGate server as the news server In MailGate configure an NNTP proxy to connect to your ISP More Information Check our web site www mailgate com for more detailed information on configuring clients MAILGATE MANUAL Configuring Clients for MailGate 8 10 9 Technical Reference Using Wildcards Using Wildcard Expressions Some entries in MailGate allow the use of wildcard patterns rather than creating long lists When creating these entries you can use special characters to control the matching process The following can be used within MailGate to create wildcard patte
10. regquerystr lt hive gt lt key gt lt value gt regsetval lt hive gt lt key gt lt valuename gt lt value gt regsetstr lt hive gt lt key gt lt valuename gt lt value gt Event Log Functions logevent lt message gt debug lt string gt Custom Proxy Script Functions Control Functions connect lt server gt lt port gt proxy Client Communication Functions write lt message gt readch readIn lt termination gt read lt count gt Proxy Communication Functions pwrite lt message gt preadch preadIn lt termination gt pread lt count gt MAILGATE MANUAL Technical Reference 9 10 Function Length lt String gt Parameters Value Type Description lt String gt string String to get length of Return Type Integer Operation Returns the length of the passed string expression as an integer value Function Left lt String gt lt Count gt Parameters lt String gt string String to extract left portion from Number of characters of lt string gt to return Return Type String Operation Returns a string of the lt count gt leftmost characters from lt string gt If the length of lt string gt is less than lt count gt the whole of lt string gt is returned Function Right lt String gt lt Count gt Parameters String to extract right portion from Number of characters of lt string gt to return Return Type String Operat
11. FtpBinding DWORD FtpDenied Multi String FtpEnable DWORD FtpPermitted Multi String FtpProxyPort DWORD FtpReadTimeout DWORD FtpTimeoutEx DWORD FtpWriteTimeout HistorySize DWORD HttpBinding DWORD HttpDenied Multi String HttpEnable DWORD HttpKeepAlive DWORD HttpPermitted Multi String MAILGATE MANUAL Technical Reference Binding setting for Ftp gateway service O no interface binding any other value stores the interface address as a 32 bit binary value List of name or ip address pattern match strings indicating which clients are denied access to the ftp gateway Controls whether the Ftp gateway is enabled or not O disabled 1 enabled List of name or ip address pattern match strings indicating which clients are permitted access to the ftp gateway Socket port number that the Ftp gateway listens on normally 21 Timeout for socket read operations by the Ftp gateway service value given in seconds Idle disconnect time for the Ftp gateway value in seconds Timeout for socket write operations by the Ftp gateway service value given in seconds Number of connections Mailgate keeps in the History list display Value not normally present and defaults to 25 If you wish to change the size of the history list manually add this value using the registry editor and set the value to the required number of entries Binding setting for Http proxy service O no inter
12. Outgoing Mail Server enter the IP address or name for the MailGate server machine 3 Incoming Mail Server enter the IP address or name for the MailGate server machine 4 Account name enter the name for your mailbox in MailGate 5 Password enter the password used for your mailbox in MailGate If you have chosen to use NT passwords in MailGate then you should check Logon using Secure Password Authentication 6 Connection Set this to using a Local Area Network LAN You will probably also want to adjust the Check for new messages setting in the Tools Options screens to a shorter time MS Internet Mail Configuration Select the Mail menu and click on Options Select Server tab Fill in Name Organization and email address Under Servers fill in the local IP address or host name of the MailGate server usually mailgate in both the outgoing mail and incoming mail slots 5 Under Logon settings If you configured MailGate to use NT password authentication then select Logon using secure password authentication otherwise select Logon using and fill in the name of your mailbox and your password on the MailGate server PUPP Eudora Mail Configuration m Select the Tools menu and click on Options 2 Select Getting started fill in your pop account details Note Eudora requires a fully qualified mail name popname your_ISP will work correctly for machines on workgroups that are not part of a domain Add Real na
13. To assist with you initial setup you can run the MailGate Wizard You will be prompted with this option every time you start the MailGate user program until you either choose not to MAILGATE MANUAL Getting Started 1 11 use the wizard or complete the process You can also run this wizard at any time by selecting it in the MailGate Start Programs entry You may also configure MailGate using the setup screens available in the user interface See Configuring MailGate on page 3 1 for more details We strongly recommend you take a look through the section Using MailGate to understand the configuration options available before proceeding Client Configuration MailGate is designed as a server based program To make use of the facilities you will need to install client software on your user machines Any client program which uses the Internet standards supported by MailGate can be used be used In general you will need to configure the following settings Mail Clients You should set both the POP3 and SMTP server addresses to the MailGate machine IP address The account user name and password should be the users mailbox name and password Web Browsers You should set the browser to connect using a LAN and to use a proxy server Set the proxy server address for all protocols to the MailGate machine address and HTTP port FTP Clients Set these to use a proxy or firewall and set the address to the MailGate machine MailGate will expe
14. following 1 Click on the Start Menu and select Settings and from the Settings menu select Control Panel 2 From the Control Panel window select Networks MAILGATE MANUAL Network Preparation 7 11 3 On the Network dialog select the Services tab and look for Remote Access Service If it is listed go to Configure your ISP below If Remote Access Service is not listed 1 You will need to obtain the NT Installation CD ROM 2 On the Service tab press the ADD button and select Remote Access Service 3 Follow the instructions from the NT setup program 4 If connecting by a modem to your ISP you will also need to install a modem if you have not done so previously gt Configure DUN for your ISP After Remote Access Service DUN is installed you will need to configure an entry for connecting to your ISP 1 Select the Dial Up Networking icon on your system rasphone exe 2 Press the New button and follow the instructions of the Wizard Tips for Dial Up Networking Configuration Check with your ISP for complete information for your connection 1 You may need to specify the DNS servers for your ISP in the TCP IP configuration 2 You will need to select whether you are assigned an address when you logon most services or have a specific IP address 3 You may need a logon script for your ISP Many service providers already have these scripts written and available MAILGATE MANUAL Network Preparation 7 12 Checklist for
15. made in the Security Tab see 3 25 for the standard proxy gateways Use the Bind Port setting to bind this proxy to your local lan IP address This setting can be used in two ways 1 With the Bind Port box checked the Local Interfaces entry will change to only allow a single IP address This is similar to the settings made in the Bindings Tab see 3 28 for standard proxy gateways This method is binding in the true sense 2 With the Bind Port box NOT checked you can enter you can enter more than one IP address on per line through which this proxy may be accessed in the Local Interfaces field This is not binding in the true sense but access is managed internally by MailGate NOTE You can have both methods configured with addresses As the true binding IP address is not normally displayed you should check this setting if you have problems connecting to your Custom Proxy Availability Use the Proxy is active on settings to define when this proxy may be accessed This is similar to the settings that may be made using the scheduler see 2 25 Timeouts Set the required timeouts for this proxy Check The Proxy uses the Dialup Connection if you want MailGate to connect to your ISP to satisfy requests passed to this proxy O For your client applications to use a MailGate Custom Proxy you will need to set them to connect to the MailGate machine when making Internet requests Refer to the supplier of your application to und
16. 08 21 00 11 00 00 Connecting to pop server pop mynet net account tes a 08 21 00 11 00 01 1 new messages to collect amp 08 21 00 11 00 02 Message collected for steve mynet net ge Scheduled mail collection started at 13 00 on 21 4ug 00 y gt WkStns 0 Dgram O nous 4 Figure 5 MailGate Administration Window Ready MAILGATE MANUAL Using MailGate MailGate Administrator Window Menus Gateway Menu The Gateway menu contains the main configuration options Setup The main Setup dialog page 3 3 Advanced Setup System security and Timeout settings page 3 25 Large Pop Message Control Settings to manage the collection of large mail messages page 3 35 Backup Configuration Backup your settings to a file page 3 34 Restore Configuration Restore your backed up settings page 3 34 Load Accounts Create mailboxes from a text file page 3 36 Manual Connect Force MailGate to make a mail exchange Disconnect Force MailGate to disconnect Startup Minimized When checked the Admin program will start in a minimized state Run as Service When checked the MailGate processing program will run as a background service Start Gateway Service Start the MailGate processing program Stop Gateway Service Stop the MailGate processing program Exit Leave the Administrator Program Edit Menu The Edit menu contains options to change certain settings
17. 1 TRUE if position is end of file or zero if not Function Ftell lt Handle gt Parameters A file handle value returned by the fopen function Return Type Integer Operation Returns the current position in the passed file Returns 1 if error occurs MAILGATE MANUAL Technical Reference 9 18 Function Ferror lt Handle gt Parameters A file handle value returned by the fopen function Return Type Integer Operation Returns the current error state of the passed file Returns zero if no error Function Fread lt Handle gt lt Count gt Parameters A file handle value returned by the fopen function Number of bytes to read from file Return Type String Operation Returns a string buffer containing the requested number of bytes from the passed file If an error occurs or there are not enough bytes available in the file the returned string may be shorted than the requested count Use feof and ferror to determine further information if this occurs Function Fwrite lt Handle gt lt Message gt Parameters A file handle value returned by the fopen function Buffer to write to file Return Type Integer Operation Writes the passed buffer to the passed file Returns the number of bytes written which if write successful will be the length of the passed string If an error occurs the returned value may be less than the length of the passed string MAILGATE MANUAL Technical Refer
18. Enabled Send OK Cancel Help Figure 11 Details for POP Account Setup gt POP Collection Mode For a standard POP collection you will need to complete e the account name e the password for this account e the POP mail server to collect from These details will have been supplied by your ISP You should select the Login Method to use Most ISP s require the standard User Pass method If in doubt you should try this setting first You may also set the Leave Mail on Server option This option allows mail that you ve collected to be retained on your ISP s mail server for the specified number of days This can be used as a backup or to allow you to collect the mail from different locations such as at home and the office There are three options e oto delete mail immediately after collection e 1 30 for number of days to leave on the server MailGate will automatically manage a list of the mail it has collected e 1to leave the mail on the server forever Note this may be a problem with some ISPs if the mailbox size gets very large MAILGATE MANUAL Configuring MailGate 3 6 Using this option requires your ISP to support the UIDL command for mail tracking If it is not working please consult your ISP b Optional Settings There are a number of optional settings which can be made to help adjust the mail routing process to allow for the range of different processes used by ISP s To fully understand
19. IP gt external Check to require SMTP clients with allowed IP addresses to use authentication when sending e mail to an external domain address Authentication required for invalid IP gt local Check to allow SMTP clients with denied IP addresses to send e mail to a local domain address if the client uses authentication Authentication required for invalid IP gt external Check to allow SMTP clients with denied IP addresses to send e mail to an external domain address if the client uses authentication Note If full access to the SMTP service is blocked in either the Security 3 25 or the Bindings 3 28 tabs these will take precedence over the SMTP relay settings MAILGATE MANUAL Configuring MailGate 3 32 NT Users Tab This tab is only available when MailGate is installed on Windows NT or 2000 When enabled MailGate will use the NT user database to obtain the passwords for each mailbox If using NT domain account validation make sure that each mailbox you create has a matching Windows NT domain account or that no one will be able to collect the mail from that mailbox You must specify the NT Domain to query when checking a mailbox password Using Windows NT domain accounts is more secure but less flexible than storing the password within MailGate MAILGATE MANUAL Configuring MailGate 3 33 Backup and Restore Configuration The MailGate configuration information is stored in the Windows registry You can
20. Internet Service Provider gt Install Software Check to see if Dial Up Networking is installed You can do this by double clicking on My Computer If it is installed you will see a folder called Dial Up Networking If Dial Up Networking is not installed do the following Start Menu click on Settings and then Control Panel Choose the Add Remove Programs option Click on the Windows Setup tab Select the Communications option and click Details Put a check in the box next to the Dial Up Networking Option Configure DUN for your ISP After Dial Up Networking is installed you will need to configure an entry for connecting to your ISP 1 Select The Internet icon on your desktop 2 Follow the instructions of the Wizard Diego NS MAILGATE MANUAL Network Preparation 7 7 Q Tips for Dial Up Networking Configuration Check with your ISP for complete information for your connection 1 You may need to specify the DNS servers for your ISP in the TCP IP configuration 2 You will need to select whether you are assigned an address when you logon most services or have a specific IP address 3 You may need a logon script for your ISP Many service providers already have these scripts written and available Windows NT Network Preparation Windows NT Network Preparation You will need the following information 1 The TCP IP addresses and machine names optional for all machines in the network 2 Your domain name optio
21. MailGate 3 15 The Web Tab Figure 17 Web Tab Check the Enable HTTP Proxy option to enable the MailGate web proxy service gt Optional Settings Authenticate Proxy Users If checked this option requires users to enter a logon and password before they can use the web proxy service The logon names and passwords available are set by the MailGate mailbox names and their passwords ISP Proxy Server Instead of MailGate connecting directly to a target host web site you may prefer to use your ISP s Proxy server if available You may also select which protocols are passed through this server and which should make a direct connection Using an ISP s proxy can improve performance but may give some reliability problems Run HTTP Proxy on port If you have a local web server running on the same machine as MailGate it may be using the standard HTTP port Port 80 As only one application on a machine can use a port you will have to run the MailGate Web proxy on a different port The standard one for this situation is 8080 Ensure you set your client programs to connect to MailGate on your alternative setting MAILGATE MANUAL Configuring MailGate 3 16 Disconnect After Once a connection has been made with your ISP MailGate will monitor the session activity If there is no activity for the Disconnect Time period then MailGate will request the connection be closed The default period is 120 seconds If MailGate is making frequen
22. Saturday and Sunday Set the minimum call to 0 5 5 minutes Set the timeout to 0 30 30 seconds Set the start time to 00 00 and the end time to 23 59 Check the schedule enabled box MAILGATE MANUAL Using MailGate Using the Connection History Using the Connection History When MailGate connect to your ISP it creates a log of the session activity This log is displayed in the main MailGate window under Connection History and is stored in the LOG subdirectory as the file HISTORY DAT The log is automatically purged and shows the last 25 connections Icons in the connection history display information about the connection ge Indicates an error in the connection oy Indicates there was no error in the connection The action had an error The action completed successfully This log is a summary of the activity only Full details of the connection can be found in the main MailGate log files See Logging on page 3 37 for more information MAILGATE MANUAL Using MailGate 2 30 Using Extensions to MailGate There are a number of optional extension module which can be used to add to the capability of MailGate For details of the current options and their functionality visit our web site www mailgate com When an extension is installed in will appear in the Extensions section of the MailGate administrator screen To configure the extension highlight it and select Edit Edit or double click on the icon For full details s
23. Web Gateway Dns Relay RA Gateway LA Gateway Set an admin access password to get MailGate to prompt for the password when started or activated from the minimzed state Admin access password OK Cancel Help Figure 24 Security Tab The security tab allows you to set allow or deny access to each of the standard functions in MailGate This access check is made before all other checks You can set similar access rights on any custom proxies see the Custom Proxy detail page 3 47 for more information To set the access rights select the service you wish to configure and this will display the Allow or Deny access dialog You should ensure after installing MailGate you set security options using either these settings or the Bindings 3 28 settings or a combination of both to at least prevent unauthorised access to your system by external users b Admin access password You can optionally set a password here which will be required to access the MailGate administrator program MAILGATE MANUAL Configuring MailGate 3 25 Allow or Deny Access Use this dialog to set the access rights for the current service You may either explicitly allow or deny access by machine IP address You can also use wildcards see 9 1 and set an address pattern In addition to the standard wildcards there are two special notations for specifying IP address ranges for this setting To specify all addresses in a subnet
24. and obtain their Internet address dynamically each time they connect to their Internet Service Provider This assigned number is only used during the connection and is not the same as the numbers for your local network Within your local network you can use the following network numbers if you do not have an assigned number 192 168 0 x 10 0 0 X The x part of the number is used for each individual machine with the range 1 254 Note When using these addresses the Subnet Mask is always 255 255 255 0 Domain Name A domain name groups computers together If you use static addressing and refer to each machine by IP number this is not required For simple networks this can be the same as the Workgroup name and all machines in the network have the same domain name For complex networks running NT Server with specific domain setup consult your network administrator Machine Names In addition to having a unique TCP IP address each machine can have it s own name If you choose to use machine names you will need to setup a method for your machines to convert these names to IP numbers This can be done using HOSTS files or a DNS or WINS server This is the name you will see in the Network Neighborhood display Machine names are generally one word with only letters and numbers alphanumeric and should be limited to a maximum of 12 characters on Windows machines Spaces and underscores and hyphens should be avoided in machine na
25. be deleted or forwarded after the auto response What will be the default local mailbox and who will read it eN ANA A ie How do you want to handle large messages Figure 8 Checklist for Mail Box Planning MAILGATE MANUAL Using MailGate 2 15 Using the Outgoing Queue Outgoing Queue The Outgoing Queue shows all mail that is waiting to be sent the next time MailGate connects For each mail message the following is displayed a Who sent the message FROM field b The intended recipient TO field c The date the message was put in the queue d The size of the message gt Delete Message from the Queue You can not edit a message once it is in the outgoing queue but you can delete it 1 Select the mail message 2 Select the Edit menu and click on Delete 3 Confirm that you want to delete the message gt Requeue if Errors If there is a problem sending a mail message MailGate will requeue the message and try on the next connection gt Information about Outgoing Messages You can get some additional information that is very useful for tracking errors In addition to the standard information shown you can highlight an outgoing message and use Edit Information to display the Queued Message dialog see 3 44 with the following e Queued when the messages was re queued for sending after an error e Last tried the last time MailGate tried to send the message e Last error the last error message
26. create a backup file of this information and restore it if needed You can also use this facility to move MailGate from one machine to another Backup Configuration gt Backup MailGate configuration 1 Select the Gateway menu and click on Backup Configuration 2 Use the dialog box to select where to place the backup file 3 Enter a filename for the backup and make sure the file ends with MGB 4 Press the OK button Restore Configuration Restore a Configuration This option will overwrite ALL your current settings with those contained in the backup file 1 Select the Gateway menu and click on Restore Configuration 2 Use the dialog box to locate the previously saved configuration 3 Press the OK button Move MailGate to another computer You can use backup and restore if you need to move MailGate to another computer 1 Backup the current configuration 2 Install MailGate and any extension modules on the new computer Do not configure this installation 3 Copy the configuration file MGB to the new computer 4 Restore the configuration file on the new computer MAILGATE MANUAL Configuring MailGate 3 34 Large POP Message Control Large POP Message Control MailGate lets you defer collection of messages over a specified size You can then review the list of large messages and decide whether to collect or delete them gt To specify size and action 1 Select Gateway Large POP Message Control to open the Large POP
27. ess acest aii 70 2 The Ment BOVE EAEE AE dead 70 2 Selecting the Fileto VIC E E ane ae E A a 10 3 USNE LIND AAEE IE A al bid 10 3 USTMEA MIES LA A A ida 10 3 LHe File Display NARA WA A a a 10 4 CONRMNUOUS MONLOTIA LL tias 10 4 LSIQUIING a Remote VIC WE dd L0 5 Using ARNET NC a ainia L0 5 11 GLOSSARY OF TERMS ooccccccononncononncnnnnnocinonncnncononnonncnonononccnnconcnncnn conoce osnovo veao oa rones ron coc e non ron cocoa res 11 1 NO NO 11 1 MAILGATE MANUAL Contents F FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU FIGU igures RE 1 SIMPLE MAI SERVER rioei cd cartes dacebcn cee buh ces seb o aida 1 2 RE 2 SIMPLE PROXY SERVER wick ceca ceidhcdecasves duced baseecch usta tub ia 1 5 RE 3 GATEWAYS AND PORTS a a ao a aoa Sienas 1 6 RE 4 MAILGATE LISTEN AND REDIRECT OF PORTS oooocccccccncnnncnnnnnnnnononononononononononononononnonononnnnnnnnnnnnonononinonoss 1 7 RE 5 MAILGATE ADMINISTRATION WINDOWo cccccccccccccncnonononononononononononononononononononononononononononononononenoneneneness 2 1 RE 6 SIMPLE MAIL ROUTING is 2 11 RE 7 ADVANGED MAM ROUTING amp a etic 2 11 RE 8 CHECKLIST FOR MAIL BOX PLANNING occccccccccconononononononononononononononononononononononononononononononononeneneneneneso 2 15 PENA AB cas 3 3 RETO POP I 15 Seen is 3 5 RE 11 DETAILS FOR POP ACCOUNT SETUP oococccc
28. for more information MAILGATE MANUAL Using MailGate 2 13 Maintaining Mailboxes After you have planned your local mailboxes you need to actually create them and set any options e Create New Mailbox a Click on the above toolbar icon or select the Edit menu click on New and select Mailbox b Enter the name for the local mailbox c Enter the password and then re enter in the confirmation box For more information see MailBox Settings Once you have created local mailboxes you may want to change or remove them later Edit a Mailbox a Select the mailbox to edit b Double click on the mailbox name or select the Edit menu and click on Edit Delete a Mailbox a Select the mailbox to delete b Select the Edit menu and click on Delete c MailGate will ask you to confirm deletion of the mailbox which includes deleting any unread mail Tip If you have a large number of mailboxes to create you can use a text file to enter the accounts See Load Accounts on page 3 36 for more information MAILGATE MANUAL Using MailGate 2 14 Checklist for Mail Box Planning Task What remote mailboxes do you have from your ISP Which remote mailboxes at your ISP should go to which local mailboxes in MailGate Should any special patterns be set for sorting into local mailboxes Should any mail be copied from one local mailbox to another local mailbox Should any local mailbox be autoresponded to Should mail
29. keys are named Proxyo Proxy1 and so on for the required number of proxies The data stored in each of these keys is the same as follows Value Name Data Type Binding DWORD ConnectPort DWORD ConnectServer String Days DWORD Denied Multi String Description String Enabled DWORD EndTime DWORD Interfaces Multi String MAILGATE MANUAL Technical Reference Description Binding setting for the custom proxy 0 no interface binding any other value stores the interface address as a 32 bit binary value Port number that proxy connects or forwards datagram packets to Ip address or name of system that proxy connects to or forwards datagram packets to Flag value indicating days of week that the custom proxy is active on with flag values as follows 1 Sunday 2 Monday 4 Tuesday 8 Wednesday 16 Thursday 32 Friday 64 Saturday List of name or ip address pattern match strings indicating which clients are denied access to the custom proxy String describing the purpose of the custom proxy Indicates whether the custom proxy is enabled or not O not enabled 1 enabled Time the proxy s active period ends value given as minutes from midnight List of interface ip addresses that the custom proxy listens on 9 42 ListenPort DWORD Permitted Multi String ReadTimeout DWORD Script DWORD ScriptFile String StartTime DWORD Timeo
30. mail mailgate com will prevent this address from being accepted Remove Occurrences of This option allows you to specify a string to be removed before the mail address is processed Some ISP or mail systems may add additional data to the normal MAILGATE MANUAL Configuring MailGate 3 7 mail address for security or system purposes This option allows the additional string to be removed before processing by MailGate Map Address This option is used mainly with LAN forward option on page 3 14 to allow the mail address to be manipulated before forwarding The Map Address setting allows the alteration of email addresses extracted from the collected messages using the following rules If the setting is blank no alterations are done If an email domain is specified such as mydomain com or mydomain com then the domain part of each address is replaced with the domain name specified in the map address option If the setting is a complete email address such as tech mydomain com then every email address is replaced with the address specified in the map address option gt Run External Command This option gives the ability to run a program or script as part of a mail collection For example to finger a SMTP server The command can be set to run e Before the POP Collection e After the POP Collection e Only run the command With this POP account need be specified and no collection will be done The Wait check box cont
31. message dialog box 2 Set the maximum message size to collect in kilobytes 3 Specify whether to notify the administrator and or the recipient of the large message The following message is delivered to the recipient or MailGate administrator when a message is deferred There is a ok message for you pending on pop server YOUR SERVER NAME account YOUR ACCOUNT NAME which is larger than the max download message setting Your MailGate administrator should be contacted if you require that it is collected and delivered to your account To help determine the message origins the header and first 25 lines follow lt Header and text is then displayed from the message gt To Collect or Delete Large Messages 1 Select Gateway Large POP Message Control to open the Large POP message dialog box 2 Select a message and use the right mouse button to display the menu 3 Select to collect the message or delete it on the next connection Note The email address of the MailGate administrator is the System Reports to setting in Email Tab on page 3 11 MAILGATE MANUAL Configuring MailGate 3 35 Load Accounts Load Accounts If you have a large number of mailboxes to create you can create a list of them and import that list into MailGate gt Create a text file First you need to create a file with the name of each mailbox on a separate line then a comma and the password like this username password Save the file with the
32. no interface binding any other value stores the interface address as a 32 bit binary value List of name or ip address pattern match strings indicating which clients are denied access to the Smtp service Controls whether the Smtp service is enabled or not o disabled 1 enabled Name or ipaddress of Smtp server at ISP to be used for passing all outgoing email to Controls if MailGate should check for a From address Some email clients responding to a Read Receipt send an acknowledgement with no From address As many ISP servers will not accept these messages MailGate by default will not accept them Use this setting to bypass the check o check enabled 1 check disabled List of name or ip address pattern match strings indicating which clients are permitted access to the Smtp service Timeout for socket read operations by the Smtp service value given in seconds List of name or ip address pattern match strings indicating which clients are denied access to use the smtp server to relay email to external addresses List of name or ip address pattern match strings indicating which clients are permitted access to use the smtp server to relay email to external addresses 9 37 Registry Parameters cont SmtpSendDelay DWORD SmtpSendPort DWORD SmtpServerPort DWORD SmtpWriteTimeout DWORD SocksBinding DWORD SocksDenied Multi String SocksEnable DWORD SocksHttpDivert DWORD So
33. on page 8 5 Bal Agent Free Agent on page 8 6 22 Virtual Access on page 8 6 MS Outlook Express Configuration MAILGATE MANUAL Select Tools then Accounts on the menu and click on the Mail tab Click on Add and choose Mail to activate the new account wizard or change your existing account details to include the following settings 1 E mail address enter your own address 2 Myincoming mail server is select POP3 3 Incoming Mail Server enter the IP address or name for the MailGate server machine 4 Outgoing Mail Server enter the IP address or name for the MailGate server machine 5 Account name enter the name for your mailbox in MailGate 6 Password enter the password used for your mailbox in MailGate If you have chosen to use NT passwords in MailGate then the password is your NT login password and you should tick Logon using Secure Password Authentication 7 Connection Set this to using a Local Area Network LAN You will probably also want to set this account to be the Default account and adjust the Check for new messages setting in the Tools Options screen to a shorter time Configuring Clients for MailGate 8 4 MS Outlook Configuration Select Tools then Services on the menu If you already have an Internet E mail service you can change this otherwise click on add to add this service Set or change your existing service details to include the following settings 1 E mail address enter your own address 2
34. or not to purge pages from the cache 0 don t check 1 check Can be used to set an alternative file an image for the web proxy error page This value is not normally present and defaults to logo gif If you wish to change the setting add the setting using the registry editor Can be used to set an alternative file for the web proxy error template file This value is not normally present and defaults to errors html If you wish to change the setting add the setting using the registry editor Indicates whether or not the Custom Proxy branch of the main display window is expanded or not Used by Mailgate to re establish the display at startup to the same state it was in when last run 0 not expanded 1 expanded As ExpandCustom for the Url filters branch As ExpandCustom for the History branch As ExpandCustom for the Mailboxes branch As ExpandCustom for the Queue branch As ExpandCustom for the root of the tree As ExpandCustom for the Schedules branch Array of strings giving names of extensions currently present The first character is either a 1 or O indicating whether the extension has been enabled or disabled This information is generated automatically An array of wildcard pattern strings and server to forward to Each email received is compared against these strings and if match the email is queued for SMTP forwarding to the corresponding server address 9 29 Registry Parameters cont
35. proxies MAILGATE MANUAL Configuring MailGate 3 2 Gateway Setup Gateway Setup The Gateway Setup section contains the screens for most of MailGate s operational settings Dialup Tab Dialup POP paa EMail ER a E WEB j i Select the Dialup Networking item that you have ao configured for connection to your Internet Service Provider If you are using a lan connection then select lt No Dialup gt Dialup entry lt No Dialup gt Backup Dialin account Dialin password Excessive connection alert Configure Pre dial command JZ Wait for completion Post dial command IM Wait for completion Figure 9 Dialup Tab Connection Method The Dialup Tab specifies the primary method to connect to the Internet and an optional backup connection For leased lines or open connections to your ISP specify lt No Dial Up gt as the DUN entry See Backup Dialup Entry on page 3 4 for more information on alternative connection to use The account name and password are the information from your ISP to logon to your account gt Pre dial and Post dial Command The pre dial and post dial command options allow you to specify any command to happen before or after dialing your connection Check wait for completion to make sure the command s complete before the next action See Excessive Connection Alert on page 3 4 for information on closing the connection after a specified time MAILGATE MANUAL Configu
36. proxy system equipped with security auditing management fault tolerance and alarm notification SOCKS is often used for a firewall TCP IP Transmission Control Protocol Internet Protocol is the protocol used for sending information between computers connected to the Internet URL Uniform Resource Locator A consistent and structured way of writing machine names or addresses of specific types that is used and understood by most internet software World Wide Web addresses take the form http address or http ip_address FTP addresses take the form ftp address MAILGATE MANUAL Glossary of Terms 11 4
37. range Enter lt any address in the desired subnet range gt lt the number of bits used for the subnet gt Example 192 168 0 1 24 With this example the first three octets form the subnet and the entire last octet is assignable The range of addresses is therefore similar to 192 168 0 Example 192 168 0 32 27 With this example the first three octets and the first 3 bits of the last octet form the subnet and only the last 5 bits of the last octet are assignable The range of addresses is therefore 192 168 0 32 to 192 168 0 63 because the range is for the 32 addresses of which 192 168 0 32 is a member To specify a specific range of addresses Enter lt starting address in the desired range gt lt the number of bits used for the subnet gt lt end point of range gt Note this option is limited to a range defined by using numbers in the last octet Example 192 168 0 4 24 8 With this example the first three octets form the subnet and the entire last octet is assignable The range of addresses is therefore 192 168 0 4 to 192 168 0 8 Example 192 168 0 35 27 38 With this example the first three octets and the first 3 bits of the last MAILGATE MANUAL Configuring MailGate 3 26 octet form the subnet and only the last 5 bits of the last octet are assignable The range of addresses is therefore 192 168 0 35 to 192 168 0 38 Note in this case the start and end of the range must both lie in the same subnet range If
38. service Socket port number that the Http proxy listens on normally 1080 Timeout for socket read operations by the Socks proxy service value given in seconds Idle disconnect time for the Socks proxy service value in seconds Timeout for socket write operations by the Socks proxy service value given in seconds 9 38 Registry Parameters cont StatusBarCounter DWORD SupportEmail String SupportRepyAddress String UnknownHandling DWORD UnknownRecipient String UseNtAccounts DWORD Version String WindowH DWORD WindowW DWORD WindowX DWORD WindowY DWORD MAILGATE MANUAL Technical Reference Indicates which counter to show on the status bar O cycle through counters ve number indexes counter in the order of the popup list Domain to send support email to This value is not usually present and defaults to mailgate com If you wish to change the setting add the value using the registry editor Mailgate pre pends support bugs or wishlist to the string to get the address to email the support request Suppliers providing their own support services for their Mailgate customers should use this facility to get support messages sent to them Email address the user has entered on the support dialog Controls the handling of email that is received but does not have a mailbox for delivery If this value is zero the message will be bounced to the originator If it is non
39. setup requirements 22 How do I setup the machine address below 23 How do I enable DNS on page 7 10 23 How do I setup the LMHOSTS and HOSTS files on page 7 10 Setup machine address for Windows NT To setup the machine address name for Windows NT 1 IPP Notes ii Click on the Start Menu and select Settings and from the Settings menu select Control Panel From the Control Panel window select Networks On the Network dialog select the Protocols tab Highlight TCP IP and press the Properties button Select the IP Address tab on the Properties dialog and check specify an IP address and enter the number Always check with your network administrator regarding your current TCP IP setup Some networks may have a server setup to assign IP address to machines on the network The machine where MailGate is installed should be setup with a specific IP address and not one obtained by a DHCP server This is to ensure that it always has the same IP address MAILGATE MANUAL Network Preparation 7 9 Enable DNS for Windows NT To setup the machine name for Windows NT Optional 1 Click on the Start Menu and select the Control Panel 2 From the Control Panel window select Networks 3 On the Network dialog select the Protocols tab 4 Highlight TCP IP and press the Properties button 5 Select the WINS Address tab on the Properties dialog 6 Check the Enable DNS for Windows Resolution Note If you have
40. supports both version 4 and version 5 of SOCKS For more information on Socks see www socks nec com Check the Enable options to enable the MailGate SOCKS service you require gt Optional Settings Pass HTTP request through Web Proxy Check this option to allow MailGate to check the local web cache Run SOCKS gateway on port The default for this is port 1080 As only one application on a machine can use a port if you already use this port you will have to run the MailGate proxy on a different port Ensure you set your client programs to connect to MailGate on your alternative setting Disconnect After Once a connection has been made with your ISP MailGate will monitor the session activity If there is no activity for the Disconnect Time period then MailGate will request the connection be closed The default period is 120 seconds MAILGATE MANUAL Configuring MailGate 3 19 RealTime AV Tab Figure 20 RealTime AV Tab Check the Enable Realtime AudioVisual Gateway option to enable the MailGate proxy service gt Optional Settings Run Realtime AV gateway on port The default for this is port 1090 As only one application on a machine can use a port if you already use this port you will have to run the MailGate proxy on a different port Ensure you set your client programs to connect to MailGate on your alternative setting Disconnect After Once a connection has been made with your ISP MailGate will monitor
41. that you wish to collect from d Your ISP s POP and SMTP server addresses To configure your client machines you will need a The IP address name of the MailGate server b The users mailbox and password settings c The ports used for each proxy service if changed MailGate TCP IP Requirements MailGate uses TCP IP for all it s network communications TCP IP is configured as part of the operating system and must be correctly setup for MailGate to operate successfully b Static IP Addresses In most small networks the easiest way to configure TCP IP is to use Static addressing With this each machine is given a unique IP number for example 192 168 1 10 When you want to connect to a remote machine you refer to it using it s IP number address If you use static addresses when you setup your client machines you will need to know the IP address of the MailGate machine and it is this you use to identify the server MAILGATE MANUAL Getting Started 1 8 gt Using Names In larger networks and the Internet it would be difficult to remember the IP numbers associated with each machine To make it easier these large networks are normally configured using machine names To be able to make a connection these names must be converted to the actual IP number by the IP protocol This process is called Vame Resolution and the IP protocol follows a sequence of events to try to find the IP number to use When configuring your MailGate s
42. the computer system This value is not normally present and defaults to 4 If you wish to change the setting manually add the value using the registry editor and set to the required value Binding setting for Pop service O no interface binding any other value stores the interface address as a 32 bit binary value If repeated checking of Pop accounts during a connection is enabled this value controls how often checks occur Default value is zero disabled other values set interval of checks in seconds List of name or ip address pattern match strings indicating which clients are denied access to the pop service Controls whether the Pop service is enabled or not o disabled 1 enabled Maximum size of pop message allowed before deferment takes place Setting to zero disables oversized checking Default value is zero Indicates whether the administrator account should be notified by email of oversized message deferments 1 notify o do not notify default value is 1 9 33 Registry Parameters cont PopOversizeNotifyUser DWORD PopPermitted Multi String PopReadTimeout DWORD PopServerPort DWORD PopTimeoutEx DWORD PopWriteTimeout DWORD PurgeDays DWORD PurgeSize DWORD PurgeSpace DWORD RasAccountEx String RasAlertActions DWORD RasAlertTimeout DWORD RasBackupAccount String MAILGATE MANUAL Technical Reference Indicates whether the account s that
43. the process you should refer to How MailGate Sorts into Mailboxes on page 2 12 before making any changes Custom Field for Routing This field allows you to specify a mail header field to look for to determine which local mailbox to place the mail in By default the mail header is scanned for the following fields Apparently To X Apparently To X Originally To Envelope To lt the string entered in the custom field on the pop dialog gt If the field is found it is compared to the address filter pattern below and if matched the default is this address is selected and searching stops If more than one of the above exist whichever is nearer the start of the header and matches the filter will be used There is also a special setting of Zo which may be used here to force MailGate to use the To and Cc fields for address data Address Filter Set a filter pattern here to reject any addresses which are not yours If an address matches the pattern filter then MailGate will accept that address and sort it into a mailbox For example if you set the filter as mailgate com MailGate will ignore any addresses not for that domain In particular if MailGate uses the To CC addresses to route email you must set the filter to your domain to ignore other address in these fields You may also use the zegate wildcard setting to exclude specific addresses from being accepted For example with the above an additional entry of
44. these MAILGATE MANUAL Technical Reference 9 2 MailGate Scripting Introduction to Scripting The script language was originally developed as a simple extendable and flexible method of controlling automated processes under Microsoft Windows NT This language is fully incorporated into MailGate as the MailGate Scripting language The language consists of a simple set of BASIC like commands see 9 3 which provide all the necessary programming constructs for program development It also allows the addition of application specific functionality via the use of external function libraries These are standard Windows NT Dynamic Link Libraries DLLs which can be developed in any language that can produce DLLs such as C C or Delphi to provide addition features to the base script language Within MailGate there is a standard set of functions see 9 9 available to the user These include some specialist functions used when creating Custom Proxy scripts Where scripting is used in a MailGate extension there may be additional functions made available for use with the extension Scripting Syntax amp Commands Scripting Syntax amp Commands The MailGate language consists of a simple set of BASIC like commands that provide all the necessary programming constructs for program development The script language is not case sensitive The following pages give details of these commands and examples of the language syntax Integer and str
45. zero it will be delivered to the email address indicated by the UnknownReceipient setting Email address for messages collected that don t have a local mailbox Address my be local or external Indicates whether the pop server checks passwords against Mailgate registry or Nt accounts database in the domain set in the NtAccountDomain setting 0 use Mailgate password database 1 use Nt domain database Only present in Nt version of Mailgate Always contains the last version of Mailgate run on the system Height of the Mailgate main window Used at Mailgate startup to restore Mailgate to the same size and position as when last run Width of the Mailgate main window Used at Mailgate startup to restore Mailgate to the same size and position as when last run Screen X position of the Mailgate main window Used at Mailgate startup to restore Mailgate to the same size and position as when last run Screen Y position of the Mailgate main window Used at Mailgate startup to restore Mailgate to the same size and position as when last run 9 39 Schedules The schedules key is used to store the schedules setup in Mailgate Under the schedules key Mailgate creates a key for each schedule entered These keys are named Scheduleo Schedule1 and so on for the required number of schedules The data stored in each of these keys is the same as follows Value Name Description Data Type Days DWORD Enabled DWORD EndTime DWORD
46. 8 9 Anawave Gravi CONQUE adi 8 9 Agen Free Agent News COR IZUIAllA ociinnniiniicicacn cnn 8 9 NEWS Si nd Conpour toh AR NN 3 10 Virtual Access News CONfIGUI ATION anieri aiir anat ienn nn e n e ii ii 3 10 9 TECHNICAL REFERENCE cscsscssscssessccsscsssscsssncsessncseesseesssssncssssensssesnessosssssosssssnssessnessessessossoses 9 1 USING WILDCARDS lolo a E aaron adas 9 1 Using Wildcard ENXPICSSIONS esse LEG ies E pe cae tas 9 7 MATEGATE MACROS aro sa ces coteataessy secusennansesiea A ke heey 9 2 Using MACHO EN PV CSSIONS ives casisa on a a taaan 9 2 MATEGATE S CRIPTING anna ducangonend osteo ESS 9 3 Introduction LO SCTIPUNG 3 Foss sia aa ieee eases banal ia 9 3 SCHDIHL SYNTAX SE COMMUNES i EEEE A Medel ils deter a A eked dite dd 9 3 SCTIDIAZ LUCIO ig 9 9 Proxy Communication FUNCTIONS coinninninininin inner 9 10 WINDOWS REGISTRY oerien ne EIEEE SN OE Ee evuece EEE EENES ENERET Nadadores 9 27 Windows ROBISIVY daa iaa EEE 9 27 VANU UAE i 9 27 IRAIN URIE EEEE A NE t 9 40 Col tas 9 4 PPL ONTOS dt 9 42 AL ARMAR E AA 9 44 COM diana 9 44 10 THE LOG FILE VIEWER coononcconoononnoononinnononononcnnonncononononncnnconcnnocrrononococconrconcn non ccnono coco nrroncn ron conce ros 10 1 INTRODUCTION TO THE LOG FILE VIEWER ocococcconoononnnonannnnononannnonnonanononnonononarononnon nro nan nonn none ra nonnonnranan ca nncinesos 10 1 USING THE LOG BILE VIEWER voeon idol crecio E R AE E RE EA EET AS Eet 10 2 Usine the LOG VICWET lek
47. A E e E E EE ARE i 2 28 LMNCOUL Override Schedule tii a a a a e aa a e a iia 2 28 USING THE CONNECTION HISTORY sv didsivcccesesetssnesteseesssstessausteneseavstestnseeussietsedsotesteusssnevrevevnsepiestpuvedeoendegersteyts 2 30 Usinethe C OMMCCHOW ANS ON ti ai At E E O E a i 2 30 USING EXTENSIONS TO MAGATE sisi cstvccceresecsssssteveessosteotasttensenevseestestiersietenesstesesuessneurevetosetesssegurteededeensstey s 2 31 3 CONFIGURING MAILGATE ccoccoccoonomosiosoncnconcnncnnnonocononncnncncnnonnconono non ccnnconcnnonncnnonoronono roo nonoconcn conc rosas 3 1 CONFIGURING MIATEGIA TE aida 3 1 GATEWAY SETUP 65s aeoiee aeee rae tutes canada EEE E EIS EEEE EEO cxavibes delia EE E EEIE ESE TE EE o 3 3 Gateway CA E EEEE E EERE A EE EEEE E EERE 3 3 Dia ii 3 3 BACKUP Dialup ENY ispirarsi ana a iiaee A EAE EE EGAT ELE ASE EEEE AE E EEKE i ERa 3 4 EXCESSIVE CONNECORN LL eiii 3 4 POP TOD ear 3 5 POP COUCCHON Das Eco 3 6 DOMAINS TAD iriiritia aria ata 3 9 VALO H KI APE E TN S 11 SMTP Auihenticanon Details aaa 3 13 LAN Forwait TaD riiseni Ene EAE AAE EAEE EEA AETERNE ENE E AEEA ETORT 3 14 LAN Forward Detail Sereen sininen anae ani a a a dete an 3 15 DHE WED LAD kin A Ei 3 16 LUPA A A ds ot 3 18 SOCKS TAD a hats a AA A DA AA Ad data 3 19 Kelime AV TADS tess E a A A AAA Aid a O 3 20 WINS LGD 0 DAA AA A AA A ia EE 3 21 Liquid Audo LAD iis LA A A AA A Aid tati 3 23 Cache Lab ii id aaa aa aaan aaa Ai aaa a aia 3 24 GATEWAY ADVANCED SETUP x acai cxiss
48. ANUAL Using MailGate 2 25 Connection Control Schedules These allow you to fine tune how your Internet connection is used Keep Connected on page 2 28 Once established MailGate will not close the connection during the active period Timeout Override on page 2 28 Overrides the standard timeout period to make best use of minimum call duration charges You can create as many schedules as you wish to allow different connection profiles to be active at different times of day or days of the week Email Transfer Schedule The Email Transfer option is the basic email connection option This schedule allows you to collect mail on a periodic schedule within a time frame such as during the week weekends and evenings You can set several schedules for Email Transfer to meet your needs such as e Every hour during the week and working hours e very four hours during the evening during the week e Once a day on the weekend Minimum redial time An amount of time that must pass between the last mail collection and the time this schedule is to run For example The minimum redial is set at 15 minutes MailGate is scheduled to collect mail on the half hour At 10 20 during a proxy connection MailGate checks for new mail At 10 30 after checking the minimum redial time MailGate will not run this occurrence of email transfer since less than 15 minutes has passed since the last mail collection Priority Email Trigger Schedule The Pr
49. Bar The Status bar contains e The current MailGate status e Acounter showing the number of user workstations currently connected e Arolling counter showing the number of current sessions for each protocol Use the right mouse button menu to select what protocol is displayed in this part of the status bar e In Out lights that flash when MailGate is connected to the Internet and traffic is passing MAILGATE MANUAL Using MailGate 2 6 Starting the Service Starting MailGate When MailGate is installed there are two parts the administration and the service process If installed as service the default the service process is started at machine startup and the admin program can be used to configure and start stop the service process If installed for desktop only mode service process starts and stops with admin program Stop and Restart MailGate If you wish to temporarily stop and restart MailGate service use the MailGate admin program The File Stop Gateway Service turns off the MailGate services The File Start Gateway Services turns MailGate services back on These options are only available if MailGate is in service mode When initially installed MailGate will be in service mode For ease click on the e on the toolbar to start the service and on the b to stop it Run as Desktop Mode The desktop mode makes the service component of MailGate start and stop as you start and stop the admin component I
50. EB EX Select the mailbox to receive email addressed to 39 unknown users in your email domain m Email settings V Enable MailGate POP server APOP Disabled System address flocalmailserver System reports to IV Enable MailGate SMTP server Copy outgoing mail to disabled gt ISP SMTP Server Auth Warn after 24 3 hrs Fail after 72 lt hrs IV Send mail immediately if connection open Reject SMTP messages bigger than 0 3 KB figure 13 Email Tab The Email tab is used to set many of the general settings for MailGate s mail servers On this tab you can enable the MailGate POP server used by your users to collect their mail and the SMTP server used by your users to send mail into MailGate for delivery gt Normally Required Settings The following settings are normally required by MailGate s email system ISP SMTP Server If you use MailGate to send external mail you must specify the address of your ISP s SMTP server All outgoing mail will be sent to this server for distribution around the Internet If your ISP requires you to use authenticated login before sending mail click on the Auth button to turn on authentication System address the FROM field to be used by MailGate admin reports and messages This should be a full email address generally in your local domain such as mailserver yourdomain com Note if your forward your administration messages to an external add
51. LGATE MANUAL Using MailGate 2 17 To use the Web proxy you will also need to consider the following gt Internet Connection Ensure you have established your method of connecting to the Internet See Internet Connection Requirements on page 1 9 for more detail gt The Web Tab on page 3 16 Enable the Web proxy Optionally you can change the port used by this service and enable MailGate to pass web requests through your ISP s web proxy Cache Tab on page 3 24 Review the settings for the management of your web cache MailGate constantly runs a low priority job to monitor and clear the web cache This operates only when no other activity is on the computer gt URL Filters on page 3 45 You can create URL filters to control your users access to the web gt The DNS Tab on page 3 21 If your users are going to use certain web applications you may need to enable the DNS relay Using URL Filtering URL filtering applies only to the Web Proxy It allows you to e allow or deny machine in your network to access the Web e allow or deny access to Web sites e set what times the filters are active You can use wildcards see 9 1 when specifying either which machines have access or Web sites may be visited See Using Wildcard Expressions on page 9 1 for more detail Sito Create a URL Filter Either click on the above icon on the toolbar or select the Edit menu and choose URL Filter This will display the URL filter detail dial
52. Mailgate Ltd MailGate User Manual Ry Q N Sa Ver 5 Proxy Gale MAILGATE MANUAL Microsoft is a registered trademark and Windows 95 Windows 98 and Windows NT are trademarks of Microsoft Corporation Copyright 1999 2001 2002 Mailgate Ltd All rights reserved No part of this publication may be reproduced stored in a retrieval system or transmitted in and for or by any means electronic mechanical photocopying recording or otherwise without the prior written permission of Mailgate Ltd King amp Associates www edking com wrote this manual and the help files for Mailgate Ltd Revised Amended and Edited by Lani K and David D Thompson Contents L GETTING STARTED AAA RA 1 1 MATGATE OVER VIEW 5 55 cit conos setedanvvon ica suet a eve A cote sasaoe ven sei sees dt tdi 1 1 WHALIS MIGIU CA ALAN sock sects ose E TO nd Es oat aa E Tate TS eR L 1 SYSTEM REQUIREMENTS coca bici 1 8 SYSTEM REGUITOCINCWES ciis 2 Bids Ett AA AA A A AA ee dda AAA AA steed Bat 1 8 MailGate TCP IP REGUIVCHICHUS icies ariii eiiiai ia een 1 8 Internet Connection Requilements oiiiniinininnniiciccin arena 1 9 TSP ACCOUNT Details gt ibi ia Aaa Td iaa ia aaa is L 10 INSTALLING MAILGATE ai Hever lode viccbes ede 1 11 nstallat on OVCIVIC A A idad aii L 11 TASCAM AS MATICES ena Ai sc di bits L 11 Client COMI QUI ATONE cis ii kittens aah tin EA clase aan ots decane deka IA A AR AEREA L 12 2 USING EIA OOO 2 1 MATEGATE MAIN WINDOW rarere aan
53. ORD DnsBinding DWORD DnsDenied Multi String DnsDialupEnabled DWORD DnsEnable DWORD DnsPermitted Multi String DnsReadTimeout DWORD DnsServers Multi String DnsTimeout DWORD DnsWriteTimeout EmailConnectFailure DWORD Technical Reference Option selected on the disconnect dialog when last used 0 disconnect when all activity ceases 1 disconnect immediately Time Mailgate waits for a response from a Dns server given in the DnsServers list before re issuing the packet to the next server in the list This value is not normally present and defaults to 1000 If you wish to change this setting manually add this value using the registry editor The value gives the delay in milliseconds Binding setting for DNS service 0 no interface binding any other value stores the interface address as a 32 bit binary value List of name or ip address pattern match strings indicating which clients are denied access to the dns relay Controls whether a new connection is established to do a dns reverse lookup for checking security settings of a service 0 don t connect 1 do connect Controls whether Mailgate runs the DNS relay o don t run 1 run List of name or ip address pattern match strings indicating which clients are permitted access to the pop service Socket timeout setting for read operations by the DNS relay value given in seconds List of dns servers dns relay relays dns packe
54. Proxy Server do below 22 What are Protocols below 22 What are Gateways and Ports on page 1 6 What can the MailGate Proxy Server do MailGate provides a cost effective way to avoid the problems of putting a modem and phone line on every desktop It allows low cost concurrent multi user Internet access and avoids the need for expensive dedicated leased lines and routers In addition with MailGate you can e decide when people can access the Internet e decide who can access the Internet e decide sites where individual users can can t access on the Internet What are Protocols A protocol is language that computers use to talk between themselves Some protocols are formally agreed upon by international standards groups Common protocols used with MailGate are e POP3 Post Office Protocol used for mail MAILGATE MANUAL Getting Started 1 5 e SMTP Simple Mail Transport Protocol used to send mail and sometimes for receiving mail e NNTP Usenet News Transport Protocol used for newsgroups e HTTP HyperText Transfer Protocol used with the Web e TCP IP Transmission Control Protocol Internet Protocol Fortunately you don t need to know the details of the protocols used You do need to know the different names and what areas they relate to so you can fill in the configuration for MailGate What are Gateways and Ports Envisage that MailGate has created a security wall around your network It isolates you from the rest o
55. Simple Network Setup Checklist for Simple Network Setup The following checklist is for a simple peer to peer network setup The options when using Windows NT Server and Domain Controllers is beyond the scope of this document All machines in network including MailGate machine TCP IP installed Have a unique IP address Have a unique machine name optional Have enabled DNS optional LMHOSTS and HOSTS files setup optional One machine in the HOSTS file is called mailgate optional Machine where MailGate is installed The TCP IP address is set explicitly and not by a DHCP server Dial Up Networking is installed The HOSTS file has this machine named as mailgate optional Figure 31 Checklist for Simple Network Setup Tip You can quickly check all machines to see if TCP IP is installed by opening a DOS box and typing PING You can test connections to other machines by typing PING IPAddress or PING Machinename See the Microsoft help file for more information about PING or type PING at the DOS prompt MAILGATE MANUAL Network Preparation 7 13 8 Configuring Clients for MailGate Overview of Client Configuration A client is the program that accesses the MailGate Server from your computer such as Internet Explorer or Netscape for web browsing MS Outlook Eudora or MS Mail for collecting your mail For your workstations to be able to access the Internet succe
56. Windows NT Server and DNS domains already setup please contact your system administrator Setup LMHOSTS and HOSTS files for Windows NT The LMHOSTS and HOSTS files are used to map specific IP addresses to a machine name In a simple network setup these contain the same information but are used by different programs If you use static addressing using IP numbers then you can ignore these settings LMHOSTS is used by the NetBEUI protocol to map machine names and IP addresses HOSTS is used by the TCP IP protocol to map machine names and IP addresses Note the HOSTS files may have multiple names for the same IP address These files are located in systemroot system32 drivers etc systemroot is a variable used to describe wherever you have installed NT There are sample files in this directory called LMHOSTS SAM and HOSTS SAM for you to refer to Setup pee and HOSTS Create the LMHOST and HOSTS files on one machine as described below 2 Make sure the HOSTS file has the extra line for localhost and MailGate machine as described below 3 Copy the LMHOST and HOSTS file to all other machines in the network Windows NT place the file in the systemroot system32 drivers etc systemroot is a variable used to describe wherever you have installed NT Windows 95 and Windows 3 1x place the file in the directory where Windows 95 3 x is installed MAILGATE MANUAL Network Preparation 7 10 Text for LMHOSTS and HOSTS The text in
57. Your own domain This configuration gives you an unlimited number of mailboxes Mail is sent to any number of people at your hostname such as e anyname your_domain e support mailgate com e johnb myco com Note In some situations your ISP may forward several single accounts to a specific POP3 account for collection This lets you collect many accounts from a single point MailGate will sort the mail into individual MailGate mailboxes as it collects them What is a Proxy Server The word proxy can be defined in general usage as A person authorized to act for another an agent or a substitute In computer terms the proxy is a program that acts as your agent between you and some other computer For example below is a simple HTTP Proxy Server The proxy server sits between you and the Internet page acting as your agent When you request information from the Web the proxy server checks to see if it already has that information If it does not it then goes to the Web and collects the page for you MAILGATE MANUAL Getting Started 1 4 Internet Service Provider MailGate Server 2 MailGate Server checks user and site access 3 MailGate checks if page in cache and if so return to user Desktop PC 1 Web Request using HTTP fram Desktop If page not available connect to ISP and get page Figure 2 Simple Proxy Server To learn more about MailGate and Proxy Servers see l What can the MailGate
58. a it is often desirable to access the current mail information This can be specified in the set up screens by using the MailGate macro facility When making a setting that supports the use of Macros existing mail header fields and other data may be referenced by specifying the field in macro format This is done by surrounding the required field name with example SUBJECT When processed the macro specifier is replaced by the content of the required field Example The SPAM extension allows you to change the subject of an email that has been identified as SPAM The setting that defines what the change should be can be configured with SPAM SS SUBJECTSS This setting will cause the extension to write a new subject field in the mail adding SPAM in front of the existing subject Generally the Macro facility can reference any existing mail header fields however when configuring to use macros be aware that not all header fields are always available in your mails Availability can depend on your ISP s server system which may be subject to change The following fields are regularly found in mail headers and are good candidates for use with macros FROM The originator s email address DATE The original email s date SUBJECT The original subject MESSAGE ID The original message ID There are also a number of Extension Module specific macro identifiers available Refer to the module help for more information on
59. a manual connection to your ISP for a mail exchange al When connected to your ISP click on this icon to force a disconnect MAILGATE MANUAL Using MailGate 2 3 Service Status Icons a This indicates the MailGate service process is stopped Click here to start the Service a This indicates the MailGate service process is running Click here to stop the Service For more information see Starting MailGate on page 2 7 Toolbar Icons Sl Click on this icon to create a new schedule entry See Using Schedules on page 2 25 e Click on this icon to create a new mailbox entry See Using Mailboxes on page 2 10 x e Click on this icon to create a new URL filter entry See Using URL Filters on page 2 18 15 Click on this icon to create a new Custom Proxy See Using Custom Proxies on page 2 22 4 Click here to cut the current data x Click here to delete the current entry Click here to display the help window T Click here to close the MailGate Administrator MailGate Administrator Window Registration Information Shows your system serial number and user count See Registration on page 4 1 for information on how to register your copy of MailGate MAILGATE MANUAL Using MailGate 2 4 Schedule List Shows a list of the connection schedules that are setup See Using Schedules on page 2 25 for more information Note the icon is dimmed if the schedule is setup but not currently enabled Mailbox List Shows a l
60. adjust its settings to allow MailGate to connect correctly For more information on the setup of Dial up Networking and TCP TP see the see the Network Requirements on page 7 1 later in this manual MAILGATE MANUAL Getting Started 1 9 ISP Account Details Your ISP account will give you access to both email and other Internet services like web browsing MailGate is mainly designed for use with ISP s who provide a POP3 service for incoming mail but it will also work well with those who wish to use the SMTP protocol For outgoing mail all ISP s provide access to an SMTP server Often this can only be accessed if you connect using the particular ISP s connection service Your main ISP may also provide access to a proxy server for web browsing MailGate can collect mail from any number of POP3 accounts and this collection can be performed in two different ways See How MailGate Sorts into Mailboxes on page 2 12 for more details For each ISP mail account you wish to use you will need to know the address name of the POP3 mail server and the mail account name and password You will also need to know the address of your main ISP s SMTP server for outgoing mail If you wish to use other services provided like your ISP s proxy server or news server you should note the details of these services MAILGATE MANUAL Getting Started 1 10 Installing MailGate Installation Overview To successfully install MailGate on your network you sho
61. ailboxes You need to setup at least one local mailbox in MailGate for each person to collect their mail The name of the local mailbox is used by MailGate to determine where to sort collected mail See How MailGate Sorts into Mailboxes on page 2 12 for more information Determine Mailbox Routing In a very simple setup each remote POP account would have a corresponding MailGate mailbox The Postmaster account is used for any other mail received and when MailGate does not know where to sort mail Using MailGate 2 10 POP accounts at your Internet Provider POP account maryb POP account sales POP account johnt Mailgate Mailbox maryb Mailgate Mailbox sales Mailgate Mailbox johnt Mailgate Server Mailgate Mailbox postmaster any other mail received Figure 6 Simple Mail Routing For another example of mail sorting see Planning Mailboxes Advanced Example below Planning Mailboxes Advanced Example A support department wants all mail sent to their support account copied to the individual support people In addition they want a mailbox where requests for common questions will be answered automatically Mailbox maryj Mailbox iain Mailto support copied to tech support staff using the alias support in the mailbox Mailbox ted setup All mail to your domain sent to one Mailgate Mailbox mailbox at your server support ISP Mailbox FAQ A
62. ails on the following pages The MailGate Custom Proxy facility can make use of the script language An example of this is supplied for use with the Telnet Custom Proxy There are some functions that are only available to the Custom Proxy usage These are also listed below Some of the MailGate optional extensions like the Spam Mail Filter also make use of the scripting language In this case documentation of the module specific functions can be found in the module help Standard MailGate Script Functions String Functions length lt string gt left lt string gt lt count gt right lt string gt lt count gt mid lt string gt lt start gt lt count gt pos lt string gt lt substring gt ascii lt string gt chr lt integer gt value lt string gt str lt value gt hex lt value gt MAILGATE MANUAL Technical Reference 9 9 IP Communications Functions inet_ntoa lt address gt inet_addr lt address gt gethostname gethostbyname lt host gt gethostbyaddr lt addr gt getnumhosts getnumaddrs gethost lt index gt getaddr lt index gt File I O Functions fopen lt filename gt lt mode gt lt sharing gt fclose lt handle gt feof lt handle gt ftell lt handle gt ferror lt handle gt fread lt handle gt lt count gt fwrite lt handle gt lt message gt fseek lt handle gt lt offset gt lt from gt Windows Registry Functions regqueryval lt hive gt lt key gt lt value gt
63. anning Plan MailGate Setup To plan the configuration of the Mail Server you will need information from a Your Internet Service Provider with specific information for access to their system and your mailboxes See What is POP and SMTP Mail on page 1 3 for information on type of mailboxes b Information about your Network TCP IP setup such as your domain name For more information about setting up TCP IP see Network Preparation on page 7 1 Setup Mail Server To setup the Mail Server you need to do the following a Plan and then create the mailboxes in MailGate that you require and setup any special actions for mailboxes such as forwarding to another account that you require b Setup the global information in the Gateway Setup dialog including the mail accounts to collect from your ISP For more information see 23 Setup the Mail Server below 22 Planning Mailboxes on page 2 10 Setup the Mail Server This section is a quick overview of the information needed to setup the mail server To setup the mail server you enter information on four tabs To access the tabs select the Gateway menu and click on Setup The following tabs are used for Mail Server setup gt Dialup Tab If you use a dialup connection the Dialup Tab specifies the Dial Up Entry of your Internet Service Provider and the account name and password used to logon This account is common for the Mail Server and all gateways If you have a leased
64. ary connections due to general DNS requests being passed around your network MAILGATE MANUAL Using MailGate 2 20 You can control your users access to this service in a number of ways See the page below on how this may be done 23 Setting Advanced Security on page 3 25 To use the DNS Relay you will also need to consider the following gt Internet Connection Ensure you have established your method of connecting to the Internet See Internet Connection Requirements on page 1 9 for more detail gt The DNS Tab Enable the DNS relay and specify your ISP s DNS server address es You can optionally enable DNS reverse look up for security checks See the DNS Tab on page 3 21 page for more details Using the RealTime Audio Visual Gateway The RealTime Audio Visual proxy will pass Realtime client requests to the Internet To use the RealTime proxy you should set your RealTime client to use a proxy and specify the MailGate server address Be aware that once the client is active you may see un requested connections being made The client software by default will try to connect to update itself For more information about RealPlayer see www realaudio com You can control your users access to this service in a number of ways See the sections below on how this may be done 221 Setting Advanced Security on page 3 25 Bal Using the Scheduler on page 2 25 To use the RealTime proxy you will also need to consider the fo
65. ate server to use the Remote Logfile Viewing facility Please refer to the Module Help for more information on how to do this 2 Install a remote copy of the Log File Viewer To be able to remotely view MailGate log files you need to install a copy of the Log File Viewer onto the remote workstation To do this you should run the install program on the remote machine and select the option to only install the Log File Viewer utility There is no configuration required in the viewer so you will now be able run the program and connect to your remote system See Using a Remote Viewer below for more information Using a Remote Viewer The Remote File Viewing option allows you to connect with and monitor in real time your MailGate system log file all from a remote workstation Once you have completed the required installation steps you can connect to your remote server either by selecting Remote MailGate System on the File Menu item or by using the shortcut Ctrl R This will display the connection dialog In the Connect to Remote Server dialog you should enter or select the address of the remote MailGate system you wish to connect to enter the appropriate password and ensure the port is set the same as the setting used on the remote system You should also consider which event types you wish to view see below Click OK and a connection will be established with your remote system MAILGATE MANUAL The Log File Viewer 10 5 Once a remote c
66. ation browser to point at the MailGate gateways See Configuring Clients for MailGate on page 8 1 for more information on typical client programs Note Only one software application can be linked to any one port If the MailGate server is also a Web or FTP server then the MailGate ports may need to be changed from the defaults See the Gateway Setup chapter on page 3 3 for more detail MAILGATE MANUAL Getting Started System Requirements System Requirements The following is a list of the requirements for a typical setup of MailGate You should ensure you have completed any setup needed before proceeding with your MailGate setup You will need to have the following a TCP IPGlossTCPIP set up on each computer on your network which will use the MailGate server If you re unfamiliar with TCP IP read the TCP IP section in this manual or refer to your Windows documentation b Decide on how you wish the MailGate server to connect to the Internet If this is to be a dial up connection then you need to install your hardware configure dial up networking and test your connection If you wish to use a router then confirm there is a working connection between the MailGate machine and the Internet You will need to know the following a The account name and password with your ISP and the name of the dial up networking configuration b The IP address name of the machine running MailGate c The name and password for the POP account s
67. both these files is in the form ip_address lt tab gt machinename ip_address lt tab gt machinename You should enter each IP address and machine name in your network each on a single line Additional Requirement for HOSTS file The HOSTS file should always contain the following entry 127 0 0 1 localhost This address is used by many TCP IP programs Requirement for MailGate On the machine that is running MailGate the HOSTS file can have the name mailgate as well as the regular machine name for the IP address For example 192 168 1 30 sysmachine mailgate This allows users to enter the word mailgate instead of having to know the specific IP address of the mailgate machine The setup instructions in this manual are based on using the machine name mailgate setup in the HOSTS file If you use another name you will need to remember to use that name instead when configuring MailGate and your client programs Note If you have a Domain Name Server DNS setup for your network please consult your system administrator for details of setting up DNS for your network and these files Setup Dial Up Networking for Windows NT Dial Up Networking must be installed on the machine that will run MailGate There are two steps with Dial Up Networking 1 Install the software 2 Configure for connecting to your Internet Service Provider gt Install Software You can check to see if Dial Up Networking is installed by the
68. can choose what details are written to this log file You can view the log file using any text editor or by using the MailGate Log Viewer utility which can be accessed by selecting Logging View Logs The most common use for the log file is to help adjust your POP collection settings To do this you should ensure you are logging POP Collection Details When you look at the log file you will see each line of your incoming emails including the mail header data and information on how MailGate is routing the mail Refer to How MailGate Sorts into Mailboxes on page 2 12 and adjust your POP collection settings until the routing you require is achieved For more complex problems use the Email for Support on page 4 2 facility and send us a copy of your log file with your question MAILGATE MANUAL Solving Problems 6 1 Winsock Error Codes MailGate uses TCP IP to communicate both with your users and the Internet This communication is processed by passing requests to the IP software loaded on your machine Sometimes there may be a problem with communications and the IP software will pass an error code back to MailGate The most common error codes are listed here to help you understand what may be wrong A full list may be found on our web site www mailgate com in the support area Code 10048 10054 10055 10060 10065 11001 Meaning he address is already in use he connection was dropped by the other lend Wi
69. ceeds limit of lt size limit gt mb currently lt current size gt bytes MAILGATE MANUAL Configuring MailGate 3 43 Maintaining the Outgoing Queue Outgoing Message Details The Outgoing Queue shows all mail that is waiting to be sent the next time MailGate connects By double clicking on a queued message or highlighting a message and selecting Edit Info MailGate will display the Outgoing Message Details dialog With this dialog you can get some additional information that is very useful for tracking errors gt File Details Both the message file name and size are displayed There are three files for each message in the queue The first part of the file name is displayed here Each outgoing message will have a file with the extension file type of msg which is the mail message data a xdl which contains the sender and recipient addresses and a ctl which contains the data displayed in this screen All outgoing mail is stored in the QUEUE subdirectory under the MailGate system directory You may also find files with the extensions of ldl and pdl These are messages that are waiting delivery to local mailboxes or are pending processing Address Data Both the sender and recipient addresses for the message are displayed b Message Status Information about the time the message was first placed in the queue and its current status are displayed If the last error shows an error code see Winsock Error Codes for a lis
70. cess to this service in a number of ways See the pages below on how this may be done Bal Setting Advanced Security on page 3 25 22 Using the Scheduler on page 2 25 To use the FTP proxy you will also need to consider the following gt Internet Connection Ensure you have established your method of connecting to the Internet See Internet Connection Requirements on page 1 9 for more detail gt The FTP Tab on page 3 18 Enable the FTP proxy Optionally you can alter the port used for this service Using the Socks Gateway The Socks proxy will act as a Socks server and pass Socks requests to the Internet Socks is a protocol wrapper which allows applications to pass data requests to a Socks server The Socks server then unwraps the request and communicates directly with the target host To use Socks MAILGATE MANUAL Using MailGate 2 19 either your client application must be able to communicate using the Socks protocol or you will need to install a Socks client and run your application from within this For more information about Socks visit www socks nec com You can control your users access to this service in a number of ways See the links below on how this may be done 23 Setting Advanced Security on page 3 25 22 Using the Scheduler on page 2 25 To use the Socks proxy you will also need to consider the following gt Internet Connection Ensure you have established your method of connecting to the Internet S
71. chr 13 chr 10 Note This function is only applicable to Custom Proxy scripts Function Read lt Count gt Parameters Return Type String Operation Reads lt count gt bytes from the client socket connection that initiated the script and returns it as a string If a socket error occurs before the requested number of bytes has been read then the function returns a string of the bytes that were available Thus to check for error or socket closure compare the length of the returned string with the requested number of bytes Note This function is only applicable to Custom Proxy scripts MAILGATE MANUAL Technical Reference 9 24 Function Pwrite lt Message gt Parameters Message to write to lan client Return Type Integer Operation Writes the passed string to the proxy socket connection established with the connect function Return value is zero if successful or socket error code if failure Note This function is only applicable to Custom Proxy scripts Function Preadch Parameters None Return Type String Operation Reads a single character from the proxy socket connection established with the connect function and returns it as a single character string If an error occurs the returned string will have zero length Note This function is only applicable to Custom Proxy scripts Function Preadin lt Termination gt cue i Value Type Description sid lt Termination g
72. cksPermitted Multi String SocksProxyPort DWORD SocksReadTimeout DWORD SocksTimeout DWORD SocksWriteTimeout DWORD MAILGATE MANUAL Technical Reference Delay in seconds before smtp transmission of outgoing email starts following a dialup connection Default is zero Port to connect to for sending outgoing email during dialup connections Default is the standard SMTP port 25 Port Mailgate runs the Smtp service on Normally this registry value will not be present and the service defaults to the standard Smtp port of 25 If it is required to modify this manually add the value using the registry editor and set it to the required port number Timeout for socket write operations by the Smtp service value given in seconds Binding setting for Socks proxy service 0 no interface binding any other value stores the interface address as a 32 bit binary value List of name or ip address pattern match strings indicating which clients are denied access to the Socks proxy service Controls whether the Socks proxy service is enabled or not O disabled 1 Socks V4 enabled 2 Socks V5 enabled 3 both Socks V4 and V5 enabled Controls whether Socks requests for port 80 http are passed to the Mailgate http proxy server so that the web cache can be checked for the request o don t divert 1 divert List of name or ip address pattern match strings indicating which clients are permitted access to the Socks proxy
73. cncncnnnnnnnnnnononononononononononononnnnnnnononnnnnnnnnnnnnnnnnnnnnononononeneninanoss 3 6 RE 12 lt DOMAINS TAB 00 AAA I 3 9 RE 13 EMATEDAB EE A T EAEE A 3 11 RE 14 SMTP AUTHENTICATION DETAILS cccccccceceeeseeeseseseseseseseseseseseseseseseseseseseseseeecesesesesesesesesesesesees 3 13 REJS LAN FORWARD TAB 3 14 RE 16 SAN FORWARD A de 3 15 REJI WEB TAB a 3 16 RE LS ER TAB isos oe sae A i ee 3 18 RETOS SOCKS TAB arenon r E eee AE ES 3 19 RE20 REALTIME AV TABA ER a EE E OEE 3 20 REZA PNS TAB hein an r E E E E R E E as ee E E R ERR 3 21 RE 22 LAQUIDI AUDIO FAB aei r e a a Saas en bee A E SSA 3 23 RE 23 CACHE FAB es 3 24 RE 24 SECUR LAB as 3 25 RE293 BINDINGS TAB ai 3 28 RE 26 TIMECOUTS FAB 25 356 50 5525500 A ees 3 29 RE 27 SMTP RELAY TAB voduscsgcoesovesvedsvscssocsoedssecssedsceesovestecsseeyss 3 31 RE 28 MAILBOX SETTINGS nE e n e E o E e Ern e e ESEE EE Ea eee EET Eeri 3 40 RE 29 EDITURL n DA h E EEE E E E E E E EAE 3 45 RE 30 CUSTOM PROXY SETTINGS ccccccccccccccccccccccccecceececseseseseseseseseseseseseseseesecsescecscecsescecececeseseseeeseseeeseeees 3 47 RE 31 CHECKLIST FOR SIMPLE NETWORK SETUP cccccccccccccccccscscceceseecccscsescscscsescsescscsescseseesessessesssesesesees 7 13 RE 32 LOG FILE VIEWER TETEE E E EE E 10 2 MAILGATE MANUAL Figures 1 Getting Started MailGate Overview What is MailGate MailGate is a complete Internet access software package It comprises two integ
74. connection established using the connect function until one or other side closes their connection or a socket error occurs Returns zero if one side closed the connection gracefully or socket error code if socket error occurred Note This function is only applicable to Custom Proxy scripts Function Write lt Message gt Parameters Message to write to lan client Return Type Integer Operation Writes the passed string to the client socket connection that initiated the script Return value is zero if successful or socket error code if failure Note This function is only applicable to Custom Proxy scripts MAILGATE MANUAL Technical Reference 9 23 Function Readch Parameters None Return Type String Operation Reads a single character from the client socket connection that initiated the script and returns it as a single character string If an error occurs the returned string will have zero length Note This function is only applicable to Custom Proxy scripts Function Readin lt Termination gt Parameters Value Type Description lt Termination gt string Sequence of characters to look for as the termination of a line Return Type String Operation Reads a line of text from the client socket connection that initiated the script and returns it as a string A line is considered all text up to and including the sequence lt termination gt Normally termination would be passed as
75. ct the client to specify the target host and user name when connecting and the firewall type settings should be set accordingly Other Clients See the client documentation on how to configure these for use with a proxy server You may also need to make further settings in MailGate to enable these More detailed configuration guidelines for the more common client packages can be found in the section Configuring Clients for MailGate 8 1 and on our website www mailgate com MAILGATE MANUAL Getting Started 1 12 2 Using MailGate MailGate Main Window 11 42 21 Aug 00 Idle MailGate Gateway Edit Logging View Help ala 510 akeles 1 9 we MailGate serial 04030 licensed for 50 users Pile Es i Scheduling a Transfer email on M TW Th F between 09 00 and 19 00 every 2 hrs 0 mins a Enable priority email trigger on Su M TW Th FS between 00 00 and 23 59 ES Mailboxes 3 postmaster 3 msgs 1k 3 steve 0 msgs Ok 3 terry 0 msgs Ok MER Dutgoing Queue From steve mynet net To jon freemail com 21 Aug 00 11 42 2k Un Filters e Deny access to sex by on Su M TW ThF S between 00 00 and 23 59 e Allow access to by 207 198 45 7 on M T W ThF between 07 00 and 19 00 E3 User defined proxies Nntp Proxy a Telnet Gateway ap Extensions Beil Spam Filter spamfltr dll Ba Fax Gateway fax dll Hg Virus Scanner virus dll a Connection History E E Scheduled mail collection started at 11 00 on 21 Aug 00
76. cting it in the MailGate Start Programs entry This wizard will guide you through a set on the most common settings to get you started You may also configure MailGate using the setup screens available in the user interface If you wish to extend you usage of MailGate or set it to do something a little more unusual then you will need to use these screens We strongly recommend you take a look through the section Using MailGate to understand the configuration options available before proceeding In this section you will find details of all the settings and features available on a screen by screen basis See the pages below to learn about individual configuration areas Gateway Setup on page 3 3 For the main setup dialogs for MailGate Gateway Advanced Setup on page 3 25 For system security and timing settings Gateway Large pop Message Control on page 3 35 To set your controls for large messages Gateway Backup Restore on page 3 34 To save your MailGate settings MAILGATE MANUAL Configuring MailGate 3 1 Gateway Load Accounts on page 3 36 Quick Mailbox creation if you have lots of users Logging on page 3 37 Setting options to control activity logging Schedules on page 3 39 To create and change your schedules Mailboxes on page 3 40 To create and change your Mailboxes URL Filters on page 3 45 To create and change your URL filtering Custom Proxies on page 3 47 To create and change your custom
77. d Le OPONSE o dnde 2 8 USING THE MAT SERVER iriri E E EE ia 2 9 Mail Server PINNING ci ti dida i ea es desidia i ei 2 9 Setup the Mail SOPVEP A dea ei eai a iieii de iia 2 9 Using DIQLIDOXOS eisian ideati aei id a acabe dsd 2 10 Using the Qutgoing QUEUE iii ta dada eidean iiti 2 16 MAILGATE MANUAL Contents USING THE PROXY GATEWAYS iaa 2 17 Proxy Gateway OVCIVICW iii iii 2 17 USING the Web PTONY cocida AS E edad isis 2 17 Using ORL FUEN ici ii in EGEA AE E E enana icon datada 2 18 Using the FTP GALCWAY oriista iiaii EEA tied vests AE E E EE EE i E ai a iian 2 19 Csing the SOCKS CQLEWAY A ietg decd EREA AEE EASE AE Eai a e ei iaia iay 2 19 Using DNS Rel ooo ii cesedscdsveadsts tuts docbegtpdshbateedicvertedesniedsdacvuebouenssdecteces 2 20 Using the RealTime Audio Visual COA WAO Y oonnnnnioniinioniicniccncccccrer nc 2 27 Using the Liquid Audio CACWAY ciooninnninncininnniconncnccc cnica nene racer rn necio 2 22 Using CUSTOM Proxies comi A ai idas 2 22 USING THE SCHEDULER cise css eroaa ree eere Ee oa NEEE SEENE E ar EEEO EEES VOERE TEE EEEE EOE E ES ETES EE 2 25 Using the Schedulet AA 2 25 mail Transfer SCHOMULE 0 ii it dad td e e N E R E a 2 26 Priority Email Trigger SCHCAUIC sive id tai id R RE E d cil 2 26 OULZOIHE Email Trieger Schedule tt it tad a a e iaai 2 27 Email Transfer after le Period Schedule coooniniionnociin ivi 2 27 SCT VICE FNADICH Scheduler c0 ca dvdics nane aine a e o aaa i aiia 2 28 keep COMMCCIEN Sehedul E ai ter R
78. d mail from one mailbox to another For example e you are on vacation and the mail should be handled by someone else e several people should see the mail Send Mail Locally to Other Users MailGate is a LAN email server You can also use MailGate to send mail to other users on your network without sending them to your Internet Provider and back again gt Forward Mail to another Mail Server MailGate can forward mail for defined addresses to another mail server This can be used to add a POP3 collection capability to mail servers which do not have this facility What are POP3 and SMTP Mail POP3 Post Office Protocol and SMTP Simple Mail Transport Protocol are different ways mail can be collected and sent SMTP is always used to send mail In a very few cases your ISP may also use SMTP to deliver mail instead of POP3 Mail at your ISP can be configured in several ways It is important to check with your ISP for the exact configuration Common POP3 Configurations gt Single user at your ISP domain This configuration gives you a mailbox with a name at your host domain such as e yourname your_ISP e jane mailgate com MAILGATE MANUAL Getting Started 1 3 gt Hostname at your ISP domain This configuration gives you an unlimited number of mailboxes Mail is sent to any number of people at the hostname at your ISP domain such as e anyname yourhost your_ISP e mary myco your_ISP e support myco demon co uk
79. dy for use with the local MailGate system The Log Viewer can be accessed either through the Vew Logs option on the Logging menu item or by running the program Mglogvwr exe which is installed in the MailGate folder You may also wish to create a shortcut to this program that can be placed on your desktop With the Log Viewer you can e Select the logfile to review from a simple dropdown list e Find text within the selected file e Use the powerful filter option to limit the entries displayed Filtering can be by entry type or by specifying a filter text string e Zock the viewer to the current log file for a continuous display of logged activity e Install a copy of the viewer on a remote PC and monitor your MailGate systems activity remotely MAILGATE MANUAL The Log File Viewer 10 1 Using the Log File Viewer Using the Log Viewer When first started the Log File Viewer will display a screen similar to the one below All the Viewer functions may be accessed using either the Menus or the Tool bar a MailGate Today MailGate Log File Viewer Ol ES File Edit View Help Today y Anis 1 0 Find po M wanna M System _ M Lock WV Eror M All Fiter zl py mgatesve sai Ox000000db MailGate 3 4 156 service starting mgatesve Sais Ox000000db Operating system is Windows NT intel 4 0 bu mgatesve soa Ox000000db PoolThreadsPerProcessor 4 mgatesve sais Ox000000db Starting 5 worker threads mgatesve sai Ox000000ca Thread s
80. e Log Viewer menu may be accessed by right clicking anywhere in the display window This is useful if you have turned off the Menu and Tool bars You can also move the entire window by holding down the Control key and then dragging the window using the mouse by clicking anywhere in the display window Continuous Monitoring Continuous monitoring of log file activity can be enabled by using the Lock option The display window will update automatically with new logged events as they occur To activate continuous monitoring you must select the file Zoday then select the Zock option on the tool bar or from the menu The lock can be released by either deselecting the option above or by moving the vertical scroll bar to the right of the display window MAILGATE MANUAL The Log File Viewer 10 4 You can set a filter see 10 3 to only display matching logged items Q If you use the view menu you can turn off the Menu and Tool bars as well as set the viewer to be always on top The display window may now be re sized to suit and will always be visible Remember the viewer menu can be accessed by a right click anywhere in the display window Installing a Remote Viewer To use the Remote Log File Viewing capability you must first complete two install steps 1 Install the Remote Admin Extension The Remote Admin Extension provides remote access to the MailGate log files You must install configure and enable this module on your MailG
81. e PC Desktop PC 2 MailGate forwards specific address patterns 73 Remote Office to the remote users collect their office server mail from the local O mail server f i MailGate Server e Office Serv a with SMTP Sengle Mall Transfer Protocol 1 MailGate collects Server to receive mail internet Service Provider all mail and sorts into mailboxes figure 16 Lan Forward Default Sender Enter the email address you wish to be used if MailGate encounters a problem establishing the From data when forwarding a message Send admin message for failures If you forward all mail messages to another server you should uncheck this If MailGate encounters a problem forwarding mail it will send an advisory message to the System reports to address specified on the Email Tab on page 3 11 If this address is also forwarded then a loop can occur in the event of the link between the servers being down LAN Forward Detail Screen In the LAN Forward Detail screen you define the settings for this LAN forward pattern entry Address Pattern Use wildcards see 9 1 to specify the pattern of addresses to be forwarded For example company2 com Smtp Server the address of the server to forward to Smtp Port the port to use Default Recipient If MailGate encounters a problem establishing the recipient or sending to the extracted address it will default to using this setting MAILGATE MANUAL Configuring
82. e indicating the registry hive to read from as follows o HKEY_LOCAL_MACHINE 1 HKEY_CURRENT_USER 2 HKEY_CLASSES_ROOT 3 HKEY_USERS Full path giving key to read from e g software IDSL MailGate Name of value to write to String to write to registry as REG_SZ data successful or Win32 error code if not Function Logevent lt Message gt Parameters string to write to MailGate event log Return Type None Operation Writes the given string to the MailGate event log as a script event type column Function Debug lt String gt Parameters lt String gt string String to write to debug 8 8 8 Return Type None Operation Write lt message gt to the system debug console If MailGate is being run under a debugger the debugger will display lt message gt MAILGATE MANUAL Technical Reference 9 22 Function Connect lt Server gt lt Port gt Parameters lt Server gt string Hostname or IP address as dotted octet string to connect to Port number to connect to Return Type Integer Operation Connects the proxy side socket to the given server and port Return value is zero if successful or socket error code if not Note This function is only applicable to Custom Proxy scripts Function Proxy Parameters None Return Type Integer Operation Proxies data in both directions between the client socket connection that initiated the script and a
83. e of company or individual this install of Mailgate is licensed to 9 36 Registry Parameters cont RemoveEnvelopeFields DWORD ReportEmailAddress String RootPath String ScriptEditWindow String SendImmediately DWORD SmtpBinding DWORD SmtpDenied Multi String SmtpEnable DWORD SmtpGateway String SmtpNoFromCheck DWORD SmtpPermitted Multi String SmtpReadTimeout DWORD SmtpRelayDenied Multi String SmtpRelayPermitted Multi String MAILGATE MANUAL Technical Reference Controls whether Mailgate strips out the envelope address fields from collected email headers or not This value is not normally present and defaults to o If you wish to strip out the fields manually add the setting using the registry editor The default value is O O do not strip 1 strip Email address that system report emails are sent to May be an internal or external address String giving path to root of data storage area to be used by Mailgate Default is to the location the Mailgate executables have been installed Contains the size and position of the script editor window The X Y W H values appear as a string of 4 space separated numbers Controls whether Mailgate senses external email as soon as it is received by the smtp server if a connection exists or waits until the next scheduled email transfer 0 wait for schedule 1 send immediately Binding setting for Smtp service O
84. e the Custom Proxy Details on page 3 47 for the settings for each Custom Proxy Socket Timeouts and Inactivity Timeouts MailGate has two types of timeout Inactivity Timeouts which can be set against each service are managed internally by MailGate Each time some data is passed using one of the service protocols the inactivity timer for that service is reset MailGate will only request a line close once all the inactivity timeouts have expired See the service setup pages for your current inactivity timeout settings These are the Disconnect after XX seconds inactivity settings for each service You can adjust these timeouts to suit your performance requirements For example an HTTP request for a web page is much more likely to be followed by another request than an email collection To save delays at the client workstation MailGate can keep the line open longer after an HTTP request than when doing an email collection Socket Timeouts set the lower level TCP IP timings The TX timeout sets the time to wait for a confirmation after transmitting data MAILGATE MANUAL Configuring MailGate 3 29 The RX timeout sets the time to wait for data to arrive after making a request for data In general you should only make changes to these settings if you have a poor communications problem If you need to increase these values you may also need to increase your inactivity timeouts as your connection may be being cut before the socket timeo
85. e to reverse look up an IP address to establish the name associated with it This will require a correctly configured HOSTS file local DNS or WINS server to be available Entering an address in the left box allows access and entering it in the right box denies access from that machine MailGate will check for a MAILGATE MANUAL Configuring MailGate 3 31 match to the deny settings first gt Authentication Mode Use the dropdown to select what usernames passwords are acceptable e Not Required Authentication is not required If used any username password will succeed e Any MailGate user pass The username password must match a user mailbox e Specified user pass The username password must match the setting specified here gt Authentication Required Checkboxes These checkboxes provide overrides for the Allow Deny settings above The two valid IP settings can be used to turn on the requirement for authentication for machines which could otherwise send mail and the two invalid IP settings can be used to allow mail sending by machines otherwise blocked Check the required boxes as follows In all cases a local domain is one that is included in the Domains Tab 3 9 list otherwise a domain is treated as external Authentication required for valid IP gt local Check to require SMTP clients with allowed IP addresses to use authentication when sending e mail to a local domain address Authentication required for valid
86. ecified information in the log file to view Filter settings can be accessed either directly from the Tool bar or from the popup screen displayed when you choose the 7 ter menu item MAILGATE MANUAL The Log File Viewer 10 3 There are two methods for filtering the data 1 Line Type Filtering Each line in the log file has a line type This is indicated by the character in the second column of the log By using the check boxes in the line type filter only lines of the chosen type s will be displayed The line type characters used are I Informational Lines W Warnings E Errors I O Lines lt indicates inbound data gt is data sent System messages 2 String Filtering By typing a text string into the 7 fer field the viewer will only display log lines which contain a matching string The last few entries made are saved and may be selected by using the dropdown in this field Using Filter Selected The string filter method may be activated by using the Filter Selected item available on the menu To use this highlight the required filtering string in the File Display Window then select the Filter Selected option The highlighted string will be passed into the Filter setting and the filter activated The File Display Window The File Display window displays the contents of the current selected log file You can scroll up and down the file using the scroll bar to the right of the window Th
87. ecution Default 300 Indicates whether the dialing process will wait for the completion of the pre dial command 1 wait o don t Default 1 Controls whether Mailgate checks to see if a smtp client session has connected to the Ras tcp ip interface rather than the lan one If it has Mailgate will keep the Ras connection open until the session ends This setting is not normally present and defaults to 1 If you wish to change the setting manually add the value using the registry editor o don t check 1 check Indicates whether RAS should utilise an already existing connection or fail Default o Should only be changed if you realise the conflict this can cause with the dialup connection and other apps using it Binding setting for RealAudio proxy service 0 no interface binding any other value stores the interface address as a 32 bit binary value List of name or ip address pattern match strings indicating which clients are denied access to the RealAudio proxy service List of name or ip address pattern match strings indicating which clients are permitted access to the RealAudio proxy service Socket port number that the RealAudio proxy listens on normally 1090 Timeout for socket read operations by the RealAudio proxy service value given in seconds Idle disconnect time for the RealAudio proxy service value in seconds Timeout for socket read operations by the RealAudio proxy service value given in seconds Nam
88. ee Internet Connection Requirements on page 1 9 for more detail The Socks Tab on page 3 19 Enable the Socks proxy required Both Socks Ver 4 and 5 are supported Optionally you can change the port used by this service and enable MailGate to pass web requests via the Web proxy making use of the cache The DNS Tab on page 3 21 If your users are going to use certain applications you may also need to enable the DNS relay This is often a requirement when using Socks V4 Using DNS Relay The DNS relay will pass client DNS name resolution requests to your ISP s DNS server To use the DNS relay you should set the DNS server setting found in the TCP IP properties on your client workstations to the MailGate machine address if your network does not have a DNS server If your network already has a DNS server then you should consult your network administrator before making any changes Notes 1 DNS relay is required for some web based Java applets to work and should be enabled if you are using these through the Web Proxy 2 Socks 4 systems often require this if there are any references by machine name 3 This service is NOT required to allow the MailGate machine to resolve addresses when communicating with the Internet Correct configuration of your Internet connection will enable this capability If you are not sure if you need this service it is generally best NOT to enable it as it can result in MailGate making unnecess
89. ee the help associated with the module When an extension is installed MailGate processes emails in the following way e MailGate receives the email and builds a list of all recipients to send it to e Each recipient address and a copy of the mail is passed to each extension installed The address is passed to each extension in the order displayed in the Admin screen e Ifthe extension returns a continue processing flag the address is passed to the next extension e Ifthe extension returns a stop processing flag all processing of the address ceases e Once the address has been passed to all extensions and a continue processing flag is passed MailGate processes the address for normal mail delivery The Extensions section lists all extensions currently installed modules and shows them in the processing order You can highlight an extension and use the Edit Move Up Move Down buttons to change the order MAILGATE MANUAL Using MailGate 2 31 3 Configuring MailGate Configuring MailGate Once the MailGate program has been installed successfully and you have completed the tasks outlined in the System Requirements section you are ready to configure MailGate To assist with you an initial setup you can run the MailGate Wizard You will be prompted with this option every time you start the MailGate user program until you either choose not to use the wizard or complete the process You can also run this wizard at any time by sele
90. em the dialup connection will always be on a second IP address Although not a Firewall in the strictest sense MailGate can prevent access to any service by making the service only available to the local LAN provided all valid users access MailGate through a single IP address To do this put the IP address of the MailGate machine in each entry You must use numeric IP address MailGate will ignore any attempt to connect to a service via any other address If your network is of a more complex structure you should use the Security Tab on page 3 25 to make the appropriate settings Other options within your operating system to further increase the security of your network are outside of the scope of this document Refer to the operation system documentation MAILGATE MANUAL Configuring MailGate 3 28 Timeouts Tab MailGate Advanced Settings 21x Security Bindings Timeouts Smtp Relay These settings control the read and write request timeout periods for the various services Socket timeouts secs Tx Rx Pop 60 120 2 Smtp fo a fia Http fo a fia Ftp 60 120 Socks so 120 ReallimeAv so fiz Liquid Audio so 120 2 o air on 00 Dns Cancel Help i i Figure 26 Timeouts Tab The Timeout tab sets the timeout for each individual socket operation Each protocol can have different timeouts The Timeout tab has the settings to the standard protocols Se
91. em allows you to log the detail for POP and SMTP traffic If there is a check mark to the left of the item the MAILGATE MANUAL Configuring MailGate 3 37 logging is turned on e POP protocol mail collection and clients e SMTP protocol mail delivery and clients Recommend Enable these when you first install to monitor exactly the processing of your mail and otherwise if there are problems with your mail handling gt Web Logging The Logging menu item allows you to log each URL requested If there is a check mark to the left of the item the logging is turned on In addition if you use Authenticate proxy users see the Web Tab on page 3 16 MailGate will log the requesting user name e Log Web requests Recommend None depends on site requirements MAILGATE MANUAL Configuring MailGate 3 38 Maintaining Schedules Schedule Detail Screen The scheduler can be used to schedule e when mail is exchanged with your ISP This allows mail to be sent and collected from your ISP during the day on a regular schedule without user intervention e when the different proxy gateways are enabled e to fine tune the use of your Internet connection To create a new schedule click on the l icon on the tool bar or select Edit New Schedule To edit an existing schedule highlight the schedule and select Edit Edit to open the schedule dialog Then 1 Check the days of the week the schedule should be active 2 Set the time when the schedule s
92. ence 9 19 Function Fseek lt Handle gt lt Offset gt lt From gt Description A file handle value returned by the fopen function Parameters Value Type lt Handle gt integer lt Offset gt integer lt From gt integer Number of bytes to move in file Indicates the type of move to make as follows O move to lt offset gt bytes from start of file 1 move to lt offset gt bytes from current location in file 2 move to lt offset gt bytes from end of file Return Type Integer Operation Moves the current file position as indicated by the parameters Returns zero if successful or non zero if error Function Regqueryval lt Hive gt lt Key gt lt Value gt Parameters lt Hive gt lt Key gt lt Value gt Operation integer string Type Description Value indicating the registry hive to read from as follows Full path giving key to read from e g software IDSL MailGate string Name of value to read Return Type See Below o HKEY_LOCAL_MACHINE 1 HKEY_CURRENT_USER 2 HKEY_CLASSES_ROOT 3 HKEY_USERS Returns a 32bit integer value giving the DWORD value at the given registry location Returns zero if error occurs MAILGATE MANUAL Technical Reference 9 20 Function Regquerystr lt Hive gt lt Key gt lt Value gt Parameters Value Type Description lt Hive gt integer Value indicating the registry hive to read from a
93. erstand how this may be achieved MAILGATE MANUAL Configuring MailGate 3 48 4 Registration amp Support Registration When you first install MailGate you can use the software with up to 10 mailboxes for a full 30 days At any time during that period you can purchase a license key and after entering this into the Registration dialog your copy of MailGate will become a fully working copy To find out how to purchase a key contact your local reseller or visit our web site www mailgate com 1 2 3 When you receive your 20 character key use Help Registration to register your software Enter your key in the Activation Key field Note that capital letters must be used Enter your company or organisation name in the Register to field Click on OK and you should get a Licence Accepted message if you entered the details above correctly Click OK to acknowledge this message You will now be asked if you wish to register your details using an on line email We advise that you do this as it enables us to keep you updated with product news and events Our policy is to only use your information for this purpose and we do not disclose your details to an other party To prevent unauthorised access to your information the email that is returned by this process to us is encrypted Your copy of MailGate will now be registered Please keep a copy of your key safe MAILGATE MANUAL Registration amp Support 4 1 Email Fo
94. erver with this type of network you need to ensure every client machine can resolve the IP address successfully If your network uses DHCP to allocate IP addresses it is best to use a fixed address for the MailGate machine For more information on the setup of TCP TP see the Network Requirements Section on page 7 1 later in this manual Internet Connection Requirements As MailGate simply uses TCP IP to connect to other machines any Internet connection which uses TCP IP can be used by MailGate This includes all forms of dial up connection as well as routed connections using dialing or fixed line routers gt Using Dial Up Connections MailGate is designed to make using a dial up Internet connection easy by providing a comprehensive connection scheduler When using dial up MailGate passes a request to Dial up Networking to establish the connection and start TCP TP Before configuring MailGate you should install any hardware required Modem ISDN Terminal Adaptor etc and configure Dial up Networking to connect to your ISP You may need to contact your ISP for assistance with the settings and account details required When you configure MailGate you will need to know the phonebook entry name to use and the dial up account name and password gt Using Routed Connections When using a router based connection you need to ensure the MailGate machine has the required access to the Internet If you use a firewall you may need to
95. extension CSV in any directory Load Accounts into MailGate In MailGate use File Load Accounts to locate the file Press OK MailGate opens a dialog box listing all the accounts and passwords it found in the file You have the following options e Click on any specific account that you want to exclude from the mailbox creation An x will be placed next to the account name e Remove all existing mailboxes before loading the new list e Don t overwrite any existing accounts You will need to set any other options for the mailboxes manually Load Accounts Detail If you have a large number of mailboxes to create you can create a list of them and import that list into MailGate Create a text file First you need to create a file with the name of each mailbox on a separate line then a comma and the password like this username password Save the file with the extension CSV in any directory gt Load Accounts into MailGate In MailGate use File Load Accounts to locate the file Press OK MailGate opens a dialog box listing all the accounts and passwords it found in the file You have the following options e Click on any specific account that you want to exclude from the mailbox creation An x will be placed next to the account name e Remove all existing mailboxes before loading the new list e Don t overwrite any existing accounts You will need to set any other options for the mailboxes manually MAILGATE MANUAL Configu
96. f the world MailGate creates specific named gateways through that security wall Consider a medieval walled city with heavily armoured gates Each gate leads out of the city to a specific road Each gate has a patrol monitoring and controlling traffic in and out of the city It is not much good using the South Gate if you are planning to journey North In computing terms these gates are called ports In the figure below each gateway has a name such as HTTP FTP Within each gate specific ports given numbers identify the port and allow traffic in and out Figure 3 Gateways and Ports Using MailGate Gateways For your workstations to be able to access the Internet successfully you need to use the gateways that MailGate has authorised for traffic in and out of the network Real life is a little more complicated than the diagram above MailGate does the following e Listens to a specific port on your network e Directs traffic on the port to a specific outgoing port The following figure shows MailGate listening and then directing the traffic to a specific port Note the two port numbers are not necessarily the same MAILGATE MANUAL Getting Started 1 6 HTTP NNTP Port 80 Port 119 Outgoing Outgoing MIC iy NNTP Traffic on Traffic on Port 80 Port 1119 Figure 4 MailGate Listen and Redirect of Ports Each service or proxy that MailGate supports uses a specific port You need to co nfigure each user s workst
97. face binding any other value stores the interface address as a 32 bit binary value List of name or ip address pattern match strings indicating which clients are denied access to the http proxy Controls whether the Http proxy is enabled or not O disabled 1 enabled Controls whether the MailGate http proxy honours keep alive requests Default value is 1 do keep alive O don t do keep alive List of name or ip address pattern match strings indicating which clients are permitted access to the http proxy 9 30 Registry Parameters cont HttpProxylgnore Multi String HttpProxyPort DWORD HttpProxyServer String HttpProxyServerPort DWORD HttpReadTimeout DWORD HttpTimeoutEx DWORD HttpUseFtpProxy DWORD HttpUseProxy DWORD HttpUseSecureProxy DWORD HttpWriteTimeout DWORD IsIconic DWORD IsZoomed DWORD MAILGATE MANUAL Technical Reference An array of wildcard strings for matching against url requests Any match will stop that request being sent through a remote proxy if you have enabled this feature in MailGate Socket port number that the Http proxy listens on normally 80 Name or ip address of a proxy server for Mailgate to pass all web requests through Port number the proxy server given in the HttpProxyServer setting is running on Timeout for socket read operations by the Http proxy service value given in seconds Idle disconnect time for the Htt
98. fers the familiar BASIC looping construct some examples for i 1 to 10 as 1 2 MAILGATE MANUAL Technical Reference 9 7 next for i a S 2 to a 3 step 2 3 2 next i for i 10 downto 1 step 2 ae 3 2 next Notice that the inclusion of the loop variable after the next is optional Inclusion of external source files The include directive includes a source file into the current script at the current point This is for including lists of external functions or script code for previously written useful subroutines Include directives can be nested across files up to a limit of 32 Example of include statement include external inc External function definitions The external function definition directive is the key to the scripting systems power and flexibility It defines the call interface to routines in a DLL file which have been developed in a suitable language Once defined the functions can be used as part of the script language The external definition statement has the following form external lt name gt lt parameters gt as async lt type gt in lt library gt where lt name gt is the name of the function in the external library lt parameters gt lists the parameters expected Parameters can be either string or integer and there may be up to 20 These are listed in the lt parameters gt section separated by commas for example string integer integer async indicates that t
99. formation 64 Pop email collection protocol 128 Pop client session protocol 256 Smtp email transmission protocol 512 Smtp client session protocol 1024 Debugging messages 2048 Web access log 9 32 Registry Parameters cont MaxWorkstations DWORD MbReportDay DWORD Minimize DWORD NtAccountDomain String Platform String PoolThreadsPerProcessor DWORD PopBinding DWORD PopCheckInterval DWORD PopDenied Multi String PopEnable DWORD PopOversizeCheck DWORD PopOversizeNotifyAdmin DWORD MAILGATE MANUAL Technical Reference Indicates the maximum number of workstations remote IP addresses that are permitted to use the MailGate system at any one time Default is 99999 If the NT workstation licencing constraint was enabled during installation this value will be 10 Indicates the day of the month that the last oversized mailbox report was generated for the mailboxes with this feature enabled Used so that MailGate can know if it has already produced a report during the current day Controls whether Mailgate automatically minimizes itself on startup O don t minimize 1 minimize Name of NT server domain that is to be used for Pop account password validation Only available with Nt version Platform that Mailgate is running on will be Windows95 or WindowsNT Indicates the number of worker threads to create in the thread pool for each processor in
100. from the NT user database MAILGATE MANUAL Configuring MailGate 3 40 Mailbox Options There are a number of optional settings that can be made for each mailbox Follow the links below for more information on these Aliases more than one username Auto Reply to incoming mail Delete Incoming mail to the mailbox Forward mail to another account Collect mail from specific POP account Size warning for this mailbox Q Tip If you have a large number of mailboxes to create you can use a text file to enter the accounts See Load Accounts on page 3 36 for more information Aliases for a Mailbox An alias allows you to add other names for sorting into a mailbox This can be useful for people who have nicknames or change their names Aliases can be used to put several accounts into one local mailbox For example if you setup a SALES mailbox you could put INFO in as the alias Then any mail sent to either sales or info would go to the same local mailbox Aliases can also be used to put a message into multiple mailboxes For example if you want to have mail sent to SUPPORT yourcompany com copied to all the technical support people you can put SUPPORT in as an aliases in the setup for each local mailbox See Planning Mailboxes Advanced Example on page 2 11 for more information Auto Reply to Mail Auto Reply sends a mail message back to the sender for each message received in the local mailbox For example this could be used to
101. he function completes asynchronously Details of this mechanism will be provided in the developers guide to the scripting language lt type gt give the return type of the function which can be string or integer Functions that don t return a value can be defined by omitting the as lt type gt section of the statement lt library gt gives the filename of the external function library Thus some example external function definitions would be external OpenFile string as integer in c external external d1ll MAILGATE MANUAL Technical Reference 9 8 external CloseFile integer in c lexternallexternal dl1 external Output string in c external external dll external IntToStr integer as string in c external external dll Functions that return integers can be used in integer expressions and those that return strings in string expressions For example file OpenFile test txt aS IntToStr 32 Comments in Scripts Comments can be added to scripts by preceding them with as per the C convention This turns the rest of the current line into a comment Comments do not effect the execution speed of the script For example This is a comment So is this a 1 Set a to the value 1 Scripting Functions Functions for Scripting There are a number of standard functions available when using the MailGate scripting language These are listed below with full det
102. hould start and end 3 Check the box to enable the schedule 4 Select the type of schedule from the drop down list gt Types of schedules See Using the Scheduler on page 2 25 for more detail on the types of schedule available Notes 1 To schedule for the whole day use the start time of 0 0 and the end time of 23 59 2 If MailGate is not running when an event is scheduled such as mail transfer it will not happen until the next scheduled time MAILGATE MANUAL Configuring MailGate 3 39 Maintaining Mailboxes Mailbox Detail Screen Mailbox Settings AES Mailbox name I Password Confirmation Aliases Advanced modes T Automatic reply T Delete incoming T Forward copy to Edit List I Collect from POP a c Details T Size warning at 103 MB OK Cancel Help Figure 28 Mailbox Settings Each user should be given a mailbox account within MailGate It is this account from which the mail will be collected by the users mail client To create a new mailbox click on the de icon on the toolbar or select Edit New Mailbox To edit an existing mailbox highlight it and select Edit Edit to display the mailbox detail screen You must give the mailbox a name and password The mailbox name can be a full email address or just the user part part before the 0 Note if you are using the NT users option in the Gateway Advanced NT Users Tab the password will be taken
103. ilGate starts its alarm process Default is zero disabled other values give timeout in minutes Login account for the backup RAS configuration Stored as an encrypted string 9 34 Registry Parameters cont RasBackupEntry String RasBackupPassword String RasEmailFailure DWORD RasEntry String RasPasswordEx String RasPopAccessCheck DWORD RasPostDialCmd String RasPostDialTerminate DWORD RasPostDialTimeout DWORD RasPostDialWait DWORD RasPreDialCmd String RasPreDialTerminate DWORD MAILGATE MANUAL Technical Reference Name of the Ras phonebook entry to be used for establishing a dialup connection if the primary entry is unavailable Backup login account password for dialup Stored as an encrypted string Controls whether or not Mailgate generates an error email message in the default mailbox when there is a failure to connect to the ISP using RAS This value is not normally present and defaults to 1 If you wish to change the setting add the setting using the registry editor O don t report errors 1 report errors Name of the Ras phonebook entry to used for establishing a dialup connection If blank no RAS dialup is undertaken and Mailgate assumes there is a permanent routed Internet connection Login account password for RAS dialup Stored as an encrypted string Controls whether Mailgate checks to see if a pop client session has connected to the Ras tcp i
104. ill run the MailGate Server program gt MailGate Requirements 1 Connection to an Internet Service Provider This can be a direct line or a dial up connection 2 TCP IP installed on all machines in the network that use MailGate 3 Dial Up Networking installed on the machine running MailGate If you have a leased line connection you do not need Dial Up Networking gt TCP IP Networking Requirements 1 A unique TCP IP address for each computer 2 Aunique machine name for each computer optional 3 Network domain name optional 4 Either Domain Name Service DNS or LMHOSTS HOSTS files for name resolution on the network optional Q The simplest setup for TCP IP is to use static addresses on your network With this you give each machine a unique IP number address and when you refer to that machine in you software settings you specify only the IP number If you use this method you can ignore all references to machine names If you are unfamiliar with TCP IP please see Preparing for TCP IP Installation on page 7 2 for more information Note Windows 3 1x and Windows for Workgroup TCP IP configuration is not covered in this document as there are so many TCP IP programs with their own requirements MAILGATE MANUAL Network Preparation 7 1 Get more information For more information read the sections for the appropriate operating system How can I tell if TCP IP is installed Window 95 98 Window
105. ing mail will be held until the next scheduled mail exchange Reject SMTP messages bigger than MailGate will reject messages from your users if they are larger than the maximum size in kilobytes Note this option is intended to prevent accidental sending of extremely large messages and if triggered it simply cuts the user connection when they try to send the message This will normally cause an error in the users mail client and should therefore be set with caution The default setting of o disables the option MAILGATE MANUAL Configuring MailGate 3 12 SMTP Authentication Details Smtp Authentication 2x Authentication Mode ARTIE Auth Username Auth Password Cancel Help Figure 14 Smtp Authentication Details Some ISP s require you to use Authenticated Login to their SMTP server before you can send a mail This is used to prevent unauthorised relaying of mail through the server MailGate provides support for the Auth Login method of authentication which requires a username and password to be sent to the server before sending the mail Authentication Mode Use the dropdown to select the authentication mode to use Three modes are available 1 No Authentication Select this if your ISP does not require authentication 2 Dialin User Pwd Use the Dialin username and password specified on the Dialup tab for login to the ISP s server 3 Specified User Pwd Use the username and password specified on th
106. ing variables Integer and string assignments Integer and string arithmetic statements Integer Boolean statements If then else constructs Labels and jumps Subroutines Repeat until constructs For to downto step next constructs Inclusion of external source files Definition of external functions Using comments MAILGATE MANUAL Technical Reference 9 3 Integer and string variables Variables are defined when an assignment to them is first made and they then exist for the duration of the script execution Variables are of two types either integer or string They are named with alphanumeric characters names are non case sensitive and must start with a alphabetic character Integer variables are indicated by ending the name with a and strings with a String and integer variables of the same name are permitted Some example variable names a Integer variable A A Integer variable A same variable as previous a String variable A exists as a separate entity to integer variable A testi23 String variable TEST123 123test Invalid variable name names must not start with a digit Integer and string assignments Variables are created when assignments are made to a previously uncreated variable The following statements would create and initialise some variables a 1 b 2 test Hello You can also initialise new variables to the value of an already existing variable of the same type a
107. internally MAILGATE MANUAL Technical Reference 9 14 Function Gethostbyname lt Host gt Parameters Host to obtain information about Return Type Integer Operation Gets host information available for the passed hostname and stores it in an internal buffer The getnumhosts getnumaddrs gethost and getaddr functions can then be used to access the information Returns zero if successful or socket error code if not Function Gethostbyaddr lt Addr gt Parameters Value Type Description lt Addr gt integer IP address as 32bit network byte ordered value to obtain information about Return Type Integer Operation Gets host information available for the passed address and stores it in an internal buffer The getnumhosts getnumaddrs gethost and getaddr functions can then be used to access the information Returns zero if successful or socket error code if not Function Getnumhosts Parameters None Return Type Integer Operation Returns an integer value giving the number of hostnames available in the internal buffer filled by the last call to gethostbyname or gethostbyaddr Returns zero if no information is available because gethostbyname or gethostbyaddr has not been called yet or the last call returned an error MAILGATE MANUAL Technical Reference 9 15 Function Getnumaddrs Parameters None Return Type Integer Operation Returns an integer value giving the number of addresses a
108. ion Returns a string of the lt count gt rightmost characters from lt string gt If the length of lt string gt is less than lt count gt the whole of lt string gt is returned MAILGATE MANUAL Technical Reference 9 11 Function Mid lt String gt lt Start gt lt Count gt Parameters Value Type Description String to extract portion from Start position to extract portion Number of characters of lt string gt to return Return Type String Operation Returns a string of lt count gt characters starting from position lt start gt from lt string gt If there are less than lt count gt characters after position lt start gt in lt string gt a string of the available characters after lt start gt is returned If lt start gt is a position after then end of lt string gt a blank string is returned Function Pos lt String gt lt Substring gt Parameters lt Substring gt Seach string Return Type Integer Operation Returns the position of the first occurrence of lt substring gt in lt string gt If lt substring gt does not exist in lt string gt returns zero Function Ascii lt String gt Parameters String to get code for Return Type Integer Operation Returns the ASCII code for the first character of the passed string expression as an integer value MAILGATE MANUAL Technical Reference 9 12 Function Chr lt Integer gt Parameters ASCII code to convert to
109. ions Whichever method is used select the Connection tab This allows you to configure the proxy settings gt Internet Explorer Version 5 If installed on the machine where MailGate is running In the Tools Internet Options Connections dialog 1 Select the Never Dial a Connection radio button 2 Select EACH dialup account and open the settings page Ensure the setting has Use Proxy Server checked and enter the IP address or name and port of the MailGate server 3 Press the LAN settings button and enter the IP address or name and port of the MailGate server here also On all other client machines you should only have to enter the LAN settings and point to the MailGate server step 3 gt Internet Explorer Versions 3 and 4 In the Connection Tab Configuration 1 Inthe HTTP dialog enter the IP address or name of the MailGate server generally mailgate 2 Check the Use the same proxy server for all protocols box 3 Click OK MAILGATE MANUAL Configuring Clients for MailGate 8 2 Note You will usually only need to set exceptions if your network is complex and contains multiple servers and routers or if you are running a local Intranet web server Consult your Network Administrator for more information Netscape Proxy Configuration Configure Netscape Version 4 1 Select the Edit menu and click on Preferences 2 Double click on Advanced in the tree on the left 3 Select Proxies 4 Select the Manual Pr
110. iority Email Trigger enabled option allows mail to be sent immediately if it contains a priority field When MailGate receives mail to send out it reads the mail header looking for a Priority field in the header MailGate will read both a Priority and X Priority field If the priority is set High and Priority Mail Trigger is enabled in the scheduler MailGate will connect immediately and send all waiting mail MAILGATE MANUAL Using MailGate 2 26 If the Priority Mail Trigger is not enabled the mail is sent on the next connection to your ISP You can set the day s of the week and the hours that this schedule is enabled Minimum redial time An amount of time that must pass between the last mail collection and the time this schedule is to run For example The minimum redial is set at 5 minutes MailGate is scheduled to collect mail on the half hour At 10 20 during a proxy connection MailGate checks for new mail At 10 30 priority email is received by MailGate Since the minimum redial time has passed MailGate will send the mail immediately At 10 33 another priority email is received This time MailGate will wait until 10 35 to send the mail Outgoing Email Trigger Schedule The Outgoing Email Trigger enabled lets you set a time period where MailGate will connect as soon as it receives mail to be sent to your ISP You can set the minimum redial dial time Minimum redial time An amount of time that must pass bet
111. is dialog for login to the ISP s server Use this option if you do not use dialup or you dial into another provider Enter the SMTP account username and password to use if you have selected the Specified User Pwd mode MAILGATE MANUAL Configuring MailGate 3 13 LAN Forward Tab Dialup POP Domains EMail Lan Forward The WEB ES Add rules to control SMTP forwarding to other systems on your LAN Address Match Add Edit Delete Default Sender mailgate V Send admin message for failures figure 15 LAN Forward Tab The LAN Forward function is used when you have multiple SMTP mail servers on your network or if you wish to use MailGate as a mail collection and delivery agent for another server for example MS Exchange In the LAN Forward tab you specify any number of mail address patterns to look for and decide which messages should be forwarded to another server Use the Add Edit buttons to create or change these address patterns using the Lan Forward detail dialog on page 3 15 Example if you have two offices and the following setup 1 All mail to the main office is directed to name company1 com 2 All mail to the remote office is directed to name company2 com 3 The remote server is named Remote1 Then the MailGate rule for LAN Forward would be Ocompany2 com forward to Remotel MAILGATE MANUAL Configuring MailGate 3 14 Main Office Remote Office ES r E Desktop RE Desktdp PC Desk p
112. ist of your local mailboxes See Maintaining Mailboxes on page 2 14 for more information Each mailbox is shown with the number of messages currently stored and the amount of space used Outgoing Queue Shows a list of all mail waiting to be sent out from MailGate to your ISP See Using the Queue on page 2 16 for more information URL Filter List Shows the list of URL filters that are setup to allow or deny access to the Web from specific machines or to specific Web sites See Using URL Filters on page 2 18 for more information Note the icon is dimmed if a filter is setup but not currently enabled Custom Proxy List Shows a list of any Custom Proxies that you have setup See Using Custom Proxies on page 2 22 for more information Note the icon is dimmed if a Custom Proxy is setup but not currently enabled MAILGATE MANUAL Using MailGate 2 5 Extensions List Shows a list of any Extension Modules you have installed See Using Extensions on page 2 31 for more information Note the icon is dimmed if an Extension is installed but not currently enabled Connection History Shows information about the last 25 connections MailGate has made See Using the Connection History on page 2 30 for more information You can click on each connection report and expand it for more details Note a green tick indicates a good connection and a red X indicates there has been an error message in the connection Administrator Window Status
113. it s own enabling schedule These schedules schedule set the days of the week and the start and end time that the proxy service can be used By default all the services can be run at any time Use the scheduler to limit the time period Keep Connected Schedule The Keep Connected schedule keeps the line connected during the specified time period If the connection is lost for any reason MailGate will re connect the next time the line is requested Timeout Override Schedule Many telecommunications providers vary their charges according to the time of day and or day of the week The Timeout Override schedule allows you to define a call timeout profile to match your telecommunications provider The schedule defines both the minimum call time and the subsequent timeout within a given overall time period Example Your telecommunications provider charges a minimum of one unit and then uses per second billing At the weekend one unit is 5 minutes but during the week one unit is 3 minutes You wish to ensure the best use is made of the unit cost but ensure the line is dropped within 1 2 a minute when per second billing is on Timeout Schedule 1 e Check days for Monday through Friday e Setthe minimum call to 0 3 3 minutes MAILGATE MANUAL Using MailGate 2 28 Set the timeout to 0 30 30 seconds Set the start time to 00 00 and the end time to 23 59 Check the schedule enabled box Timeout Schedule 2 Check the days
114. ks for an ERRORS HTML and LOGO GIF in the MailGate installation directory If these files are not found it uses its own internal file gt Format of ERRORS HTML MailGate installs an ERRORS SAM file as a sample for creating the ERRORS HTML file Errors html is a standard html page with a couple of comments in it to mark where MailGate adds error specific info The two tags are lt head gt Immediately after this text string MailGate will put a short message to be used as the title of the web response i e what appears on the browsers window bar You could put this in the main body of the html as well instead if you wish lt error gt Immediately after this text string MailGate will put the text of the error message gt Referencing an Image MailGate also supports the insertion of an image into the page The image has to be referenced by the GUID string AFo0E4B6 C3Fo 11d1 86AC 0080C8330493 logo gif This is done so the separate request the browser will make for the image can be identified and not proxied like other requests The response to this request by MailGate is to send back the image stored in LOGO GIF file MAILGATE MANUAL User Reference 5 1 6 Solving Problems Using the Log Files MailGate logs all activity in a daily log file stored in the LOG folder under the MailGate system directory The file name used follows the format MG lt yymmdd gt LOG Using the Logging see 3 37 menu item you
115. l Domain In addition to the domain name it is possible to specify a specific user address to be included or excluded from the local list For example if the Domains tab contained mydomain net Mail to anyone mydomain net would be handled locally unless an exception is listed below 4jim mydomain net The negates the rule so that mail to jim mydomain net will be sent externally to your ISP This is useful for organizations with more than one office but only one email domain If most mail is to be sent to your ISP you can list only the user IDs that should be sent locally Note that the domain name is not specified jim mydomain net fred mydomain net So those particular accounts are local and anything else in a domain MAILGATE MANUAL Configuring MailGate 3 9 gets sent by your ISP gt Unknown Local Address Handling If MailGate does not know in which mailbox to place a message it looks to this option to decide what to do You can 1 Have the mail returned to the sender This will be done including a standard failed delivery message If you wish to create your own message create a text file containing your message using the file name bounce txt and place in the MailGate system folder 2 Have the mail sent to a specific MailGate mailbox For more information see How MailGate Sorts into Mailboxes on page 2 12 MAILGATE MANUAL Configuring MailGate 3 10 Email Tab Dialup POP Domains EMail Lan Forward The W
116. l standard for transmission over digital lines running at 64 Kbps ISP Internet Service Provider The company that provides you with your connection to the Internet MAILGATE MANUAL Glossary of Terms 11 2 LAN Local Area Network is a system connecting multiple computers together Localhost A special TCP IP address which refers to the current machine Also known as the Loopback address Uses the reserved IP address of 127 0 0 1 NNTP The mechanism and underlying standard for processing News in Internet newsgroups POPS Post Office Protocol 3 is an advanced Internet mail service that allows your ISP to store your mail for you until you dial in You may also be able to store collected mail for reference for a certain time With this protocol the Recipient contacts the Sender and requests the data PSTN Public Switched Telephone Network The worldwide voice telephone network RAS Remote Access Server The Microsoft Windows software application for managing dialup connections Router A computer system that stores and forwards data packets using network addresses from one network to another Server A computer that holds applications or data shared by users on a network SMTP Simple Mail Transfer Protocol is used to send e mail across the Internet With this protocol the Sender contacts the Recipient and transmits the data MAILGATE MANUAL Glossary of Terms 11 3 SOCKS SOCKS is a network
117. line specify NO DIALUP in the Dial Up Entry For more information see Dialup Tab on page 3 3 MAILGATE MANUAL Using MailGate 2 9 POP Tab The POP Tab lists the mailboxes to collect These can be from any mail server than can be reached through your ISP connection For each account you must specify the account name password and mail server to collect from For more information see POP Tab on page 3 5 gt Domains Tab The Domains Tab specifies any domain that you want to handle on your network and not forward to your ISP This allows mail to be sent from one local mailbox to another local mailbox without sending via the remote ISP mailbox es The Domains Tab also specifies how to handle unknown addresses whether to return to the sender or send to a specific MailGate mailbox For more information see Domains Tab on page 3 9 b Email Tab The Email Tab enables the Mail Server within MailGate For outgoing mail you must also specify the mail server used by your ISP For more information see Email Tab on page 3 11 Lan Forward Tab The Lan Forward Tab enables MailGate to forward mail to another mail server on you LAN using SMTP This could be another copy of MailGate or servers such a Microsoft Exchange or Lotus Notes You define an address pattern match to use when deciding which mail is to be forwarded For more information see Lan Forward Tab on page 3 14 Using Mailboxes MAILGATE MANUAL Planning M
118. llowing gt Internet Connection Ensure you have established your method of connecting to the Internet See Internet Connection Requirements on page 1 9 for more detail gt The Realtime AV Tab on page 3 20 Enable the RealTime proxy Optionally you can alter the port used for this service MAILGATE MANUAL Using MailGate 2 21 Using the Liquid Audio Gateway The Liquid Audio proxy will pass Liquid Audio client requests to the Internet To use the Liquid Audio proxy you should set your Liquid Audio client to use a proxy and specify the MailGate server address For more information about LiquidAudio see www liquidaudio com You can control your users access to this service in a number of ways See the links below on how this may be done Bl Setting Advanced Security on page 3 25 22 Using the Scheduler on page 2 25 To use Liquid Audio proxy you will also need to consider the following gt Internet Connection Ensure you have established your method of connecting to the Internet See Internet Connection Requirements on page 1 9 for more detail gt The Liquid Audio Tab on page 3 23 Enable the Liquid Audio proxy Optionally you can alter the port used for this service Using Custom Proxies Using Custom Proxies The Custom Proxy facility allows you to create your own proxy services to pass non standard protocol or client requests to the Internet A default installation of MailGate includes two example
119. lt account gt forwardex List of addresses to forward copy of email Multi String delivered to the account to lt account gt password Password for the account stored as an encrypted String string lt account gt popaccount Account to collect email from direct into String account stored as an encrypted string Only used if the flags value has the pop collection flag set lt account gt popleavedays Number of days to leave email on the pop server DWORD after collection before deleting Only used if the flags value has the pop collection flag set lt account gt poppassword Password to account to collect email from direct into account stored as an encrypted string Only used if the flags value has the pop collection flag set lt account gt popserver Ip address or name of pop server to collect email from direct into account stored as an encrypted string Only used if the flags value has the pop collection flag set Counters This key is used to store the number of active sessions of each type of facility in Mailgate It is a volatile key and the values contained within are not user changeable MAILGATE MANUAL Technical Reference 9 44 10 The Log File Viewer Introduction to the Log File Viewer The Log Viewer is a utility program supplied with MailGate to make the task of monitoring and reviewing the MailGate log files easier The Log File Viewer is installed as part of your MailGate installation process and is rea
120. me and return address 3 Select Hosts and enter the SMTP address this is the MailGate server IP address or name 4 Select Auto Configure and fill in the Server Name this is the IP address or name of the MailGate Server Enter the user name and password for the MailGate POP mailbox 5 Click OK to accept all changes MAILGATE MANUAL Configuring Clients for MailGate 8 5 Agent Free Agent Mail Configuration 1 Select the Options menu and click on General Preferences 2 Select User tab and fill in your email and other personal details 3 Select System Tab and enter the IP address or name of the MailGate server under both the mail and news server Virtual Access Mail Configuration In Version 4 0 of Virtual Access do the following 1 Select the File menu and click on Comms Setting 2 Select the Internet service to configure 3 Onthe MAIL tab set the outgoing and incoming mail server as mailgate More Information Check our web site www mailgate com for more detailed information on configuring clients MAILGATE MANUAL Configuring Clients for MailGate 8 6 FTP Client Configuration FTP Client Configuration You use an FTP client to access an FTP server for uploading or downloading files Often this is the method used to maintain a web site FTP via Browsers If your browser has already been configured to use the MailGate HTTP proxy server then you need do nothing further for FTP under HTTP to work through the bro
121. mes MAILGATE MANUAL Network Preparation 7 3 Windows 95 98 Network Preparation MAILGATE MANUAL Windows 95 98 Network Preparation The following topics cover network preparation issues for Windows 95 You will need the following information 1 The TCP IP addresses and machine names optional for all machines in the network 2 Your domain name optional If you are unfamiliar with TCP IP please see Preparing for TCP IP Installation on page 7 2 for more information For more information see 22 How can I tell if TCP IP is installed below Bal How do I setup the machine address on page 7 5 1 How do I enable DNS on page 7 5 Ba How do I setup the LMHOSTS and HOSTS files on page 7 6 Bal How do I setup Dial Up Networking on page 7 7 TCP IP Install for Windows 95 98 To check to see if TCP TP is installed on Windows 95 or 98 do the following 1 Click on the Start Menu and select Settings and from the Settings menu select Control Panel 2 From the Control Panel wndow select Networks 3 Onthe Configuration tab TCP IP should be listed gt IfTCP IP is not listed 1 You will need to obtain the Win 95 Installation CD ROM 2 On the Configuration tab press the ADD button select protocol and then select Microsoft in the left hand dialog and TCP TP in the right hand dialog and click OK 3 Follow the instructions from the setup program For detailed information on TCP TP installation please consult the Microsoft hel
122. n this mode you can think of the MailGate system as a single program You can switch MailGate into desktop mode by unchecking the Gateway Run as Service menu option To switch back to service mode simply re check this option Be aware that when in desktop mode MailGate s services will only be available to your network users whilst the admin program is running Logging off your desktop session for example will stop the MailGate services For this reason we advise that for normal operation you stay in service mode See also Command Line Options on page 2 8 MAILGATE MANUAL Using MailGate 2 7 Command Line Options As long as the MailGate service is started you can use either of the following command lines to start an email connection and transfer mailgate connect mgatesve connect In addition the mailgate exe program can be used to start or stop the MailGate service from a batch file or script mailgate start Starts the service mailgate stop Stops the service The mgatesvc exe program can be used with the following command line options mgatesvc start Starts the service mgatesvc stop Stops the service mgatesvc install Installs mgatesvc as a system service mgatesvc remove Removes mgatesvc from the system services mgatesvc console Runs the mgatesvc process on the desktop in a console window See also Starting MailGate on page 2 7 MAILGATE MANUAL Using MailGate 2 8 Using the Mail Server Mail Server Pl
123. nal If you are unfamiliar with TCP IP please see Preparing for TCP IP Installation on page 7 2 for more information For more information see 22 How can I tell if TCP TP is installed on page 7 9 Bal How do I setup the machine address on page 7 9 22 How do I enable DNS on page 7 10 Bal How do I setup the LMHOSTS and HOSTS files on page 7 10 Bal How do I setup Dial Up Networking on page 7 11 Note This section covers only the basic installation and setup for a small network This section does not cover Windows NT Server setup with Primary Domain Controllers multiple networks or domains etc For complex network setups please consult your system network administrator MAILGATE MANUAL Network Preparation 7 8 TCP IP Install for Windows NT 4 To check to see if TCP IP is installed on Windows NT 4 0 do the following 1 Click on the Start Menu and select Settings and from the Settings menu select Control Panel 2 From the Control Panel window select Networks 3 On the Network dialog select the Protocols tab TCP IP should be listed here gt IfTCP IP is not listed You will need to obtain the NT Installation CD ROM 1 2 3 On the Protocol tab press the ADD button and select TCP IP Follow the instructions from the NT setup program For detailed information on TCP IP installation please consult the Microsoft help files and documentation b If TCP IP is listed Check the following TCP IP
124. ncvtvcceesesttornesveneeveestesends fevsendentveeeseyisueetopevevnseduedenguseveesvevessuesnesvecedesesssets 3 25 GaLEWAY ADVANCED SCLUP ori ii Stee seats AAA AAA ia tidad 3 25 SECULAR N O E RE A E R ER N E OE 3 25 low OF DENY A COCSS anii ii R N E R EE RT OORA 3 26 VAPI E A E E E E E EE EE E T E E 3 28 LUNE OULS LADA A S E TE A E E A 3 29 SMIPR AY LA diia ts 3 31 IND USCIS LAD lt A E E 3 33 BACKUP AND RESTORE CONFIGURATION c ccccsssssssseessesecssesscsesescssesssesecssessesessessesssesecseessesessessesesnesseeseens 3 34 BACKUDSC ONfIQUILLLION a a a eii rai 3 34 Restore CONE O a a a A O A A pana 3 34 MAILGATE MANUAL Contents LARGE POP MESSAGE CONTROL sossies ceecavensuniab es dave bugs su sdeu ea deataven E T EAr ales 3 35 Large POP Message Control moiiiininuicnicninonnc enn 3 33 LOAD ACCOUNTS cose e Aeree sorea ena Ere EEN NEE rE EEE EEE EEEE E EETA pedian ect rE USEE EEEE N S EE ES 3 36 LOGE A CCOUNIS aiii 3 36 LOGE Accounts Detall orisirisii kE aA EEES EAEE EAA REEE E i EEE RETS EAE EE 3 36 LOGGING INFORMATION rosee seus siete on teste ore EE EEE tanbevnesteuvesecuvgecns E ESEE Are TE upeveus EEE SE ESOK En SEA Era R 3 37 Pute LOBELL UES crniiin aia 3 37 VETE EEE EA E T EE TN 3 37 MAINTAINING SCHEDULES eessen eseeto rouee Ee ores Neas EEEO NSE N E SS EESE EE dbverdecuostvens OPNE ESES TESNE ER 3 39 Schedule DAIES TC Mii ida 3 39 MAINTAINING MAILBOXES sesseur erant e roar ea rE Nns NEE EErEE NEE EET E Sea EEEa EES ESEE vies tesbentvecc
125. ne string value InstallPath which the install script writes to enable it to easily find the installation for future upgrade installs There are also number of registry key sections under this location discussed in the following sections Parameters Most of the MailGate general settings are stored in this key The values and purpose are as follows Value Name Data Type AlwaysCheckMail DWORD CopyOutgoing String Debuglt DWORD DefaultMailbox String Description Controls whether Mailgate checks for new email at the start of any new connection or only when a connection is established by a mail collection schedule 1 always collect O only for mail collection schedules Name of local account to receive copies of all outgoing email or blank string if no copies to be made When set to non zero value each time mgatesvc is started it will create a log file debugit log in the mailgate root directory This log will received detailed protocol and i o information that can be used by the developers to diagnose problems Default is o and this value should not be altered unless under the direction of MailGate support staff Name of local account to receive messages that can t be delivered to a local account by the routing rules and automatically generated admin messages MAILGATE MANUAL Technical Reference 9 27 MAILGATE MANUAL Registry Parameters cont DisconnectMode DWORD DnsAlternativeDelay DW
126. net and NNTP traffic through MailGate For more details see 22 Using Custom Proxies on page 2 22 22 NNTP Custom Proxy on page 2 23 B Telnet Custom Proxy on page 2 23 To create a new Custom Proxy click on the 3 icon on the toolbar or select Edit New Custom Proxy To edit an existing entry highlight it and select Edit Edit to display the Custom Proxy detail screen To configure your Custom Proxy follow these steps gt Required Entries Title Give your proxy a title Proxy Enabled Check this box to enable the proxy This proxy listens on port Enter the port number your users will use to connect to the proxy MAILGATE MANUAL Configuring MailGate 3 47 For Select the type of data traffic Use streams for TCP traffic like HTTP and Datagram for IP traffic ike DNS Not required if you use a script Valid Requests are passed through to Specify the remote host machine this proxy should connect to Not required if you use a script On Port Specify the port number to use when connecting to the remote host Not required if you use a script Run Script Check this box if you wish to use a MailGate script Use the edit button to edit your script See Introduction to Scripting on page 9 3 for more detail on the MailGate scripting language gt Optional Settings Security Use the Requests are permitted and denied boxes to control which machines can access this proxy This is similar to the settings
127. nsock is out of buffer space ime Out Host Unreachable Name lookup Authoritative answer Host not found Name lookup Valid name no data record MAILGATE MANUAL Solving Problems Likely Cause here is a lock or failure to connect Try again later he remote system terminated the connection for some reason Can also be caused by net overload causing a timeout or a failure in your Internet connection Generally caused by a IP address loop Carefully check your IP configuration In particular check you have not set Use ISP proxy Server Web Tab or DNS Servers DNS Tab to point at MailGate IP has timed out connecting to or communicating with the host Check the host IP address is valid and that the service you are trying to use is available Try again later he connection to the host machine has failed Check the host IP address is valid and that the service you are trying to use is available Try again later A DNS lookup problem The connection to the host machine has failed Check the host TP address is valid and that the service you are trying to use is available he DNS server queried does not have data for the request made Check that the service you are trying to use is available 6 2 7 Network Preparation Network Requirements Network Requirements This section covers the system setup for machines on the network that will connect to the MailGate Server and the machine that w
128. nternet Service Provider e Sorts and distributes mail to your users and may have other functionality such as automatic forwarding of mail See What can the MailGate Server Do on page 1 5 for more information To send and collect your mail your client mail program connects to the local mail server The diagram below shows how a simple mail server works A Desktop PC Send and collect mail from ISP Internet Service Provider Pin Desktop PC MailGate Server 1 Each machine sends their mail to the MailGate Server to send and connects to the Mailgate Server to collect their mail Desktop PC Figure 7 Simple Mail Server To continue learning about mail and mail servers see 221 What are POP3 and SMTP mail on page 1 3 22 What can the MailGate mail server do on page 1 3 Getting Started 1 2 What can the MailGate Mail Server do In addition to collecting sorting and sending mail MailGate has a number of features to make management of your email easy Here are some examples of the more common features gt Automatic Replies MailGate can send a preset message any time mail is received in a specific mailbox For example e if someone mailed to info yourdomain you could send a specific information message back as email e you can also set this to reply that you are on vacation for a specific period and who they should contact in the meantime gt Automatic Forwarding MailGate can automatically forwar
129. nts on these values For example as 1 and b 2 would evaluate to TRUE if a was equal to 1 and b was equal to 2 If then else endif The if statement comes in two forms the single line form and the multiple line form If the whole if then statement is on one line the endif is not needed If the statement is split of a number of lines the statement must be terminated with endif For example if as 1 then b 2 or if as 1 then b 2 endif The else section of the statement is optional You can separate statements with the amp character which acts as a statement separator You may also use this statement separator anywhere in a script You can join lines of a script to be treated as a single line with the _ character again this can be used anywhere in a script MAILGATE MANUAL Technical Reference 9 5 Some more example if statements if a lt 3 then b 1 amp c 2 else b 2 cs 1 if as 1 then if b 2 then o9 c 1 endif endif Notice that nesting of statements is supported Labels and jumps Unlike BASIC the script language does not have line numbers It supports jumps but you do this by defining labels in the script A label is given a text value and is defined by proceeding it with a s For example testlabel would define the label testlabel at the particular point in the script You can jump to labels with the goto statement The goto statement is foll
130. og on page 3 45 gt Order of Filters The order of the filters is important When there are multiple filters MailGate uses the first filter entry it finds with a match for both the machine name and the URL and will act on the Allow Deny setting You can drag and drop the filters in the main MailGate window or use Move Up Down on the right mouse button menu to change the order For example if you want to limit access only to a few specific web MAILGATE MANUAL Using MailGate 2 18 sites on all machines you would list the ones they could access first and the last URL filter would deny access to all other web sites e Allow access to www macromedia com by all machines e Allow access to microsoft com by all machines e Allow access to mailgate com by all machines e Deny access to by all machines You can have the machine and URL patterns in different filters e Deny access to sex by all machines e Allow access to by MACHINE1 e Deny access to by MACHINE2 Machine can access the web but not any sites with the letters SEX in them Machine2 can not access the web at all Using the FTP Gateway The FTP proxy will pass FTP protocol requests to the Internet To use the FTP proxy you should set your workstation FTP client to use a proxy or firewall MailGate requires the client to pass the target FTP host and user name to the proxy in the format USER userid hostname You can control your users ac
131. ollection dialog box with details for each account See POP Collection Details on page 3 6 for more information on individual account settings gt Options In the options section of the dialog you can tell MailGate how often to check for incoming mail while the connection is active for a proxy session and you can adjust the length of time MailGate will wait while inactive before dropping the connection O All mail collected by these settings will be passed to the mail routing system See How MailGate Sorts into Mailboxes on page 2 12 for more detail on this process You can also collect mail by setting a pop collection against a user mailbox In this case the sorting process is bypassed See Maintaining Mailboxes on page 3 40 for more detail on this option MAILGATE MANUAL Configuring MailGate 3 5 POP Collection Details The POP Collection dialog has the details for each POP account that MailGate collects from It may also be used to trigger other processes such as starting an SMTP mail feed from your ISP POP Collection 21x E Set pop account and routing details for Options a email collection Custom header a rae RE field for routing Address filter x Pop account pattem s Pop password zi Remove Pop server occurances of Leave email on server for 4 days Map address Run external command m Telnet tickle Connect to Before C After C Command only JW Wait on port 23 4 I
132. onnection is in use all the normal facilities of the Log File Viewer are available for use O About Event Types To reduce the bandwidth requirement when remote viewing you should take care to only view those event types you need to see The event filtering is performed at the remote system so network traffic is kept at a minimum This may be particularly important if viewing across a remote TCP IP link Using Command Line Parameters The Log File Viewer utility may be started from a command line or shortcut with a number of parameters which will establish the remote connection on startup These parameters are remote lt server gt lt port gt pwd lt password gt flags A TJ WI E OILS where A All I Info W Warning E Error O 1 0 S System event types Note If no flags parameter is specified the flags used for the last remote connection are assumed Example command line mglogvwr remote 192 168 1 1 pwd secret flags WES MAILGATE MANUAL The Log File Viewer 10 6 11 Glossary of Terms Glossary of Terms ASCII American Standard Code for Information Interchange The set of 255 characters recognized by most computers These characters are plain text with no formatting information Browser or Web Browser A software program that receives and displays information from the World Wide Web WWW Cache A local store of information used to speed performance by servicing a request rather
133. ot exist or cannot be found the class op gt fopen call fails class op w Opens an empty file for writing If the given file exists its contents are destroyed class op a Opens for writing at the end of the file appending without removing the EOF marker before writing new data to the file creates the file first if it doesn t exist class op r Opens for both reading and writing The file must exist class op w Opens an empty file for both reading and writing If the given file exists its contents are destroyed class 0p a Opens for reading and appending the appending operation includes the removal of the EOF marker before new data is written to the file and the EOF marker is restored after writing is complete creates the file first if it doesn t exist class opt Open in text translated mode In this mode class kn CTRL Z is interpreted as an end of file character on input In files opened for reading writing with class op a class op fopen checks for a class kn CTRL Z at the end of the file and removes it if possible This is done because using class op gt fseek and class op ftell to move within a file that ends with a class kn CTRL Z may cause class op gt fseek to behave improperly near the end of the file Also in text mode carriage return linefeed combinations are translated into single linefeeds on input and linefeed characters are translated to carriage return linefeed combinations on output When a Unicode stream
134. owed by the label name terminated by a For example goto testlabel would jump to the above defined label Think of the symbols joining up to remember where to put the It is in fact not necessary to use the goto command and this can be omitted but was included for clarity The following would be equivalent to the above goto statement MAILGATE MANUAL Technical Reference 9 6 testlabel The most common use of jumps is in if statements For example if as 1 then goto testlabel if at 2 then testlabel Both of the above statements would jump to the label if the condition evaluated to true Subroutines Labels can also be used to mark the start of a subroutine Subroutines are called by the gosub statement and control returns to the calling point when the return statement is encountered for example gosub test end test as 1 b 2 return Notice the use of end to stop the program execution dropping through to the subroutine All variables are considered global and so subroutine script code can access variables created outside the subroutine and vice versa Repeat until constructs The repeat until construct repeats the enclosed statements until the logical expression evaluates to true For example count 1 repeat as 1 a 2 count count t 1 until count 10 You can nest repeat until statements if desired For to downto step next This statement of
135. oxy Configuration option on the right and press the View button 5 For each proxy that you will use enter the IP address or name of the MailGate server generally mailgate and the port it uses gt Configure Netscape Version 3 1 Select the Options menu and click on Network Preferences 2 Select the Proxies Tab 3 Select the Manual Proxy Configuration option and press the View button 4 For each proxy that you will use enter the IP address or name of the MailGate server generally mailgate and the port it uses Note The following are the standard ports for some common protocols Protocol Port HTTP 80 FTP 21 Socks 1080 More Information Check our web site www mailgate com for more detailed information on configuring clients MAILGATE MANUAL Configuring Clients for MailGate 8 3 Mail Client Configuration Mail Client Configuration Your mail client is used to collect mail from your personal mailbox in MailGate allows you to review this mail and create and send mail to other users To communicate with MailGate you will need to set the server details to use the MailGate IP address or name and the account details to refer to your mailbox in MailGate Note MailGate uses Internet standards to mail communications and any mail client that supports these standards can be used This section covers setting up several common mail clients for use with MailGate 22 MS Internet Mail on page 8 5 22 Eudora Mail
136. p files and documentation gt IfTCP IP is listed Check the following TCP IP setup requirements Bal How do I setup the machine address on page 7 5 Bal How do I enable DNS on page 7 5 l How do I setup the LMHOSTS and HOSTS files on page 7 6 Network Preparation 7 4 Setup machine address for Windows 95 98 To setup the network domain name for Windows 95 1 2 3 ii Click on the Start Menu and select Settings and from the Settings menu select Control Panel From the Control Panel window select Networks On the Network dialog select TCP IP gt your network adapter Press the Properties button and select the IP Address tab Check Specify an IP Address Enter a unique IP address Always check with your network administrator regarding your current TCP IP setup Some networks may have a server setup to assign IP address to machines on the network The machine where MailGate is installed should be setup with a specific IP address and not one obtained by a DHCP server This is to ensure that it always has the same IP address Enable DNS for Win95 98 To setup the network domain name for Windows 95 Optional 1 2 3 ii Click on the Start Menu and select Settings and from the Settings menu select Control Panel From the Control Panel window select Networks On the Network dialog select TCP IP gt your network adapter Press the Properties button and select the DNS Configuration tab
137. p interface rather than the lan one If it has Mailgate will keep the Ras connection open until the session ends This setting is not normally present and defaults to 1 If you wish to change the setting manually add the value using the registry editor o don t check 1 check Command to be executed immediately after to a RAS dialup session ends Indicates whether the post dial command process should be terminated if it runs for longer than the timeout value 1 terminated O don t Default 1 Amount of time in seconds that the post dial command is allowed to complete execution Default 300 Indicates whether the dialing process will wait for the completion of the post dial command 1 wait o don t Default 1 Command to be executed immediately prior to a RAS dialup Indicates whether the pre dial command process should be terminated if it runs for longer than the timeout value 1 terminated o don t Default 1 9 35 Registry Parameters cont RasPreDialTimeout DWORD RasPreDialWait DWORD RasSmtpAccessCheck DWORD RasUseExisting DWORD RealAudioBinding DWORD RealAudioDenied Multi String RealAudioPermitted Multi String RealAudioProxyPort DWORD RealAudioReadTimeout DWORD RealAudioTimeout DWORD RealAudioReadTimeout DWORD RegisteredTo String MAILGATE MANUAL Technical Reference Amount of time in seconds that the pre dial command is allowed to complete ex
138. p proxy value in seconds Controls whether ftp url requests made to the Mailgate web proxy are routed through the proxy server given in the HttpProxyServer setting or the request is made direct to the requested ftp server O direct 1 pass to proxy Controls whether http url requests made to the Mailgate web proxy are routed through the proxy server given in the HttpProxyServer setting or the request is made direct to the requested web server 0 direct 1 pass to proxy Controls whether https url requests made to the Mailgate web proxy are routed through the proxy server given in the HttpProxyServer setting or the request is made direct to the requested web server 0 direct 1 pass to proxy Timeout for socket write operations by the Http proxy service value given in seconds Indicates whether Mailgate is currently in the iconic minimized state or not Used at startup to restore Mailgate to the same state as when last used 0 not iconic 1 iconic Indicates whether Mailgate is currently in the zoomed maximized state or not Used at startup to restore Mailgate to the same state as when last used 0 not zoomed 1 zoomed 9 31 Registry Parameters cont KeepAliveMaxRequests DWORD LastId DWORD LicenseString String LiquidAudioBinding DWORD LiquidAudioDenied Multi String LiquidAudioPermitted Multi String LiquidAudioReadTimeout DWORD LiquidAudioTimeoutEx DWORD
139. pecific POP account directly into this mailbox You will need to specify the POP server name account name and password for the account to collect from You ISP will supply these details You should select the Login Method to use Most ISP s require the standard User Pass method If in doubt you should try this setting first NOTE This method of collection bypasses the normal routing logic specified in How MailGate Sorts into Mailboxes on page 2 12 and places all collected mail directly into this mailbox You should NOT collect mail from a given POP account by this route and by setting the account details in the Gateway Setup POP account tab Leave Mail on Server for x Days This option allows mail that you ve collected to be retained on your ISP mail server for the specified number of days This can be used as a backup or MAILGATE MANUAL Configuring MailGate 3 42 to allow you to collect the mail from different locations such as at home and the office This option requires your ISP supports the UIDL command for mail tracking If it is not working please consult your ISP Size Warning for a Mailbox A size warning can be set for each MailGate mailbox This may be useful if you set your users mail clients to leave a copy of mail on the server The mailbox sizes are checked daily When the mailbox reaches this size the following warning message is sent to the MailGate administrator Mailbox lt mailbox name gt ex
140. place the file in the systemroot system32 drivers etc systemroot is a variable used to describe wherever you have installed NT this need not be drive C Windows 95 98 and Windows 3 1x place the file in the directory where Windows 95 98 or 3 1x is installed Text for LMHOSTS and HOSTS The text in both these files is in the form ip_address lt tab gt machinename ip_address lt tab gt machinename You should enter each IP address and machine name in your network each on a single line Additional Requirement for HOSTS file The HOSTS file should always contain the following entry 127 0 0 1 localhost This address is used by many TCP IP programs MAILGATE MANUAL Network Preparation 7 6 Requirement for MailGate For the machine that is running MailGate the HOSTS file can have the name mailgate as well as the regular machine name for the IP address For example 192 168 1 30 sysmachine mailgate This allows users to enter the word mailgate instead of having to know the specific IP address of the MailGate machine Note If you have a Domain Name Server DNS setup for your network please consult your system administrator for details of setting up DNS for your network and these files Setup Dial Up Networking for Windows 95 98 Dial Up Networking must be installed on the machine that will run MailGate There are two steps with Dial Up Networking 1 Install the software 2 Configure for connecting to your
141. r Support Free Support for Registered Users All registered users are eligible for free technical support via Email All support Emails will be responded to but without guarantee as to the response time Email your support questions to support mailgate com including your serial number and the registered user name Chargeable Support Options Annual Support Contract A chargeable service that includes telephone support Please contact your dealer for further information Support for Evaluation Versions Support for evaluation users is freely available on an ad hoc basis by e mail response times cannot be guaranteed eval mailgate com Emailing for Support MailGate can be used to generate an email message for support Select Help Email for Support to access the Send Support Email dialog Create your email as follows Report Type Select the type of email you wish to send Select Logs to Include Use you mouse to select the log files that show your problem Note the log file name is MG lt yymmdd gt LOG Select other options Copy to System Reports Address if you would like to get a copy of your message Include Connection History to send a copy of your current connection history data Include Configuration to send a copy of your settings so we can replicate your setup Reply Address Enter the email address our support desk should reply to Message Please give as much detail as possible We would like to know
142. rated parts a mail server and proxy gateway Technical Definition Mail MailGate is a LAN POP3 and SMTP Email server with Internet Service Provider ISP connection integration for Internet email transmission and collection It supports Internet Server Providers based on SMTP or POP3 client delivery and works with many different POP configurations at the ISP end Gate MailGate is a full Proxy gateway for HTTP and FTP protocols Realtime Audio Visual Liquid Audio and the SOCKS TCP IP proxy server protocol In addition it will relay DNS requests and with the custom proxy feature you can setup proxies to do pretty much whatever you want The MailGate software package consists of e the mail and proxy server software e anadministration program to setup configure and control the servers e a setup wizard to get you started fast e a log file viewing utility to make fine tuning of the system easy e anumber of optional extensions to add extra functionality to your system MAILGATE MANUAL Getting Started 1 1 MAILGATE MANUAL Non Technical Tutorial For the non technical users most of us see the sections below to go over the terms and concepts used in MailGate Bl What is a Mail Server below Bl What is a Proxy Server on page 1 4 What is a Mail Server A mail server is a program that resides on one computer in your network that e Collects mail from your Internet Service Provider s e Sends outgoing mail to your I
143. rectly configured HOSTS file DNS or WINS server Optionally you can define both when the filter entry is active and enable or disable this entry in your filter list gt Order of Filter entries The order of your filter entries is important You can drag and drop the filters in the main MailGate window or use Move Up Down on the right mouse button menu to change the order When a user makes a request MailGate checks each filter entry in turn and uses the first match it finds for both the machine name and the URL acting on the allow or deny MAILGATE MANUAL Configuring MailGate 3 45 setting If the end of the list is reached and no match is found the request will be allowed Example You want to limit access only to a few specific web sites on all machines you would list the ones they could access first and the last URL filter would deny access to all other web sites e Allow access to www macromedia com by all machines e Allow access to microsoft com by all machines e Allow access to mailgate com by all machines e Deny access to by all machines For more information see Using URL filters on page 2 18 MAILGATE MANUAL Configuring MailGate 3 46 Maintaining Custom Proxies Custom Proxy Details Figure 30 Custom Proxy Settings The Custom Proxy facility allows create your own proxy gateways so MailGate can proxy non standard protocols MailGate is installed with two examples that you can use to proxy Tel
144. requent connections to your ISP for DNS requests you may want to increase the Disconnect After setting The line will be open a little longer but MailGate will make fewer phone connections This should also help response times DNS relay is normally only required if you are running Internet applications on your workstations such as e Java applets which need to make a connect by machine name e Socks 4 systems if there are any references by machine name MAILGATE MANUAL Configuring MailGate 3 21 Enabling DNS relay when it is not required can give rise to spurious connections being made to your ISP for no obvious reason To correctly use DNS relay you will need to specify the MailGate machine address as the DNS server in the network settings on your client workstations MAILGATE MANUAL Configuring MailGate 3 22 Liquid Audio Tab Figure 22 Liquid Audio Tab Check the Enable Liquid Audio Gateway option to enable the MailGate proxy service gt Optional Settings Run Liquid Audio gateway on port The default for this is port 18888 As only one application on a machine can use a port if you already use this port you will have to run the MailGate proxy on a different port Ensure you set your client programs to connect to MailGate on your alternative setting Disconnect After Once a connection has been made with your ISP MailGate will monitor the session activity Ifthere is no activity for the Disconnect Time period
145. ress be sure to use a full email address for the System Address Some ISPs validate the FROM field looking for a local address before accepting mail System reports to this is the mail address that MailGate will send administrative messages to This can be the name of a MailGate mailbox or a full email address internal or external gt Optional Settings APOP MailGate s POP server supports encrypted login using the MAILGATE MANUAL Configuring MailGate 3 11 APOP command Select if you wish the POP server to accept or require users to login using APOP authentication You may have to adjust your email client setting to use APOP The default for normal POP3 operation is to disable APOP Outgoing copy you can have a copy of all outgoing mail it sent to a specific MailGate mailbox Warn After the number of hours a message can stay in the outgoing queue before a warning message is sent to the originator The default is 24 hours The warning can be disabled by entering O hours Fail After the number of hours a message can stay in the outgoing queue before a failure message is sent to the originator and MailGate stop trying to send the message The default is 72 hours If you enter O hours MailGate will never fail a message and will keep trying indefinitely Send mail immediately if connection open MailGate will connect to the ISP s SMTP server if the connection is currently open to send an outgoing mail If unchecked outgo
146. ring MailGate 3 3 Backup Dialup Entry The Backup Dialup Entry allows you to specify an alternative Dialup Phonebook entry to use if the primary connection can not be made Select the alternative entry using the dropdown and specify the username and password for this alternative account Note Many ISP s will not allow access to their mail servers particularly SMTP from an external connection You may find that when MailGate uses your backup dialup that mail sending and collection errors occur Excessive Connection Alert The Dialup Networking Alert dialog sets the maximum time for a connection in hours and minutes and what to when the amount of time is reached When the time limit is reached MailGate can do one or more of the following Force a disconnection Send the MailGate administrator an advisory mail The administrator mail address is set on the Gateway Setup Email Tab in the System reports to field Sound an audible alarm on the machine where MailGate is running MAILGATE MANUAL Configuring MailGate 3 4 POP Tab e Pome ere poten Dake POP Domains EMail Lan Forward The WEB Add the pop accounts you want to collect da email from Add Options Check every 300 secs during proxy connections Disconnect after 120 4 seconds inactivity Figure 10 POP Tab The POP tab lists all POP accounts that MailGate collects from Pressing the ADD or EDIT button calls the POP C
147. ring MailGate 3 36 Logging Information Purge Logging Files MailGate can create several log files containing data as specified by the options selected in the Logging Menu The length of time log files are retained is defined in the Logging Purging dialog box Enable log file purging Check this to have MailGate purge the log files gt Purge log files older than Specify the number of days to retain the log files The default is 30 days Logging The core MailGate system can create two type of log file General logs and Web Request logs If you have installed any Extension Modules then there may be additional logs associated with the module The above log files are stored in subdirectory LOG with the filenames a MG lt date gt log for general logging b RQ lt date gt log for web request logging To view a log use any text editor You can also view the general log using the MailGate log viewer accessed from the Logging View Logs menu option In the Logging menu option you may select the type of information written to the log files gt General Logging The Logging menu item allows you to log the following items If there is a check mark to the left of the item the logging is turned on e Log errors MailGate system errors e Log warnings warnings for potential problems e Log informationals general information and activity Recommend Enable all three options b Mail Logging The Logging menu it
148. rns Matches any single character T m matches Tim Tom and tam 4 Matches zero or more characters Hol d matches holed and hold Matches any single character that appears within the square brackets For example 0123456789 will match any single digit from o to 9 You can also specify a range using a dash for example 0 9 Indicates the start of a new line For example Received will only return a match if the Received is found at the start of a new line Used in extension modules which check email contents Indicates the match must occur on a single line For example _ filename exe will only return a match if the strings filename and exe occur on a single line Matches any single character that does not appear within the square brackets For example abc will match any single character except a b and c Matches the following character literally For example will match a single asterisk and will match a single backslash Negate The matching will return true if the negated pattern is NOT matched Use this option with care in pattern lists For example on the Setup Domains Tab username mydomain com will cause MailGate to treat this address as an external address as it is NOT a local domain MAILGATE MANUAL Technical Reference 9 1 MailGate Macros Using Macro Expressions The MailGate Macro Facility is available in a number of the MailGate extension modules When manipulating mail dat
149. rols whether the collection process waits suspends itself until the spawned process terminates or carries on straight away gt Telnet tickle If your ISP is using SMTP instead of POP3 to send your mail they may require a connection or some text to be sent in order to wake up the mail delivery The telnet tickle option can be used to do this As with the Command Only option above telnet tickle may be used without performing a POP collection You will require the following information e The machine address to connect to Your ISP should have this information e The port to use the default is 23 for telnet e The text characters to send if required MAILGATE MANUAL Configuring MailGate 3 8 Domains Tab Dialup POP Domains EMail Lan Forward The WEE Enter the domains for which you do not want to forward mail to the Internet For example mycompany co uk Local domains Unknown local address handling Return to sender Deliver to postmaster Figure 12 Domains Tab gt Domain Handling The Domains Tab sets which email domains are for local delivery and which are sent by your Internet Service Provider In addition on the Domains tab you specify what to do with mail addressed to an unknown user i e there is no matching mailbox In most cases the Domains Tab will contain the local network Domain name so mail from one person to another within the domain is sent locally Exceptions to Loca
150. s 1 S aS a hello b as You cannot assign integer values to strings or vice versa Integer and string arithmetic statements String variables support the operation which acts as string concatenate The following script segment shows this a Hello b there cs folks d a bS c The value of d after executing this script would be Hello there folks The operator is the only one supported by string variables MAILGATE MANUAL Technical Reference 9 4 Integer variables support the following arithmetic operators and or xor not The logic operators and or xor and not do bitwise operations between two integer values for example 7 and 3 would result in the value 4 The integer arithmetic evaluator also supports parenthesis and operator precedence as per the standard rules Some example arithmetic assignments Ao ll j O ow ole ll N o oO 3 Q result a b c and 121 notres not result A d c Integer Boolean expressions Non zero values are considered true and zero values false Two constants exist TRUE and FALSE which have the value 1 and o respectively Boolean expressions can only exist in if then else and repeat until statements The following comparison operators are supported lt gt lt gt lt gt These will evaluate to either the TRUE or FALSE 1 or 0 The Boolean operators and or xor and not work as logic stateme
151. s NT see see 7 4 7 9 How do I setup the machine address Window 95 98 Windows NT see see 7 5 7 9 How do I enable DNS Window 95 98 Windows NT see see 7 5 7 10 How do I setup the LMHOSTS and Window 95 98 Windows NT see HOSTS files see 7 6 7 10 How do I setup Dial Up Networking Window 95 98 Windows NT see see 7 7 7 11 Preparing for TCP IP Installation Before setting up TCP IP you will need to obtain some information from your network administrator If you do not have a network administrator you will need to make the decisions now for your network 1 What is the TCP IP network address for your network and number for each machine 2 What is the DOMAIN name for your network optional 3 What are the names for each machine in the network optional TCP IP Network Address TCP IP Networking uses a number broken into four parts and separated by a period Part of the IP number is for the network and common to all machines and part is used to address each individual machine For example 192 168 0 1 is a TCP IP network number 192 168 0 is the network part 1 is the individual machine Other machines in the network would be numbered 192 168 1 2 192 168 1 3 up to 254 MAILGATE MANUAL Network Preparation 7 2 What Address Should be Used Internet addresses numbers are assigned to specific companies or groups by various organizations around the world However many companies connect to the Internet
152. s follows o HKEY_LOCAL_MACHINE 1 HKEY_CURRENT_USER 2 HKEY_CLASSES_ROOT 3 HKEY_USERS lt Key gt string Full path giving key to read from e g software IDSL MailGate lt Value gt string Name of value to read Return Type String Operation Returns a string giving the REG_SZ value at the given registry location Returns zero length string if error occurs Function Regsetval lt Hive gt lt Key gt lt Valuename gt lt Value gt Parameters Value Type Description lt Hive gt integer Value indicating the registry hive to read from as follows o HKEY_LOCAL_ MACHINE 1 HKEY_CURRENT_USER 2 HKEY CLASSES ROOT 3 HKEY_USERS lt Key gt string Full path giving key to write to e g software IDSL MailGate lt Valuename gt string Name of value to write lt Value gt integer 32bit value to write to registry as REG_DWORD data Return Type Integer Operation Writes the given data value to the registry as a REG_DWORD item Returns zero if successful or Win32 error code if not MAILGATE MANUAL Technical Reference 9 21 Function Regsetstr lt Hive gt lt Key gt lt Valuename gt lt Value gt Parameters Value lt Hive gt lt Key gt lt Valuename gt lt Value gt Type integer string string string Return Type Integer Operation Writes the given data value to the registry as a REG_SZ item Returns zero if Description Valu
153. s of Custom Proxies supplied to support NNTP and Telenet To configure and use these services see the pages below 22 Using the NNTP Proxy on page 2 23 22 Using the Telenet Proxy on page 2 23 To use your own Custom Proxy you will need to instruct your client application to use a Proxy or a Firewall and specify the MailGate server address You will also need to know the Port number the application uses the host server to communicate with and the type of data used For full details on making these settings see the Custom Proxy detail on page 3 47 MAILGATE MANUAL Using MailGate 2 22 You can also make settings for each proxy to control your users access to the service based on both time and IP address settings If your client application requires multiple ports then you should consider using the Socks facility instead of a number of Custom Proxies Using the NNTP Proxy The NNTP example Custom Proxy will pass NNTP News protocol requests to the Internet To use the NNTP Proxy you should set your Newsreader client to reference MailGate See News Client Configuration on page 8 9 for information on some common newsreaders To configure the NNTP proxy for use follow the steps below 1 Double click on the NNTP Example Custom Proxy Title give the Custom Proxy a name Check Proxy Enabled Proxy listens on port the standard NNTP port is 119 Select Streams Connection Valid requests passed through enter the name of the news ser
154. schedule select Edit New Schedule to open the schedule dialog or click on the l icon on the toolbar To edit an existing schedule highlight the schedule and select Edit Edit or double click on it For full details on the available fields see Schedule Details on page 3 39 Types of Schedule Each of the different schedules is listed below See the pages below for more detail on the settings available Email Transfer Schedules These schedules allow you to fine tune how MailGate uses your Internet connection to transfer external email Email Transfer on page 2 26 Fixed periodic connection to transfer external email Priority Email Trigger on page 2 26 An override to send mail marked as high priority Outgoing Email Trigger on page 2 27 An override to send any outgoing mail Email Transfer after Idle Period on page 2 27 Makes a connection if there has been no other activity within a given period Service Availability Schedules Each proxy service in MailGate has it s own Service Enabled Schedule on page 2 28 Each of these works in the same way and they are listed in the schedule dialog as Web Proxy Enabled Ftp Proxy Enabled Socks Gateway Enabled Realtime AV Gateway Enabled and Liquid Audio Gateway Enabled With this type of schedule you can control what times your users can access the service Note If you want a service to be available all the time then you do not need to create a schedule for it MAILGATE M
155. send a message that you are on vacation Create the Auto Reply 1 Select the mailbox to send the Auto Reply in the MailGate main window 2 Select the Edit menu and click on Edit 3 Check the Automatic Reply box at the bottom of the Mailbox Settings window 4 Press the Edit button next to Automatic Reply and enter the text to be sent in the reply MAILGATE MANUAL Configuring MailGate 3 41 Notes 1 The reply text is kept in the MAILBOX sub directory of the MailGate installation directory in a file called lt MAILBOXNAME gt REP 2 Windows 95 has a 64K limit when writing text within the MailGate edit box but you can edit the file with another editor Windows NT has no limit to the length of text Delete Incoming Mail This option automatically deletes any mail received into this mailbox If you have Forward Copy to or Automatic Reply turned on then these actions will happen before the message is deleted Forward Copy To This option forwards a copy of a mail message to another email address which can be a local mailbox or an external address You can use this to forward mail to another person while you are out of the office or when two people have responsibility for answering a mailbox If you are forwarding to another local mailbox then you only need to specify the mailbox name or alias To forward to more than one address enter each on a new line Collect from Specific POP Account This option to collect from a s
156. ssfully they need to use the gateways that MailGate has authorised for traffic in and out of the network This section contains some simple guidelines on setting up some of the more common client programs to use MailGate For more detailed and up to date information please check our web site www mailgate com The web site is updated more frequently than the help file For more information please choose a client type below Bal Web Browsers on page 8 2 Bal Mail clients on page 8 4 Bal FTP clients on page 8 7 Bal News clients on page 8 9 MAILGATE MANUAL Configuring Clients for MailGate 8 1 Web Browser Client Configuration Web Browser Client Configuration You use a Web Browser to access and view website pages You will need to configure your browser to use a Proxy Server and give it the proxy server address this will be the MailGate machine address Your browser will then pass your web requests to the proxy server In this section you will find notes on setting up Internet Explorer Versions 3 4 and 5 and Netscape Version 3 and 4 to use the MailGate Server 22 Information on Internet Explorer below Bal Information on Netscape on page 8 3 Internet Explorer Proxy Configuration There are several methods with Internet Explorer 32 bit versions 3 4 and 5 on Windows platform for getting to the browser configuration i Inthe Control Panel select Internet applet ii In Internet Explorer select the View menu and click on Opt
157. sssssdeosecseesovaesadenssateecebsocsaersacteassesaessunsessiesessessaees 5 1 MAGATE CUSTOMIZATION measar Eea TE E EAEE E E AE EE ET EA A A E A TEENE 5 1 Web Proxy Message CUSIOMUZATION iia iii J L 6 SOLVING PROBLEMS ccscsscsscesssssssssssssscesssssescssssesssssesscsesscessessnsssssnessessessessssscessnesssssessessessossoeee 6 1 USING THE LOGFILES omita lat it is Dandies Levees ai dia 6 1 WINSOCK ERROR CODES essees e o aa ee esae ctu serves a EEA re E IE a 0h ctvces dae r E E cd li 6 2 T NETWORK PREPARATION cscssssssssscsscsssssssscssesssssssssscsssscescsssnsssssnessssnessossesssssssnesssesessessessoseoees 7 1 NETWORK REQUIREMENTS uni did 7 1 Network REGUITCIMCIUS 22 AA AA A AA aa AA A AA E AT 7 1 Preparing for TCP IP Installation c ooiiinnininvnvinvnvinvivviciniciccin rre 7 2 Windows 95 98 Network Preparation cciiininincnnin unico nice nn 7 4 Windows NT Network PrepardllA cciiiicinnicnanicninicnici nene 7 8 Checklist for Simple Network Setup vecccccccccccveccvscvvecevecssesscsscsesessesssesesscesscescesecssessseseeseeeseseseseeseesseeeeaeees 7 13 8 CONFIGURING CLIENTS FOR MAILGATE occccccocconnonnonncnonnonncnonanonncnnconcnnonnonaconncnoco non nonnoncnnonccnuoness 8 1 OVERVIEW OF CLIENT CONFIGURATION s csccssssssssssscesevsessscssvssassssscnsasesssessevsesssescusecssesessessavasessnensaseneseese 8 1 WEB BROWSER CLIENT CONFIGURATION c csscsssescssesssesesssesscsesssesseessesesssesscseseseseeesssessssssceesssesssesseese
158. string Return Type String Operation Returns a string containing the single character for the passed ASCII code Function Parameters lt String gt string String to convert g g g Return Type Integer Operation Returns the integer value represented by the passed string If the string does not represent an integer value zero is returned Function Str lt Value gt Parameters Value to convert to string Return Type String Operation Returns a string of digits representing lt value gt MAILGATE MANUAL Technical Reference 9 13 Function Hex lt Value gt Parameters Value to convert to string Return Type String Operation Returns a string of hex digits representing lt value gt Function Inet_ntoa lt Address gt Parameters IP address as 32bit network byte ordered value Return Type String Operation Returns a string representing the passed IP address in dotted octet form Uses Winsock inet_ntoa function internally Function Inet_addr lt Address gt Parameters IP address as dotted octet string Return Type See Below Operation Returns a 32 bit network byte ordered value representing the string passed Uses Winsock inet_addr function internally Function Gethostname Parameters None Return Type String Operation Returns a string giving the hostname of the computer that MailGate is running on Uses Winsock gethostname function
159. t string Sequence of characters to look for as the termination of a line Return Type String Operation Reads a line of text from the proxy socket connection established with the connect function and returns it as a string A line is considered all text up to and including the sequence lt termination gt Normally termination would be passed as chr 13 chr 10 Note This function is only applicable to Custom Proxy scripts MAILGATE MANUAL Technical Reference 9 25 Function Pread lt Count gt Parameters Number of bytes to read Return Type String Operation Reads lt count gt bytes from the proxy socket connection established with the connect function and returns it as a string If a socket error occurs before the requested number of bytes has been read then the function returns a string of the bytes that were available Thus to check for error or socket closure compare the length of the returned string with the requested number of bytes Note This function is only applicable to Custom Proxy scripts Function Parameters Fone None OOOO esting ating S integers integer SSCS Return Type None Operation Calling this function MAILGATE MANUAL Technical Reference 9 26 Windows Registry Windows Registry MailGate stores its configuration in the registry All settings are stored under the section HKEY_LOCAL_ MACHINE Software IDSL Mailgate Within this key there is o
160. t specific patterns See Set a Specific Pattern for Mailbox Sorting on page 2 13 for more information gt Header fields searched first The mail header is scanned for the following fields Apparently To X Apparently To X Originally To Envelope To lt the string entered in the custom field on the pop dialog gt If the field is found it is compared to the address filter pattern and if matched the default is this address is selected and searching stops If more than one of the above exist whichever is nearer the start of the header and matches the filter will be used Special Routing If the custom header field for routing entry contains To MailGate sorts using only the TO and CC header fields MAILGATE MANUAL Using MailGate 2 12 gt If header fields not found If none of the above result in a match the search is then done for a Received for field with an address that matches the address filter pattern If this fails then email addresses are taken from the TO and CC fields if they match the address filter pattern When matching TO and CC fields the emails Message Id field is also checked against a list of recently received Message Ids If the message id has been already processed the email will be discarded This is done since if an email is sent to multiple recipients within an organization there may be multiple copies in the ISP pop account The to cc method will deliver a copy to all recipien
161. t connections to your ISP for HTTP requests you may want to increase the Disconnect After setting The line will be open a little longer but MailGate will make fewer phone connections This should also help response times MAILGATE MANUAL Configuring MailGate 3 17 FTP Tab Figure 18 FTP Tab Check the Enable FTP Proxy option to enable the MailGate FTP proxy service gt Optional Settings Run FTP Proxy on port If you have a local FTP server running on the same machine as MailGate it may be using the standard FTP port Port 21 As only one application on a machine can use a port you will have to run the MailGate Web proxy on a different port The standard one for this situation is 2121 Ensure you set your client programs to connect to MailGate on your alternative setting Disconnect After Once a connection has been made with your ISP MailGate will monitor the session activity If there is no activity for the Disconnect Time period then MailGate will request the connection be closed The default period is 120 seconds If MailGate is making frequent connections to your ISP for FTP requests you may want to increase the Disconnect After setting The line will be open a little longer but MailGate will make fewer phone connections This should also help response times MAILGATE MANUAL Configuring MailGate 3 18 Socks Tab E E Pass HTTP requests through Web proxy rn Figure 19 Socks Tab MailGate
162. t of the common code meanings gt Delete Message from the Queue In this dialog you can delete the message by selecting the Delete button gt Requeue if Errors If there is a problem sending a mail message MailGate will requeue the message and try on the next connection MAILGATE MANUAL Configuring MailGate 3 44 Maintaining URL Filters URL Filter Details Edit Und Filter 71x r Fiter match strings Un Pattern F Machine name or DINA ip addes pattem Alowaccess Dery access r Fiter active times FM Sunday M Mordy W Tuesday W Wednesday FP Thursday Friday W Saturday Start Time 0 3 fo 3 End Time 23 ale 7 Fiker enabled ES A figure 29 Edit URL Filter By creating URL filters you can control which web sites and pages your users can access You can create as may URL filter checks as you like to build a profile to suit your requirements To create a new filter entry click on the e icon on the toolbar or select Edit New URL Filter To edit an existing entry highlight it and select Edit Edit to display the URL filter detail screen You must specify a URL pattern and a machine address pattern to which this filter is applicable using wildcards see 9 1 You then select to either Allow or Deny access for requests that match the pattern settings If you choose to use machine names MailGate must be able to reverse lookup the users IP address and find the machine name using a cor
163. tarted mgatesve 252 Ox000000ec Thread started mgatesve 232 Ox000000a6 Thread started mgatesve 252 Ox000000f3 Thread started mgatesve 252 Ox000000f6 Thread started mgatesve 252 Ox000000ca Starting stream acceptor mgatesve az Ox000000ca Starting stream acceptor mgatesve sate Ox000000ca Starting stream acceptor mgatesve sad Ox000000ca Starting stream acceptor mgatesve 152 0x000000ca Starting stream acceptor mgatesve 152 0x000000ca Starting stream acceptor mgatesve 292 Ox000000ca Starting stream acceptor mgatesve 152 0x000000ca Starting stream acceptor mgatesve 152 0x000000ca Starting Figure 32 Log File Viewer When you exit from the Log Viewer your current settings will be saved The Menu Bar The Log File Viewer menu option give access to all the options available on the Tool bar Using the File menu you can select the log file see 10 3 to view The Find see 10 3 and Filter see 10 3 options can be found on the Edit menu Using the View menu you can turn off the Menu and Tool bars by unchecking the respective options This reduces the window size and may be useful if you wish to use the viewer in ocked mode for a MAILGATE MANUAL The Log File Viewer 10 2 continuous display see 10 4 of logged activity Checking the Always on Top option will make the Viewer window stay visible in the foreground When the Menu bar is hidden you can move the entire window by holding down the Control key and
164. te intrincada 2 1 MailGate Administrator Window MCs ccccccccvsssecccccecesvecsececeeesesnsssscesesesesessneseeesecesesessscesecsssenessssesecsesensnaes 2 2 CMEWAYM OU A A A a aE 2 2 IES A IAEA EAS AR E ART 2 2 ATA OLAI A E A astra 2 3 LAY AG RARA A E A EEE E E IN 2 3 VALUA RE PR EAE EEA E AA taengas abba 2 3 MailGate Administrator Window ICONS oooossanonooeennnnnnnnnennsennoseeenennnsereenernsseererernsssnserernennssrrererssssrereersnrnnee 2 3 Manua CO e O OOT lt lt A aa a a aa n a a a a a ai A 2 3 SCTVICE STATUS LAI 32 AE A S EE E AE EA ias 2 4 TOO DOL CONS AAE coeds E E E AR A IE A T E E E tates actta 2 4 MailGate Administrator WiNAOW veccecvssececececesvtssececeeesesneseeeeeeesesnsuesesesesssesnaseseseceseesasscesesseseneassceseseesenenies 2 4 VGA AVLLI AERE A E E E T E in 2 4 Schedule LAS cise A A a aa RAT a Ev ia 2 5 Mailbox LIS 2 i ne A a E AA EA A E ii 2 5 OUt ZONE QUCHE A A A A sta A cbse Pages pad la A Sa AA Dae eee 2 5 URE Filler Tist A A A A A idad 2 5 CUSTOM PPT ONY LAST pi sa castes A eR ERT UD A nied A AA iad gies 2 5 VII RU BEA AAA A Pas a aiie o e Ev ba vaedands desk bencdcc Wendi sd t a Gast a aiee a i t es 2 6 Connection TUS O Via ii asa a Use bag aaa ag te E Dae Tate AA EA aT dees basi 2 6 Administrator Window Status BAP ooocinnnnnnncinicacanaaonocononnnano no nono nnnnna nano r oro cn anar ano cnn ron nana nn nr cor cnn nan naar raro rnanannn no 2 6 STARTING THE SERVICE da 2 7 SLATE MACAO A AA A AAA A A id 2 7 Comman
165. than having to contact the true source of the data Client The workstation or PC in a Client Server environment The Client is the end recipient DHCP Dynamic Host Configuration Protocol Software included in the operating system that automatically assigns IP addresses to stations on a network MAILGATE MANUAL Glossary of Terms 11 1 DNS Domain Name System is a distributed database system for translating computer names into numeric Internet addresses used when transferring your messages and commands across the Internet Domain Name The part of an Internet address that identifies the address group Example in sales mailgate com mailgate com is the Domain Name DUN Dial Up Networking The software that provides the Winsock connection between your computer and your Internet Service Provider FTP The file transfer protocol often used to send files around the Internet There are public ftp sites where you can download public domain and shareware programs updated drivers for your PC s graphics card and many other useful files Gateway A link between two systems Gateways are also used between systems that may otherwise be incompatible HTTP HyperText Transfer Protocol the mechanism and standards underlying the world wide web Sometimes also used to refer to a web server Sometimes used in the form SHTTP or HTTPS to refer to a high security web server ISDN Integrated Services Digital Network An internationa
166. the session activity If there is no activity for the Disconnect Time period then MailGate will request the connection be closed The default period is 120 seconds For more information about RealPlayer see www realaudio com MAILGATE MANUAL Configuring MailGate 3 20 DNS Tab A FTP SOCKS Realtime 4Y DNS Liquid Audio Cache a b c Enter options for DNS relaying and DNS reverse F lookups that may be required to complete service 234 security checks T Enable dialup for DNS reverse lookup security checks Server s to relay dns packets to Options Disconnect after 120 seconds inactivity Figure 21 DNS Tab Check the Enable DNS relay to enable the MailGate DNS relay service You will also need to specify at least one DNS server to query This will normally be your dialin ISP s DNS server gt Optional Settings Enable dialup for DNS reverse lookup security checks If you set security settings in the Gateway Advanced setup using machine names this option tells MailGate to dialup your ISP to lookup the machine name belonging to an IP address reverse lookup for the allow deny access checks Normally you will not use this option Disconnect After Once a connection has been made with your ISP MailGate will monitor the session activity If there is no activity for the Disconnect Time period then MailGate will request the connection be closed The default period is 120 seconds If MailGate is making f
167. then MailGate will request the connection be closed The default period is 120 seconds For more information about Liquid Audio see www liquidaudio com MAILGATE MANUAL Configuring MailGate 3 23 Cache Tab Figure 23 Cache Tab The Web Cache stores web page data that is specifies as static This is determined by the web data header information Dynamic web pages for example forms results are not cached MailGate runs the low priority cache management job in the background to check the cache parameters and delete old information MailGate will always delete oldest data first until all criteria are met On the Cache Tab you can set the Cache criteria both by age and cache size as well as request the current cache be cleared Note You can exceed limits specified in the Cache tab until the next time the cache management task is run MAILGATE MANUAL Configuring MailGate 3 24 Gateway Advanced Setup Gateway Advanced Setup The Gateway Advanced Setup section contains the settings used to set the MailGate security and timeout options You should review your security settings but generally should not change the timeouts Security Tab MailGate Advanced Settings El E Security Bindings Timeouts Smtp Relay 8 Use these settings to control overall access to the services of MailGate The access settings on this page take priority over any other checks Ftp Gateway Smtp Server Socks Gateway
168. then dragging the window using the mouse by clicking anywhere in the display window O If the Menu bar is hidden all the menu options are still available by right clicking in the file display window Selecting the File to View Use the drop down on the Tool bar or the File Recent Logs item to select the log file to review The selected file will now be displayed in the display window If you select the file 7oday the Zock option for continuous activity display see 10 4 will also be available Using Find The Find option in the Log File Viewer is a quick way to find a particular text string in the current selected log file Find can be accessed either directly from the Tool bar or from the popup screen displayed when you choose the 777d menu item To use the Find option enter the string to find in the field displayed If you are accessing Find using the Tool bar press F3 to find the next occurrence or Shift F3 to find the previous occurrence of the string If you are using the popup screen use the radio button to select Up or Down and click OK Using Find Selected Find may be activated by using the Find Selected item available on the Edit menu To use this highlight the required string in the File Display Window then select the Find Selected option The highlighted string will be passed into the Find setting and the find activated Using Filters The Filter options in the Log File Viewer are a powerful way of selecting sp
169. ts to Servers may be specified by the IP address as a string or by the dns servers name Idle disconnect time for the dns relay value in seconds Socket timeout setting for write operations by the DNS relay value given in seconds Controls whether or not Mailgate generates an error email message in the default mailbox when there is a failure to connect to a pop server for email collection This value is not normally present and defaults to 1 If you wish to change the setting add the setting using the registry editor o don t report errors 1 report errors 9 28 Registry Parameters cont EnablePurgeDays DWORD EnablePurgeSize DWORD EnablePurgeSpace DWORD ErrorImageFile String ErrorTemplateFile String ExpandCustom DWORD ExpandFilters DWORD ExpandHistory DWORD ExpandMailboxes DWORD ExpandQueue DWORD ExpandRoot DWORD ExpandScheduling DWORD Extensions Multi String Forwards Multi String MAILGATE MANUAL Technical Reference Controls whether the web cache purge system checks number of days pages have been in the cache when deciding whether or not to purge pages from the cache o don t check 1 check Controls whether the web cache purge system checks the cache size when deciding whether or not to purge pages from the cache O don t check 1 check Controls whether the web cache purge system checks the available disk space when deciding whether
170. ts when processing the first message The recent message id file expires entries older than 3 days After the filter has been applied any options specified in Remove Occurrences or Map Address are applied gt Delivery to mailbox when address found Each address obtained above then has the domain part stripped and is then delivered to the mailboxes that have a matching name or alias Note that if multiple accounts have the same alias and that is the delivery address each account will receive a copy Setting a Specific Pattern for Mailbox Sorting MailGate analyses the email headers as described in How MailGate Sorts into Mailboxes on page 2 12 If an address matches the pattern filter then MailGate will accept the mail and sort it into a mailbox You can have more than one pattern but each must be on a separate line For example if you set the filter as mailgate com MailGate will ignore any addresses not for that domain In particular if MailGate uses the To CC addresses to route email set the filter to your domain to ignore other address in these fields See Using Wildcard Expressions in MailGate for more information For information on mail sorting rules see How MailGate Sorts into Mailboxes on page 2 12 Tip You can put your domain name as the filter Eyourdomain so MailGate only looks at those addresses to sort mail You can also use Aliases for a mail box for sorting See Aliases for a Mailbox on page 3 41
171. ueesenees 8 2 Web Browser Client CONfIQSUIAUION idiniriin i n i E K RAE T E EKE E AR EREK EER 8 2 nternet Explorer Proxy CONfIQSUIQUON oiei E REER G E EE T EEEa 8 2 Wetscape Proxy CONJ LUTON OM ai E AEREE O REEVE ERRAR RE 8 3 MAIL CLIENT CONFIGURATION eraa ranere raaa are AEEA panah rr OAE Er RAR eSEE EEES EA Onine RAAE EE nei ERER ena eri ReiS 8 4 Mau Cheit CONE ATION o AA A ts a a a tas a aa 8 4 MS Outlook Express COMPQUIAMON ss eir its 8 4 MAILGATE MANUAL Contents MAS Outlook CONPIQUTAMON n E EEEE ein E oa sth Un aes aaa ei gine a iia 8 5 MS Internet Mail CONIZULOlIA coioiinicninicicnicicnn rre 8 5 Eudora Mail ConfiguratioN issirsiiiisrisiiiisnisnciorisrieer enana 8 5 Agen Free Agent Mail CONFAZUI OM ciiiiinnnnnuicnicicinii erre 8 6 Virtual Access Mail CONAZUIA OM coiiiiiinicicnin ici 8 6 EIP CLIENT CONFIGURATION vieraan asearen EEn SEEE OEKE EE e EEVA ERES EET OTETA acaso laos creaban 8 7 FIP Client CONPIQUICUION e Sii EER a aiei eiai i iiis 8 7 Cute FIP COMfIGUIAMION 00 inira aE EEEIEE AR EO EEE A E E AET EE N Ea E taiag 8 7 Internet Neighbourhood Configuration sssssssesssssiesseseririsrererriererreereresrrererrrnrerreerenrerrnseerrnresrenrenreeesneeet 8 8 WS_FTP CONPIQUIGIION iii a TE EES E E EEEa AEE EE EEANN 8 8 NEWS CLIENT CONFIGURATION vi ncccciscviesibenetnecscevetvenstevesetevvoupcovtutassbevte tev hausa S ESE OAEI SNEEN ENEE EEVEE EE EEE 8 9 News Client CONFIGUTATION ci to eisi oiii iE ai EAE iE a Oia EEEE T EE ESE TE ai ia a
172. uld follow the following simple steps a Install TCP IP and establish your Internet connection See System Requirements on page 1 8 for more details b Obtain your ISP s account details for you See System Requirements on page 1 8 for more details c Install the MailGate program from your download or CD copy d Configure MailGate using either the configuration wizard or the setup screens e Configure your client machines and software to work with MailGate f Test your installation For more information see 23 Installing MailGate below 23 Client Configuration on page 1 12 Installing MailGate MailGate is supplied as a single self extracting and installing executable program To install MailGate simply double click on the install file and follow the screen prompts When first installed MailGate will run for 30 days with a 10 user limit You may purchase a registration key at any time and when this has been entered into the registration screen your copy of MailGate will become a fully licenced copy There are a number of optional modules available each of which has it s own install executable To install any of these first complete your MailGate installation then run the module install program and follow the screen prompts gt Configuring MailGate Once the MailGate program has been installed successfully and you have completed the tasks outlined in the System Requirements section you are ready to configure MailGate
173. ut DWORD Type DWORD UsesRas DWORD WriteTimeout DWORD MAILGATE MANUAL Technical Reference Socket port number the custom proxy listens on List of name or ip address pattern match strings indicating which clients are permitted access to the custom proxy Timeout for socket read operations by the custom proxy value given in seconds Indicates whether or not the custom proxy has a script O no script 1 script present Name of the file that the script is stored in Scripts are stored in the Script directory that is created in the Mailgate install directory Time the proxy s active period starts value given as minutes from midnight Idle disconnect time for the custom proxy value in seconds Type of custom proxy O Stream proxy 1 Datagram proxy Indicates whether the custom proxy requires a Ras connection or not If not the custom proxy won t cause a dialup to occur 0 doesn t use Ras 1 does use Ras Timeout for socket write operations by the custom proxy value given in seconds 9 43 Mailboxes The mailboxes key is used to store details of the pop accounts setup in Mailgate Each account has a number of entries of the form lt accountname gt lt setting gt as follows Value Name Description Data Type lt account gt flags Set of flags indicating mailbox options selected DWORD flags as follows 1 Auto reply 2 Delete incoming 4 Forward 8 Pop collection
174. ut period has expired MAILGATE MANUAL Configuring MailGate 3 30 SMTP Relay Tab MailGate Advanced Settings El E Security Bindings Timeouts Smtp Relay Allow connections from Deny connections from these machine names these machine names and or io addresses and or ip addresses i Authentication mode Not Notrequied y Username Password J Authentication required for valid IP gt local V Authentication required for valid IF gt external IV Authentication required for invalid IP gt local JV Authentication required for invalid IP gt external Cancel Help Figure 27 Smtp Relay Tab SMTP relaying is the passing of mail messages from one domain to another This feature of SMTP servers is often exploited by email spammers to hide the original source of their mails The standard SMTP protocol does not require a user to provide a username password before sending mail data The enhanced protocol ESMTP though allows for a number of SMTP authentication methods MailGate supports the LOGIN method of authentication With the SMTP relay tab you can control access to the MailGate SMTP service by using a combination of settings Allow Deny Connections Use these settings to set the access rights to the SMTP relay service You may either explicitly allow or deny access by machine IP address You can use wildcards 9 1 to set an address pattern If you wish to use machine names MailGate must be abl
175. utoreply to request for Repy sent to FAQ enabled in the mailbox ougoing queue setup on Mailgate server figure 7 Advanced Mail Routing MAILGATE MANUAL Using MailGate 2 11 How MailGate Sorts into Mailboxes MailGate can be configured to collect POP3 mail by one of two methods If the collection details are specified against a user mailbox see Mailbox Options on page 3 40 then all collected mail is simply placed in that user s mailbox If the collection is specified in the POP collection tab on page 3 5 then MailGate uses rules to search the incoming mail headers and determine to which mailbox incoming mail should be delivered gt Analyze the Mail Header The mail is analyzed in the following steps a Search for specific header fields listed below and look for a match using the whole address If found deliver the mail to the mailbox b Ifno match found on whole address look for match of the address filter pattern specified when the mailbox was setup c Ifthe header fields are not found continue the search for additional fields and look for match of the address filter pattern specified when the mailbox was setup d Take the full address with the domain name and compare against all mailbox and aliases names e Tfno match found strip the domain name from the address and deliver to all mailboxes that have a matching name or alias By default the address filter pattern is means any text You can se
176. vailable in the internal buffer filled by the last call to gethostbyname or gethostbyaddr Returns zero if no information is available because gethostbyname or gethostbyaddr has not been called yet or the last call returned an error Function Gethost lt Index gt Parameters Index position to read hostname from internal structure Return Type String Operation Returns a string value giving the hostname at the lt index gt position in the internal buffer Returns a blank string if no hostname available at the requested position or no data in the internal buffer Note that gethost 1 will return the primary name of the host and gethost 2 n will return any aliases the host has Function Getaddr lt Index gt Parameters Index position to read address from internal structure Return Type See Below Operation Returns the IP address as 32bit network byte ordered value at the lt index gt position in the internal buffer Returns zero if no address available at the requested position or no data in the internal buffer MAILGATE MANUAL Technical Reference 9 16 Function Fopen lt Filename gt lt Mode gt lt Sharing gt Parameters Value lt Filename gt lt Mode gt lt Sharing gt Type string string integer Description Name of file to be opened The string class pmode specifies the type of access requested for the file as follows class op r Opens for reading If the file does n
177. veeveeb arene 3 40 Mailbox Detail SCIOCH perisis ieten iiki a dadas 3 40 Aliases JOR AMADO id tt A E A E TAR E teas RO E E E 3 41 Auto REDIVIO Ml iani a a a aer na e n a a ei ai 3 41 Delete INCOMMMEM GU AAA an aa aa aea aii 3 42 Forward COPY LOr rreri td AA A A A Ad brida 3 42 Collect from Specific POP ACCOUN it ia it iii 3 42 Sie Warning Jor a MaD ON iii E E AA ii E E E A i 3 43 MAINTAINING THE OUTGOING QUEUE c cccesssssecsesseeecssecensesaeeecsnaeececsneeecsesaececeeaeecesaeeecsesaeeeceeseeesssueeseneaaeees 3 44 Outono Message DAS A E vues A REE 3 44 MAINTAINING URL FILTERS ssssscvsacsvevscesesseozestvesneevesopesnsetennus ERN EA SESINO O a ENE REEN REONE AROSA VENE ESERE NORISS KEETE Nei 3 45 OREK ilet Deals ti EAN E E N E A E etna 3 45 MAINTAINING CUSTOM PROXIES jx evesicosesscozscvessnesvesstesesetevast tens endosedevassvevseceustestaesunsendopevevoneyusserserevesesesersieyes 3 47 CUSTOM FIONY DOTAUS gt dd bodied A Ad aida 3 47 4 REGISTRATION SUPPORT csscsssscsscsssescsssscssssnsssesssssescsssnssssenessessessessessessssenesssssessessessossoees 4 1 REGISTRATION hereon eean eoero ero ENEE soventeecvevstes ie ovtusueveevtovdbento EIA Enea AEE EN Creed sobe Cbeeentesvontevecdegie odie 4 1 EMAIL FOR SUPPORT A NN 4 2 WEB LISTS ON THE HELP MENU winccncscscttecccsesstyotesetcvescvetissbonte r a R Ta EEEE Ero eE te stevnvgetbresntonsevebeceveppen sponte 4 3 5 USER REFERENCE wssscsecisescescscccsecssscsstocsssceccvassscssacectescn
178. ver to connect to The requests are normally passed through port 119 the standard NNTP port Check when the proxy is active 9 Check The proxy uses the dial up connection if this is your method of connection 10 Review any security settings required DQO N For full details on any of the screen fields see the Custom Proxy Settings on page 3 47 Using the Telnet Proxy The Telnet example Custom Proxy will pass Telnet protocol requests to the Internet To use the Telnet Proxy you should set your Telnet client to reference MailGate The Telnet Proxy has an associated script that asks for the site you want to connect to with Telnet This allows one Proxy to access multiple telnet locations MAILGATE MANUAL Using MailGate 2 23 To configure the Telnet proxy for use follow the steps below 1 NDRY 8 Double click on the Telnet example Custom Proxy Title give the Custom Proxy a name Check Proxy Enabled Proxy listens on port the standard Telnet port is 23 Check the Run Script box Check when the proxy is active Check The proxy uses the dial up connection if this is your method of connection Review any security settings required For full details on any of the screen fields see the Custom Proxy Settings on page 3 47 MAILGATE MANUAL Using MailGate Using the Scheduler Using the Scheduler The MailGate scheduler has three types of schedule which serve slightly different purposes To create a new
179. ween the last mail collection and the time this schedule is to run This allows you to make sure that outgoing mail does not wait too long to be sent For example The minimum redial is set at 5 minutes At 10 20 during a proxy connection MailGate checks for new mail At 10 30 outgoing mail is received by MailGate Since 5 minutes has passed since the last mail collection MailGate sends the mail immediately Email Transfer after Idle Period Schedule The Email Transfer after Idle Period lets you define a periodic interval to connect and collect mail after the last connection was made You can define what days of the week and hours you want this schedule to be active After The After value specifies how much time in hours and minutes MAILGATE MANUAL Using MailGate 2 27 must pass since the last mail connection was made Once this time has been reached MailGate will connect and collect mail This option works with all other scheduling options For example you can collect mail during proxy connections but make sure mail is collected if there has not been a proxy connection recently In Gateway Setup POP tab set MailGate to check for mail whenever a proxy connection is made and check during the connection for the specified time period Set an Email Transfer after Idle Period to 1 hour If there has been no proxy connection for an hour then MailGate will collect email Service Enabled Schedule Each proxy service has
180. what has happened what you expect to happen and when the problem occurred if possible Click on the send button to transmit your email MAILGATE MANUAL Registration Support 4 2 Web Lists on the Help Menu Our web site www mailgate com is the one of the best places to look if you re having problems The latest information regarding the program updates and technical information can be found there Through Help MailGate on the Web you will find links both to our web site and other related sites This list can be modified to include any web site you might want to visit while using MailGate The file URLS DAT in the directory where MailGate is installed contains the content of the menu list The format for the file is lt siteaddress gt lt space gt lt description for menu gt You can also insert a line in the menu by placing the word separator on a line by itself without the quote For example http www mailgate com MailGate home page separator http www socks nec com NEC SOCKS TCP IP stack home page MAILGATE MANUAL Registration Support 4 3 5 User Reference MailGate Customization Web Proxy Message Customization When the web proxy returns an error to the user it uses an internal HTML file to format the error You can create your own HTML file and optional GIF file to format the error instead for your site requirements such as internal support telephone line or email address MailGate loo
181. would have received a deferred message should be notified by email of the message deferment 1 notify o do not notify default value is 1 List of name or ip address pattern match strings indicating which clients are permitted access to the pop service Timeout for socket read operations by the Pop service value given in seconds Port Mailgate runs the Pop service on Normally this registry value will not be present and the service defaults to the standard Pop port of 110 If it is required to modify this manually add the value using the registry editor and set it to the required port number Idle disconnect time for the Pop service value in seconds Timeout for socket write operations by the Pop service value given in seconds Number of days cached web pages are kept on disk before being purged by Mailgate Only used if the EnablePurgeDays setting is enabled Size in KB that the web cache is allowed to grow to before pages are purged from the cache Only used if the EnablePurgeSize setting is enabled Size in KB of free disk space that must exist on the web cache drive If space becomes less than this value pages are purged from the cache Only used if the EnablePurgeSize setting is enabled Login account for RAS dialup Stored as an encrypted string Bitmap indicating actions to take on connection timeout 1 sound beeps 2 Email admin 3 Force disconnection This sets the maximum connected session time before Ma
182. wser For setting the HTTP proxy see Web Browser Client Configuration on page 8 2 Note You should NOT set the FTP protocol in your browser proxy settings to use the MailGate FTP port FTP Client Configuration This section covers setting up some common FTP client programs to use the MailGate Server If you have a separate FTP program you must configure it to use the MailGate FTP proxy For information see the listings below for how to configure Bal Cute FTP below Bal Internet Neighbourhood on page 8 8 22 WS_FTP on page 8 8 Cute FTP Configuration m Select the FTP Menu and click on Settings 2 Click on Options and select Firewall tab 3 Set HOST to point to the MailGate machine Enter either the IP address or the machine name generally mailgate 4 Set PORT to point at relevant port normally port 21 5 Leave USER ID and PASSWORD blank 6 Set TYPE to USER 7 Tick to enable firewall access MAILGATE MANUAL Configuring Clients for MailGate 8 7 Internet Neighbourhood Configuration Set these properties for each site to which you wish to connect to 1 WRIN Firewall Access ticked Firewall Access Type RAPTOR USER fw_usrnam Firewall Host Information Firewall MailGate Host Machine ID Leave Username amp Password Blank Leave Passive Mode unchecked WS_FTP Configuration Create a Site Entry for each host you wish to connect to Set the following properties to use the MailGate proxy 1 2
183. you wish to use machine names MailGate must be able to reverse look up an IP address to establish the name associated with it This will require correctly configured HOSTS files local DNS or a WINS server to be available Entering an address in the top box allows access and entering it in the lower box denies access from that machine MailGate will check for a match to the deny settings first Note See also the SMTP relay tab on page 3 31 to prevent spam mail relay Q If your network is configured such that your users all access MailGate through a single LAN card in the MailGate machine and your Internet access is through dialup or via a different LAN card use the Bindings settings to prevent external access to your system MAILGATE MANUAL Configuring MailGate 3 27 Bindings Tab MailGate Advanced Settings E E Security Bindings Timeouts Smtp Relay For multihomed systems you can bind services to sit only run on one of the systems IP addresses by entering the required IP address below Pop Server 192 168 0 1 Smtp Server 92168 01 Web Gateway 92168 01 Ftp Gateway 92168 01 Socks Gateway 92168 01 Dns Relay 92168 01 Realtime AV fi 92 168 0 1 Liquid Audio fi 92 168 0 1 Cancel Help Figure 25 Bindings Tab The Bindings Tab is for Multi homed system i e a system with two or more IP address It can limit a particular service to be available on only one of the addresses In a dialup syst

MailGate User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents