Dominio propio de un proveedor

En Pro, un proveedor puede configurar su propia dirección de portal en Configuración → Branding, como portal.theircompany.com o order.theircompany.com. El proveedor se lee desde ese host. Una persona solo ve un portal al que pertenece. El personal inicia sesión en esa misma dirección y abre el espacio de trabajo allí. Al cerrar sesión, se devuelve a la página de inicio de sesión de esa dirección. Los compradores siguen abriendo el portal comercial.

Use portal. o order. en lugar del dominio sin formato. El dominio sin formato es donde se establece el correo electrónico del proveedor, y un CNAME allí lucha contra esos registros de correo. La aplicación rechaza un nombre sin formato como theircompany.com.

theirname.tradecatalog.app y tradecatalog.app/p/theirname siguen funcionando. El correo sigue enviándose desde orders@tradecatalog.app. Las páginas en la dirección del proveedor envían X-Robots-Tag: noindex. /mcp, /oauth y /api/v1 permanecen en tradecatalog.app.

Conecte su direcciónEnlace a esta sección#

Abra Configuración → Branding → Su dirección de portal en Pro.

1. Elija Usar su marca para colocar su nombre, logo y colores en la pantalla de inicio de sesión, el portal, correos electrónicos y documentos de pedido. La información del servicio permanece en la página de inicio de sesión.
2. Ingrese una dirección como portal.theircompany.com y elija Guardar dirección y marca. Esto guarda la dirección y la marca juntas y comienza la verificación.
3. Agregue el CNAME mostrado en su proveedor de DNS. Los botones de copia copian el nombre y el destino exactos. Si su proveedor agrega automáticamente su dominio, ingrese solo la parte antes de su dominio en Nombre.
4. Siga Dirección guardada, Dominio verificado y Conexión segura. La activación del nombre de host y la emisión del certificado son verificaciones separadas. Un dominio verificado no significa que HTTPS esté listo.
5. Las verificaciones se refrescan cada 30 segundos durante hasta diez minutos mientras esta página está visible. Elija Verificar conexión nuevamente para intentar de nuevo después de cambiar DNS o si las verificaciones automáticas se han detenido.
6. Una vez que aparezca Su certificado está listo, verifique que su CNAME apunte al destino mostrado y use Abrir su página de inicio de sesión para verificar que su portal propio se abra de forma segura antes de compartirla. La preparación del proveedor no verifica independientemente a dónde envía su registrador el tráfico. Su enlace al portal existente permanece disponible durante toda la configuración.

Las nuevas direcciones usan validación de certificado HTTP automática. Una verificación de conexión puede reintentar con seguridad un certificado pendiente en el mismo nombre de host, sin eliminarlo. Las configuraciones antiguas de TXT pueden pasar a la validación HTTP cuando sean elegibles. La validación de DNS delegado y comodín retienen su método existente.

Cuando se necesita validación de DNS, se muestran todos los valores TXT requeridos, incluidos ambos valores cuando dos registros comparten un nombre. Los registros CNAME de delegación son una alternativa cuando se ofrece. Mantenga los registros de delegación para renovaciones; un registro CNAME y un registro TXT no pueden compartir el mismo nombre. Para la validación HTTP automática, se encuentran disponibles otros registros de verificación de certificado bajo Registros adicionales de verificación de certificado en lugar de presentarse como un paso adicional requerido.

La página muestra la hora de la última verificación y cualquier problema informado por el servicio de certificados. Un intento fallido mantiene su dirección actual y los registros de verificación. Si necesita ayuda, utilice Obtener ayuda para conectar su dirección. No necesita administrar las credenciales de la API de TradeCatalog ni buscar un botón de plataforma oculto.

Dejar en blanco la dirección guardada y elegir Eliminar dirección y guardar la marca la eliminará. Cuando la plataforma esté conectada a Cloudflare, el antiguo nombre de host personalizado también se eliminará allí. No cambia los registros DNS de su registrador.

Para operadores de plataformaEnlace a esta sección#

Las secciones siguientes describen la infraestructura de TradeCatalog, no los pasos que deben completar los proveedores. El origen de respaldo y la ruta de captura de producción se configuran por separado. No cambie las credenciales del proveedor o las rutas de zona al seguir la configuración del proveedor anterior.

Cloudflare para SaaSEnlace a esta sección#

Hágalo en la zona tradecatalog.app, manualmente, cuando esté listo para activar los dominios personalizados. Habilite Cloudflare para SaaS para esa zona primero.

1. Origen de respaldoEnlace a esta sección#

El tráfico con nombre de host personalizado se envía a un origen de respaldo en su zona. Para un Worker, ese registro es sin origen:

Luego establezca el origen de respaldo en fallback.tradecatalog.app. En el panel de control, es SSL/TLS → Nombres de host personalizados → Origen de respaldo. Con la API:

PUT /zones/{zone_id}/custom_hostnames/fallback_origin
{ "origin": "fallback.tradecatalog.app" }

Espere a que ese origen de respaldo esté Activo. Vea Workers como origen de respaldo.

2. Ruta de WorkerEnlace a esta sección#

Esa ruta ya está en las rutas de producción en wrangler.jsonc. Wrangler reemplaza las rutas al desplegar, por lo que eliminarla allí detendría que el dominio propio de un proveedor llegue a este Worker. No la agregue a la fase de prueba.

{ "pattern": "*/*", "zone_name": "tradecatalog.app" }

Esa ruta envía a este Worker todo host que ingrese a la zona, incluido el dominio propio de un cliente. Las rutas más específicas ganan, así que deje las rutas que ya están allí:

{ "pattern": "tradecatalog.app", "custom_domain": true }

{ "pattern": "*.tradecatalog.app/*", "zone_name": "tradecatalog.app" }

Y deje la ruta del Worker de prueba como está:

{ "pattern": "staging.tradecatalog.app", "custom_domain": true }

No coloque */* en la fase de prueba. No cree un nombre de host personalizado igual a tradecatalog.app, www.tradecatalog.app o fallback.tradecatalog.app.

3. API de nombres de host personalizadosEnlace a esta sección#

La aplicación llama a la API de nombres de host personalizados cuando un proveedor verifica una dirección, y solo después de que estos estén configurados en el Worker de producción:

• CLOUDFLARE_API_TOKEN como secreto, con permiso para editar nombres de host personalizados y sus certificados
• CLOUDFLARE_ZONE_ID como el id de zona tradecatalog.app

POST /zones/{zone_id}/custom_hostnames
{
  "hostname": "portal.theircompany.com",
  "ssl": { "method": "http", "type": "dv", "settings": { "min_tls_version": "1.2" } }
}

La encuesta de estado usa GET /zones/{zone_id}/custom_hostnames/{id}. Una verificación de conexión iniciada por el proveedor puede PATCH un certificado DV gestionado por el proveedor pendiente y luego leer su estado nuevamente, preservando sus configuraciones SSL. Nunca elimina o vuelve a crear un nombre de host. Los certificados personalizados activos y cargados no se reinician, y la validación delegada o de comodín permanece en TXT. Al borrar o reemplazar una dirección, se envía DELETE para el id anterior.

Las nuevas direcciones usan validación de certificado HTTP: una vez que el CNAME apunte al origen de respaldo, Cloudflare puede validar automáticamente. Las direcciones existentes mantienen su método de validación original hasta que se cambie.

El personal de la plataforma puede ejecutar Verificar dirección para cualquier empresa desde la cuenta de cliente de esa empresa, y al abrir el espacio de trabajo y usar Configuración → Marca. Restablecer validación de certificado solo es para el personal de la plataforma. Pide a Cloudflare que establezca el método de certificado en HTTP. Si Cloudflare no cambia el método en el nombre de host existente, el nombre de host se elimina y se vuelve a crear con la misma dirección y configuración de certificado, y se guarda el nuevo id. La confirmación indica que esto cambia el nombre de host personalizado en vivo de Cloudflare. Mientras se ejecuta el restablecimiento, el botón de confirmación muestra "Restableciendo...", muestra una animación y no se puede presionar nuevamente. Después, la página muestra el estado y cualquier registro DNS que enviar a los proveedores. Verificar dirección en la cuenta del cliente hace lo mismo mientras se ejecuta la verificación. Un propietario de proveedor no puede ejecutar el restablecimiento.

Para una dirección que aún usa TXT o delegación después de un reintento seguro, el proveedor elige Verificar conexión nuevamente, agrega cada registro de certificado mostrado bajo Agregue estos registros en el proveedor de DNS, y vuelve a verificar. El DNS puede conectarse mientras el certificado aún necesita estos registros. No reemplace un token TXT con otro cuando se muestren dos. Si se ofrece delegación, use sus registros CNAME en lugar de los registros TXT conflictivos. La aplicación no redirige /.well-known/acme-challenge/ ni /.well-known/pki-validation/ en ese host. Deje esos caminos intactos en cualquier regla de redirección, para que una verificación de certificado no se reescriba.

Lo que el cliente agregaEnlace a esta sección#

Un CNAME para portal.theircompany.com (o order.) que apunte a fallback.tradecatalog.app.

Recomienda este nombre. Un dominio básico como theircompany.com no puede ser un CNAME normal sin mover el correo electrónico, y la proxying de nivel raíz de Cloudflare es una configuración separada. No lo uses.