mirror of
https://github.com/Smaug123/KaTeX
synced 2025-10-07 20:28:38 +00:00
* Add note re: HTML to security documentation page * Update docs/security.md Co-authored-by: ylemkimon <y@ylem.kim> Co-authored-by: ylemkimon <y@ylem.kim> Co-authored-by: Erik Demaine <edemaine@mit.edu>
22 lines
944 B
Markdown
22 lines
944 B
Markdown
---
|
|
id: security
|
|
title: Security
|
|
---
|
|
Any HTML generated by KaTeX *should* be safe from `<script>` or other code
|
|
injection attacks.
|
|
|
|
Of course, it is always a good idea to sanitize the HTML, though you will need
|
|
a rather generous whitelist (including some of SVG and MathML) to support
|
|
all of KaTeX.
|
|
|
|
A variety of options give finer control over the security of KaTeX
|
|
with untrusted inputs; refer to [Options](options.md) for more details.
|
|
* `maxSize` can prevent large width/height visual affronts.
|
|
* `maxExpand` can prevent infinite macro loop attacks.
|
|
* `trust` can allow certain commands that may load external resources or change HTML attributes and thus are not always safe (e.g., `\includegraphics` or `\htmlClass`)
|
|
|
|
The error message thrown by KaTeX may contain unescaped LaTeX source code.
|
|
See [Handling Errors](error.md) for more details.
|
|
|
|
> If you discovered a security issue, please let us know via https://hackerone.com/khanacademy
|