How to enroll the agent, when faced with the error message "Agent is not enrolled"

  • Updated

 

This is a guide on how to enroll the agent when faced with the error "Agent is not enrolled" when running the doctor command.

 

Prerequisites

  • When troubleshooting the Vanta Agent, running the built-in troubleshooting tool called doctor returns the following error message:
    Running checkup: Check Vanta endpoint metadata
    ERROR: Agent is not enrolled.
    X Checkup failed. See above for what went wrong.
  • Your company's Vanta Key (Only Vanta admins and editors have access to this information within Vanta)

Procedure

  1. Verify you are getting the "Agent is not enrolled" error when running the inbuilt diagnostic tool, Doctor, in your machines command prompt/terminal.

    To run Doctor:

    • Mac -
      • Open terminal (easiest way is cmd + space bar & search for 'terminal')
      • Copy/Paste sudo /usr/local/vanta/vanta-cli doctor
      • Hit 'Return'. It may ask you for a password (use the password you have to download apps or to open your computer)

    • Windows
      • Search for cmd.exe in the search bar. Right-click and select “run as administrator.”
      • Type C:\PROGRA~1\Vanta\vanta-cli doctor and hit 'Return'

        Agent_not_enrolled_error_-_Windows_example.png

  2. Locate the company's Vanta Key, This can be provided to you by your admin.
    • Vanta Admin can locate the key within Vanta using the following steps: 
      • Navigate to the Computers Page
      • Click on the Unmonitored Tab
      • Click on View Setup Instructions
      • Click on Option 3: MDM and Vanta Agent
      • Look for the phrase VANTA_KEY

  3. Run the below command prompt in your terminal, replacing 'VANTA_KEY' with the key from the previous step, and 'YOUR_EMAIL' with the email for the device's primary user:

    • Mac -
      • Open terminal (easiest way is cmd + space bar & search for 'terminal')
      • Type sudo /usr/local/vanta/vanta-cli register --secret="VANTA_KEY" --email="YOUR_EMAIL"  and hit 'Return'. 
        • For example:
          sudo /usr/local/vanta/vanta-cli register --secret="1232131231asdasd" --email="abc@defg.com"

    • Windows - 
      • Search for cmd.exe in the search bar. Right-click and select “run as administrator.”
      • Type C:\PROGRA~1\Vanta\vanta-cli register --secret="VANTA_KEY" --email="YOUR_EMAIL" and hit 'Return'

        • For example:
          C:\PROGRA~1\Vanta\vanta-cli register --secret="1232131231asdasd" --email="abc@defg.com"