Partager via

KeyDerivationParameters.BuildForSP800108(IBuffer, IBuffer) Méthode

  • Référence

Définition

Espace de noms:
Windows.Security.Cryptography.Core
Modifier

Crée un objet KeyDerivationParameters pour une utilisation en mode compteur, fonction de dérivation de clé HMAC (Hash-based message authentication code).

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

Paramètres

label
IBuffer

Mémoire tampon qui spécifie l’objectif du matériau de keying dérivé.

context
IBuffer

Mémoire tampon qui spécifie les informations relatives au matériau de clé dérivé. Par exemple, le contexte peut identifier les parties qui dérivent le matériel de clé et, éventuellement, un nonce connu par les parties.

Retours

KeyDerivationParameters

Fait référence aux paramètres utilisés lors de la dérivation de clé.

Exemples

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);
}

Remarques

Vous pouvez utiliser les noms d’algorithmes suivants avec la fonction OpenAlgorithm pour ouvrir un fournisseur d’algorithme KDF SP800108 :

S’applique à