Генерирует подписи

# openssl_sign

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

openssl_sign — Генерирует подписи

### Описание

function 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() - Проверяет подпись

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open