Histórico da Página
Foundation Saúde com HTTPS
Características do Requisito
Linha de Produto: | Datasul | ||||
Segmento: | Saúde | ||||
Módulo: | Foundation Saúde | ||||
Rotina: |
| ||||
País(es): | Brasil | ||||
Pacote: | 12.1.23 |
Descrição
As implementações descritas neste documento, correspondem as adequações no Foundation Saúde para utilização do padrão HTTPS.
Procedimento 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).
Procedimento para Configuração
- %JBOSS_HOME% → diretório do JBOSS do Foundation Saúde.
- O certificado deve ser copiado para a pasta %JBOSS_HOME%\server\default\conf
- As configurações referente aos connectors devem ser alteradas no arquivo %JBOSS_HOME%\server\default\deploy\jboss-web.deployer\server.xml
- As configurações referentes as portas dos web-services devem ser alteradas no arquivo %JBOSS_HOME%\server\default\deploy\jbossws.sar\jbossws.beans\META-INF\jboss-beans.xml
- As configurações dividem-se em 3 etapas: modificar o connector da aplicação de http para https, criar uma novo conector para os web-services HTTP e especificar as portas dos web-services.
Alteração connector HTTP para HTTPS:
Adicionar os seguintes atributos a tag do conector correspondente do foundation:
Atributos | Descrição | Valor |
---|---|---|
keystoreFile | Diretório onde está salvo o certificado | %JBOSS_HOME%\server\default\conf |
keystorePass | Senha do certificado | --- |
SSLEnabled | Ativar a utilização do SSL | true |
scheme | Protocolo utilizado na comunicação. Ex: http, https | https |
secure | Define se será utilizado SSL para a conexão | true |
sslProtocol | Define o protocolo SSL que será utilizado | TLS |
Alteração no arquivo %JBOSS_HOME%\server\default\deploy\jboss-web.deployer\server.xml:
<Connector emptySessionPath="true"
port="28080" minSpareThreads="5" maxSpareThreads="75"
enableLookups="true" disableUploadTimeout="true"
acceptCount="100" maxThreads="200"
scheme="https" secure="true" SSLEnabled="true"
keystoreFile="C:\totvs\autorizador\jboss-4.2.3-WAC.GA\server\default\conf\autorizador.jks" keystorePass=""
clientAuth="false" sslProtocol="TLS"/>
Criação connector para WebService HTTP:
Alterar o arquivo %JBOSS_HOME%\server\default\deploy\jboss-web.deployer\server.xml criando um novo connector conforme exemplo abaixo. A porta que será utilizada fica a critério do cliente:
<Connector emptySessionPath="true"
port="38443" minSpareThreads="5" maxSpareThreads="75"
enableLookups="true" disableUploadTimeout="true"
acceptCount="100" maxThreads="200"
scheme="https" secure="true" SSLEnabled="false"
keystoreFile="C:\totvs\autorizador\jboss-4.2.3-WAC.GA\server\default\conf\autorizador.jks" keystorePass="medical"
clientAuth="false" sslProtocol="TLS"/>
Especificação das Portas dos Webservices
Alterar o arquivo %JBOSS_HOME%\server\default\deploy\jbossws.sar\jbossws.beans\META-INF\jboss-beans.xml informando quais portas devem ser utilizadas pelos webservices HTTP e HTTPS .
Importante:
Com a criação do novo connector para os web services http, o cliente deve atualizar os endereços internos que apontam para o Foundation e também repassar as novas urls para os serviços externos que utilizam esses web services.