> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/pam/administration/certificates/renewal.md).

# Renovar e implantar certificados

Renueve certificados SSL/TLS por ACME o por un CSR firmado por su CA interna, e instálelos en Nginx, Apache o IIS con prueba de configuración y reversión automática.

## Qué es esto y cuándo usarlo

La solución puede renovar un certificado del inventario e instalarlo en el servidor que lo presenta. Hay dos maneras de obtener el nuevo certificado:

| Método                  | Cómo se obtiene el certificado                                                                                                                    | Úselo para                                                                                             |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **ACME (automática)**   | La solución genera la clave, solicita el certificado a la CA, demuestra el control de cada nombre y recibe el certificado, sin ningún paso humano | Let's Encrypt, ZeroSSL, CA internas con servidor ACME, CA comerciales con ACME                         |
| **CSR para CA interna** | La solución genera la clave y una solicitud de firma de certificado (CSR). Su CA la firma y usted envía el certificado firmado                    | CA internas sin ACME, como Active Directory Certificate Services, y cualquier CA con un proceso manual |

Con cualquiera de los dos métodos, la solución puede después **implantar** el certificado en el activo: Nginx y Apache en Linux por SSH, e IIS en Windows por WinRM.

La renovación puede ejecutarse bajo demanda, con **Renovar ahora** o **Generar CSR**, o por sí sola un número fijo de días antes del vencimiento.

## Antes de empezar

* El certificado ya en el inventario y vinculado a su **Activo**. Vea [Monitorear certificados SSL/TLS](https://wiki.datadike.com/es/pam/administration/certificates/monitoring.md).
* Un rol con permiso para renovar certificados.
* Para **ACME (automática)**: una cuenta ACME; vea [Conectar una autoridad de certificación ACME](https://wiki.datadike.com/es/pam/administration/certificates/acme-accounts.md). La implantación también debe estar configurada, porque la CA valida cada nombre descargando un archivo que la solución coloca en el servidor. Cada nombre debe ser un nombre DNS al que la CA llegue por el puerto 80. Los nombres comodín (`*.example.com`) no se pueden emitir de esta forma.
* Para la implantación, una cuenta en el activo registrada en **Cuentas › Cuentas**:
  * **Linux**: una cuenta SSH que pueda escribir los archivos del certificado y recargar el servidor web, directamente o con **Usar sudo**.
  * **Windows**: una cuenta WinRM del grupo local Administradores. El puerto 5985 o 5986 abierto desde la solución.
* Las rutas de los archivos de certificado, clave y cadena a las que ya apunta la configuración del servidor web. La solución reemplaza los archivos; no edita la configuración del servidor web.

## Pasos

### Configurar la renovación y la implantación

1. Abra **Entorno › Certificados**, abra el menú del certificado y elija **Editar**.
2. En **Renovación**, elija **Cómo renovar**: **ACME (automática)** o **CSR para CA interna**.
3. Para ACME, elija la **Cuenta ACME**.
4. Elija el **Tipo de clave** del nuevo certificado.
5. En **Implantación**, elija el tipo de servidor: **Nginx (Linux, SSH)**, **Apache (Linux, SSH)** o **IIS (Windows, WinRM)**. Elija **Sin implantación** si va a instalar el certificado usted mismo.
6. Elija la **Cuenta en el activo**. La lista muestra las cuentas del activo vinculado al certificado.
7. Rellene los campos del tipo de servidor:
   * **Nginx**: **Archivo del certificado** y **Archivo de la clave**. El archivo del certificado recibe el certificado seguido de la cadena intermedia.
   * **Apache**: **Archivo del certificado** y **Archivo de la clave**, y **Archivo de la cadena** solo si su configuración usa `SSLCertificateChainFile` (Apache anterior a 2.4.8). Deje **Archivo de la cadena** vacío y la cadena irá en el archivo del certificado.
   * **IIS**: el nombre del **Sitio de IIS**, tal como aparece en el Administrador de IIS.
   * **ACME en Linux**: **Raíz web (ACME)**, el directorio que el sitio sirve en `/`. Los archivos de validación se escriben en `.well-known/acme-challenge/` dentro de ese directorio. En IIS se usa la raíz del propio sitio.
8. Active **Usar sudo** si la cuenta lo necesita para escribir los archivos y recargar el servidor.
9. Para renovar sin intervención de nadie, active **Renovación automática** y fije **Renovar cuántos días antes**.
10. Guarde.

### Renovar con ACME

1. Abra el certificado. El panel **Renovación** muestra el método y el historial.
2. Haga clic en **Renovar ahora**.

La renovación se ejecuta en segundo plano. **Paso a paso**, en el historial de renovaciones, muestra cada etapa a medida que ocurre: clave generada, pedido realizado, nombres validados, certificado emitido, archivos instalados, configuración probada, servidor recargado, nuevo certificado confirmado en la dirección.

### Renovar con un CSR

1. Abra el certificado y haga clic en **Generar CSR**. La solución genera la clave privada, la guarda cifrada y crea el CSR con los nombres del certificado actual.
2. Haga clic en **Copiar CSR** o **Descargar CSR** y envíelo a su CA.
3. Cuando la CA devuelva el certificado firmado, haga clic en **Enviar certificado firmado** y péguelo en PEM. Pegue la cadena intermedia justo después.
4. Marque **Implantar en el activo en cuanto se reciba** para instalarlo de inmediato, o déjelo desmarcado y haga clic en **Implantar** más tarde, en una ventana de mantenimiento.

La solución rechaza un certificado firmado que no corresponda a la clave privada que generó, y registra el rechazo.

### Qué ocurre durante la implantación

En **Nginx y Apache**:

1. Se hace una copia de seguridad de los archivos actuales junto a los originales.
2. Se escriben los nuevos archivos. Los archivos que ya existen conservan su propietario, grupo y permisos.
3. Se prueba la configuración con `nginx -t` o `apachectl -t`.
4. Si la prueba **falla**, se restauran los archivos anteriores, el servidor no se recarga y la renovación falla con la salida de la prueba.
5. Si la prueba pasa, el servidor se recarga sin cortar conexiones.

En **IIS**, el certificado y su clave se importan en el almacén **Personal** del equipo (`LocalMachine\My`), y el enlace HTTPS del sitio, en el puerto y el nombre de host del certificado, pasa a apuntar al nuevo certificado. Si el enlace no existe, se crea, con SNI cuando hay un nombre de host definido.

En todos los casos, la solución se conecta después a la dirección y confirma que presenta el nuevo certificado. La renovación solo se marca como **Implantado** tras esa confirmación.

### Renovación automática

La verificación diaria inicia una renovación para cada certificado con **Renovación automática** activada, cuando los días restantes llegan a **Renovar cuántos días antes**.

* Con **ACME**, se ejecuta el flujo completo, implantación incluida.
* Con **CSR**, la solución genera el CSR y avisa a los destinatarios. El resto espera a que se envíe el certificado firmado.
* Tras un intento fallido, el siguiente empieza al día siguiente.

## Qué debe ver

El historial de renovaciones del certificado muestra cada intento con su origen (manual o automático), su estado y sus fechas. Los estados son **Pendiente**, **Esperando certificado firmado**, **Emitiendo**, **Emitido**, **Implantando**, **Implantado**, **Fallido** y **Cancelado**.

Tras una implantación correcta, la tarjeta del certificado muestra la nueva fecha de vencimiento y el estado vuelve a **Válido**.

Los destinatarios de la notificación **Renovación de certificado** reciben un aviso cuando un certificado se emite o se implanta, cuando una renovación falla y cuando la renovación automática ha generado un CSR que espera a su CA. Fije los destinatarios en **Configuración del sistema › Notificaciones › Suscripción**.

## Cómo verificar que funcionó

1. En el historial de renovaciones, el intento debe estar en **Implantado**, y **Paso a paso** debe terminar con la confirmación de que la dirección presenta el nuevo certificado.
2. Desde cualquier máquina que llegue a la dirección, lea el certificado que presenta el servidor y compare la huella y la fecha de fin con las que muestra la solución:

   ```bash
   openssl s_client -connect host.example.com:443 -servername host.example.com </dev/null 2>/dev/null \
     | openssl x509 -noout -fingerprint -sha256 -enddate
   ```
3. Abra **Auditoría › Consola › Certificados** y busque el certificado. Debe ver **Renovación iniciada**, **Certificado recibido** y **Certificado implantado**, cada uno con el usuario que actuó, o **Sistema** en una renovación automática.

## Errores comunes

| Síntoma                                                                              | Causa                                                                                                                               | Solución                                                                                                                                      |
| ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Renovar ahora** rechazado: la validación ACME necesita la implantación configurada | ACME seleccionado con **Sin implantación**                                                                                          | Configure la implantación. El archivo de validación tiene que colocarse en el servidor                                                        |
| Rechazado: solo nombres DNS sin comodín                                              | Un nombre del certificado es un comodín o una dirección IP                                                                          | Use **CSR para CA interna** para ese certificado                                                                                              |
| Falla al validar los nombres                                                         | La CA no pudo descargar el archivo de validación por HTTP en el puerto 80, o **Raíz web (ACME)** no es el directorio servido en `/` | Abra el puerto 80 desde la CA hasta el servidor y corrija **Raíz web (ACME)**                                                                 |
| Falla: la prueba de configuración falló, archivos anteriores restaurados             | Los nuevos archivos rompen la configuración del servidor web, por ejemplo una ruta de clave que la configuración no usa             | Lea la salida de la prueba en **Paso a paso**, corrija las rutas de los archivos e implante de nuevo                                          |
| Falla: el servidor sigue presentando el certificado anterior                         | El servidor se recargó pero sirve el certificado desde otra ruta, o un balanceador de carga situado delante termina el TLS          | Apunte **Archivo del certificado** y **Archivo de la clave** a las rutas que usa la configuración. Con un balanceador de carga, implante allí |
| **Certificado firmado rechazado**                                                    | El certificado no corresponde a la clave de esta renovación, o la CA lo devolvió en DER                                             | Envíe el certificado firmado para este CSR, en PEM. Si se perdió el CSR, cancele la renovación y genere uno nuevo                             |
| IIS: sitio no encontrado                                                             | **Sitio de IIS** no coincide con el nombre del sitio en el Administrador de IIS                                                     | Copie el nombre exacto del Administrador de IIS                                                                                               |
| Conexión WinRM rechazada                                                             | Puerto 5985/5986 cerrado, o la cuenta no es administrador local                                                                     | Abra el puerto y use una cuenta del grupo local Administradores                                                                               |

## Referencia de campos

| Campo                      | Qué hace                                                                                     | Valores aceptados                                                                               | Predeterminado       |
| -------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | -------------------- |
| Cómo renovar               | Método de renovación                                                                         | **ACME (automática)**, **CSR para CA interna**                                                  | Vacío: no se renueva |
| Cuenta ACME                | CA que emite el certificado. Solo ACME                                                       | Una cuenta ACME                                                                                 | Ninguno              |
| Tipo de clave              | Clave del nuevo certificado                                                                  | RSA 2048, RSA 3072, RSA 4096, ECDSA P-256, ECDSA P-384                                          | RSA 2048             |
| Renovación automática      | Inicia la renovación desde la verificación diaria                                            | Activado, desactivado                                                                           | Desactivado          |
| Renovar cuántos días antes | Días antes del vencimiento en que empieza la renovación automática                           | Días                                                                                            | 30                   |
| Implantación               | Tipo de servidor donde se instala el certificado                                             | **Sin implantación**, **Nginx (Linux, SSH)**, **Apache (Linux, SSH)**, **IIS (Windows, WinRM)** | **Sin implantación** |
| Cuenta en el activo        | Cuenta usada para conectarse al activo                                                       | Una cuenta del activo vinculado                                                                 | Ninguno              |
| Usar sudo                  | Escribe los archivos y recarga el servidor con sudo. Solo Linux                              | Activado, desactivado                                                                           | Desactivado          |
| Archivo del certificado    | Ruta del certificado en el servidor. Solo Linux                                              | Ruta absoluta                                                                                   | Ninguno              |
| Archivo de la clave        | Ruta de la clave privada en el servidor. Solo Linux                                          | Ruta absoluta                                                                                   | Ninguno              |
| Archivo de la cadena       | Ruta de un archivo de cadena separado. Solo Apache                                           | Ruta absoluta, o vacío                                                                          | Vacío                |
| Raíz web (ACME)            | Directorio servido en `/`, donde se escriben los archivos de validación. Solo Linux con ACME | Ruta absoluta                                                                                   | Ninguno              |
| Sitio de IIS               | Sitio cuyo enlace HTTPS recibe el certificado. Solo IIS                                      | Nombre del sitio                                                                                | Ninguno              |

## Páginas relacionadas

* [Monitorear certificados SSL/TLS](https://wiki.datadike.com/es/pam/administration/certificates/monitoring.md)
* [Conectar una autoridad de certificación ACME](https://wiki.datadike.com/es/pam/administration/certificates/acme-accounts.md)
* [Auditoría de certificados y claves PGP](https://wiki.datadike.com/es/pam/administration/audit/certificate-and-key-audit.md)
* [Cuentas gestionadas](https://wiki.datadike.com/es/pam/administration/accounts/managed-accounts.md)
