Executando o Web Plugin em um iframe

O Web Plugin funciona dentro de um iframe. O iframe deve ter permissão para usar a câmera, e cada página envolvida deve ser servida via HTTPS e coberta pela sua licença.

Início rápido

<iframe src="https://your-domain.example/liveness-page" allow="camera"></iframe>

allow="camera" é obrigatório; caso contrário, o navegador bloqueia o acesso à câmera, e o plugin não pode iniciar.

Requisitos

Requisito	Aplica-se a
allow="camera" na tag iframe	cada iframe na cadeia
HTTPS	a página pai e a página com o plugin
Domínio listado na sua licença	a página pai e a página com o plugin
Mesma origem da página com o plugin	a página pai – veja Página pai em um domínio diferente

Se o seu iframe contiver outro iframe, cada nível precisa do seu próprio allow="camera": a página externa o adiciona ao iframe que contém o wrapper, e a página do wrapper o adiciona ao iframe que contém o plugin. A ausência do atributo em qualquer nível bloqueia a câmera para tudo abaixo dele.

Solução de problemas

Problema	Causa	Solução
A caixa de diálogo de permissão da câmera nunca aparece; on_error recebe error_no_camera (error_no_camera_ios no iOS, error_no_camera_android no Android)	Um iframe na cadeia não tem allow="camera"	Adicione allow="camera" a todos os iframes na cadeia
Erro de conexão. Use HTTPS para se conectar.	A página pai ou a página com o plugin é servida via HTTP	Sirva ambas via HTTPS
Erro de licença. A origem https://… não está na lista permitida pela licença	O domínio dessa página não está na sua licença	Entre em contato com seu representante da Oz para adicionar o domínio
Verifique a política de mesma origem das janelas pai. O plugin deve verificar o host de cada janela.	A página pai está em uma origem diferente da página com o plugin	Entre em contato com seu representante da Oz – esta configuração precisa de uma definição adicional no lado do servidor

Página pai em um domínio diferente

O plugin lê o endereço de cada janela pai para verificá-lo em relação à sua licença. Quando a página pai está em uma origem diferente, o navegador bloqueia essa leitura e a verificação não pode ser concluída. Essa configuração é suportada, mas precisa de uma definição adicional no lado do Web Adapter – entre em contato com o representante da Oz.

Se você usou anteriormente iframe_allowed

iframe_allowed não é mais usado. O suporte a iframe está sempre ativado, e os requisitos acima são tudo o que é necessário, portanto, basta remover o parâmetro do arquivo de configuração do Web Adapter.