Proxy Zone Migration Overview

Migrate legacy zones to proxy zones by using B2C Commerce Business Manager or the CDN-API. Proxy zones give you standard eCDN configuration and the latest security features, and they prevent common hierarchy-assignment issues. Migration is required to move to Hyperforce, which doesn't support legacy zones.

A legacy zone is shared across your Development, Staging, and Production instances. Migrating it to a proxy zone modernizes your eCDN setup and is a prerequisite for Hyperforce. Perform the migration on each instance (Dev, Staging, and Production), and delete the legacy zone only after every instance has been migrated successfully.

Important If you already have an active legacy zone for a fully qualified domain name (for example, through eCDN or as an existing Cloudflare Orange-to-Orange customer), the legacy zone takes priority over the proxy zone and wildcard custom hostnames don't work. Migrate and remove the legacy zone to resolve the conflict.

1. Migrate a Legacy Zone to a Proxy Zone
   Start the migration of a B2C Commerce legacy zone to a proxy zone in Business Manager or with the CDN-API. Proxy zones use standard eCDN configuration and the latest security features and prevent common hierarchy-assignment issues. This migration is required to move to Hyperforce, which doesn't support legacy zones.
2. Configure Proxy Zone Settings
   After you migrate a B2C Commerce legacy zone to a proxy zone, most settings transfer automatically. Manually copy the two settings that don't transfer, Logpush and rate limiting rules, from the legacy zone to the new proxy zone.
3. Create a Custom Hostname with a Custom Certificate
   When you migrate a legacy zone to a proxy zone, a certificate is automatically created with the validation method set to "http". If you need a different validation method, delete the generated certificate and add a custom one. Create the custom certificate in Business Manager for B2C Commerce or use the addCertificateForZone API.
4. Update Authoritative DNS
   Point your B2C Commerce storefront's DNS records at the new proxy zone. Get the DNS CNAME record value from the getZonesInfo name property or from Business Manager, and then update the record with your authoritative DNS provider.
5. Remove a Subdomain from a Legacy Zone
   After you migrate a subdomain to the proxy zone, remove it from the legacy zone and delete the old certificate so that the legacy certificate no longer shows on your B2C Commerce storefront.
6. Delete a Legacy Zone
   After you move all subdomains from the B2C Commerce legacy zone to the proxy zone, delete the legacy zone with the Remove Zone option. This is the final step of the proxy zone migration.