Skip to content

Clarify that server-ca is optional for mTLS ingest - #61

Open
JannikBrand wants to merge 1 commit into
SAP-docs:mainfrom
JannikBrand:server-ca-fix
Open

JannikBrand wants to merge 1 commit into
SAP-docs:mainfrom
JannikBrand:server-ca-fix

Conversation

@JannikBrand

@JannikBrand JannikBrand commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

What

Clarify that the server-ca value returned in service bindings is optional for mTLS ingest into SAP Cloud Logging.

The ingest endpoints (ingest-mtls, ingest-otlp) present a server certificate that chains to a public root (Let's Encrypt ISRG Root X1). Any runtime whose system trust store already carries the public roots — which is the default for CF stacks, SapMachine, current Node.js versions — needs no additional pinning. Instructing consumers to pin server-ca as a sole trust anchor was misleading and became actively wrong when the ingestion CA was rotated (a customer whose app pinned the previous intermediate saw ingest break).

Changes

  • Ingest from the Cloud Foundry Runtime — remove server-ca from the user-provided-service (cf cups) example and its jq extractor. Loggregator's HTTPS writer adds a UPS-supplied ca additively to the platform's trust pool; it is not required when the endpoint chains to a public root.
  • Ingest via the JSON API Endpoint — drop --cacert server-ca.crt from the curl example (call it out as optional in a note).
  • Ingest via the OpenTelemetry API Endpoint — annotate server-ca in the sample credentials JSON as optional and add a clarifying note. Also relaxed the wording "the required endpoint and credentials" → "the endpoint and credentials".

Context

Signed-off-by: Jannik Brand <jannik.brand@sap.com>
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