September 22 — Documentation updated for compatibility with the latest PAM version (5.3.0).
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Endpoints

La dirección y el puerto que la consola entrega a un cliente cuando se abre una sesión, y por qué cambiar un puerto aquí no mueve el servicio que realmente está escuchando.

Un endpoint es la dirección y el conjunto de puertos que la consola da a un cliente al abrir una sesión: aquí es donde hay que marcar. Un mismo componente puede tener varios endpoints, porque un cliente dentro del centro de datos y un cliente en internet no llegan a él por la misma dirección.

Qué es esto y cuándo usarlo

Los componentes de la solución, el core, el conector de terminal, el conector gráfico, el conector de base de datos y los demás, escuchan cada uno en algún sitio. Un endpoint es el registro que dice cómo debe llegar a ellos un cliente:

Endpoint
Finalidad

Predeterminado

La ruta interna, entre el core y el conector de terminal

Externo

Para clientes fuera de la red

Privado

Para una DMZ o una red privada

Se selecciona un endpoint por conexión, y las reglas de endpoint deciden cuál, haciendo coincidir un grupo de IP. El resultado se entrega al cliente: se escribe en el archivo de conexión descargado si es un cliente nativo, o lo usa directamente el cliente web.

Usted toca esta pantalla en dos situaciones: cuando una clase de clientes llega a la solución por una dirección distinta de la que supone el valor predeterminado, y cuando hay que cambiar un puerto porque el 3389 o el 2222 ya está ocupado, o porque un estándar de cortafuegos lo prohíbe.

Antes de empezar

  • Privilegios de administrador en la consola.

  • La dirección que cada población de clientes usa realmente para llegar a la solución, que a menudo no es la dirección por la que el appliance se conoce a sí mismo.

  • Para un cambio de puerto, acceso al despliegue. El lado que escucha no se configura desde la consola, y el cambio no está terminado hasta que ambos lados coinciden.

Pasos

Para que una clase de clientes llegue a la solución por una dirección distinta, añada o edite el endpoint de esa red y déle el nombre de host que esos clientes resuelven; después añada una regla de endpoint que lo seleccione para el grupo de IP correspondiente.

Para cambiar un puerto, ambos lados tienen que moverse, en este orden:

  1. Cambie primero el listener. El puerto que el componente publica realmente lo fija su despliegue. Actualizarlo es una tarea de despliegue: corresponde a quien instaló la plataforma, no al operador de la consola.

  2. Después cambie el anuncio en el endpoint, para que a los clientes se les indique el puerto nuevo.

  3. Vuelva a probar con una sesión real. Nada más demuestra que las dos mitades ya coinciden.

Las bases de datos se comportan de forma algo distinta: cada conector de base de datos tiene su propio endpoint de servicio, y el puerto forma parte de cómo se enruta una sesión de base de datos. Por eso algunas plataformas de base de datos no tienen ningún puerto editable: el propio puerto es la clave de enrutamiento.

Lo que debería ver

Los endpoints se listan por componente, junto al propio estado del componente:

Campo
Significado

Nombre

El identificador único del componente

Tipo

Qué es: core, terminal, gráfico, base de datos, aplicación virtual, procesamiento de vídeo

Estado

En línea, Sin conexión, o un estado de error

Último heartbeat

Cuándo reportó por última vez

Versión

La compilación que está ejecutando

Endpoints

Las direcciones de conexión definidas para él, por red

Un componente que está Sin conexión no tiene ningún endpoint operativo, diga lo que diga el registro del endpoint.

Cómo verificar que funcionó

Volver a leer el registro del endpoint no dice nada: mostrará exactamente lo que usted escribió. Verifíquelo contra una sesión.

  1. Abra una sesión real en el protocolo que ha cambiado, como un usuario de la población de clientes a la que va dirigido el endpoint. No desde el host de la consola, y no desde su propia red si esa es otra red.

  2. Lea la dirección que se le dio al cliente. Para un cliente nativo, el archivo de conexión descargado lleva el host y el puerto; para el cliente web, la sesión simplemente conecta o no. Confirme que es la dirección y el puerto que pretendía.

  3. Confirme que algo está escuchando ahí. Si el cliente va al sitio correcto y la conexión aun así se rechaza, el anuncio se movió y el listener no.

  4. Pruebe cada población de clientes por separado. Un cliente interno y uno externo pueden resolver a endpoints distintos, y arreglar uno normalmente no rompe nada, pero tampoco demuestra nada sobre el otro.

Errores comunes

Síntoma
Causa
Solución

El cliente abre y falla al conectar de inmediato, en un puerto que acaba de cambiar

Anuncio nuevo, listener viejo: al cliente se le manda a un puerto donde nadie responde

Mueva el listener al puerto nuevo, en el despliegue, y vuelva a probar

Los clientes siguen llegando al puerto antiguo después de cambiar el despliegue

Listener nuevo, anuncio viejo: la cadena de conexión todavía lleva el puerto anterior

Actualice el endpoint para que el anuncio coincida

Algunos clientes conectan y otros no

Resuelven a endpoints distintos, y solo uno es correcto

Compruebe qué endpoint recibe realmente cada población antes de cambiar puertos

A un cliente se le da una dirección interna no enrutable

Se está usando el endpoint predeterminado para clientes fuera de la red

Defina el endpoint externo y una regla de endpoint que lo seleccione para esas direcciones

El cambio de puerto se revirtió tras una reinstalación o una actualización

El instalador vuelve a aplicar el puerto propio del despliegue y reescribe el anuncio con él

Registre cualquier puerto no predeterminado como parte de los parámetros de instalación de esa máquina, para que una nueva ejecución lo conserve

El puerto parece libre, pero siguen llegando conexiones por él

Una redirección local desvía el tráfico antes del socket

Inspeccione las reglas de NAT del host en lugar de sus sockets a la escucha

Se cortaron sesiones y una figura como todavía abierta

El componente que escucha se reinició o se recreó con sesiones en curso

Haga los cambios de puerto en ventana de mantenimiento; una sesión que queda abierta así hay que cerrarla administrativamente

Referencia de campos

Elemento
Qué es

Endpoint Predeterminado

La ruta interna, entre el core y el conector de terminal

Endpoint Externo

La dirección que usan los clientes de fuera de la red

Endpoint Privado

La dirección que se usa desde una DMZ o una red privada

Regla de endpoint

Vincula un grupo de IP a un endpoint, de modo que se selecciona un endpoint por conexión

Campos de puerto

El puerto anunciado al cliente. Nunca el puerto en el que escucha el componente

Endpoint de servicio de base de datos

Cada conector de base de datos tiene el suyo; en algunas plataformas de base de datos el puerto es la clave de enrutamiento y no es editable

Páginas relacionadas

  • Puertos y protocolos: los puertos que se usan para llegar a los activos, que son una cuestión aparte de estos

  • Métodos de conexión: qué clientes puede lanzar un usuario y, por tanto, qué endpoint se le entregará

  • Proxy: llegar a los activos a través de una máquina de salto

  • Broker: conectividad inversa, donde la ruta se establece hacia fuera

  • Conceptos básicos: cómo se relacionan los componentes, los activos y las sesiones

Atualizado

Isto foi útil?