Configuración del cifrado SSL
Si desea cifrar las transferencias de datos de RaptorXML+XBRL Server mediante el protocolo SSL, deberá:
•Generar una clave privada SSL y crear un archivo de certificado de clave pública SSL.
•Configurar RaptorXML+XBRL Server para la comunicación con cifrado SSL.
A continuación encontrará instrucciones para hacerlo.
Este método utiliza el kit de herramientas OpenSSL de código abierto para gestionar el cifrado SSL. Por tanto, los pasos que se describen en las instrucciones sólo funcionarán en equipos con OpenSSL. Por lo general, OpenSSL viene preinstalado en la mayoría de las versiones de Linux. También puede instalar OpenSSL en equipos de Windows. En la wiki de OpenSSL encontrará enlaces para descargar los binarios de instalación.
Para generar una clave privada y obtener un certificado de una entidad de certificación, siga estos pasos:
SSL requiere tener instalada una clave privada en RaptorXML+XBRL Server. Esta clave privada se utilizará para cifrar todos los datos de RaptorXML+XBRL Server. Para crear la clave privada utilice este comando de OpenSSL: openssl genrsa -out private.key 2048
Esto crea un archivo llamado private.key, que contiene la clave privada. Es importante recordar dónde guarda ese archivo. Necesitará la clave privada para (i) generar la solicitud de firma de certificado (CSR) e (ii) instalarla en RaptorXML+XBRL Server.
|
2.Solicitudes de firma de certificado (CSR)
La Petición de firma de Certificado (CSR) se envía a una entidad de certificación, como VeriSign o Thawte, para solicitar un certificado de clave pública. La CSR se basa en su clave privada y contiene información sobre su organización. Cree una CSR con este comando de OpenSSL (que suministra el archivo de clave privada, private.key, que se creó en el primer paso, como uno de sus parámetros): openssl req -new -nodes -key private.key -out my.csr
Durante la generación de la CSR deberá indicar datos sobre su compañía. Esta información la usará la entidad de certificación para confirmar la identidad de su empresa.
•País •Localidad (ciudad donde está situada su empresa) •Organización (el nombre de su empresa) No utilice caracteres especiales porque el certificado no será válido. •Nombre común (el nombre DNS de su servidor) Debe ser idéntico al nombre oficial de su servidor (es decir, debe ser el nombre DNS que utilizarán las aplicaciones cliente para conectarse al servidor. •Una contraseña de comprobación. Deje este campo vacío.
|
Compre un certificado SSL de una entidad de certificación reconocida, como son VeriSign o Thawte. Para el resto del procedimiento, siga los pasos que le indique VeriSign. El proceso con otras entidades de certificación es parecido.
•Vaya al sitio web de VeriSign. •Haga clic en Comprar certificados SSL. •Existen distintos tipos de certificados SSL que puede comprar. Para RaptorXML+XBRL Server es suficiente un certificado Secure Site o Secure Site Pro. Como no existe una barra de dirección verde no será necesaria una comprobación extendida (EV). •Siga el procedimiento de registro y rellene la información necesaria para la compra. •Cuando se le pida la CSR (creada en el paso n°2), copie y pegue el contenido del archivo my.csr en el formulario del pedido. •Efectúe el pago con una tarjeta de crédito válida.
|
4.Recibir la clave pública de la entidad de certificación
La entidad de certificación completará el proceso de inscripción en uno a tres días laborables. Durante este tiempo puede que reciba algún correo electrónico o alguna llamada para comprobar que está autorizado para solicitar un certificado SSL para su dominio DNS. Colabore con la autoridad para completar el proceso.
Una vez completado el proceso de registro y autorización, recibirá un correo electrónico con la clave pública de su certificado SSL. La clave pública estará en texto simple o adjunta como archivo .cer .
|
5.Guardar la clave pública en un archivo
Para poder usarla con RaptorXML+XBRL Server, la clave pública debe estar guardada en un archivo .pem. Si la clave pública se suministró como texto, copie y pegue todas las líneas entre estas dos:
--BEGIN CERTIFICATE-- ... --END CERTIFICATE--
en un archivo de texto al que debe llamar mycertificate.cer.
|
6.Guardar los certificados intermedios de la entidad de certificación en un archivo
Para completar el certificado SSL necesitará otros dos certificados: el certificado intermedio principal y el certificado intermedio secundario. Su entidad de certificación mostrará contenido de certificados intermedios en su sitio web.
•Certificados intermedios de Verisign: https://knowledge.verisign.com/support/ssl-certificates-support/index?page=content&id=AR657&actp=LIST&viewlocale=en_US •Certificados intermedios de Verisign para sus productos Secure Site: https://knowledge.verisign.com/support/ssl-certificates-support/index?page=content&id=AR1735
Copie y peque los dos certificados intermedios (primario y secundario) en dos archivos de texto distintos y guárdelos en su equipo.
|
Ahora cuenta con tres archivos de certificado:
•Clave pública (mycertificate.cer) •Certificado intermedio secundario •Certificado intermedio principal
Si lo desea, puede integrar sus certificados intermedios en su certificado de clave pública. Más abajo explicamos cómo hacerlo. (Como alternativa, puede utilizar el parámetro del archivo de configuración https.certificate-chain para especificar la ubicación de los certificados intermedios.)
Cada uno contiene bloques de texto enmarcados por líneas que tienen este aspecto: --BEGIN CERTIFICATE-- ... --END CERTIFICATE--
Ahora copie y pegue los tres certificados en un solo archivo, uno detrás del otro. El orden de aparición es importante: (i) primero la clave pública, (ii) después el certificado intermedio secundario y (iii) por último el certificado intermedio principal. Compruebe que no hay líneas vacías entre un certificado y el siguiente. --BEGIN CERTIFICATE-- public key from mycertificate.cer (ver paso 5) --END CERTIFICATE-- --BEGIN CERTIFICATE-- secondary intermediate certificate (ver paso 6) --END CERTIFICATE-- --BEGIN CERTIFICATE-- primary intermediate certificate (ver paso 6) --END CERTIFICATE--
Guarde el texto resultante en un archivo llamado publickey.cer. Este ya es el certificado de clave pública de su certificado SSL. Incluye el certificado de clave pública y la cadena de confianza (es decir, los certificados intermedios utilizados por la entidad de certificación para firmar el certificado. |