Skip to content

Commit e2db796

Browse files
Updates based on suggestions - part 1
1 parent e562c19 commit e2db796

File tree

2 files changed

+62
-34
lines changed

2 files changed

+62
-34
lines changed

src/content/docs/cloudflare-one/team-and-resources/devices/agentless/pac-files/configure-pac-files.mdx

Lines changed: 59 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,9 @@ Install a [Cloudflare certificate](/cloudflare-one/team-and-resources/devices/us
2929

3030
## 1. Generate a proxy endpoint
3131

32-
You can generate a proxy endpoint in Cloudflare One or through the Cloudflare API.
32+
You can generate two types of proxy endpoint in Cloudflare One or through the Cloudflare API: IP and Authorization.
33+
34+
Authorization endpoints require users to pass [Access policies](/cloudflare-one/access-controls/policies/policy-management/) to use the endpoint. Source IP endpoints only proxy traffic originating from a specific source IP.
3335

3436
:::caution
3537
All devices you add to the proxy endpoint will be able to access your Cloudflare Tunnel applications and services. If you only want to proxy web traffic, you can build a network policy that blocks those source IPs from connecting to your internal resources.
@@ -43,36 +45,67 @@ All devices you add to the proxy endpoint will be able to access your Cloudflare
4345

4446
2. Select **Create proxy endpoint**.
4547

46-
3. Give your endpoint any name.
48+
3. Select between **Add an authorization endpoint** or **Add a source IP endpoint**.
49+
50+
:::note
51+
Once you choose a type of proxy endpoint, you cannot revert this decision.
52+
:::
53+
54+
## Authorization endpoint
55+
56+
If you select **Add an authorization endpoint**:
57+
58+
1. Enter your basic information.
59+
60+
2. Add an existing policy, or [create a new policy](/cloudflare-one/access-controls/policies/).
61+
62+
3. Add your login method.
63+
64+
4. Once you filled all the information, select **Save**.
65+
66+
### Edit authorization
67+
68+
To edit an authorization endpoint:
69+
70+
1. In [Cloudflare One](https://one.dash.cloudflare.com/), go to **Networks** > **Resolvers & Proxies** > **Proxy endpoints**.
71+
2. Select **Proxy endpoints**, and locate your authorization endpoint. The dashboard will display **Authorization** under **Type**.
72+
3. Select the three dots, then select **Configure**.
73+
4. Choose the information you want to edit:
74+
- **Basic info**: Enter your basic info, then select **Save**.
75+
- **Access policies**: Here, you can:
76+
- Select existing policies or create a new policy.
77+
- Select the three dots that allow you to
78+
- **Login methods**: Select the [identity providers](/cloudflare-one/integrations/identity-providers/) you want to use to log in to this application.
4779

48-
4. Enter the public source IP address of your device(s) in CIDR notation. For example:
80+
## Source IP endpoint
81+
82+
If you select **Add a source IP endpoint**:
83+
84+
1. Enter the public source IP address of your device(s) in CIDR notation. For example:
4985
- **IPv4**: `192.0.2.0/8`
5086
- **IPv6**: `2001:0db8:0000:0000:0000:1234:5678:0000/109`
5187

5288
:::note
5389
Gateway limits the prefix length of source networks for proxy endpoints to `/8` for IPv4 networks and `/32` for IPv6 networks.
5490
:::
5591

56-
5. Select **Save endpoint** and confirm the endpoint creation.
92+
2. Select **Save endpoint** and confirm the endpoint creation.
5793

5894
Your Cloudflare proxy server domain is of the form:
5995

6096
```txt
6197
https://<SUBDOMAIN>.proxy.cloudflare-gateway.com
6298
```
6399

64-
Once you create an endpoint, the dashboard will display an option to add additional endpoints:
65-
66-
1. Go to **Networks** > **Resolves & Proxies** > **Proxy endpoints**.
67-
2. Select **Add an endpoint**.
68-
3. Select the type of proxy endpoint you want to create. Choose between **Authorization** for an authorization endpoint, or **Source IP address**.
100+
### Edit source IP endpoint
69101

70-
If you select **Authorization**:
102+
To edit a source IP endpoint:
71103

72-
1. Enter your basic information.
73-
2. Add an existing policy, or [create a new policy](/cloudflare-one/access-controls/policies/).
74-
3. Add your login method.
75-
4. Once you filled all the information, select **Save**.
104+
1. In [Cloudflare One](https://one.dash.cloudflare.com/), go to **Networks** > **Resolvers & Proxies** > **Proxy endpoints**.
105+
2. Select **Proxy endpoints**, and locate your authorization endpoint. The dashboard will display **Source IP** under **Type**.
106+
3. Select the three dots, then select **Configure**.
107+
4. Edit the name and/or configure the source IPs that are allowed.
108+
5. Select **Save**.
76109

77110
</TabItem>
78111

@@ -127,18 +160,6 @@ If you select **Authorization**:
127160

128161
</Tabs>
129162

130-
### Edit an existing proxy endpoint
131-
132-
To edit an existing proxy endpoint:
133-
134-
1. In [Cloudflare One](https://one.dash.cloudflare.com/), go to **Networks** > **Resolvers & Proxies** > **Proxy endpoints**.
135-
2. Select **Proxy endpoints**, then select the three dots.
136-
3. Select **Configure**, and choose the information you want to edit:
137-
- **Basic info**: Enter your basic info, then select **Save**.
138-
- **Access policies**: Here, you can:
139-
- Select existing policies or create a new policy.
140-
- Select the three dots that allow you to
141-
- **Login methods**:
142163

143164
## 2. Test your proxy server
144165

@@ -190,20 +211,25 @@ function FindProxyForURL(url, host) {
190211
- Use a proper text editor such as VS Code to avoid added characters.
191212
:::
192213

193-
### Add additional PAC files
194-
195-
To add additional PAC files:
214+
To create a PAC file:
196215

197-
1. Go to **Networks** > **Resolves & Proxies** > **Proxy endpoints**.
198-
2. Select **Add PAC files**.
199-
3. Here, you can add **PAC file details** and **Setup instructions**.
200-
In **PAC files details:**
216+
1. In [Cloudflare One](https://one.dash.cloudflare.com/), go to **Networks** > **Resolvers & Proxies** > **Proxy endpoints**.
217+
2. Create a proxy endpoint.
218+
3. Once you create a proxy endpoint, select **Add PAC files**.
219+
4. Here, you can add **PAC file details** and **Setup instructions**.
220+
In **PAC files details**:
201221
- Enter the **Basic Information**.
202222
- Enter the **PAC file configuration** > Select **Browse PAC file configuration templates** and choose a pre-configured template to customize. The only available outputs are Okta and Azure. Once you select the template, the **PAC file JavaScript** is going to be populated with a template.
203223
In **Setup instructions:**
204224
- Choose a browser and follow the instructions.
205225
4. Select **Create**.
206226

227+
Your PAC file is of the form:
228+
229+
```txt
230+
https://<SUBDOMAIN>/test/test
231+
```
232+
207233
### Edit your PAC files
208234

209235
To edit your PAC files:

src/content/docs/cloudflare-one/team-and-resources/devices/agentless/pac-files/limitations.mdx

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,12 @@ sidebar:
77

88
## Traffic limitations
99

10-
The agentless HTTP proxy does not support [identity-based policies](/cloudflare-one/traffic-policies/identity-selectors/) or mTLS authentication.
10+
IP endpoints do not support [identity-based policies](/cloudflare-one/traffic-policies/identity-selectors/) or mTLS authentication.
1111

1212
To enforce HTTP policies for UDP traffic, you must turn on the [Gateway proxy for UDP](/cloudflare-one/traffic-policies/http-policies/http3/#enable-http3-inspection).
1313

14+
Authorization endpoints, do not support anything that is not HTTP/HTTPS. That means no other TCP or UDP protocol is supported, including HTTP3.
15+
1416
## Gateway DNS and resolver policies
1517

1618
Gateway DNS and resolver policies will always apply to traffic proxied via PAC files, regardless of device configuration.

0 commit comments

Comments
 (0)