Further improvements for SSL/TLS authenticate

[josesimoes]

Description

• Now surfacing detailed exceptions and error codes from secure connect/accept.
• Add new SslError codes.

Motivation and Context

• Continuation of Improve return result from SSL/TLS authenticate APIs #407.
• Backed by Improve error handling in SecureAccept and SsecureConnect nf-interpreter#3468

How Has This Been Tested?

Screenshots

Types of changes

• Improvement (non-breaking change that improves a feature, code or algorithm)
• Bug fix (non-breaking change which fixes an issue with code or algorithm)
• New feature (non-breaking change which adds functionality to code)
• Breaking change (fix or feature that would cause existing functionality to change)
• Config and build (change in the configuration and build system, has no impact on code or features)
• Dependencies (update dependencies and changes associated, has no impact on code or features)
• Unit Tests (add new Unit Test(s) or improved existing one(s), has no impact on code or features)
• Documentation (changes or updates in the documentation, has no impact on code or features)

Checklist:

• My code follows the code style of this project (only if there are changes in source code).
• My changes require an update to the documentation (there are changes that require the docs website to be updated).
• I have updated the documentation accordingly (the changes require an update on the docs in this repo).
• I have read the CONTRIBUTING document.
• I have tested everything locally and all new and existing tests passed (only if there are changes in source code).
• I have added new tests to cover my changes.

[coderabbitai]

📝 Walkthrough

Walkthrough

SSL XML documentation now maps authentication failures to SslError values through CryptographicException.ErrorCode, distinguishes certificate and handshake codes, and updates all client/server authentication overloads without changing runtime behavior.

Changes

SSL authentication error documentation

Layer / File(s)	Summary
SslError exception and error-code contract nanoFramework.System.Net/Security/SslError.cs	Documents exception types for handshake-related enum values and explains certificate verification bitmasks versus raw mbedTLS error codes.
Authentication overload documentation nanoFramework.System.Net/Security/SslStream.cs	Updates all client and server authentication overloads to document CryptographicException.ErrorCode mappings, InvalidOperationException cases, and removal of prior handshake SocketException documentation.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title is concise, within length limits, and accurately reflects the SSL/TLS authentication improvements.
Description check	✅ Passed	The description is clearly related to the changes by mentioning detailed exceptions and new SslError codes.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[josesimoes]

@coderabbitai review

[coderabbitai]

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[josesimoes]

@coderabbitai review

[coderabbitai]

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.