readme - SignedData

Author: Falseclock

README.md

@@ -21,17 +21,18 @@ composer require falseclock/advanced-cms
 Предыстория
 ------------
 Когда в Казахстане и России стала активно внедряться Электронная цифровая подпись (ЭЦП), я с большой для себя неожиданностью обнаружил,
-что в PHP нет библиотек, позволяющих не только формализовать ASN.1 запись цифровой подписи в объект, но и буквально модифицировать её, путем добавления
+что в PHP нет библиотек, позволяющих не только формализовать ASN.1 запись цифровой подписи в объект, но и тем более модифицировать её, путем добавления
 OCSP проверок или TSP меток, удалить электронный контент, чтобы оставить только подписи или просто объединить две разные подписи одних и тех же данных.
 Отправной точкой стала библиотека [adapik/cms](https://github.com/Adapik/CMS), в которой на тот момент не было детального описания всех возможных полей и данных в
 CAdES. Так начался долгий путь чтения RFC и написания [нескольких тысяч строк кода](https://github.com/Adapik/CMS/graphs/contributors) чтобы полностью и 
-безошибочно описать рекомендации в виде библиотеки. Но по договоренности с Александром Даниловым, мы решили, что изначальная библиотека будет работать
+детально описать рекомендации в виде библиотеки. Но по договоренности с Александром Даниловым, мы решили, что изначальная библиотека будет работать
 исключительно в режиме чтения, а все остальное, если я того желаю, могу сделать в виде отдельного пакета. Что, собственно, и было сделано.
 
 
 ## Манипуляторы
 
 * [EncapsulatedContentInfo](#EncapsulatedContentInfo)
+* [SignedData](#_SignedData_)
 * [OCSPRequest](#OCSPRequest)
 * [OCSPResponse](#OCSPResponse)
 * [OCSPResponseStatus](#OCSPResponseStatus)
@@ -40,7 +41,6 @@ CAdES. Так начался долгий путь чтения RFC и напи
 * [ResponseBytes](#ResponseBytes)
 * [RevocationValues](#RevocationValues)
 * [Signature](#Signature)
-* [SignedData](#_SignedData_)
 * [SignedDataContent](#SignedDataContent)
 * [SignerInfo](#SignerInfo)
 * [TBSRequest](#TBSRequest)
@@ -53,7 +53,8 @@ CAdES. Так начался долгий путь чтения RFC и напи
 * * *
 
 # **EncapsulatedContentInfo**
-**EncapsulatedContentInfo** — Согласно [RFC5652](https://datatracker.ietf.org/doc/html/rfc5652#section-5.2) - место хранения подписанных данных.
+**EncapsulatedContentInfo** — Согласно [RFC5652](https://datatracker.ietf.org/doc/html/rfc5652#section-5.2) - место хранения подписанных данных. Хранить
+данные в слепке ЭЦП не обязательное условие, следовательно, их можно удалять или внедрять. 
 
 ## **Методы**
 
@@ -68,7 +69,8 @@ public function setEContent(OctetString $octetString): self
 ```
 
 В случае, если подписанные данные и сами подписи хранятся раздельно, но необходимо сформировать полный CMS файл, данный метод позволяет
-внедрить содержание в подпись. 
+внедрить содержание в подпись. Следует учесть, что метод не проверяет хэш файла и хэш из подписи, так как алгоритм хеширования может не входить
+в стандартную поставку openssl.
 
 * * *
 
@@ -86,4 +88,23 @@ public function unSetEContent(): self
 хранить данные и подписи, вполне разумно их разделять, особенно, если данные очень большого объема, так как их всегда можно проверить по хэшу, 
 который использовался в подписи. 
 
-* * *
+* * *
+
+# **SignedData**
+**SignedData** — объединение двух цифровых подписей в единую.
+
+## **Методы**
+
+### **mergeCMS**
+
+mergeCMS — объединение дайджестов, публичных и отозванных сертификатов, а также самих подписей
+
+#### Описание
+
+```php
+public function mergeCMS(SignedData $signedData): SignedData
+```
+
+Метод позволяет собрать несколько CMS файлов в единый, если один и тот же файл был подписан разными системами, либо если каждая подпись хранится отдельно.
+
+* * *