Skip to content

Commit 5a02152

Browse files
[CF4SaaS] Clarify O2O intro adding a DNS record example (#19098)
* Style guide adjustments and consistently use 2nd person * Fix example breaking mermaid diagram in getting-started * Bring 'With O2O' higher and provide intro to the CNAME record * Add CNAME record example to how-it-works * Nit: Remove redundant 'Step' in H3s
1 parent dee6e8f commit 5a02152

File tree

4 files changed

+38
-24
lines changed

4 files changed

+38
-24
lines changed

src/content/docs/cloudflare-for-platforms/cloudflare-for-saas/saas-customers/how-it-works.mdx

Lines changed: 31 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -9,52 +9,66 @@ head:
99

1010
---
1111

12-
Orange-to-Orange (O2O) is a specific traffic routing configuration where traffic routes through two Cloudflare zones: the first Cloudflare zone is owned by customer 1 and the second Cloudflare zone is owned by customer 2, who is considered a SaaS Provider.
12+
import { Example } from "~/components";
1313

14-
If one or more hostnames are onboarded to a SaaS Provider that uses Cloudflare products as part of their platform, specifically the [Cloudflare for SaaS product](/cloudflare-for-platforms/cloudflare-for-saas/), those hostnames will be created as Custom Hostnames in the SaaS Provider's zone. The Custom Hostnames must be activated to give the SaaS Provider permission to route traffic for the hostname through their zone.
14+
Orange-to-Orange (O2O) is a specific traffic routing configuration where traffic routes through two Cloudflare zones: the first Cloudflare zone is owned by customer 1 and the second Cloudflare zone is owned by customer 2, who is considered a SaaS provider.
1515

16-
## Without O2O
16+
If one or more hostnames are onboarded to a SaaS Provider that uses Cloudflare products as part of their platform - specifically the [Cloudflare for SaaS product](/cloudflare-for-platforms/cloudflare-for-saas/) - those hostnames will be created as [custom hostnames](/cloudflare-for-platforms/cloudflare-for-saas/domain-support/) in the SaaS Provider's zone.
1717

18-
If you do not have your own Cloudflare zone and have only onboarded one or more of your hostnames to a SaaS Provider, then O2O will not be enabled.
18+
To give the SaaS provider permission to route traffic through their zone, any custom hostname must be activated by you (the SaaS customer) by placing a [CNAME record](/cloudflare-for-platforms/cloudflare-for-saas/start/getting-started/#3-have-customer-create-cname-record) on your authoritative DNS. If your authoritative DNS is Cloudflare, you have the option to [proxy](/fundamentals/concepts/how-cloudflare-works/#application-services) your CNAME record, achieving an Orange-to-Orange setup.
1919

20-
Without O2O enabled, the settings configured in the SaaS Provider's zone will be applied to the traffic.
20+
21+
## With O2O
22+
23+
If you have your own Cloudflare zone (`example.com`) and your zone contains a [proxied DNS record](/dns/manage-dns-records/reference/proxied-dns-records/) matching the custom hostname (`mystore.example.com`) with a **CNAME** target defined by the SaaS Provider, then O2O will be enabled.
24+
25+
<Example>
26+
27+
DNS management for **example.com**
28+
29+
| **Type** | **Name** | **Target** | **Proxy status** |
30+
| -------- | ------------ | --------------------------------- | ---------------- |
31+
| `CNAME` | `mystore` | `customers.saasprovider.com` | Proxied |
32+
33+
</Example>
34+
35+
With O2O enabled, the settings configured in your Cloudflare zone will be applied to the traffic first, and then the settings configured in the SaaS provider's zone will be applied to the traffic second.
2136

2237
```mermaid
2338
flowchart TD
24-
accTitle: Your zone using a SaaS provider, but without O2O
39+
accTitle: O2O-enabled traffic flow diagram
2540
2641
A[Website visitor]
2742
2843
subgraph Cloudflare
29-
B[SaaS Provider-owned zone]
44+
B[Customer-owned zone]
45+
C[SaaS Provider-owned zone]
3046
end
3147
32-
C[SaaS Provider Origin]
48+
D[SaaS Provider Origin]
3349
3450
A --> B
3551
B --> C
52+
C --> D
3653
```
54+
## Without O2O
3755

38-
## With O2O
39-
40-
If you have your own Cloudflare zone and your zone contains a **Proxied** DNS record matching the Custom Hostname with a **CNAME** target provided by the SaaS Provider, then O2O will be enabled.
56+
If you do not have your own Cloudflare zone and have only onboarded one or more of your hostnames to a SaaS Provider, then O2O will not be enabled.
4157

42-
With O2O enabled, the settings configured in your Cloudflare zone will be applied to the traffic first, and then the settings configured in the SaaS Provider's zone will be applied to the traffic second.
58+
Without O2O enabled, the settings configured in the SaaS Provider's zone will be applied to the traffic.
4359

4460
```mermaid
4561
flowchart TD
46-
accTitle: O2O-enabled traffic flow diagram
62+
accTitle: Your zone using a SaaS provider, but without O2O
4763
4864
A[Website visitor]
4965
5066
subgraph Cloudflare
51-
B[Customer-owned zone]
52-
C[SaaS Provider-owned zone]
67+
B[SaaS Provider-owned zone]
5368
end
5469
55-
D[SaaS Provider Origin]
70+
C[SaaS Provider Origin]
5671
5772
A --> B
5873
B --> C
59-
C --> D
6074
```

src/content/docs/cloudflare-for-platforms/cloudflare-for-saas/saas-customers/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ import { DirectoryListing } from "~/components"
1313

1414
Cloudflare partners with many [SaaS providers](/cloudflare-for-platforms/cloudflare-for-saas/saas-customers/provider-guides/) to extend our performance and security benefits to your website.
1515

16-
Cloudflare customers can take this process a step further by managing their own zone on Cloudflare. This setup - known as **Orange-to-Orange (O2O)** - allows them to benefit from their provider's setup but still customize how Cloudflare treats incoming traffic to their zone.
16+
If you are a SaaS customer, you can take this process a step further by managing your own zone on Cloudflare. This setup - known as **Orange-to-Orange (O2O)** - allows you to benefit from your provider's setup but still customize how Cloudflare treats incoming traffic to your zone.
1717

1818
## Related resources
1919

src/content/docs/cloudflare-for-platforms/cloudflare-for-saas/start/getting-started.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ The `CNAME` target — optional, but highly encouraged — provides a friendly a
3232

3333
<Example>
3434

35-
| **Type** | **Name** | **IPv4 address** | **Proxy status** |
35+
| **Type** | **Name** | **Target** | **Proxy status** |
3636
| -------- | ------------ | --------------------------------- | ---------------- |
3737
| `CNAME` | `.customers` | `proxy-fallback.saasprovider.com` | Proxied |
3838

@@ -53,21 +53,21 @@ To finish the custom hostname setup, your customer needs to set up a `CNAME` rec
5353
Your customer's `CNAME` record might look like the following:
5454

5555
```txt
56-
www.mystore.com CNAME customers.saasprovider.com
56+
mystore.example.com CNAME customers.saasprovider.com
5757
```
5858

5959
This record would route traffic in the following way:
6060

6161
```mermaid
6262
flowchart TD
6363
accTitle: How traffic routing works with a CNAME target
64-
A[Request to <code>www.mystore.com</code>] --> B[<code>customers.saasprovider.com</code>]
64+
A[Request to <code>mystore.example.com</code>] --> B[<code>customers.saasprovider.com</code>]
6565
B --> C[<code>proxy-fallback.saasprovider.com</code>]
6666
```
6767

6868
<br/>
6969

70-
Requests to `www.mystore.com` would go to your `CNAME` target (`customers.saasprovider.com`), which would then route to your fallback origin (`proxy-fallback.saasprovider.com`).
70+
Requests to `mystore.example.com` would go to your `CNAME` target (`customers.saasprovider.com`), which would then route to your fallback origin (`proxy-fallback.saasprovider.com`).
7171

7272
[^1]: <Render file="regional-services" />
7373

src/content/partials/cloudflare-for-platforms/get-started-per-hostname.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ import { Render, TabItem, Tabs } from "~/components"
77

88
You need to perform the following steps for each custom hostname.
99

10-
### Step 1 — Plan for validation
10+
### 1. Plan for validation
1111

1212
Before you create a hostname, you need to plan for:
1313

@@ -24,7 +24,7 @@ Depending on which method you select for each of these options, additional steps
2424

2525
:::
2626

27-
### Step 2 — Create custom hostname
27+
### 2. Create custom hostname
2828

2929
After planning for certification and hostname validation, you can create the custom hostname.
3030

0 commit comments

Comments
 (0)