File: System\IdentityModel\Protocols\WSTrust\Entropy.cs
Project: ndp\cdf\src\WCF\IdentityModel\System.IdentityModel.csproj (System.IdentityModel)
//-----------------------------------------------------------------------
// <copyright file="Entropy.cs" company="Microsoft">
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// </copyright>
//-----------------------------------------------------------------------
 
namespace System.IdentityModel.Protocols.WSTrust
{
    using System.IdentityModel.Tokens;
 
    /// <summary>
    /// The Entropy used in both token request message and token response message. 
    /// </summary>
    public class Entropy : ProtectedKey
    {
        /// <summary>
        /// Use this constructor to create an Entropy object with some randomly generated bytes.
        /// </summary>
        /// <param name="entropySizeInBits">The entropySizeInBits of the key material inside the entropy.</param>
        public Entropy( int entropySizeInBits )
            : this( CryptoHelper.GenerateRandomBytes( entropySizeInBits ) )
        {
        }
 
        /// <summary>
        /// Constructor for sending entropy in binary secret format.
        /// </summary>
        /// <param name="secret">The key material.</param>
        public Entropy( byte[] secret )
            : base( secret )
        {
        }
 
        /// <summary>
        /// Constructor for sending entropy in encrypted key format.
        /// </summary>
        /// <param name="secret">The key material.</param>
        /// <param name="wrappingCredentials">The encrypting credentials used to encrypt the key material.</param>
        public Entropy( byte[] secret, EncryptingCredentials wrappingCredentials )
            : base( secret, wrappingCredentials )
        {
        }
 
        /// <summary>
        /// Constructs an entropy instance with the protected key.
        /// </summary>
        /// <param name="protectedKey">The protected key which can be either binary secret or encrypted key.</param>
        public Entropy( ProtectedKey protectedKey )
            : base( GetKeyBytesFromProtectedKey( protectedKey ), GetWrappingCredentialsFromProtectedKey( protectedKey ) )
        {
        }
 
        static byte[] GetKeyBytesFromProtectedKey( ProtectedKey protectedKey )
        {
            if ( protectedKey == null )
            {
                throw DiagnosticUtility.ExceptionUtility.ThrowHelperArgumentNull( "protectedKey" );
            }
 
            return protectedKey.GetKeyBytes();
        }
 
        static EncryptingCredentials GetWrappingCredentialsFromProtectedKey( ProtectedKey protectedKey )
        {
            if ( protectedKey == null )
            {
                throw DiagnosticUtility.ExceptionUtility.ThrowHelperArgumentNull( "protectedKey" );
            }
 
            return protectedKey.WrappingCredentials;
        }
    }
}