Skip to content

Commit c6378dc

Browse files
[Gateway] CONNECT proxy/PAC file identity
1 parent 9dabdcb commit c6378dc

File tree

4 files changed

+83
-15
lines changed

4 files changed

+83
-15
lines changed
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
pcx_content_type: how-to
3+
title: Best practices for writing PAC files
4+
sidebar:
5+
order: 4
6+
---

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

Lines changed: 52 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
pcx_content_type: how-to
3-
title: PAC files
3+
title: Configure PAC files
44
sidebar:
5-
order: 1
5+
order: 2
66
---
77

88
import {
@@ -61,6 +61,19 @@ Your Cloudflare proxy server domain is of the form:
6161
https://<SUBDOMAIN>.proxy.cloudflare-gateway.com
6262
```
6363

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**.
69+
70+
If you select **Authorization**:
71+
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**.
76+
6477
</TabItem>
6578

6679
<TabItem label="API">
@@ -114,6 +127,19 @@ https://<SUBDOMAIN>.proxy.cloudflare-gateway.com
114127

115128
</Tabs>
116129

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**:
142+
117143
## 2. Test your proxy server
118144

119145
1. In [Cloudflare One](https://one.dash.cloudflare.com/), create an [HTTP policy](/cloudflare-one/traffic-policies/http-policies/) for testing purposes. For example:
@@ -164,6 +190,29 @@ function FindProxyForURL(url, host) {
164190
- Use a proper text editor such as VS Code to avoid added characters.
165191
:::
166192

193+
## Add additional PAC files
194+
195+
To add additional PAC files:
196+
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:**
201+
- Enter the **Basic Information**.
202+
- 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.
203+
In **Setup instructions:**
204+
- Choose a browser and follow the instructions.
205+
4. Select **Create**.
206+
207+
### Edit your PAC files
208+
209+
To edit your PAC files:
210+
211+
1. In [Cloudflare One](https://one.dash.cloudflare.com/), go to **Networks** > **Resolvers & Proxies** > **Proxy endpoints** > **PAC files**.
212+
2. Locate the PAC file you want to edit, select the three dots, then select **Configure**.
213+
3. Edit **PAC files details** and/or **Setup instructions**.
214+
4. Select **Save**.
215+
167216
## 4. Configure your devices
168217

169218
All major browsers support PAC files. You can configure individual browsers, or you can configure system settings that apply to all browsers on the device. Multiple devices can call the same PAC file as long as their source IP addresses were included in the proxy endpoint configuration.
@@ -306,16 +355,4 @@ Using your proxy endpoint's domain, you can get the IP addresses assigned to the
306355

307356
</Tabs>
308357

309-
To ensure responses are allowed through your firewall, add an inbound rule to allow the static IPv4 address for Cloudflare proxy endpoints, `162.159.193.21`.
310-
311-
## Limitations
312-
313-
### Traffic limitations
314-
315-
The agentless HTTP proxy does not support [identity-based policies](/cloudflare-one/traffic-policies/identity-selectors/) or mTLS authentication.
316-
317-
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).
318-
319-
### Gateway DNS and resolver policies
320-
321-
Gateway DNS and resolver policies will always apply to traffic proxied via PAC files, regardless of device configuration.
358+
To ensure responses are allowed through your firewall, add an inbound rule to allow the static IPv4 address for Cloudflare proxy endpoints, `162.159.193.21`.
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
pcx_content_type: how-to
3+
title: PAC files
4+
sidebar:
5+
order: 1
6+
group:
7+
hideIndex: true
8+
---
9+
Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
pcx_content_type: how-to
3+
title: Limitations
4+
sidebar:
5+
order: 3
6+
---
7+
8+
## Traffic limitations
9+
10+
The agentless HTTP proxy does not support [identity-based policies](/cloudflare-one/traffic-policies/identity-selectors/) or mTLS authentication.
11+
12+
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).
13+
14+
## Gateway DNS and resolver policies
15+
16+
Gateway DNS and resolver policies will always apply to traffic proxied via PAC files, regardless of device configuration.

0 commit comments

Comments
 (0)