Onboard a macOS device to a Wi-Fi or wired network with AgentP

In this topic, you will learn how to onboard using Portnox™ AgentP, a macOS computer, and a Wi-Fi or wired network managed by Portnox™ Cloud.

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 browser.
  2. Click on the tile that represents the macOS system to download the AgentP installer.

  3. Run the downloaded installer.
  4. In the first step of the Install Portnox AgentP wizard, click on the Continue button.

  5. In the next step of the Install Portnox AgentP wizard, click on the Install button.

  6. In the last step of the Install Portnox AgentP wizard, click on the Close button.

Result: AgentP is installed. The operating system will start AgentP immediately.

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

  2. Click on the Corporate email button or the Corporate credentials button.
    • Select the Corporate email option if Portnox Cloud manages your user repository.
    • Select the Corporate credentials option 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 Entra ID, Google Workspace, or Okta Workforce Identity.
    1. In the Email address field, enter your corporate email address and click on the Register button.

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

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

    3. In AgentP, paste the code in the empty field and click on the Activate button.

  4. If you have chosen Corporate credentials:
    1. Click on 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 click on the Register button.

      Note:
      Options depend on the repositories integrated with Portnox Cloud: 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. Install the Wi-Fi configuration profile.

    1. Open the macOS System Preferences application.

    2. In the System Preferences window, double click on the Profiles icon.

    3. In the Profiles window, click on the Install button.

    macOS configures the network settings for the networks configured in your Portnox Cloud group.

  6. In the status menu bar, click on the Wi-Fi icon to open the list of available Wi-Fi networks, and select the network configured in previous steps.

  7. Optional: If your group is configured for credential-based authentication, macOS shows a pop-up asking you to enter credentials. Enter your credentials, and click on the OK button.

    You can also enter your identity in the down-level logon name format: domain\user, for example, vorlon.com\kosh.

    If your group is configured for certificate-based authentication, the pop-up is not displayed because it is not necessary.

Result: Your device is registered and connected to the network managed by Portnox Cloud, and AgentP is running.