Redirect
Integração com FaceSign via SSO e Webview
Este documento descreve o processo de integração com a plataforma FaceSign utilizando Single Sign-On (SSO) juntamente com uma página web intermediária. O fluxo inclui redirecionamento, autenticação facial biométrica, criptografia e validação dos dados do usuário.
1. Crie um Website para Receber o Redirecionamento
Desenvolva uma página web que será responsável por receber o callback do processo de autenticação realizado na plataforma FaceSign. Essa URL será configurada posteriormente no Portal Adm da FaceSign.
Exemplo:
https://seusite.com.br/callback2. Aponte o WebView para Abrir a URL Parametrizada
Abra o seguinte link dentro do WebView da sua aplicação. A URL será disponibilizada pelo Portal Adm da FaceSign, mas deverá conter o parâmetro clientUserId preenchido com o CPF do usuário.
Exemplo:
https://dev-app.facesign.in/sso/3330bb2d-127e-0000-ada0-f7d99b44d659?clientUserId=123456🔐 Importante: Utilize sempre HTTPS para garantir a segurança do processo.
3. Construa o Processo de Captura do CPF
Antes de abrir o WebView, construa um processo na sua aplicação para coletar o CPF do usuário. Este CPF será utilizado como valor do parâmetro clientUserId na URL acima.
Exemplo de coleta:
<label for="cpf">CPF:</label>
<input type="text" id="cpf" name="cpf" placeholder="Digite seu CPF">
<button onclick="abrirFaceSign()">Autenticar</button>
<script>
function abrirFaceSign() {
let cpf = document.getElementById("cpf").value;
window.location.href = "https://dev-app.facesign.in/sso/3330bb2d-127e-0000-ada0-f7d99b44d659?clientUserId=" + cpf;
}
</script>4. Envio do CPF por Parâmetro na URL
Envie o CPF coletado como parâmetro na URL para garantir maior segurança no processo de identificação do usuário.
Exemplo:
https://dev-app.facesign.in/sso/3330bb2d-127e-0000-ada0-f7d99b44d659?clientUserId=12345678901🧠 clientUserId: Campo esperado pela FaceSign para identificar o usuário na sua base.
5. Autenticação por Biometria Facial 3D
Após o acesso à URL, o usuário será direcionado ao app da FaceSign (ou ambiente web próprio), onde realizará a autenticação biométrica facial 3D.
6. Configure a Página de Callback no FaceSign
Acesse o Portal Administrativo da FaceSign e edite as configurações do cliente.
Navegue até a página de edição do cliente.
Acesse a aba Funcionalidades.
Localize o botão “Habilitar SSO” e clique para ativar a funcionalidade.
7. Selecione a Opção Redirect
Na tela de SSO, selecione a opção Redirect para ter acesso ao campo de configuração do endpoint.
8. Informe a URL do Website Criado
No campo “URL para callback redirect”, informe a URL do website criado anteriormente:
9. Configure o Website para Receber os Dados do Redirect
Após a conclusão do processo de autenticação, a FaceSign fará um redirecionamento para a URL configurada, enviando dois parâmetros:
{
"chave": "",
"user": "ch78YMRvs1yebIU4EwZFK8GqOBujbhcIju4Mu9DLgRQsXyt4Qber9gFqe4Is+Db5UsBlmT0pKkLXe9S+0aLYrUcA4f8Bgj26fgVlKuw+bDGJsBHxuvD5DN0COwVplDz+mKwOdNGvQyjWpZlebmrOrMTeavnNUMha2RUFza1Pyd7DmljbSrpuXaY5zRirP14aCI3Vg7hgt19xvYW2BNjn6ok3CFXw7rXYQqBpln2DhSoDrTYOxTIetFAnYcs1gC5DNCuxjdyOGaxbA1lScsy8eDBATVtc0MOYQ/+S4tj/bLo5it0ACzUSwKcKD6oZPAEKIlzfchA+Yqml4bSMjQF6riGw1P/0/+m2VUjkyTxLeSSQ67Atm0h1YTW4ctKCzl5kOOq6YBRUsY3pr2l4xn3G+zfI/XcwK/8ZSNHkFdQO4="
}Você deve capturar esses valores e prosseguir com a etapa de validação.
10. Faça uma Chamada para a API de Descriptografia
Utilize a API abaixo para validar os dados recebidos:
Endpoint:
POST /api/SingleSignOn/ValidateHeaders:
Content-Type: application/jsonBody:
{
"key": "<valor_do_parâmetro_chave>",
"data": "<valor_do_parâmetro_user>"
}💡 Substitua
<valor_do_parâmetro_chave>e<valor_do_parâmetro_user>pelos valores recebidos na URL de callback.
11. Receba os Dados Descriptografados
Você receberá uma resposta contendo os dados do usuário autenticado. Um exemplo é:
{
"clientId": "30af224e-9ac6-40eb-89f9-b2a7d2081a59",
"status": "Ativo",
"cpf": "24748342820",
"name": "Leandro Gujev Firmino",
"face": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsKCwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQUFBQUFBQUFBQUFBQUFB...",
"coordinates": "latitude: -20.4238977, longitude: -49.9681062",
"ipAdrress": "192.168.2.116",
"transactionID": "68290cd6-4517-4d71-6730-08dd51a42f40"
}12. Valide e Autentique o Usuário na Sua Aplicação
Com os dados recebidos:
Confirme se o status retornado é
"Ativo".Verifique se o CPF corresponde ao usuário esperado.
Valide os campos adicionais conforme necessário (ex: localização, IP, face).
Libere ou negue o acesso com base nos dados recebidos.
⚠️ Recomendação de Segurança: Armazene apenas os dados essenciais do usuário e siga as normas de proteção de dados (ex.: LGPD).
Considerações Finais
Ao seguir este guia, você conseguirá integrar com segurança o processo de autenticação biométrica facial com sua aplicação, aumentando significativamente a confiabilidade das transações e acessos dos usuários.
Suporte e Contato
Para suporte técnico ou dúvidas, utilize o Portal Admin FaceSign ou entre em contato com nossa equipe através dos canais oficiais.
Atualizado