Skip to content

docs(security): the Iceberg sink catalogAuth checks and the Debezium Server's dotenv names - #199

Merged
fas89 merged 1 commit into
mainfrom
docs/sink-catalogauth-hardening
Nov 5, 2026
Merged

fas89 merged 1 commit into
mainfrom
docs/sink-catalogauth-hardening

Conversation

@fas89

@fas89 fas89 commented Nov 5, 2026

Copy link
Copy Markdown
Collaborator

Documents three forge-cli security fixes that are on main, not yet in a release. Each changed sentence carries the house marker *On forge-cli main, not yet in a release ([forge-cli #N](…)).*.

  • forge-cli #828, docs/advanced/source-aligned-acquisition.md and docs/advanced/network-safety.md. The Iceberg sink's catalogAuth host check now refuses the cloud metadata addresses even when listed, like the orchestrator guard, the OpenLineage emitter and the managed Flink host check. The sentence saying it "refuses link-local and unspecified addresses only" is updated. The 169.254.169.254 refusal example is the text the CLI now prints.
  • forge-cli #830, docs/advanced/source-aligned-acquisition.md. A new "Override text" rule. With catalogAuth, a catalog URL that holds ${, starts with env: or holds a control character is refused wherever it is set, and so is such text in the override values Iceberg reads. Kafka-side keys keep their config providers.
  • forge-cli #833, docs/advanced/project-dotenv-trust.md. A project dotenv file can no longer set the embedded Debezium Server's configuration (DEBEZIUM_*, QUARKUS_*, SMALLRYE_*, MP_CONFIG_*, profile forms included), its JVM options and binary (JDK_JAVA_OPTIONS, JAVA_OPTS, JAVA_HOME), or its launcher's settings.

Checks

  • Against data-product-forge==0.27.0 from PyPI (Python 3.11), all exit 0:
    • check_cli_docs.py
    • check_providers.py
    • check_cli_docs.py --markers-only
    • gen_contract_reference.py --check
  • npm ci && npm run docs:build && node scripts/check-dist-links.mjs: exit 0.
  • The wording follows each forge-cli PR's CHANGELOG entry. The 169.254.169.254 example output was captured from forge-cli main after #828.

…Server's dotenv names

Three forge-cli fixes on main, not yet in a release:
- forge-cli #828: the sink's catalogAuth host check refuses the cloud
  metadata addresses, as the other internal-endpoint checks do;
- forge-cli #830: with catalogAuth, text the sink expands later (${, a
  leading env:, a control character) is refused in a catalog URL and in
  the override values Iceberg reads;
- forge-cli #833: a project dotenv file cannot set the embedded Debezium
  Server's configuration, its JVM options or its launcher's settings.
@fas89
fas89 merged commit e027462 into main Nov 5, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant