Skip to content

v0.10.0

Latest

Choose a tag to compare

@github-actions github-actions released this 06 Nov 23:30
· 5 commits to main since this release
3a18024

Upgrade notes:

  • New reports carry schemaVersion: "1.5.0". It adds the report language hu and the
    linked-page observation with its reasons. Consumers that accept 1.4.0 only must add 1.5.0
    (schemas/report-1.5.0.schema.json).
  • On sites with subdomains, the first crawled page of up to five other hosts (docs., blog.)
    now gets the consent, banner and HTTPS checks too. That can add findings and one consent run
    per host. --host-checks main or "hostChecks": "main" keeps the previous behaviour.
  • The legal notice and the privacy policy linked from the start page are loaded once more for the
    new legal-notice-content, privacy-policy-vendors and privacy-policy-content rules, plus a
    cookie policy the privacy policy links. That is up to three extra page loads per scan, also
    through a network adapter, and can add findings. Deselect a rule to skip its load. Without a
    legal notice link, a page behind a vague legal link or the privacy policy is read instead.
  • New dependency pdfjs-dist (5.1.x, the last line that supports Node 20.12) to read PDF cookie
    policies. It brings the optional @napi-rs/canvas, which privalint does not use; install with
    --omit=optional to skip it.
  • Native scans make DNS lookups for up to 20 first-party subdomains that received requests, to
    find CNAME-cloaked trackers. Scans through a network adapter make none.
  • New rules run by default and can add findings: mixed-content reports a form that submits over
    HTTP as an error, so scans with the default --fail-on error can fail on it;
    form-preticked-consent, privacy-policy-content, third-party-personal-data and
    banner-keyboard add warnings,
    referrer-policy info.
  • Values of e-mail and phone parameters in request addresses are replaced by [redacted] in
    finding evidence, so evidence strings of native scans can differ from earlier reports.
  • Scans with the settings check can report the new consent-preselected error on banners whose
    settings layer starts with optional categories switched on.

Added

  • Fix guides for Cookiebot, Usercentrics, OneTrust and Complianz (docs/fixes, English and
    German): each consent finding mapped to the setting in that consent manager, every step linked to
    the vendor's documentation. When the consent manager is recognised, the fix of the finding links
    the section; Hungarian reports link the English guide. Complianz's documented reopen class
    cmplz-show-banner now counts as a settings link (#138)
  • privacy-policy-vendors reads a cookie policy published as a PDF on the same site: it is
    downloaded (up to 5 MB, through the network adapter when there is one) and its text extracted
    with pdf.js, without running code from the file. A PDF that fails or is larger stays unread as
    before (#113)
  • --format html (and -o report.html) writes a self-contained HTML report with inline CSS for
    light and dark: findings by page and severity, evidence in collapsible sections, fixes, legal
    basis and the disclaimer. Every scanned value is escaped, and the page loads nothing (#129)
  • --baseline <report.json> (Action input baseline) compares the findings with an earlier JSON
    report: each finding is marked new or existing by rule, page and subject (the SARIF
    fingerprint), baseline.fixed lists the findings that are gone where the rule ran again, and --fail-on counts new
    findings only. Text and Markdown show the counts, SARIF sets baselineState. A baseline with
    another schema major version is rejected (#128)
  • New opt-in rule gpc-signal (--gpc, config gpc, Action input gpc): privalint loads the
    start page once more with Global Privacy Control (Sec-GPC: 1 and
    navigator.globalPrivacyControl) and notes as info whether the banner hides and trackers stay
    away. The outcome is in consent.gpc (schema 1.5.0) (#132)
  • --check-accept (config acceptCheck, Action input check-accept): privalint also accepts in a
    fresh browser, reloads and records what loads then. privacy-policy-vendors then also looks for
    services that run only with consent, and thirdParties lists them with the phase
    after-accept. The outcome is in consent.accept (schema 1.5.0); there is no finding of its
    own (#131)
  • New rule banner-keyboard (warning): before clicking reject, privalint presses Tab up to 60
    times and warns when the reject control never gets focus, with the element and the press that
    focused the accept control as evidence (#122)
  • CNAME-cloaked trackers: native scans resolve the CNAME chain of first-party subdomains that
    received requests and report a chain that reaches a tracker (from the tracker list and AdGuard's
    cname-trackers list) through pre-consent-trackers, with the chain as evidence. No DNS lookups
    through a network adapter or offline (#126)
  • New rule fingerprinting (warning): a third-party script reads back a canvas, the unmasked WebGL
    renderer or an offline audio rendering before consent. Charts that only draw are not reported;
    reCAPTCHA, hCaptcha and Turnstile are info. The Fingerprint agent hosts are on the tracker list
    (#124)
  • Trackers routed through the site's own domain are recognised by their path and parameters on
    any host: GA4 /g/collect?v=2&tid=G-…, Universal Analytics collect hits, server-side Google Tag
    Manager gtm.js?id=GTM-… and gtag/js?id=G-…, and Meta Pixel /tr?id=…&ev=…. The evidence names
    the host they were proxied through (#125)
  • New opt-in rule trackers-after-close (--check-close, config closeCheck, Action input
    check-close): privalint closes the banner with its close button ("×", "Schließen") in a fresh
    browser, reloads and reports trackers that load then as errors, since closing is no choice. A
    banner without a close button counts as checked. The result is in consent.close (schema
    1.5.0) (#121)
  • New rule banner-language (info): the consent banner is in another language than the page's
    <html lang>, guessed from common words of eight languages. A banner in the language of the
    browser locale is not reported, since many consent managers follow it (#123)
  • --sitemap (config sitemap, Action input sitemap) chooses the pages after the start page from
    the sitemap: Sitemap: lines in robots.txt, else /sitemap.xml, with sitemap indexes one level
    deep. Up to half the pages go to pages likely to hold forms or checkout steps (/kontakt,
    /newsletter, /checkout, …), shallowest first and one per section; the rest take one page per
    section in turn. Same-site pages only, within maxPages; without
    a sitemap the crawl follows links as before (#133)
  • Reports list every host outside the site that answered a request in thirdParties: registrable
    domain, first page, phases, request count and the vendor privalint knows it as, hosts only. The
    Markdown report shows it as a collapsed table, a starting point for the privacy policy and for
    new list entries (#127)
  • --device <name> (config device, Action input device) emulates a Playwright device such as
    "iPhone 15": viewport, user agent and touch, so banners are checked in their mobile layout, where
    the reject button is often hidden or smaller. The report records it in options.device
    (schema 1.5.0) (#130)
  • New rule third-party-personal-data (warning): requests to other sites carry e-mail
    addresses or phone numbers in their query string, plain or as SHA-256 hashes in parameters
    such as em or ud[em]. Only parameter names are reported, and the values are replaced by
    [redacted] in every finding that shows a request address (#118)
  • third-party-embeds fixes point to the YouTube privacy-enhanced mode, the Vimeo dnt=1
    parameter and a placeholder image for Google Maps. None replaces consent (#137)
  • New rule form-preticked-consent (warning): a form ticks a newsletter or advertising consent
    checkbox before the visitor chooses (#139)
  • New rule mixed-content: a form on an HTTPS page submits to an http:// address (error);
    scripts, images, frames or stylesheets referenced over HTTP are info (#120)
  • New rule referrer-policy (info): the page sets unsafe-url or no-referrer-when-downgrade by
    header or meta tag and contacts other hosts, which then receive the full page address (#119)
  • New rule privacy-policy-content: the privacy policy gives no e-mail or postal address of the
    controller, or still contains template text such as [Firmenname] or "Musterstraße" (warning);
    a data protection officer named without contact details is info. On an overview page that links
    further privacy documents, a missing contact is info (#116)
  • legal-notice-content reads a page behind a vague legal link ("Rechtliche Hinweise") or the
    privacy policy when the start page links no legal notice, and reports what it misses there as
    info (#114)
  • Trackers from the vendors' own documentation: Google Ads conversions on www.google.com,
    Reddit Pixel, VWO (hosts and cookies), Microsoft Xandr universal pixel and the Amazon Associates
    oneTag (#71)
  • The Drupal banner EU Cookie Compliance is recognised by name, as seen on a Hungarian railway
    site that offers only "accept all"
  • --lang hu: findings, fixes and the text, Markdown and SARIF reports in Hungarian, with
    schema 1.5.0 for the new language value (#59)
  • New rule privacy-policy-vendors: trackers and cookie-setting embeds the start page uses that
    the privacy policy, or a cookie policy it links, doesn't name (warning); font services, CDNs and
    other listed services as info. Names match as whole words, with known other names (#105)
  • New rule legal-notice-content: the legal notice linked from the start page gives no postal
    address or e-mail address (warning), or names a registered legal form without a register entry
    (info). Postcodes of Germany, Austria, Switzerland and Hungary are recognised (#104). With
    --region hu a missing tax number of a company, with --region at a missing media disclosure
    (Offenlegung) is noted as info (#115)
  • New rule third-country-providers (info): error monitoring, performance monitoring, feature
    flag and backend services outside the EU/EEA contacted before consent, such as Sentry on
    ingest.us.sentry.io or a Supabase project. Region hosts in the EU are not reported (#109)
  • New rule reject-less-prominent (info): a first-layer reject control shown as plain text next
    to an accept button, with less than half its area, or with low text contrast, measured from the
    rendered box and computed styles (#107)
  • New rule consent-preselected (error, with the settings check): optional categories, or a wider
    consent level, already switched on when the banner settings open, named by their labels in
    consent.settings.preselected (#106)
  • New rule tracking-cookie-lifetime (info): tracking cookies that last longer than 13 months,
    the CNIL's recommended maximum, with their lifetime in days (#108)
  • Start-page checks on other hosts of the site: consent, reject, banner and HTTPS rules run on the
    first crawled page of each subdomain, up to five. Their consent results are in consentByHost.
    --host-checks main turns it off (#103)
  • Every report has ruleSummary: per rule, pages with a finding, checked without one, not
    evaluable and skipped by reason, plus the page IDs worth a look. --evaluations summary writes
    JSON without the per-page rule evaluations; the coverage gate reads the summary then and gives
    the same verdict (#101)
  • Adapter scans record how long the adapter took: capture.diagnostics.timing.adapter has the
    number of requests, the median and 95th percentile time to the response headers, and the five
    slowest requests split into queue, headers and body time. Text and Markdown reports print it on
    pages with timeouts, so a slow adapter environment stands out (#99)

Changed

  • Text and Markdown reports show an impressum-link or privacy-policy-link finding that repeats
    on several pages once, under "On several pages", with the pages listed. JSON and SARIF still
    have one finding per page. The messages no longer say "on this page" (#102)

Fixed

  • legal-notice-content only accepts an address when the street sits on the postcode's line or
    the line above it, so a stray number and a year in other paragraphs no longer pass (#142)
  • legal-notice-content and privacy-policy-vendors no longer say "checked, no finding" when
    they had nothing to read: on other pages they are skipped (not-start-page), without a link
    they are skipped (no-linked-page), and when the page didn't load they are not evaluable
    (linked-page-not-loaded). A finding about something missing from a page that didn't load
    completely is not evaluable either (#141). A start page without such a link does not count as incomplete for
    --fail-on-incomplete; impressum-link and privacy-policy-link report the missing link
  • A request that never finishes no longer makes every document rule not evaluable. When the page
    itself was read, a rule that finds what it looks for (the Impressum link, the privacy link)
    counts as checked; a finding about something missing stays not evaluable, since the missing
    part may not have loaded (#140)
  • Side loads of the legal notice and the privacy policy skip error pages (404, 500) and links that
    lead nowhere, such as a "Privacy settings" button with href="#" before the policy link
  • consent-preselected only counts switches the visitor can actually switch off, and keeps what
    it saw when a later step of the settings check fails
  • legal-notice-content recognises UK postcodes and Irish Eircodes, ignores floors written as
    "OG"/"UG", legal forms of the host or web designer, copyright years, phone numbers and
    "at office." when looking for address, e-mail and legal form
  • privacy-policy-vendors matches vendors named with a slash ("DoubleClick/Google Marketing")
    and "X" as Twitter
  • reject-less-prominent measures translucent buttons on dark banners and oklch() colours
  • tracking-cookie-lifetime measures 13 calendar months, so a cookie set for exactly 13 months
    is never reported
  • Hungarian report text uses the right article before abbreviations and numbers ("az SE", "az 5")
  • Grouped findings in text and Markdown reports keep different vendors with the same fix apart
  • privacy-policy-vendors drops to info when the privacy policy links a cookie policy it can't
    read, such as a PDF, and names that link
  • Text and Markdown reports also show a third-country-providers or third-party-cdns finding
    that repeats on several pages once per vendor
  • consent-preselected is evaluated whenever the settings layer opened, also when no save button
    was found; before, it was not evaluable there
  • A video, image or font over maxResponseBytes no longer makes an adapter scan page partial. It
    is delivered without its body, with status and headers kept, and noted as resource-limit with
    skippedReason: 'policy' (#100)