Presentación
Este artículo cubre la configuración de certificados SSL personalizados en el área Gestión de dominios de la plataforma.
Los certificados SSL son necesarios en la plataforma para asegurar sus dominios personalizados y secundarios.
Al configurar un dominio personalizado o secundario en la plataforma, tendrá la opción de utilizar un certificado gestionado por la plataforma o bien un certificado SSL personalizado que haya adquirido usted mismo:
- Si planea elegir un certificado gestionado por la plataforma, no necesita realizar las configuraciones descritas en este artículo. La plataforma se encargará directamente de la creación, carga, servicio y renovación del certificado de su dominio.
- Si, en cambio, desea utilizar un certificado SSL personalizado, deberá seguir los pasos descritos en este artículo para añadir su certificado a la plataforma.
Una vez hecho esto, al configurar su dominio personalizado o secundario, podrá seleccionar el certificado previamente añadido desde una lista desplegable.
Requisitos previos
La configuración de certificados SSL está disponible si tiene activadas las funciones de dominio personalizado o empresa extendida en su plataforma.
Si no cuenta con ninguna de estas, no necesita configurar certificados SSL.
Preparación de un certificado SSL para un dominio
Este capítulo cubre todos los pasos que debe completar antes de poder subir un certificado SSL a la plataforma.
Nombre del dominio a proteger con el certificado:
Debe haber adquirido previamente la propiedad del nombre de dominio que desea proteger con un certificado SSL. Normalmente esto se realiza a través de su proveedor de registro o del departamento informático de su empresa.
→ El nombre de dominio que utilice puede ser de tercer a quinto nivel, y no debe ser el mismo que cualquiera de los dominios de remitente de correo electrónico que esté usando. Para más información, consulte los artículos correspondientes sobre dominios personalizados o dominios secundarios.
Configuración DNS del dominio:
Antes de solicitar un certificado SSL, la configuración DNS del dominio debe estar correctamente completada, con un registro CNAME correcto y un registro CAA, si procede.
➢ Consulte el artículo sobre Gestión de dominios: Requisitos de configuración de DNS.
De lo contrario, la autoridad certificadora (CA) no podrá emitir un certificado SSL para el dominio.
Compra del certificado SSL para el dominio:
A continuación, debe comprar a una autoridad certificadora (CA) como Digicert o Comodo un certificado SSL emitido para su dominio (o para un dominio comodín correspondiente).
A tener en cuenta: Esta es una funcionalidad técnica. Contacte con su proveedor de certificados, con el departamento informático de su empresa o con un socio de confianza para obtener ayuda si no tiene familiaridad con este proceso.
Al comprar un certificado, generalmente se le solicitará que envíe un archivo CSR (Certificate Signing Request), que contiene el nombre común que desea proteger con el certificado, información sobre su empresa y su clave pública.
→ Tenga en cuenta que la plataforma no ofrece una función para generar un archivo CSR por usted. Sin embargo, puede generar su CSR usando herramientas como OpenSSL.
Al generar el CSR, debe especificar el nombre común: este es el nombre de dominio completo que desea proteger con su certificado. Por ejemplo, learning.mycompany.com. Si solicita un certificado comodín, añada un asterisco * a la izquierda del nombre común donde desea que esté el comodín. Por ejemplo, *.mydomain.com.
Algunos registradores y proveedores de certificados requieren que elija el tipo de servidor web donde está alojado su sitio para continuar con su proceso de registro. En esos casos, elija o introduzca Apache como tipo de servidor de alojamiento.
Nota sobre certificados autofirmados:
El uso de certificados autofirmados genera errores en las funcionalidades de la plataforma. Docebo recomienda comprar un certificado SSL de una autoridad certificadora (CA), tal y como se indica más arriba, para ofrecer una experiencia ideal al usuario.
Preparación de archivos de certificados .PEM para la carga:
Al comprar un certificado SSL, recibirá de la autoridad certificadora uno o más archivos que pueden estar en formato CRT, DER o PEM, entre otros:
- Un archivo de certificado principal, que contiene la clave pública e información de validación del dominio: Por ejemplo,
<yourdomain_name>.crt -
Archivo(s) de certificado intermedio, que contienen los certificados intermedios necesarios para la cadena de confianza: Por ejemplo,
<Intermediate>.crt
También necesitará:
- Un archivo de clave privada, por ejemplo
<Your_Domain_Name>.key. Este no es proporcionado por la CA sino que se genera en su servidor cuando crea la Solicitud de Firma de Certificado (CSR).
Estos archivos deben ser convertidos al formato PEM antes de poder cargarse en la plataforma.
→ Puede hacerlo mediante OpenSSL u otra herramienta.
Específicamente, el formato requerido es: solo formato PEM, con extensión de archivo .pem, y contenido en un archivo de texto. Esto significa que el archivo puede abrirse en cualquier editor de texto plano como Notepad (para Windows) y TextEdit (para MacOS), para verificar que esté en el formato correcto:
El archivo de certificado PEM debe comenzar y terminar con las siguientes etiquetas, y no debe tener texto fuera de las mismas:
-----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----De manera similar, el archivo de clave privada PEM debe comenzar y terminar con las siguientes etiquetas:
-----BEGIN RSA PRIVATE KEY-----
-----END RSA PRIVATE KEY-----El texto entre estas etiquetas de inicio y fin debe constar de líneas de exactamente 64 caracteres, debiendo contener la línea final 64 o menos caracteres (según las especificaciones del formato PEM (se abre en una nueva pestaña)).
Adición de un certificado SSL a la plataforma
Antes de poder asignar un certificado a un dominio, debe añadirlo al área Gestión de dominios de la plataforma.
Después de preparar los archivos del certificado como se explica en el capítulo Preparación de un certificado SSL para un dominio, seleccione Menú de navegación > Configuración (icono de llave inglesa) > Configuración y herramientas de la plataforma > Gestión de dominios. A continuación, haga clic en el icono más en la esquina superior derecha de la ventana y seleccione la opción Nuevo certificado SSL.
En el panel que se abrirá, introduzca un Nombre para su certificado. Tenga en cuenta que este nombre no tiene conexión con el certificado, tiene solo fines de referencia. Luego, en la sección Parámetros, cargue los archivos en formato PEM con la extensión .pem preparada previamente:
- El archivo requerido de certificado SSL y el archivo de clave privada
- Y, opcionalmente, el archivo de la CA intermedia.
Una vez que haya añadido los archivos, haga clic en Crear y editar para continuar. En la página que se abre, la pestaña Propiedades resume el certificado cargado. Toda la información aquí es de solo lectura excepto el Nombre del certificado.
- En la sección General, puede revisar el Nombre y los archivos del certificado.
- En la sección Detalles, puede verificar el Emisor del certificado, las fechas de Validez y los nombres DNS para los que el certificado puede ser usado. Estas propiedades dependen de los archivos PEM que cargara.
A tener en cuenta: La función Gestión de dominios admite los certificados comodín. Puede añadirse y utilizarse un certificado comodín para todos los dominios que coincidan con el patrón sin tener que volver a cargar el certificado para cada dominio necesario.
→ Una vez añadido un certificado, aparecerá listado en la pestaña Certificados SSL de la página Gestión de dominios, y podrá asignarlo a un dominio.
Visualización de los certificados SSL
Para ver la lista de los certificados, seleccione Menú de navegación > Configuración (icono de llave inglesa) > Configuración y herramientas de la plataforma > Gestión de dominios y, en la página de Gestión de dominios, seleccione la pestaña Certificados SSL.
Puede filtrar la lista de certificados para mostrar solo aquellos que no están asignados a ningún dominio:
- En la esquina superior izquierda de la lista, haga clic en el icono de filtro y seleccione la casilla Sin dominios asignados.
- Haga clic en Borrar filtros activos para volver a mostrar todos los certificados.
También puede introducir texto en el cuadro Buscar… para encontrar un certificado específico rápidamente.
Para personalizar qué columnas se muestran, en la esquina superior izquierda de la lista, haga clic en el icono de columnas y seleccione las columnas que desee mostrar. Al desmarcar una casilla se ocultará la columna asociada.
Cada certificado de la lista muestra el estado (válido, caducado, a punto de caducar), información sobre la validez y el número de dominios a los que está asignado. Puede ver toda la información sobre un certificado haciendo clic en su nombre en la lista.
- La pestaña Propiedades contiene dos secciones, General y Detalles. Todos estos campos son de solo lectura, excepto el Nombre del certificado.
- La pestaña Dominios asignados enumera los dominios a los que el certificado está asignado actualmente.
Asignación de un certificado SSL a un dominio
Una vez añadido un certificado SSL, puede asignarlo a un dominio de la siguiente manera:
- En la lista de certificados SSL, localice el certificado que desee usar y, en la columna Dominios asignados, haga clic en el icono de globo.
- Ahora verá en la pestaña Dominios asignados la lista de dominios, si los hay, que están usando actualmente este certificado.
- Para añadir un dominio, haga clic en el icono más en la esquina superior derecha y seleccione Asignar dominio. Después, seleccione el dominio y haga clic en Asignar.
→ Solo podrá seleccionar dominios que coincidan con este certificado y que no tengan ya otro certificado asignado.
Un método alternativo es asignar el certificado desde la pestaña de dominios:
- En la página Gestión de dominios:
- para el dominio principal, vaya a la pestaña Dominio principal
- para un dominio secundario, vaya a la pestaña Dominios secundarios y, en la fila del dominio, haga clic en el icono de puntos suspensivos > Editar - Desplácese hacia abajo hasta la sección Certificado SSL, seleccione la opción Certificado SSL personalizado y luego, en la lista desplegable, seleccione el certificado que desee asignar.
→ Solo podrá seleccionar certificados que coincidan con el dominio.
A tener en cuenta: Un certificado es apto para ser asignado a un dominio si el nombre común en el archivo del certificado — o uno de sus nombres alternativos de sujeto (SAN) — coincide con el dominio, ya sea exactamente o con un patrón comodín.
El mismo certificado puede ser asignado a múltiples dominios; sin embargo, cada dominio puede tener solo un certificado asignado.
Una vez asignado el certificado SSL, le sugerimos verificar la encriptación de su dominio personalizado con una herramienta, como los ejemplos que se enumeran, para confirmar que el proceso se ha completado correctamente:
- Herramientas de certificados TLS/SSL de Digicert (se abre en una nueva pestaña)
- Comprobador SSL de Namecheap (se abre en una nueva pestaña)
Para tener un seguimiento correcto del material de formación al usar un dominio personalizado, compruebe de que su dominio personalizado esté completamente asegurado usando HTTPS. Tenga en cuenta que Docebo admite HTTP/2 (se abre en una nueva pestaña) sobre TLS 1.2 (se abre en una nueva pestaña).
Anulación de la asignación de un certificado a un dominio
Puede eliminar un certificado SSL autogestionado de un dominio. Tenga en cuenta que, al hacerlo, se emitirá automáticamente un certificado gestionado por la plataforma para usarse en su lugar.
- En la lista de certificados SSL, haga clic en el nombre del certificado que desea desasignar y luego seleccione la pestaña Dominios asignados.
- En la fila del dominio que desea desasignar, haga clic en icono de puntos suspensivos > Desasignar del certificado.
→ Verá una advertencia indicando que un certificado gestionado por la plataforma será emitido para reemplazar el que está eliminando. - Haga clic en Desasignar para confirmar.
A tener en cuenta: Los certificados SSL gestionados por la plataforma se crean mediante el servicio externo Let’s Encrypt, y hay un límite de 5 certificados por dominio por semana. Si ya ha alcanzado este límite, recibirá un mensaje de error “Se ha producido un error al generar el certificado SSL gestionado por la plataforma” y no podrá continuar con la anulación de la asignación.
Cambio del certificado SSL de un dominio
Necesitará reemplazar su certificado SSL personalizado, por ejemplo, cuando haya vencido.
Además, si desea cambiar cualquier propiedad de un certificado diferente a su Nombre, por ejemplo, para añadir un archivo de CA intermedia, no podrá hacerlo en el certificado existente. Deberá reemplazar el certificado:
- Siga el procedimiento descrito en el capítulo Adición de un certificado SSL para añadir un nuevo certificado, subiendo los archivos del certificado que incorporen los cambios que necesite.
- Ahora para reemplazar el certificado antiguo con el nuevo:
- para el dominio principal, vaya a la pestaña Dominio principal
- para un dominio secundario, vaya a la pestaña Dominios secundarios y, en la fila del dominio, haga clic en el icono de puntos suspensivos > Editar - Desplácese hasta la sección Certificado SSL y, en la lista desplegable de Certificados SSL, seleccione el nuevo certificado que acaba de añadir. A continuación, haga clic en Guardar cambios.
Repita este procedimiento para cualquier otro dominio que estuviera usando el mismo certificado.
A tener en cuenta: No se recomienda reemplazar el certificado haciendo primero una Anulación de la asignación del antiguo y luego una Asignación del nuevo certificado. Esto se debe a que la anulación de la asignación desencadenará automáticamente la emisión de un certificado gestionado por la plataforma para el dominio, con el riesgo de alcanzar el límite de 5 certificados.
Eliminación de un certificado SSL
Solo puede eliminar un certificado SSL si no está asignado a ningún dominio.
- En la lista de certificados SSL, localice el certificado que desee eliminar.
→ Si el certificado tiene dominios asociados, deberá desasignarlo de cada dominio o alternativamente reemplazarlo con un certificado diferente. - Coloque el cursor sobre la fila del certificado y haga clic en el icono de puntos suspensivos > Eliminar. Luego, en el cuadro de diálogo, haga clic nuevamente en Eliminar para confirmar.
Preguntas frecuentes sobre la gestión de dominios
Para información sobre preguntas frecuentes, consulte el artículo Gestión de dominios: Preguntas y respuestas.