Configurando o SSL para o servidor da aplicação JBoss configuring-ssl-for-jboss-application-server
Para configurar o SSL no JBoss Application Server, você precisa de uma credencial SSL para autenticação. Você pode usar a ferramenta de chaves Java para criar uma credencial ou solicitar e importar uma credencial de uma autoridade de certificação (CA). Você deve então ativar o SSL no JBoss.
Você pode executar a ferramenta de chaves usando um único comando que inclui todas as informações necessárias para criar a área de armazenamento de chaves.
Neste procedimento:
[appserver root]
é o diretório inicial do servidor de aplicativos que executa formulários AEM.[type]
é um nome de pasta que varia, dependendo do tipo de instalação executada.
Criar uma credencial SSL create-an-ssl-credential
-
Em um prompt de comando, navegue até [INÍCIO: JAVA]/bin e digite o seguinte comando para criar a credencial e o keystore:
keytool -genkey -dname "CN=
Nome do host, OU=
Nome do grupo, O=
Nome da empresa,L=
Nome da cidade, S=
Estado, C=
Código do país"-alias "AEMForms Cert"
-keyalg RSA -keypass
key_password-keystore
keystorename.keystore
note note NOTE Substituir [JAVA_HOME]
com o diretório onde o JDK está instalado e substitua o texto em itálico por valores que correspondam ao seu ambiente. Nome do Host é o nome de domínio totalmente qualificado do servidor de aplicativos. -
Insira o
keystore_password
quando solicitado a fornecer uma senha. A senha do keystore e a chave devem ser idênticas.note note NOTE A variável keystore_password
A senha informada nesta etapa pode ser a mesma senha (key_password) inserida na etapa 1 ou diferente. -
Copie o keystorename.keystore para o
[appserver root]/server/[type]/conf
digitando um dos seguintes comandos:- (Windows Single Server)
copy
keystorename.keystore[appserver root]\standalone\configuration
- Cópia (Windows Server Cluster)
keystorename.keystore[appserver root]\domain\configuration
- (Linux Single Server)
cp keystorename.keystore [appserver root]/standalone/configuration
- (Cluster de servidores Linux)
cp <em>keystorename</em>.keystore<em>[appserver root]</em>/domain/configuration
- (Windows Single Server)
-
Exporte o arquivo de certificado digitando o seguinte comando:
- (Servidor único)
keytool -export -alias "AEMForms Cert" -file AEMForms_cert.cer -keystore [appserver root]/standalone/configuration/keystorename.keystore
- (Cluster de servidores)
keytool -export -alias "AEMForms Cert" -file AEMForms_cert.cer -keystore [appserver root]/domain/configuration/keystorename.keystore
- (Servidor único)
-
Insira o keystore_password quando solicitado a fornecer uma senha.
-
Copie o arquivo AEMForms_cert.cer para o [raiz do appserver] \conf digitando o seguinte comando:
- (Windows Single Server)
copy AEMForms_cert.cer [appserver root]\standalone\configuration
- (Cluster do Windows Server)
copy AEMForms_cert.cer [appserver root]\domain\configuration
- (Linux Single Server)
cp AEMForms _cert.cer [appserver root]\standalone\configuration
- (Cluster de servidores Linux)
cp AEMForms _cert.cer [appserver root]\domain\configuration
- (Windows Single Server)
-
Visualize o conteúdo do certificado digitando o seguinte comando:
keytool -printcert -v -file [appserver root]\standalone\configuration\AEMForms_cert.cer
keytool -printcert -v -file [appserver root]\domain\configuration\AEMForms_cert.cer
-
Para fornecer acesso de gravação ao arquivo cacerts no
[JAVA_HOME]\jre\lib\security
, se necessário, execute as seguintes tarefas:- (Windows) Clique com o botão direito do mouse no arquivo cacerts, selecione Propriedades e desmarque o atributo Somente leitura.
- Tipo (Linux)
chmod 777 cacerts
-
Importe o certificado digitando o seguinte comando:
keytool -import -alias "AEMForms Cert" -file
AEMForms_cert.cer -keystore
JAVA_HOME\jre\lib\security\cacerts
-
Tipo
changeit
como a senha. Esta senha é a senha padrão para uma instalação do Java e pode ter sido alterada pelo administrador do sistema. -
Quando solicitado
Trust this certificate? [no]
, tipoyes
. A confirmação "O certificado foi adicionado ao armazenamento de chaves" é exibida. -
Se você estiver se conectando por SSL do Workbench, instale o certificado no computador do Workbench.
-
Em um editor de texto, abra os seguintes arquivos para edição:
-
Servidor único -
[appserver root]
/standalone/configuration/lc_<dbname turnkey="">.xml -
Cluster de servidores -
[appserver root]
/domain/configuration/host.xml -
Cluster de servidores -
[appserver root]
/domain/configuration/domain_<dbname>.xml
-
-
- Para um único servidor, no lc_<dbaname tunkey="">.xml, adicione o seguinte depois de <security-realms> seção:
code language-xml <security-realm name="SSLRealm"> <server-identities> <ssl> <keystore path="C:/Adobe/Adobe_Experience_Manager_Forms/jboss/standalone/configuration/aemformses.keystore" keystore-password="changeit" alias="AEMformsCert" key-password="changeit"/> </ssl> </server-identities> </security-realm>
Localize o
<server>
seção presente após o seguinte código:<http-listener name="default" socket-binding="http" redirect-socket="https" max-post-size="104857600"/>
Adicione o seguinte à <server> seção presente após o código acima:
code language-xml <https-listener name="default-secure" socket-binding="https" security-realm="SSLRealm"/>
- Para cluster de servidores, no [raiz do appserver]\domain\configuration\host.xml em todos os nós, adicione o seguinte depois de <security-realms> seção:
code language-xml <security-realm name="SSLRealm"> <server-identities> <ssl> <keystore path="C:/Adobe/Adobe_Experience_Manager_Forms/jboss/standalone/configuration/aemformses.keystore" keystore-password="changeit" alias="AEMForms Cert" key-password="changeit"/> </ssl> </server-identities> </security-realm>
No nó primário do Cluster de Servidores, no campo [raiz do appserver]\domain\configuration\domain_<dbname>.xml, localize o <server> seção presente após o seguinte código:
<http-listener name="default" socket-binding="http" redirect-socket="https" max-post-size="104857600"/>
Adicione o seguinte à <server> seção presente após o código acima:
code language-xml <https-listener name="default-secure" socket-binding="https" security-realm="SSLRealm"/>
-
Altere o valor de
keystoreFile
atributo e a variávelkeystorePass
atributo para a senha do keystore especificada quando você criou o keystore. -
Reinicie o servidor de aplicativos:
-
Para instalações prontas para uso:
- No Painel de Controle do Windows, clique em Ferramentas Administrativas e em Serviços.
- Selecione JBoss para o Adobe Experience Manager Forms.
- Selecione Ação > Parar.
- Aguarde até que o status do serviço apareça como interrompido.
- Selecione Ação > Iniciar.
-
Para instalações do JBoss pré-configuradas ou configuradas manualmente pelo Adobe:
-
Em um prompt de comando, navegue até
[appserver root]
/bin. -
Pare o servidor digitando o seguinte comando:
- (Windows)
shutdown.bat -S
- (Linux)
./shutdown.sh -S
- (Windows)
-
Aguarde até que o processo JBoss tenha sido totalmente desligado (quando o processo JBoss retornar o controle para o terminal em que foi iniciado).
-
Inicie o servidor digitando o seguinte comando:
- (Windows)
run.bat -c <profile>
- (Linux)
./run.sh -c <profile>
- (Windows)
-
-
-
Para acessar o console de administração usando SSL, digite
https://[host name]:'port'/adminui
em um navegador da web:A porta SSL padrão para JBoss é 8443. A partir daqui, especifique esta porta ao acessar formulários AEM.
Solicitar uma credencial de uma autoridade de certificação request-a-credential-from-a-ca
-
Em um prompt de comando, navegue até [INÍCIO: JAVA]/bin e digite o seguinte comando para criar o keystore e a chave:
keytool -genkey -dname "CN=
Nome do host, OU=
Nome do grupo, O=
Nome da empresa, L=
Nome da cidade, S=
Estado, C=
Código do país"-alias "AEMForms Cert"
-keyalg RSA -keypass
-key_password-keystore
keystorename.keystore
note note NOTE Substituir [JAVA_HOME]
com o diretório onde o JDK está instalado e substitua o texto em itálico por valores que correspondam ao seu ambiente. -
Digite o seguinte comando para gerar uma solicitação de certificado a ser enviada à autoridade de certificação:
keytool -certreq -alias
"Certificado AEMForms"-keystore
keystorename.keystore -file
AEMFormscertRequest.csr -
Quando a solicitação de um arquivo de certificado for atendida, conclua o próximo procedimento.
Usar uma credencial obtida de uma CA para habilitar o SSL use-a-credential-obtained-from-a-ca-to-enable-ssl
-
Em um prompt de comando, navegue até
[JAVA HOME]
/bin e digite o seguinte comando para importar o certificado raiz da CA com a qual o CSR foi assinado:keytool -import -trustcacerts -file
rootcert.pem -keystorekeystorename.keystore -alias root
Se o certificado raiz não estiver no navegador, importe-o também para lá.
note note NOTE Substituir [JAVA_HOME]
com o diretório onde o JDK está instalado e substitua o texto em itálico por valores que correspondam ao seu ambiente. -
Em um prompt de comando, navegue até
[JAVA HOME]
/bin e digite o seguinte comando para importar a credencial para o keystore:keytool -import -trustcacerts -file
CACertificateName.crt -keystore
keystorename.keystore
note note NOTE - Substituir
[JAVA_HOME]
com o diretório onde o JDK está instalado e substitua o texto em itálico por valores que correspondam ao seu ambiente. - O certificado assinado CA importado substituirá um certificado público autoassinado, se ele existir.
- Substituir
-
Conclua as etapas 13 a 18 de Criar uma credencial SSL.