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

  1. 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 -keypasskey_password -keystorekeystorename .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.
  2. 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.
  3. 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
  4. 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
  5. Insira o keystore_password quando solicitado a fornecer uma senha.

  6. 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
  7. 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
  8. 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
  9. Importe o certificado digitando o seguinte comando:

    keytool -import -alias "AEMForms Cert" -fileAEMForms_cert .cer -keystoreJAVA_HOME \jre\lib\security\cacerts

  10. 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.

  11. Quando solicitado Trust this certificate? [no], tipo yes. A confirmação "O certificado foi adicionado ao armazenamento de chaves" é exibida.

  12. Se você estiver se conectando por SSL do Workbench, instale o certificado no computador do Workbench.

  13. 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"/>
    
  14. Altere o valor de keystoreFile atributo e a variável keystorePass atributo para a senha do keystore especificada quando você criou o keystore.

  15. 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
      • 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>
  16. 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

  1. 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 -keystorekeystorename .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.
  2. Digite o seguinte comando para gerar uma solicitação de certificado a ser enviada à autoridade de certificação:

    keytool -certreq -alias "Certificado AEMForms" -keystorekeystorename .keystore -fileAEMFormscertRequest.csr

  3. 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

  1. 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 -keystore keystorename.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.
  2. 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 -fileCACertificateName .crt -keystorekeystorename .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.
  3. Conclua as etapas 13 a 18 de Criar uma credencial SSL.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2