La plataforma 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 del Desarrollador como para los diferentes entornos del
API Gateway.
1.1 Acceso a la Configuración de Dominios
Para acceder a la configuración de
dominios, navegá a:
|
Workspace >
Configuraciones > Dominios
|
En esta sección encontrarás tres
áreas de configuración:
• 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.
1.2 Requisito Previo: Configuración de CNAME
Antes de ingresar dominios en la
plataforma, es necesario configurar los registros CNAME en el administrador de
DNS de tu organización. Todos los dominios deben apuntar a:
|
💡
Tip: Podés verificar
la propagación de los registros CNAME usando la herramienta
https://www.whatsmydns.net/ antes de guardar la configuración en Vor-Tex.
|
Ejemplo de estructura de dominios
recomendada:
|
Uso
|
Tipo
|
Ejemplo de
Dominio
|
|
Portal del
Desarrollador
|
Portal
|
ciudadabierta.portal.empresa.com
|
|
API de
Producción
|
Production
|
prod.api.empresa.com
|
|
API de
Staging
|
Staging
|
stg.api.empresa.com
|
|
API de
Desarrollo
|
Development
|
developers.api.empresa.com
|
|
WebSocket
|
Production
|
wss.empresa.com
|
|
SOAP Gateway
|
Production
|
gateway-soap.empresa.com
|
1.3 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 (ej: Development, Prod2, Production, soap, Staging, Websocket).
• Tipo: categoría del entorno
(Development, Production, Staging).
• Subdominio: el dominio
activo asociado a ese entorno.
Para agregar un nuevo dominio de
API, hacer clic en el botón Agregar dominio ubicado en la esquina superior
derecha de la tabla. Se puede controlar la cantidad de entradas visibles
mediante el selector Elementos por página.
1.4 Publicar una Versión de API en un Dominio
Una vez configurados los dominios,
es posible publicar versiones de APIs en entornos específicos. Esto determina
bajo qué URL quedará disponible el método para los consumidores.
El flujo general es:
• Acceder a la versión de la
API que se desea publicar.
• Seleccionar el entorno
(dominio) de destino.
• Confirmar la publicación.
La API quedará accesible bajo el subdominio configurado para ese entorno.
|
📌
Nota: Contactar al
equipo de soporte en support@vor-tex.io para la instalación y configuración
de certificados SSL sobre dominios personalizados.
|