Skip to content

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.

  • 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.
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.

  1. 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.
  2. Select Sign in with Microsoft (or enter the user name and password and select Sign in).
  3. On Choose your device, the iPhone, iPad, Mac tile is preselected. Optionally enter a Device name, then tap Continue.
  4. On Install on your iPhone, iPad or Mac, tap Download -wifi.mobileconfig and Allow the download. The link works once and for 10 minutes.
  5. Open Settings, tap Profile Downloaded near the top, then Install (top right). Enter the device passcode and confirm Install.
  6. Switch to the secure network: Settings › Wi-Fi, tap Corp-WiFi. Apple devices stay on the setup network until the user switches.
  1. Join Corp-Onboard or open the portal address in a browser.
  2. Sign in, keep the iPhone, iPad, Mac tile, and select Continue.
  3. Select Download -wifi.mobileconfig.
  4. Open System Settings › General › Device Management (on macOS 13: System Settings › Privacy & Security › Profiles). The downloaded profile waits there.
  5. Double-click the profile, select Install, and enter the Mac’s password when asked.
  6. 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.

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.

  • 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.
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.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security