Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
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>&#160;</p>
	<h1 id="HTTPS-ÁreadeTransferência-Introdução">Introduction</h1>
	<p>
		<span style="color: rgb(85, 85, 85);">In communications with
			any&#160;<span style="color: rgb(85, 85, 85);">web application
				(</span><em>HTTPS</em><span style="color: rgb(85, 85, 85);">)
				through a&#160;</span><em>Java</em><span style="color: rgb(85, 85, 85);">&#160;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>&#160;</p>
	<h1 id="HTTPS-ÁreadeTransferência-DownloaddoCertificado">Certificate
		Download</h1>
	<p>
		The first step is to&#160;<em>download</em>&#160;the&#160;<em>SSL</em>&#160;certificate
		for the desired website, that is, the website to which you want to
		connect through java, by using&#160;<em>HTTPS</em>. The certificate
		can be easily downloaded through a&#160;<em>browser</em>. In the case
		of Chrome<em>,&#160;</em>after opening the Fluig address, follow the
		instructions below:
	</p>
	<p>&#160;</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;">&#160;</p>
	<p style="text-align: left;">&#160;</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>,&#160;as shown in the following image<strong>&#160;</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>&#160;</p>
	<p>&#160;</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;">&#160;</p>
	<p style="text-align: left;">&#160;</p>
	<ul>
		<li style="text-align: left;">After defining the name and
			location to export the&#160;<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:&#160;</span><em>&lt;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
maxLevel4
outlinetrue
stylenone
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 Chromeal 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
titleNota

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
languagebash
keytool -importcert -trustcacerts -alias <apelido>&lt;apelido> -file <caminho&lt;caminho para o certificado .crt> -keystore <caminho&lt;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>&#160;</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;">&lt;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;">&lt;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;">&lt;caminho para o
								cacerts></strong>
						</p></td>
					<td class="confluenceTd"><p>
							Enter the l<span>ocation in&#160;</span><em
								style="margin-left: 0.0px;">&lt;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>&#160;</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;">&#160;</p>
</div>