--- title: Installation description: Konfigurieren Sie die CSP, installieren Sie das Web SDK-Paket und laden Sie die für die Lebenderkennung erforderlichen Ressourcendateien herunter. canonical: https://developer.unico.io/de/dual-api/developers/sdks-and-tools/web/web-sdk/installation/ locale: de generated_by: markdown-export --- ## Abhängigkeit hinzufügen und Paketmanager konfigurieren ****Schritt 1** — Content Security Policy (CSP) konfigurieren** Das Web SDK verwendet Web Workers für Sicherheit und Performance. Fügen Sie die folgende Konfiguration zu Ihrer CSP hinzu: ```html ``` :::warning Wenn Ihre Anwendung eine CSP hat, ist diese Konfiguration zwingend erforderlich, um die ordnungsgemäße Funktionsweise des SDK sicherzustellen. ::: :::info[Warum jede Direktive erforderlich ist] - **`'unsafe-eval'`** (script-src) — wird von der Lebenderkennung benötigt, um WebAssembly zu kompilieren und Sicherheitsroutinen zur Laufzeit dynamisch auszuwerten. - **`'unsafe-inline'`** (style-src, script-src-elem) — wird für die Inline-Stile und das Inline-Script-Bootstrapping des SDK benötigt. Ohne diese Direktive funktioniert die Aufnahmeoberfläche nicht. - **`*.acesso.io`** — Legacy-Infrastrukturdomäne von Unico, weiterhin erforderlich für Assets und API-Aufrufe. - **`*.unico.run` / `*.unico.io` / `*.unico.app`** — aktuelle Unico-Dienstdomänen (CDN, API und App-Subdomänen). - **`*.googleapis.com`** (script-src, style-src, script-src-elem, connect-src) — erforderlich, um das Google Fonts-Stylesheet (`@font-face`-CSS über `fonts.googleapis.com`) und andere Google-API-Ressourcen zu laden, die von der Capture-UI verwendet werden. - **`fonts.gstatic.com`** (font-src) — Stellt die binären Google-Fonts-Schriftdateien bereit, auf die das von `fonts.googleapis.com` geladene Stylesheet verweist. - **`*.sentry.io`** — Unico nutzt Sentry für das SDK-Fehlertracking. In `script-src` und `connect-src` erforderlich, um Fehlerberichtsaufrufe zu erlauben. - **`*.launchdarkly.com`** — Unico nutzt LaunchDarkly für die Feature-Flag-Auswertung, die das Verhalten des SDK steuert (z. B. die Auswahl der Kamera-Engine). In `script-src` und `connect-src` erforderlich, um das Streaming und die Auswertung von Flags zu erlauben. - **`*.newrelic.com` / `bam.nr-data.net`** — Unico nutzt New Relic Browser für das Performance-Monitoring des SDK. Erforderlich in `script-src` (Agent-Skript) und `connect-src` (Beacon-Aufrufe). - **`blob:`** (worker-src, child-src, script-src-elem) — erforderlich, da Web Workers und bestimmte SDK-Unterressourcen zur Laufzeit als Blob-URLs erstellt werden. ::: ****Schritt 2** — Paket installieren** Das Web SDK wird über ein npm-Paket oder CDN bereitgestellt. ### npm ```bash npm install unico-webframe ``` ### yarn ```bash yarn add unico-webframe ``` ### CDN Laden Sie das SDK herunter und importieren Sie es in Ihr Projekt: - [Version `3.23.7` herunterladen](https://cdn.unico.io/sdk/check/bio/unico-webframe-3.23.7.zip) ****Schritt 3** — SDK importieren** Importieren Sie das SDK nach der Installation in Ihr Projekt. ### Von npm ```javascript import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'unico-webframe' ``` ### Von CDN ```javascript import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'UnicoCheckBuilder.min.js' ``` ****Schritt 4** — Zusätzliche Ressourcendateien herunterladen** Zusätzliche Ressourcendateien sind für die Liveness-Erfassung erforderlich. Laden Sie die Datei passend zu Ihrer SDK-Version herunter und binden Sie sie in Ihr Projekt ein: :::warning[Upgrade-Checkliste] Die Ressourcendateien sind versionsgekoppelt an das SDK. Jedes Mal, wenn Sie `unico-webframe` aktualisieren, **müssen** Sie die passenden Ressourcen aus der folgenden Tabelle erneut herunterladen — bei nicht übereinstimmenden Versionen tritt zur Laufzeit ein Fehler bei der Liveness-Erfassung auf. **Alternativ** kann das SDK seit Version 3.18.0 diese Dateien beim Initialisieren automatisch abrufen, wodurch der manuelle Download entfällt. Weitere Informationen zur Option `setResourceDirectory` finden Sie unter [Initialisierung](/dual-api/developers/sdks-and-tools/web/web-sdk/initialization). ::: | SDK-Version | FaceTec-Ressourcen | |---|---| | 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 (siehe Legacy-Tabelle) | Laden Sie außerdem die **KI-Dateien** für das SDK herunter: [models.zip](https://cdn.unico.io/sdk/check/bio/models.zip). :::warning[Öffentlicher Pfad] Alle zusätzlichen Dateien müssen an einem öffentlich zugänglichen Ort gehostet werden, der für das Web innerhalb Ihres Projekts sichtbar ist. :::