Onboard Android devices with the AirEnroll app
Since Android 11, web pages and downloaded files can no longer add an enterprise (EAP-TLS) Wi-Fi network by themselves. AirEnroll is a small Airowire app that finishes BYOD onboarding on Android: the user taps one button on the portal, and the app installs the certificate and the Wi-Fi settings. The user never types a CA, a domain or an identity.
Before you begin
Section titled “Before you begin”- A BYOD portal with Android ticked under Devices & Wi-Fi › Platforms (BYOD onboarding).
- The app file
airenroll.apkpresent on the Airgate server (inBYOD_APPS_DIR, by default/usr/share/airgate/byod-apps). Without it, the portal offers only manual setup for Android. - Android 10 or later.
- Users may need to allow installs from their browser (Install unknown apps) because the app is downloaded from the portal.
What the user does
Section titled “What the user does”- Join the onboarding SSID (for example
Corp-Onboard) or open the portal address in the browser. - Sign in (Sign in with Microsoft, or user name and password).
- On Choose your device, keep the Android tile and select Continue.
- On How do you want to set up?, select Use the AirEnroll app (Recommended).
- On Set up with AirEnroll:
- Get AirEnroll: downloads the app. Allow installs from the browser when Android asks, then install it. Skip this if the app is already installed.
- Open AirEnroll. If the button does nothing, use Button not working? Tap here instead.
- AirEnroll asks Set up Wi-Fi from nac.contoso.com? The user checks that this is the company portal and taps Continue.
- Ready to set up shows the Portal, Organisation, Account, Network, Server and Certificate valid until. The user taps Set up Wi-Fi.
- Android confirms:
- Android 11 and later: the system sheet asks to save the network; the user taps Save. This stores a normal saved network that stays even if the app is removed.
- Android 10, or when the sheet is not available: Android asks Allow suggested Wi-Fi networks? (often as a notification); the user taps Allow. Suggested networks are removed if the app is uninstalled.
- All set · Connected to Corp-WiFi shows the certificate expiry and a Manage my devices link to the portal.
The setup link behind Open AirEnroll works once and for 10 minutes.
What the app configures
Section titled “What the app configures”| Setting | Value |
|---|---|
| Security | WPA2-Enterprise, EAP method TLS (no phase 2) |
| Identity | the identity Airgate assigns to the device |
| CA certificate | the Airgate root CA |
| Domain (server name check) | the portal’s RADIUS server name, for example radius.contoso.com |
| Client certificate | the device’s personal certificate and key, with the intermediate CA |
Android’s Wi-Fi configuration keeps the key and certificates. The app itself keeps only a small, non-secret record for its home screen (SSID, owner, expiry, the Manage my devices address and the portal host), excluded from backups. It never logs the certificate or its password.
How the app protects the user
Section titled “How the app protects the user”- It accepts only
httpssetup links with a host name, and shows the host before fetching anything. - It makes a single request to that host, follows no redirects, and checks that the CA it receives matches the fingerprint the portal sent.
Manual setup (without the app)
Section titled “Manual setup (without the app)”On How do you want to set up?, Set up manually downloads a certificate file and shows the steps:
- Open the file. If it does not open: Settings › Security › More security settings › Encryption & credentials › Install a certificate › Wi-Fi certificate.
- Enter the certificate password shown on the page and keep the suggested name.
- In Wi-Fi settings, choose
Corp-WiFiand enter: EAP method TLS, CA certificate the installed one (or Use system certificates), Domainradius.contoso.com, User certificate the installed one, Identity as shown. - Tap Connect. If the device asks for the CA separately, use Download the CA certificate on the page.
Menu names differ between Android makers; the app avoids these steps.
Distributing the app
Section titled “Distributing the app”- From the portal (default): the portal serves
airenroll.apkfromBYOD_APPS_DIR. Aairenroll.apk.sha256file next to it lets IT check the download. - Managed Google Play / Play Store: when the app is available there, the portal’s fallback link (Button not working?) opens the store listing when the app is missing.
- Package name:
com.airowire.airenroll.
Verify
Section titled “Verify”- On the phone: Settings › Network & internet › Internet (or Wi-Fi) lists
Corp-WiFias saved and connected. - In Airgate: BYOD › BYOD devices lists the device with Platform Android; Monitor › Sign-in log shows the EAP-TLS sign-in.
Troubleshooting
Section titled “Troubleshooting”| Message in AirEnroll | Cause | Fix |
|---|---|---|
This link was already used — go back to the portal and tap Open again. |
The single-use link was used. | On the portal, go back and tap Open AirEnroll again (sign in again if needed). |
This link is not valid or has expired — go back to the portal and tap Open again. |
More than 10 minutes passed. | As above. |
You are not signed in on the portal any more — sign in again and tap Open again. |
The portal session ended. | Sign in again. |
The portal is having a problem (error 5xx). Try again in a few minutes. |
Server error. | Retry; check Monitor › Logs. |
The device certificate from the portal could not be opened. Go back to the portal and tap Open again. |
The phone cannot read the certificate package. | Retry; if it repeats, use manual setup and contact Airowire support. |
Network not saved |
The user did not tap Save. | Tap Try again, then Save, or Use alternative method. |
This portal needs a newer version of AirEnroll. Update the app and try again. |
The app is older than the portal. | Install the current app from the portal. |
| Phone saved the network but does not connect; Sign-in log: The device didn’t trust Airgate’s RADIUS certificate | The RADIUS server name does not match. | Check the portal’s RADIUS server name; onboard again. |
| No Use the AirEnroll app option on the portal | airenroll.apk missing in BYOD_APPS_DIR. |
Install the app file on the server, or use manual setup. |