Instalação

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:

<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"
/>

aviso

Se a sua aplicação possuir CSP, esta configuração é obrigatória para garantir o funcionamento correto do SDK.

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

npm install unico-webframe

yarn add unico-webframe

Baixe o SDK e importe-o no seu projeto:

Baixar versão 3.23.7

Passo 3 — Importar o SDK

Após a instalação, importe o SDK no seu projeto.

Via npm
Via CDN

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

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:

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 para a opção setResourceDirectory.

Versão do SDK	Recursos 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 (consulte a tabela legada)

Baixe também os arquivos de IA do SDK: models.zip.

Caminho público

Todos os arquivos adicionais devem estar hospedados em um local público, visível para a Web dentro do seu projeto.