# Como habilitar a porta SSL no Exchange Reporter Plus O objetivo deste documento é ajudá-lo a configurar a certificação SSL no Exchange Reporter Plus. A certificação SSL protege todas as informações confidenciais enviadas entre os navegadores dos usuários e o servidor Exchange Reporter Plus, criptografando e transmitindo as informações por meio de um canal seguro. O Exchange Reporter Plus é um software baseado na web, por isso é importante proteger a comunicação entre o navegador e o servidor da solução. SSL é uma tecnologia de segurança padrão para estabelecer um canal seguro criptografado para comunicação entre navegadores e servidores e também é usado para proteger a comunicação do Exchange Reporter Plus. Este documento explica detalhadamente sobre: ### [Etapa 1: Como habilitar o SSL no Exchange Reporter Plus](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#s1) ### [Etapa 2: A criação um arquivo CSR e envio para uma autoridade de certificação](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#s2) - [Criação de um arquivo KEYSTORE](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#f1) - [Criação de um arquivo CSR (Solicitação de Assinatura de Certificado)](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#f2) - [Adição do certificado assinado pela autoridade de certificação ao keystore](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#f3) ### [Etapa 3: Associação do Exchange Reporter Plus ao certificado assinado](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#s3) ## Etapa 1: Como habilitar o SSL no Exchange Reporter Plus 1. Faça login no **Exchange Reporter Plus** com credenciais de administrador. 2. Vá para **Configurações > Admin > Configurações gerais > Configurações do produto.** 3. Em Configurações da conexão, marque a caixa **Habilitar porta SSL [https]**. 4. Insira um **número de porta** (somente se requisitado). 5. Clique em **Salvar.** 6. **Reinicie** o Exchange Reporter Plus. ![enabling-ssl-in-exchange-reporter-plus](https://www.manageengine.com/br/exchange-reports/images/enabling-ssl-in-exchange-reporter-plus.png) ## Etapa 2: A criação um arquivo CSR e envio para uma autoridade de certificação O Exchange Reporter Plus usa o servidor Tomcat para os arquivos **Keystore** e **CSR** específicos que precisam ser criados antes de solicitar certificados de uma autoridade de certificação. Siga as etapas abaixo: ### A. Criação de um arquivo KEYSTORE 1. Abra o **Prompt de comando.** 2. Navegue até a pasta **\jre\bin** e execute o seguinte comando: ``` keytool -genkey -alias tomcat -keypass -keyalg RSA -validity 1000 -keystore .keystore ``` 3. Após executar o comando acima, você será solicitado a responder às seguintes perguntas: - Insira a senha do keystore. (Insira a senha da chave que você usou no comando acima ou use caracteres simples como **changeit**.) - Qual é o seu nome e sobrenome? (Você pode fornecer o nome da máquina ou o nome de domínio totalmente qualificado (FQDN) do servidor que hospeda o Exchange Reporter Plus aqui.) - Qual é o nome da sua unidade organizacional? - Qual é o nome da sua organização? - Qual é o nome da sua cidade ou localidade? - Qual é o nome do seu estado ou província? - Qual é o código do país de duas letras para esta unidade? ![creating-a-keystore-file](https://www.manageengine.com/br/exchange-reports/images/creating-a-keystore-file.png) Depois de responder a essas perguntas, confirme que as informações inseridas estão corretas para que o **arquivo keystore** seja criado. ### B. Criação de um arquivo CSR (Solicitação de Assinatura de Certificado) 1. Abra o **Prompt de comando.** 2. Navegue até a pasta **\jre\bin** e execute o seguinte comando: ``` keytool -certreq -alias tomcat -keyalg RSA -keystore .keystore -file .csr ``` **Observação:** O **arquivo CSR** deve ser enviado à autoridade certificadora (AC) para receber arquivos de certificado assinados pela CA. Consultes as etapas fornecidas no [Apêndice A](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#appendixA) para solicitar um certificado de uma AC interna. ### C. Adição de um certificado assinado pela autoridade de certificação ao keystore **Observação:** Para adicionar certificados SSL assinados pela AC ao keystore, use as instruções listadas para os fornecedores específicos abaixo. Essas instruções podem mudar dependendo do certificado emitido pela AC. Certifique-se de substituir os valores de exemplo fornecidos dentro de <>. 1. Faça download e descompacte os **arquivos de certificado** fornecidos por sua AC. 2. Abra um **Prompt de comando** elevado e navegue até a pasta **\jre\bin**. (Por padrão: C:\ManageEngine\Exchange Reporter Plus\jre\bin.) 3. Para importar o certificado para um arquivo **.keystore**, execute os comandos da lista abaixo (conforme aplicável à sua AC): - **[Se a sua AC for o GoDaddy](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#g1)** - **[Se a sua AC for o Verisign](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#g1)** - **[Se a sua AC for o Comodo](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#g1)** #### Adicionar certificado assinado para autoridade certificadora: GoDaddy ``` keytool -import -alias root -keystore .keystore -trustcacerts -file gd_bundle.crt keytool -import -alias cross -keystore .keystore -trustcacerts -file gd_cross_intermediate.crt keytool -import -alias intermediate -keystore .keystore -trustcacerts -file gd_intermediate.crt keytool -import -alias -keystore .keystore -trustcacerts -file .crt ``` #### Adicionar certificado assinado para autoridade certificadora: Verisign ``` keytool -import -alias intermediateCA -keystore .keystore -trustcacerts -file .cer keytool -import -alias -keystore .keystore -trustcacerts -file .cer ``` #### Adicionar certificado assinado para autoridade certificadora: Comodo ``` keytool -import -trustcacerts -alias root -file AddTrustExternalCARoot.crt -keystore .keystore keytool -import -trustcacerts -alias addtrust -file UTNAddTrustServerCA.crt -keystore .keystore keytool -import -trustcacerts -alias ComtodoUTNServer -file ComodoUTNServerCA.crt -keystore .keystore keytool -import -trustcacerts -alias essentialSSL -file essentialSSLCA.crt -keystore .keystore keytool -import -trustcacerts -alias -file .crt -keystore .keystore ``` ## Etapa 3: Associação do Exchange Reporter Plus ao certificado assinado Dependendo se o certificado é para um único domínio ou para um certificado de vários domínios/curinga, as etapas podem variar. - **[Para um certificado SSL de domínio único](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#h1)** - **[Para um certificado multidomínio ou curinga](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#h2)** ### A. Para um certificado SSL de domínio único **Observação:** Se o seu certificado estiver em CER, CRT, PEM ou qualquer outro formato, converta-o primeiro para o formato P7B e depois prossiga com a instalação. Consulte o [Apêndice B](https://www.manageengine.com/br/exchange-reports/kb/how-to-enable-ssl-port-in-exchange.html#appendixB) para saber como converter certificados para o formato P7B. **Etapas para instalar o certificado P7B no Exchange Reporter Plus** 1. Coloque o **arquivo P7B** em **\jre\bin.** (Por padrão: C:\ManageEngine\Exchange Reporter Plus\jre\bin.) 2. Abra um **Prompt de comando** elevado e navegue até **\jre\bin.** 3. Execute o seguinte comando: ``` keytool -import -alias tomcat -trustcacerts -file cert.p7b -keystore .keystore ``` 4. Copie o arquivo keystore para: **\conf** (por padrão: C:\ManageEngine\Exchange Reporter Plus\conf). 5. Faça backup do arquivo **server.xml** em **\conf**. 6. Edite o arquivo **server.xml** substituindo o valor das seguintes tags do conector SSL na parte inferior da página: - **keystoreFile** com **./conf/.keystore** - **keystorePass** com qualquer senha que você inseriu durante a geração do CSR. Por exemplo: ``` ``` 7. **Salve** as alterações. 8. **Reinicie** o Exchange Reporter Plus. Se você conseguir visualizar o console de login do Exchange Reporter Plus sem qualquer aviso do navegador, você instalou com êxito seu certificado SSL no Exchange Reporter Plus. ### B. Para um certificado multidomínio ou curinga 1. Copie o arquivo de certificado **PFX/PKCS12** e cole-o no caminho **\conf.** (Por padrão: C:\ManageEngine\Exchange Reporter Plus\conf.) 2. Abra o arquivo **server.xml** (presente em **\conf**) em um editor de texto de sua escolha. Vá até o final do arquivo XML e procure a **Tag do conector** que começa com ``. 3. Agora, edite os seguintes valores dentro da tag do conector: ``` keystoreFile="./conf/.pfx" keystorePass="" keystoreType="PKCS12" ``` Por exemplo: ``` ``` 4. **Reinicie** o Exchange Reporter Plus. Se você conseguir visualizar o console de login do Exchange Reporter Plus sem qualquer aviso do navegador, você instalou com êxito seu certificado SSL no Exchange Reporter Plus. ## Apêndice A **Solicitar um certificado da Microsoft Certificate Services (AC interna)** 1. Conecte-se ao **Microsoft Certificate Services** e clique no link **Solicitar um certificado**. 2. Clique em **Solicitação avançada de certificado.** 3. Envie uma solicitação de certificado usando um arquivo **CMC ou PKCS #10** codificado em base 64 ou envie uma solicitação de renovação usando um arquivo **PKCS #7** codificado em base 64. 4. Abra o **arquivo CSR** usando um editor, copie o conteúdo e cole-o em **Solicitação salva.** 5. Selecione **Servidor da web** como **Modelo de certificado.** 6. Clique no botão **Enviar.** 7. O certificado será emitido quando você clicar no link **Fazer download da cadeia do certificado** e selecionar os tipos de **Certificados PKCS #7**. O nome do arquivo baixado deve ser **certnew.p7b.** **Observação:** Copie e cole o arquivo do certificado na pasta **\jre\bin**. 8. Clique na guia **Página inicial** no canto superior direito e clique em **Fazer download de uma certificado AC, certificado de cadeia ou link do CRL** para fazer download do **certificado raiz da AC.** 9. Clique no link **Fazer download de certificado AC** e salve o certificado raiz. O nome do arquivo baixado deve ser **certnew.cer.** **Observação:** Copie e cole o **arquivo do certificado** na pasta **\jre\bin**. 10. Navegue até **\jre\bin** usando o prompt de comando para importar o certificado da AC interna para arquivo **.keystore** executando o seguinte comando: ``` keytool -import -trustcacerts -alias tomcat -file certnew.p7b -keystore .keystore ``` 11. Adicione o certificado raiz da sua AC interna à lista de ACs confiáveis no arquivo Java cacerts executando o seguinte comando: ``` keytool -import -alias -keystore ..\lib\security\cacerts -file certnew.cer ``` **Observação:** Abra o arquivo **certnew.cer** para obter o nome da AC interna e fornecer uma senha adequada quando solicitado. ## Apêndice B **Etapas para converter certificados CER, CRT e PEM para o formato P7B** 1. Clique duas vezes no **certificado do domínio** para abri-lo na janela **Certificado**. 2. Na guia **Detalhes**, clique em **Copiar para arquivo.** ![steps-to-convert-p7b-format](https://www.manageengine.com/br/exchange-reports/images/steps-to-convert-p7b-format.png)