--- title: Установка description: Настройте CSP, установите пакет Web SDK и загрузите файлы ресурсов, необходимые для функции «Проверка живости». canonical: https://developer.unico.io/ru/dual-api/developers/sdks-and-tools/web/web-sdk/installation/ locale: ru generated_by: markdown-export --- ## Добавьте зависимость и настройте менеджер пакетов ****Шаг 1** — Настройте Content Security Policy (CSP)** Web SDK использует Web Workers для обеспечения безопасности и производительности. Добавьте следующую конфигурацию в ваш CSP: ```html ``` :::warning Если ваше приложение использует CSP, эта конфигурация обязательна для корректной работы SDK. ::: :::info[Почему каждая директива необходима] - **`'unsafe-eval'`** (script-src) — требуется движку обнаружения живости для компиляции WebAssembly и динамической оценки своих процедур безопасности во время выполнения. - **`'unsafe-inline'`** (style-src, script-src-elem) — требуется для встроенных стилей SDK и начальной загрузки встроенных скриптов. Удаление этой директивы нарушает работу интерфейса захвата. - **`*.acesso.io`** — устаревший домен инфраструктуры Unico, по-прежнему необходимый для ресурсов и вызовов API. - **`*.unico.run` / `*.unico.io` / `*.unico.app`** — текущие сервисные домены Unico (CDN, API и поддомены приложений). - **`*.googleapis.com`** (script-src, style-src, script-src-elem, connect-src) — необходимо для загрузки таблицы стилей Google Fonts (CSS `@font-face` через `fonts.googleapis.com`) и других ресурсов Google API, используемых в интерфейсе захвата. - **`fonts.gstatic.com`** (font-src) — Предоставляет двоичные файлы шрифтов Google Fonts, на которые ссылается таблица стилей, загружаемая с `fonts.googleapis.com`. - **`*.sentry.io`** — Unico использует Sentry для отслеживания ошибок SDK. Требуется в `script-src` и `connect-src` для разрешения вызовов отчётов об ошибках. - **`*.launchdarkly.com`** — Unico использует LaunchDarkly для оценки feature flag, управляющих поведением SDK (например, выбором движка камеры). Требуется в `script-src` и `connect-src` для разрешения потоковой передачи и оценки флагов. - **`*.newrelic.com` / `bam.nr-data.net`** — Unico использует New Relic Browser для мониторинга производительности SDK. Требуется в `script-src` (скрипт агента) и `connect-src` (вызовы beacon). - **`blob:`** (worker-src, child-src, script-src-elem) — требуется, поскольку Web Workers и определённые подресурсы SDK создаются как Blob URL во время выполнения. ::: ****Шаг 2** — Установите пакет** Web SDK доступен через пакет npm или CDN. ### npm ```bash npm install unico-webframe ``` ### yarn ```bash yarn add unico-webframe ``` ### CDN Скачайте SDK и импортируйте его в свой проект: - [Скачать версию `3.23.7`](https://cdn.unico.io/sdk/check/bio/unico-webframe-3.23.7.zip) ****Шаг 3** — Импортируйте SDK** После установки импортируйте SDK в свой проект. ### Из npm ```javascript import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'unico-webframe' ``` ### Из CDN ```javascript import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'UnicoCheckBuilder.min.js' ``` ****Шаг 4** — Загрузите дополнительные файлы ресурсов** Для выполнения захвата Liveness необходимы дополнительные файлы ресурсов. Загрузите файл, соответствующий вашей версии SDK, и включите его в проект: :::warning[Контрольный список обновления] Файлы ресурсов привязаны к версии SDK. При каждом обновлении `unico-webframe` **необходимо** повторно скачать соответствующие ресурсы из таблицы ниже — использование несовместимых версий вызывает ошибку времени выполнения при захвате Liveness. **В качестве альтернативы**, начиная с SDK 3.18.0, SDK может автоматически загружать эти файлы при инициализации, устраняя необходимость ручной загрузки. Информацию об опции `setResourceDirectory` см. в разделе [Инициализация](/dual-api/developers/sdks-and-tools/web/web-sdk/initialization). ::: | Версия SDK | Ресурсы FaceTec | |---|---| | 3.23.7 | [9.7.114](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.114/resources.zip) | | 3.23.3 → 3.23.6 | [9.7.107](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.107/resources.zip) | | 3.23.0 → 3.23.1 | [9.7.102](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.102/resources.zip) | | 3.22.6 → 3.22.7 | [9.7.100](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.100/resources.zip) | | 3.22.5 | [9.7.99](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.99/resources.zip) | | 3.22.3 → 3.22.4 | [9.7.98](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.98/resources.zip) | | 3.22.2 | [9.7.96](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.96/resources.zip) | | 3.22.1 | [9.7.93](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.93/resources.zip) | | 3.22.0 | [9.7.90](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.90/resources.zip) | | 3.21.3 → 3.21.4 | [9.7.85](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.85/resources.zip) | | 3.21.2 | [9.7.82](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.82/resources.zip) | | 3.21.1 | [9.7.80](https://cdn.unico.io/sdk/check/facetec/v2-browser-v9.7.80/resources.zip) | | 3.20.10 → 3.21.0 | [9.7.76](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.76/resources.zip) | | 3.20.9 | [9.7.75](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.75/resources.zip) | | 3.20.8 | [9.7.73](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.73/resources.zip) | | 3.20.7 | [9.7.68](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.68/resources.zip) | | 3.20.5 → 3.20.6 | [9.7.65](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.65/resources.zip) | | 3.20.3 → 3.20.4 | [9.7.64](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.64/resources.zip) | | 3.20.2 | [9.7.63](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.63/resources.zip) | | 3.20.1 | [9.7.61](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.61/resources.zip) | | 3.20.0 | [9.7.55](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.55/resources.zip) | | 3.19.0 → 3.19.3 | [9.7.45 → 9.7.51](https://cdn.unico.io/sdk/check/facetec/browser-v9.7.51/resources.zip) | | 3.18.x | 9.6.92 → 9.7.41 (см. устаревшую таблицу) | Также загрузите **файлы ИИ** для SDK: [models.zip](https://cdn.unico.io/sdk/check/bio/models.zip). :::warning[Публичный путь] Все дополнительные файлы должны быть размещены в публичном месте, доступном из браузера в рамках вашего проекта. :::