66 lines
2.3 KiB
C#
66 lines
2.3 KiB
C#
namespace ZB.MOM.WW.OtOpcUa.Client.Shared.Models;
|
|
|
|
/// <summary>
|
|
/// Settings for establishing an OPC UA client connection.
|
|
/// </summary>
|
|
public sealed class ConnectionSettings
|
|
{
|
|
/// <summary>
|
|
/// The primary OPC UA endpoint URL.
|
|
/// </summary>
|
|
public string EndpointUrl { get; set; } = string.Empty;
|
|
|
|
/// <summary>
|
|
/// Optional failover endpoint URLs for redundancy.
|
|
/// </summary>
|
|
public string[]? FailoverUrls { get; set; }
|
|
|
|
/// <summary>
|
|
/// Optional username for authentication.
|
|
/// </summary>
|
|
public string? Username { get; set; }
|
|
|
|
/// <summary>
|
|
/// Optional password for authentication.
|
|
/// </summary>
|
|
public string? Password { get; set; }
|
|
|
|
/// <summary>
|
|
/// Transport security mode. Defaults to <see cref="Models.SecurityMode.None" />.
|
|
/// </summary>
|
|
public SecurityMode SecurityMode { get; set; } = SecurityMode.None;
|
|
|
|
/// <summary>
|
|
/// Session timeout in seconds. Defaults to 60.
|
|
/// </summary>
|
|
public int SessionTimeoutSeconds { get; set; } = 60;
|
|
|
|
/// <summary>
|
|
/// Whether to automatically accept untrusted server certificates. Defaults to true.
|
|
/// </summary>
|
|
public bool AutoAcceptCertificates { get; set; } = true;
|
|
|
|
/// <summary>
|
|
/// Path to the certificate store. Defaults to a subdirectory under LocalApplicationData
|
|
/// resolved via <see cref="ClientStoragePaths"/> so the one-shot legacy-folder migration
|
|
/// runs before the path is returned.
|
|
/// </summary>
|
|
public string CertificateStorePath { get; set; } = ClientStoragePaths.GetPkiPath();
|
|
|
|
/// <summary>
|
|
/// Validates the settings and throws if any required values are missing or invalid.
|
|
/// </summary>
|
|
/// <exception cref="ArgumentException">Thrown when settings are invalid.</exception>
|
|
public void Validate()
|
|
{
|
|
if (string.IsNullOrWhiteSpace(EndpointUrl))
|
|
throw new ArgumentException("EndpointUrl must not be null or empty.", nameof(EndpointUrl));
|
|
|
|
if (SessionTimeoutSeconds <= 0)
|
|
throw new ArgumentException("SessionTimeoutSeconds must be greater than zero.",
|
|
nameof(SessionTimeoutSeconds));
|
|
|
|
if (SessionTimeoutSeconds > 3600)
|
|
throw new ArgumentException("SessionTimeoutSeconds must not exceed 3600.", nameof(SessionTimeoutSeconds));
|
|
}
|
|
} |