Skip to content

Document RECOGNIZER_REGISTRY_CONF_FILE override for the analyzer server - #2311

Merged
omri374 merged 1 commit into
data-privacy-stack:mainfrom
nikolas-sapa:docs/recognizer-registry-conf-file
Sep 29, 2026
Merged

omri374 merged 1 commit into
data-privacy-stack:mainfrom
nikolas-sapa:docs/recognizer-registry-conf-file

Conversation

@nikolas-sapa

Copy link
Copy Markdown
Contributor

Documents the RECOGNIZER_REGISTRY_CONF_FILE override offered in #2256 (part 2), where the reporter showed that ItFiscalCodeRecognizer — registered with supported_languages: [it] — is unreachable from the default analyzer image, which loads only the en NLP model.

Adds a section to docs/analyzer/recognizer_registry_provider.md covering:

  • how the server selects the registry file via RECOGNIZER_REGISTRY_CONF_FILE (plus a mention of the sibling ANALYZER_CONF_FILE / NLP_CONF_FILE), previously undocumented anywhere in docs/
  • a worked example enabling ItFiscalCodeRecognizer for en with a mounted registry file — the exact one-line override the reporter validated end-to-end through LLM gateways
  • a cross-link to Filtering recognizers by country for the general supported_countries filter

Docs-only change; no code touched. Related: #2259 covers part 1 of the same issue.

@GiorgioDotcom

Copy link
Copy Markdown

Confirming the example against what I measured for #2256: this is the exact override I ran, a full copy of default_recognizers.yaml with supported_languages changed to [en] on ItFiscalCodeRecognizer and country_code: it left as is, mounted via RECOGNIZER_REGISTRY_CONF_FILE. With it, IT_FISCAL_CODE is detected for language: en, including omocodia variants, and the same request without the override returns nothing.

The note about supported_languages having to match the analyzer configuration is worth keeping: when I set the registry-level supported_languages to [en, it] while the analyzer config still listed only en, the server exited at startup with "Misconfigured engine, supported languages have to be consistent" (exit code 3). The three variants I tried, with the outcome of each, are here: https://github.com/GiorgioDotcom/llm-gateway-privacy-bench/tree/master/presidio-cf/verifica-pr2271

Thanks for picking this up.

@omri374
omri374 merged commit d4ccc6b into data-privacy-stack:main Sep 29, 2026
39 checks passed
SharonHart added a commit that referenced this pull request Oct 25, 2026
Move the analyzer-specific docs entries (#2311, #2255) from General to
Analyzer, split the cross-package lockfile security update (#2304) into one
entry per affected component, move BatchDeanonymizeEngine to Anonymizer in
2.2.364, and use the same section order (General, Analyzer, Anonymizer,
Image Redactor, Presidio-Structured) in 2.2.364 as in 2.2.365/2.2.363.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: c0bbebdb-b405-4d2a-bd7b-42124649670a
@SharonHart SharonHart mentioned this pull request Oct 25, 2026
4 of 6 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants