Some devices can be configured for wireless network connectivity, though the methods available for doing so vary by model.
When adding a wireless interface, you will need to know the SSID, the security type, and the pass phrase for the wifi network you want to connect to.

Web admin

  1. Complete device setup.
  2. Log in to Web Admin.
  3. Click Network Configuration.
  4. Click Add Wi-fi Interface.
  5. Make your changes.
  6. Restart networking.
  7. Check the interface status.
    • The Web Admin home page shows the status of the wireless interface; there are three possible states: connected, configured but not connected, not configured. The wireless LED, if present, indicates the same three states.
  8. Verify that the interface acquired an IP address.
    1. In APM, navigate to > Manage Monitoring Points.
    2. Select the monitoring point you are interested in.
    3. On the right side panel, check Local Network Interfaces for an IP address on the interface.

Web admin

  1. Complete device setup.
  2. Log in to Web Admin.
  3. Navigate to Network Settings > Network Interfaces.
  4. Click Add Interface and select Wireless.
  5. Click the wireless network you want to connect to.
    • Wait for the configuration page to appear.
  6. Make your changes.
  7. Restart networking.
  8. Check the interface status.
    1. Navigate to Home.
    2. In the Network State section, check the Status for the interface.
      • It should be Up.
  9. Verify that the interface acquired an IP address.
    1. In APM, navigate to > Manage Monitoring Points.
    2. Select the monitoring point you are interested in.
    3. On the right side panel, check Local Network Interfaces for an IP address on the interface.

Admin API

  1. Complete device setup.
  2. Discover the device hostname at > Manage Monitoring Points.
  3. Find out what interfaces are already configured:
    1. Plug the device hostname into this url.
    2. Under the interface resource open GET /interface/ and click Submit.
    3. If you see the wireless interface ‘wlan0’ in the returned list of interfaces, the wireless interface is already configured and you don’t need to go any further.
  4. If you are connecting to an access point that uses WPA2 Enterprise authentication, you might need to upload a CA certificate, client certificate, and/or a client private key before configuring the interface.
    1. Open POST /interface/file/ to upload these files. It also contains a description of the supported formats.
  5. Open POST /interface/ to configure the wireless interface.
  6. Sub in your wireless SSID, key/password, and certificate file names into one of these JSON objects: WEP, WPA-PSK, WPA2 Enterprise (PEAP), WPA2 Enterprise (TLS)
  7. Paste it into the white box.
  8. Click Submit.
  9. In the response, look for 'success': true, which lets you know that the interface was successfully created and configured.
  10. Restart the networking service in order to apply the changes.
    1. Under the service resource open PUT /service/{service_name}/.
    2. Set service_name to ‘networking’, action to ‘restart’, and then click Submit. You will briefly lose connectivity to the Admin API.
  11. Verify that your new interface exists by repeating Step 3.
  12. Verify that the interface acquired an IP address.
    1. In APM, navigate to > Manage Monitoring Points.
    2. Select the monitoring point you are interested in.
    3. On the right side panel, check Local Network Interfaces for an IP address on the interface.

curl

  1. Complete device setup.
  2. Discover the device hostname at > Manage Monitoring Points.
  3. Find out what interfaces are already configured.

    curl -X GET --header "Accept: application/json" "https://HOSTNAME/api/v1/interface/?config_state=active"
    
  4. If you are connecting to an access point that uses WPA2 Enterprise authentication, you might need to upload a CA certificate, client certificate, and/or a client private key before configuring the interface.

    curl -k -X POST --header 'Expect:' --header 'Content-Type: multipart/form-data' --header 'Accept: application/json' -F wpa_ca_cert=@FULL_PATH_TO_FILE -F wpa_client_cert=@FULL_PATH_TO_FILE -F wpa_private_key=@ FULL_PATH_TO_FILE https://admin:ADMINPASS@APPLIANCEIP/api/v1/interface/file/
    
  5. Create a file called wifi-config.json containing one of the objects from the Admin API section. Make sure you sub in your details.
  6. Add a new wireless interface.

    curl -k -X POST --header "Content-Type: application/json" --data-binary @wifi-config.json https://admin:ADMINPASS@HOSTNAME/api/v1/interface/
    
  7. Verify that your changes are pending.

    curl -k https://admin:ADMINPASS@HOSTNAME/api/v1/interface/?config_state=pending
    
  8. Restart networking. You will briefly lose connectivity to the Admin API.

    curl -k -X PUT --header "Content-Type: application/json" -d {} https://admin:ADMINPASS@HOSTNAME/api/v1/service/networking/action=restart
    
  9. Verify that your new interface exists by repeating Step 3.
  10. Verify that the interface acquired an IP address.
    1. In APM, navigate to > Manage Monitoring Points.
    2. Select the monitoring point you are interested in.
    3. On the right side panel, check Local Network Interfaces for an IP address on the interface.

USB

If you are connecting to an access point that uses WPA2 Enterprise authentication, you may need to upload a CA certificate, client certificate, and/or a client private key to the monitoring point before configuring the interface. Use curl or the Admin API to upload these files.

To add a wireless interface:

  1. Download the wireless interface config file.
  2. Edit the downloaded config file for your needs.
    • Uncomment sections to be used.
    • Replace content in arrow brackets.
  3. Copy the file onto a USB stick.
  4. Make sure the monitoring point is ready.
  5. Insert the USB stick into the monitoring point.
    • The monitoring point reads the configuration from the USB stick and indicates that it is doing so.
  6. Wait until the monitoring point is finished.
  7. Remove the USB stick.
    • The monitoring point configuration is updated.
    • Any problems updating the configuration are logged in the usb.log file on the USB stick.
  8. Verify that the interface acquired an IP address.
    1. In APM, navigate to > Manage Monitoring Points.
    2. Select the monitoring point you are interested in.
    3. On the right side panel, check Local Network Interfaces for an IP address on the interface.