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

In this topic, you will learn how to onboard using Portnox™ AgentP, a Windows 10 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. Scroll down to Windows files and click on the tile that best represents your Windows version to download the AgentP installer. Then, run the downloaded installer.

  3. In the first step of the Portnox AgentP Setup wizard, click on the Next button.

  4. In the next step of the Portnox AgentP Setup wizard, read the license agreement, activate the I accept the terms in the License Agreement checkbox, and click on the Next button.

  5. In the next step of the Portnox AgentP Setup wizard, select the installation location on your disk by clicking on the Change button if needed, and then click on the Next button.

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

  7. In the last step of the Portnox AgentP Setup wizard, click on the Finish 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 Start menu.

  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 Azure (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: 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.

Result: Your device is registered and AgentP is running.

Connect to the network using AgentP

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

  1. If AgentP is not running, start it from the Start menu.

  2. Click on the About tab and scroll down to see the Networks section.

  3. Click on the name of the network to connect to it.
  4. Optional: If your group is configured for credential-based authentication, Windows shows the Sign in window. 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 Sign in window is not displayed because it is not necessary.

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