This site is the archived OWASP Foundation Wiki and is no longer accepting Account Requests.
To view the new OWASP Foundation website, please visit

Category:OWASP Scrubbr

Revision as of 05:44, 5 February 2009 by Arshan (talk | contribs)

Jump to: navigation, search

What is Scrubbr?

Scrubbr is a BSD-licensed database scanning tool that checks numerous database technologies for the presence of possible stored cross-site scripting attacks. The tool was partialy inspired by "Scrawlr", a trimmed-down version of HP's WebInspect which was released for free after the so-called "asprox" mass-SQL injection bot exploited hundreds of thousands of insecure ASP sites.

In a similar vein, Aspect Security generously donated Scrubbr to OWASP to help people get some visibility into their databases and check for malicious data.

What can Scrubbr do for me?

If you can tell Scrubbr how to access your database, it will search through every field capable of holding strings in the database for malicious code. If you want it to, it will search through every table, every row, and every column. This will be very slow on large enterprise databases, but its very useful to have assurance that there is no malicious data anywhere in the system.

Scrubbr can detect input that doesn't match up with an AntiSamy policy file. There is a subtle difference between "matching an AntiSamy policy" and being "detected as an attack."

There are numerous tools out that *detect* XSS attacks in different contexts better than AntiSamy. The most prominent and peer-reviewed are NoScript ( and PHPIDS ( However, this is not strictly what AntiSamy does. AntiSamy checks if rich input that is passed in is allowed according to a policy file.

Chances are that there is some input in your database that looks like rich input how we in the web world think about it, but actualy isn't. For example, if someone writes the following in their profile comment:

"Hey, I sure am gonna miss seeing Sarah Palin on TV all the time <g>".

Obviously the user intended the <g> string to express a grin emotion, but that unfortunately looks like rich input, and since AntiSamy uses a whitelist for higher assurance, it will be flagged.

We are always looking to improve our engine, and we are working with the PHPIDS group to possibly invoke their ruleset in order to provide less false positives.

With all of that being said, AntiSamy does an excellent job in most situations and will still detect the vast majority of stored XSS attacks, depending on the injection context.

What can't Scrubbr do for me?

Scrubbr can't find XSS vulnerabilities in your web application. It can only detect data that doesn't follow your site's policy for input that is in your database. If you don't have a policy for rich input, then start with the Slashdot policy file and add what you think you need from the other policy files. More information on policy files can be found on the OWASP AntiSamy page:

Once you have a policy in place, then you can enfoce it with Scrubbr.

How do I get Scrubbr?

You can download the Scrubbr installer from the project's Google Code downloads page.

Contacting the Scrubbr group

If you would like to request a feature, let us know about a bug, or provide a patch, please let us know on the Google Code issue tracker for the project:

General questions can be e-mailed to the Scrubbr mailing list [email protected]. If you have a question about Scrubbr development, contact the [email protected] mailing list.

Known issues

Scrubbr is a new open source project, and not surprisingly it has a few issues that we are working to address. If you have an issue that's not on this list, please add it to the issues list described in the previous section.

"I installed Scrubbr to C:\Program Files on Vista, and now the Uninstaller doesn't quite work

Microsoft Vista uses Virtual Paths (like Java servlets) to accommodate the diverge between UAC and Windows XP security, which makes uninstalling a manual process when you install to C:\Program Files. This is why the installer defaults the value to C:\Scrubbr on Windows.

When a user executes a setup executable (setup.exe, install.exe, etc.) Vista will prompt you with a security dialog before it allows the setup program to install files to a system directory like C:\Program Files. However, since Scrubbr uses [izPack] as a cross-platform installer, the setup executable is actually a cross-platform JAR executable instead of an exe file. This does not trip the necessary Windows Vista UAC prompt and therefore silently fails to actually install to C:\Program Files. However, since Vista knew that this behavior would happen a lot, they compensated by redirecting the installation to another path, C:\Users\<your_username>\AppData\Local\VirtualStore\Program Files. Therefore, when the Uninstaller runs, it tries to delete C:\Program Files\Scrubbr, which doesn't exist, since it's unaware that Scrubbr has been installed to a virtual directory.

This can be thought of as a bug in either Vista or in izPack, since neither accounts for the other. However, izPack allows us to install to many different platforms cleanly, so we don't think we're going to switch. That being said, uninstalling on Vista when the Uninstall option doesn't work is simple: 1. Open up Explorer 2. Navigate to C:\Users\<your_username>\AppData\Local\VirtualStore\Program Files 3. Delete the Scrubbr directory 4. Confirm that Scrubbr is no longer in your Start Menu or Program Files directory

Scrubbr has an extremely small footprint. It installs a few files into Program Files and that is it. There is no user settings in your profile directory or registry values or anything of the sort. Simply deleting the directory makes it go away forever.


Scrubbr was primarily developed by Arshan Dabirsiaghi ([email protected]) of Aspect Security with help from Brandon DeVries ([email protected]). Other folks contributed in their own ways, including:

  • Dave Wichers, COO, Aspect Security
  • Jeff Williams, CEO, Aspect Security
  • Mike Fauzy, Senior Application Security Engineer, Aspect Security
  • Marcin Wielgoszewski, Security Consultant, Founder

Pages in category "OWASP Scrubbr"

This category contains only the following page.