docs: SSH host verification is done at connect time#21173
Closed
docs: SSH host verification is done at connect time#21173
Conversation
There was a problem hiding this comment.
Pull request overview
This PR updates libcurl option documentation to clarify that SSH host verification happens when establishing a new connection, and that subsequent connection reuse may occur without re-running the originally configured verification method.
Changes:
- Document that
CURLOPT_SSH_KNOWNHOSTSverification is applied on new connections and that verified connections can later be reused. - Document similar “verify on connect, then reuse” behavior for
CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256andCURLOPT_SSH_HOST_PUBLIC_KEY_MD5. - Cross-reference the other SSH host verification options in each doc page to set expectations around connection reuse.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| docs/libcurl/opts/CURLOPT_SSH_KNOWNHOSTS.md | Adds a note describing verification at connect time and that the connection can later be reused. |
| docs/libcurl/opts/CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256.md | Adds a similar note for SHA256 host key verification and connection reuse behavior. |
| docs/libcurl/opts/CURLOPT_SSH_HOST_PUBLIC_KEY_MD5.md | Adds a similar note for MD5 host key verification and connection reuse behavior. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Connection reuse is done more "casually" once verified. Closes #21173
66d27a4 to
0405b2c
Compare
icing
approved these changes
Mar 31, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Connection reuse is done more "casually" once verified.