ASP.NET Core 中的哈希密码

项目
11/06/2024

本文介绍如何调用 KeyDerivation.Pbkdf2 方法来支持使用 PBKDF2 算法对密码进行哈希处理。

警告

KeyDerivation.Pbkdf2 API 是一个低级别的加密基元，旨在用于将应用集成到现有协议或加密系统中。 KeyDerivation.Pbkdf2 不应用于支持基于密码的登录，并且需要在数据存储中存储哈希密码的新应用。新应用应使用 PasswordHasher。有关 PasswordHasher 的详细信息，请参阅浏览 ASP.NET Core Identity PasswordHasher。

数据保护代码库包含一个 Nuget 包 Microsoft.AspNetCore.Cryptography.KeyDerivation，其中包含加密密钥派生功能。该包是一个独立的组件，不依赖于数据保护系统的其余部分。该包可独立使用。为了方便起见，源与数据保护代码库并存。

警告

以下代码演示如何使用 KeyDerivation.Pbkdf2 生成共享密钥。它不应用于对密码进行哈希处理以存储在数据存储中。

using Microsoft.AspNetCore.Cryptography.KeyDerivation;
using System.Security.Cryptography;

Console.Write("Enter a password: ");
string? password = Console.ReadLine();

// Generate a 128-bit salt using a sequence of
// cryptographically strong random bytes.
byte[] salt = RandomNumberGenerator.GetBytes(128 / 8); // divide by 8 to convert bits to bytes
Console.WriteLine($"Salt: {Convert.ToBase64String(salt)}");

// derive a 256-bit subkey (use HMACSHA256 with 100,000 iterations)
string hashed = Convert.ToBase64String(KeyDerivation.Pbkdf2(
    password: password!,
    salt: salt,
    prf: KeyDerivationPrf.HMACSHA256,
    iterationCount: 100000,
    numBytesRequested: 256 / 8));

Console.WriteLine($"Hashed: {hashed}");

/*
 * SAMPLE OUTPUT
 *
 * Enter a password: Xtw9NMgx
 * Salt: CGYzqeN4plZekNC88Umm1Q==
 * Hashed: Gt9Yc4AiIvmsC1QQbe2RZsCIqvoYlst2xbz0Fs8aHnw=
 */

using System;
using System.Security.Cryptography;
using Microsoft.AspNetCore.Cryptography.KeyDerivation;

public class Program
{
    public static void Main(string[] args)
    {
        Console.Write("Enter a password: ");
        string password = Console.ReadLine();

        // generate a 128-bit salt using a cryptographically strong random sequence of nonzero values
        byte[] salt = new byte[128 / 8];
        using (var rngCsp = new RNGCryptoServiceProvider())
        {
            rngCsp.GetNonZeroBytes(salt);
        }
        Console.WriteLine($"Salt: {Convert.ToBase64String(salt)}");

        // derive a 256-bit subkey (use HMACSHA256 with 100,000 iterations)
        string hashed = Convert.ToBase64String(KeyDerivation.Pbkdf2(
            password: password,
            salt: salt,
            prf: KeyDerivationPrf.HMACSHA256,
            iterationCount: 100000,
            numBytesRequested: 256 / 8));
        Console.WriteLine($"Hashed: {hashed}");
    }
}

/*
 * SAMPLE OUTPUT
 *
 * Enter a password: Xtw9NMgx
 * Salt: CGYzqeN4plZekNC88Umm1Q==
 * Hashed: Gt9Yc4AiIvmsC1QQbe2RZsCIqvoYlst2xbz0Fs8aHnw=
 */

有关实际用例，请参阅 ASP.NET Core Identity 的 PasswordHasher 类型的源代码。

注意

指向 .NET 参考源的文档链接通常会加载存储库的默认分支，该分支表示针对下一个 .NET 版本的当前开发。若要为特定版本选择标记，请使用“切换分支或标记”下拉列表。有关详细信息，请参阅如何选择 ASP.NET Core 源代码的版本标记 (dotnet/AspNetCore.Docs #26205)。

通过

ASP.NET Core 中的哈希密码

其他资源