Instalador e Manual de Instalação do TSA para o Autorizador WEB

Linha de Produto:	Datasul
Segmento:	Saúde
Módulo:	TOTVS Saúde Planos (Linha Datasul)

...

Rotina:	Biometria Autorizador

Visão Geral

O objetivo desta funcionalidade é disponibilizar uma nova forma de captura da biometria uma vez que o plugin Java será desativado em breve, conforme

...

03. SOLUÇÃO

comunicado.

...

Para isto, foi desenvolvido um novo componente denominado TSA (Totvs Smart Agent). Este componente esta disponível para a leitora Nitgen Hamster DX (HFDU01 a HFDU06), BioFlex TechMag BIOFII-S180 e DigitalPersona

...

4000B (Apenas com o Novo TSA).

Card documentos

Informacao	A partir da versão 12.1.23 a opção de uso da biometria através do Applet foi removida do produto devido a descontinuidade do plugin Java.
Titulo	Importante

Procedimento para Utilização

Totvs custom tabs box

tabs	Utilizando TSA Antigo, Utilizando TSA Novo
ids	tsaantigo,tsanovo

Totvs custom tabs box items

default	yes
referencia	tsaantigo

Requisitos Mínimos

Windows Vista ou superior
Entrada USB 2.0 ou superior.
Navegadores: Microsoft Edge, Internet Explorer 11, Chrome 50 ou superior ou Firefox
Aparelho de Biometria

Totvs custom tabs box

tabs

Totvs custom tabs box

tabs	Instalação,Configuração Sistema
ids	instalacaoinstalar,configuracaoconfigurar

Totvs custom tabs box items

default	yes
referencia	instalacaoinstalar

Totvs custom tabs box

tabs	Requisitos Mínimos, Leitoras Nitgen,Leitoras Bioflex,Verificar a Instalação
ids	requisitos,nitgen,bioflex,verificar

Totvs custom tabs box items

default	yes
referencia	requisitos

Windows Vista ou superior
Entrada USB 2.0 ou superior.
Navegadores: Microsoft Edge, Internet Explorer 11, Chrome 50 ou superior ou Firefox
Aparelho de Biometria

nitgen

Necessário download

Totvs custom tabs box items

default	no
referencia	nitgen

Necessário download do .zip com os instaladores para a leitora Nitgen: Instaladores Nitgen.zip

Aviso
Caso já existe instalação exista instalação para leitoras diferentes ou TSA novo, desinstalar os programas anteriores.

Após concluir o download, abra o arquivo " .zip" e execute o instalador conforme a plataforma do sistema operacional.

Após instalação, conecte a leitora e abra a página http://localhost:21000/nitgen.html e e verifique se a página a seguir é exibida. Em caso positivo, os programas foram instalados corretamente:Image RemovedImage Added

verificar

Totvs custom tabs box items

default	no
referencia	bioflex

Necessário download dos intaladores da Leitora do .zip com os instaladores para a leitora Bioflex (disponível a partir da versão 12.1.20): Instaladores Biotouch.zip

Aviso
Caso já existe exista instalação para leitoras diferentes ou TSA novo, desinstalar os programas anteriores.

Abrir o arquivo

"

.zip

" referente

referente a leitora Bioflex e executar o instalador

"

ftrDriverSetup_winxp_vista_win7_whql_2307.exe

"

.

Image RemovedImage Added

Instalar o programa

"

TotvsSABiotouchWeb32.exe

"

.

Image Removed

Após instalação, conecte a leitora e abra a página http://localhost:21000/biotouch.html e verifique se a página a seguir é exibida. Em caso positivo, os programas foram instalados corretamente.

Image Removed

Totvs custom tabs box items

default

no

referencia

Image Added

Verificando a Instalação

Clicar em

“Start Session”

Start Session, será gerado um session id e o console irá apresentar mensagens de

"

Start

" e "

e Long polling browser request

"

.

Image Removed

Image Added

Após, clique em

"

Capture and Save

" para

para testar a captura da biometria. Deverá ser possível visualizar a digital na tela. Para leitoras Bioflex, será necessário fornecer a digital três vezes para a salvar a captura.

Image Removed

Image Added

Após a realização da captura, valide a digital salva clicando no botão

"

Verify saved

"

.

Image Removed

Image Added

Se a digital informada for válida, será exibida mensagem

"

fingerprint is valid

"

no log.

Image Removed

Image Added

Se fornecida digital inválida, o quadro

"

Verified

" ficará

ficará vazio (versão Nitgen) ou será fornecida a mensagem

"

Fingerprint doesn't match

" na

na tela (Bioflex).
Após realizar estes testes com sucesso, o novo componente de biometria já estará apto para utilização no Autorizador Web.

Totvs custom tabs box items

default	no
referencia	configuracaoconfigurar

Para cada sessão do usuário, logo após realizar o login, o sistema irá verificar se o serviço do TSA está ativo na máquina local do usuário.

Nitgen será apresentado dessa forma:

Image Removed

Biotouch será apresentado dessa forma:

Image Removed

Por padrão, o sistema não habilita o componente TSA para utilização. Para isso, deve-se adicionar duas propriedades nas configurações.

A propriedade com.totvs.saude.wac.bean.fingerprint.usingApplet deve ser cadastrada como false.

Na propriedade com.totvs.saude.biometria.totvstec.appdevice deve ser informado o tipo de leitora desejado. As opções disponíveis são NITGEN e BIOTOUCH.

Image Removed

Image Added

A partir da instalação e validação do componente, o sistema está apto para realizar a captura sem depender do plugin Java.Image Removed

A tela de captura informa se esta realizando o processo utilizando o TSA ou plugin Java.

Image Removed

Verificações Realizadas pelo Sistema

Para que o sistema utilize o componente TSA, será feita uma verificação no momento do login na aplicação, seguindo o fluxo abaixo:

1 - Para o navegador Internet Explorer, será feita uma tentativa de comunicação com o serviço do TSA. Caso o serviço não esteja instalado ou não iniciado, o sistema irá ser configurado para carregar o Applet Java no momento da captura. Caso no momento do login, o serviço TSA esteja instalado e iniciado, porem no momento da captura este esteja parado, o sistema irá emitir o seguinte alerta: "Serviço TSA não instalado ou não iniciado. Reinicie o navegador para utilizar o Applet Java"

2 - Para o navegador Chrome, ao realizar o login, não será verificado a existência do TSA, pois este será a única opção. No momento da captura, caso o serviço não esteja instalado ou não iniciado, será exibida a seguinte mensagem: "Este computador necessita a instalação do componente TSA para realizar a validação biométrica. Caso instalado, verifique se o serviço está ativo. Em caso de dúvida acione o suporte técnico."

Obs: Caso o usuário opte por não instalar o componente TSA, o sistema ficará restrito ao navegador Internet Explorer, pois é o único a dar suporte ao Applet Java.

Define a porta em que será hospedado o serviço do TSA.

Portas padrões:

Totvs custom tabs box items

default	no
referencia	tsanovo

Requisitos Mínimos

Windows 7 Service Pack 2 ou superior.
Entrada USB 2.0 ou superior.
Navegadores: Microsoft Edge, Internet Explorer 11, Chrome 50 ou superior ou Firefox.
Aparelho de biometria.
500Mb de espaço livre em disco.
HAW - Autorizador Web - 12.1.23 ou superior.

Totvs custom tabs box

tabs	Instalação, Configuração Sistema, Configuração TSA, Verificar a Configuração
ids	instalacao,configuracaoSistema,configuracaoTSA,verificacao

Totvs custom tabs box items

default	yes
referencia	instalacao

Aviso
Caso já exista instalação para leitoras do TSA antigo, desinstalar os programas anteriores.

Card documentos

Informacao	Durante a instalação é solicitado o diretório de instalação do SmartAgent, recomenda-se instalar o TSA com HTTPS em C:\Program Files\Totvs\SmartAgentHTTPS e o HTTP em C:\Program Files\Totvs\SmartAgentHTTP para evitar conflito em prestadores que atendem mais de uma Cooperativa medica.
Titulo	Atenção!

O processo é demonstrado em um GIF a seguir.

Realizar o download do TSA correspondente para a maquina.
- 32 bits: TotvsSmartAgentHTTP32.zip
- 64 bits: TotvsSmartAgentHTTP64.zip

Extrair os arquivos
Executar o TotvsSmartAgentHTTP64.exe ou TotvsSmartAgentHTTP32.exe
Pronto, a instalação foi realizada com sucesso.

Card documentos

Informacao	A biometria bioflex está disponível apenas para 32 bits.
Titulo	Atenção Bioflex!

Image Added

Verificando a Instalação

Clicando no smartagente.exe abrirá a tela, deve ser selecionado o modelo de leitora que será utilizado no Device.
Após ser selecionado e posicionar o dedo, clicar em Capture para testar a captura da biometria. Deverá ser possível visualizar a digital na tela.
Em caso de sucesso, será exibida uma mensagem de Sucess

Image Added

Aviso
Caso haja algum problema onde está sendo exibida a mensagem de Sucess, será retornado a inconsistência que está ocorrendo.

Após a realização da captura, valide a digital salva clicando no botão Verify.
Se a digital informada for válida, será exibida mensagem de Match True.

Image Added

Se fornecida digital inválida, será exibida mensagem de Match False.

Totvs custom tabs box items

default	no
referencia	configuracaoSistema

Totvs custom tabs box

tabs	Configurando o tipo de biometria, Configurando TSA utilizado, Configuração da Porta
ids	tipoBiometria,tipoTSA,porta

Totvs custom tabs box items

default	yes
referencia	tipoBiometria

Para selecionar o dispositivo de biometria que será utilizado é necessário cadastrar a propriedade com.totvs.saude.biometria.totvstec.appdevice onde deve ser informado o tipo de leitora desejado. As opções disponíveis são NITGEN , BIOTOUCH e DIGITALPERSONA.

Image Added

Totvs custom tabs box items

default	no
referencia	tsanovo

Totvs custom tabs box

tabs	Instalação, Configuração Sistema, Configuração TSA, Verificar a instalação
ids	instalacao,configuracaoSistema,configuracaoTSA,verificacao

Totvs custom tabs box items

default	yes
referencia	instalacao

Totvs custom tabs box

tabs	Requisitos Mínimos, Como Instalar
ids	requisitos,download,

Totvs custom tabs box items

default	yes
referencia	requisitos

Windows 7 Service Pack 2 ou superior.

Entrada USB 2.0 ou superior.

Navegadores: Microsoft Edge, Internet Explorer 11, Chrome 50 ou superior ou Firefox.

Aparelho de biometria.

500Mb de espaço livre em disco.

HAW - Autorizador Web - 12.1.23 ou superior.

Image Removed

Totvs custom tabs box items

default	no
referencia	download	tipoTSA

Para definir qual o tipo do TSA (TSA novo,com HTTP ou HTTPS, ou o TSA antigo) será utilizado é verificada a propriedade com.totvs.saude.biometry.https.

Valor Propriedade	Descrição
Não cadastrada	Será utilizada o TSA antigo, este só esta disponível na versão HTTP.
false	Será utilizado o novo TSA com HTTP

É possível a utilização do TSA antigo e novo e de diferentes leitoras na mesma maquina.

Card documentos

Informacao	Durante a instalação é solicitado o diretório de instalação do SmartAgent, recomenda-se instalar o TSA com HTTPS em C:\Program Files\Totvs\SmartAgentHTTPS e o HTTP em C:\Program Files\Totvs\SmartAgentHTTP para evitar conflito em prestadores que atendem mais de uma Cooperativa medica.
Titulo	Atenção!

O processo é demonstrado em um GIF a seguir.

Realizar o download do TSA correspondente para a maquina.

32 bits: TotvsSmartAgentHTTP32.zip
64 bits: TotvsSmartAgentHTTP64.zip

Extrair os arquivos

Executar o TotvsSmartAgentHTTP64.exe ou TotvsSmartAgentHTTP32.exe

Pronto, a instalação foi realizado com sucesso

.

Card documentos

Informacao	A

biometria bioflex está disponível apenas para 32 bits.

Titulo

Atenção Bioflex!

legislação da TISS estabelece a utilização de HTTPS e como a utilização do novo TSA exige a reinstalação do mesmo em todos os prestadores, sugerimos a implementação do TSA HTTPS como padrão.
Titulo	Atenção!

true

Será utilizado o novo TSA com HTTPS.

Totvs custom tabs box items

referencia
default	no

configuracaoSistema

porta

A atualização automática do TSA é realizada através da URL informada no arquivo de configuração, dessa forma, em casos em que as clínicas ou consultórios atendem mais de uma operadora é inviável ter apenas uma instalação para atender a todas, pois o TSA poderá ser atualizado por uma operadora e pelas outras não. Para atender essa necessidade será utilizada

Totvs custom tabs box

tabs	Configurando o tipo de biometria, Configurando TSA utilizado, Configuração da Porta
ids	tipoBiometria,tipoTSA,porta

Para definir qual o tipo do TSA (TSA novo,com HTTP ou HTTPS, ou o TSA antigo) será utilizado é verificada a propriedade com.totvs.saude.biometry.https.

Será utilizado o novo TSA com HTTPS.

Totvs custom tabs box items

default	yes
referencia	tipoBiometria

Para selecionar o dispositivo de biometria que será utilizado é necessário cadastrar a propriedade com.totvs.saude.biometria.totvstec.appdevice onde deve ser informado o tipo de leitora desejado. As opções disponíveis são NITGEN , BIOTOUCH e DIGITALPERSONA.

Image Removed

Totvs custom tabs box items

default	no
referencia	tipoTSA

Valor Propriedade

Descrição

Não cadastrada

Será utilizada o TSA antigo, este só esta disponível na versão HTTP.

false

Será utilizado o novo TSA com HTTP.

Card documentos

Informacao	A legislação da TISS estabelece a utilização de HTTPS e como a utilização do novo TSA exige a reinstalação do mesmo em todos os prestadores, sugerimos a implementação do TSA HTTPS como padrão.
Titulo	Atenção!

true

biometry.port para que seja possível parametrizar qual a porta http/https será utilizada pelo TSA.

Caso a propriedade esteja cadastrada será utilizada essa porta prioritariamente. Exemplo: 21005.
Caso não seja cadastrada será utilizada como porta padrão os seguintes casos:

21003 para o novo TSA com HTTP
21004 para o novo TSA com HTTPS

Exemplo sobre utilizar em mais de uma operadora está presente no documento DT - Propriedade para seleção de porta utilizada pelo TSA

As configurações são feitas no arquivo smartagent.ini, este arquivo fica localizado no diretório de instalação do TSA.

Este arquivo deve ser alterado conforme a configuração desejada pela Unimed.

Exemplo de configuração para HTTPS:

Totvs custom tabs box items

default	no
referencia	configuracaoTSA

Totvs custom tabs box

tabs	Smartagent.ini, Atualização Automática,HTTPS, HTTP
ids	smartagentini,atualizacaoAutomatica,https,http

Totvs custom tabs box items

default	noyes
referencia	porta

A atualização automática do TSA é realizada através da URL informada no arquivo de configuração, dessa forma, em casos em que as clínicas ou consultórios atendem mais de uma operadora é inviável ter apenas uma instalação para atender a todas, pois o TSA poderá ser atualizado por uma operadora e pelas outras não. Para atender essa necessidade será utilizada a propriedade com.totvs.saude.biometry.port para que seja possível parametrizar qual a porta http/https será utilizada pelo TSA.

Caso a propriedade esteja cadastrada será utilizada essa porta prioritariamente. Exemplo: 21005.
Caso não seja cadastrada será utilizada como porta padrão os seguintes casos:

21003 para o novo TSA com HTTP
21004 para o novo TSA com HTTPS

Exemplo sobre utilizar em mais de uma operadora está presente no documento DT - Propriedade para seleção de porta utilizada pelo TSA

Totvs custom tabs box items

default	no
referencia	configuracaoTSA

O arquivo zip retornado no download-url pode conter qualquer arquivo que já exista no diretório de instalação do TSA, os arquivos no diretório de instalação das clinicas serão substituídos caso sejam diferentes dos arquivos no zip.

smartagentini

As configurações são feitas no arquivo smartagent.ini este arquivo fica localizado no diretório de instalação do TSA. É possível realizar o download da ferramenta no ícone abaixo:

Pode ser realizado o download do smartagent.ini:

View file

name	smartagent.ini
height	150

Este arquivo deve ser alterado conforme a configuração desejada pela Unimed.

Exemplo de configuração para HTTPS:

Bloco de código
[General] Port=21004 SSL=1 [Update] URL=http://exemplo/update.json

Image Added

Configuração

Descrição

Port

Define a porta em que será hospedado o serviço do TSA.

Portas padrões:

Porta	Utilização
21000	TSA antigo
21001	TSA antigo Nitgen
21002	TSA antigo Biotouch
21003	Novo TSA com HTTP
21004	Novo TSA com HTTPS

Porta Customizada:

Para customizar a porta deve ser alterada essa configuração

E adicionada a propriedade com.totvs.saude.biometry.port no autorizador com a mesma porta.

SSL

Define se será utilizado SSL.

Portas padrões:

Valor	Resultado
0 (Padrão)	Não utiliza o SSL para a conexão (HTTP)
1	Utiliza o SSL para a conexão (HTTPS)

URL

Url, especifica da Unimed, que retorna um json contendo os dados da ultima versão disponível.

Esta configuração está detalhada na aba Atualização Automática.

Aviso
Após configuração do smartagent.ini é necessário que seja reiniciado o TSA.

Totvs custom tabs box items

default	no
referencia	atualizacaoAutomatica

A seguir encontram-se as configurações para atualizar automaticamente o TSA.

O TSA irá realizar a verificação de uma atualização a cada 24 horas, a verificação será feita através de um arquivo json retornado por uma url, da Unimed, configurada no smartagent.ini.

Abaixo tem um exemplo da seção Update que deve ser informada no arquivo smartagent.ini para habilitar a atualização automática.

Bloco de código
[Update] URL=http://exemplo/update.json

A url da Unimed deve retornar a seguinte estrutura de json:

Bloco de código
{ "latest-version": "3.0", "download-url": "http://exemplo/SmartAgentHTTP.zip", "force-update": false }

Parâmetro	Descrição	Tipo
latest-version	Número da versão do TSA contida na URL indicada em download-url	string
download-url	URL da Unimed contendo um arquivo ZIP com a nova versão dos arquivos para serem atualizados no diretório de instalação do TSA.	string
force-update	Indica se força a atualização ou não	boolean

O arquivo zip retornado no download-url pode conter qualquer arquivo que já exista no diretório de instalação do TSA, os arquivos no diretório de instalação das clinicas serão substituídos caso sejam diferentes dos arquivos no zip.

Card documentos

Informacao	Caso seja colocado algum arquivo adicional, o mesmo não será copiado
Titulo	Atenção!

Card documentos

Informacao	O arquivo ZIP não deve conter um instalador, pois não será executado.
Titulo	Atenção!

O processo de atualização está demonstrado no fluxograma a seguir.

Unimed

A seguinte parte deve ser realizada pela Unimed para disponibilizar uma nova versão do TSA (smartagent.exe) ou das configurações smartagent.ini e tsa.bin.

Image Added

Clinicas

O seguinte processo ocorre automaticamente nas clinicas que possuem o TSA instalado.

Image Added

O processo está descrito a seguir:

Caso a versão indicada no parâmetro latest-version seja maior do que a versão atual ou o parâmetro force-update estiver com valor true, o TSA notificará a existência de atualização.

Ao clicar na notificação de atualização, o TSA irá:

Fazer o download do arquivo ZIP indicado pelo parâmetro download-url
Extrair o conteúdo numa pasta temporária
Verificar quais dos arquivos existentes na pasta temporária são diferentes em relação à instalação atual
Fechar o TSA
Substituir os arquivos
Reiniciar o TSA

Totvs custom tabs box items

default	no
referencia	https

Totvs custom tabs box

tabs	How To, Gerar Certificado Auto-Assinado,Criptografar Certificado,Instalação do Certificado,Verificando Instalação
ids	howto,gerarCertificado,criptografarCertificado,instalarCertificado,verificarInstalacao

Totvs custom tabs box items

default	yes
referencia	howto

Vídeo How-to ensinando a instalar.

Conector de Widget

url	http://youtube.com/watch?v=evb5-AO5D6Y

Totvs custom tabs box items

default	no
referencia	gerarCertificado

Para gerar um certificado auto assinado foi utilizado o OpenSSL.
Link para download do OpenSSL para windows. (A versão para download depende do seu sistema operacional)

Por padrão o OpenSSL é criado na pasta C:\Program Files\OpenSSL-Win64 caso a instalação seja para 64 bits e na pasta C:\Program Files (x86)\OpenSSL-Win32 para instalação 32 bits.

Na pasta bin foi aberto o CMD como administrador.

Image Added

Foi utilizado o seguinte comando para gerar o certificado.

Bloco de código

title	Comando

openssl req -new -newkey rsa:4096 -nodes -keyout minhachaveprivada.key -out meucertificado.csr -days 36500 -subj /CN=127.0.0.1

Informações

title	Parâmetros

"-newkey": gera um par de chaves para utilizar no certificado.
"rsa:" : define a quantidade de bits que serão utilizados para gerar a chave;
"-days" : define a validade do certificado, neste caso 36500 o certificado tem validade de 100 anos;
"-keyout" : nome do arquivo gerado que conterá a chave privada do certificado;
"-out" : nome do arquivo gerado que conterá o certificado;
"-subj /CN": utilizado para definir para qual site o certificado é valido, neste caso o TSA utiliza o IP 127.0.0.1;

O certificado e chave serão gerados na pasta bin do OpenSSL.

É necessário criar um arquivo de configurações (v3.ext) na pasta bin do OpenSSL e colocar os seguintes dados:

Bloco de código

title	Arquivo de configuração (v3.ext)

# v3.ext
subjectAltName = IP:127.0.0.1

É possível realizar o download do arquivo de configuração no ícone abaixo:

View file

name	v3.ext
height	150

Para converter o certificado para formato pem foi utilizado o seguinte comando

Totvs custom tabs box

tabs	Atualização Automática, Smartagent.ini, HTTPS, HTTP
ids	atualizacaoAutomatica,smartagentini,https,http

A seguir encontram-se as configurações para atualizar automaticamente o TSA.

O TSA irá realizar a verificação de uma atualização a cada 24 horas, a verificação será feita através de um arquivo json retornado por uma url, da Unimed, configurada no smartagent.ini.

Abaixo tem um exemplo da seção Update que deve ser informada no arquivo smartagent.ini para habilitar a atualização automática.

Totvs custom tabs box items

default	yes
referencia	atualizacaoAutomatica

Bloco de código
[Update] URL=http://exemplo/update.json

A url da Unimed deve retornar a seguinte estrutura de json:

Bloco de código
{ "latest-version": "3.0", "download-url": "http://exemplo/SmartAgentHTTP.zip", "force-update": false }

Parâmetro

Descrição

Tipo

latest-version

Número da versão do TSA contida na URL indicada em download-url

string

download-url

URL da Unimed contendo um arquivo ZIP com a nova versão dos arquivos para serem atualizados no diretório de instalação do TSA.

string

force-update

Indica se força a atualização ou não

boolean

Card documentos

Informacao	Caso seja colocado algum arquivo adicional, o mesmo não será copiado
Titulo	Atenção!

Card documentos

Informacao	O arquivo ZIP não deve conter um instalador, pois não será executado.
Titulo	Atenção!

O processo de atualização está demonstrado no fluxograma a seguir.

Unimed

A seguinte parte deve ser realizada pela Unimed para disponibilizar uma nova versão do TSA (smartagent.exe) ou das configurações smartagent.ini e tsa.bin.

Image Removed

Clinicas

O seguinte processo ocorre automaticamente nas clinicas que possuem o TSA instalado.

Image Removed

O processo está descrito a seguir:

Caso a versão indicada no parâmetro latest-version seja maior do que a versão atual ou o parâmetro force-update estiver com valor true, o TSA notificará a existência de atualização.

Ao clicar na notificação de atualização, o TSA irá:

Fazer o download do arquivo ZIP indicado pelo parâmetro download-url
Extrair o conteúdo numa pasta temporária
Verificar quais dos arquivos existentes na pasta temporária são diferentes em relação à instalação atual
Fechar o TSA
Substituir os arquivos
Reiniciar o TSA

Totvs custom tabs box items

default	no
referencia	smartagentini

Bloco de código
[General] Port=21004 SSL=1 [Update] URL=http://exemplo/update.json

Image Removed

Configuração

Descrição

Port

Porta	Utilização
21000	TSA antigo
21001	TSA antigo Nitgen
21002	TSA antigo Biotouch
21003	Novo TSA com HTTP
21004	Novo TSA com HTTPS

Porta Customizada:

Para customizar a porta deve ser alterada essa configuração

E adicionada a propriedade com.totvs.saude.biometry.port no autorizador com a mesma porta.

SSL

Define se será utilizado SSL.

Portas padrões:

Valor	Resultado
0 (Padrão)	Não utiliza o SSL para a conexão (HTTP)
1	Utiliza o SSL para a conexão (HTTPS)

URL

Url, especifica da Unimed, que retorna um json contendo os dados da ultima versão disponível.

Esta configuração está detalhada na aba Atualização Automática.

Totvs custom tabs box items

default	no
referencia	https

Totvs custom tabs box

tabs	How To, Gerar Certificado Auto-Assinado, Instalação do Certificado, Criptografar Certificado
ids	howto,gerarCertificado,instalarCertificado,criptografarCertificado

Totvs custom tabs box items

default	yes
referencia	howto

Vídeo How-to ensinando a instalar.

Conector de Widget

url	http://youtube.com/watch?v=evb5-AO5D6Y

Totvs custom tabs box items

default	no
referencia	gerarCertificado

Para gerar um certificado auto assinado foi utilizado o OpenSSL.
Link para download do OpenSSL para windows.

Por padrão o OpenSSL é criado na pasta C:\Program Files\OpenSSL-Win64 caso a instalação seja para 64 bits e na pasta C:\Program Files (x86)\OpenSSL-Win32 para instalação 32 bits.

Na pasta bin foi aberto o CMD como administrador.

Image Removed

Foi utilizado o seguinte comando para gerar o certificado.

Bloco de código

title	Comando

openssl x509 -req -newsha256 -newkeydays rsa:409636500 -nodesin meucertificado.csr -keyoutsignkey minhachaveprivada.key -out meucertificado.csr -days 36500 -subj /CN=127.0.0.1.pem -extfile v3.ext

Informações

title	Parâmetros

"-newkeysha256":gera um par de chaves para utilizar no certificado."rsa:" : define a quantidade de bits que serão utilizados para gerar a chave Algorítimo de hash que será utilizado pelo certificado;
"-days" : define a validade do certificado, neste caso 36500 o certificado tem validade de 100 anos;
"-keyoutsignkey" : nome do arquivo gerado que conterá a chave privada do certificado;
"-in" : nome do arquivo de certificado gerado anteriormente;
"-out": nome do arquivo que será gerado que conterá com o certificado em formato pem;
"-subj /CNextfile": utilizado nome do arquivo com configurações para definir o IP alternativo (Necessário para qual site o certificado é valido, neste caso o TSA utiliza o IP 127.0.0.1;

O certificado e chave serão gerados na pasta do OpenSSL.

É necessário criar um arquivo de configurações e colocar os seguintes dados.

Bloco de código

title	Arquivo de configuração (v3.ext)

# v3.ext
subjectAltName = IP:127.0.0.1

o Chrome funcionar corretamente);

Totvs custom tabs box items

default	no
referencia	criptografarCertificado

O certificado deve ser criptografado para fazer com que apenas o TotvsSmartAgent tenha acesso ao conteúdo.

Para criptografar o certificado foi criado o tsaencryptor.exe. É possível realizar o download da ferramenta no ícone abaixo:

View file

name	tsaencryptor.exe
height	150

Aviso
O tsaencryptor.exe deve estar na mesma pasta onde está localizado os arquivos certificado.pem e minhachaveprivada.key

O seguinte comando é utilizado para criptografar o certificado, o comando deve ser rodado no CMD na pasta em que foi feito o download do tsaencryptor.exePara converter o certificado para formato pem foi utilizado o seguinte comando.

"-sha256": Algorítimo de hash que será utilizado pelo certificado;

"-days" : define a validade do certificado, neste caso 36500 o certificado tem validade de 100 anos;

"-signkey" : nome do arquivo gerado que conterá a chave privada do certificado;

"-in" : nome do arquivo de certificado gerado anteriormente;

"-out": nome do arquivo que será gerado com o certificado em formato pem;

"-extfile": nome do arquivo com configurações para definir o IP alternativo (Necessário para o Chrome funcionar corretamente);

Bloco de código

title	Comando

openssl x509tsaencryptor.exe -req -sha256 -days 36500 -in c meucertificado.csrpem -signkeyk minhachaveprivada.key -out meucertificado.pem -extfile v3.ext

Informações

title	Parâmetros

p senhadaminhachave

Parâmetros	Descrição
-c	Nome ou caminho do certificado valido em formato .pem
-k	Nome ou caminho da chave do certificado em formato .key
-p	Senha do arquivo da chave

Após rodar o comando será criado o arquivo tsa.bin no diretório onde o comando foi executado.

Image Added

Este arquivo é o certificado criptografado, ele deve ser colocado na pasta de instalação do TSA.

Totvs custom tabs box items

default	no
referencia	instalarCertificado

Card documentos

Informacao	É necessário instalar o certificado em todos os computadores que irão utilizar o TSA.
Titulo	Atenção!

Os passos seguintes mostram o processo de instalação do certificado.

1 - Passo: alterar a extensão do arquivo .pem para .crt
2 - Passo: Clicar duas vezes no certificado, será aberto uma janela e na parte de baixo desta existe um botão instalar certificado.
3 - Passo: Para instalar o certificado deve-se clicar em avançar e instalar o certificado como um Autoridade Certificadora.

Card documentos

Informacao	É necessário reiniciar os navegadores que estiverem abertos.
Titulo	Atenção!

Após rodar o comando será criado o arquivo tsa.bin no diretório onde o comando foi executado.

Image Removed

Este aquivo é o certificado criptografado, ele deve ser colocado na pasta de instalação do TSA.

Totvs custom tabs box items

default	no
referencia	verificarInstalacao	criptografarCertificado

Card documentos
Informacao Esses passos são obrigatórios em caso de utilização com navegador Firefox
Titulo Atenção!

Executar o smartAgent (smartagent.exe) presente na pasta de instalação do TSA.

Informações

Em caso dele já estar aberto enquanto houve a configuração, é necessário encerá-lo e executa-lo novamente.

Quando for utilizada a leitura é necessário que esteja sendo executado o TSA.

Após executado, deve ser acessado no navegador:

https:\\127.0.0.1:informarPorta

onde diz informarPorta deve ser trocado pelo valor setado na variável port do smartAgent.ini que se encontra na pasta de instalação do TSA
Um exemplo da troca: https:\\127.0.0.1:21004

Informações

title	Navegador Firefox

No navegador Firefox, ao cessar pela primeira vez será apresentada uma mensagem de potencial risco de segurança:

Image Added

Deve ser clicado em avançado
Em seguida apresentará a mensagem com os dados do certificado que foi instalado anteriormente.
Deve ser clicado em aceitar o risco e continuas

Ao conseguir acessar a conexão no navegador será apresentada a seguinte mensagem:

Image Added

Quando apresentar essa mensagem significa que está pronto para ser testado no autorizador

O certificado deve ser criptografado para fazer com que apenas o TotvsSmartAgent tenha acesso ao conteúdo.

Para criptografar o certificado foi criado o tsaencryptor.exe. É possível realizar o download da ferramenta no ícone abaixo:

View file

name	tsaencryptor.exe
height	150

O seguinte comando é utilizado para criptografar o certificado, o comando deve ser rodado no CMD na pasta em que foi feito o download do tsaencryptor.exe.

Bloco de código

title	Comando

tsaencryptor.exe -c meucertificado.pem -k minhachaveprivada.key -p senhadaminhachave

Parâmetros

Descrição

-c

Nome ou caminho do certificado valido em formato .pem

-k

Nome ou caminho da chave do certificado em formato .key

-p

Senha do arquivo da chave

Totvs custom tabs box items

default	no
referencia	http

Card documentos

Informacao	A legislação da TISS estabelece a utilização de HTTPS e como a utilização do novo TSA exige a reinstalação do mesmo em todos os prestadores, sugerimos a implementação do TSA HTTPS como padrão.
Titulo	Atenção!

É necessário apenas configurar o smartagent.ini com a porta correta e colocar o arquivo na pasta de instalação do TSA.

Totvs custom tabs box items

default	no
referencia	verificacao

A partir da instalação e validação do componente, o sistema está apto para realizar a captura.

A tela de captura informa se esta realizando o processo utilizando o "TSA".

HTML

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>

...

Árvore de páginas

Versões comparadas

Versão antiga 47

Nova versão Atual

Chave

Instalador e Manual de Instalação do TSA para o Autorizador WEB

Visão Geral

03. SOLUÇÃO

Procedimento para Utilização

Requisitos Mínimos

Verificando a Instalação

Verificações Realizadas pelo Sistema

Requisitos Mínimos

Verificando a Instalação

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 47

Nova versão Atual

Chave

Instalador e Manual de Instalação do TSA para o Autorizador WEB

Visão Geral

03. SOLUÇÃO

Procedimento para Utilização

Requisitos Mínimos

Verificando a Instalação

Verificações Realizadas pelo Sistema

Requisitos Mínimos

Verificando a Instalação