Admin Helper Tools

This page provides executables that use API calls to help MetaDefender NAC administrators with tasks that might otherwise be tedious.

Mass Reauthenticate

Description: Forces re-authentication for an all devices in a particular Policy Group.

Download Links:

CLI arguments:

  • -group : Name of Policy Group to re-authenticate. Must match exactly including capitalization and whitespace. If the group name includes spaces and you are providing the name via command-line argument, be sure to wrap the name in quotes. No quotes are needed when providing the group name interactively.
  • -dry-run : Show who would be forced to re-authenticate without actually doing it.
  • -reset-creds : Not only force re-authentication, but also forget currently authenticated username for each device.
  • -skip-cert-validation : Skip certificate validation when making API calls. Useful if you are using the -url argument with an IP address.
  • -url : Base URL to use in API calls. Defaults to "https://portal.myweblogon.com:8443".
  • -username : Admin username used to authenticate API calls. (Password will be prompted interactively.)

Additional Notes:

The program can be executed without any arguments by simply double-clicking it. In that case you will be prompted to enter group name and admin username interactively (password is always prompted interactively). The base URL will be the default, -dry-run will be false, and -reset-creds will be false.

The password will not be displayed as you type it. Don't worry, this is expected.

Troubleshooting Tips:

  • If the program reports zero clients in the given Policy Group, make sure you typed the group name correctly.
  • If you get an error involving "401", make sure the admin username and password you provided are correct.

Clear Enrollments

Description: Deletes all device enrollments from the NAC virtual appliance

Download Links:

CLI arguments:

  • -dry-run : Perform a dry run without deleting anything. Shows what would be cleared without actually removing the enrollment records.
  • -url : Base URL for the API calls. Defaults to "https://portal.myweblogon.com:8443".
  • -user : Username for authentication used in API calls. (Password will be prompted interactively.)

Additional Notes:

The program can be executed without any arguments by simply double-clicking it. In that case you will be prompted to enter the username interactively (password is always prompted interactively). The base URL will be the default and -dry-run will be false.

The password will not be displayed as you type it. Don't worry, this is expected.

Troubleshooting Tips:

  • If you get an error involving "401", make sure the username and password you provided are correct.
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard