APIM Self-Hosted Gateway Configuration Problems

Question

APIM Self-Hosted Gateway Configuration Problems

David Fernando Lopez Cueca 60

I configured a self-hosted gateway and deployed it on a Docker machine. I've already configured the API to use the self-hosted gateway, uploaded the certificate, and so on, but I have two specific questions. The application consuming the endpoint is still using the base URL from the API's custom domain. The other question is that when I switch it to use the self-hosted gateway, the base URL doesn't change; it remains the one from the Azure API's custom domain. Does anyone have any idea what I might be missing to get it working correctly?

Rakesh Mishra 9,700 Puntos de reputación Personal externo de Microsoft Moderador

2026-05-14T21:33:28.94+00:00

Hola @Anonymous , por favor acepta como respuesta si te resulta útil.

Respuesta aceptada por el autor de la pregunta

0 respuestas adicionales

Su respuesta

Rakesh Mishra 9,700 Puntos de reputación Personal externo de Microsoft Moderador

2026-05-14T21:33:28.94+00:00

Hola @Anonymous , por favor acepta como respuesta si te resulta útil.

Answer 1

Rakesh Mishra 9,700 Personal externo de Microsoft Moderador

Hola David, parece que tu gateway autoalojado está activo y comunicándose con Azure APIM, pero tu cliente sigue usando la URL gestionada de APIM (y el portal sigue mostrando esa URL base) porque hay que configurar algunas piezas extra de enrutamiento.

Así es como puedes configurar APIM para que use la pasarela autoalojada y refleje la URL base correcta en el Portal de Desarrolladores:

Asigna tu API al gateway autoalojado
Por defecto, las APIs solo están asociadas con la pasarela gestionada basada en la nube.
- En el portal de Azure, ve a tu instancia APIM > APIs > selecciona la pestaña de Configuración > API ____ .
- Desplázate hacia abajo hasta Gateways (o asociaciones de Gateway) y asegúrate de que tu gateway autoalojado esté comprobado.
- Nota: Solo las APIs asignadas explícitamente a una puerta de enlace aparecerán (y podrán ser llamadas) a través de esa pasarela.
Configura un nombre de host personalizado específicamente para tu gateway autoalojado
(Nota: No configure esto en la hoja principal "Custom Domains" bajo "Gateway configuration API"—eso es solo para que la pasarela obtenga su configuración interna).
- En la barra lateral del portal de Azure, ve a Despliegue + infraestructura > Gateways (o Gateways autoalojados) y selecciona tu gateway autoalojado específico.
- En Configuración, selecciona Nombres de host > + Añadir.
- Introduce el nombre de dominio en el que quieres que responda tu gateway autoalojada (por ejemplo, api.mycompany.com) y asigna el certificado TLS correspondiente (. PFX / Llave Vault). Esto vincula oficialmente la URL base a tu gateway autoalojado.
Apunta tu DNS a la IP / Balanceador de Carga de tu gateway autoalojado
- Crea un registro A (o CNAME) para tu nombre de host personalizado (por ejemplo, api.mycompany.com) y apunta a la IP pública/controlador de entrada que usas en Docker o Kubernetes para alojar el contenedor de gateway.
- Verifica que https://<your-shg-hostname>/status-0123456789abcdef los devuelven para 200 OK asegurarte de que el DNS y los certificados funcionan de extremo a extremo.
Republicar el Portal para Desarrolladores
- Para asegurarte de que el portal descubre y lista la nueva URL base para tus APIs, navega al portal de desarrolladores > resumen del portal en APIM.
- Pulsa Publicar. Una vez publicado, el portal de desarrolladores listará la URL base del gateway autoalojado dentro de las páginas de referencia de tu API.

Por favor, prueba los pasos anteriores y háznoslo saber en los comentarios si aún ves la URL antigua.

Referencias

Nota: Esta respuesta está redactada con la ayuda de sistemas de IA.

David Fernando Lopez Cueca 60 Puntos de reputación

2026-05-09T00:57:31.1966667+00:00

Hi Rakesh. Thank you so much for taking the time to help me. I have a few questions regarding the steps you outlined:

I've already done everything you suggested, but I have one question. If I don't publish the new Base URL to the developer portal, will it not be available? That's one question. The other is, when the application consumes the endpoint, wouldn't something need to be changed to point to the new Base URL being provided by the Self-Hosted Gateway?
Rakesh Mishra 9,700 Puntos de reputación Personal externo de Microsoft Moderador

2026-05-11T23:41:04.08+00:00
Hola David, por favor encuentra la respuesta a tu pregunta abajo y dime si tienes más preguntas.

1. Si no publicas el portal, ¿la API sigue disponible?

¡Sí, está completamente disponible! En Azure APIM, el Portal para Desarrolladores es puramente una interfaz de documentación y descubrimiento; no dicta el enrutamiento real ni la disponibilidad en tiempo de ejecución de tus APIs.

Mientras hayas configurado el nombre de host personalizado en el recurso de gateway autoalojado y tu DNS apunte correctamente a la IP/Ingress de tu contenedor, el endpoint está activo y listo para procesar el tráfico. Pulsar "Publicar" simplemente actualiza el contenido estático del portal para desarrolladores para que los desarrolladores que lean tu documentación vean la URL base correcta. Si nunca la publicas, la API seguirá funcionando perfectamente con la nueva URL; la documentación del portal simplemente parecerá desactualizada.

2. ¿Es necesario cambiar la aplicación del cliente?

Sí, absolutamente. La aplicación cliente debe actualizarse para apuntar a la nueva URL base (tu dominio personalizado que se resuelve en la pasarela autoalojada).

Si dejas la aplicación cliente configurada con la URL original de la pasarela gestionada APIM (que normalmente termina en .azure-api.net), el tráfico seguirá fluyendo por internet directamente a la pasarela de nube gestionada de Azure. Para enrutar realmente el tráfico a través de tu propia infraestructura y contenedor, la configuración base de la URL de la aplicación cliente debe actualizarse para consumir el nuevo endpoint proporcionado por tu gateway autoalojado.

¡Espero que esto aclare las cosas! Por favor, acepta como respuesta si te resulta útil.
David Fernando Lopez Cueca 60 Puntos de reputación

2026-05-12T02:44:49.7866667+00:00

I have one last question, Rakesh. As you can see in the attached image, the self-hosted gateway we created is mapped to the gateways, and we've already followed all the steps you previously indicated. My specific question is why the base URL doesn't change in the API settings. I see that it always remains the default base URL of the API's custom domain, but it doesn't change to the domain associated with the self-hosted gateway. However, when we test the API, it does load the base URL of the self-hosted gateway. Is this normal behavior?
Rakesh Mishra 9,700 Puntos de reputación Personal externo de Microsoft Moderador

2026-05-13T19:33:03.03+00:00
Oye David, esa es una observación fantástica. Para responder directamente a tu pregunta: Sí, este es un comportamiento 100% normal y esperado por diseño.

Mirando la captura de pantalla que has proporcionado (image_ea5094.png), el campo "URL base" en la pestaña de configuración general es un campo de solo lectura. En la interfaz de Azure Portal, este campo específico está codificado de forma fija para mostrar permanentemente la URL predeterminada de la puerta de enlace gestionada en la nube (normalmente terminando en .azure-api.net) junto con el sufijo de tu API.

Aquí está la razón por la que funciona así:

Relación de uno a muchos: Azure APIM permite que una única API se asocie simultáneamente con múltiples gateways. Por ejemplo, podrías tener tu API expuesta en la pasarela gestionada por defecto, una pasarela autoalojada en un centro de datos local y otra pasarela autoalojada en AWS.

Limitación de la interfaz: Debido a que puede haber muchas URLs base válidas para una sola API dependiendo de la pasarela que llame el cliente, la página de configuración general no intercambia dinámicamente ese cuadro de texto. Simplemente se ancla a la instancia gestionada principal.

El hecho de que veas la URL correcta del gateway autoalojado cuando vas a la pestaña de Test (o al Portal de Desarrolladores) es exactamente lo que quieres ver. La pestaña Test es consciente del contexto y te permite seleccionar por qué entorno de gateway específico estás enrutando el tráfico.

Dado que tus aplicaciones cliente están accediendo con éxito al gateway autoalojado y la pestaña de Prueba refleja el enrutamiento correcto, puedes considerar tu configuración completa y exitosa con confianza. ¡Buen trabajo montando esto! Por favor, acepta como respuesta si te resulta útil.

Compartir a través de

APIM Self-Hosted Gateway Configuration Problems

0 respuestas adicionales

Su respuesta