debian-mirror-gitlab/lib/banzai/filter/base_sanitization_filter.rb
2022-01-26 12:08:38 +05:30

74 lines
2.5 KiB
Ruby

# frozen_string_literal: true
module Banzai
module Filter
# Sanitize HTML produced by markup languages (Markdown, AsciiDoc...).
# Specific rules are implemented in dedicated filters:
#
# - Banzai::Filter::SanitizationFilter (Markdown)
# - Banzai::Filter::AsciiDocSanitizationFilter (AsciiDoc/Asciidoctor)
# - Banzai::Filter::BroadcastMessageSanitizationFilter (Markdown with styled links and line breaks)
#
# Extends HTML::Pipeline::SanitizationFilter with common rules.
class BaseSanitizationFilter < HTML::Pipeline::SanitizationFilter
include Gitlab::Utils::StrongMemoize
extend Gitlab::Utils::SanitizeNodeLink
UNSAFE_PROTOCOLS = %w(data javascript vbscript).freeze
def allowlist
strong_memoize(:allowlist) do
allowlist = super.deep_dup
# Allow span elements
allowlist[:elements].push('span')
# Allow data-math-style attribute in order to support LaTeX formatting
allowlist[:attributes]['code'] = %w(data-math-style)
allowlist[:attributes]['pre'] = %w(data-math-style data-mermaid-style data-kroki-style)
# Allow html5 details/summary elements
allowlist[:elements].push('details')
allowlist[:elements].push('summary')
# Allow abbr elements with title attribute
allowlist[:elements].push('abbr')
allowlist[:attributes]['abbr'] = %w(title)
# Disallow `name` attribute globally, allow on `a`
allowlist[:attributes][:all].delete('name')
allowlist[:attributes]['a'].push('name')
# Allow any protocol in `a` elements
# and then remove links with unsafe protocols
allowlist[:protocols].delete('a')
allowlist[:transformers].push(self.class.method(:remove_unsafe_links))
# Remove `rel` attribute from `a` elements
allowlist[:transformers].push(self.class.remove_rel)
customize_allowlist(allowlist)
end
end
def customize_allowlist(allowlist)
raise NotImplementedError
end
class << self
def remove_rel
lambda do |env|
if env[:node_name] == 'a'
# we allow rel="license" to support the Rel-license microformat
# http://microformats.org/wiki/rel-license
unless env[:node].attribute('rel')&.value == 'license'
env[:node].remove_attribute('rel')
end
end
end
end
end
end
end
end