This document provides a 3 sentence summary of the AntiSamy User Guide:
The guide introduces the AntiSamy project which is an HTML, CSS, and JavaScript filter for Java that sanitizes user input based on a policy file. It describes how to download, configure, and use AntiSamy by importing necessary classes, declaring a policy file path, creating policy and AntiSamy objects, and scanning input to get clean output. The document also explains how to configure policy files and customize filtering by modifying directives, regular expressions, attributes, and element rules in the XML policy file.
This ppt contains a laconic description of HTML history and development and application of HTML5. Some of most frequent and useful tags are also covered.
Joomla is said to be one of the most popularly used Content Management Systems used worldwide. Most people are attracted towards Joomla is because of its $0 price tag.
5 Warning Signs Your BMW's Intelligent Battery Sensor Needs AttentionBertini's German Motors
IBS monitors and manages your BMW’s battery performance. If it malfunctions, you will have to deal with an array of electrical issues in your vehicle. Recognize warning signs like dimming headlights, frequent battery replacements, and electrical malfunctions to address potential IBS issues promptly.
"Trans Failsafe Prog" on your BMW X5 indicates potential transmission issues requiring immediate action. This safety feature activates in response to abnormalities like low fluid levels, leaks, faulty sensors, electrical or mechanical failures, and overheating.
Core technology of Hyundai Motor Group's EV platform 'E-GMP'Hyundai Motor Group
What’s the force behind Hyundai Motor Group's EV performance and quality?
Maximized driving performance and quick charging time through high-density battery pack and fast charging technology and applicable to various vehicle types!
Discover more about Hyundai Motor Group’s EV platform ‘E-GMP’!
What Exactly Is The Common Rail Direct Injection System & How Does It WorkMotor Cars International
Learn about Common Rail Direct Injection (CRDi) - the revolutionary technology that has made diesel engines more efficient. Explore its workings, advantages like enhanced fuel efficiency and increased power output, along with drawbacks such as complexity and higher initial cost. Compare CRDi with traditional diesel engines and discover why it's the preferred choice for modern engines.
What Does the PARKTRONIC Inoperative, See Owner's Manual Message Mean for You...Autohaus Service and Sales
Learn what "PARKTRONIC Inoperative, See Owner's Manual" means for your Mercedes-Benz. This message indicates a malfunction in the parking assistance system, potentially due to sensor issues or electrical faults. Prompt attention is crucial to ensure safety and functionality. Follow steps outlined for diagnosis and repair in the owner's manual.
This ppt contains a laconic description of HTML history and development and application of HTML5. Some of most frequent and useful tags are also covered.
Joomla is said to be one of the most popularly used Content Management Systems used worldwide. Most people are attracted towards Joomla is because of its $0 price tag.
5 Warning Signs Your BMW's Intelligent Battery Sensor Needs AttentionBertini's German Motors
IBS monitors and manages your BMW’s battery performance. If it malfunctions, you will have to deal with an array of electrical issues in your vehicle. Recognize warning signs like dimming headlights, frequent battery replacements, and electrical malfunctions to address potential IBS issues promptly.
"Trans Failsafe Prog" on your BMW X5 indicates potential transmission issues requiring immediate action. This safety feature activates in response to abnormalities like low fluid levels, leaks, faulty sensors, electrical or mechanical failures, and overheating.
Core technology of Hyundai Motor Group's EV platform 'E-GMP'Hyundai Motor Group
What’s the force behind Hyundai Motor Group's EV performance and quality?
Maximized driving performance and quick charging time through high-density battery pack and fast charging technology and applicable to various vehicle types!
Discover more about Hyundai Motor Group’s EV platform ‘E-GMP’!
What Exactly Is The Common Rail Direct Injection System & How Does It WorkMotor Cars International
Learn about Common Rail Direct Injection (CRDi) - the revolutionary technology that has made diesel engines more efficient. Explore its workings, advantages like enhanced fuel efficiency and increased power output, along with drawbacks such as complexity and higher initial cost. Compare CRDi with traditional diesel engines and discover why it's the preferred choice for modern engines.
What Does the PARKTRONIC Inoperative, See Owner's Manual Message Mean for You...Autohaus Service and Sales
Learn what "PARKTRONIC Inoperative, See Owner's Manual" means for your Mercedes-Benz. This message indicates a malfunction in the parking assistance system, potentially due to sensor issues or electrical faults. Prompt attention is crucial to ensure safety and functionality. Follow steps outlined for diagnosis and repair in the owner's manual.
Why Is Your BMW X3 Hood Not Responding To Release CommandsDart Auto
Experiencing difficulty opening your BMW X3's hood? This guide explores potential issues like mechanical obstruction, hood release mechanism failure, electrical problems, and emergency release malfunctions. Troubleshooting tips include basic checks, clearing obstructions, applying pressure, and using the emergency release.
𝘼𝙣𝙩𝙞𝙦𝙪𝙚 𝙋𝙡𝙖𝙨𝙩𝙞𝙘 𝙏𝙧𝙖𝙙𝙚𝙧𝙨 𝙞𝙨 𝙫𝙚𝙧𝙮 𝙛𝙖𝙢𝙤𝙪𝙨 𝙛𝙤𝙧 𝙢𝙖𝙣𝙪𝙛𝙖𝙘𝙩𝙪𝙧𝙞𝙣𝙜 𝙩𝙝𝙚𝙞𝙧 𝙥𝙧𝙤𝙙𝙪𝙘𝙩𝙨. 𝙒𝙚 𝙝𝙖𝙫𝙚 𝙖𝙡𝙡 𝙩𝙝𝙚 𝙥𝙡𝙖𝙨𝙩𝙞𝙘 𝙜𝙧𝙖𝙣𝙪𝙡𝙚𝙨 𝙪𝙨𝙚𝙙 𝙞𝙣 𝙖𝙪𝙩𝙤𝙢𝙤𝙩𝙞𝙫𝙚 𝙖𝙣𝙙 𝙖𝙪𝙩𝙤 𝙥𝙖𝙧𝙩𝙨 𝙖𝙣𝙙 𝙖𝙡𝙡 𝙩𝙝𝙚 𝙛𝙖𝙢𝙤𝙪𝙨 𝙘𝙤𝙢𝙥𝙖𝙣𝙞𝙚𝙨 𝙗𝙪𝙮 𝙩𝙝𝙚 𝙜𝙧𝙖𝙣𝙪𝙡𝙚𝙨 𝙛𝙧𝙤𝙢 𝙪𝙨.
Over the 10 years, we have gained a strong foothold in the market due to our range's high quality, competitive prices, and time-lined delivery schedules.
Things to remember while upgrading the brakes of your carjennifermiller8137
Upgrading the brakes of your car? Keep these things in mind before doing so. Additionally, start using an OBD 2 GPS tracker so that you never miss a vehicle maintenance appointment. On top of this, a car GPS tracker will also let you master good driving habits that will let you increase the operational life of your car’s brakes.
Comprehensive program for Agricultural Finance, the Automotive Sector, and Empowerment . We will define the full scope and provide a detailed two-week plan for identifying strategic partners in each area within Limpopo, including target areas.:
1. Agricultural : Supporting Primary and Secondary Agriculture
• Scope: Provide support solutions to enhance agricultural productivity and sustainability.
• Target Areas: Polokwane, Tzaneen, Thohoyandou, Makhado, and Giyani.
2. Automotive Sector: Partnerships with Mechanics and Panel Beater Shops
• Scope: Develop collaborations with automotive service providers to improve service quality and business operations.
• Target Areas: Polokwane, Lephalale, Mokopane, Phalaborwa, and Bela-Bela.
3. Empowerment : Focusing on Women Empowerment
• Scope: Provide business support support and training to women-owned businesses, promoting economic inclusion.
• Target Areas: Polokwane, Thohoyandou, Musina, Burgersfort, and Louis Trichardt.
We will also prioritize Industrial Economic Zone areas and their priorities.
Sign up on https://profilesmes.online/welcome/
To be eligible:
1. You must have a registered business and operate in Limpopo
2. Generate revenue
3. Sectors : Agriculture ( primary and secondary) and Automative
Women and Youth are encouraged to apply even if you don't fall in those sectors.
Symptoms like intermittent starting and key recognition errors signal potential problems with your Mercedes’ EIS. Use diagnostic steps like error code checks and spare key tests. Professional diagnosis and solutions like EIS replacement ensure safe driving. Consult a qualified technician for accurate diagnosis and repair.
In this presentation, we have discussed a very important feature of BMW X5 cars… the Comfort Access. Things that can significantly limit its functionality. And things that you can try to restore the functionality of such a convenient feature of your vehicle.
What Does the Active Steering Malfunction Warning Mean for Your BMWTanner Motors
Discover the reasons why your BMW’s Active Steering malfunction warning might come on. From electrical glitches to mechanical failures and software anomalies, addressing these promptly with professional inspection and maintenance ensures continued safety and performance on the road, maintaining the integrity of your driving experience.
1. AntiSamy User Guide
This document was prepared by Julian Cohen and generously donated to the OWASP AntiSamy project. It introduces the
project to unfamiliar users and describes how to get, configure and use AntiSamy in your application.
May 11, 20100
1. Introduction
AntiSamy is an HTML, CSS and JavaScript filter for Java that sanitizes user input based on a policy file. AntiSamy is not an
HTML, CSS and JavaScript validator. It is merely a way to make sure HTML, CSS and JavaScript input strictly follows rules
defined by a policy file. The project’s main site and repository are shown here:
http://www.owasp.org/index.php/Category:OWASP_AntiSamy_Project
http://code.google.com/p/owaspantisamy/
AntiSamy does a very good job of removing malicious HTML, CSS and JavaScript, but in security, no solution is
guaranteed. AntiSamy’s success depends on the strictness of your policy file and the predictability of browsers’
behavior. AntiSamy is a sanitization framework; it is up to the user how it does its sanitization. Using AntiSamy does not
guarantee filtering of all malicious code. AntiSamy simply does what is described by the policy file.
AntiSamy is simple from an external view. AntiSamy’s function is based on an XML policy file. The policy file is read in to
create a Policy object that is used by AntiSamy. The Policy object is then passed to AntiSamy to be used in the parsing
and filtering of input. AntiSamy uses the third party libraries Xerces, Batik and NekoHTML to help facilitate parsing and
filtering of input.
2. 2. Setting Up
Download the current AntiSamy jar file from http://code.google.com/p/owaspantisamy/downloads/list or from Maven’s
central repo (under org.owasp.antisamy). These are the dependencies that you will need to satisfy. These are all also
available in Maven’s central repo, or can be downloaded from the locations specified:
xercesImpl.jar http://xerces.apache.org/mirrors.cgi#binary
batik.jar http://xmlgraphics.apache.org/batik/download.cgi
nekohtml.jar http://sourceforge.net/projects/nekohtml/
Once all these jars are in your classpath, you’re ready to start using AntiSamy. A code snippet invoking AntiSamy is
broken down in the next section.
import org.owasp.validator.html.*; // Import AntiSamy
Here, all necessary AntiSamy objects are imported to be used.
String POLICY_FILE_LOCATION = "antisamy-1.4.1.xml"; // Path to policy file
String dirtyInput = "<div><script>alert(1);</script></div>"; // Some fake input
In this step, the path to the XML policy file was declared, and some fake, possibly malicious, data was stored as our user
input.
Policy policy = Policy.getInstance(POLICY_FILE_LOCATION); // Create Policy object
The Policy object was created and populated from the XML policy file in this line. Policy objects can also be read from
InputStreams or File objects directly.
AntiSamy as = new AntiSamy(); // Create AntiSamy object
CleanResults cr = as.scan(dirtyInput, policy, AntiSamy.SAX); // Scan dirtyInput
Here, an AntiSamy object was created and used to sanitize user input based on the Policy object with the SAX parser.
System.out.println(cr.getCleanHTML()); // Do something with your clean output!
The output from AntiSamy was written to the console. As is shown in the “Output”, script tag was removed:
Input:
<div><script>alert(1);</script></div>
Output:
<div></div>
A large part of getting a Cross Site Scripting attack to execute is context. An attacker injecting JavaScript inside a tag
would use a different payload than if they were injecting JavaScript inside an attribute. This is what is meant my
“context.” When AntiSamy filters your input, context plays a major role in if that filtered output is going to be malicious
or not. To avoid anything exceedingly complicated, AntiSamy assumes that all filtered output will be placed in between
a start and end tag.
3. Each line from this code snippet shows whether or not it’s safe to place AntiSamy into a particular HTML context. If
AntiSamy data is used in any other context than what’s shown it’s safe to assume that it’s being used unsafely.
<div>[SAFE]</div>
<input type="text" value="[UNSAFE]">
<textarea>[UNSAFE]</textarea>
<script>var j = '[UNSAFE]';</script>
For more on this distinction, see the following OWASP AntiSamy mailing list threads [1] [2] and the OWASP XSS
Prevention Cheat Sheet.
[1] https://lists.owasp.org/pipermail/owasp-antisamy/2009-October/000263.html
[2] https://lists.owasp.org/pipermail/owasp-antisamy/2011-May/000400.html
[3] https://www.owasp.org/index.php/XSS_(Cross_Site_Scripting)_Prevention_Cheat_Sheet
4. 3. Policy Files
AntiSamy comes with several example policy files based on the function of real-world websites. You can use these as
your policy files, or build upon them to create more specific policies.
When starting out with AntiSamy, you’ll probably want to start off with a base policy file. However, sometimes it may
be difficult to decide which policy file to start with. The following table breaks down the various default policy files that
ship with AntiSamy:
Policy Description
antisamy-tinymce.xml Based on the HTML WYSIWYG editor, relatively safe. This policy file only allows
text formatting, and may be a good choice if users are submitting HTML to be used
in a blog post.
antisamy-anythinggoes.xml A very dangerous policy file, this will allow all HTML, CSS and JavaScript. You
shouldn’t use this in production.
antisamy-ebay.xml Based on the content filtering for the popular electronic auction website,
relatively safe. This policy file gives the user a little bit of freedom, and may be
a good choice if users are submitting HTML for a large portion of a page.
antisamy-myspace.xml Based on the content filtering for the popular social networking site, relatively
dangerous. This policy file gives the user a lot of freedom, and may be a good
choice if users are submitting HTML for an entire page.
antisamy-slashdot.xml Based on the comment filtering on the popular news site, but not quite as strict.
This policy file only allows strict text formatting, and may be a good choice if
users are submitting HTML in a comment thread.
antisamy.xml Default policy file, fairly permissive. This policy file allows most HTML
elements, and may be useful if users are submitting full HTML pages.
Configuring Your AntiSamy Policy
If a base policy file doesn’t meet your needs, you can tweak your policy file to your needs. Each section of the policy file
is broken down in the next few sections to give the developer background on tweaking the output.
Policy File Directives [<directives></directives>]
The following table shows the directives, their default values, and their impact on the AntiSamy filtering process.
Directive Type Default Description
useXHTML boolean false When this feature is on, AntiSamy will output the sanitized
data in XHTML format as opposed to just regular HTML.
omitXMLDeclaration boolean true When "omitXMLDeclaration" is turned on, AntiSamy will
automatically prepend the XML header to output.
Enabling this feature will tell AntiSamy not to do that.
omitDoctypeDeclaration boolean true When this feature is enabled, AntiSamy will automatically
prepend the HTML doctype declaration. By default,
AntiSamy will not prepend this header.
formatOutput boolean true When enabled, AntiSamy will automatically format the
output according to some basic rules and indentation.
Kind of like "pretty print."
maxInputSize int 100000 This directive specifies the maximum size (in bytes) of
user input before it's validated.
embedStyleSheets boolean false When the developer chooses to allow CSS, this directive
5. will specify whether or not remote stylesheets found
referenced in the user's input will be pulled down and
embedded into the current user input.
maxStyleSheetImports int 1 This feature allows developers to specify how many
remote stylesheets can be downloaded from any one
input.
connectionTimeout int 1000 When "embedStyleSheets" is enabled, this timeout value
(in milliseconds) will be used when fetching the offsite
resource in question. This should be used to prevent
validation threads from blocking when connecting to 3rd
party systems that may purposefully act really, really
slowly.
preserveComments boolean false When enabled, AntiSamy will keep HTML comments
supplied in the input.
nofollowAnchors boolean false When enabled, AntiSamy will append rel="nofollow"
attributes to all anchor (<a>) tags supplied in the input.
This is useful for telling search engines not to associate
your site with sites that are under the control of your
users.
validateParamAsEmbed boolean false When enabled, AntiSamy will treat attributes of <embed>
tags in the policy the same as any <param> tags nested
inside the the <embed>. This allows users to, according to
policy, pass in data in either of those two methods with
equal security. This is needed for sites that allow users to
supply videos, etc.
preserveSpace boolean false When enabled, this feature is intended to preserve spaces
as specified in the input without normalization. Right now
it only works as according
to http://xerces.apache.org/xerces-
j/apiDocs/org/apache/xml/serialize/OutputFormat.html#setP
reserveSpace%28boolean%29.
onUnknownTag String remove When this directive is set to "encode," it will encode the
tag using HTML entities, instead of removing the tag,
which is the default behavior.
Common Regular Expressions [<common-regexps> </common-regexps>]
You can declare regular expressions here that can be used in the rest of the Policy File. Example:
<regexp name="htmlId" value="[a-zA-Z0-9:-_.]+"/>
Line 51 in antisamy-1.4.1.xml
This regular expression is used to determine whether text in an id attribute is valid or not.
Common Attributes [<common-attributes> </common-attributes>]
Here you can declare attributes here that are common to many different tags. Example:
<attribute name="id" description="The 'id' of any HTML attribute should not contain
anything besides letters and numbers">
<regexp-list>
<regexp name="htmlId"/>
</regexp-list>
</attribute>
Lines 145-149 in antisamy-1.4.1.xml
6. This is where the id attribute is mapped to the htmlId regular expression.
Global Tag Attributes [<global-tag-attributes> </global-tag-attributes>]
You can declare attributes here that are global to all different tags. Example:
<attribute name="id"/>
Line 496 in antisamy-1.4.1.xml
The id attribute is global to many different tags.
Tags to Encode [<tags-to-encode> </tags-to-encode>]
You can declare tags here that will not be removed, filtered, validated or truncated, but encoded using HTML entities.
Example:
<tag>g</tag>
Line 505 in antisamy-1.4.1.xml
The g tag doesn’t actually do anything, but it isn’t malicious either so we can encode it, rather than remove it.
Tag Rules [<tag-rules> </tag-rules>]
You can define parsing rules here that will be used for each tag individually. The following section shows what happens
to tags according to what actions AntiSamy has decided to perform on it. This will help understand how to build your
own tag-rules rules.
Default: Behavior when the tag is not listed in <tag-rules>
Input:
<div><anewtag id="newtag" anewattrib="attrib">Text goes
<b>here</b>.</anewtag></div>
Output:
<div>Text goes <b>here</b>.</div>
remove: Behavior when the tag-rule action is set to “remove” for given tag. Tag is deleted with all of its child text.
Input:
<div><anewtag id="newtag" anewattrib="attrib">Text goes
<b>here</b>.</anewtag></div>
Output:
<div></div>
filter: Behavior when the tag-rule action is set to “filter” for given tag. Delete tag, but keep its child text.
Input:
<div><anewtag id="newtag" anewattrib="attrib">Text goes
<b>here</b>.</anewtag></div>
Output:
<div>Text goes <b>here</b>.</div>
validate: Behavior when the tag-rule action is set to “validate” for given tag. Verify that its attributes and children
elements follow rules defined in policy file.
Input:
<div><anewtag id="newtag" anewattrib="attrib">Text goes
<b>here</b>.</anewtag></div>
7. Output:
<div><anewtag id="newtag">Text goes <b>here</b>.</anewtag></div>
truncate: Behavior when the tag-rule action is set to “validate” for given tag . Keep the element, but remove all
attributes.
Input:
<div><anewtag id="newtag" anewattrib="attrib">Text goes
<b>here</b>.</anewtag></div>
Output:
<div><anewtag>Text goes <b>here</b>.</anewtag></div>
Example:
<tag name="html" action="validate"/>
Line 513 in antisamy-1.4.1.xml
The html tag is included in the clean output after it has been validated that it has been properly used.
CSS Rules [<css-rules> </css-rules>]
You can define parsing rules here that will be used for each CSS property individually. Only CSS defined in this section is
allowed. Example:
<property name="width" default="auto" description="">
<category-list>
<category value="visual"/>
</category-list>
<literal-list>
<literal value="auto"/>
<literal value="inherit"/>
</literal-list>
<regexp-list>
<regexp name="length"/>
<regexp name="percentage"/>
</regexp-list>
</property>
Lines 2096-2108 in antisamy-1.4.1.xml
The CSS width property is allowed only when it matches these rules when used. The value of the width element must
be a length, percentage or one of the two literal values “auto” or “inherit”.
8. 4. References
The following references may be useful for further reading.
OWASP AntiSamy Project Page
http://www.owasp.org/index.php/AntiSamy
AntiSamy Policy File Directives Documentation (old)
http://www.owasp.org/index.php?title=AntiSamy_Directives&oldid=71778
AntiSamy OWASP Project Assessment Checklist
http://spreadsheets.google.com/ccc?key=pAX6n7m2zaTW-JtGBqixbTw
AntiSamy Mailing List Archives
https://lists.owasp.org/pipermail/owasp-antisamy/
XSS (Cross Site Scripting) Prevention Cheat Sheet
http://www.owasp.org/index.php/XSS_(Cross_Site_Scripting)_Prevention_Cheat_Sheet