Autorizador_Reconhecimento_Facial

CONTEÚDO

Visão Geral
Exemplo de utilização
Tela Seleção da Câmera
1. Outras Ações / Ações relacionadas
Tela Registro de Biometria
1. Outras Ações / Ações relacionadas
Tela Validação de Biometria
1. Outras Ações / Ações relacionadas
Tela Validação Realizada com Sucesso
1. Outras Ações / Ações relacionadas
Tela Alterar Biometria Cadastrada

01. VISÃO GERAL

As implementações descritas neste documento correspondem a alteração do layout da tela de Identificação do Beneficiário no módulo Autorizador WEB para utilização do Reconhecimento Facial.

Para o total funcionamento da Reconhecimento Facial, é necessário que a versão do Progress do Appserver Autorizador esteja na versão mínima recomendada pela TOTVS, que é a 11.7.5. Essa informações já foi encaminhada na data 20/05/2020 para os clientes TOTVS. Qualquer inconsistência sobre a versão do seu Progress, deve ser acionado o suporte da Progress.

02. EXEMPLO DE UTILIZAÇÃO

Para utilizar é necessário realizar os passos da implantação e configuração.

Procedimentos para Implantação

A implementação descrita no documento estará disponível a partir da atualização do pacote no cliente.

O pacote está disponível no portal (https://suporte.totvs.com/download) e também na console de atualização.

Procedimentos para Configuração

i. Configuração dos Parâmetros de Integração Reconhecimento Facial

No programa Central de Integração Saúde Planos (hgp.integrationsParams) há um cadastro de reconhecimento facial que possibilita o registro referente ao sistema de integração para reconhecimento facial.

Nele serão informados o Sistema de Integração, a URL da API, o Token e a Acuracidade Aceitável.

As URL's disponíveis se encontram na página de Ambientes de Integração da Biodoc . Segue abaixo as opções disponíveis para serem configuradas no sistema:
URL Ambiente de Homologação Ambiente de Produção
API’s https://api.sandbox.biodoc.com.br/
https://api.biodoc.com.br/
O Token para integração deve ser obtido no canal de suporte da equipe Biodoc, através do endereço https://suporte.cloudmed.io/

Mais informações sobre esse programa em: DT Central de Integrações Saúde Planos - (hgp.integrationsParams).

ii. Configuração para habilitar o Cadastro da Biometria

Necessário cadastrar as propriedades "com.totvs.saude.wac.biometry.newPage" e "com.totvs.saude.wac.checkin.newPage" ambas como "true" para utilizar a nova página de biometria.

Foi adicionado um novo label Permite Biometria Facial no programa Manutenção Associativa Prestador x Clínica (AC0210H) para habilitar biometria facial. Quando parametrizado como Sim será apresentado a biometria facial. E quando parametrizado o campo Permite Biom.Facial Intercambio, passa apresentado a biometria facial para beneficiários de intercâmbio.

Também é necessário alterar a configuração da Manutenção Associativa Processos x Anexos (hcg.associativeProcessAttachments), item "11 - Autorizador", deve ser habilitado a opção “Armazenamento dos anexos” e escolher uma opção em “Tipo de Armazenamento”.

Após as definições acimas realizadas, deve ser informado no "Tipo de Anexo" a informação que contenha ".PNG" para guardar a imagem capturada pela webcam do beneficiário.

Na configuração do propath do appserver utilizado no autorizador é necessário informar biblioteca OpenEdge.Net.pl para o correto funcionamento das integrações utilizadas para validar a biometria facial.

Caso não apareça outras associativas em "Manutenção Associativa Processos x Anexos" além do "1 - Tipo de Anexo Padrão" ou a opção "11 - Autorizador", deve ser executado a SPP SPCG034. Mais informações sobre a SPP: DT Gerenciador de Anexos e posteriormente cadastrado os "Tipos de Anexo" no programa hcg.attachmentType.

Necessário parametrizar no programa Manutenção de Parâmetros Web (hac.webparams) a faixa etária que capturar a biometria facial. Caso o beneficiário não esteja na faixa etária não será apresentado em tela a biometria facial para cadastro ou validação.

iii. Configuração para Habilitar a Alteração da Biometria

Foi criado um novo campo no menu Manutenção de Secretários(as) (hat.secretary) onde é possível parametrizar se o(a) secretário(a) terá permissão para alterar a foto referência da biometria facial do beneficiário.

Ao editar o cadastro de secretária é necessário acessar a aba Clínicas Associadas, conforme imagem abaixo:

Ao editar a clínica desejada é exibido em tela a Associativa de Secretario(a) x Clínica, contendo o novo parâmetro Permitir Alterar Biometria:

Além disso foram criadas 2 novas propriedades: com.totvs.saude.wac.changeBiometry e com.totvs.saude.wac.biometry.validateBeforeUpdate, sendo:

com.totvs.saude.wac.changeBiometry: Propriedade que define se será possível atualizar a biometria facial do beneficiário caso o(a) secretário(a) tenha permissão.
com.totvs.saude.wac.biometry.validateBeforeUpdate: Propriedade que define se será validado a imagem do beneficiário antes de realizar a atualização.

A primeira propriedade listada é obrigatória para possibilitar a alteração da foto referência pela secretária, sem esta propriedade ativa o botão de alterar a foto referência não será habilitado. A segunda propriedade quando não cadastrada permite a alteração da foto referência sem qualquer tipo de validação a fim de verificar se a foto capturada trata-se do beneficiário em questão, ou seja, é possível alterar a foto do beneficiário por qualquer imagem.

iv. Configuração de Importação de Certificado

Para utilizar a biometria facial é necessário realizar a importação do certificado https do sistema de integração que está sento utilizado.

A não importação do certificado poderá causar a seguinte mensagem em tela: Erro: Erro ao Integrar Nenhuma reposta obtida.

Certificado Biodoc:

CertificadosBiodoc.zip

Não é necessário efetuar a instalação dos certificados em anexo pelo "proenv", conforme consta na TDN Autorizador Reconhecimento Facial.

Os certificados em anexo devem ser inseridos na pasta "certs" .

No documento Importação de certificados Https pode ser visualizado o passo a passo de como realizar a importação do certificado acima ou obter certificados de outros links https e efetuar a importação.

Procedimentos para Utilização

Para a utilização dessa funcionalidade é necessário utilizar o autorizador com https

Além disso, essa funcionalidade não é compatível com nenhuma versão do Internet Explorer.

1. Seleção da Biometria Digital

Com a parametrização do programa AC0210H é apresentada a biometria facial junto a biometria digital. São disponibilizados dois botões. Quando não houver a biometria facial cadastrada será habilitado o botão Cadastrar Biometria Facial:

Caso haja a biometria cadastrada será habilitado apenas o botão de Validar Biometria:

Para saber os procedimentos de configuração e utilização da Biometria Digital acessar a documentação: DT (Autorizador) - Autenticação Biometria Digital

2. Cadastro da Biometria Facial

Ao clicar no botão Cadastrar Biometria Facial será aberto um pop-up onde poderá ser selecionada a câmera que deverá ser utilizada para capturar a imagem:

É necessário permitir a utilização da câmera quando realizada validação por seu respectivo navegador.

Ao clicar no botão Capturar Imagem será retornada a imagem capturada e dois botões o Tentar Novamente e o Salvar:

O botão Tentar Novamente retorna a tela de seleção da câmera e novamente aparece a imagem para capturar.

O botão Salvar salva a imagem que foi capturada e redireciona para a tela do usuário:

3. Validação da Biometria

Ao clicar no botão Validar Biometria será aberto um pop-up onde poderá ser selecionada a câmera que deverá ser utilizada para capturar a imagem:

Ao clicar no botão Capturar Imagem será retornada a imagem capturada e dois botões o Tentar Novamente e o Validar:

O botão Tentar Novamente retorna para a tela de seleção da câmera e captura, assim como no registro da biometria facial.

O botão Validar, valida a imagem capturada com imagem de referência que foi salva durante o cadastro. Caso o beneficiário seja identificado será retornado na tela a foto capturada e a foto de referência e dois botões o Atualizar foto de referência pela atual e o Continuar com Atendimento.

A validação leva em consideração a similaridade da imagem capturada com a imagem de referência. Essa similaridade considera uma porcentagem mínima que é parametrizada no campo Acuracidade Aceitável presente na aba de Reconhecimento Facial do programa Central de Integração Saúde Planos (hgp.integrationsParams). Dessa forma se a similaridade for menor que a informada no programa será apresentada uma mensagem de erro e ficará disponível a tela de captura de imagem com o botão de Tentar Novamente.

O botão Atualizar foto de referência pela atual altera a foto de referência da validação pela foto que foi capturada:

O botão Continuar com Atendimento, fecha o pop-up e redireciona para a tela com as informações do usuário:

04. Atualização da Biometria Facial

Caso seja necessário atualizar a foto referência do beneficiário, através desta funcionalidade é possível realizar a atualização da foto.

Ao informar a carteira de um beneficiário que já possua uma foto referência salva, é habilitado o botão Alterar Biometria Cadastrada. Segue abaixo demonstração do processo:

05. Remoção da Biometria Facial

Caso seja necessário remover a biometria facial que foi cadastrada, é necessário realizar login como Administrador do Sistema.

Dessa forma na barra lateral é apresentada a opção de Remover Biometria. Ao clicar e informar a carteira do beneficiário será apresentada se há alguma biometria cadastrada (seja facial ou digital).

Caso haja cadastro biométrico, apresentará as opções e o botão de excluir de cada biometria.