Installation

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 :

<meta
  http-equiv="Content-Security-Policy"
  content="
      script-src 'self' 'unsafe-eval' *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app *.sentry.io;
      worker-src 'self' blob:;
      child-src 'self' blob:;
      style-src 'self' 'unsafe-inline' *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app;
      font-src 'self' https://fonts.gstatic.com *.acesso.io *.unico.run *.unico.io *.unico.app;
      img-src 'self' data: blob: *.acesso.io *.unico.run *.unico.io *.unico.app;
      media-src 'self' data: *.acesso.io *.unico.run *.unico.io *.unico.app;
      script-src-elem 'self' 'unsafe-inline' blob: *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app;
      connect-src *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app *.sentry.io"
/>

avertissement

Si votre application possède une CSP, cette configuration est obligatoire pour garantir le bon fonctionnement du SDK.

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.
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
yarn
CDN

npm install unico-webframe

yarn add unico-webframe

Téléchargez le SDK et importez-le dans votre projet :

Télécharger la version 3.23.7

Étape 3 — Importer le SDK

Après l'installation, importez le SDK dans votre projet.

Depuis npm
Depuis CDN

import {
  UnicoCheckBuilder,
  SelfieCameraTypes,
  UnicoThemeBuilder,
  DocumentCameraTypes,
  UnicoConfig,
  LocaleTypes
} from 'unico-webframe'

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 :

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 pour l'option setResourceDirectory.

Version du SDK	Ressources FaceTec
3.23.7	9.7.114
3.23.3 → 3.23.6	9.7.107
3.23.0 → 3.23.1	9.7.102
3.22.6 → 3.22.7	9.7.100
3.22.5	9.7.99
3.22.3 → 3.22.4	9.7.98
3.22.2	9.7.96
3.22.1	9.7.93
3.22.0	9.7.90
3.21.3 → 3.21.4	9.7.85
3.21.2	9.7.82
3.21.1	9.7.80
3.20.10 → 3.21.0	9.7.76
3.20.9	9.7.75
3.20.8	9.7.73
3.20.7	9.7.68
3.20.5 → 3.20.6	9.7.65
3.20.3 → 3.20.4	9.7.64
3.20.2	9.7.63
3.20.1	9.7.61
3.20.0	9.7.55
3.19.0 → 3.19.3	9.7.45 → 9.7.51
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.

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.