Using the MAC Registration Lists Area of the UI

The MAC Registration Lists area of the UI lets you create MAC registrations, and import MAC registration lists or individual MAC addresses into these configurations for use in a workflow.

Navigate to Configuration > MAC Registration Lists. From here, you can add new MAC registration lists, view current lists, and click the wrench icon next to any list to perform actions on that list. The following screen is an example of the MAC Registrations List main screen where one list called "MAC Registrations" already exists and is in use in a workflow (see the Status column).

MAC Registrations Lists Main Screen

Parent topic: Cloudpath Configuration

Adding a New MAC Registration Configuration

Follow these steps to create a new MAC Registration configuration which you can then use to import MAC addresses.

  1. Click Add MAC Registration List in the upper right of the screen shown above.
  2. In the Create MAC Registrations screen (see the example screen below), configure the values (described after the example screen), then click Save.

    Creating a New MAC Registration Configuration

    • Display Name: Any descriptive name you want.
    • Description: Optional description of this particular MAC registration configuration.
    • SSID Regex: SSID to which MAC registered devices are assigned.
      Note: This field is case sensitive. Separate multiple SSIDs by a vertical pipe (|). The default (*) is any SSID that is pointed at the RADIUS server.
    • Expiration Date Basis: The basis for calculating the default validity period for MAC registration.
      Note: A sponsor can override the validity period configured for MAC registration. Cloudpath Enrollment System Sponsored Guest Access Configuration Guide, located on the Support tab, for details.
    • Offset: The number of hours/days/months/etc to be offset from the event date when calculating the registration validity period. If Specified Date is selected, this should be the date in YYYY/MM/DD format.
      Note: This field may be unnecessary and therefore disappear, depending on your selection for Expiration Date Basis.
    • Behavior: Specifies the prompt and redirect settings for the MAC registration configuration. Use the Web Page Information section to configure the user prompt or redirect URL. Behavior settings include:
      • Prompt user when MAC is unknown.
      • Always prompt the user.
      • Redirect when MAC is unknown.
      • Always redirect to authenticate user. (This is the default and the most commonly used setting).
      • Skip registration when MAC is unknown.
    • Use the Config Shortcuts buttons to populate the Redirect URL and POST Parameters according to your controller vendor and preferred protocol.
    • Allow Continuation - If checked, the submit-redirect call is processed, if unchecked, the submit- redirect call is ignored.
    • Kill Session - If checked, the user's session will be killed as they are redirected and, if they return, they will be forced to start over.
    • Authentication Attributes: Refer to Adding RADIUS Attributes
  3. After you click Save, you are returned to the Details tab of the MAC Registration List screen for the list you just configured, as shown in the following example screen:

    Details Tab for Newly Added Mac Registration List

  4. If you click View All MAC Registration Lists, you are returned to the main screen, with the new configuration (MAC Registration-8 in this example) appearing in the list, as shown below:

    MAC Registration Lists Screen After Adding a Second Registration Configuration

Importing a MAC Registration List

Follow these steps to import a MAC registration list into a MAC registration configuration.

  1. From the main MAC Registrations Lists screen, click the wrench icon for the list in which you want to import a MAC address list.
  2. On the ensuing screen, click the MAC Registrations tab. A screen such as the following is invoked:

    MAC Registrations Tab of a MAC Registration List

  3. If you first need a template for adding MAC addresses to an .xls file, click Download Bulk Import Template.
  4. Once you are ready to import the list of MAC addresses to the MAC registration list, click Import.
    Note: If importing from a .csv file, the following date formats are supported: yyyyMMdd, HHmmss, yyyyMMdd HHmm, yyyyMMdd, MM/dd/yyyy HHmmss, MM/dd/yyyy HHmm, MM/dd/yyyy, yyyy-MM-dd HH:mm:ss, yyyy-MM-dd.
  5. Browse to select your MAC address list, then click Continue.
  6. A popup message appears, where you click Continue Import:

    Popup Asking You to Confirm Import of MAC Address List File

  7. The file is imported and the MAC addresses are added to the applicable MAC Registration list.

Importing Individual MAC Addresses

Follow these steps to import individual MAC addresses into a MAC registration configuration.

  1. From the MAC Registrations tab of the desired MAC Registrations List (refer to the example in MAC Registrations Tab of a MAC Registration List), click the Add button in the "MAC Registrations" portion of the screen.
  2. In the popup window, enter the MAC addresses, separated by commas, that you wish to add.
  3. Click Save.
  4. Confirm the import on the ensuing popup window.
    You are returned to the MAC Registrations tab, and there should be a confirmation message at the top, indicating that the MAC addresses have been successfully added. They will also appear at the bottom of that screen.

Removing a MAC Registration Configuration List or Its MAC Addresses

Follow these steps to either remove the MAC addresses from a MAC registration configuration list or to remove both the MAC addresses and the list itself:

  1. Click the Details tab from an open MAC Registration List screen.
  2. Click Edit.
  3. Scroll to the bottom of the screen until you get to the Cleanup area, and click Cleanup to display the options:

    Cleanup Options for MAC Registration Configuration List

    Note: You cannot destroy the entire list if it is currently part of a workflow.
  4. Click on the desired option.
    A Warning popup appears.
  5. If you wish to continue, be sure to check the box to indicate that you "understand the warning," then click Continue.
    You are returned to the Details tab, where you should see a message indicating that your action has taken effect.