Para habilitar o acesso HTTPS no PIMSConnector, será necessário importar o certificado *.cer para um certificado *.keystore e configurá-lo na instalação do JBoss.
Importando certificado *.cer para certificado *.keystore.
Determinado certificado, obtido de uma Autoridade Certificadora no formato *.cer, deve ser importado para o arquivo *.keystore através do utilitário keytool que acompanha a distribuição do JDK, localizado no diretório PIMSCONNECTOR_HOME\PIMSConnector\jdk7\bin. Para importar o certificado, execute os seguintes passos:
Passo 1. Acesse o diretório bin do JDK via prompt:
Bloco de código |
---|
|
cd $PIMSCONNECTOR_HOME\PIMSConnector\jdk7\bin\ |
Passo 2. Execute o utilitário
...
keytool, informando os seguintes parâmetros:
Bloco de código |
---|
|
keytool -import -alias pims_key -keystore $JBOSS_PIMSCONECTOR_HOME/server/INSTANCIA/conf/NOME_CHAVE.keystore -storepass SENHA_CHAVE -trustcacerts -file $ENDERECO_DO_CERTIFICADO/certificado_valido.cer |
Configurando instalação do JBoss com certificado *.keystore importado
A instalação do PIMSConnector já contém um certificado *.keystore com nome prx.keystore, localizado em $JBOSS_PIMSCONECTOR_HOME\server\INSTANCIA\conf\prx.keystore. Esse certificado está configurado em um conector SSL/TSL no arquivo $JBOSS_PIMSCONECTOR_HOME\PIMSConnector\jboss-6.1.0.pimsconnector\server\INSTANCIA\deploy\jbossweb.sar\server.xml, conforme seguinte trecho:
Bloco de código |
---|
language | xml |
---|
theme | Eclipse |
---|
firstline | 24 |
---|
title | Arquivo server.xml - Padrão |
---|
linenumbers | true |
---|
|
<!-- SSL/TLS Connector configuration using the admin devl guide keystore-->
<Connector protocol="HTTP/1.1" SSLEnabled="true"
port="${jboss.web.https.port}" address="${jboss.bind.address}"
scheme="https" secure="true" clientAuth="false"
keystoreFile="${jboss.server.home.dir}/conf/prx.keystore"
keystorePass="SENHA" sslProtocol = "TLS"
ciphers="SSL_RSA_WITH_RC4_128_MD5, SSL_RSA_WITH_RC4_128_SHA,
TLS_RSA_WITH_AES_128_CBC_SHA, TLS_DHE_RSA_WITH_AES_128_CBC_SHA,
TLS_DHE_DSS_WITH_AES_128_CBC_SHA, SSL_RSA_WITH_3DES_EDE_CBC_SHA,
SSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA, SSL_DHE_DSS_WITH_3DES_EDE_CBC_SHA" /> |
...
- keystoreFile - Informar a localização do novo arquivo *.keystore, importado do certificado *.cer;
- keystorePass - Informar a senha definida na importação do certificado; e
- ciphers - Remover esse atributo dado conector, para que o o JBoss utilize o valor default.
...
Bloco de código |
---|
language | xml |
---|
theme | Eclipse |
---|
firstline | 24 |
---|
title | Arquivo server.xml - Modificado |
---|
linenumbers | true |
---|
|
<!-- SSL/TLS Connector configuration using the admin devl guide keystore-->
<Connector protocol="HTTP/1.1" SSLEnabled="true"
port="${jboss.web.https.port}" address="${jboss.bind.address}"
scheme="https" secure="true" clientAuth="false"
keystoreFile="${jboss.server.home.dir}/conf/NOME_CHAVE.keystore"
keystorePass="SENHA" sslProtocol = "TLS" /> |
Aviso |
---|
|
- A porta usada para acesso HTTPS é o número da porta atual do PIMSConnector com a adição de 363. Por exemplo, se o PIMSConnector estiver configurado na porta HTTP 8080, então a porta HTTPS será a 8443. Para acessar o PIMSConnector via HTTPS digite na barra de endereço do navegador , para um servidor configurado com HTTP na porta 8080, digite https://localhosthost:8443/PIMSConnector, em que localhost é o na barra de endereço do navegador, trocando o host pelo IP do servidor e 8443 é a porta configurada 8080 com adição de 363.
- O navegador poderá exibir uma mensagem de certificado invalidodigital não confiável ao tentar abrir esse endereço, caso o mesmo não seja assinado por uma autoridade certificadoraservidor esteja ainda configurado com o certificado auto-assinado, prx.keystore.
|