Multi Domain Workspace

Multi Domain Workspace

Resumen

Vor-Tex permite asociar múltiples dominios personalizados a una cuenta. Esta configuración reemplaza los dominios por defecto bajo *.vor-tex.io por dominios propios, tanto para el portal para desarrolladores como para los distintos entornos del API Gateway. Esta guía explica dónde se configuran, qué requisito de DNS hace falta y cómo publicar una versión de API en un dominio.

Antes de comenzar

  • Configure los registros CNAME en el administrador de DNS de su organización. Todos los dominios deben apuntar a cloud.vor-tex.io.
  • Puede verificar la propagación de los registros CNAME con https://www.whatsmydns.net/ antes de guardar la configuración en Vor-Tex.
  • Para instalar y configurar certificados SSL sobre los dominios personalizados, contacte al equipo de soporte en support@vor-tex.io.

Configurar los dominios

Acceder a la configuración

Ingrese a Workspace > Configuraciones > Dominios. La sección tiene estas áreas:

  • Portal para desarrolladores: dominio público del portal de APIs expuesto a los consumidores.
  • Websocket: dominio utilizado para conexiones WebSocket en tiempo real.
  • SOAP: dominio para el gateway de servicios SOAP.
  • Dominios de las APIs: tabla de dominios por entorno, cada uno con nombre, tipo y subdominio asignado.

Estructura recomendada

UsoTipoEjemplo de dominio
Portal del desarrolladorPortalciudadabierta.portal.empresa.com
API de producciónProductionprod.api.empresa.com
API de stagingStagingstg.api.empresa.com
API de desarrolloDevelopmentdevelopers.api.empresa.com
WebSocketProductionwss.empresa.com
SOAP GatewayProductiongateway-soap.empresa.com

Dominios de las APIs (entornos)

La sección inferior de la pantalla muestra todos los dominios de API configurados. Cada entrada incluye:

  • Nombre: identificador del entorno, por ejemplo Development, Prod2, Production, soap, Staging o Websocket.
  • Tipo: categoría del entorno (Development, Production o Staging).
  • Subdominio: el dominio activo asociado a ese entorno.

Para agregar un dominio de API, haga clic en Agregar dominio, en la esquina superior derecha de la tabla. Con el selector Elementos por página puede controlar cuántas entradas se ven.

Publicar una versión de API en un dominio

Con los dominios configurados, puede publicar versiones de APIs en entornos específicos. Esto determina bajo qué URL queda disponible el método para los consumidores.

  1. Acceda a la versión de la API que desea publicar.
  2. Seleccione el entorno (dominio) de destino.
  3. Confirme la publicación.

Resultado esperado

La API queda accesible bajo el subdominio configurado para el entorno elegido, y el portal para desarrolladores, WebSocket y SOAP responden en los dominios propios de la organización.

Errores frecuentes

  • El dominio no responde: el registro CNAME no apunta a cloud.vor-tex.io o todavía no se propagó. Verifíquelo con whatsmydns.net.
  • El navegador muestra un error de certificado: falta instalar el certificado SSL del dominio personalizado. Contacte a support@vor-tex.io.

Artículos relacionados