--- title: Installation description: Configurez la CSP, installez le package Web SDK et téléchargez les fichiers de ressources nécessaires à la capture Détection de Vie. canonical: https://developer.unico.io/fr/dual-api/developers/sdks-and-tools/web/web-sdk/installation/ locale: fr generated_by: markdown-export --- ## Ajouter la dépendance et configurer le gestionnaire de paquets ****Étape 1** — Configurer la Politique de Sécurité du Contenu (CSP)** Le Web SDK utilise des Web Workers pour la sécurité et les performances. Ajoutez la configuration suivante à votre CSP : ```html ``` :::warning Si votre application possède une CSP, cette configuration est obligatoire pour garantir le bon fonctionnement du SDK. ::: :::info[Pourquoi chaque directive est requise] - **`'unsafe-eval'`** (script-src) — requis par le moteur de détection de vivacité pour compiler WebAssembly et évaluer dynamiquement ses routines de sécurité à l'exécution. - **`'unsafe-inline'`** (style-src, script-src-elem) — requis pour les styles en ligne et le démarrage des scripts en ligne du SDK. Le supprimer casse l'interface de capture. - **`*.acesso.io`** — domaine d'infrastructure Unico hérité, toujours nécessaire pour les assets et les appels API. - **`*.unico.run` / `*.unico.io` / `*.unico.app`** — domaines de service Unico actuels (CDN, API et sous-domaines d'application). - **`*.googleapis.com`** (script-src, style-src, script-src-elem, connect-src) — requis pour charger la feuille de styles Google Fonts (CSS `@font-face` via `fonts.googleapis.com`) et autres ressources de l'API Google utilisées par l'interface de capture. - **`fonts.gstatic.com`** (font-src) — Fournit les fichiers binaires de polices Google Fonts référencés par la feuille de styles chargée depuis `fonts.googleapis.com`. - **`*.sentry.io`** — Unico utilise Sentry pour le suivi des erreurs du SDK. Requis dans `script-src` et `connect-src` pour autoriser les appels de rapport d'erreurs. - **`*.launchdarkly.com`** — Unico utilise LaunchDarkly pour l'évaluation des feature flags contrôlant le comportement du SDK (par exemple, la sélection du moteur de caméra). Requis dans `script-src` et `connect-src` pour autoriser le streaming et l'évaluation des flags. - **`*.newrelic.com` / `bam.nr-data.net`** — Unico utilise New Relic Browser pour la surveillance des performances du SDK. Requis dans `script-src` (script de l'agent) et `connect-src` (appels de beacon). - **`blob:`** (worker-src, child-src, script-src-elem) — requis car les Web Workers et certaines sous-ressources du SDK sont créés sous forme d'URL Blob à l'exécution. ::: ****Étape 2** — Installer le paquet** Le Web SDK est fourni via un paquet npm ou un CDN. ### npm ```bash npm install unico-webframe ``` ### yarn ```bash yarn add unico-webframe ``` ### CDN Téléchargez le SDK et importez-le dans votre projet : - [Télécharger la version `3.23.7`](https://cdn.unico.io/sdk/check/bio/unico-webframe-3.23.7.zip) ****Étape 3** — Importer le SDK** Après l'installation, importez le SDK dans votre projet. ### Depuis npm ```javascript import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'unico-webframe' ``` ### Depuis CDN ```javascript import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'UnicoCheckBuilder.min.js' ``` ****Étape 4** — Télécharger les fichiers de ressources supplémentaires** Des fichiers de ressources supplémentaires sont nécessaires pour effectuer la capture Liveness. Téléchargez le fichier correspondant à votre version du SDK et incluez-le dans votre projet : :::warning[Liste de vérification pour la mise à niveau] Les fichiers de ressources sont liés à la version du SDK. Chaque fois que vous mettez à jour `unico-webframe`, vous **devez** re-télécharger les ressources correspondantes depuis le tableau ci-dessous — l'utilisation de versions incompatibles provoque une erreur d'exécution lors de la capture Liveness. **Alternativement**, depuis le SDK 3.18.0, le SDK peut récupérer automatiquement ces fichiers à l'initialisation, éliminant ainsi l'étape de téléchargement manuel. Consultez [Initialisation](/dual-api/developers/sdks-and-tools/web/web-sdk/initialization) pour l'option `setResourceDirectory`. ::: | Version du SDK | Ressources 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 (voir tableau hérité) | Téléchargez également les **fichiers IA** pour le SDK : [models.zip](https://cdn.unico.io/sdk/check/bio/models.zip). :::warning[Chemin public] Tous les fichiers supplémentaires doivent être hébergés dans un emplacement public, visible sur le Web au sein de votre projet. :::