This section describes how to sanitize the Rich Text Editor serverside
The rich text editor is sanitized on the frontend by default, however, you may want to do this serverside as well. The libraries that are out there tend to have very strict, and therefore, problematic dependencies, so we'll leave it up to you how you want to sanitize the HTML.
To make this task as easy as possible we've added an abstraction called IHtmlSanitizer
, by default this doesn't do anything, but you can overwrite it with your own implementation to handle sanitization how you see fit. This interface only has a single method string Sanitize(string html)
, the output of this method is what will be stored in the database when you save a RichText editor.
To add your own sanitizer you must first create a class the implements the interface:
As you can see this specific implementation doesn't do a whole lot, but the Sanitize
method is where you can use a library, or even your own sanitizer implementation, to sanitize the RichText editor input.
Now that you've added your own custom IHtmlSanitizer
you must register it in the container to replace the existing NoOp sanitizer.
You can register it directly in the Startup.cs
, for instance using an extension method on the IUmbracoBuilder
:
Extension method:
Calling the extension method:
Or you can use a Composer:
If you've followed along you'll now see that no matter what you type in a Rich Text Editor, when you save it, it'll always only contain a heading that says "Sanitized HTML", this is of course isn't that helpful, but it shows that everything is working as expected, and that whatever your sanitizer returns is what will be saved.