Onboard Windows PCs with AirEnroll for Windows
AirEnroll for Windows is a small Airowire program that does the whole BYOD
Wi-Fi setup on a personal Windows 10 or 11 PC in one go. The user signs in on
the BYOD portal, downloads AirEnroll-<code>.exe and runs it. AirEnroll
installs the certificates and an EAP-TLS Wi-Fi profile and connects. It needs
no administrator rights and no MDM.
Before you begin
Section titled “Before you begin”- A BYOD portal with Windows ticked under Devices & Wi-Fi › Platforms (BYOD onboarding).
AirEnroll.exe(x64) present on the Airgate server inBYOD_APPS_DIR(by default/usr/share/airgate/byod-apps); optionallyAirEnroll-arm64.exefor Windows on ARM. WithoutAirEnroll.exethe portal offers only the manual zip.- The PC has a Wi-Fi adapter (WLAN AutoConfig running).
- The secure SSID uses WPA2-Enterprise, or WPA2/WPA3 transition mode (see limitations).
What the user does
Section titled “What the user does”- Join the onboarding SSID or open the portal address, and sign in.
- On Choose your device, keep the Windows tile and select Continue.
- On How do you want to set up?, select Use the AirEnroll app (Recommended).
- On Set up with AirEnroll:
- Download AirEnroll (or Windows on ARM? Download the ARM64 version).
- Run it: open the downloaded file. Keep its name as it is: it carries the one-time setup code.
- If Windows protected your PC (SmartScreen) appears, select More info, then Run anyway.
- AirEnroll asks:
AirEnroll will download your Wi-Fi settings from: nac.contoso.com … Continue?The user selects Yes only if this is the company portal. - Windows asks whether to install the organisation’s root certificate. The console window shows the thumbprint to compare. The user selects Yes.
- AirEnroll adds the network, moves it to the top of the Wi-Fi list and
connects. It shows
You are connected to Corp-WiFi., orCorp-WiFi is set up. Windows will connect automatically when the network is in range., and a link to the portal’s My devices page. - Back on the portal, select I have finished.
If AirEnroll asks for the setup link (for example the file was renamed or copied from a USB stick), the user copies the link shown on the portal under If AirEnroll asks for the setup link, copy this and paste it and pastes it. The setup link works once and for 10 minutes.
What AirEnroll does
Section titled “What AirEnroll does”| Step | What happens |
|---|---|
| Finding your setup link | Reads the code from its own file name and the portal address from the download’s “mark of the web” (Zone.Identifier), or uses --enroll <link>, or asks the user. Only https links are accepted. |
| Checking for a Wi-Fi adapter | Done before the single-use link is used. |
| Downloading your Wi-Fi settings | One request to the portal; only same-host https redirects are followed. |
| Installing certificates | The Airgate root goes to the user’s Trusted Root Certification Authorities (Windows asks), the intermediate to Intermediate Certification Authorities, and the device certificate to Personal with a non-exportable key in the Microsoft Software Key Storage Provider. |
| Adding the Wi-Fi network | A WPA2-Enterprise/AES profile with EAP-TLS, connect automatically. Server validation is on: the server name must be the portal’s RADIUS server name and the root must be the Airgate root, with no prompt. The client certificate is chosen by its issuer. An all-user profile is tried first, a per-user one when policy forbids it. |
| Connecting | Connects and waits up to 25 seconds. |
Log file: %LOCALAPPDATA%\AirEnroll\enroll.log. It never contains the
certificate, its password or the full setup code.
Manual setup (without the app)
Section titled “Manual setup (without the app)”Set up manually downloads a zip:
- Extract it (right-click › Extract All).
- Right-click
install.ps1› Run with PowerShell. - Answer Yes when Windows asks to install the certificate authority.
- Windows connects to
Corp-WiFi.
Command line (support)
Section titled “Command line (support)”AirEnroll.exe [--enroll <setup link>] [--no-pause]AirEnroll.exe --dry-run [--json <payload.json> | --enroll <setup link>]AirEnroll.exe --version--dry-run changes nothing: with --json it validates a saved payload and
prints the Wi-Fi profile XML; otherwise it prints the setup link it would use.
SmartScreen and code signing
Section titled “SmartScreen and code signing”Until the AirEnroll binaries you ship are signed with an Authenticode code-signing certificate, SmartScreen warns about the download and users must select More info › Run anyway. Every download has a unique file name, so an unsigned program cannot build a SmartScreen reputation. Tell users in your rollout message, or ship signed binaries (an EV certificate or Azure Trusted Signing passes SmartScreen at once). Renaming a signed file does not break its signature, so the portal can still name each download individually.
Limitations
Section titled “Limitations”- WPA2-Enterprise profile. It also connects to WPA2/WPA3 transition-mode SSIDs. A WPA3-Enterprise-only SSID needs a WPA3 profile, which AirEnroll does not create yet.
- Software key. The key is stored by the Microsoft Software Key Storage Provider, not in the TPM.
- Old certificates stay in the user’s Personal store; the issuer filter keeps the profile on Airgate certificates and Windows picks a valid one.
- The onboarding SSID stays saved. The new profile is moved to the top so Windows prefers it.
- The link is used early. If the user selects No on the root certificate prompt, the single-use link is already used; they download AirEnroll again.
Verify
Section titled “Verify”- On the PC:
netsh wlan show profileslistsCorp-WiFi;certmgr.msc› Personal › Certificates shows the device certificate issued by the Onboard CA. - In Airgate: BYOD › BYOD devices lists the PC with Platform Windows; Monitor › Sign-in log shows the EAP-TLS sign-in.
Troubleshooting
Section titled “Troubleshooting”| Message in AirEnroll | Cause | Fix |
|---|---|---|
This setup link has already been used. Go back to the portal, sign in again and download a new copy of AirEnroll. |
The single-use link was used (for example a second run). | Download AirEnroll again from the portal. |
This setup link is not valid or has expired. … |
More than 10 minutes passed, or the code is wrong. | As above. |
Windows did not record where this program was downloaded from (then asks for the link) |
The file was renamed, copied or unzipped. | Paste the setup link from the portal. |
This computer has no usable Wi-Fi adapter. |
No Wi-Fi adapter or WLAN AutoConfig stopped. | Enable Wi-Fi; the link is not used yet. |
The certificate authority was not trusted, so Wi-Fi was not set up. … |
The user selected No on the root prompt. | Download AirEnroll again and select Yes. |
The portal is busy. Wait a minute and run AirEnroll again. |
Rate limit on the portal. | Wait and retry. |
Corp-WiFi is set up. Windows will connect automatically… but it never connects; Sign-in log: The device didn’t trust Airgate’s RADIUS certificate |
Server name mismatch. | Check the portal’s RADIUS server name. |
| No Use the AirEnroll app option on the portal | AirEnroll.exe missing in BYOD_APPS_DIR. |
Install it on the server, or use the zip. |
Related
Section titled “Related”- BYOD onboarding
- AirEnroll for Android
- Manage BYOD devices
- Windows SCEP (PCs managed by Intune)