Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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

...

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
InformacaoA 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.
TituloImportante

Procedimento para Utilização


Totvs custom tabs box
tabsInstalação, Configuração Sistema, Configuração TSA, Verificar a instalaçãoUtilizando TSA Antigo, Utilizando TSA Novo
idsinstalacao,configuracaoSistema,configuracaoTSA,verificacaotsaantigo,tsanovo
Totvs custom tabs box items
instalacao
defaultyes
referenciatsaantigo

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
tabsRequisitos Mínimos, Nitgen, Bioflex, Digital PersonaInstalação,Configuração Sistema
idsrequisitos,nitgen,bioflex,digitalPersonainstalar,configurar
no
Totvs custom tabs box items
defaultyes
referenciarequisitos
  • 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.
instalar
Totvs custom tabs box
tabsLeitoras Nitgen,Leitoras Bioflex
idsnitgen,bioflex
Totvs custom tabs box items
default
yes
referencianitgen

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

Card documentos
InformacaoDurante 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.
TituloAtenção!

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

Aviso

Caso já 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

Image Added


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

  • É necessário instalar o componente TSA as instruções e o download estão disponíveis nesta pagina.
  • Instruções de validação da instalação podem ser encontradas neste link.
  • 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
    defaultno
    referenciabioflex

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

    Card documentos
    InformacaoDurante 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.
    TituloAtenção!

    • É necessário instalar o componente TSA as instruções e o download estão disponíveis nesta pagina (para a leitora Bioflex é necessário instalar a versão 32 bits).
    • Instruções de validação da instalação podem ser encontradas neste link.
    • Após realizar estes testes com sucesso, o novo componente de biometria já estará apto para utilização no Autorizador Web.

    Necessário download 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á exista instalação para leitoras diferentes ou TSA novo, desinstalar os programas anteriores.

    • Abrir o arquivo .zip referente a leitora Bioflex e executar o instalador ftrDriverSetup_winxp_vista_win7_whql_2307.exe.

    Image Added

    • Instalar o programa TotvsSABiotouchWeb32.exe.
    • 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 Added

    Verificando a Instalação

    • Clicar em Start Session, será gerado um session id e o console irá apresentar mensagens de Start e Long polling browser request.

    Image Added

    • Após, clique em Capture and Save 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 Added


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

    Image Added

    • Se a digital informada for válida, será exibida mensagem fingerprint is valid no log.

    Image Added

    • Se fornecida digital inválida, o quadro Verified ficará vazio (versão Nitgen) ou será fornecida a mensagem Fingerprint doesn't match na tela (Bioflex).
    • Após realizar estes testes com sucesso, o novo componente de biometria já estará apto para
    Totvs custom tabs box items
    defaultno
    referenciadigitalPersona

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

    Card documentos
    InformacaoDurante 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.
    TituloAtenção!

    • É necessário instalar o componente TSA as instruções e o download estão disponíveis nesta pagina.
    • Instruções de validação da instalação podem ser encontradas neste link.
    • 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
    defaultno
    referencia
    configuracaoSistema
    configurar

    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.

    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

    Totvs custom tabs box
    tabsConfigurando o tipo de biometria, Configurando TSA utilizado
    idstipoBiometria,tipoTSA
    Totvs custom tabs box items
    defaultyes
    referenciatipoBiometria

    Para selecionar o dispositivo de biometria que sera utilizado é necessário cadastrar a 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 e DIGITALPERSONA.

    Image Removed

    Totvs custom tabs box items
    defaultno
    referenciatipoTSA

    A propriedade com.totvs.saude.biometry.https foi criada para definir se é utilizado o TSA novo,com HTTP ou HTTPS, ou o TSA antigo.

    Caso a propriedade não esteja cadastrada será utilizada o TSA antigo, este só esta disponível na versão HTTP.

    Caso a propriedade esteja cadastrada como false será utilizado o novo TSA com HTTP. Neste caso destacamos que 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.

    Caso a propriedade esteja cadastrada como true será utilizado o novo TSA com HTTPS.

    Totvs custom tabs box items
    defaultno
    referenciaconfiguracaoTSA
    Totvs custom tabs box
    tabsAtualização Automática, Facilitador, Smartagent.ini, HTTPS, HTTP
    idsatualizacaoAutomatica,facilitador,smartagentini,https,http

    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.

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

    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.

    totvsyesatualizacaoAutomatica
    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-
    totvs-
    atualizacaoAutomatica
    custom-tabs-box
    tabsInstalação, Configuração Sistema, Configuração TSA, Verificar a Configuração
    idsinstalacao,configuracaoSistema,configuracaoTSA,verificacao

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

    As seguintes configurações são necessárias para utilizar o HTTPS:

    Image Removed

    howto,gerarCertificado,instalarCertificado,criptografarCertificado
    Totvs custom tabs box-items
    defaultnoyes
    referenciainstalacaofacilitador

    Para simplificar a instalação, o instalador vai extrair os arquivos de configuração da pasta data.zip presente no mesmo diretório.

     Image Removed

    Dentro do arquivo é colocado o arquivo tsa.bin e o arquivo de configuração smartagent.ini.

    Image Removed

    Os arquivos são extraídos na pasta de instalação do TSA.

    Image Removed

    Totvs custom tabs box items
    defaultno
    referenciasmartagentini

    Configuração

    Descrição

    Aviso

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

    Card documentos
    InformacaoDurante 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.
    TituloAtenção!

    O processo é demonstrado em um GIF a seguir.

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

    Card documentos
    InformacaoA biometria bioflex está disponível apenas para 32 bits.
    TituloAtençã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.
    Port

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

    Portas padrões:

    Porta

    Utilização

    21000TSA antigo
    21001TSA antigo Nitgen
    21002TSA antigo Biotouch
    21003Novo TSA com HTTP
    21004Novo TSA com HTTPS
    SSL

    Define se será utilizado SSL.

    Portas padrões:

    Valor

    Resultado

    0 (Padrão)Não utiliza o SSL para a conexão (HTTP)
    1Utiliza o SSL para a conexão (HTTPS)
    Totvs custom tabs box items
    defaultno
    referenciahttps
    Totvs custom tabs box
    tabsHow To, Gerar Certificado Auto-Assinado, Instalação do Certificado, Criptografar Certificado
    ids
    yes
    Totvs custom tabs box items
    default
    no
    referenciaconfiguracaoSistema

    Vídeo How-to ensinando a instalar.

    http://youtube.com/watch?v=evb5-AO5D6Y
    Totvs custom tabs box
    tabsConfigurando o tipo de biometria, Configurando TSA utilizado, Configuração da Porta
    idstipoBiometria,tipoTSA,porta
    howto
    Conector de Widget
    url
    Totvs custom tabs box items
    defaultyes
    referenciatipoBiometria

    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
    defaultno
    referenciagerarCertificado
    referenciatipoTSA

    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 PropriedadeDescrição
    Não cadastradaSerá utilizada o TSA antigo, este só esta disponível na versão HTTP.
    false

    Será utilizado o novo TSA com HTTP.

    Card documentos
    InformacaoA 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.
    TituloAtenção!

    trueSerá utilizado o novo TSA com HTTPS.
    Totvs custom tabs box items
    defaultno
    referenciaporta

    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
    defaultno
    referenciaconfiguracaoTSA
    Totvs custom tabs box
    tabsSmartagent.ini, Atualização Automática,HTTPS, HTTP
    idssmartagentini,atualizacaoAutomatica,https,http
    Totvs custom tabs box items
    defaultyes
    referenciasmartagentini

    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
    namesmartagent.ini
    height150

    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

    21000TSA antigo
    21001TSA antigo Nitgen
    21002TSA antigo Biotouch
    21003Novo TSA com HTTP
    21004Novo 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)
    1Utiliza 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
    defaultno
    referenciaatualizacaoAutomatica

    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âmetroDescriçãoTipo
    latest-versionNúmero da versão do TSA contida na URL indicada em download-urlstring
    download-urlURL 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-updateIndica se força a atualização ou nãoboolean

    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
    InformacaoCaso seja colocado algum arquivo adicional, o mesmo não será copiado
    TituloAtenção!

    Card documentos
    InformacaoO arquivo ZIP não deve conter um instalador, pois não será executado.
    TituloAtençã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
    defaultno
    referenciahttps
    Totvs custom tabs box
    tabsHow To, Gerar Certificado Auto-Assinado,Criptografar Certificado,Instalação do Certificado,Verificando Instalação
    idshowto,gerarCertificado,criptografarCertificado,instalarCertificado,verificarInstalacao
    Totvs custom tabs box items
    defaultyes
    referenciahowto

    Vídeo How-to ensinando a instalar.

    Conector de Widget
    urlhttp://youtube.com/watch?v=evb5-AO5D6Y

    Totvs custom tabs box items
    defaultno
    referenciagerarCertificado

    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
    titleComando
    openssl req -new -newkey rsa:4096 -nodes -keyout minhachaveprivada.key -out meucertificado.csr -days 36500 -subj /CN=127.0.0.1
    Informações
    titleParâ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
    titleArquivo 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
    namev3.ext
    height150


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

    ara 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É necessário criar um arquivo de configurações e colocar os seguintes dados

    .

    Bloco de código
    titleComando
    openssl x509 -req -
    new
    sha256 -
    newkey
    days 
    rsa:4096
    36500 -
    nodes
    in meucertificado.csr -
    keyout
    signkey minhachaveprivada.key -out meucertificado.
    csr
    pem -
    days 36500 -subj /CN=127.0.0.1
    extfile v3.ext
    Informações
    titleParâmetros
    • "-
    newkey
    • sha256":
    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;
    • "-
    keyout
    • 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
    que conterá o certificado
    • com o certificado em formato pem;
    • "-
    subj /CN
    • extfile": 
    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 do OpenSSL.

    • nome do arquivo com configurações para definir o IP alternativo (Necessário para o Chrome funcionar corretamente);
    Totvs custom tabs box items
    defaultno
    referenciacriptografarCertificado

    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
    nametsaencryptor.exe
    height150

    Aviso

    tsaencryptor.exe deve estar na mesma pasta onde está localizado os arquivos certificado.pem 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.exe

    .

    Bloco de código
    title
    Arquivo de configuração (v3.ext)
    # v3.ext
    subjectAltName = IP:127.0.0.1

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

    Bloco de código
    titleComando
    openssl x509 -req -sha256 -days 36500 -in meucertificado.csr -signkey minhachaveprivada.key -out meucertificado.pem -extfile v3.ext
    Informações
    titleParâmetros
    • "-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);
    Totvs custom tabs box items
    defaultno
    referenciainstalarCertificado

    É necessário instalar o certificado em todos os computadores que irão utilizar o TSA.
    Os passos seguintes mostram o processo de instalação do certificado.

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

    É necessário reiniciar os navegadores que estiverem abertos.

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

    Image Removed

    Image Removed
    Comando
    tsaencryptor.exe -c meucertificado.pem -k minhachaveprivada.key -p senhadaminhachave
    ParâmetrosDescrição 
    -cNome ou caminho do certificado valido em formato .pem
    -kNome ou caminho da chave do certificado em formato .key
    -pSenha 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

    Image Added

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

    Totvs custom tabs box items
    defaultno
    referenciainstalarCertificado

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

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

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

    Card documentos
    InformacaoÉ necessário reiniciar os navegadores que estiverem abertos.
    TituloAtenção!

    Totvs custom tabs box items
    defaultno
    referenciaverificarInstalacao
    Card documentos
    InformacaoEsses passos são obrigatórios em caso de utilização com navegador Firefox
    TituloAtençã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
    titleNavegador 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.

    Totvs custom tabs box items
    defaultno
    referenciacriptografarCertificado

    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 que pode ser baixado no link a seguir.

    View file
    nametsaencryptor.exe
    height250

    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
    titleComando
    tsaencryptor.exe -c meucertificado.pem -k minhachaveprivada.key -p senhadaminhachave
    ParâmetrosDescrição 
    -cNome ou caminho do certificado valido em formato .pem
    -kNome ou caminho da chave do certificado em formato .key
    -pSenha do arquivo da chave

    Totvs custom tabs box items
    defaultno
    referenciahttp

    Card documentos
    InformacaoA 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.
    TituloAtenção!

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

    O seguinte arquivo deve ser colocado no diretório de instalação do TSA.

    Clique aqui para baixar o arquivo. 

    Diretório de instalação: C:\Program Files\Totvs\SmartAgentHTTP

    Totvs custom tabs box items
    defaultno
    referenciaverificacao

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

    Image Modified


    A tela de captura informa se esta realizando o processo utilizando o

    "

    TSA

    "

    .

    Image Modified

    04. DEMAIS INFORMAÇÕES

    ...

    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>
    

    ...