- Notifications
You must be signed in to change notification settings - Fork2
License
0xception/slurm
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
This software is an eCAP adapter used to inject or enable a promotionalnetwork by injecting an ad/promotion into the users http browser session.However the mechanism is broad enough to allow any javascript to be injectedinto a users session.
Available adapters (installed in /usr/local/lib/ by default):
slurm: injects an html script tag into the header of any valid http web request. Requests are validated against an extension list, a domain whitelist, and request/response headers including: Cache-Control "no-transform", Content-MD5, Content-Type "text/html", and Content-Encoding. After validation the headers are then mangled to include no-cache controls and date last modified to limit the amount of caching by the browser.
The libecap-0.0.3 library is required to build and use these adapters. You canget the library fromhttp://www.e-cap.org/. The adapters can be built andinstalled from source, usually by running:
% ./configure% make% sudo make install
For documentation, the libecap library implementation, and supportinformation, please visit the eCAP project web site:http://www.e-cap.org/
This adapter and libecap work in conjunction with squid-3.1.15 proxy server.You can get squid fromhttp://www.squid-cache.org/. Squid can be built in asimilar manor, usually by running:
% ./configure --enable-ecap --prefix=/usr% make% sudo make install
For documentation and support please see the squid projects websitehttp://www.squid-cache.org/.
Next we need to build the ecap slurm adapter.
% ./bootstrap.sh% ./configure% make% sudo make install
After installing the slurm adapter we just need to setup squid config. Copythe example configuration file over to /etc/squid/slurm.conf and setup squidto using this config. Or you can replace the default config.
% sudo cp config/slurm.conf /etc/squid/squid.conf
Now you can start squid either using the manual configuration or using thenewly copied default config.
% /usr/sbin/squid -f /etc/config/slurm.conf
or% /etc/init.d/squid start
To shutdown squid you can use the stop or the shutdown command
% /usr/sbin/squid -f /etc/config/slurm.conf -k shutdown
or% /etc/init.d/squid stop
Make sure to also open up any firewall to use the port configured inslurm.conf.