Domínio próprio de um fornecedor

No Pro, um fornecedor pode definir seu próprio endereço de portal em Configurações → Branding, como portal.theircompany.com ou order.theircompany.com. O fornecedor é lido a partir desse host. Uma pessoa ainda só vê um portal ao qual pertence. Os funcionários entram no mesmo endereço e abrem o workspace lá. Ao sair, retorna à página de login desse endereço. Os compradores ainda abrem o portal comercial.

Use portal. ou order. em vez do domínio puro. O domínio puro é onde o e-mail do fornecedor é definido, e um CNAME lá luta contra esses registros de e-mail. O aplicativo recusa um nome puro, como theircompany.com.

theirname.tradecatalog.app e tradecatalog.app/p/theirname continuam funcionando. O e-mail ainda é enviado de orders@tradecatalog.app. Páginas no endereço próprio do fornecedor enviam X-Robots-Tag: noindex. /mcp, /oauth e /api/v1 permanecem em tradecatalog.app.

Conecte seu endereçoLink para esta seção#

Abra Configurações → Branding → Seu endereço do portal no Pro.

1. Escolha Use seu branding para colocar seu nome, logotipo e cores na tela de login, no portal, e-mails e documentos de pedidos. As informações do serviço ficam na página de login.
2. Insira um endereço, como portal.theircompany.com e escolha Salvar endereço e branding. Isso salva o endereço e o branding juntos e inicia a verificação.
3. Adicione o CNAME mostrado no seu provedor de DNS. Botões de cópia copiam o nome e o alvo exatos. Se seu provedor adicionar seu domínio automaticamente, insira apenas a parte antes do seu domínio em Nome.
4. Siga Endereço salvo, Domínio verificado e Conexão segura. Ativação do hostname e emissão de certificado são verificações separadas. Um domínio verificado sozinho não significa que o HTTPS esteja pronto.
5. As verificações são atualizadas a cada 30 segundos por até dez minutos enquanto esta página estiver visível. Escolha Verificar conexão novamente para tentar novamente após alterar o DNS ou se as verificações automáticas tiverem parado.
6. Assim que Seu certificado está pronto aparecer, verifique se seu CNAME aponta para o alvo mostrado e use Abrir sua página de login para verificar se seu próprio portal abre com segurança antes de compartilhá-lo. A prontidão do provedor não verifica independentemente para onde seu registrador está enviando o tráfego. Seu link de portal existente permanece disponível durante toda a configuração.

Novos endereços usam validação de certificado HTTP automática. Uma verificação de conexão pode repetir com segurança um certificado pendente no mesmo hostname, sem excluí-lo. Configurações TXT antigas podem migrar para validação HTTP quando elegíveis. Validação de DNS delegado e wildcard retém seu método existente.

Quando a validação de DNS for necessária, todos os valores TXT necessários são mostrados, incluindo ambos os valores quando dois registros compartilham um nome. Registros CNAME de delegação são uma alternativa quando oferecidos. Mantenha os registros de delegação para renovações; um registro CNAME e registros TXT não podem compartilhar o mesmo nome. Para validação HTTP automática, registros adicionais de verificação de certificado estão disponíveis em Registros adicionais de verificação de certificado em vez de apresentados como uma etapa extra necessária.

A página mostra o horário da última verificação e quaisquer problemas relatados pelo serviço de certificado. Uma tentativa falhada mantém seu endereço e registros de verificação atuais. Se precisar de ajuda, use Obter ajuda para conectar seu endereço. Você não precisa gerenciar as credenciais da API do TradeCatalog ou procurar um botão oculto na plataforma.

Deixar o endereço salvo em branco e escolher Remover endereço e salvar branding o removerá. Quando a plataforma estiver conectada ao Cloudflare, o antigo hostname personalizado também será removido lá. Isso não altera os registros DNS do seu registrador.

Para operadores da plataformaLink para esta seção#

As seções abaixo descrevem a infraestrutura do TradeCatalog, não os passos que os fornecedores precisam completar. A origem de fallback e a rota de catch-all de produção são configuradas separadamente. Não altere as credenciais do provedor ou as rotas de zona ao seguir a configuração do fornecedor acima.

Cloudflare para SaaSLink para esta seção#

Faça isso na zona tradecatalog.app, manualmente, quando estiver pronto para ativar os domínios personalizados. Ative o Cloudflare para SaaS para essa zona primeiro.

1. Origem de fallbackLink para esta seção#

O tráfego com hostname personalizado é enviado para uma origem de fallback na sua zona. Para um Worker, esse registro é sem origem:

Em seguida, defina a origem de fallback como fallback.tradecatalog.app. No painel, isso é SSL/TLS → Hostnames personalizados → Origem de fallback. Com a API:

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

Espere até que essa origem de fallback esteja Ativa. Veja Workers como sua origem de fallback.

2. Rota do WorkerLink para esta seção#

Essa já está nas rotas de produção em wrangler.jsonc. O Wrangler substitui as rotas durante o deploy, então removê-la lá pararia o domínio de um fornecedor de alcançar esse Worker. Não a adicione ao ambiente de staging.

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

Essa rota envia todo host que entra na zona para esse Worker, incluindo o domínio próprio de um cliente. Rotas mais específicas vencem, então deixe as rotas que já estão lá:

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

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

E deixe a rota do Worker de staging como está:

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

Não coloque */* no staging. Não crie um hostname personalizado igual a tradecatalog.app, www.tradecatalog.app ou fallback.tradecatalog.app.

3. API de hostnames personalizadosLink para esta seção#

O app chama a API de hostnames personalizados quando um fornecedor verifica um endereço, e somente após esses estarem configurados no Worker de produção:

• CLOUDFLARE_API_TOKEN como segredo, com permissão para editar hostnames personalizados e seus certificados
• CLOUDFLARE_ZONE_ID como o id da zona tradecatalog.app

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

A verificação de status usa GET /zones/{zone_id}/custom_hostnames/{id}. Uma verificação de conexão iniciada pelo fornecedor pode seguramente PATCH um certificado DV gerenciado pelo provedor pendente e depois ler seu status novamente, preservando suas configurações SSL. Ele nunca apaga ou recria um hostname. Certificados personalizados ativos e carregados não são reiniciados, e a validação delegada ou wildcard permanece como TXT. Limpar ou substituir um endereço envia DELETE para o id anterior.

Novos endereços usam validação de certificado HTTP: uma vez que o CNAME aponte para a origem de fallback, o Cloudflare pode validar automaticamente. Endereços existentes mantêm seu método de validação original até que seja alterado.

Funcionários da plataforma podem executar Verificar endereço para qualquer empresa a partir da conta do cliente dessa empresa, e ao abrir o workspace e usar Configurações → Branding. Redefinir validação de certificado é exclusivo para funcionários da plataforma. Ele pede ao Cloudflare para definir o método do certificado como HTTP. Se o Cloudflare não mudar o método no hostname existente, o hostname é removido e criado novamente com as mesmas configurações de endereço e certificado, e o novo id é salvo. A confirmação diz que isso altera o hostname personalizado ativo no Cloudflare. Enquanto a redefinição está em execução, o botão de confirmação diz Redefinindo…, mostra uma animação de carregamento e não pode ser pressionado novamente. Após isso, a página mostra o status e quaisquer registros DNS a serem enviados ao fornecedor. Verificar endereço na conta do cliente faz o mesmo enquanto a verificação está em execução. Um proprietário de fornecedor não pode executar a redefinição.

Para um endereço que ainda usa TXT ou delegação após uma tentativa segura, o fornecedor escolhe Verificar conexão novamente, adiciona todos os registros de certificado mostrados sob Adicionar esses registros no provedor de DNS, e verifica novamente. O DNS pode ser conectado enquanto o certificado ainda precisa desses registros. Não substitua um token TXT pelo outro quando dois forem mostrados. Se a delegação for oferecida, use seus registros CNAME em vez dos registros TXT conflitantes. O app não redireciona /.well-known/acme-challenge/ ou /.well-known/pki-validation/ nesse host. Deixe esses caminhos em paz em qualquer regra de redirecionamento, para que uma verificação de certificado não seja reescrita.

O que o cliente adicionaLink para esta seção#

Um CNAME para portal.theircompany.com (ou order.) apontando para fallback.tradecatalog.app.

Recomenda-se esse nome. Um domínio simples, como theircompany.com, não pode ser um CNAME normal sem mover o e-mail, e o proxy de apex do Cloudflare é uma configuração separada. Não o use.