Skip to content

Commit 6265858

Browse files
committed
QR code enrollment
1 parent 913674a commit 6265858

File tree

1 file changed

+53
-2
lines changed

1 file changed

+53
-2
lines changed

src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx

Lines changed: 53 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,13 @@ If you plan to direct your users to manually download and configure the WARP cli
1515

1616
## Windows, macOS, and Linux
1717

18-
### Enroll via the GUI
18+
### Enroll using the GUI
1919

2020
<Render file="warp/enroll-desktop" />
2121

2222
The device is now protected by your organization's Zero Trust policies.
2323

24-
### Enroll via the CLI
24+
### Enroll using the CLI
2525

2626
To enroll your device using the terminal:
2727

@@ -74,10 +74,61 @@ The device is now protected by your organization's Zero Trust policies. For more
7474

7575
## iOS, Android, and ChromeOS
7676

77+
### Enroll manually
78+
7779
<Render file="warp/enroll-ios-android" />
7880

7981
The device is now protected by your organization's Zero Trust policies.
8082

83+
### Enroll using a QR code
84+
85+
<Details header="Feature availability">
86+
87+
| System | Availability | Minimum WARP version |
88+
| -------- | ------------ | -------------------- |
89+
| Windows || |
90+
| macOS || |
91+
| Linux || |
92+
| iOS || 1.5 |
93+
| Android || |
94+
| ChromeOS || |
95+
96+
</Details>
97+
98+
Administrators can provide users with a custom login link or QR code that automatically fills in your organization's <GlossaryTooltip term="team name">team name</GlossaryTooltip> during device enrollment. Using a QR code reduces the potential for error that comes with manual entry of the team name.
99+
100+
#### Generate a QR code
101+
102+
To generate a device enrollment QR code:
103+
104+
1. Copy the following link, replacing `your_team_name` with your Zero Trust <GlossaryTooltip term="team name">team name</GlossaryTooltip>:
105+
```txt
106+
cf1app://oneapp.cloudflare.com/team?name=your_team_name
107+
```
108+
2. Use any QR code generator to embed the link in a QR code.
109+
3. Distribute the QR code to users.
110+
111+
#### Use the QR code
112+
113+
To enroll a device using the QR code:
114+
115+
1. [Download](/cloudflare-one/connections/connect-devices/warp/download-warp/) and install the Cloudflare One Agent app.
116+
2. Scan the QR code provided by your administrator. Alternatively, go to the login link that is embedded in the QR code.
117+
118+
The Cloudflare One Agent app will open and start the onboarding flow.
119+
3. Review the privacy policy and select **Accept**.
120+
4. On the **Enter team name** screen, confirm that the pre-populated <GlossaryTooltip term="team name">team name</GlossaryTooltip> matches your organization.
121+
122+
:::note[`Already Authenticated` error]
123+
If Cloudflare One Agent is already logged in using another team name, you must first log out of that account. Go to **Settings** > **Account** to log out, and then retry the QR code or login link.
124+
:::
125+
6. Complete the authentication steps required by your organization.
126+
7. After authenticating, select **Install VPN Profile**.
127+
8. In the **Connection request** popup window, select **OK**.
128+
9. If you did not enable [auto-connect](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/#auto-connect), manually turn on the switch to **Connected**.
129+
130+
The device is now protected by your organization's Zero Trust policies.
131+
81132
## Virtual machines
82133

83134
By default, virtual machines (VMs) are subject to the WARP client settings of the host. If you want to deploy a separate instance of WARP in a VM, you must configure the VM to operate in bridged networking mode.

0 commit comments

Comments
 (0)