Skip to content

MSSQL: encrypt-in-transit default for msodbcsql18 compatibility#4

Merged
Hanan-Akeyless merged 1 commit into
masterfrom
ASM-18581-mssql18-encrypt-default
Jul 2, 2026
Merged

MSSQL: encrypt-in-transit default for msodbcsql18 compatibility#4
Hanan-Akeyless merged 1 commit into
masterfrom
ASM-18581-mssql18-encrypt-default

Conversation

@Hanan-Akeyless

@Hanan-Akeyless Hanan-Akeyless commented Jul 2, 2026

Copy link
Copy Markdown
Collaborator

Summary

Part of the SRA ARM64 effort (ASM-18581). The zero-trust-bastion Adminer stack must move msodbcsql17msodbcsql18 because v17 has no arm64 packages. msodbcsql18 changes the default for an unset Encrypt from no (plaintext) to yes with mandatory server-certificate validation — which would break every MSSQL connection on the default (no-SSL) path to a server without a CA-trusted cert.

This sets the MSSQL connection in the akeyless login plugin to always encrypt in transit, and to validate the server cert only when the user opts into SSL mode:

Path Before (msodbcsql17, unset) After (msodbcsql18)
Default (no SSL selected) plaintext Encrypt=true, TrustServerCertificate=true — encrypted, no cert validation
SSL mode selected Encrypt=true, TrustServerCertificate=false unchanged (strict)

Net effect: existing connections stay reachable (no cert-validation break) and get upgraded from plaintext to encrypted — a security gain, not just a compatibility patch. Approach chosen with the SRA lead over the alternatives (exact-v17 plaintext preserve vs. v18 strict-by-default).

Delivery

plugins/login-akeyless-ssl.php ships standalone (not compiled into adminer-5.4.2.php), so this is the only file that changes. Once merged, this needs a new tag (e.g. v5.4.2.2); zero-trust-bastion then bumps its pinned adminer URLs to that tag alongside the msodbcsql18 Dockerfile change.

Verification

  • php -l clean
  • End-to-end via zero-trust-bastion image (msodbcsql18): Adminer MSSQL login to a server with and without a trusted cert, default and SSL-mode paths, on amd64 and arm64 — covered in the companion ZTB PR

🤖 Generated with Claude Code

The SRA bastion is moving its Adminer stack from msodbcsql17 to msodbcsql18
(required for arm64 — v17 has no arm64 packages). msodbcsql18 flips the default
for an unset Encrypt from "no" (plaintext) to "yes" with mandatory server-cert
validation, which would break every MSSQL connection on the default no-SSL path
to a server without a CA-trusted certificate.

Set the MSSQL connection to always encrypt in transit, and validate the server
certificate only when the user opts into SSL mode. On the default path this keeps
existing connections reachable (TrustServerCertificate=true skips validation)
while still upgrading them from plaintext to encrypted — a net security gain over
the previous msodbcsql17 behavior. The explicit SSL opt-in remains strict
(TrustServerCertificate=false).

Consumed by zero-trust-bastion via the pinned adminer tag; requires a new tag
and a matching Dockerfile bump there.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 2, 2026

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 8b9583da-d583-4f4f-9e81-53f53e278cac

📥 Commits

Reviewing files that changed from the base of the PR and between eb3de30 and 3b2e82e.

📒 Files selected for processing (1)
  • plugins/login-akeyless-ssl.php
👮 Files not reviewed due to content moderation or server errors (1)
  • plugins/login-akeyless-ssl.php

📝 Walkthrough

[!WARNING]

Walkthrough skipped

File diffs could not be summarized.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch ASM-18581-mssql18-encrypt-default

Comment @coderabbitai help to get the list of available commands.

@Hanan-Akeyless Hanan-Akeyless merged commit cec1b54 into master Jul 2, 2026
1 of 2 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