PINEAPPLE_DEVICE_FILTER_ADD - add a MAC address to a Pineapple device filter list

PINEAPPLE_DEVICE_FILTER_ADD_FILE - add a list of MAC addresses in a file to a Pineapple device filter list

PINEAPPLE_DEVICE_FILTER_DELETE - delete a MAC address from a Pineapple device filter list

PINEAPPLE_DEVICE_FILTER_CLEAR - clear a Pineapple device filter list

PINEAPPLE_DEVICE_FILTER_LIST - show a Pineapple device filter list

PINEAPPLE_DEVICE_FILTER_MODE - set the Pineapple device filter mode

When to use them

The Pineapple device filter system defines the scope of an engagement by controlling what devices are allowed to connect to a Pineapple access point.

The PINEAPPLE_DEVICE_FILTER_... commands provide a scriptable interface to manipulating the filter lists.

Syntax 

  PINEAPPLE_DEVICE_FILTER_ADD [list] [mac] {mac2 ... macN}

list (allow or deny)

Add one or more MAC addresses to the allow or deny device filter list

MAC address

MAC address to add to the filter list, in xx:xx:xx:xx:xx:xx format.

  PINEAPPLE_DEVICE_FILTER_ADD_FILE [list] [file]

list (allow or deny)

Add one or more MAC addresses to the allow or deny device filter list

file

File containing one or more MAC adresses, one MAC per line.

  PINEAPPLE_DEVICE_FILTER_DELETE [list] [mac] {mac2 ... macN}

list (allow or deny)

Delete one or more MAC addresses from the allow or deny filter list

MAC address

MAC address to delete from the filter list, in xx:xx:xx:xx:xx:xx format.

  PINEAPPLE_DEVICE_FILTER_CLEAR [list]

list (allow or deny)

Clear the specified device filter list (allow or deny list)

  PINEAPPLE_DEVICE_FILTER_LIST [list]

list (allow or deny)

Filter list to display the contents of (allow or deny)

  PINEAPPLE_DEVICE_FILTER_MODE [mode]

mode (allow or deny)

Set the operational mode of the device filter (allow or deny)

Results

Changes to the Pineapple device filter list are enacted immediately.

Examples 

  PINEAPPLE_MIMIC_DISABLE # disable openap mimic while we change lists
PINEAPPLE_DEVICE_FILTER_CLEAR allow
PINEAPPLE_DEVICE_FILTER_ADD allow 00:DE:AD:BE:EF:05
PINEAPPLE_DEVICE_FILTER_ADD allow 01:FE:ED:FA:CE:99
PINEAPPLE_DEVICE_FILTER_MODE allow
PINEAPPLE_MIMIC_ENABLE # re-enable mimic