KeyDerivationParameters.BuildForSP800108(IBuffer, IBuffer) Método

Definição

Namespace:

Windows.Security.Cryptography.Core

Cria um objeto KeyDerivationParameters para uso em um modo de contador, função de derivação de chave HMAC (código de autenticação de mensagem baseado em hash).

public:
 static KeyDerivationParameters ^ BuildForSP800108(IBuffer ^ label, IBuffer ^ context);

 static KeyDerivationParameters BuildForSP800108(IBuffer const& label, IBuffer const& context);

public static KeyDerivationParameters BuildForSP800108(IBuffer label, IBuffer context);

function buildForSP800108(label, context)

Public Shared Function BuildForSP800108 (label As IBuffer, context As IBuffer) As KeyDerivationParameters

Parâmetros

label

IBuffer

Buffer que especifica a finalidade do material de chave derivada.

context

IBuffer

Buffer que especifica informações relacionadas ao material de chave derivada. Por exemplo, o contexto pode identificar as partes que estão derivando o material de chave e, opcionalmente, um nonce conhecido pelas partes.

Retornos

KeyDerivationParameters

Refere-se aos parâmetros usados durante a derivação de chave.

Exemplos

public void SampleDeriveFromSP800108()
{
    // Create a string that contains the algorithm name.
    String strAlgName = KeyDerivationAlgorithmNames.Sp800108CtrHmacSha256;

    // Open the specified algorithm.
    KeyDerivationAlgorithmProvider objKdfProv = KeyDerivationAlgorithmProvider.OpenAlgorithm(strAlgName);

    // Specify the requested size, in bytes, of the derived key. 
    UInt32 targetSize = 32;

    // Create a buffer that contains the label value.
    String strPurpose = "Purpose";
    IBuffer buffLabel = CryptographicBuffer.ConvertStringToBinary(strPurpose, BinaryStringEncoding.Utf8);

    // Create a buffer that contains the context value.
    byte[] Nonce = { 1, 1, 0, 0, 0, 0, 0, 0};
    IBuffer buffContext = CryptographicBuffer.CreateFromByteArray(Nonce);

    // Create the derivation parameters.
    KeyDerivationParameters kdf800108Params = KeyDerivationParameters.BuildForSP800108(buffLabel, buffContext);

    // Create a secret value.
    IBuffer buffSecret = CryptographicBuffer.GenerateRandom(32);

    // 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,
        kdf800108Params,
        targetSize);

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

Comentários

Você pode usar os seguintes nomes de algoritmo com a função OpenAlgorithm para abrir um provedor de algoritmoSP800108 KDF:

• KeyDerivationAlgorithmNames.Sp800108CtrHmacMd5
• KeyDerivationAlgorithmNames.Sp800108CtrHmacSha1
• KeyDerivationAlgorithmNames.Sp800108CtrHmacSha256
• KeyDerivationAlgorithmNames.Sp800108CtrHmacSha384
• KeyDerivationAlgorithmNames.Sp800108CtrHmacSha512