How to upgrade from v2 to v3

Split exclusion settings

Move any static-asset extensions out of DATADOME_URL_REGEX_EXCLUSION :

  • DATADOME_URL_REGEX_EXCLUSION now holds only your own URL exclusions.
  • DATADOME_STATIC_ASSET_EXCLUSION (new) holds static-asset extensions: standard list, on by default.
- DATADOME_URL_REGEX_EXCLUSION="/health|/heartbeat|\.(avi|avif|bmp|css|eot|flac|flv|gif|gz|ico|jpeg|jpg|js|json|less|map|mka|mkv|mov|mp3|mp4|mpeg|mpg|ogg|ogm|opus|otf|png|svg|svgz|swf|ttf|wav|webm|webp|woff|woff2|xml|zip)$"
+ DATADOME_URL_REGEX_EXCLUSION="/health|/heartbeat"

Additional URI checks enabled by default

Review each setting and disable it only if necessary for compatibility with your application.

  • Matrix params DATADOME_REMOVE_MATRIX_PARAMS): like query params (?), we ignore matrix params (;) before regex evaluation.
  • Encoding DATADOME_ENCODED_CHAR_INCLUSION): we inspect static-looking paths containing one of %23 %25 %2f %3b %3f.

For more information, see Split exclusion settings and default checks.


Did this page help you?