Skip to content

Enforce HTTPS: add SLES/openSUSE certificate trust instructions (#28292) - #37675

Merged
tdykstra merged 1 commit into
dotnet:mainfrom
baylavdev:docs/enforcing-ssl-sles
Sep 21, 2026
Merged

tdykstra merged 1 commit into
dotnet:mainfrom
baylavdev:docs/enforcing-ssl-sles

Conversation

@baylavdev

@baylavdev baylavdev commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

What

Replaces the "see issue #28292" placeholder and the commented-out RHEL copy in aspnetcore/security/enforcing-ssl.md with a real Trust the certificate on SUSE Linux Enterprise Server (SLES) and openSUSE section:

  • dependency install with the SUSE package name (mozilla-nss-tools provides certutil)
  • export the development certificate
  • trust in Chromium-based browsers and in Firefox (certutil)
  • trust in curl/OpenSSL clients (--cacert, or SSL_CERT_DIR via the existing OpenSSL trust section)
  • cleanup
  • a note explaining why adding the certificate to /etc/pki/trust/anchors/ + update-ca-certificates does not work (the dev cert is CA:FALSE; p11-kit lists it as an anchor but omits it from the bundles, so OpenSSL keeps rejecting it)

Fixes #28292. Contributes to #27603 (SLES coverage; the RHEL/tabs restructuring in that issue is out of scope here).

Why

The page has pointed SLES users at a GitHub issue since 2023, and the commented-out block was a straight copy of the RHEL steps with dnf, which doesn't apply. Two earlier volunteers dropped the item for lack of a SLES environment to verify on.

How

  • Every command was run on registry.suse.com/bci/dotnet-sdk:8.0 (SLES 15 SP7) and registry.opensuse.org/opensuse/leap:15.6, including the negative result for the system trust store.
  • Heading promoted from #### (nested under the linux-dev-certs subsection by accident) to ###, a sibling of the other Linux subsections.
  • Kept the placeholder-variable style used elsewhere in the article (${CertificateDirectory}, ${UserProfile}) and the [!WARNING]/[!NOTE] alert syntax.
  • ms.date updated.

Checklist

  • Steps verified on SLES 15 SP7 and openSUSE Leap 15.6
  • Links resolve (#openssl-trust is an existing heading in the article)
  • No changes outside the SLES section and ms.date
  • Follows existing article conventions (alerts, placeholders, heading levels)

Internal previews

File Preview link
aspnetcore/security/enforcing-ssl.md Learn preview

Build report

Replaces the SLES placeholder (and the commented-out RHEL copy) with steps
verified on SLES 15 SP7 and openSUSE Leap 15.6: zypper package names,
certutil for Chromium/Firefox, curl --cacert, cleanup, and a note on why
the system trust store does not accept the CA:FALSE dev certificate.

Fixes dotnet#28292
Contributes to dotnet#27603
@baylavdev

Copy link
Copy Markdown
Contributor Author

@dotnet-policy-service agree

@baylavdev baylavdev changed the title Enforce HTTPS: add SLES/openSUEnforce HTTPS: add SLES/openSUSE certificate trust instructions (#28292)SE certificate trust instructions Enforce HTTPS: add SLES/openSUSE certificate trust instructions (#28292) Sep 17, 2026
@guardrex
guardrex requested a review from tdykstra September 17, 2026 14:16
@tdykstra
tdykstra requested a lite review from Copilot September 21, 2026 21:36

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Address the certificate directory rehashing, NSS database initialization, Firefox trust flag, and stale ms.date issues.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 1 Medium severity · 1 Low severity

Open (2)
What changed in this PR

Adds SLES/openSUSE certificate trust instructions to the HTTPS documentation.

Changes:

  • Documents SUSE dependencies, certificate export, browser, Firefox, and OpenSSL trust setup.
  • Adds cleanup steps and explains the system trust-store limitation.
  • Updates metadata.
File Description
aspnetcore/​security/​enforcing-ssl.md Adds SLES/openSUSE certificate trust guidance.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

```

### Cleaning up the Development Certificates
Alternatively, point `SSL_CERT_DIR` at a directory that contains the certificate as described in [OpenSSL trust](#openssl-trust).
monikerRange: '>= aspnetcore-3.0'
ms.custom: linux-related-content
ms.date: 07/29/2026
ms.date: 09/17/2026
@tdykstra
tdykstra merged commit 1db7d76 into dotnet:main Sep 21, 2026
5 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.

Trust HTTPS certificate on SLES

3 participants