# Обновление ПО в соответствии с новыми требованиями регулятора в Казахстане

## Общая информация <a href="#obshaya-informaciya" id="obshaya-informaciya"></a>

С 1 января 2025 года вступает в силу Постановление Правления Агентства Республики Казахстан по регулированию и развитию финансового рынка от 16 августа 2024 года № 56 «Об утверждении Правил проведения биометрической идентификации банками, организациями, осуществляющими отдельные виды банковских услуг, и микрофинансовыми организациями» (далее – **Постановление**).

Чтобы наше ПО соответствовало требованиям Постановления, мы добавили новый способ проверки биометрических данных: комплексную проверку. В ходе нее система сличает эталонное фото человека, который проходит идентификацию, со снятыми видеороликами, на которых этот человек делает три разных жеста (пункт 6 Постановления), причём каждому жесту соответствует одно видео. По результатам комплексной проверки можно сформировать отчет, в котором, согласно пунктам 9 и 13, будут содержаться:

* Результат проверки,
* ИИН пользователя, прошедшего проверку,
* Изображение с лицом пользователя,
* Набор изображений, соответствующих проделанным пользователем жестам,
* Реквизиты компании-заказчика проверки,
* Дата и время проведения проверки.

Обратите внимание: дополнительные проверки на сервере увеличивают требования к мощностям и влияют на время выполнения анализов.

## Требования <a href="#trebovaniya" id="trebovaniya"></a>

Минимальные версии ПО:

* API – 5.3.1,
* Web SDK – 1.6.15,
* Web UI - 1.3.4,
* Mobile SDK (iOS, Android, Flutter) – 8.14.

Комплексная проверка работает только в режиме анализа «На сервере».

## Настройка SDK <a href="#nastroika-sdk" id="nastroika-sdk"></a>

Для соответствия требованиям **Постановления** вам потребуется:

1. Включить сохранение кадров из видеороликов с жестами пользователя с помощью параметра `extract_action_shot`.
2. При создании заявки (папки) передать дополнительные параметры:
   * `iin` – ИИН пользователя,
   * `company_details` – информацию о компании.

&#x20;Эти данные потом попадают в отчет.

Ниже вы найдете инструкции по передаче/включению параметров для Web и Mobile SDK.

### Web SDK <a href="#web-sdk" id="web-sdk"></a>

1. Для Web SDK в [настройках файла конфигурации Web Adapter](https://doc.ozforensics.com/oz-knowledge/guides/administrator-guide/web-adapter/configuration-file-settings) установите параметру `extract_action_shot` значение `True`.
2. При запуске плагина укажите параметры `iin` и `company_details` в поле `meta`:

```javascript
OzLiveness.open({
...
  meta: { 
    ...
    // ИИН вашего клиента
    'iin': '<your_client_iin>',
    // реквизиты вашей компании: название, БИН, контакты и т.д.
    // для переноса строки используйте \n
    'company_details': '<your_company_details>',
  },
...
});
```

### Mobile SDK <a href="#mobile-sdk" id="mobile-sdk"></a>

1. В мобильных SDK добавьте параметр `extract_action_shot` со значением `true` в `params` (iOS) /`analysisParams` (Android) структуры `Analysis` при выполнении анализа:

#### iOS

```
Analysis.init(media: results,
 type: .quality,
 mode: .serverBased,
 params: ["extract_best_shot" : true, "extract_action_shot": true])
```

#### Android <a href="#android" id="android"></a>

```
val analysisParams = mapOf(
    "extract_best_shot" to true,
    "extract_action_shot" to true
)
AnalysisScenario.Liveness
 -> addAnalysis(
  Analysis(
    Analysis.Type.QUALITY,
    analysisMode,
    media,
    analysisParams, 
    sizeReductionStrategy
  )
 )
```

2. Передайте параметры `iin` и `company_details` в метаданные папки. При загрузке медиафайлов через SDK используйте метод `addFolderMeta`.

**iOS**

```swift
let analysis = Analysis.init(media: mediaToAnalyze, type: .quality, mode: .serverBased)
// iin - ИИН вашего клиента, company_details - реквизиты вашей компании: название, БИН, контакты и т.д.
// для переноса строки используйте \n
var folderMeta: [String: Any] = ["iin": "<your_client_iin>", "company_details": "<your_company_details>"]
analysisRequest.addFolderMeta(folderMeta)
```

**Android**

```kotlin
analysisCancelable = AnalysisRequest.Builder()
    .addAnalysis(
        Analysis(
            Analysis.Type.QUALITY,
            Analysis.Mode.SERVER_BASED,
            mediaToAnalyze
        )
    )
// iin - ИИН вашего клиента, company_details - реквизиты вашей компании: название, БИН, контакты и т.д.
// для переноса строки используйте \n
    .addFolderMeta(
        mapOf(
            "iin" to "<your_client_iin>",
            "company_details" to "<your_company_details>"
        )
    .build()
    )
```

3. Если вы загружаете медиафайлы без участия нашего SDK, передайте ИИН пользователя и реквизиты компании с помощью поля `folderMeta` метода `generateSignedPayload`.

**iOS**

```swift
// iin - ИИН вашего клиента, company_details - реквизиты вашей компании: название, БИН, контакты и т.д.
// для переноса строки используйте \n
var folderMeta: [String: Any] = ["iin": "<your_client_iin>", "company_details": "<your_company_details>"]
let payload = OZSDK.generateSignedPayload(media: [OZMedia], folderMeta)
```

**Android**

```kotlin
// iin - ИИН вашего клиента, company_details - реквизиты вашей компании: название, БИН, контакты и т.д.
// для переноса строки используйте \n
val folderMeta = mapOf(
            "iin" to "<your_client_iin>",
            "company_details" to "<your_company_details>"
            )
val payload = OzLivenessSDK.generateSignedPayload(media, folderMeta)
```

## Отчет <a href="#otchet" id="otchet"></a>

Если все передано правильно, по результатам проверки можно будет сгенерировать отчет через Web UI (кнопка PDF в заявке) или API (`POST /api/folders/{{folder_id}}/reports/`). На титульной странице отчета будут ваши реквизиты и дата и время прохождения проверки. Далее – идентификатор папки, ИИН пользователя, который проходил проверку, информация о видеофайлах, результаты анализов, а также кадры для каждого жеста, который выполнял пользователь. Таким образом, все требования Постановления будут выполнены.

Если у вас остались вопросы, пожалуйста, [обращайтесь](mailto:info@ozforensics.com).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.ozforensics.com/oz-knowledge-ru/other/obnovlenie-po-v-sootvetstvii-s-novymi-trebovaniyami-regulyatora-v-kazakhstane.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.