Onboard an iPhone to a Wi-Fi network with AgentP

In this topic, you will learn how to onboard using Portnox™ AgentP, an iPhone with iOS, and a Wi-Fi network managed by Portnox™ Cloud.

Important: To onboard AgentP on iOS, your iOS device must use Safari as its default browser. If you changed your default browser to another browser such as Chrome, you must change it back to Safari to onboard AgentP. To learn how to change your default browser on iOS, follow this guide from Apple.

Download and install AgentP

In this section, you will download and install Portnox AgentP on your device.

  1. Open the Download Portnox AgentP page in your mobile browser.

    You can also find AgentP in the App Store manually by typing Portnox in the search box.

  2. Press the iOS tile to open the App Store page for Portnox AgentP. Then, press the cloud symbol to install AgentP.

Result: AgentP is installed.

Register your device using AgentP

In this section, you will use Portnox™ AgentP to register your device with Portnox™ Cloud.

  1. If AgentP is not running, start it from the Home screen.

  2. Press Corporate email or Corporate credentials. Select Corporate email if Portnox Cloud manages your user repository. Select Corporate credentials if you have integrated Portnox Cloud with an external repository. Proceed with the following steps depending on your choice.

  3. If you have chosen Corporate email:
    Important: Only choose the Corporate email option if Portnox Cloud manages your user repository. Cloud manages the user repository if it’s not integrated with any external repositories such as Microsoft Azure (Entra ID), Google Workspace, or Okta Workforce Identity.
    1. In the Email address field, enter your corporate email address and press Submit.

    2. In the “AgentP” Would Like to Send You Notifications pop-up, press Allow.

      You will see a confirmation that an email with an activation code has been sent.

    3. Open your email client and find the email received from Portnox Cloud containing an activation link and a one-time activation code. Press the link or copy the code to the clipboard.

    4. In AgentP, paste the code in the Activation code field and press Activate.

  4. If you have chosen Corporate credentials:
    1. Press the button that represents the authentication repository you want to use to sign in. If you want to enter credentials directly, enter them in the Login (domain\user) or UPN (email) and Password fields and press Activate.

      Note: Options depend on the repositories integrated with Portnox Cloud: Microsoft Azure (Entra ID), Google Workspace, and/or Okta Workforce Identity.
    2. Complete the steps needed to sign in. These steps depend on the chosen authentication repository.
  5. In the Allow “AgentP” to use your location? pop-up, press Allow While Using App.

Result: Your device is registered and AgentP is running.

Connect to the Wi-Fi network using AgentP

In this section, you will use Portnox™ AgentP to connect to the Wi-Fi network.

  1. If AgentP is not running, start it from the Home screen.

  2. Press  ≡  and then press Network.

  3. Press Configure to download the profile for this network and connect to it.

  4. In the pop-up that says The website is trying to download a configuration profile, press Allow.

  5. In the Profile Downloaded pop-up, press Close.

  6. Press the Home button and press the icon of the Settings app.

  7. In the Settings app, press the Profile Downloaded row.

  8. In the Install Profile pane, press Install.

  9. Enter your passcode.

  10. Press Install.

  11. Go back to the Settings app and press the Wi-Fi row to change the Wi-Fi settings.

  12. Press the configured Wi-Fi network in the MY NETWORKS section to connect.

Result: Your device is connected to the network managed by Portnox Cloud.