--- title: Instalação description: Configure a CSP, instale o pacote do Web SDK e baixe os arquivos de recursos necessários para a captura de Prova de Vida. canonical: https://developer.unico.io/pt-BR/dual-api/developers/sdks-and-tools/web/web-sdk/installation/ locale: pt-BR generated_by: markdown-export --- ## Adicionar a dependência e configurar o gerenciador de pacotes ****Passo 1** — Configurar a Política de Segurança de Conteúdo (CSP)** O Web SDK utiliza Web Workers para segurança e desempenho. Adicione a seguinte configuração à sua CSP: ```html ``` :::warning Se a sua aplicação possuir CSP, esta configuração é obrigatória para garantir o funcionamento correto do SDK. ::: :::info[Por que cada diretiva é necessária] - **`'unsafe-eval'`** (script-src) — necessário para o motor de detecção de vivacidade compilar WebAssembly e avaliar dinamicamente suas rotinas de segurança em tempo de execução. - **`'unsafe-inline'`** (style-src, script-src-elem) — necessário para os estilos inline e o bootstrapping de scripts inline do SDK. Removê-lo quebra a interface de captura. - **`*.acesso.io`** — domínio de infraestrutura legada da Unico, ainda necessário para assets e chamadas de API. - **`*.unico.run` / `*.unico.io` / `*.unico.app`** — domínios de serviço atuais da Unico (CDN, API e subdomínios de aplicação). - **`*.googleapis.com`** (script-src, style-src, script-src-elem, connect-src) — necessário para carregar a stylesheet do Google Fonts (CSS `@font-face` via `fonts.googleapis.com`) e outros recursos da API do Google utilizados pela interface de captura. - **`fonts.gstatic.com`** (font-src) — Fornece os arquivos binários das Google Fonts referenciados pela folha de estilos carregada de `fonts.googleapis.com`. - **`*.sentry.io`** — a Unico utiliza o Sentry para rastreamento de erros do SDK. Necessário em `script-src` e `connect-src` para permitir as chamadas de relatório de erros. - **`*.launchdarkly.com`** — a Unico utiliza o LaunchDarkly para avaliação de feature flags que controlam o comportamento do SDK (por exemplo, seleção do motor de câmera). Necessário em `script-src` e `connect-src` para permitir o streaming e a avaliação de flags. - **`*.newrelic.com` / `bam.nr-data.net`** — a Unico utiliza o New Relic Browser para monitoramento de performance do SDK. Necessário em `script-src` (script do agente) e `connect-src` (chamadas de beacon). - **`blob:`** (worker-src, child-src, script-src-elem) — necessário porque Web Workers e certos sub-recursos do SDK são criados como URLs Blob em tempo de execução. ::: ****Passo 2** — Instalar o pacote** O Web SDK é fornecido por meio de um pacote npm ou cdn. ### npm ```bash npm install unico-webframe ``` ### yarn ```bash yarn add unico-webframe ``` ### CDN Baixe o SDK e importe-o no seu projeto: - [Baixar versão `3.23.7`](https://cdn.unico.io/sdk/check/bio/unico-webframe-3.23.7.zip) ****Passo 3** — Importar o SDK** Após a instalação, importe o SDK no seu projeto. ### Via npm ```javascript import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'unico-webframe' ``` ### Via CDN ```javascript import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'UnicoCheckBuilder.min.js' ``` ****Passo 4** — Baixar arquivos de recursos adicionais** Arquivos de recursos adicionais são necessários para realizar a captura de Prova de Vida. Baixe o arquivo correspondente à sua versão do SDK e inclua-o no seu projeto: :::warning[Checklist de atualização] Os arquivos de recursos estão vinculados à versão do SDK. Sempre que você atualizar o `unico-webframe`, **deve** baixar novamente os recursos correspondentes da tabela abaixo — utilizar versões incompatíveis causa um erro em tempo de execução durante a captura de Prova de Vida. **Alternativamente**, desde o SDK 3.18.0 o SDK pode buscar automaticamente esses arquivos no momento da inicialização, eliminando a etapa de download manual. Consulte [Inicialização](/dual-api/developers/sdks-and-tools/web/web-sdk/initialization) para a opção `setResourceDirectory`. ::: | Versão do SDK | Recursos 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 (consulte a tabela legada) | Baixe também os **arquivos de IA** do SDK: [models.zip](https://cdn.unico.io/sdk/check/bio/models.zip). :::warning[Caminho público] Todos os arquivos adicionais devem estar hospedados em um local público, visível para a Web dentro do seu projeto. :::