# Аутентификация и контроль доступа

Сервис поддерживает два механизма аутентификации:
- аутентификация пользователей по цифровым сертификатам - этот механизм подходит для тех случаев, когда действия выполняются от имени пользователей (к примеру просмотр своих подписанных документов или документов сотрудников компании);
- аутентификация информационных систем двусторонним mTLS - этот механизм подходит для автоматизированных сценариев, когда действия должны выполняться не от имени определенных пользователей, а от имени информационной системы (к примеру построение отчетов о подписанных документах по расписанию).


## Аутентификация пользователей по цифровым сертификатам {#user-authentication}
Этот способ аутентификации подходит для тех сценариев, когда действия предполагается выполнять от имени конкретных пользователей, к примеру:
- Система электронного документооборота (ЭДО) может использовать SIGEX как источник данных о цифровых подписях под документами пользователей. В этом случае после входа в свой профиль в ЭДО пользователи могут просматривать и редактировать настройки своего профиля в SIGEX, менять параметры своих подписанных документов в SIGEX. Для выполнения действий ЭДО обращается к сервису SIGEX от имени того пользователя, который запросил выполнение этого действия в ЭДО.
- Веб интерфейс информационной системы может взаимодействовать с SIGEX напрямую, а не через свой сервер, это может быть удобно для тех систем, которым не требуется проверять цифровые подписи под электронными документами - к примеру системы обмена сообщениями или CRM системы могут отображать контекстную информацию о документах подписанных цифровой подписью.
- Информационные системы могут внедрять аутентификацию по цифровым сертификатам (к примеру вход в личный кабинет пользователя по цифровому сертификату) используя данный механизм аутентификации в режиме *внешней аутентификации*, преимущества такого подхода:
  - регистрация новых пользователей не обязательна, они могут сразу входить в систему;
  - идентификация пользователей по ИИН;
  - при необходимости привязка к БИН;
  - простая реализация минимизирует вероятность обнаружения уязвимостей.

Аутентификация пользователей по цифровым сертификатам основана на подписании пользователем блока случайных данных (*nonce*) и последующей проверке этой подписи. В том случае, если подпись верна, сервис может быть уверен в том, что пользователь обладает закрытым ключом соответствующим открытому ключу в сертификате (регистрационном свидетельстве).

За данный режим аутентификации отвечают следующие API:
- [`POST` `/api/auth` - аутентификация, подготовительный этап - получение блока случайных данных](/support/developers/api-auth/index.md#auth-init)
- [`POST` `/api/auth` - аутентификация](/support/developers/api-auth/index.md#auth)
- [`POST` `/api/auth` - сброс аутентификации](/support/developers/api-auth/index.md#auth-reset) - не используется в режиме *внешней аутентификации*
- [`GET` `/api/auth` - текущее состояние аутентификации](/support/developers/api-auth/index.md#auth-status) - не используется в режиме *внешней аутентификации*

Отличительной особенностью режима *внешней аутентификации* является то, что в этом режиме сервис SIGEX не устанавливает в своих ответах *cookie* с *JWT* токенами содержащими информацию о пользователе прошедшем аутентификацию. Детали приведены в [`POST` `/api/auth` - аутентификация](/support/developers/api-auth/index.md#auth).

Вводная статья [Аутентификация по цифровым сертификатам](/blog/authentication/) описывает процесс интеграции аутентификации в информационные системы в режиме *внешней аутентификации*.


## Аутентификация информационных систем двусторонним mTLS {#system-authentication}
Этот способ аутентификации подходит для тех сценариев, когда действия должны выполняться не от имени определенных пользователей, а от имени информационной системы, к примеру:
- автоматизированный экспорт подписей из SIGEX в локальную БД;
- анализ и построение отчетов о документах организации;
- построение отчетов о действиях сотрудников организации (кто что и когда подписывал).

В случае использования этого механизма, с точки зрения SIGEX информационная система будет действовать от имени организации, а не какого-то определенного ее представителя.

Данный механизм аутентификации доступен на отдельном порту [https://sigex.kz:10443](https://sigex.kz:10443) и требует предоставления клиентского сертификата [https://ru.wikipedia.org/wiki/HTTPS#Идентификация_клиента](https://ru.wikipedia.org/wiki/HTTPS#%D0%98%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D1%8F_%D0%BA%D0%BB%D0%B8%D0%B5%D0%BD%D1%82%D0%B0). Практически все API, доступные на стандартном порту [https://sigex.kz](https://sigex.kz), без изменений доступны и тут. Исключение составляют API аутентификации по цифровым сертификатам, тут они не работают.

**Важный нюанс:** реализация данного механизма аутентификации основана на сертификатах только по той причине, что в mTLS не предусмотрено аутентификации по открытым ключам, фактически сервис анализирует только открытый ключ содержащийся в сертификате, остальные поля не учитываются.

Для того, чтобы использовать аутентификацию информационных систем двусторонним mTLS необходимо:
- *опционально* самостоятельно сгенерировать клиентский mTLS сертификат для информационной системы (это можно сделать автоматически в следующем пункте);
- добавить сертификат информационной системы в настройках организации в необходимые этой информационной системе списки контроля доступа;
- на сервере информационной системы в качестве URL для доступа к API SIGEX использовать [https://sigex.kz:10443](https://sigex.kz:10443);
- настроить использование двустороннего mTLS при взаимодействии с API SIGEX на сервере информационной системы с использованием указанного ранее сертификата и соответствующего закрытого ключа.

Поддерживаемые протоколы:
- `TLS 1.3`.

Допустимые длины ключей:
- `RSA` не короче `2048` бит;
- `ECDSA` не короче `224` бит.


## Контроль доступа {#access-control}
Полномочия первого руководителя **всегда** присутствуют во всех блоках контроля доступа настроек организации ([`POST` `/api/organizationSettings` - сохранить настройки организации](/support/developers/api-settings/index.md#organization-settings-apply)). Таким образом первый руководитель всегда имеет доступ к документам, пакетам документов и настройкам организации.

### Просмотр информации о документе и настроек документа {#access-control-document-access}
Документ может быть публично доступным, либо с ограниченным доступом, это определяет параметр `private` в настройках документа (см. [`POST` `/api/{id}/settings` - изменение настроек документа](/support/developers/api-documents/index.md#document-settings)).

<div class="table-responsive-md">
  <table class="table table-bordered">
  <thead>
    <tr>
      <th scope="col">Аутентификация была выполнена:</th>
      
        <th class="text-center" scope="col">Без аутентификации</th>
      
        <th class="text-center" scope="col">Физическим лицом (ИИН)</th>
      
        <th class="text-center" scope="col">Сотрудником юридического лица (ИИН + БИН + полномочие)</th>
      
        <th class="text-center" scope="col">Информационной системой юридического лица (БИН)</th>
      
    </tr>
  </thead>

  <thead>
    <tr>
      <th scope="col">Документ отвечает следующим требованиям:</th>
      
    </tr>
  </thead>


  <tbody>
    <tr>
      <th scope="col">Публично доступный документ</th>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
    </tr>


    <tr>
      <th scope="col">Документ с ограниченным доступом который не попадает под описанные ниже ситуации (не совпадает ни ИИН ни БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом подписан этим физическим лицом (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом подписан этим сотрудником этого юридического лица (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом подписан каким-то сотрудником этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsAccess</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsAccess</code>
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом зарегистрирован информационной системой этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsAccess</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsAccess</code>
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом, в настройках документа в <code>documentAccess</code> указан ИИН (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом, в настройках документа в <code>documentAccess</code> указан ИИН и БИН (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом, в настройках документа в <code>documentAccess</code> указан БИН (совпадает БИН), может быть указан ИИН, но не совпадает</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsAccess</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsAccess</code>
          
        </td>
      
    </tr>

  </tbody>

</table>
</div>

### Получение подписанных данных документа из архива или временного хранилища {#access-control-document-access-archive}
Доступ к подписанным данным документа предоставляется аналогично доступу к информации о документе, но с ограничением - он возможен только аутентифицированным пользователям и информационным системам (за исключением специального режима активируемого с помощью `publicDuringPreregistration` и `publicWhileLessThanSignatures`, в этом случае аутентификация не требуется).

<div class="table-responsive-md">
  <table class="table table-bordered">
  <thead>
    <tr>
      <th scope="col">Аутентификация была выполнена:</th>
      
        <th class="text-center" scope="col">Без аутентификации</th>
      
        <th class="text-center" scope="col">Физическим лицом (ИИН)</th>
      
        <th class="text-center" scope="col">Сотрудником юридического лица (ИИН + БИН + полномочие)</th>
      
        <th class="text-center" scope="col">Информационной системой юридического лица (БИН)</th>
      
    </tr>
  </thead>

  <thead>
    <tr>
      <th scope="col">Документ отвечает следующим требованиям:</th>
      
    </tr>
  </thead>


  <tbody>
    <tr>
      <th scope="col">Публично доступный документ</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
    </tr>


    <tr>
      <th scope="col">Документ с ограниченным доступом который не попадает под описанные ниже ситуации (не совпадает ни ИИН ни БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом подписан этим физическим лицом (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом подписан этим сотрудником этого юридического лица (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом подписан каким-то сотрудником этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsAccess</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsAccess</code>
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом зарегистрирован информационной системой этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsAccess</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsAccess</code>
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом, в настройках документа в <code>documentAccess</code> указан ИИН (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом, в настройках документа в <code>documentAccess</code> указан ИИН и БИН (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ с ограниченным доступом, в настройках документа в <code>documentAccess</code> указан БИН (совпадает БИН), может быть указан ИИН, но не совпадает</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsAccess</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsAccess</code>
          
        </td>
      
    </tr>
  </tbody>

</table>
</div>

В том случае, если **документ был предрегистрирован** и флаг `publicDuringPreregistration` был установлен в `true`, то доступ к подписываемым данным может получить **любой кто знает идентификатор документа** до тех пор **пока под ним не будет зарегистрирована первая подпись**. После регистрации первой подписи он будет обрабатываться как обычный документ.

Аналогичный режим работает в том случае, если для `publicWhileLessThanSignatures` установлено значение больше нуля не зависимо от того, была выполнена регистрация или предрегистрация.

### Изменение настроек документа {#access-control-document-settings}
<div class="table-responsive-md">
  <table class="table table-bordered">
  <thead>
    <tr>
      <th scope="col">Аутентификация была выполнена:</th>
      
        <th class="text-center" scope="col">Без аутентификации</th>
      
        <th class="text-center" scope="col">Физическим лицом (ИИН)</th>
      
        <th class="text-center" scope="col">Сотрудником юридического лица (ИИН + БИН + полномочие)</th>
      
        <th class="text-center" scope="col">Информационной системой юридического лица (БИН)</th>
      
    </tr>
  </thead>

  <thead>
    <tr>
      <th scope="col">Документ отвечает следующим требованиям:</th>
      
    </tr>
  </thead>


  <tbody>
    <tr>
      <th scope="col">Документ не попадает под описанные ниже ситуации (не совпадает ни ИИН ни БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ подписан этим физическим лицом (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ подписан этим сотрудником этого юридического лица (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ подписан каким-то сотрудником этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsSettings</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsSettings</code>
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ зарегистрирован информационной системой этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsSettings</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsSettings</code>
          
        </td>
      
    </tr>

  </tbody>

</table>
</div>

### Перечисление документов {#access-control-document-list}
API перечисления документов ([`GET` `/api?from=xxx&until=yyy&organization=true&dataArchived=true&searchQuery=search+string&includeSignatures=false` - перечисление документов аутентифицированного пользователя или системы](/support/developers/api-documents/index.md#documents-search)) с помощью параметра `organization` позволяет указывать какие документы следует перечислять:
- **Документы пользователя** (их возможно перечислять после прохождения аутентификации по сертификату физического, либо юридического лица) - это документы, подписанные пользователем, как физическим лицом, либо представителем юридического лица.
- **Документы юридического лица** (их возможно перечислять после прохождения аутентификации по сертификату юридического лица, либо информационной системой по двустороннему mTLS) - это документы, подписанные сотрудниками той же организации, что пользователь или информационная система, а так же зарегистрированные информационными системами этой же организации.

Во втором случае следует установить `organization=true` в запросе.

Перечисление **документов пользователя**:
<div class="table-responsive-md">
  <table class="table table-bordered">
  <thead>
    <tr>
      <th scope="col">Аутентификация была выполнена:</th>
      
        <th class="text-center" scope="col">Без аутентификации</th>
      
        <th class="text-center" scope="col">Физическим лицом (ИИН)</th>
      
        <th class="text-center" scope="col">Сотрудником юридического лица (ИИН + БИН + полномочие)</th>
      
        <th class="text-center" scope="col">Информационной системой юридического лица (БИН)</th>
      
    </tr>
  </thead>

  <thead>
    <tr>
      <th scope="col">Типы документов которые будут перечислены:</th>
      
    </tr>
  </thead>


  <tbody>
    <tr>
      <th scope="col">Документ не попадает под описанные ниже ситуации (не совпадает ни ИИН ни БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ подписан этим физическим лицом (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ подписан этим сотрудником этого юридического лица (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ подписан каким-то сотрудником этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ зарегистрирован информационной системой этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

  </tbody>

</table>
</div>

Перечисление **документов юридического лица**:
<div class="table-responsive-md">
  <table class="table table-bordered">
  <thead>
    <tr>
      <th scope="col">Аутентификация была выполнена:</th>
      
        <th class="text-center" scope="col">Без аутентификации</th>
      
        <th class="text-center" scope="col">Физическим лицом (ИИН)</th>
      
        <th class="text-center" scope="col">Сотрудником юридического лица (ИИН + БИН + полномочие)</th>
      
        <th class="text-center" scope="col">Информационной системой юридического лица (БИН)</th>
      
    </tr>
  </thead>

  <thead>
    <tr>
      <th scope="col">Типы документов которые будут перечислены:</th>
      
    </tr>
  </thead>


  <tbody>
    <tr>
      <th scope="col">Документ не попадает под описанные ниже ситуации (не совпадает ни ИИН ни БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ подписан этим физическим лицом (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ подписан этим сотрудником этого юридического лица (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsList</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsList</code>
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ подписан каким-то сотрудником этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsList</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsList</code>
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Документ зарегистрирован информационной системой этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>documentsList</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>documentsList</code>
          
        </td>
      
    </tr>

  </tbody>

</table>
</div>

### Просмотр информации о пакете документов и его настроек {#access-control-package-access}
Пакет документов может быть публично доступным, либо с ограниченным доступом, это определяет параметр `private` в настройках пакета документов (см. [`POST` `/api/package/{packageId}/settings` - изменение настроек пакета документов](/support/developers/api-packages/index.md#package-settings)).

<div class="table-responsive-md">
  <table class="table table-bordered">
  <thead>
    <tr>
      <th scope="col">Аутентификация была выполнена:</th>
      
        <th class="text-center" scope="col">Без аутентификации</th>
      
        <th class="text-center" scope="col">Физическим лицом (ИИН)</th>
      
        <th class="text-center" scope="col">Сотрудником юридического лица (ИИН + БИН + полномочие)</th>
      
        <th class="text-center" scope="col">Информационной системой юридического лица (БИН)</th>
      
    </tr>
  </thead>

  <thead>
    <tr>
      <th scope="col">Пакет документов отвечает следующим требованиям:</th>
      
    </tr>
  </thead>


  <tbody>
    <tr>
      <th scope="col">Публично доступный</th>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
    </tr>


    <tr>
      <th scope="col">С ограниченным доступом который не попадает под описанные ниже ситуации (не совпадает ни ИИН ни БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">С ограниченным доступом, зарегистрирован информационной системой этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>packagesAccess</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>packagesAccess</code>
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">С ограниченным доступом, в его настройках в <code>packageAccess</code> указан ИИН (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">С ограниченным доступом, в его настройках в <code>packageAccess</code> указан ИИН и БИН (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">С ограниченным доступом, в его настройках в <code>packageAccess</code> указан БИН (совпадает БИН), может быть указан ИИН, но не совпадает</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>packagesAccess</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>packagesAccess</code>
          
        </td>
      
    </tr>

  </tbody>

</table>
</div>

### Изменение настроек пакета документов {#access-control-package-settings}
<div class="table-responsive-md">
  <table class="table table-bordered">
  <thead>
    <tr>
      <th scope="col">Аутентификация была выполнена:</th>
      
        <th class="text-center" scope="col">Без аутентификации</th>
      
        <th class="text-center" scope="col">Физическим лицом (ИИН)</th>
      
        <th class="text-center" scope="col">Сотрудником юридического лица (ИИН + БИН + полномочие)</th>
      
        <th class="text-center" scope="col">Информационной системой юридического лица (БИН)</th>
      
    </tr>
  </thead>

  <thead>
    <tr>
      <th scope="col">Пакет документов отвечает следующим требованиям:</th>
      
    </tr>
  </thead>


  <tbody>
    <tr>
      <th scope="col">Не попадает под описанные ниже ситуации (не совпадает ни ИИН ни БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Зарегистрирован информационной системой этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>packagesSettings</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>packagesSettings</code>
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">В настройках пакета документов в <code>packageSettings</code> указан ИИН (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">В настройках пакета документов в <code>packageSettings</code> указан ИИН и БИН (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">В настройках пакета документов в <code>packageSettings</code> указан БИН (совпадает БИН), может быть указан ИИН, но не совпадает</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>packagesSettings</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>packagesSettings</code>
          
        </td>
      
    </tr>

  </tbody>

</table>
</div>

### Перечисление пакетов документов {#access-control-package-list}
API перечисления пакетов документов ([`GET` `/api/package?from=xxx&until=yyy&organization=true` - перечисление пакетов документов аутентифицированного пользователя или системы](/support/developers/api-packages/index.md#package-search)) с помощью параметра `organization` позволяет указывать какие пакеты документов следует перечислять:
- **Пакеты документов пользователя** (их возможно перечислять после прохождения аутентификации по сертификату физического, либо юридического лица) - это пакеты документов в настройках которых пользователь указан в `packageAccess` как физическое лицо или сотрудник юридического лица.
- **Пакеты документов юридического лица** (их возможно перечислять после прохождения аутентификации по сертификату юридического лица, либо информационной системой по двустороннему mTLS) - это пакеты документов в настроках которых в `packageAccess` указан БИН юридического лица, а так же зарегистрированные информационными системами этой же организации.

Во втором случае следует установить `organization=true` в запросе.

Перечисление **пакетов документов пользователя**:
<div class="table-responsive-md">
  <table class="table table-bordered">
  <thead>
    <tr>
      <th scope="col">Аутентификация была выполнена:</th>
      
        <th class="text-center" scope="col">Без аутентификации</th>
      
        <th class="text-center" scope="col">Физическим лицом (ИИН)</th>
      
        <th class="text-center" scope="col">Сотрудником юридического лица (ИИН + БИН + полномочие)</th>
      
        <th class="text-center" scope="col">Информационной системой юридического лица (БИН)</th>
      
    </tr>
  </thead>

  <thead>
    <tr>
      <th scope="col">Типы пакетов документов которые будут перечислены:</th>
      
    </tr>
  </thead>


  <tbody>
    <tr>
      <th scope="col">Пакет документов не попадает под описанные ниже ситуации (не совпадает ни ИИН ни БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Пакет документов зарегистрирован информационной системой этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">В настройках пакета документов в <code>packageAccess</code> указан ИИН (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">В настройках пакета документов в <code>packageAccess</code> указан ИИН и БИН (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">В настройках пакета документов в <code>packageAccess</code> указан БИН (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

  </tbody>

</table>
</div>

Перечисление **пакетов документов юридического лица**:
<div class="table-responsive-md">
  <table class="table table-bordered">
  <thead>
    <tr>
      <th scope="col">Аутентификация была выполнена:</th>
      
        <th class="text-center" scope="col">Без аутентификации</th>
      
        <th class="text-center" scope="col">Физическим лицом (ИИН)</th>
      
        <th class="text-center" scope="col">Сотрудником юридического лица (ИИН + БИН + полномочие)</th>
      
        <th class="text-center" scope="col">Информационной системой юридического лица (БИН)</th>
      
    </tr>
  </thead>

  <thead>
    <tr>
      <th scope="col">Типы пакетов документов которые будут перечислены:</th>
      
    </tr>
  </thead>


  <tbody>
    <tr>
      <th scope="col">Пакет документов не попадает под описанные ниже ситуации (не совпадает ни ИИН ни БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">Пакет документов зарегистрирован информационной системой этого юридического лица (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>packagesList</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>packagesList</code>
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">В настройках пакета документов в <code>packageAccess</code> указан ИИН (совпадает ИИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">В настройках пакета документов в <code>packageAccess</code> указан ИИН и БИН (совпадают ИИН и БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            <i class="fas fa-check text-success"></i>
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
    </tr>

    <tr>
      <th scope="col">В настройках пакета документов в <code>packageAccess</code> указан БИН (совпадает БИН)</th>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            
          
        </td>
      
        <td class="text-center">
          
            сотрудник является <strong>первым руководителем</strong>, либо в настройках его организации его <strong>ИИН</strong> или его <strong>полномочия</strong> указаны в <code>packagesList</code>
          
        </td>
      
        <td class="text-center">
          
            в настройках организации mTLS сертификат системы не отключен и указан в блоке <code>packagesList</code>
          
        </td>
      
    </tr>

  </tbody>

</table>
</div>

### Просмотр/изменение настроек организации {#access-control-organization-settings}
Просматривать и изменять настройки организации могут:
- в том случае, если выполнена аутентификация по сертификату **сотрудника юридического лица**, то в этом сертификате должно присутствовать полномочие приведенное в блоке `organizationSettings` настроек этой организации ([`POST` `/api/organizationSettings` - сохранить настройки организации](/support/developers/api-settings/index.md#organization-settings-apply)), либо ИИН в сертификате должен совпадать с одним из указанных в блоке `organizationSettings`;
- в том случае, если выполнена аутентификация информационных систем двусторонним mTLS, то сертификат использованный при аутентификации должен быть указан в блоке `organizationSettings` настроек этой организации ([`POST` `/api/organizationSettings` - сохранить настройки организации](/support/developers/api-settings/index.md#organization-settings-apply)).

### Просмотр/изменение настроек пользователя {#access-control-user-settings}
Просматривать и изменять свои настройки может пользователь, выполнивший аутентификацию как по сертификату физического лица, так и сотрудника юридического лица.

### Отправка Исходящих и комментирование Входящих/Исходящих от имени физического лица {#access-control-routing-acctions-user}
Пользователи могут отправлять от своего имени Исходящие выполнив аутентификацию по сертификату физического лица. Так же выполнив аутентификацию по сертификату физического лица они могут комментировать от своего имени Входящие и Исходящие.

### Перечисление Входящих/Исходящих физического лица {#access-control-incoming-outgoing-list-user}
Пользователи могут перечислять свои Входящие ([`GET` `/api/incoming?from=xxx&until=yyy` - получение списка входящих документов и пакетов документов](/support/developers/api-incoming-outgoing/index.md#incoming-list)) и Исходящие ([`GET` `/api/outgoing?from=xxx&until=yyy` - получение списка исходящих документов и пакетов документов](/support/developers/api-incoming-outgoing/index.md#outgoing-list)) выполнив аутентификацию по сертификату физического лица.

### Отправка Исходящих и комментирование Входящих/Исходящих от имени юридического лица {#access-control-routing-acctions-organization}
Отправлять документы и комментировать Входящие и Исходящие от имени организации могут:
- в том случае, если выполнена аутентификация по сертификату **сотрудника юридического лица**, то в этом сертификате должно присутствовать полномочие приведенное в блоке `documentsPackagesRoute` настроек этой организации ([`POST` `/api/organizationSettings` - сохранить настройки организации](/support/developers/api-settings/index.md#organization-settings-apply)), либо ИИН в сертификате должен совпадать с одним из указанных в блоке `documentsPackagesRoute`;
- в том случае, если выполнена аутентификация информационных систем двусторонним mTLS, то сертификат использованный при аутентификации должен быть указан в блоке `documentsPackagesRoute` настроек этой организации ([`POST` `/api/organizationSettings` - сохранить настройки организации](/support/developers/api-settings/index.md#organization-settings-apply)).

### Перечисление Входящих/Исходящих юридического лица {#access-control-incoming-outgoing-list-organization}
Перечислять Входящие ([`GET` `/api/incoming?from=xxx&until=yyy` - получение списка входящих документов и пакетов документов](/support/developers/api-incoming-outgoing/index.md#incoming-list)) и Исходящие ([`GET` `/api/outgoing?from=xxx&until=yyy` - получение списка исходящих документов и пакетов документов](/support/developers/api-incoming-outgoing/index.md#outgoing-list)) организации могут:
- в том случае, если выполнена аутентификация по сертификату **сотрудника юридического лица**, то в этом сертификате должно присутствовать полномочие приведенное в блоке `routedDocumentsPackagesView` настроек этой организации ([`POST` `/api/organizationSettings` - сохранить настройки организации](/support/developers/api-settings/index.md#organization-settings-apply)), либо ИИН в сертификате должен совпадать с одним из указанных в блоке `routedDocumentsPackagesView`;
- в том случае, если выполнена аутентификация информационных систем двусторонним mTLS, то сертификат использованный при аутентификации должен быть указан в блоке `routedDocumentsPackagesView` настроек этой организации ([`POST` `/api/organizationSettings` - сохранить настройки организации](/support/developers/api-settings/index.md#organization-settings-apply)).