sanitizer.go 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
  1. // Copyright 2017 The Gogs Authors. All rights reserved.
  2. // Use of this source code is governed by a MIT-style
  3. // license that can be found in the LICENSE file.
  4. package markup
  5. import (
  6. "regexp"
  7. "sync"
  8. "github.com/microcosm-cc/bluemonday"
  9. "github.com/gogits/gogs/pkg/setting"
  10. )
  11. // Sanitizer is a protection wrapper of *bluemonday.Policy which does not allow
  12. // any modification to the underlying policies once it's been created.
  13. type Sanitizer struct {
  14. policy *bluemonday.Policy
  15. init sync.Once
  16. }
  17. var sanitizer = &Sanitizer{
  18. policy: bluemonday.UGCPolicy(),
  19. }
  20. // NewSanitizer initializes sanitizer with allowed attributes based on settings.
  21. // Multiple calls to this function will only create one instance of Sanitizer during
  22. // entire application lifecycle.
  23. func NewSanitizer() {
  24. sanitizer.init.Do(func() {
  25. // We only want to allow HighlightJS specific classes for code blocks
  26. sanitizer.policy.AllowAttrs("class").Matching(regexp.MustCompile(`^language-\w+$`)).OnElements("code")
  27. // Checkboxes
  28. sanitizer.policy.AllowAttrs("type").Matching(regexp.MustCompile(`^checkbox$`)).OnElements("input")
  29. sanitizer.policy.AllowAttrs("checked", "disabled").OnElements("input")
  30. // Custom URL-Schemes
  31. sanitizer.policy.AllowURLSchemes(setting.Markdown.CustomURLSchemes...)
  32. })
  33. }
  34. // Sanitize takes a string that contains a HTML fragment or document and applies policy whitelist.
  35. func Sanitize(s string) string {
  36. return sanitizer.policy.Sanitize(s)
  37. }
  38. // SanitizeBytes takes a []byte slice that contains a HTML fragment or document and applies policy whitelist.
  39. func SanitizeBytes(b []byte) []byte {
  40. return sanitizer.policy.SanitizeBytes(b)
  41. }