Perguntas frequentes

A FACEIO é um framework de autenticação facial multiplataforma para aplicações web e móveis. Os desenvolvedores o utilizam para adicionar login com reconhecimento facial, autenticação sem senha e reautenticação de contas sem construir a própria infraestrutura de reconhecimento.

A integração começa com o fio.js, a biblioteca JavaScript executada no navegador, documentada no Guia de integração da FACEIO. Os usuários fazem cadastro e autenticação por meio de um widget hospedado que funciona com webcam ou câmera frontal do celular.

A FACEIO é desenvolvida e mantida pela PixLab ↗, parte da Symisc Systems ↗. A FACEIO oferece autenticação facial em diferentes navegadores, o widget ID Match para comparar uma selfie com a foto do documento e o Meeting Shield para reuniões compatíveis no navegador. São produtos separados, com finalidades diferentes.

Para conhecer as práticas de privacidade, segurança e operação, comece pelo Central de Confiança, guia de boas práticas de privacidade e guia de boas práticas de segurança.

1. Crie um aplicativo no FACEIO Console ↗.
2. Copie o Public ID do aplicativo.
3. Adicione o fio.js ao seu site ou aplicativo web.
4. Chame enroll() para cadastrar usuários e authenticate() para o login de usuários recorrentes.

O caminho mais curto é o guia de primeiros passos. Para código de produção, continue com a referência da API e guia de integração do fio.js.

A FACEIO combina vários componentes: a biblioteca JavaScript fio.js, um widget seguro no navegador, serviços de autenticação facial no backend, REST APIs opcionais e eventos de webhook para o seu servidor.

A maioria das integrações de autenticação facial começa com o widget hospedado porque ele gerencia a captura da câmera, as verificações de vivacidade, a comparação facial e a compatibilidade do navegador. O widget apresenta o fluxo de consentimento configurado, enquanto o proprietário continua responsável pelos avisos e pelo consentimento. Depois, os aplicativos podem conectar webhooks, endpoints da REST API e fluxos de Facial ID.

Sim. A FACEIO foi projetada para navegadores modernos de desktop e dispositivos móveis com acesso a webcam ou câmera frontal. Use o mesmo padrão fio.js para fluxos web em desktop e dispositivos móveis, depois teste as permissões da câmera e o comportamento do navegador antes do lançamento.

Para observações sobre navegadores e frameworks, consulte a Central do desenvolvedor e o guia de integração.

• Primeiros passos para criar o primeiro aplicativo e fazer uma configuração rápida.
• Guia de integração para fio.js, enroll(), authenticate(), tratamento de erros e gerenciamento de sessões.
• Central do desenvolvedor para exemplos de frameworks, REST APIs, webhooks, privacidade, segurança e referências para produção.
• Webhooks e os Facial ID para sincronização com o backend e gerenciamento do ciclo de vida dos usuários cadastrados.

A FACEIO não depende de um framework específico. Você pode carregar fio.js a partir de HTML simples, React, Vue, Next.js, Angular, jQuery ou qualquer frontend capaz de executar JavaScript no navegador e solicitar permissão para a câmera.

Seu backend pode ser escrito em Node.js, PHP, Python, Go, Rust, Java, .NET ou qualquer stack capaz de receber webhooks e fazer requisições HTTPS à REST API. Comece pela Central do desenvolvedor e pelo guia de integração.

Sim. A FACEIO pode ser usada como uma camada de login facial sem senha, uma etapa de verificação de segundo fator ou uma etapa de reautenticação da conta antes de ações sensíveis. O padrão adequado depende do seu modelo de sessão, fluxo de recuperação de conta e requisitos de consentimento do usuário.

Para planejar, compare o guia de autenticação sem senha, o guia de login facial e a documentação de boas práticas de segurança.

Sim. Os webhooks permitem que seu backend receba eventos de cadastro de usuários, autenticação bem-sucedida e exclusão de Facial IDs. Isso é útil quando o servidor precisa sincronizar o estado da conta, gravar logs de auditoria ou acionar fluxos do aplicativo.

Valide o token Bearer do cabeçalho WWW-Authenticate e os identificadores esperados do aplicativo antes de confiar no payload de um webhook.

Um Facial ID, também chamado de Index ID, é o identificador FACEIO associado ao registro de autenticação facial de um usuário cadastrado. Ele ajuda os desenvolvedores a gerenciar o estado de autenticação, solicitações de exclusão e a vinculação de contas sem expor imagens faciais brutas, vetores faciais ou hashes biométricos ao aplicativo.

A REST API é destinada a operações privadas no backend, como gerenciar dados do aplicativo, trabalhar com Facial IDs e excluir registros cadastrados. Ela é separada da inicialização do widget por meio do fio.js, executado no navegador do usuário.

Recupere sua chave de API no Application Manager do FACEIO Console ↗, mantenha-a no servidor e consulte a documentação da REST API antes de fazer chamadas em produção.

Um Facial ID é um identificador exclusivo anônimo, semelhante em finalidade a um UUID ↗, atribuído pelo mecanismo de reconhecimento facial a cada usuário cadastrado no seu aplicativo FACEIO após o consentimento explícito. Ele ajuda seu backend a associar a autenticação facial aos registros da sua própria conta, mantendo os dados da conta exibidos ao usuário separados do índice do mecanismo de reconhecimento facial.

O cadastro facial é criado com uma única chamada a enroll() a partir do fio.js, a biblioteca de widget JavaScript implementada no seu site ou aplicação web.

Para excluir um Facial ID, faça uma chamada à REST API a partir do seu backend privado para o endpoint DELETEFACIALID. Uma chamada bem-sucedida remove completamente o Facial ID, os dados de payload associados e o hash biométrico desse aplicativo FACEIO. O endpoint está documentado na referência da REST API.

Um exemplo em Python para exclusão no backend está disponível como um GitHub Gist ↗. Para conhecer as práticas de privacidade e conformidade, consulte o Central de Confiança FACEIO.

Sim. O Application Manager permite ajustar a aparência do widget, adicionar seu logotipo, configurar links legais e definir opções de segurança para cada aplicativo FACEIO. Mantenha o consentimento e os links legais claros, pois eles fazem parte do fluxo de autenticação exibido ao usuário.

Crie ou atualize as configurações do widget no FACEIO Console ↗, depois teste o fluxo nos navegadores e dispositivos realmente usados pelos seus usuários.

O mecanismo de reconhecimento facial transforma o rosto de um usuário cadastrado em um vetor matemático de características, normalmente tratado como um hash biométrico dentro de um índice de aplicativo isolado. A FACEIO oferece suporte ao PixLab Insight e ao AWS Rekognition; o proprietário do aplicativo configura o mecanismo, a região e o modelo de implantação.

Escolha com base na residência de dados, nos requisitos do provedor de nuvem, nas necessidades on-premise e na sua análise jurídica e de segurança. Use a referência do Facial ID, guia de boas práticas de privacidade, guia de boas práticas de segurança e a FACEIO Console ↗ para testar a configuração.

A FACEIO oferece mecanismos de reconhecimento facial em nuvem e uma opção on-premises com o PixLab Insight na infraestrutura controlada pelo cliente. O proprietário seleciona e configura o mecanismo, a região, as credenciais e o modelo de implantação. Entre em contato pelo canal de suporte do FACEIO Console ↗ para planejar a implantação.

FACEIO Meeting Shield é uma extensão do Chrome que avalia sinais de risco de deepfakes e vídeos sintéticos em reuniões compatíveis no navegador. Ele é separado da autenticação facial com fio.js e não garante a detecção de todo vídeo manipulado.

FACEIO ID Match é um widget incorporável que captura uma selfie ao vivo e um documento, verifica a vivacidade e compara a selfie com a foto do documento. Os integradores chamam idmatch() para abrir o fluxo no navegador.

A FACEIO fornece detecção facial, vivacidade e comparação 1:1. A PixLab DOCSCAN ↗ lê o documento e pode extrair campos opcionais. O ID Match não autentica o documento, não estabelece identidade legal, não conclui verificações KYC ou AML e não toma decisões de aprovação.

A autenticação facial padrão da FACEIO cadastra um usuário e depois autentica esse usuário recorrente contra o registro. O ID Match não cadastra nem autentica a pessoa: ele faz uma comparação pontual 1:1 entre uma selfie ao vivo e a foto do documento apresentado e pode retornar campos extraídos.

A implementação segue o mesmo padrão de integração de fio.js descrito no guia de integração, mas chama idmatch() em vez de enroll() ou authenticate().

Use o FACEIO Console ↗ para criar aplicativos, copiar Public IDs, configurar a aparência do widget, gerenciar opções de segurança, consultar o uso, abrir solicitações de suporte e gerenciar o faturamento.

Para consultar os detalhes dos planos públicos, veja a página de preços da FACEIO.

A FACEIO oferece planos adequados para protótipos, MVPs e aplicativos em produção. Consulte a página de preços para consultar limites, recursos e opções de upgrade atuais e, em seguida, crie ou atualize seu aplicativo no Console ↗.

Entre no FACEIO Console ↗, selecione Novo aplicativo, siga o assistente e use o Public ID gerado na sua integração com fio.js.

O guia de primeiros passos explica o mesmo processo com o código mínimo necessário para cadastrar e autenticar seu primeiro usuário.

Crie uma conta na página de cadastro do FACEIO Console ↗, depois crie seu primeiro aplicativo no painel. As etapas de verificação são realizadas no Console durante a configuração do aplicativo.

Para encerrar uma conta, remova os aplicativos que não são mais necessários, resolva eventuais pendências das assinaturas ativas e use os controles da conta ou o suporte privado no canal de suporte do Console ↗. A exclusão da conta é permanente; exporte tudo o que precisar antes de solicitar o encerramento.

A FACEIO não armazena os dados completos do cartão de crédito no Console do aplicativo. Quando aplicável, os pagamentos e as assinaturas são processados pelo comerciante ou processador de pagamentos exibido no checkout.

Para alterações de plano, faturas e dúvidas privadas sobre faturamento, use o canal de suporte do Console ↗.

O proprietário do aplicativo é responsável pela forma como a FACEIO é usada no produto. Isso inclui quando o widget é exibido, o que é informado aos usuários, como o consentimento é coletado, qual mecanismo de reconhecimento é escolhido, quais opções de segurança são ativadas e o que acontece depois que a FACEIO retorna um resultado de autenticação.

A FACEIO é um framework de autenticação facial preparado para produção, implantado desde 2022, com mais de 9 milhões de instâncias do widget servidas e milhares de clientes no mundo todo. Esse histórico não substitui as responsabilidades de segurança, privacidade, aspectos legais e consentimento no nível do seu aplicativo.

A FACEIO fornece o widget para navegador, APIs, webhooks e orientações de implementação. Ela não é responsável pelo uso indevido de um aplicativo, pela ausência de avisos aos usuários, por recuperação de conta fraca, gerenciamento inseguro de sessões ou decisões posteriores tomadas pelo aplicativo. Antes do lançamento, consulte o guia de boas práticas de segurança, guia de boas práticas de privacidade e Central de Confiança.

Não. A própria FACEIO, incluindo fio.js, o widget incorporado, a REST API e o Console, não retém imagens faciais brutas nem armazena ou expõe hashes biométricos. Seu aplicativo recebe identificadores e resultados de autenticação, não imagens faciais brutas, vetores faciais ou hashes biométricos.

O mecanismo de reconhecimento facial selecionado trata os vetores faciais ou assinaturas hash de acordo com a configuração, a região, o fluxo de consentimento e a política de exclusão definidos pelo proprietário do aplicativo. Os proprietários são responsáveis por escolher o mecanismo, explicar o fluxo aos usuários e oferecer caminhos de exclusão ou opt-out. Leia a referência do Facial ID, guia de boas práticas de privacidade e Central de Confiança.

Não. A própria FACEIO não armazena hashes biométricos. O mecanismo de reconhecimento facial selecionado cria e gerencia um hash biométrico somente pelo fluxo de cadastro após o consentimento explícito do usuário. O hash é um vetor matemático, não uma imagem facial bruta, e não é retornado ao frontend.

Cada aplicativo FACEIO usa seu próprio índice isolado. Não existe um banco de dados centralizado de hashes biométricos dos clientes, e os fluxos de exclusão são realizados pelas Facial ID e os REST API documentadas. Os proprietários dos aplicativos continuam responsáveis pelos avisos legais, consentimento, escolhas de retenção e solicitações de exclusão dos usuários.

Não. As verificações de vivacidade e anti-spoofing da FACEIO fazem parte do fluxo de autenticação facial, mas nenhum sistema de detecção pode garantir o bloqueio de todo ataque de apresentação, tentativa de replay, automação ou padrão de abuso de conta.

Os proprietários devem combinar a FACEIO com a validação padrão por PIN Code, restrições de domínio, limitação de taxa, regras de recuperação de conta, verificações de autorização no servidor, validação de webhooks e processos de suporte adequados. Use o guia de boas práticas de segurança para decidir quais controles pertencem ao seu aplicativo.

A FACEIO ativa a validação por PIN Code por padrão. O PIN adiciona um segredo conhecido pelo usuário, portanto o fluxo configurado exige mais do que uma correspondência facial. Ele é um fator adicional de autenticação, não um detector de deepfakes, e deve ser combinado com vivacidade e controles de segurança do aplicativo.

Os proprietários podem revisar os requisitos do PIN Code, a rejeição de PINs fracos, as restrições de domínio e país e outros controles de segurança no Application Manager do FACEIO Console ↗. A configuração recomendada está documentada no guia de boas práticas de segurança.

Sim. Os proprietários podem restringir a inicialização do widget a nomes de domínio aprovados e, quando configurado, a países aprovados. Esses controles ajudam a impedir que sites não autorizados carreguem seu aplicativo FACEIO e reduzem tráfego indesejado de regiões que você não atende.

Configure essas opções na aba SECURITY do Application Manager e verifique o comportamento antes da implantação em produção. Consulte o guia de boas práticas de segurança para orientações de implantação.

Comece pelo Central de Confiança, guia de boas práticas de privacidade e guia de boas práticas de segurança. As equipes de produto, jurídico e engenharia também devem consultar a Política de Privacidade e os Termos de Uso antes de implantar a FACEIO para usuários reais.

A documentação da FACEIO ajuda as equipes a implementar a autenticação facial com responsabilidade, mas não substitui a análise jurídica e de segurança do proprietário do aplicativo, os avisos aos usuários, o fluxo de consentimento, o processo de suporte ou as obrigações de conformidade nos mercados em que o aplicativo opera.

Use o Fórum da comunidade FACEIO ↗ para perguntas públicas de implementação, discussões entre desenvolvedores e tópicos detalhados que podem ajudar outras equipes a integrar a autenticação facial.

Use o canal de suporte do Console ↗ para questões privadas de conta, faturamento, produção, segurança ou específicas do cliente.

Use o fórum para perguntas reutilizáveis, como exemplos de frameworks, padrões de integração, tratamento de webhooks, UX de login facial, implementação do ID Match e notas de solução de problemas que não exponham dados privados da conta.

Use o suporte privado quando a questão incluir IDs de aplicativos, dados de faturamento, dados de usuários, incidentes de produção ou informações sensíveis de segurança.

Use o página de status da FACEIO ↗ para consultar a disponibilidade atual do serviço e as atualizações de incidentes. Para obter ajuda com a implementação, use a página de suporte ou abra uma solicitação privada no Console.