需要注意的是,openssl_sign() 和 openssl_verify (OPENSSL_ALGO_SHA1) 使用的默认签名算法不再默认情况下由 OpenSSL 版本 3 系列支持。
使用更新的 OpenSSL 库,您必须在库所在的服务器上运行
"update-crypto-policies --set LEGACY"
才能使这些函数在没有可选的替代算法参数的情况下工作。
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
openssl_sign — 生成签名
$data
,&$signature
,$private_key
,$algorithm
= OPENSSL_ALGO_SHA1
openssl_sign() 使用与 private_key
关联的私钥生成加密数字签名,从而计算指定 data
的签名。请注意,数据本身不会被加密。
data
要签名的字符串数据
signature
如果调用成功,则签名将返回到 signature
中。
private_key
OpenSSLAsymmetricKey - 由 openssl_get_privatekey() 返回的密钥
字符串 - PEM 格式的密钥
algorithm
字符串 - 由 openssl_get_md_methods() 返回的有效字符串,例如“sha256WithRSAEncryption”或“sha384”。
版本 | 描述 |
---|---|
8.0.0 |
private_key 现在接受 OpenSSLAsymmetricKey 或 OpenSSLCertificate 实例;以前,接受的是 OpenSSL key 或 OpenSSL X.509 类型的 资源。 |
示例 #1 openssl_sign() 示例
<?php
// 假设 $data 包含要签名的数据
// 从文件获取私钥并准备它
$pkeyid = openssl_pkey_get_private("file://src/openssl-0.9.6/demos/sign/key.pem");
// 计算签名
openssl_sign($data, $signature, $pkeyid);
// 从内存中释放密钥
openssl_free_key($pkeyid);
?>
示例 #2 openssl_sign() 示例
<?php
// 要签名的数据
$data = 'my data';
// 创建新的私钥和公钥
$new_key_pair = openssl_pkey_new(array(
"private_key_bits" => 2048,
"private_key_type" => OPENSSL_KEYTYPE_RSA,
));
openssl_pkey_export($new_key_pair, $private_key_pem);
$details = openssl_pkey_get_details($new_key_pair);
$public_key_pem = $details['key'];
// 创建签名
openssl_sign($data, $signature, $private_key_pem, OPENSSL_ALGO_SHA256);
// 保存以供日后使用
file_put_contents('private_key.pem', $private_key_pem);
file_put_contents('public_key.pem', $public_key_pem);
file_put_contents('signature.dat', $signature);
// 验证签名
$r = openssl_verify($data, $signature, $public_key_pem, "sha256WithRSAEncryption");
var_dump($r);
?>
需要注意的是,openssl_sign() 和 openssl_verify (OPENSSL_ALGO_SHA1) 使用的默认签名算法不再默认情况下由 OpenSSL 版本 3 系列支持。
使用更新的 OpenSSL 库,您必须在库所在的服务器上运行
"update-crypto-policies --set LEGACY"
才能使这些函数在没有可选的替代算法参数的情况下工作。
如果您只想要一个真正简单的私钥/公钥对,这可能会有所帮助
<?php
$data = "啤酒真不错.. 嗝...";
// 你可以使用以下命令生成一个简单的私钥/公钥对:
// openssl genrsa 512 >private_key.txt
// openssl rsa -pubout <private_key.txt >public_key.txt
// 重要提示:以下密钥对仅供测试使用。
// 出于安全原因,你必须为生产环境获取新的密钥对。
$private_key = <<<EOD
-----BEGIN RSA PRIVATE KEY-----
MIIBOgIBAAJBANDiE2+Xi/WnO+s120NiiJhNyIButVu6zxqlVzz0wy2j4kQVUC4Z
RZD80IY+4wIiX2YxKBZKGnd2TtPkcJ/ljkUCAwEAAQJAL151ZeMKHEU2c1qdRKS9
sTxCcc2pVwoAGVzRccNX16tfmCf8FjxuM3WmLdsPxYoHrwb1LFNxiNk1MXrxjH3R
6QIhAPB7edmcjH4bhMaJBztcbNE1VRCEi/bisAwiPPMq9/2nAiEA3lyc5+f6DEIJ
h1y6BWkdVULDSM+jpi1XiV/DevxuijMCIQCAEPGqHsF+4v7Jj+3HAgh9PU6otj2n
Y79nJtCYmvhoHwIgNDePaS4inApN7omp7WdXyhPZhBmulnGDYvEoGJN66d0CIHra
I2SvDkQ5CmrzkW5qPaE2oO7BSqAhRZxiYpZFb5CI
-----END RSA PRIVATE KEY-----
EOD;
$public_key = <<<EOD
-----BEGIN PUBLIC KEY-----
MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBANDiE2+Xi/WnO+s120NiiJhNyIButVu6
zxqlVzz0wy2j4kQVUC4ZRZD80IY+4wIiX2YxKBZKGnd2TtPkcJ/ljkUCAwEAAQ==
-----END PUBLIC KEY-----
EOD;
$binary_signature = "";
// 至少在 PHP 5.2.2 / OpenSSL 0.9.8b (Fedora 7) 上
// 似乎不需要调用 openssl_get_privatekey 或类似函数。
// 只需传递上面定义的密钥即可
openssl_sign($data, $binary_signature, $private_key, OPENSSL_ALGO_SHA1);
// 检查签名
$ok = openssl_verify($data, $binary_signature, $public_key, OPENSSL_ALGO_SHA1);
echo "检查 #1: ";
if ($ok == 1) {
echo "签名正常(如预期)\n";
} elseif ($ok == 0) {
echo "错误(有问题)\n";
} else {
echo "异常,检查签名错误\n";
}
$ok = openssl_verify('篡改'.$data, $binary_signature, $public_key, OPENSSL_ALGO_SHA1);
echo "检查 #2: ";
if ($ok == 1) {
echo "错误:数据已被篡改,但签名仍然有效!糟糕!\n";
} elseif ($ok == 0) {
echo "错误的签名(如预期,因为数据已被篡改)\n";
} else {
echo "异常,检查签名错误\n";
}
?>
签名算法(常量)列表非常有限!幸运的是,更新版本的 php/openssl 允许你将签名算法指定为字符串。
你可以使用 'openssl_get_md_methods' 方法获取摘要方法列表。只有其中一些方法可用于使用 RSA 私钥签名。
可以使用 RSA 私钥签名的摘要方法包括:md4、md5、ripemd160、sha、sha1、sha224、sha256、sha384、sha512。
以下是使用 SHA-512 哈希修改后的示例 #1
<?php
// 假设 $data 包含要签名的数据
// 从文件获取私钥并准备
$fp = fopen("/src/openssl-0.9.6/demos/sign/key.pem", "r");
$priv_key = fread($fp, 8192);
fclose($fp);
$pkeyid = openssl_get_privatekey($priv_key);
// 使用 SHA-512 计算签名
openssl_sign($data, $signature, $pkeyid, "sha512");
// 从内存中释放密钥
openssl_free_key($pkeyid);
?>
你好,
用于选择签名算法的第四个参数 'signature_alg' 可以是以下之一
OPENSSL_ALGO_SHA1
OPENSSL_ALGO_MD5
OPENSSL_ALGO_MD4
OPENSSL_ALGO_MD2
仅供需要的人参考。
此致