Een domein van de leverancier zelf

Op Pro kan een leverancier hun eigen portal adres instellen in Instellingen → Merkbeeld, zoals portal.theircompany.com of order.theircompany.com. De leverancier wordt opgehaald vanaf dat host. Een persoon ziet nog steeds alleen een portal waar ze bij horen. Medewerkers melden zich aan op datzelfde adres en openen de werkruimte daar. Uitloggen brengt terug naar de inlogpagina van dat adres. Kopers openen nog steeds de handelsportal.

Gebruik portal. of order. in plaats van het blote domein. Het blote domein is waar de e-mail van de leverancier is ingesteld, en een CNAME daar kan die e-mailrecords verstoren. De app weigert een blote naam zoals theircompany.com.

theirname.tradecatalog.app en tradecatalog.app/p/theirname blijven werken. E-mail wordt nog steeds verzonden vanaf orders@tradecatalog.app. Pagina's op het adres van de leverancier sturen X-Robots-Tag: noindex. /mcp, /oauth en /api/v1 blijven op tradecatalog.app.

Verbind je adresLink naar deze sectie#

Open Instellingen → Merkbeeld → Je portal adres op Pro.

1. Kies Gebruik je merkbeeld om je naam, logo en kleuren op de inlogpagina, de portal, e-mails en besteldocumenten te zetten. Serviceinformatie blijft op de inlogpagina.
2. Voer een adres zoals portal.theircompany.com in en kies Opslaan adres en merkbeeld. Dit slaat het adres en merkbeeld samen op en start de controle.
3. Voeg de CNAME toe die verschijnt bij je DNS leverancier. Kopieerknoppen kopiëren de exacte naam en doel. Als je leverancier je domein automatisch toevoegt, voer dan alleen het deel voor je domein in Naam.
4. Volg Adres opgeslagen, Domein geverifieerd en Beveiligde verbinding. Hostnaam activering en certificaatuitgifte zijn aparte controles. Een geverifieerd domein betekent niet dat HTTPS klaar is.
5. Controles vernieuwen elke 30 seconden gedurende maximaal tien minuten terwijl deze pagina zichtbaar is. Kies Controleer verbinding opnieuw om te proberen na het aanpassen van DNS of als automatische controles zijn gestopt.
6. Zodra Je certificaat is klaar verschijnt, controleer of je CNAME naar het weergegeven doel wijst en gebruik Open je inlogpagina om te controleren of je eigen portal veilig opent voordat je het deelt. Leveranciersbereidheid verifieert niet onafhankelijk waar je registratieverkeer naartoe stuurt. Je bestaande portal link blijft beschikbaar tijdens de setup.

Nieuwe adressen gebruiken automatische HTTP certificaatvalidatie. Een verbindingstest kan veilig opnieuw proberen met een pendend certificaat op dezelfde hostnaam, zonder het te verwijderen. Oudere TXT setup kan overgaan naar HTTP validatie wanneer geschikt. Gedelegeerde en wildcard DNS validatie behouden hun bestaande methode.

Bij DNS validatie worden alle vereiste TXT waarden weergegeven, inclusief beide waarden wanneer twee records dezelfde naam delen. Delegatie CNAME records zijn een alternatief wanneer aangeboden. Houd de delegatie records voor vernieuwingen; een CNAME en TXT records kunnen niet dezelfde naam delen. Voor automatische HTTP validatie zijn extra DNS verificatie records beschikbaar onder Extra certificaatverificatie records in plaats van als een vereiste extra stap.

De pagina toont de tijd van de laatste controle en eventuele problemen die zijn gemeld door de certificaatservice. Een mislukte poging houdt uw huidige adres- en verificatiegegevens behouden. Als u hulp nodig heeft, gebruik dan Hulp bij het verbinden van uw adres. U hoeft de API-referenties van TradeCatalog niet te beheren of op te zoeken naar een verborgen platformknop.

Als u het opgeslagen adres leeg laat en Adres verwijderen en merkgegevens opslaan kiest, wordt het verwijderd. Wanneer het platform is verbonden met Cloudflare, wordt de oude aangepaste hostnaam daar ook verwijderd. Dit verandert uw DNS-instellingen bij de registrator niet.

Voor platformbeheerdersLink naar deze sectie#

De onderstaande secties beschrijven de infrastructuur van TradeCatalog, niet de stappen die leveranciers moeten voltooien. De fallback origin en de productie catch-all route zijn apart geconfigureerd. Verander geen providerreferenties of zone routes tijdens het volgen van de bovenstaande leveranciersinstellingen.

Cloudflare voor SaaSLink naar deze sectie#

Doe dit op de tradecatalog.app zone, handmatig, wanneer u klaar bent om aangepaste domeinen in te schakelen. Cloudflare voor SaaS activeren voor die zone eerst.

1. Fallback originLink naar deze sectie#

Aangepaste hostnaamverkeer wordt naar een fallback origin in uw zone gestuurd. Voor een Worker is dit record zonder oorsprong:

Stel de fallback origin vervolgens in op fallback.tradecatalog.app. In de dashboard is dit SSL/TLS → Aangepaste hostnamen → Fallback origin. Met de API:

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

Wacht tot deze fallback origin Actief is. Zie Workers als uw fallback origin.

2. Worker routeLink naar deze sectie#

Deze route is al opgenomen in de productie routes in wrangler.jsonc. Wrangler vervangt routes bij het implementeren, dus het verwijderen ervan zou ervoor zorgen dat een leveranciers eigen domein deze Worker niet bereikt. Voeg deze niet toe aan staging.

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

Deze route stuurt elk hostnaam dat de zone binnenkomt naar deze Worker, inclusief het eigen domein van een klant. Meer specifieke routes winnen, dus laat de bestaande routes staan:

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

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

Laat de route van de staging Worker zoals deze is:

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

Voeg */* niet toe aan staging. Maak geen aangepaste hostnaam gelijk aan tradecatalog.app, www.tradecatalog.app of fallback.tradecatalog.app.

3. Aangepaste hostnamen APILink naar deze sectie#

De app roept de aangepaste hostnamen API aan wanneer een leverancier een adres controleert, en pas nadat deze zijn ingesteld op de productie Worker:

• CLOUDFLARE_API_TOKEN als geheim, met toestemming om aangepaste hostnamen en hun certificaten te bewerken
• CLOUDFLARE_ZONE_ID als de tradecatalog.app zone id

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

Status polling gebruikt GET /zones/{zone_id}/custom_hostnames/{id}. Een leverancier-initieerde verbindingstest kan veilig PATCH een pendende provider-beheerde DV-certificaat en daarna opnieuw de status lezen, terwijl de SSL-instellingen behouden blijven. Het verwijdert of hermaakt nooit een hostnaam. Actieve en geüploade aangepaste certificaten worden niet opnieuw gestart, en gedelegeerde of wildcard validatie blijft TXT. Het wissen of vervangen van een adres stuurt DELETE voor de vorige id.

Nieuwe adressen gebruiken HTTP-certificaatvalidatie: zodra de CNAME naar de fallback origin wijst, kan Cloudflare dit automatisch valideren. Bestaande adressen behouden hun oorspronkelijke validatiemethode tot deze wordt gewijzigd.

Platformmedewerkers kunnen Adres controleren uitvoeren voor elk bedrijf vanuit het klantaccount van dat bedrijf, en door het werkruimte te openen en Instellingen → Merkgegevens te gebruiken. Certificaatvalidatie opnieuw instellen is alleen voor platformmedewerkers. Het vraagt Cloudflare om de certificatiemethode in te stellen op HTTP. Als Cloudflare de methode niet kan wijzigen op de bestaande hostnaam, wordt de hostnaam verwijderd en opnieuw gemaakt met hetzelfde adres en certificaatinstellingen, en wordt de nieuwe id opgeslagen. De bevestiging zegt dat dit de live Cloudflare aangepaste hostnaam verandert. Terwijl het opnieuw instellen wordt uitgevoerd, toont de bevestigingsknop Resetten…, een spinner en kan deze niet opnieuw worden ingedrukt. Daarna toont de pagina de status en eventuele DNS-gegevens om te sturen naar de leverancier. Controleer het adres op het klantaccount doet hetzelfde terwijl de controle wordt uitgevoerd. Een leveranciershouder kan het opnieuw instellen niet uitvoeren.

Voor een adres dat nog steeds TXT of gedelegeerd gebruikt na een veilige poging, kiest de leverancier Verbinding opnieuw controleren, voegt elke certificaatrecord toe die onder Deze records toevoegen worden weergegeven bij de DNS-provider, en controleert opnieuw. DNS kan worden verbonden terwijl het certificaat nog deze records nodig heeft. Voeg geen enkele TXT-token in plaats van de andere wanneer twee worden weergegeven. Als gedelegeerd wordt aangeboden, gebruik dan de CNAME-records in plaats van conflicterende TXT-records. De app richt geen omleidingen om /.well-known/acme-challenge/ of /.well-known/pki-validation/ op die host. Laat deze paden onaangetast in elke omleidingsregel, zodat een certificaatcontrole niet wordt herschreven.

Wat de klant toevoegtLink naar deze sectie#

Een CNAME voor portal.theircompany.com (of order.) die wijst naar fallback.tradecatalog.app.

Beveel deze naam aan. Een lege domeinnaam zoals theircompany.com kan geen normale CNAME zijn zonder het verplaatsen van e-mail, en de apex-proxy van Cloudflare is een aparte instelling. Gebruik deze niet.