Support Center

How to register (join) a sensor to Pulse

Last Updated: Oct 16, 2019 12:57PM EDT
IMPORTANT: Before registering a sensor to Pulse, please ensure the sensor is up-to-date and running the latest Pwnix Release available. For information on how to update the sensor please refer to the support article, the user Manual or contact support@pwnieexpress.com

It is also required to know the Fully Qualified Domain Name (FQDN) i.e. "widgets.pwnieexpress.net", or "f4k2ae79.pwnieexpress.net", etc. of the Pulse environment provisioned for use. If you do not know the FQDN please contact support@pwnieexpress.com.


How to Register (Join) a Sensor to Pulse 

Registering a sensor to Pulse is a simple, two-step process. The first step is performed from the sensor itself, using the sensor's web-based UI or via SSH. The second step is performed from within Pulse, whereupon the sensor being registered must be approved.

First Step
  1. From the network the sensor will be discovering assets and reporting upon to Pulse, log in to the sensor using its web-based UI at https://x.x.x.x:1443 (whereas x.x.x.x is the IP address assigned to the sensor).
  2. After login, from the "Overview" page, click "Pulse" on the left side of the UI.
  3. If the sensor has yet to be registered, three fields will be visible. If the sensor has already been registered, a blue button offering to "Deregister Sensor" will be provided and there is no need to proceed any further.
    • In the “Pulse Hostname” field, type the FQDN for the Pulse environment the sensor is to be registered with, i.e."widgets.pwnieexpress.net" or "f4k2ae79.pwnieexpress.net".
    • In the “Sensor Name” field, type the name, i.e. "Berlin – Branch Office" to represent the sensor. It is encouraged the name of the sensor is indicative of the geographic location or branch office where the sensor is physically located.
    • Optionally, in the "Contact” field, type the name of an individual who would be responsible for the administration of the sensor.
  4. After the required information has been provided, click the “Connect to Pulse” button once to join the sensor to Pulse.
  5. This completes the first step.
Second Step
  1. Using a web browser (Google Chrome is recommended) login to Pulse using the same FQDN, i.e. "https://widgets.pwnieexpress.net", "https://f4k2ae79.pwnieexpress.net", etc. the sensor was registered to/with.
  2. Next, click "Tools" i.e. the “wrench” icon at the top and select "Unapproved sensors" from the drop-down menu.
  3. All sensors registered, but awaiting approval will be displayed.
  4. When the sensor appears on the list, click the “Approve” button once to complete the process of joining the sensor to Pwn Pulse.
  5. This completes the second step.
After the sensor has been approved, go to the Sensors page and wait approximately 3-5 minutes, refreshing the page periodically for the sensor to become "online". After the sensor is online, select the sensor, then select Services. On the Services page, enable the discovery related services desired.

For reference the PwnScan Automated Scanner service performs the continuous discovery of assets on the network, i.e. anything with an IP address. The Realtime Wireless Discovery service performs the continuous discovery of wireless assets and the Blue Hydra Bluetooth Scanner service performs the continuous discovery of Bluetooth assets.

After enabling one or more of the discovery related services, please be aware it may take as long as an hour before assets become reflected within the Pulse UI under the Assets page.

Additional Notes:
In the first step, as an alternative to using the web-based UI to register a sensor to Pulse, it is possible to register a sensor to Pulse using SSH by performing the following:
  1. Establish either an SSH connection or a reverse SSH connection to the sensor and login with the "pwnie" user account.
  2. Type sudo su and press Enter, then re-type the password to become superuser.
  3. Next, type px-register-dispatch --hostname widgets.pwnieexpress.net --sensorname "<Sensor Name>" and press Enter, replacing widgets.pwnieexpress.net with the FQDN for the Pulse environment, and the <Sensor Name> with the name of the sensor desired.
  4. After being returned to the "#" prompt, login to Pulse to approve the sensor.

Contact Us

support@pwnieexpress.com
http://assets0.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete