CryptographicEngine.DeriveKeyMaterial Método

Definición

Espacio de nombres:

Windows.Security.Cryptography.Core

Deriva una clave de otra clave mediante una función de derivación de claves. Para obtener más información, consulte las clases KeyDerivationAlgorithmProvider y KeyDerivationParameters .

public:
 static IBuffer ^ DeriveKeyMaterial(CryptographicKey ^ key, KeyDerivationParameters ^ parameters, unsigned int desiredKeySize);

 static IBuffer DeriveKeyMaterial(CryptographicKey const& key, KeyDerivationParameters const& parameters, uint32_t const& desiredKeySize);

public static IBuffer DeriveKeyMaterial(CryptographicKey key, KeyDerivationParameters parameters, uint desiredKeySize);

function deriveKeyMaterial(key, parameters, desiredKeySize)

Public Shared Function DeriveKeyMaterial (key As CryptographicKey, parameters As KeyDerivationParameters, desiredKeySize As UInteger) As IBuffer

Parámetros

key

CryptographicKey

Clave simétrica o secreta usada para la derivación.

parameters

KeyDerivationParameters

Parámetros de derivación. Los parámetros varían según el tipo de algoritmo KDF utilizado.

desiredKeySize

UInt32

unsigned int

uint32_t

Tamaño solicitado, en bytes, de la clave derivada.

Devoluciones

IBuffer

Búfer que contiene la clave derivada.

Ejemplos

public String SampleDeriveFromPbkdf(
    String strAlgName,
    UInt32 targetSize)
{
    // Open the specified algorithm.
    KeyDerivationAlgorithmProvider objKdfProv = KeyDerivationAlgorithmProvider.OpenAlgorithm(strAlgName);

    // Create a buffer that contains the secret used during derivation.
    String strSecret = "MyPassword";
    IBuffer buffSecret = CryptographicBuffer.ConvertStringToBinary(strSecret, BinaryStringEncoding.Utf8);

    // Create a random salt value.
    IBuffer buffSalt = CryptographicBuffer.GenerateRandom(32);

    // Specify the number of iterations to be used during derivation.
    UInt32 iterationCount = 10000;

    // Create the derivation parameters.
    KeyDerivationParameters pbkdf2Params = KeyDerivationParameters.BuildForPbkdf2(buffSalt, iterationCount);

    // Create a key from the secret value.
    CryptographicKey keyOriginal = objKdfProv.CreateKey(buffSecret);

    // Derive a key based on the original key and the derivation parameters.
    IBuffer keyDerived = CryptographicEngine.DeriveKeyMaterial(
        keyOriginal,
        pbkdf2Params,
        targetSize);

    // Encode the key to a hexadecimal value (for display)
    String strKeyHex = CryptographicBuffer.EncodeToHexString(keyDerived);

    // Return the encoded string
    return strKeyHex;
}

Comentarios

La derivación de claves requiere que use las clases KeyDerivationAlgorithmProvider y KeyDerivationParameters . Se pueden usar las siguientes funciones de derivación de claves:

• BuildForPbkdf2
• BuildForSP800108
• BuildForSP80056a

Para obtener un ejemplo completo que contiene el siguiente ejemplo de código, vea la clase KeyDerivationAlgorithmProvider .

Consulte también

• KeyDerivationAlgorithmProvider
• KeyDerivationParameters