前往 Vapor 2.0 - 文档目录
散列（Hashing）是将任意数据转换为固定大小格式的一种方法。与ciphers不同，散列的数据不能从结果摘要中检索出来。Hashes可用于创建密钥、文件标识符或存储凭据。
来自维基百科(Wikipedia)的哈希函数图。
警告
如果可能的话，避免存储密码散列。如果你必须，请务必在继续之前先研究一下艺术的状态。
构造（Make）
要对一个字符串进行散列，可以在Droplet上使用hash属性。
let digest = try drop.hash.make("vapor")
print(digest.string)
检查（Checking）
一些散列算法为相同的消息创建不同的散列摘要。因此，使用check方法检查您的散列是必要的。
let matches = try drop.hash.check("vapor", matchesHash: digest)
加密哈希计算器（CryptoHasher）
在默认情况下，Vapor使用的是SHA-256哈希计算器。您可以在配置文件中更改这个，也可以通过给Droplet一个不同的哈希计算器。
配置（Configuration）
Config/droplet.json
{
...,
"hash": "crypto",
...
}
Config/crypto.json
{
"hash": {
"method": "sha256",
"encoding": "hex",
"key": "password"
},
...
}
编码（Encoding）
加密哈希计算器支持三种编码方法。
hexbase64plain
秘钥（Key）
提供一把钥匙将使哈希计算器使用HMAC产生键控的哈希。一些哈希计算器需要一个密钥。
支持（Supported）
| Name | Method | Requires Key |
|---|---|---|
| SHA-1 | sha1 | no |
| SHA-224 | sha224 | no |
| SHA-256 | sha256 | no |
| SHA-384 | sha384 | no |
| SHA-512 | sha512 | no |
| MD4 | md4 | no |
| MD5 | md5 | no |
| RIPEMD-160 | ripemd160 | no |
| Whirlpool | whirlpool | yes |
| Streebog-256 | streebog256 | yes |
| Streebog-512 | streebog512 | yes |
| GostR341194 | gostr341194 | yes |
手册（Manual）
可以在不使用配置文件的情况下交换哈希计算器。
哈希（Hash）
let hash = CryptoHasher(
hash: .sha256,
encoding: .hex
)
let drop = try Droplet(hash: hash)
哈希信息验证码（HMAC）
let hash = CryptoHasher(
hmac: .sha256,
encoding: .hex,
key: "password".makeBytes()
)
let drop = try Droplet(hash: hash)
跨平台文件加密哈希计算器（BCryptHasher）
BCrypt（跨平台文件加密工具）是一个密码哈希函数，它自动包含了盐（salts），并提供了一个可配置的成本（cost）。成本（cost）可用于增加生成哈希所需的计算。
再瞧瞧
了解更多关于维基百科的关键扩展(key stretching)。
配置（Configuration）
要使用BCryptHasher，可以在droplet.json配置文件中更改"hash"键。
Config/droplet.json
{
...,
"hash": "bcrypt",
...
}
要配置成本(cost)，需要添加一个bcrypt.json文件。
Config/bcrypt.json
{
"cost": 8
}
提示
您可以使用不同的BCrypt costs用于生产和开发模式，以便在项目工作时快速地保持密码散列。
手册（Manual）
您可以手动分配一个BCryptHasher到drop.hash。
let hash = BCryptHasher(cost: 8)
let drop = try Droplet(hash: hash)
高级设置（Advanced）
自定义（Custom）
你也可以创建你自己的哈希计算器。您只需要遵循Hash协议。
/// Creates hash digests 创建哈希摘要
public protocol HashProtocol {
/// Given a message, this method
/// returns a hashed digest of that message.
/// 给定消息，该方法返回该消息的散列摘要。
func make(_ message: Bytes) throws -> Bytes
/// Checks whether a given digest was created
/// by the supplied message.
/// 检查给定摘要是否被所提供的消息所创建。
///
/// Returns true if the digest was created
/// by the supplied message, false otherwise.
/// 如果摘要被提供的消息所创建，则返回true，否则将返回false。
func check(_ message: Bytes, matchesHash: Bytes) throws -> Bool
}