KeyDerivationParameters.BuildForPbkdf2(IBuffer, UInt32) Méthode

Définition

Espace de noms:

Windows.Security.Cryptography.Core

Crée un objet KeyDerivationParameters à utiliser dans la fonction de dérivation de clé basée sur un mot de passe 2 (PBKDF2).

public:
 static KeyDerivationParameters ^ BuildForPbkdf2(IBuffer ^ pbkdf2Salt, unsigned int iterationCount);

 static KeyDerivationParameters BuildForPbkdf2(IBuffer const& pbkdf2Salt, uint32_t const& iterationCount);

public static KeyDerivationParameters BuildForPbkdf2(IBuffer pbkdf2Salt, uint iterationCount);

function buildForPbkdf2(pbkdf2Salt, iterationCount)

Public Shared Function BuildForPbkdf2 (pbkdf2Salt As IBuffer, iterationCount As UInteger) As KeyDerivationParameters

Paramètres

pbkdf2Salt

IBuffer

Salt, une valeur aléatoire ou pseudorandom à combiner avec le mot de passe en plusieurs itérations. Un sel est utilisé pour augmenter l’entropie au-dessus de ce qui peut être obtenu à l’aide d’un mot de passe seul.

iterationCount

UInt32

unsigned int

uint32_t

Nombre d’itérations à utiliser pour dériver une clé.

Retours

KeyDerivationParameters

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

Exemples

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

Remarques

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

• KeyDerivationAlgorithmNames.Pbkdf2Md5
• KeyDerivationAlgorithmNames.Pbkdf2Sha1
• KeyDerivationAlgorithmNames.Pbkdf2Sha256
• KeyDerivationAlgorithmNames.Pbkdf2Sha384
• KeyDerivationAlgorithmNames.Pbkdf2Sha512