HTML |
---|
<div id="main-content" class="wiki-content group">
<h1 id="HTTPS-ÁreadeTransferência-Índice">Contents</h1>
<p>
<style type='text/css'>/*<![CDATA[*/
div.rbtoc1412695400621 {
padding: 0px;
}
div.rbtoc1412695400621 ul {
list-style: none;
margin-left: 0px;
}
div.rbtoc1412695400621 li {
margin-left: 0px;
padding-left: 0px;
}
/*]]>*/
</style>
<div class='toc-macro rbtoc1412695400621'>
<ul class='toc-indentation'>
<li><span class='TOCOutline'>1</span> <a
href='#HTTPS-ÁreadeTransferência-Objetivo'>Objective</a></li>
<li><span class='TOCOutline'>2</span> <a
href='#HTTPS-ÁreadeTransferência-Introdução'>Introduction</a></li>
<li><span class='TOCOutline'>3</span> <a
href='#HTTPS-ÁreadeTransferência-DownloaddoCertificado'>Certificate
Download</a></li>
<li><span class='TOCOutline'>4</span> <a
href='#HTTPS-ÁreadeTransferência-Instalaçãodocertificado'>Certificate
Installation</a></li>
</ul>
</div>
</p>
<h1 id="HTTPS-ÁreadeTransferência-Objetivo">Objective</h1>
<p>The objective of this guide is to instruct the user who uses the
"Transfer Area" feature to post documents in HTTPS environment.</p>
<p> </p>
<h1 id="HTTPS-ÁreadeTransferência-Introdução">Introduction</h1>
<p>
<span style="color: rgb(85, 85, 85);">In communications with
any <span style="color: rgb(85, 85, 85);">web application
(</span><em>HTTPS</em><span style="color: rgb(85, 85, 85);">)
through a </span><em>Java</em><span style="color: rgb(85, 85, 85);"> application
(Web or Desktop), an inconsistency may occur in which the Java
application attempts to communicate with the site through HTTPS, as
it does not have an SSL certificate associated with it. To
troubleshoot, follow the steps below. the procedure must be
performed on each of the client’s station.</span>
</span>
</p>
<p>
<img
class="confluence-embedded-image confluence-content-image-border image-center"
width="500" src="attachments/146178992/146113150.png"
data-image-src="attachments/146178992/146113150.png">
</p>
<p style="text-align: center;">
<strong>Figure 1 - Error message when there is no valid
certificate.</strong>
</p>
<p style="text-align: center;">
<strong><br /></strong>
</p>
<p>
<em><br /></em>
</p>
<div class="aui-message warning shadowed information-macro">
<span class="aui-icon icon-warning">Icon</span>
<div class="message-content">
<p>
<span style="color: rgb(56, 56, 56);">This guide has been
specially written for Java 7.</span>
</p>
</div>
</div>
<p> </p>
<h1 id="HTTPS-ÁreadeTransferência-DownloaddoCertificado">Certificate
Download</h1>
<p>
The first step is to <em>download</em> the <em>SSL</em> certificate
for the desired website, that is, the website to which you want to
connect through java, by using <em>HTTPS</em>. The certificate
can be easily downloaded through a <em>browser</em>. In the case
of Chrome<em>, </em>after opening the Fluig address, follow the
instructions below:
</p>
<p> </p>
<ul>
<li style="text-align: left;">Click the Padlock Icon located in
the address bar.</li>
<li style="text-align: left;">In the </strong>Connection<strong>
tab click on <strong>Certificate information</strong>, as shown in
the following image:</li>
</ul>
<p>
<img class="confluence-embedded-image image-center" width="500"
src="attachments/146178992/146117772.png"
data-image-src="attachments/146178992/146117772.png">
</p>
<p style="text-align: center;">
<strong>Figure 2</strong> <strong>- Screen with the
information of URL accessed</strong>
</p>
<p style="text-align: left;"> </p>
<p style="text-align: left;"> </p>
<ul>
<li style="text-align: left;">On the certificate screen, access
the </strong>Details<strong> tab and click on <strong>Copy
to File</strong><strong>...</strong>, as shown in the following image<strong> </strong>:
</li>
</ul>
<p>
<img class="confluence-embedded-image image-center"
src="attachments/146178992/146117773.png"
data-image-src="attachments/146178992/146117773.png">
</p>
<p style="text-align: center;">
<strong>Figure 3 - Screen with the details of the certificate</strong>
</p>
<p> </p>
<p> </p>
<ul>
<li>On the <strong>Certificate Export Wizard</strong> screen,
click <strong>Next</strong> until you reach the <strong>Image
5</strong> screen, referring to the <strong>Export File Format:</strong></li>
</ul>
<p>
<img class="confluence-embedded-image image-center"
src="attachments/146178992/146117774.png"
data-image-src="attachments/146178992/146117774.png">
</p>
<p style="text-align: center;">
<strong>Figure 4 - Certificate Export Wizard screen</strong>
</p>
<p style="text-align: center;">
<strong><br /></strong>
</p>
<p>
<img class="confluence-embedded-image image-center"
src="attachments/146178992/146117776.png"
data-image-src="attachments/146178992/146117776.png">
</p>
<p style="text-align: center;">
<strong>Figure 5</strong><strong> -Certificate export wizard
screen</strong>
</p>
<p style="text-align: center;">
<strong><br /></strong>
</p>
<p>
<img class="confluence-embedded-image image-center"
src="attachments/146178992/146117778.png"
data-image-src="attachments/146178992/146117778.png">
</p>
<p style="text-align: center;">
<strong>Figure 6</strong> - <strong>Certificate Export Wizard
screen</strong>
</p>
<p style="text-align: left;"> </p>
<p style="text-align: left;"> </p>
<ul>
<li style="text-align: left;">After defining the name and
location to export the <em>.CER</em> file, proceed and click <strong>Finish</strong>,
as shown in the following image:
</li>
</ul>
<p>
<em><img class="confluence-embedded-image image-center"
src="attachments/146178992/146117779.png"
data-image-src="attachments/146178992/146117779.png"></em>
</p>
<p style="text-align: center;">
<strong>Figure 7</strong> - <strong>Certificate Export Wizard
screen</strong>
</p>
<p style="text-align: left;">
<em><br /></em>
</p>
<p style="text-align: left;">
<em><br /></em>
</p>
<h1 id="HTTPS-ÁreadeTransferência-Instalaçãodocertificado">Certificate
Installation</h1>
<p>
<span style="color: rgb(85, 85, 85);">The next step is to
install the certificate in the local certificate base of java.
Usually located at: </span><em><JAVAHOME>/jre7/lib/security/cacerts</em>
</p>
<div class="aui-message warning shadowed information-macro">
<p class="title">Note</p>
<span class="aui-icon icon-warning">Icon</span>
<div class="message-content">
<p>
<span style="color: rgb(56, 56, 56);">If you are working in
Windows, you have to execute cmd.exe in administrator mode, so that
the process may continue.</span>
</p>
</div>
</div>
<p>
<span style="color: rgb(85, 85, 85);"><br /></span>
</p>
<ul>
<li><span style="color: rgb(85, 85, 85);">Open the command
line terminal and execute:</span></li>
</ul>
<div class="code panel pdl" style="border-width: 1px;">
<div class="codeContent panelContent pdl">
<pre class="theme: Confluence; brush: bash; gutter: false"
style="font-size: 12px;">keytool |
Índice
Table of Contents |
---|
maxLevel | 4 |
---|
outline | true |
---|
style | none |
---|
exclude | .*ndice |
---|
|
Objetivo
El objetivo de esta guía es orientar al usuario que esté utilizando la función "Área de Transferencia" para publicar documentos en ambiente HTTPS.
Introducción
En comunicaciones con alguna aplicación web (HTTPS) a través de una aplicación Java (Web o Desktop) puede ocurrir una inconsistencia en el momento en que la aplicación Java intenta comunicarse con el site usando HTTPS, por no tener un certificado SSL asociado. Para solucionar, siga los pasos detallados a seguir, el procedimiento se debe realizar en cada estación cliente.
Image Removed
Figura 1 - Mensaje de error cuando no hay certificado válido.
Note |
---|
Esta guía fue especialmente escrita para Java 7. |
Download del Certificado
El primer paso es hacer el download del certificado SSL del site deseado, es decir, del site en el cual desea conectarse a través del java usando HTTPS. El download del certificado puede ser realizado fácilmente a través de un navegador. En el caso del Chrome, al abrir la dirección del Fluig, siga las instrucciones a continuación:
- Haga clic en el Ícono del candado ubicado en la barra de dirección.
- En la guía Conexión haga clic en el link Informaciones del certificado, conforme a la imagen a seguir:
Image Removed
Figura 2 - Pantalla con las informaciones del certificado de la URL accedida
- En la pantalla de Certificado, acceda la guía Detalles y haga clic en el botón Copiar para Archivo... conforme a la imagen a seguir:
Image Removed
Figura 3 - Pantalla con los detalles del certificado
- En la pantalla Asistente para Exportación de Certificados, haga clic en Avanzar hasta llegar a la pantalla de la Imagen 5, referente al Formato del Archivo de Exportación:
Image Removed
Figura 4 - Pantalla de la Wizard de exportación del certificado
Image Removed
Figura 5 - Pantalla de la Wizard de exportación del certificado
Image Removed
Figura 6 - Pantalla de la Wizard de exportación del certificado
- Después de definir el nombre y el lugar para exportar el archivo .cer, avance y haga clic en el botón Concluir, conforme a la imagen a seguir:
Image Removed
Figura 7 - Pantalla de la Wizard de exportación del certificado
Instalación del certificado
El próximo paso es instalar el certificado dentro de la base local de certificados del java. Normalmente ubicado en: <JAVAHOME>/jre7/lib/security/cacerts.
Note |
---|
|
En el caso que esté trabajando en el Windows, será necesario ejecutar el cmd.exe en el modo administrador, para dar continuidad en este proceso. |
- Abra la terminal de línea de comando y ejecute:
Code Block |
---|
|
keytool -importcert -trustcacerts -alias <apelido><apelido> -file <caminho<caminho para o certificado .crt> -keystore <caminho<caminho para o cacerts> -storepass changeit |
Los parámetros del comando anterior, se deben alterar conforme a seguir:
Parámetro | Descripción |
<apellido> | Informar nombre para identificar el certificado que se instalará en la base |
<camino para el certificado .crt> | Informar el camino en el que se guardó el certificado |
<camino para el cacerts> | Informar ubicación en <JAVAHOME>/jre7/lib/security/cacerts |
-storepass changeit | “changeit” es la contraseña estándar para la manipulación de la base de certificados Java. No se debe modificar |
- Después de la ejecución y confirmación del comando anterior, el certificado estará instalado en la base local de certificados del Java. Se presentarán los detalles del certificado importado, conforme a la Figura 8:
Image Removed
Figura 8 - Pantalla con los detalles del certificado importado
No es necesario reiniciar la máquina después de ejecutar los procedimientos anteriormente citados, aconsejamos apenas que se reinicie el navegador.
...
changeit</pre>
</div>
</div>
<p> </p>
<p>The parameters of the command above should be amended as
follows:</p>
<div class="table-wrap">
<table class="confluenceTable">
<tbody>
<tr>
<td class="highlight confluenceTd"><p align="center">
<span style="color: rgb(0, 51, 102);">Parameter</span>
</p></td>
<td class="highlight confluenceTd"><p align="center">
<span style="color: rgb(0, 51, 102);">Description</span>
</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>
<strong style="margin-left: 0.0px;"><apelido></strong>
</p></td>
<td class="confluenceTd"><p>
<span>Enter the name to identify the certificate to be
installed on the base</span>
</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>
<strong style="margin-left: 0.0px;"><caminho para o
certificado .crt></strong>
</p></td>
<td class="confluenceTd"><p>
<span>Enter the path in which the certificate was saved</span>
</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>
<strong style="margin-left: 0.0px;"><caminho para o
cacerts></strong>
</p></td>
<td class="confluenceTd"><p>
Enter the l<span>ocation in </span><em
style="margin-left: 0.0px;"><JAVAHOME>/jre7/lib/security/cacerts</em>
</p></td>
</tr>
<tr>
<td colspan="1" class="confluenceTd"><em><strong
style="margin-left: 0.0px;">-storepass changeit</strong></em></td>
<td colspan="1" class="confluenceTd"><span>“changeit”
is the default password for manipulating the <em>Java</em>
certificates base. It should not be changed.
</span></td>
</tr>
</tbody>
</table>
</div>
<p> </p>
<ul>
<li
style="color: rgb(85, 85, 85); font-size: 10.0pt; line-height: 13.0pt;"><span
style="color: rgb(85, 85, 85); font-size: 10.0pt; line-height: 13.0pt;">After
executing and confirming the previous command, the certificate will
be installed in the local certificate base of Java. </span>Details of the
imported certificate will be displayed, a shown in <strong>Figure
8</strong>:</li>
</ul>
<p>
<img class="confluence-embedded-image image-center"
src="attachments/146178992/146117804.png"
data-image-src="attachments/146178992/146117804.png">
</p>
<p style="text-align: center;">
<strong>Figure 8 - Certificate details screen</strong>
</p>
<p style="text-align: center;">
<strong><br /></strong>
</p>
<p style="text-align: left;">It is not necessary to reboot the
machine after executing the above procedures, although we recommend
restarting the browser.</p>
<p style="text-align: left;"> </p>
</div>
|