// 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";
}
}
}