From 895acf2a850efd302781880156266900e1621459 Mon Sep 17 00:00:00 2001
From: Artem Vasilev <kern.usr@gmail.com>
Date: Thu, 20 Oct 2022 20:06:50 +0300
Subject: [PATCH] =?UTF-8?q?=D0=9F=D1=80=D0=BE=D1=86=D0=B5=D1=81=D1=81=20?=
 =?UTF-8?q?=D0=BF=D0=B5=D1=80=D0=B5=D0=B4=D0=B5=D0=BB=D0=BA=D0=B8=20=D0=B1?=
 =?UTF-8?q?=D0=B8=D0=B1=D0=BB=D0=B8=D0=BE=D1=82=D0=B5=D0=BA=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/Certificate.php                           |  87 ++++++++++++++
 src/CryptoPro.php                             | 107 ++++++++++++++++++
 src/Helpers/CertificateHelper.php             |  70 ++++++++++++
 .../Messages/HumanReadebleCPErrors.php        |   8 ++
 src/Tags/AbstractTagsCodes.php                |  20 ++++
 src/Tags/AbstractTagsOIDs.php                 |  25 ++++
 src/Tags/AbstractTagsTranslations.php         |  13 +++
 src/Tags/IssuerTagsTranslations.php           |  25 ++++
 src/Tags/SubjectTagsTranslations.php          |  27 +++++
 src/Tags/TagsCodes.php                        |  27 +++++
 src/Tags/TagsCodesInterface.php               |   8 ++
 src/Tags/TagsOIDs.php                         |  27 +++++
 src/Tags/TagsOIDsInterface.php                |  10 ++
 src/Tags/TagsTranslationsInterface.php        |   8 ++
 src/Traits/ReversMapInterface.php             |   8 ++
 src/Traits/ReversMapTrait.php                 |  37 ++++++
 16 files changed, 507 insertions(+)
 create mode 100755 src/Certificate.php
 create mode 100755 src/Helpers/CertificateHelper.php
 create mode 100755 src/Helpers/Messages/HumanReadebleCPErrors.php
 create mode 100755 src/Tags/AbstractTagsCodes.php
 create mode 100755 src/Tags/AbstractTagsOIDs.php
 create mode 100755 src/Tags/AbstractTagsTranslations.php
 create mode 100755 src/Tags/IssuerTagsTranslations.php
 create mode 100755 src/Tags/SubjectTagsTranslations.php
 create mode 100755 src/Tags/TagsCodes.php
 create mode 100755 src/Tags/TagsCodesInterface.php
 create mode 100755 src/Tags/TagsOIDs.php
 create mode 100755 src/Tags/TagsOIDsInterface.php
 create mode 100755 src/Tags/TagsTranslationsInterface.php
 create mode 100755 src/Traits/ReversMapInterface.php
 create mode 100755 src/Traits/ReversMapTrait.php

diff --git a/src/Certificate.php b/src/Certificate.php
new file mode 100755
index 0000000..08db78b
--- /dev/null
+++ b/src/Certificate.php
@@ -0,0 +1,87 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro;
+
+class Certificate
+{
+	/**
+	 * возвращает флаг действительности сертификата
+	 *
+	 * @return void
+	 */
+	public function isValid()
+	{
+	}
+
+	/**
+	 * возвращает указанное внутренее свойство у сертификата в формате Cades
+	 *
+	 * @return void
+	 */
+	public function getCadesProp()
+	{
+	}
+
+	/**
+	 * возвращает сертификат в формате base64
+	 *
+	 * @return void
+	 */
+	public function exportBase64()
+	{
+	}
+
+	/**
+	 * возвращает информацию об алгоритме сертификата
+	 *
+	 * @return void
+	 */
+	public function getAlgorithm()
+	{
+	}
+
+	/**
+	 * возвращает расшифрованную информацию о владельце сертификата
+	 *
+	 * @return void
+	 */
+	public function getOwnerInfo()
+	{
+	}
+
+	/**
+	 * возвращает расшифрованную информацию об издателе сертификата
+	 *
+	 * @return void
+	 */
+	public function getIssuerInfo()
+	{
+	}
+
+	/**
+	 * возвращает ОИД'ы сертификата
+	 *
+	 * @return void
+	 */
+	public function getExtendedKeyUsage()
+	{
+	}
+
+	/**
+	 * возвращает расшифрованные ОИД'ы
+	 *
+	 * @return void
+	 */
+	public function getDecodedExtendedKeyUsage()
+	{
+	}
+
+	/**
+	 * проверяет наличие ОИД'а (ОИД'ов) у сертификата
+	 *
+	 * @return void
+	 */
+	public function hasExtendedKeyUsage()
+	{
+	}
+}
\ No newline at end of file
diff --git a/src/CryptoPro.php b/src/CryptoPro.php
index 6bed535..6081cfe 100755
--- a/src/CryptoPro.php
+++ b/src/CryptoPro.php
@@ -4,5 +4,112 @@ namespace Webmasterskaya\CryptoPro;
 
 class CryptoPro
 {
+	/**
+	 * возвращает список сертификатов, доступных пользователю в системе
+	 *
+	 * @return void
+	 */
+	public static function getUserCertificates(bool $resetCache = false)
+	{
+	}
+
+	/**
+	 * возвращает список сертификатов, доступных пользователю в системе, в том числе просроченные и без закрытого ключа
+	 *
+	 * @return void
+	 */
+	public static function getAllUserCertificates(bool $resetCache = false)
+	{
+	}
+
+	/**
+	 * возвращает список сертификатов, из закрытых ключей и/или сертификаты не установленные всистеме*
+	 *
+	 * @return void
+	 */
+	public static function getContainerCertificates(bool $resetCache = false)
+	{
+	}
+
+	/**
+	 * возвращает список сертификатов, из закрытых ключей и/или сертификаты не установленные всистеме*, в том числе просроченные и без закрытого ключа
+	 *
+	 * @return void
+	 */
+	public static function getAllContainerCertificates(bool $resetCache = false)
+	{
+	}
+
+	/**
+	 * возвращает сертификат по отпечатку
+	 *
+	 * @return void
+	 */
+	public static function getCertificate()
+	{
+	}
+
+	/**
+	 * создает совмещенную (присоединенную) подпись сообщения
+	 *
+	 * @return void
+	 */
+	public static function createAttachedSignature()
+	{
+	}
+
+	/**
+	 * создает отсоединенную (открепленную) подпись сообщения
+	 *
+	 * @return void
+	 */
+	public static function createDetachedSignature()
+	{
+	}
+
+	/**
+	 * добавляет совмещенную (присоединенную) подпись к раннее подписанному документу (реализует метод coSign)
+	 *
+	 * @return void
+	 */
+	public static function addAttachedSignature()
+	{
+	}
+
+	/**
+	 * добавляет отсоединенную (открепленную) подпись к раннее подписанному документу (реализует метод coSign)
+	 *
+	 * @return void
+	 */
+	public static function addDetachedSignature()
+	{
+	}
+
+	/**
+	 * создает XML подпись для документа в формате XML
+	 *
+	 * @return void
+	 */
+	public static function createXMLSignature()
+	{
+	}
+
+	/**
+	 * создает хеш сообщения по ГОСТ Р 34.11-2012 256 бит
+	 *
+	 * @return void
+	 */
+	public static function createHash()
+	{
+	}
+
+	/**
+	 * возвращает информацию о CSP и плагине
+	 *
+	 * @return void
+	 */
+	public static function getSystemInfo()
+	{
+	}
 
 }
\ No newline at end of file
diff --git a/src/Helpers/CertificateHelper.php b/src/Helpers/CertificateHelper.php
new file mode 100755
index 0000000..f0f9b03
--- /dev/null
+++ b/src/Helpers/CertificateHelper.php
@@ -0,0 +1,70 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Helpers;
+
+use Webmasterskaya\CryptoPro\Tags\TagsCodes;
+use Webmasterskaya\CryptoPro\Tags\TagsOIDs;
+use Webmasterskaya\CryptoPro\Tags\TagsTranslationsInterface;
+
+class CertificateHelper
+{
+	public static function parseCertInfo(TagsTranslationsInterface $tagsTranslations, string $rawInfo)
+	{
+		$extractedEntities = [];
+
+		preg_match_all('/([а-яА-Яa-zA-Z0-9\s.]+)=(?:("[^"]+?")|(.+?))(?:,|$)/', $rawInfo, $extractedEntities, PREG_SET_ORDER, 0);
+
+		if (!empty($extractedEntities))
+		{
+			return array_map(function ($extractedEntity) use ($tagsTranslations) {
+
+				$title = trim($extractedEntity[1]);
+
+				// Проверяем наличие OID в заголовке
+				$oidIdentifierMatch = [];
+				$oidIdentifier      = null;
+				if (preg_match('/^OID\.(.*)/', $title, $oidIdentifierMatch) === 1)
+				{
+					$oidIdentifier = trim($oidIdentifierMatch[1]);
+				}
+
+				// Если нашли OID в заголовке, пытаемся его расшифровать
+				if (!empty($oidIdentifier))
+				{
+					$titleCode = TagsOIDs::codeByOid($oidIdentifier);
+
+					if (empty($titleCode))
+					{
+						$titleCode = 'OID.' . $oidIdentifier;
+					}
+				}
+				else
+				{
+					$titleCode = TagsCodes::codeByName($title);
+
+					if (empty($titleCode))
+					{
+						$titleCode = $title;
+					}
+				}
+
+				// Получаем человекочитаемый заголовок
+				$title = $tagsTranslations::translationByCode($titleCode);
+
+				// Вырезаем лишние кавычки
+				$description = preg_replace(
+					'/"{2}/g', '"',
+					preg_replace(
+						'/^"(.*)"/', "$1",
+						trim($extractedEntity[2] ?? $extractedEntity[3])
+					)
+				);
+
+				return ['title' => $title, 'description' => $description, 'code' => $titleCode];
+
+			}, $extractedEntities);
+		}
+
+		return [];
+	}
+}
\ No newline at end of file
diff --git a/src/Helpers/Messages/HumanReadebleCPErrors.php b/src/Helpers/Messages/HumanReadebleCPErrors.php
new file mode 100755
index 0000000..9f6e9b2
--- /dev/null
+++ b/src/Helpers/Messages/HumanReadebleCPErrors.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Helpers\Messages;
+
+class HumanReadableCPErrors
+{
+
+}
\ No newline at end of file
diff --git a/src/Tags/AbstractTagsCodes.php b/src/Tags/AbstractTagsCodes.php
new file mode 100755
index 0000000..f8dda38
--- /dev/null
+++ b/src/Tags/AbstractTagsCodes.php
@@ -0,0 +1,20 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Tags;
+
+use Webmasterskaya\CryptoPro\Traits\ReversMapInterface;
+use Webmasterskaya\CryptoPro\Traits\ReversMapTrait;
+
+abstract class AbstractTagsCodes implements TagsCodesInterface, ReversMapInterface
+{
+	protected const MAP = [];
+
+	use ReversMapTrait;
+
+	public static function codeByName($name)
+	{
+		$reverseMap = self::reverseMap();
+
+		return $reverseMap[strtolower($name)] ?? null;
+	}
+}
\ No newline at end of file
diff --git a/src/Tags/AbstractTagsOIDs.php b/src/Tags/AbstractTagsOIDs.php
new file mode 100755
index 0000000..5d7df1e
--- /dev/null
+++ b/src/Tags/AbstractTagsOIDs.php
@@ -0,0 +1,25 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Tags;
+
+use Webmasterskaya\CryptoPro\Traits\ReversMapInterface;
+use Webmasterskaya\CryptoPro\Traits\ReversMapTrait;
+
+abstract class AbstractTagsOIDs implements TagsOIDsInterface, ReversMapInterface
+{
+	protected const MAP = [];
+
+	use ReversMapTrait;
+
+	public static function codeByOid($oid)
+	{
+		return self::MAP[$oid] ?? null;
+	}
+
+	public static function oidByCode($code)
+	{
+		$reverseMap = self::reverseMap();
+
+		return $reverseMap[strtolower($code)] ?? null;
+	}
+}
\ No newline at end of file
diff --git a/src/Tags/AbstractTagsTranslations.php b/src/Tags/AbstractTagsTranslations.php
new file mode 100755
index 0000000..defa5dc
--- /dev/null
+++ b/src/Tags/AbstractTagsTranslations.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Tags;
+
+abstract class AbstractTagsTranslations implements TagsTranslationsInterface
+{
+	protected const MAP = [];
+
+	public static function translationByCode($code)
+	{
+		return self::MAP[$code] ?? $code;
+	}
+}
\ No newline at end of file
diff --git a/src/Tags/IssuerTagsTranslations.php b/src/Tags/IssuerTagsTranslations.php
new file mode 100755
index 0000000..2732bdb
--- /dev/null
+++ b/src/Tags/IssuerTagsTranslations.php
@@ -0,0 +1,25 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Tags;
+
+class IssuerTagsTranslations extends AbstractTagsTranslations
+{
+	protected const MAP
+		= [
+			'UN'     => 'Неструктурированное имя',
+			'CN'     => 'Удостоверяющий центр',
+			'C'      => 'Страна',
+			'S'      => 'Регион',
+			'STREET' => 'Адрес',
+			'O'      => 'Компания',
+			'OU'     => 'Тип',
+			'T'      => 'Должность',
+			'OGRN'   => 'ОГРН',
+			'OGRNIP' => 'ОГРНИП',
+			'SNILS'  => 'СНИЛС',
+			'INN'    => 'ИНН',
+			'INNLE'  => 'ИНН рганизации',
+			'E'      => 'Email',
+			'L'      => 'Город',
+		];
+}
\ No newline at end of file
diff --git a/src/Tags/SubjectTagsTranslations.php b/src/Tags/SubjectTagsTranslations.php
new file mode 100755
index 0000000..36975ce
--- /dev/null
+++ b/src/Tags/SubjectTagsTranslations.php
@@ -0,0 +1,27 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Tags;
+
+class SubjectTagsTranslations extends AbstractTagsTranslations
+{
+	protected const MAP
+		= [
+			'UN'     => 'Неструктурированное имя',
+			'CN'     => 'Владелец',
+			'SN'     => 'Фамилия',
+			'G'      => 'Имя Отчество',
+			'C'      => 'Страна',
+			'S'      => 'Регион',
+			'STREET' => 'Адрес',
+			'O'      => 'Компания',
+			'OU'     => 'Отдел/подразделение',
+			'T'      => 'Должность',
+			'OGRN'   => 'ОГРН',
+			'OGRNIP' => 'ОГРНИП',
+			'SNILS'  => 'СНИЛС',
+			'INN'    => 'ИНН',
+			'INNLE'  => 'ИНН рганизации',
+			'E'      => 'Email',
+			'L'      => 'Город',
+		];
+}
\ No newline at end of file
diff --git a/src/Tags/TagsCodes.php b/src/Tags/TagsCodes.php
new file mode 100755
index 0000000..a3d79a1
--- /dev/null
+++ b/src/Tags/TagsCodes.php
@@ -0,0 +1,27 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Tags;
+
+class TagsCodes extends AbstractTagsCodes
+{
+	protected const MAP
+		= [
+			'UN'     => ['UN', 'unstructuredName'],
+			'CN'     => ['CN', 'commonName'],
+			'SN'     => ['SN', 'surname'],
+			'G'      => ['G', 'givenName', 'gn'],
+			'C'      => ['C', 'countryName'],
+			'S'      => ['S', 'ST', 'stateOrProvinceName'],
+			'STREET' => ['STREET', 'streetAddress'],
+			'O'      => ['O', 'organizationName'],
+			'OU'     => ['OU', 'organizationalUnitName'],
+			'T'      => ['T', 'TITLE'],
+			'OGRN'   => ['OGRN', 'ОГРН'],
+			'OGRNIP' => ['OGRNIP', 'ОГРНИП'],
+			'SNILS'  => ['СНИЛС', 'SNILS'],
+			'INN'    => ['ИНН', 'ИННФЛ', 'ИНН ФЛ', 'INN'],
+			'INNLE'  => ['ИННЮЛ', 'ИНН ЮЛ', 'INNLE', 'INN LE', 'ИНН организации'],
+			'E'      => ['E', 'email', 'emailAddress', 'pkcs9email'],
+			'L'      => ['L', 'localityName'],
+		];
+}
\ No newline at end of file
diff --git a/src/Tags/TagsCodesInterface.php b/src/Tags/TagsCodesInterface.php
new file mode 100755
index 0000000..a674385
--- /dev/null
+++ b/src/Tags/TagsCodesInterface.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Tags;
+
+interface TagsCodesInterface
+{
+	public static function codeByName($name);
+}
\ No newline at end of file
diff --git a/src/Tags/TagsOIDs.php b/src/Tags/TagsOIDs.php
new file mode 100755
index 0000000..ec77fad
--- /dev/null
+++ b/src/Tags/TagsOIDs.php
@@ -0,0 +1,27 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Tags;
+
+class TagsOIDs extends AbstractTagsOIDs
+{
+	protected const MAP
+		= [
+			'1.2.840.113549.1.9.2' => 'UN',
+			'2.5.4.3'              => 'CN',
+			'2.5.4.4'              => 'SN',
+			'2.5.4.42'             => 'G',
+			'2.5.4.6'              => 'C',
+			'2.5.4.8'              => 'S',
+			'2.5.4.9'              => 'STREET',
+			'2.5.4.10'             => 'O',
+			'2.5.4.11'             => 'OU',
+			'2.5.4.12'             => 'T',
+			'1.2.643.100.1'        => 'OGRN',
+			'1.2.643.100.5'        => 'OGRNIP',
+			'1.2.643.100.3'        => 'SNILS',
+			'1.2.643.3.131.1.1'    => 'INN',
+			'1.2.643.100.4'        => 'INNLE',
+			'1.2.840.113549.1.9.1' => 'E',
+			'2.5.4.7'              => 'L',
+		];
+}
\ No newline at end of file
diff --git a/src/Tags/TagsOIDsInterface.php b/src/Tags/TagsOIDsInterface.php
new file mode 100755
index 0000000..bb5637f
--- /dev/null
+++ b/src/Tags/TagsOIDsInterface.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Tags;
+
+interface TagsOIDsInterface
+{
+	public static function codeByOid($oid);
+
+	public static function oidByCode($code);
+}
\ No newline at end of file
diff --git a/src/Tags/TagsTranslationsInterface.php b/src/Tags/TagsTranslationsInterface.php
new file mode 100755
index 0000000..77f6744
--- /dev/null
+++ b/src/Tags/TagsTranslationsInterface.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Tags;
+
+interface TagsTranslationsInterface
+{
+	public static function translationByCode($code);
+}
\ No newline at end of file
diff --git a/src/Traits/ReversMapInterface.php b/src/Traits/ReversMapInterface.php
new file mode 100755
index 0000000..944b2a6
--- /dev/null
+++ b/src/Traits/ReversMapInterface.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Traits;
+
+interface ReversMapInterface
+{
+	public static function reverseMap();
+}
\ No newline at end of file
diff --git a/src/Traits/ReversMapTrait.php b/src/Traits/ReversMapTrait.php
new file mode 100755
index 0000000..8b2895f
--- /dev/null
+++ b/src/Traits/ReversMapTrait.php
@@ -0,0 +1,37 @@
+<?php
+
+namespace Webmasterskaya\CryptoPro\Traits;
+
+trait ReversMapTrait
+{
+	public static function reverseMap()
+	{
+		static $reverseMap;
+
+		if (!isset($reverseMap))
+		{
+			$reverseMap = [];
+			foreach (self::MAP as $key => $values)
+			{
+				if (is_object($values))
+				{
+					$values = (array) $values;
+				}
+
+				if (!is_array($values))
+				{
+					$reverseMap[strtolower((string) $values)] = $key;
+				}
+				else
+				{
+					foreach ($values as $value)
+					{
+						$reverseMap[strtolower($value)] = $key;
+					}
+				}
+			}
+		}
+
+		return $reverseMap;
+	}
+}
\ No newline at end of file