Библиотека для просмотра установленных сертификатов, подписания данных и верификации подписей с помощью расширения КриптоПро для PHP.
Перед использованием Crypto-PHP необходимо произвести установку КриптоПРО CSP и скомпилировать расширение libphpcades для вашей версии PHP.
Если подразумевается подписание данных, то дополнительно потребуется установить необходимые ключи для пользователя, из-под которого запущен веб-сервер.
Более подробно описано в инструкции по установке.
Полный пример использования можно посмотреть на странице examples/index.php.
require 'CryptoHelper.php';
$crypto = new CryptoHelper();Их хранилища пользователя запрашиваются только активные и валидные сертификаты.
$certificates = $crypto->GetCertificates();
print_r($certificates);
//=> Array (
// [0] => CryptoCertificate Object (
// [original:CryptoCertificate:private] => CPCertificate Object ()
// [pin:CryptoCertificate:private] =>
// [Subject] => stdClass Object (
// [email] => admin@example.com
// [name] => Horns and Hoofs, LLC (TEST)
// [company] => ООО "Рога и Копыта"
// )
// [Issuer] => stdClass Object (
// [email] => support@cryptopro.ru
// [city] => Moscow
// [company] => CRYPTO-PRO LLC
// [name] => CRYPTO-PRO Test Center 2
// )
// [Version] => 3
// [SerialNumber] => 120039CB6175D20B28460D384200010039CB61
// [Thumbprint] => 81E3BF1FB98BE9FA37637072491C58F8A9FEFC30
// [ValidFrom] => 13.08.2019 06:37:33
// [ValidTo] => 13.11.2019 06:47:33
// [HasPrivate] => 1
// [IsValid] => 1
// )
// )Класс CryptoHelper содержит несколько методов подписания данных:
| Метод | Аргументы | Описание |
|---|---|---|
| Sign | (CryptoСertificate, string $data, $toBase64 = true) | Подписание строки |
| SignFile | (CryptoСertificate, string $dataFilePath, $string $signFilePath = null) | Подписание файла и сохранение в файл $signFilePath (если указан) |
// Если у сертификата задан pin, то необходимо его указать
$certificate->SetPin('123456');
// Прдписание строки
$secret = 'My secret string';
$sign = $crypto->Sign($certificate, $secret);
// => 'MIIIgAYJKoZIhvc...';
// Подписание файла
$sign = $crypto->SignFile($certificate, 'file.pdf', 'file.pdf.sgn');
// => 'MIIIgAYJKoZIhvc...';Класс CryptoHelper содержит несколько методов верификации данных:
| Метод | Аргументы | Описание |
|---|---|---|
| Verify | (string $data, $toBase64 = true) | Верификация строки |
| VerifyFile | (string $dataFilePath, $string $signFilePath = null) | Верификация файлов |
$data = 'My secret string';
$sign = 'MIIIgAYJKoZIhvc...';
$signInfo = $crypto->Verify($data, $sign, true);
if (!$signInfo) {
// Подпись не валидна
} else {
// Подпись валидна, вывести список подписей
foreach ($signInfo as $sign) {
echo "\nTimestamp: {$sign->ts}, Name: {$sign->cert->Subject->Name}\n";
}
}
// Верификация файлов
$signInfo = $crypto->VerifyFile('file.pdf', 'file.pdf.sgn');