KeyDerivationParameters.BuildForPbkdf2(IBuffer, UInt32) Méthode

Référence

Définition

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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 :

S’applique à

Partager via