Описание

openssl_sign(
    string $data,
    string &$signature,
    OpenSSLAsymmetricKey|OpenSSLCertificate|array|string $private_key,
    string|int $algorithm = OPENSSL_ALGO_SHA1,
    int $padding = 0
): bool

Функция openssl_sign() вычисляет подпись для данных data путём генерации закрытым ключом private_key криптографического цифрового слепка. Обратите внимание, что сами данные не шифруются.

Список параметров

data

Строка данных, для которых требуется получить отпечаток.

signature

В случае успешного выполнения функция поместит подпись в переменную, которую задали в параметре signature.

private_key

Экземпляр класса OpenSSLAsymmetricKey — ключ, который вернула функция openssl_get_privatekey().

Строка (string) — ключ в формате PEM.

algorithm

Целое число (int) — один из алгоритмов подписи.

Строка (string) — корректная строка, которую вернула функция openssl_get_md_methods(), например, «sha256WithRSAEncryption» или «sha384».

padding

Схема дополнения PSS (англ. Probabilistic Signature Scheme — вероятностная схема подписи) алгоритма RSA.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Список изменений

Версия	Описание
8.5.0	Добавили необязательный параметр `padding`.
8.0.0	Параметр `private_key` теперь принимает экземпляр класса OpenSSLAsymmetricKey или OpenSSLCertificate; раньше принимался ресурс (resource) типа `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_verify() - Проверяет подпись