Onboard iPhone, iPad and Mac with BYOD
Apple devices are onboarded with a configuration profile (.mobileconfig). It
contains the user’s personal certificate, the Airgate root CA and the Wi-Fi
settings for the secure SSID. No app is needed. This page describes each step
the user sees, so you can write your own instructions or help users on the
phone.
Before you begin
Section titled “Before you begin”- A BYOD portal with iPhone, iPad, Mac ticked under Devices & Wi-Fi › Platforms (BYOD onboarding).
- The user knows the portal address, or the onboarding SSID opens it.
What the profile contains
Section titled “What the profile contains”| Payload | Content |
|---|---|
| CA certificates | The Airgate root CA (and an intermediate when the chain has one), so the device trusts the RADIUS server certificate. |
Wi-Fi certificate (Wi-Fi certificate (<identity>)) |
The user’s personal certificate and key (PKCS#12). |
| Wi-Fi | SSID, WPA2-Enterprise with EAP-TLS (TLS 1.2 or later), Auto Join on, the trusted RADIUS server name (TLSTrustedServerNames). |
The profile is named <organization> Wi-Fi. It removes itself when the
certificate expires; the user then onboards the device again. It is signed when the Airgate
server has a profile-signing identity; otherwise the device shows it as Not
Verified, which is expected, and it still installs.
Steps for iPhone and iPad
Section titled “Steps for iPhone and iPad”- Join the onboarding SSID (for example
Corp-Onboard) or open the portal address. If the portal opens in the captive sign-in window, tap the option to open it in Safari: profiles install only from Safari. - Select Sign in with Microsoft (or enter the user name and password and select Sign in).
- On Choose your device, the iPhone, iPad, Mac tile is preselected. Optionally enter a Device name, then tap Continue.
- On Install on your iPhone, iPad or Mac, tap Download
-wifi.mobileconfig and Allow the download. The link works once and for 10 minutes. - Open Settings, tap Profile Downloaded near the top, then Install (top right). Enter the device passcode and confirm Install.
- Switch to the secure network: Settings › Wi-Fi, tap
Corp-WiFi. Apple devices stay on the setup network until the user switches.
Steps for Mac
Section titled “Steps for Mac”- Join
Corp-Onboardor open the portal address in a browser. - Sign in, keep the iPhone, iPad, Mac tile, and select Continue.
- Select Download
-wifi.mobileconfig . - Open System Settings › General › Device Management (on macOS 13: System Settings › Privacy & Security › Profiles). The downloaded profile waits there.
- Double-click the profile, select Install, and enter the Mac’s password when asked.
- Choose the secure network: click the Wi-Fi icon in the menu bar and select
Corp-WiFi. The Mac stays on the setup network until you switch.
The portal’s Done page shows Waiting for your device to join Corp-WiFi until Airgate sees the device connect, then You’re all set.
Private Wi-Fi address
Section titled “Private Wi-Fi address”Apple devices use a private Wi-Fi address per network by default. This does not
affect BYOD: Airgate recognizes the onboarded device by its certificate, not
by its MAC address, and marks the endpoint it sees with BYOD = true. The MAC
shown under BYOD › BYOD devices › MAC (last seen) is the private address of
the secure SSID.
Verify
Section titled “Verify”- On the iPhone or iPad: Settings › General › VPN & Device Management lists the profile. On the Mac: System Settings › General › Device Management (macOS 13: Privacy & Security › Profiles).
- In Airgate: BYOD › BYOD devices shows the device with Platform iPhone, iPad, Mac and Last connected.
- Monitor › Sign-in log shows the EAP-TLS sign-in that matched the BYOD rule.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Cause | Fix |
|---|---|---|
| Nothing happens after Download in the captive window | The captive sign-in window cannot install profiles. | Open the portal in Safari. |
| No Profile Downloaded in Settings | The download was blocked or the profile expired (a downloaded profile is removed after a few minutes if not installed). | Download again (sign in again if the link was used). |
| Mac: the profile is not in Device Management | The file was downloaded to another Mac or deleted. | Double-click the .mobileconfig in Downloads. |
| Profile shows Not Verified | The server has no profile-signing identity. | Expected; install anyway. |
The device does not join Corp-WiFi |
The user stayed on the setup network. | Choose Corp-WiFi manually. |
| Sign-in log: The device didn’t trust Airgate’s RADIUS certificate | The RADIUS server name in the profile does not match the server certificate. | Check the portal’s RADIUS server name and the EAP certificate; onboard again. |
This download link was already used or has expired. |
Each link works once and for 10 minutes. | Sign in again on the portal. |
Related
Section titled “Related”- BYOD onboarding
- Manage BYOD devices
- macOS SCEP (Macs managed by Intune)