El nombre de dominio de un clúster Dynatrace Managed no es un detalle cosmético. Es la dirección que escriben tus usuarios, la que llevan cientos de OneAgent para llegar al clúster, la que referencian los ActiveGate, los recursos DynaKube, los scripts de automatización y las integraciones por API. Y son los certificados SSL asociados a ese nombre los que garantizan a todos esos clientes que hablan realmente con tu clúster.
En muchas instalaciones, el clúster arranca con el subdominio dynatrace-managed.com y el certificado gestionados automáticamente por Dynatrace (o, sin esa gestión automática, con un certificado autofirmado), y se decide «más adelante» pasar a un nombre propio como dynatrace.{tu-empresa}.com y a un certificado emitido por la autoridad interna. Ese «más adelante» suele llegar con urgencia: avisos del navegador, una política de seguridad que prohíbe los certificados no aprobados, o un certificado caducado un lunes por la mañana.
Este artículo explica cómo elegir el nombre de dominio del clúster, preparar e instalar un certificado SSL/TLS y organizar la renovación para que nunca vuelva a ser un incidente.
Entender quién se conecta a qué
Antes de cambiar nada, haz un mapa de los clientes del nombre de dominio:
- Navegadores de los usuarios: CMC y entornos en
https://{tu-dominio}/e/{id-entorno}. - OneAgent: se conectan a los nodos del clúster o a ActiveGate, según la lista de direcciones de comunicación que reciban.
- ActiveGate: los Cluster ActiveGate (puerto 9999 por defecto) suelen servir de punto de entrada para los agentes que están fuera de la red del clúster.
- Clientes de API: automatizaciones en
https://{tu-dominio}/api/cluster/v2/…y…/e/{id}/api/v2/…. - Kubernetes:
apiUrlen cadaDynaKube(consulta Dynatrace Operator en Managed).
Un cambio de nombre afecta a todos estos clientes; un cambio de certificado afecta a todos los que verifican la cadena de confianza.
Elegir el nombre de dominio y los certificados SSL
El nombre
Elige un nombre estable, independiente de los nombres de host de los nodos, que pueda sobrevivir a la sustitución de un servidor o a una ampliación del clúster. Tu DNS resuelve ese nombre hacia un balanceador de carga situado delante de los nodos, o directamente hacia los nodos (registros múltiples).
El tipo de certificado
| Opción | A favor | En contra |
|---|---|---|
| Gestión automática (subdominio dynatrace-managed.com) | Ningún esfuerzo, certificado aprobado | Nombre impuesto, depende de la conexión a Mission Control |
| Autofirmado (gestión automática desactivada) | Ningún esfuerzo | Avisos del navegador, rechazo por clientes estrictos |
| PKI interna de la empresa | Aprobado por los equipos y servidores internos | Hay que distribuir la raíz a los clientes fuera del dominio (contenedores, socios) |
| Autoridad pública | Aprobado en todas partes | Requiere un nombre público; poco adecuado para un clúster puramente interno |
El certificado debe cubrir el nombre del clúster en el campo Subject Alternative Name (SAN). Si los OneAgent también llegan a los nodos por su propio nombre, incluye esos nombres en el SAN. Además, el certificado se instala nodo por nodo en la CMC, y la documentación propone un subdominio por nodo (n01.{tu-dominio}…) para el enrutamiento mediante balanceador.
Tutorial paso a paso
Paso 1: crear el registro DNS
Crea el registro para {tu-dominio} y comprueba la resolución desde un equipo de usuario, un nodo del clúster y un host monitorizado:
dig +short {votre-domaine}
getent hosts {votre-domaine}
Paso 2: generar la clave y la solicitud de certificado
En un equipo de administración seguro, crea un archivo de configuración de OpenSSL que incluya el SAN:
cat > csr.cnf <<'EOF'
[req]
distinguished_name = dn
req_extensions = ext
prompt = no
[dn]
CN = {votre-domaine}
O = {votre-organisation}
[ext]
subjectAltName = DNS:{votre-domaine},DNS:{nom-noeud-1},DNS:{nom-noeud-2}
EOF
openssl req -new -newkey rsa:2048 -nodes -keyout cluster.key -out cluster.csr -config csr.cnf
openssl req -in cluster.csr -noout -text | grep -A1 "Subject Alternative Name"
Envía cluster.csr a tu PKI. Protege la clave privada (chmod 600 cluster.key) y no la hagas pasar nunca por correo electrónico.
Paso 3: preparar la cadena completa
Une el certificado del servidor y los certificados intermedios, y comprueba después la coherencia entre la clave y el certificado:
cat cluster.crt intermediaire.crt > cluster-fullchain.pem
openssl x509 -in cluster.crt -noout -subject -enddate
openssl x509 -in cluster.crt -noout -modulus | sha256sum
openssl rsa -in cluster.key -noout -modulus | sha256sum
Las dos huellas deben ser idénticas. La CMC espera archivos PEM con sus cabeceras BEGIN/END completas y una clave privada sin cifrar; si la tuya está protegida con contraseña:
openssl rsa -in cluster-chiffree.key -out cluster.key
Paso 4: declarar el nombre de dominio en la CMC
En la Cluster Management Console, desactiva primero Manage domain name and SSL certificates (Settings > Preferences), abre después Settings > Public endpoints e indica {tu-dominio} como dirección habitual de la interfaz web. En tu DNS, crea un registro A que apunte a cada nodo. Este parámetro condiciona las URL generadas (enlaces en las notificaciones, metadatos SAML, instaladores).
Paso 5: instalar el certificado
También en la CMC, desde la página de inicio, abre cada nodo y después Edit SSL certificate en su página de detalles: pega la clave privada, el certificado del servidor y la cadena (raíz e intermedios) y guarda. Repite la operación en cada nodo. Si un balanceador de carga termina el TLS delante del clúster, el certificado se instala en el balanceador; asegúrate entonces de que el tráfico hacia los nodos sigue cifrado y de que las cabeceras transmitidas cumplen lo que indica la documentación. Por prudencia, planifica la operación en una ventana de mantenimiento.
Paso 6: verificar desde los clientes
openssl s_client -connect {votre-domaine}:443 -servername {votre-domaine} </dev/null 2>/dev/null \
| openssl x509 -noout -subject -issuer -enddate
curl -sS -o /dev/null -w "%{http_code}\n" --cacert {racine-pki}.pem \
-H "Authorization: Api-Token {token}" \
"https://{votre-domaine}/e/{id-environnement}/api/v2/entities?entitySelector=type(%22HOST%22)&pageSize=1"
Comprueba después, en un entorno, que los OneAgent y los ActiveGate siguen conectados. En los Cluster ActiveGate, verifica también el certificado que exponen en su puerto (9999 por defecto).
Paso 7: actualizar los clientes que referencian el nombre antiguo
apiUrlde los recursosDynaKube:https://{tu-dominio}/e/{id-entorno}/api.- Variables de URL en tus pipelines y herramientas de automatización.
- Raíz de la PKI añadida a los almacenes de confianza de los contenedores y servidores fuera del dominio.
Buenas prácticas
- Un nombre estable y genérico, desacoplado de los nombres de host de los nodos.
- Alerta de caducidad al menos 30 días antes del vencimiento, por ejemplo con un monitor sintético o un script
opensslprogramado. - Runbook de renovación probado, con la lista de componentes afectados (clúster, balanceador, ActiveGate).
- Clave privada protegida y guardada en una caja fuerte de secretos, nunca en un repositorio de código.
- Cadena completa siempre incluida: olvidar el intermedio es la primera causa de errores en los clientes.
Preguntas frecuentes
¿Qué debe contener el campo SAN del certificado?
Como mínimo, el nombre del clúster. Si los OneAgent también llegan a los nodos por su propio nombre, añade esos nombres al SAN o prevé un certificado por nodo, según tu arquitectura.
¿Por qué algunos clientes rechazan un certificado que es válido?
Lo más habitual es que la cadena esté incompleta: no se proporcionó el certificado intermedio. Otra causa frecuente es que la raíz de la PKI interna no esté en el almacén de confianza de los contenedores o de los servidores fuera del dominio.
¿Cómo evitar sorpresas por una caducidad?
Crea una alerta al menos 30 días antes del vencimiento, con un monitor sintético o un script openssl programado, y mantén al día un runbook de renovación que enumere clúster, balanceador y ActiveGate.
Conclusión
Un nombre de dominio bien elegido y un certificado emitido por una autoridad aprobada convierten tu clúster Managed en un servicio de empresa de confianza, y no solo en una herramienta técnica. Si primero mapeas los clientes, verificas con cuidado la cadena con openssl y automatizas la vigilancia de la caducidad, una operación temida pasa a ser una rutina anual sin sorpresas.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión de Managed.