readme - SignerInfo

Author: Falseclock

README.md

@@ -32,7 +32,7 @@ CAdES. Так начался долгий путь чтения RFC и напи
 ## Манипуляторы
 
 * [EncapsulatedContentInfo](#EncapsulatedContentInfo)
-* [SignedData](#_SignedData_)
+* [SignedData](#SignedData)
 * [SignedDataContent](#SignedDataContent)
 * [SignerInfo](#SignerInfo)
 * [UnsignedAttributes](#UnsignedAttributes)
@@ -97,7 +97,7 @@ public function mergeCMS(SignedData $signedData): SignedData
 * * *
 
 # **SignedDataContent**
-**SignedDataContent** — согласно [RFC5652](https://datatracker.ietf.org/doc/html/rfc5652#section-5.1) это последовательность нескольких элементов, который включает
+**SignedDataContent** — согласно [RFC5652](https://datatracker.ietf.org/doc/html/rfc5652#section-5.1) это последовательность нескольких элементов, которая включает
 дайджест, подписанные данные, сертификаты, отзывы на сертификаты и данные по подписях.
 
 ## **Методы**
@@ -143,7 +143,59 @@ appendSignerInfo — добавление подписи в CMS, которая
 public function appendSignerInfo(Certificate $certificate): self
 ```
 
-Это тот самый метод, ради которого и затеялась разработка данной библиотеки. Позволяет объединять несколько подписей в единый CMS файл.
+Это один из основных методов, ради которого и затеялась разработка данной библиотеки. Позволяет объединять несколько подписей в единый CMS файл.
 
 * * *
 
+# **SignerInfo**
+**SignerInfo** — согласно [RFC5652](https://datatracker.ietf.org/doc/html/rfc5652#section-5.3) в подписи могут содержаться неподписанные данные. Например, 
+OCSP проверка или TSP метка. Несмотря на то, что эти данные также могут находиться и в подписанных данных, не все средства подписания реализуют сохранение
+дополнительных атрибутов в блоке подписи. Для этого в SignerInfo предусмотрен блок UnsignedAttributes, куда важные данные для проверки легитимности подписи
+могут быть добавлены позднее. Более подробно об атрибутах можно найти информацию в [RFC5126](https://datatracker.ietf.org/doc/html/rfc5126).
+
+## **Методы**
+
+### **addUnsignedAttribute**
+
+addUnsignedAttribute — добавление неподписанного атрибута
+
+#### Описание
+
+```php
+public function addUnsignedAttribute(UnsignedAttribute $newAttribute): SignerInf
+```
+
+Как правило, это OCSP и TSP данные. На самом деле, атрибуты не ограничены только этими проверками и метками. Тем не менее одинаковые типы данных
+хранятся в неупорядоченном наборе последовательности, имеющий OID идентификатор, указывающий какой набор данных содержит та или иная последовательность.
+Иными словами, например OCSP метки будут храниться в SET поле SEQUENCE, которая имеет OID 1.2.840.113549.1.9.16.2.24 (revocationValues), а TSP метки
+будут храниться в наборе последовательности, которая имеет OID 1.2.840.113549.1.9.16.2.14 (timeStampToken)
+
+* * *
+
+### **createUnsignedAttributes**
+
+createUnsignedAttributes — создание набора неподписанных атрибутов
+
+#### Описание
+
+```php
+protected function createUnsignedAttributes(): ?UnsignedAttributes
+```
+
+Электронная цифровая подпись необязательно должна иметь неподписанные данные, тем не менее, этот набор может быть добавлен в ЭЦП не нарушая целостность её данных.
+
+* * *
+
+### **deleteUnsignedAttributes**
+
+deleteUnsignedAttributes — удаление неподписанных атрибутов
+
+#### Описание
+
+```php
+public function deleteUnsignedAttributes(): SignerInfo
+```
+
+Так же как и с добавлением дополнительных атрибутов, они могут быть легко удалены, при этом целостность и достоверность подписи не будет нарушена. 
+
+* * *