How to safely output rich text content in AnQiCMS templates and avoid XSS attacks?

When building and operating a website, content display is undoubtedly the core link.Especially when displaying rich text content that includes images, links, bold, italic, and other formats, how to ensure that the page is beautiful while also effectively resisting potential security threats is a problem worth in-depth discussion.AnQiCMS (AnQiCMS) is a content management system that emphasizes security and efficiency, providing clear and strong mechanisms in this regard.

The built-in security mechanism of AnQi CMS: Your first line of defense

<Will be escaped to<,>Will be escaped to>,"Will be escaped to"And so on), will be automatically converted into safe character entities.

This mechanism is the key first step in preventing cross-site scripting attacks (XSS).XSS attacks are usually implemented by injecting malicious scripts into websites. If the template directly outputs user input without filtering, attackers may exploit this vulnerability to steal user information, tamper with page content, or even control the user's browser.The default automatic escaping of AnQi CMS is to intercept these potential malicious codes, to display them as plain text instead of executable code, thus fundamentally protecting the website and the safety of visitors.

Understanding rich text content: Why is it special?

However, not all content needs to be escaped.For example, when we edit articles, we often use features such as bold, italic, inserting images, and adding links provided by rich text editors.This content is actually stored in the form of HTML tags.<p>这是一段<strong>加粗</strong>的文字</p>This is not the effect we want.

In a scenario where the browser needs to correctly parse and render HTML tags, we need a mechanism to “tell” the Anqi CMS template engine: “This content is confirmed safe HTML, please do not escape it, and parse and display it directly as HTML.”

When to use|safeFilter: The Correct Way to Unlock Rich Text

In the Anqi CMS template system, this "tell" mechanism to the template engine is,|safeFilter. When you output a variable, if the variable contains content you want to be interpreted as HTML instead of escaped rich text, you can add|safefilter.

For example, on the article detail page, we usually need to display the content of the document (archive.Content), the detailed description of the category (category.Content), or the content of a single page (page.ContentThese are all rich text. The correct output should be like this:

{# 输出文章详情内容 #}
<div>
    {%- archiveDetail articleContent with name="Content" %}
    {{ articleContent|safe }}
</div>

{# 输出分类的详细内容 #}
<div>
    {%- categoryDetail categoryContent with name="Content" %}
    {{ categoryContent|safe }}
</div>

{# 输出单页面的内容 #}
<div>
    {%- pageDetail pageContent with name="Content" %}
    {{ pageContent|safe }}
</div>

By adding|safeFilter, you explicitly tell the template engine,articleContent/categoryContentandpageContentThis content in these variables is 'safe' HTML and can be output directly.

But please note:Use|safeThe filter means that as a website operator, you are responsible for this content.safety responsibility. Once used|safe，AnQi CMS will no longer automatically escape this content, it will completely trust the content you provide.If this content comes from untrusted user input, or if it contains malicious JavaScript code, then this malicious code will be executed in the user's browser, thereby triggering an XSS attack.|safeThe filter should only be used when you have confirmed that the content source is reliable and that the rich text content has been processed securely.

Safe rendering of Markdown content

The AnQi CMS also supports Markdown editors, which provides another convenient way for content creators to write.When the background enables the Markdown editor and you insert Markdown formatted content into the document, an additional step is required when Anqi CMS outputs the content in the template: convert Markdown to HTML.

Now, you can use|renderThe filter is responsible for parsing Markdown syntax and converting it to the corresponding HTML structure. After the conversion is complete, since the result is HTML, we still need to use|safeA filter to ensure that these HTML can be properly parsed and displayed in the browser, rather than being escaped as plain text.

Here is an example:

{# 假设archive.Content中是Markdown格式的内容，先通过render转换为HTML，再通过safe输出 #}
<div>
    {%- archiveDetail articleContent with name="Content" %}
    {{ articleContent|render|safe }}
</div>

Here|renderIt will convert Markdown text to HTML and then|safeThe filter is responsible for safely displaying the converted HTML on the page.

Avoid XSS attacks **practices: It\'s not just|safe

relying on|safeA filter is not enough to build a completely secure website. A strong CMS system has a multi-layered security mechanism. When using anqi CMS, we should also:

1. Strictly manage the source of content:
2. Utilize built-in security features:The AnQi CMS comes with features such as content security management, sensitive word filtering, and anti-crawling interference code.Configure these features in the background to review and filter published content in real time. Even if there is any inappropriate content by mistake, it can be discovered and handled in time.
3. Regularly update the system:Software security vulnerabilities occur from time to time, and the Anqi CMS team will continuously release updates to fix known issues and enhance security.By using the system upgrade feature on the backend, ensure that your AnQiCMS is always running the latest version, which is an important aspect of website security.
4. Content review:For user-generated content (UGC), such as comments, message boards, etc., it is recommended to enable content review functionality.In the background, you can manually review this content and ensure its safety before publishing it to the front end.The Anqi CMS comment list tag and message form tag both provide relevant parameters to handle the review status.

Understand the automatic escaping mechanism of AnQi CMS and use it reasonably:|safeand|renderA filter, combined with strict content management and system security features, enables us to ensure a rich and diverse content while effectively preventing XSS attacks, providing users with a safe and reliable browsing environment.

---

Frequently Asked Questions (FAQ)

**1. I outputted in the template{{ archive.Content }},