前往 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)
加密哈希计算器支持三种编码方法。
hex
base64
plain
秘钥(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
}