Saltar al contenido

¿Cómo soluciono el error “TargetNotConnected” en el Administrador de sesiones?

7 minutos de lectura
0

Quiero establecer sesiones de reenvío de puertos a través del Administrador de sesiones, una función de AWS Systems Manager. Sin embargo, he recibido el mensaje de error “TargetNotConnected”.

Descripción corta

Si AWS Systems Manager no puede establecer una conexión con tu instancia de Amazon Elastic Compute Cloud (Amazon EC2) de destino, recibirás el mensaje de error “TargetNotConnected”. Este problema surge por los siguientes motivos:

  • Tu instancia de EC2 no cumple los requisitos previos del Administrador de sesiones.
  • No has registrado la instancia de Amazon EC2 como nodo administrado.
  • Has configurado mal tu proxy.
  • Las políticas de control de servicios (SCP) bloquean las acciones de API requeridas.
  • Hay problemas con AWS Systems Manager Agent (SSM Agent).
  • Hay problemas en tu contenedor de Amazon Elastic Container Service (Amazon ECS).
  • Usas un host bastión y has configurado mal la base de datos.

Resolución

Nota: Si se muestran errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), consulta Solución de errores para la AWS CLI. Además, asegúrate de utilizar la versión más reciente de AWS CLI. Para obtener información sobre la configuración del reenvío de puertos, consulta ¿Cómo uso el reenvío de puertos del Administrador de sesiones de Systems Manager sin un host bastión para conectarme a mi instancia de EC2 a través de RDP?

Requisitos previos:

Cómo asegurarte de que tu instancia aparezca como un nodo gestionado

Los problemas de enrutamiento de red, configuración de grupos de seguridad de nube virtual privada (VPC) y AWS Identity and Access Management (IAM) pueden provocar errores "TargetNotConnected". Para solucionar estos problemas, consulta ¿Por qué Systems Manager no muestra mi instancia de Amazon EC2 como una instancia administrada?

Comprobación de la configuración del proxy

Si tu configuración usa un servidor proxy, comprueba que el proxy permita el punto de enlace del Administrador de sistemas ssm.region.amazonaws.com. Si tu instancia se encuentra en una región que se inició antes de 2024, asegúrate también de que el proxy permita ec2messages.region.amazonaws.com. En las instancias de una región que se inició en 2024 o después, asegúrate de que el proxy permita ssmmessages.region.amazonaws.com.

Nota: Sustituye region por tu región.

Para omitir el proxy y probar la conectividad, ejecuta el siguiente comando:

curl -I https://ssm.region.amazonaws.com --noproxy "*"

Nota: Sustituye region por tu región.

Si puedes conectarte con el comando anterior, entonces hay problemas con el proxy. Asegúrate de que la configuración del proxy del agente SSM para tu instancia de Windows o Linux es correcta y coincide con la configuración de la red.

Cómo revisar los SCP

Los SCP a nivel de AWS Organizations pueden bloquear las acciones de API necesarias incluso si has configurado correctamente los permisos de IAM.

Para resolver este problema, sigue estos pasos:

  1. Utiliza el simulador de política de IAM para comprobar si el rol de IAM de la instancia puede ejecutar las acciones que se enumeran en la política AmazonSSMManagedInstanceCore.
  2. Comprueba los SCP que has asociado a tu unidad organizativa o cuenta para asegurarte de que permiten las acciones ssm:*. En las instancias de una región que se inició antes de 2024, asegúrate de que los SCP también permitan la acción ec2messages:*. Para las instancias de una región que se inició en 2024 o después, asegúrate de que los SCP permitan la acción ssmmessages:*.
  3. Si has actualizado un SCP, ejecuta el siguiente comando para reiniciar SSM Agent según tu sistema operativo (SO).
    Linux:
    sudo systemctl restart amazon-ssm-agent
    Windows:
    Restart-Service AmazonSSMAgent
    Nota: Debes ejecutar el comando de Windows como administrador de PowerShell.

Solución de problemas con SSM Agent

Nota: Para SSM Agent 3.1.501.0 o posterior, puedes usar ssm-cli para solucionar problemas de disponibilidad de nodos administrados.

Asegúrate de que el estado de SSM Agent esté en ejecución. A continuación, ejecuta el siguiente comando en función de tu sistema operativo para comprobar los registros de SSM Agent.

Linux:

sudo tail -f /var/log/amazon/ssm/amazon-ssm-agent.log

Windows:

Get-Content "C:\ProgramData\Amazon\SSM\Logs\amazon-ssm-agent.log" -Tail 50

En función de lo que encuentres en los registros, soluciona los problemas con SSM Agent.

(Solo Amazon ECS) Comprobación de la configuración de un contenedor

Si usas un contenedor de Amazon ECS, lleva a cabo las siguientes acciones para solucionar los errores "TargetNotConnected".

Asegúrate de que ECS Exec esté activado a nivel de tarea

Sigue estos pasos:

  1. Abre la consola de Amazon ECS.
  2. En el panel de navegación, selecciona Clusters (Clústeres).
  3. Selecciona tu clúster y, a continuación, selecciona tu tarea.
  4. En Configuration (Configuración), verifica que ECS Exec esté establecido en Turned on.
    Si ECS Exec no está activado, inicia una nueva tarea con ECS Exec activado.

Comprobación del modo de red de tareas

Para las tareas que se ejecutan en instancias de EC2, el modo de red afecta a la funcionalidad de ECS Exec. Se recomienda utilizar el modo de red awsvpc.

Para actualizar el modo de red, actualiza la definición de la tarea y, a continuación, en Network mode (Modo de red), selecciona awsvpc. A continuación, actualiza el servicio para usar la nueva definición de tarea.

Nota: Para cambiar de bridge a awsvpc, también debes actualizar el parámetro networkConfiguration en la configuración de tu servicio o tarea para especificar subredes y grupos de seguridad.

Comprobación de la configuración de red

Asegúrate de que los grupos de seguridad de tareas de Amazon ECS permitan el tráfico en el puerto 443 y en otros puertos que tu configuración utilice. Además, confirma que la tarea de Amazon ECS tiene un rol de IAM con los permisos de administrador de sesión necesarios.

(Solo hosts bastión) Comprobación de la configuración de la base de datos

Si usas un host bastión para conectarte a la base de datos, ejecuta el siguiente comando en función de tu sistema operativo para probar la conectividad de la base de datos.

Linux:

nc -zv Database_endpoint Database_port

Windows:

Test-NetConnection -ComputerName Database_endpoint -Port Database_port

Nota: Sustituye Database_endpoint por el punto de enlace de la base de datos y Database_port por el puerto de la base de datos.

Si la conexión se realiza correctamente, el resultado muestra que el puerto está abierto. Si la conexión falla, comprueba las reglas del grupo de seguridad entre el bastión y la base de datos. Asegúrate de que el grupo de seguridad de la base de datos tenga una regla de entrada que permita el tráfico desde el host bastión en el puerto de la base de datos. Comprueba también que el grupo de seguridad del bastión tenga una regla de salida que permita el tráfico a la base de datos en el puerto de la base de datos.

Solución de problemas adicional

Si sigues teniendo problemas, consulta el historial de eventos de AWS CloudTrail para ver los siguientes orígenes de eventos:

  • ssm.amazonaws.com
  • (Solo instancias en una región que se iniciaron antes de 2024) ec2messages.amazonaws.com
  • (Solo instancias de una región que se iniciaron en 2024 o después) ssmmessages.amazonaws.com

En Event history (Historial de eventos), comprueba si hay códigos de error específicos en las llamadas a la API fallidas. AccessDenied y UnauthorizedOperation significan que hay problemas con los permisos de IAM, e InvalidUserID.NotFound significa que hay problemas con el perfil de instancia.

Si tienes problemas de conexión, conéctate a una instancia en una subred o zona de disponibilidad diferente. Alternativamente, inicia una nueva instancia con la misma configuración y, a continuación, usa la nueva instancia para conectarte.

Información relacionada

Solución de problemas del Administrador de sesiones

Inicio de una sesión (reenvío de puertos)

OFICIAL DE AWSActualizada hace 8 meses
Sin comentarios

Contenido relevante