Joseph Doherty
9cff87fe85
Remove project bookkeeping citations from shipped code comments across the solution: hyphenated task IDs (WP-14, StoreAndForward-025), milestone/task/ issue refs (M3, Task 4, Audit Log #23, #21), Bundle X task-bundle labels, and C/D/K/S/T phase labels. Comment text only — no code logic, string/log literals, or XML-doc structure changed. Genuine descriptions are preserved (only the citation is stripped), and technical lookalikes are retained (UTF-8, SHA-256, T00:00:00, M365, UTC-5, pre-C4/pre-C5 schema versions). Flagged by the new CommentChecker TaskReferenceInComment / TrackingReferenceInComment checks plus targeted grep passes; full solution builds clean, append-only guard tests pass.
52 lines
2.0 KiB
C#
52 lines
2.0 KiB
C#
namespace ZB.MOM.WW.ScadaBridge.NotificationService;
|
|
|
|
/// <summary>
|
|
/// The three TLS modes the design doc defines for SMTP connections.
|
|
/// A single boolean cannot represent the requirement, so the configured
|
|
/// <c>SmtpConfiguration.TlsMode</c> string is parsed into this three-state enum.
|
|
/// </summary>
|
|
public enum SmtpTlsMode
|
|
{
|
|
/// <summary>No transport security — plain SMTP. Maps to <c>SecureSocketOptions.None</c>.</summary>
|
|
None,
|
|
|
|
/// <summary>Opportunistic STARTTLS upgrade (typically port 587). Maps to <c>SecureSocketOptions.StartTls</c>.</summary>
|
|
StartTls,
|
|
|
|
/// <summary>Implicit TLS / SSL-on-connect (typically port 465). Maps to <c>SecureSocketOptions.SslOnConnect</c>.</summary>
|
|
Ssl,
|
|
}
|
|
|
|
/// <summary>
|
|
/// Parses the free-text <c>SmtpConfiguration.TlsMode</c> value into a
|
|
/// <see cref="SmtpTlsMode"/>, rejecting unknown values rather than silently
|
|
/// falling back to opportunistic negotiation.
|
|
/// </summary>
|
|
public static class SmtpTlsModeParser
|
|
{
|
|
/// <summary>
|
|
/// Parses a configured TLS mode string. A null or empty value defaults to
|
|
/// <see cref="SmtpTlsMode.StartTls"/> (the design-doc default for port 587).
|
|
/// </summary>
|
|
/// <param name="tlsMode">The TLS mode string to parse (None, StartTLS, or SSL); null/empty defaults to StartTLS.</param>
|
|
/// <exception cref="ArgumentException">The value is not one of None/StartTLS/SSL.</exception>
|
|
/// <returns>The corresponding <see cref="SmtpTlsMode"/> enum value.</returns>
|
|
public static SmtpTlsMode Parse(string? tlsMode)
|
|
{
|
|
if (string.IsNullOrWhiteSpace(tlsMode))
|
|
{
|
|
return SmtpTlsMode.StartTls;
|
|
}
|
|
|
|
return tlsMode.Trim().ToLowerInvariant() switch
|
|
{
|
|
"none" => SmtpTlsMode.None,
|
|
"starttls" => SmtpTlsMode.StartTls,
|
|
"ssl" => SmtpTlsMode.Ssl,
|
|
_ => throw new ArgumentException(
|
|
$"Unknown SMTP TLS mode '{tlsMode}'. Expected one of: None, StartTLS, SSL.",
|
|
nameof(tlsMode)),
|
|
};
|
|
}
|
|
}
|