FAQ
Perguntas frequentes
Geral
Os produtos Oz Forensics possuem certificados?
Certificamos nossa arquitetura na iBeta:
o método de captura do SDK de frontend (na iBeta, fornecemos um Mobile SDK) e
o processamento completo da detecção de ataques de apresentação no lado do Oz API.
Se você substituir a captura do Mobile SDK pela captura do Web SDK, a arquitetura e a precisão de segurança contra ataques de apresentação permanecem as mesmas, mas, em alguns casos, a Taxa de Falsa Rejeição pode aumentar devido à menor qualidade das câmeras dos laptops.
Além disso, no cenário de uso do nosso Web SDK, implementamos uma camada adicional de proteção contra ataque deepfake / injeção: detecção de spoofing de câmera (ataques de injeção / deep fake) 
No entanto, esses tipos de ataques não estão relacionados a ataques de apresentação e não estão incluídos no escopo de certificação da iBeta.
Como autorizar no Oz API?
Obtenha o token de autorização via API, conforme descrito aqui. Para obter o token, você precisa das credenciais e do endereço da API fornecidos por nós. O token é necessário para todas as interações subsequentes com o Oz API.
Quais são os requisitos de sistema do Oz?
Servidor Oz BIOMETRY / Liveness
CPU: 16 cores
RAM: 32 GB
Disco: 80 GB
Servidor Oz API / Web UI / Web SDK
CPU: 8 núcleos
RAM: 16 GB
Disco: 300 GB
Consulte a tabela de compatibilidade para versões de SO.
Você pode usar duas máquinas virtuais em um único host físico, mas certifique-se de que seu servidor seja potente o suficiente. Observe: se você implementar o modelo de uso on-premise, quanto melhor for seu hardware, mais rápidas serão as análises.
Como estimar os requisitos de hardware com base em requisições por minuto/hora
A capacidade de throughput do sistema depende do número de Oz BIOMETRY/Liveness servidores que você configurou. Cada servidor ou pod (Docker/K8s) pode processar:
Até 34 análises por minuto, 2040 análises por hora,
Até 2 threads simultâneas
Para aumentar o desempenho, dimensione a implantação horizontalmente adicionando mais servidores ou pods.
Como testar as soluções Oz?
No nível básico, você pode testá-las por conta própria sem sequer envolver nossos engenheiros: visite nossa página Web Demo ou baixe nosso aplicativo de demonstração na Google Play (Android) ou TestFlight (iOS) com a funcionalidade no dispositivo. Para explorar mais recursos, entre em contato conosco para obter as credenciais e os links necessários para acessar:
as análises de Liveness e Face Matching baseadas em servidor,
a Web Demo estendida,
console web para verificar as informações sobre pedidos e análises,
e REST API.
Teremos prazer em fornecer qualquer suporte.
Posso usar meu próprio conjunto de dados para testes?
Claro, pode. Entre em contato conosco para obter suas credenciais para acessar o Oz API. Depois, siga as instruções de este guia de integração.
O Oz SDK protege contra ataques de injeção (câmeras virtuais etc.)?
Sim, fornecemos proteção contra ataques de injeção. Se você gravar um vídeo usando nosso SDK, obtém proteção em duas camadas contra ataques de injeção: a forma como gravamos vídeos permite que nossas redes neurais rastreiem os ataques no próprio vídeo, e as informações coletadas sobre o contexto e as propriedades da câmera ajudam a detectar o uso de câmeras virtuais ou outros métodos de injeção.
Para evitar intenções maliciosas, não permitimos o uso de câmeras virtuais.
O que é telemetria e por que devo usá-la?
Telemetria é um serviço de registro que grava cada evento durante a sessão do usuário, desde a inicialização do SDK até a obtenção dos resultados da verificação, incluindo a verificação de segurança e dados comuns do dispositivo.
Exemplo:
Cada evento gera um registro de telemetria, e esses registros ajudam muito na investigação de incidentes e no fortalecimento de nossa defesa contra ameaças atuais e potenciais. Recomendamos fortemente habilitar e armazenar os dados de telemetria.
As informações que coletamos via telemetria são anonimizadas. Por meio da telemetria, nós não armazenamos:
identificadores diretos (como IMEI ou nome de usuário),
dados financeiros,
dados de comunicação,
informações de localização,
Ou quaisquer outros dados que não sejam necessários para a investigação de incidentes.
No Oz API, temos um subcomponente para receber telemetria: Echo. Aqui, você encontra uma breve descrição e o guia do administrador.
Para usuários do Oz API em nuvem com versão nativa do SDK 8.0.0 e superior, a telemetria é configurada automaticamente e salva junto com os dados da análise. Em ambientes on-premise, sugerimos configurar a telemetria e enviar os dados para nossos servidores. Entre em contato conosco para obter as credenciais necessárias.
Com que frequência vocês lançam novas versões de software?
Melhoramos continuamente nosso software, aprimorando seu desempenho e segurança. A frequência típica de atualização é a seguinte:
Mobile SDKs: atualizações mensais, com versões principais com mudanças significativas ocorrendo anualmente.
Web SDK: atualizações mensais, que podem incluir mudanças significativas.
API: atualizada uma ou duas vezes por ano, potencialmente incorporando mudanças significativas.
Independentemente do conteúdo da atualização, fornecemos suporte completo durante todo o processo de atualização para garantir funcionalidade sem interrupções.
Posso desativar ou evitar as verificações de segurança?
Infelizmente, não. A segurança é nossa prioridade máxima, e essas medidas de proteção são essenciais para manter seus dados seguros. Desativá-las pode resultar em riscos de segurança, como acesso não autorizado ou vazamentos de dados.
Qual é a diferença entre access_token e session_token?
Esses são dois tokens distintos usados em diferentes estágios da interação com o Oz API.
access_token autentica suas solicitações ao Oz API. É emitido via POST {{host}}/api/authorize/auth e deve ser incluído em todas as solicitações da API no cabeçalho X-Forensic-Access-Token.
session_token é específico para OzCapsula. É emitido via GET {{host}}/api/authorize/session_token, vinculado a uma sessão de captura e a um contêiner específicos, e tem um tempo de vida limitado. session_token deve ser obtido antes do início da captura: ele é necessário para criar o contêiner de dados OzCapsula.
SDK
Qual é o tamanho do arquivo de vídeo capturado?
SDKs nativos (Mobile): Selfie simples – 1 a 2 MB, outros gestos – 1,2 a 4,5 MB.
Web SDK: 2 a 5 MB.
Para informações detalhadas sobre os tamanhos dos arquivos, consulte este artigo.
Posso capturar um documento usando o Oz SDK?
O processamento de documentos não é nossa especialidade, e não temos planos de desenvolver nessa direção. Nosso foco principal é fornecer serviços de Liveness e Face Matching com resultados claros e precisos.
Os SDKs nativos (Mobile) não incluem funcionalidade de captura de documentos. O Web SDK oferece apenas uma tela básica de captura de documentos. Nenhum dos SDKs fornece OCR (reconhecimento de campos do documento), identificação do tipo de documento, verificação de qualidade etc. Para essas tarefas, considere integrar seu próprio software OCR ou de terceiros.
Você pode utilizar os documentos para Face Matching com um vídeo de Liveness no lado do servidor. Use as photo_id_front e photo_id_back tags para fotos das faces frontal e traseira de um documento, respectivamente.
Quais idiomas seus SDKs suportam e como posso adicionar um idioma personalizado?
Web SDK: EN, ES, PT-BR, KK.
Web Demo: EN, ES, PT-BR, KK.
Para adicionar seu próprio idioma ao Web SDK, consulte estas instruções.
Mobile SDK: EN, ES, HY, KK, KY, TR, PT-BR.
Mobile Demo: EN, ES, PT-BR.
Para adicionar seu próprio idioma aos Mobile SDKs, consulte estas instruções: iOS, Android.
Como altero textos nas strings do SDK?
Você pode alterar qualquer mensagem do SDK. Para isso, vá para a seção de localização do SDK desejado:
Baixe o arquivo de strings. Ele consiste nos registros de localização. Cada registro contém uma chave e um texto para essa chave. Faça suas alterações e siga as instruções fornecidas.
Observe: nos mobile SDKs, o recurso de alteração de texto foi implementado em 8.1.0.
Os Oz SDKs funcionam com Flutter (Xamarin, React etc.)?
Nossos SDKs podem ser integrados com qualquer framework ou biblioteca.
Para Native SDKs, criamos nosso próprio Flutter SDK para iOS e Android: consulte esta seção. Você também pode incorporá-los a frameworks como Cordova, Xamarin, Ionic, Kotlin Multiplatform, React Native etc.
Para Web SDK, temos exemplos para Angular, React, Vue e Svelte. Substitua https://<link>.ozforensics.com em index.html com o link do seu Web Adapter, se necessário.
E se eu não usar o Oz SDK para capturar vídeo?
Você pode usar qualquer mídia para análise. No entanto, com nossos SDKs, a precisão das análises é maior, pois a qualidade de um vídeo capturado pelos nossos SDKs é ideal para a análise de Liveness subsequente. A integração perfeita dos componentes de captura e análise de vídeo garante que todo o processo ocorra sem problemas. Além disso, projetamos nossos SDKs pensando em usuários reais, proporcionando uma ótima experiência do usuário.
Se você gravar um vídeo usando nosso SDK, obtém proteção em duas camadas contra ataques de injeção: a forma como gravamos vídeos permite que nossas redes neurais rastreiem os ataques no próprio vídeo, e as informações coletadas sobre o contexto e as propriedades da câmera ajudam a detectar o uso de câmeras virtuais ou outros métodos de injeção.
Vocês realizam alguma verificação de qualidade de mídia durante as análises?
As análises tratam a mídia em sua forma bruta sem avaliar sua qualidade. No entanto, damos atenção à qualidade da mídia quando tiramos uma foto ou gravamos um vídeo usando nosso SDK. Verificamos iluminação, tamanho e posição do rosto, presença de quaisquer objetos adicionais etc. Você pode encontrar a lista de verificações do nosso SDK aqui.
Observe que, se você usar seu próprio SDK ou um SDK de terceiros para capturar uma foto ou vídeo, o resultado deve atender aos nossos critérios de qualidade. Caso contrário, isso pode afetar a precisão das análises.
Seus SDKs oferecem suporte a leitores de tela e como posso ativá-los?
Sim, nossos SDKs são totalmente compatíveis com os leitores de tela nativos em todas as plataformas suportadas – VoiceOver no iOS e macOS, TalkBack no Android e qualquer leitor de tela padrão no Windows – de modo que usuários com deficiência visual e cegos possam usar todas as funções sem percepção visual.
Isso funciona desde a versão 8.14 do SDK Android e iOS e da versão 1.7.14 do Web SDK. VoiceOver em nossos SDKs é ativado automaticamente se a opção correspondente tiver sido habilitada nas configurações do dispositivo.
Posso adicionar meu próprio logotipo ao Oz SDK?
Sim. Este é um recurso pago gerenciado pelo seu licença. Depois que esse recurso for ativado, você pode substituir o logotipo da Oz pelo seu próprio.
Web SDK
Na arquivo de configuração ou, ao chamando OzLiveness.open(options), especifique a URL do logotipo:
ou:
Recomendamos usar o formato SVG, embora PNG e JPG também sejam suportados. Se necessário, você também pode configurar o tamanho e a posição do logotipo conforme descrito aqui.
Mobile SDK
Tanto no Android quanto no iOS, você pode personalizar o logotipo, seu tamanho e sua posição.
Android
Para obter a lista completa de parâmetros de personalização, consulte aqui. A imagem do logotipo deve estar no formato JPG ou PNG.
iOS
Para obter a lista completa de parâmetros de personalização, consulte aqui. O logotipo é fornecido como uma UIImage.
Análises
Quanto tempo as análises levam?
Normalmente, a análise leva de 1 a 3 segundos.
O tempo depende do tipo de análise (no dispositivo ou baseada em servidor) e de alguns outros fatores.
Baseada em servidor: para o modelo de uso on-premise, o que mais importa é o seu hardware. Para SaaS, nosso hardware é usado, mas, ainda assim, nos horários de pico a análise pode demorar mais devido ao aumento da carga.
No dispositivo iOS: menos de um segundo.
No dispositivo Android: em smartphones novos – até três segundos, depende da CPU.
Em modelos antigos, esses números podem ser um pouco maiores. Quanto mais novo for seu smartphone, mais rápidas serão as análises.
Recomendamos usar análises baseadas em servidor sempre que possível, pois as análises on-device tendem a produzir resultados menos precisos.
Como baixar os dados de todos os pedidos?
Todos os dados dos seus pedidos podem ser recuperados via API. Chame GET Folder [LIST]. A resposta será um arquivo JSON com todas as informações necessárias.
Se você precisar dos dados detalhados das suas análises, certifique-se de que o with_analyses parâmetro esteja definido como True: GET /api/folders/?with_analyses=true. Você também pode especificar outros parâmetros, como ID do usuário ou tipo de análise. Para baixar nossa coleção do Postman, prossiga aqui.
Para recuperar as informações de um pedido específico (pasta), você precisará do seu ID. No console web, vá para a Pedidos aba, clique Filtro, insira o número do pedido no campo apropriado e clique Pesquisar. Quando o pedido necessário for exibido, clique no ícone com PDF, selecione o modelo de relatório e clique Continuar. Os dados do pedido serão baixados no formato PDF. Para saber mais sobre como trabalhar com o console web da Oz, consulte esta seção.
Como faço a análise de Liveness para uma foto?
Com a API 5.0.0 e superior, você pode realizar a análise de Liveness para qualquer mídia, incluindo imagens.
Com a API 4.0.8 e inferiores, Liveness não funciona com imagens, mas aceita sequências de quadros. Assim, para realizar uma análise usando uma foto, você precisa convertê-la em uma sequência de quadros de um único quadro. Coloque a foto em um arquivo ZIP e use tags de vídeo, para que os algoritmos de Liveness tratem essa foto como um vídeo. Você pode encontrar mais informações em nosso guia de integração.
Qual é a diferença entre One shot, Selfie e Best Shot?
Captura única e Selfie são Liveness passiva ações. Para a Selfie ação, gravamos um vídeo curto e o enviamos para a análise. Para Captura única, é usado apenas um único quadro, o que reduz tanto o tamanho do arquivo quanto a precisão da análise. Recomendamos evitar o Captura única gesto sempre que possível, pois tende a produzir resultados menos precisos.
Em 1º de janeiro de 2027, o gesto One Shot ficará indisponível. Planeje sua migração.
Best Shot não é uma ação. É um opção que permite salvar o melhor quadro (o de maior qualidade e melhor ajustado) do vídeo de Liveness. Esta opção funciona apenas como um complemento ao Liveness. No entanto, para um Captura única gesto, tendemos a usar o quadro do Best Shot.
Qual é a diferença entre os status DECLINED e FAILED?
A análise é marcada como FAILED quando encontra um erro que impede sua conclusão. Por exemplo, se o sistema falhar ao detectar qualquer rosto em um arquivo de mídia, não há conteúdo para analisar, resultando no status FAILED status. O sistema fornece uma descrição do erro detalhando a causa da falha. Se você enviou a solicitação de análise via API, a descrição do erro está no error_message campo da resposta JSON. No pedido no Web Console, clique no ponto de exclamação vermelho para abrir a janela com a descrição.
O DECLINED status significa que a análise foi concluída e o sistema considerou que a verificação não foi bem-sucedida. Você também receberá um número que é o score resultante. Por exemplo, a análise recebe o DECLINED status DECLINED quando dois rostos em arquivos de mídia não correspondem (Face Matching) ou quando o ataque de spoofing é detectado (Liveness).
Para mais detalhes sobre os status, consulte este artigo.
O que impacta o score de spoofing (confiança)?
Ao calcular o score de spoofing, as redes neurais levam em conta muitos fatores. Alguns deles podem ser explicados; por exemplo, câmeras melhores (e mais bem controladas) geralmente produzem scores mais precisos. É por isso que os scores dos Native SDKs costumam ser mais baixos para tentativas originais do que os dos Web SDKs. No entanto, devido à multiplicidade de fatores envolvidos, os scores não são diretamente interpretáveis.
Mesmo ao repetir tentativas em condições semelhantes e aparentemente tornando-as iguais, as imagens variam ligeiramente de uma tentativa para outra, levando também a possíveis diferenças nos scores.
No entanto, esses fatores podem ter um impacto mais significativo e podem resultar em rejeições falsas, aumentando a FRR:
Defeitos na câmera ou objetos que obstruem parcialmente o campo de visão da câmera, como películas protetoras, capas ou suportes.
Condições extremas de iluminação.
Uso de câmeras de baixa qualidade ou especializadas.
Óculos com armações grossas e reflexos de tela (óculos ópticos padrão geralmente são aceitos).
Acessórios de cabeça, que são aceitos principalmente quando não cobrem o rosto, mas podem afetar ligeiramente o score de falsa rejeição.
Não usar nosso SDK para gravar mídia também pode ser um fator significativo que contribui para scores ruins de Liveness e rejeições falsas.
Atualizado
Isto foi útil?