Quick Start Guide¶
Using it with Mozilla Firefox and NoScript¶
- Dowload the latest Blitzableiter browser binaries.
- Put it in a directory of your choice.
- Open your Firefox, click on the NoScript symbol and choose "Settings".
- Click the "Advanced" tab.
- Check the "Enable external filters" box.
- Enter "shockwave|futuresplash" as content type.
- As "Executable file" select the Blitzableiter binary that you downloaded before.
- Select the domains you do not want to filter ".youtube.com" e.g.
private
Blitzableiter should now be ready to use. Whenever a Flash file appears on a site you are visiting, NoScript passes this file to Blitzableiter. If it is a well formed Flash file, Blitzableiter returns it to NoScript. If not a custom Flash file containing error information will be displayed.
Using it with the ICAP server¶
In order to use the Blitzableiter ICAP service you need a Squid3 (or another ICAP enabled proxy) which sends the SWF files to Blitzableiter.
Getting Blitzableiter¶
- Dowload the latest Blitzableiter ICAP binaries.
- Put it in a directory of your choice.
Configuring Blitzableiter¶
The Blitzableiter ICAP server has to be configured first. You can find the configuration file in the program directory under /Configuration/icap.config.
- Apply your desired connections settingsprivate
- Leave the ICAP settings as they are
- Under "Storing Files" set your inputdirectory and outputdirectory
- Under "Logging" set your log path, and select the types of log files you want to get written. For normal use <LogLevel>Error</LogLevel> should be enough. Only enable <LogLevel>Debug</LogLevel> is you have real issues. In this case you should contact us and append the log files.
- Under "Blitzableiter" set the path to the replacement file which will be displayed in the clients browser if the file gets rejected. The file is part part of this distribution (replacement.swf)
When using the ICAP server on a Windows host, you have to have the .NET framework installed.
In order to start the ICAP service under Linux you have to have the Mono framework installed.
With Ubuntu for instance it can be installed via:
apt-get install mono-runtime
Now Blitzableiter can be started by invoking
ricaps.exe
Configuring Squid¶
After Blitzableiter ICAP is set up you have to configure Squid to use the ICAP Server. Add the following lines to the your squid configuration.icap_enable on icap_send_client_ip off icap_send_client_username off icap_service Blitzableiter respmod_precache bypass=1 icap://IP:PORT/response acl acl_flash rep_mime_type shockwave|futuresplah adaptation_access Blitzableiter allow acl_flash
After a restart Squid now should send all responses with mime type shockwave or futuresplash to the Blitzableiter ICAP server which filters them.
Note¶
Squids ICAP client sends the complete HTTP Request and HTTP Response to the ICAP server.
This may contain sensitive data like cookies and session IDs. Keep that in mind.