How AirSyncFilter works
AirSyncFilter monitors the ActiveSync / AirSync data flow between the phone and Exchange. Based on rules, the data is manipulated so that the phone or Exchange gets only filtered data.
System Requirements
-
Windows® 2003/2008 with TCP/IP installed
-
Microsoft Exchange 2010
Installation
Decide if AirSyncFilter should be installed on the Exchange server or on a different machine:
-
Single Exchange server
If you have only one Exchange server,
then run AirSyncFilter on the Exchange server. The
installation is much simpler when you run AirSyncFilter
on the same machine as Exchange.
By default Exchange uses HTTPS ( e.g. port 443 with
TLS/SSL ) for ActiveSync. Installing AirSyncFilter on
port 80 will not change anything on the Exchange
configuration.
And on your phone you only need to disable TLS/SSL,
which makes configuring the phone much simpler. If you
want to switch back to unfiltered ActiveSync, then the
only thing you need to is is to enable TLS/SSL on the
phone.
-
Cluster
If you have a cluster then you must run AirSyncFilter on a different machine, because
AirSyncFilter doesn't support a cluster.
Once you decided on which machine you are installing
AirSyncFilter, perform the following steps:
-
Run Setup.exe or create a directory on your machine and copy all the files into this directory
-
Start AirSyncFilter Admin (MBAdmin.exe) to
configure AirSyncFilter
-
The first time you run AirSyncFilter you will be prompted for the following information:
The name or IP address of the Exchange server.
If AirSyncFilter is running on the same machine as the Exchange server, then you can use localhost as the name.
The port Exchange listens
If AirSyncFilter is running on the same machine as the Exchange server than use port
443.
If Exchange uses TLS/SSL
By default Exchange uses TLS/SSL.
-
Running AirSyncFilter on the same machine as Exchange server
If you run AirSyncFilter on the same machine as the Exchange, then you must tell Exchange to listen on a
different; e.g. not port 80, because only one
application can listen to a specific port at one time.
- Exchange 2010 and SBS 2011
Start Internet Information Services (IIS) Manager and select Sites->Default
Web Site,
right click and
select Edit Bindings.
In the dialog locate http
and change the port from 80
to 81.
Then restart IIS so that the nbew
binding takes place.
Note: Make sure you open port 80
on the firewall or else the phone can't
connect to AirSyncFilter.
Run AirSyncFilter as a service
Once you run AirSyncFilter as a service, errors will only be visible in the logfile or in the main window of MBAdmin. Consequently, before running it as a service you must first ensure that
AirSyncFilter is running properly with no errors by launching it in Console Mode (i.e. starting it from an icon).
In general, installing AirSyncFilter as a service should be your last task and not your first.
Note: Keep in mind that AirSyncFilter needs to reside on a local disk or the service controller will not be able to start it.
Also make sure MBAdmin.exe and MBServer.exe are in the same directory.
Start MBAdmin, select View->Service and here you can install, remove, start and stop the service. By default it is an AutoStart service and any time your computer is started,
AirSyncFilter will start.
Note: After you have started AirSyncFilter as a service, verify that
AirSyncFilter has no errors.
You need to take a look into the logfile to do this or start MBAdmin and in the main window you see the logfile.
For the examples below, we assume AirSyncFilter is in
C:\AirSyncFilter
-
Installing AirSyncFilter as a service
Start MBServer.exe with the argument of install, by typing MBServer install at the command prompt and
AirSyncFilter will create the service.
By default it is an AutoStart service and any time your computer is started,
AirSyncFilter will start.
You can start and stop AirSyncFilter at any time via Control Panel
Note: After you have started
AirSyncFilter as a service, verify that AirSyncFilter has no errors.
You need to take a look into the logfile to do this or start MBAdmin and in the main window you see the logfile.
-
Removing AirSyncFilter as a service
Start MBServer.exe with the argument of remove, by typing MBServer remove at the command prompt and
AirSyncFilter will delete the service.
How to stop AirSyncFilter
-
AirSyncFilter runs as a console application:
-
Press ESCAPE
-
Select Close from the system menu (works only on Windows NT®)
-
Press Alt-F4 (works only on Windows NT®)
-
AirSyncFilter runs as a service on Windows NT®:
-
Open Control Panel, select Services, locate
AirSyncFilter and
press the button labeled Stop
-
type Net Stop AirSyncFilter at the command prompt
Upgrade to the latest Version
You will find the latest version of AirSyncFilter in the
Download Area
setup_AirSyncFilter_??.exe searches for a previously installed
AirSyncFilter and updates only the executable files. The
settings, which are stored in AirSyncFilter.ini and *.dat, are
not touched.
If the AirSyncFilter service is running, it is stopped and
restarted after the update. In the unlikely event that a
executable is locked, the setup program asks for a reboot to
change the file. If you refuse the reboot, you need to manually
reboot later to bring the new executable into affect.
Note: If you are upgrading from a very old version then you must reapply your registration number.
Helper Programs
-
LogView
LogView allows you to view the logfile in real time from any machine on your network.
This is especially useful if MBServer runs as a service.
-
TLS/SSL Toolkit
The TLS/SSL Toolkit
contains a generic certificate that you may use for a quick
start.
Download TLS/SSL Toolkit
and extract cert.pem and cacert.pem into the AirSyncFilter
directory and then turn on TLS/SSL.
Troubleshooting
Click here to view the troubleshooting section
Licensing Agreement
AirSyncFilter ® is copyrighted 1993-2011 by DataEnter GmbH
This product and its documentation may not, in whole or in part, be copied, rent, leased, loaned, resold, assigned, sublicensed, modified, reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any other natural or computer language, in any form or by any means whatsoever, be it electronic, mechanical, magnetic, optical, manual or otherwise, without the prior written consent of DataEnter.
DataEnter makes no warranty or representation, either expressed or implied, with respect to the product
AirSyncFilter and its documentation, their quality, performance, merchantability, or fitness for a particular purpose. DataEnter reserves the right to revise the user's guide and make changes to the content without obligation to notify any person or organization of such change. In no event will DataEnter be liable for any direct, indirect, special, incidental or consequential damages, real or imagined, resulting from the use or purchase of this software. Under no circumstances shall DataEnter's liability for damages exceed the price paid for the software license. Should any remedy hereunder be determined to have failed, all limitations of liability and exclusion of damages set forth above shall remain in full force and effect. The extent of the DataEnter's warranty for the software and its documentation is limited to physical defects of the distribution media containing the software. Contact DataEnter to obtain return authorization for the replacement diskette within 30 days of the original date of purchase. Any further statement made by agents, employees, distributors or dealers of DataEnter do not constitute warranties and are not binding. No employee of DataEnter has the authority to modify any portion of this warranty.
All brand and product names we refer to in the documentation are used solely for identification purposes and may be trademarks of other companies.
AirSyncFilter Standard Edition: DataEnter, (the licensor) grants the buyer (the licensee) the right to use this copy of
AirSyncFilter Standard Edition (the program) on a single computer at a single location running a single instance and servicing a single Exchange server as long as the licensee complies with the terms of this license.
The licensor reserves the right to terminate this license if the licensee violates any part of the agreement. The licensee agrees to make copies of the program only for backup purposes. The licensee agrees not to copy the documentation and to take all necessary precautions to ensure that the backup copies of the software are not distributed to or acquired by other parties.
Support: Support is by e-mail
Upgrades, Updates: Updates are free, as long as the major version number does not change.
( at present the major version number is v3.x )
Trademarks, OpenSSL Credit
History
v3.00 2011-07-22
v3.01 2011-12-05
- New: Rules to prevent delete and change of
common items
- New: Compiled with ASLR (address space
randomization) and NX (no execution)
- Fix: Demo days at midnight
- Fix: Inbound HTTP optimized for faster accepting
new connections
- Fix: Connection manager shut down when system
goes out of resources
- Fix: Inbound connection manager stopped when out
of resources
Click here to view the complete History
|