Merge pull request #15160 from github/max-schaefer/csharp-xss

C#: Mention more XSS sanitisation options in query help.

Author: max-schaefer

csharp/ql/src/Security Features/CWE-079/XSS.qhelp

@@ -11,17 +11,24 @@ without properly sanitizing the input first, allows for a cross-site scripting v
 </overview>
 <recommendation>
 
-<p>To guard against cross-site scripting, consider using contextual output encoding/escaping before
-writing user input to the page, or one of the other solutions that are mentioned in the
-references.</p>
+<p>
+To guard against cross-site scripting, consider using a library that provides suitable encoding
+functionality, such as the <code>System.Net.WebUtility</code> class, to sanitize the untrusted input before writing it to the page.
+For other possible solutions, see the references.
+</p>
 
 </recommendation>
 <example>
 
-<p>The following example shows the page parameter being written directly to the server error page,
-leaving the website vulnerable to cross-site scripting.</p>
-
-<sample src="XSS.cs" />
+<p>
+The following example shows the page parameter being written directly to the server error page,
+leaving the website vulnerable to cross-site scripting.
+</p>
+<sample src="XSSBad.cs" />
+<p>
+Sanitizing the user-controlled data using the <code>WebUtility.HtmlEncode</code> method prevents the vulnerability:
+</p>
+<sample src="XSSGood.cs" />
 
 </example>
 <references>
@@ -36,6 +43,5 @@ OWASP:
 Wikipedia: <a href="http://en.wikipedia.org/wiki/Cross-site_scripting">Cross-site scripting</a>.
 </li>
 
-
 </references>
 </qhelp>

csharp/ql/src/Security Features/CWE-079/XSS.cs renamed to csharp/ql/src/Security Features/CWE-079/XSSBad.cs

@@ -0,0 +1,13 @@
+using System;
+using System.Web;
+using System.Net;
+
+public class XSSHandler : IHttpHandler
+{
+    public void ProcessRequest(HttpContext ctx)
+    {
+        string page = WebUtility.HtmlEncode(ctx.Request.QueryString["page"]);
+        ctx.Response.Write(
+            "The page \"" + page + "\" was not found.");
+    }
+}