// Default privacy provider (empty class). // Copyright (C) 2008-2010 Malcolm Crowe, Lex Li, and other contributors. // // Permission is hereby granted, free of charge, to any person obtaining a copy of this // software and associated documentation files (the "Software"), to deal in the Software // without restriction, including without limitation the rights to use, copy, modify, merge, // publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons // to whom the Software is furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in all copies or // substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, // INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE // FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR // OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. using System; using System.Collections.Generic; namespace GSF.Net.Snmp.Security { /// /// Default privacy provider. /// public sealed class DefaultPrivacyProvider : IPrivacyProvider { private static IPrivacyProvider _defaultInstance; /// /// Default privacy provider with default authentication provider. /// public static IPrivacyProvider DefaultPair { get { return _defaultInstance ?? (_defaultInstance = new DefaultPrivacyProvider(DefaultAuthenticationProvider.Instance)); } } /// /// Initializes a new instance of the class. /// /// Authentication provider. public DefaultPrivacyProvider(IAuthenticationProvider authentication) { AuthenticationProvider = authentication; } #region IPrivacyProvider Members /// /// Corresponding . /// public IAuthenticationProvider AuthenticationProvider { get; private set; } [Obsolete("Use EngineIds instead.")] public OctetString EngineId { get; set; } /// /// Engine IDs. /// /// This is an optional field, and only used by TRAP v2 authentication. public ICollection EngineIds { get; set; } /// /// Decrypts the specified data. /// /// The data. /// The parameters. /// public ISnmpData Decrypt(ISnmpData data, SecurityParameters parameters) { if (data == null) { throw new ArgumentNullException(nameof(data)); } if (parameters == null) { throw new ArgumentNullException(nameof(parameters)); } if (data.TypeCode != SnmpType.Sequence) { DecryptionException newException = new DecryptionException("Default decryption failed"); throw newException; } return data; } /// /// Encrypts the specified scope. /// /// The scope data. /// The parameters. /// public ISnmpData Encrypt(ISnmpData data, SecurityParameters parameters) { if (data == null) { throw new ArgumentNullException(nameof(data)); } if (parameters == null) { throw new ArgumentNullException(nameof(parameters)); } if (data.TypeCode == SnmpType.Sequence || data is ISnmpPdu) { return data; } throw new ArgumentException("Invaild data type.", nameof(data)); } /// /// Gets the salt. /// /// The salt. public OctetString Salt { get { return OctetString.Empty; } } /// /// Passwords to key. /// /// The secret. /// The engine identifier. /// public byte[] PasswordToKey(byte[] secret, byte[] engineId) { return AuthenticationProvider.PasswordToKey(secret, engineId); } #endregion /// /// Returns a that represents this instance. /// /// /// A that represents this instance. /// public override string ToString() { return "Default privacy provider"; } } }