CITSmart 8
Executar a Instalação

Instalando Certificado SSL

A instalação de um certificado SSL é obrigatória para funcionamento da ferramenta CITSmart. Existem duas formas de configurar um certificado SSL em nossos cenários:

  • Gerando e utilizando auto assinado.
  • Utilizando um certificado válido com uma cadeia de certificação válida.

Gerando e utilizando um certificado auto assinado pelo Java

A forma como você acessa o CITSmart altera a maneira de geração do certificado SSL. Existem duas possibilidades de acessar o URL do sistema:

A geração do certificado em ambos casos é ligeiramente diferente. Abaixo o procedimento válido par ambos os casos.

Criando um certificado para uma entrada de DNS

Abaixo o comando para se gerar um certificado SSL para uma entrada de DNS chamada citsmart.example.com. Lembre-se de alterar os seguintes parâmetros abaixo:

  • KEY_NAME: Um nome para chave/arquivo. Exemplo CITSmartV1.
  • citsmart.example.com: Altere para entrada de DNS que você criou para sua aplicação.
  • validity 365: Tempo de validade da chave em dias. Dependendo do requisito de segurança interno de sua instituição, defina esse valor. Após atingido o limite de tempo, o certificado irá se expirar e será necessário gerar outro. Definia o tempo que achar melhor apropriado. No exemplo o certificado vale por 1 ano 365 dias).
  • PASSWORD: Uma senha para o certificado. Exemplo password123456
Shell


Quando o comando for executado, será realizada uma série de perguntas, no qual poderá ser respondidas ou não (o preenchimento é opcional). Caso não queira preencher as informações, digite [enter] para todas, com exceção da última que precisará ser respondido `yes.

Shell


Criando um certificado para um endereço IP

Abaixo o comando para se gerar um certificado SSL para um acesso feito diretamente por IP, por exemplo 192.168.0.40. Lembre-se de alterar os seguintes parâmetros abaixo:

  • KEY_NAME: Um nome para chave/arquivo. Exemplo CITSmartV1.
  • 192.168.0.40: Altere para o endereço IP que está respondendo o CITSmart.
  • validity 365: Tempo de validade da chave em dias. Dependendo do requisito de segurança interno de sua instituição, defina esse valor. Após atingido o limite de tempo, o certificado irá se expirar e será necessário gerar outro. Definia o tempo que achar melhor apropriado. No exemplo o certificado vale por 1 ano 365 dias).
  • PASSWORD: Uma senha para o certificado. Exemplo password123456
Shell


Quando o comando for executado, será realizada uma série de perguntas, no qual poderá ser respondidas ou não (o preenchimento é opcional). Caso não queira preencher as informações, digite [enter] para todas, com exceção da última que precisará ser respondido `yes.

Shell


Gerando o arquivo .cer e importando para o cacerts

O próximo passo é a geração do arquivo de certificado .cer. Para gerar o arquivo, execute o comando abaixo substituindo os valores (como nome do keystore e tempo) de acordo com keystore gerado nos comandos anteriores. No momento que executar o comando, será solicitada a senha gerada nos passos anteriores.

Shell


Agora é necessário importar o arquivo .cer para o cacerts do Java. Execute o comando abaixo para realizar a importação. No momento que executar o comando, será solicitada a senha do cacerts (a senha padrão do aplicativo Java caso não tenha alterado é changeit). Altere os nome dos arquivos de acordo com o que que fora gerado anteriormente. No final do comando responda [yes] para prosseguir.

Shell


Para finalizar, qualquer que tenha sido a forma escolhida, mude o proprietário do keystore para o wildfly, substituindo o exemplo abaixo pelo nome do seu certificado caso tenha alterado:

Shell


Gerando o keystore com certificado válido

Caso você tenha um certificado válido, com uma cadeia de certificação válida, é necessário importar o certificado para o Java. Para isso, utilize o comando abaixo. Lembre-se de alterar os seguintes parâmetros:

  • CERTIFICADO.p12: O nome do seu certificado p12 que você deve fazer upload para o servidor via scp.
  • ALIAS_CERT: Um apelido (nome) para o certificado.
  • CERTIFICADO.jks: O nome do arquivo de keystore que será gerado.
Shell


Uma vez gerado o arquivo do keystore, é necessário importá-lo para o cacerts (mesmo procedimento de importação utilizado na geração do certificado auto assinado)

Configurando o keystore no wildfly

Acesse o wildfly no modo CLI e dê os comandos abaixo substituindo os valores pelos nomes dos arquivos criados anteriormente:

Shell


Dê um reload, e saia do CLI:

Shell