Skip to main content

Pulseway

Visualize Pulseway Account, Group, Host, HostAgent, Policy changes through queries and alerts.

Installation Guide

Overview​

Pulseway can be deployed either on-premise or in the cloud. If hosting your own server, you need to provide the Pulseway host name.

Prerequisites​

Ensure the following items are available before configuring the integration:

  • Pulseway API Token
  • Pulseway API Secret
  • Pulseway Host Name

Configuring Pulseway​

Generating a Pulseway API Token and Secret​

Authentication Method: BASIC Authentication​

To authorize Pulseway APIs, this integration requires the API Token and Secret.

Steps to Generate an API Token and Secret​

  1. Log in to the Pulseway web application.
  2. Navigate to Configuration in side pane under the Administration.
  3. Click on API Access.
  4. Under the Third-Party Access tab, click Create Token.
  5. Provide the following details:
    • Name: Assign a name to the token.
    • Description: Add a description for reference.
    • Expiration: Set the token's expiry date.
    • Access: Enable access to all organizations.
  6. Click Edit Permissions and select the following permissions:
    • Device: Get All Devices, Get Device Applied Policies.
    • Asset: Get All Devices and Asset Information.
    • Group: Get All Groups.
    • Environment Information: Get Environment Information.
  7. Confirm the selected permissions.
  8. Click Create.
  9. Copy the Token ID and Token Secret and save them securely.
  10. Confirm by selecting I confirm that I saved my Token Secret code.
  11. Close the Window.

Get Pulseway Host Name​

Admin > Server Admin > Overview > Server Information > Name

Configuring in JupiterOne​

  1. In the J1 Search homepage, navigate to the Integrations section from the top navigation bar.

  2. Search for Pulseway and select it.

  3. Click the Add Instance button and configure the following:

    • Pulseway API Token: Enter the API Token generated in Pulseway.
    • Pulseway API Secret: Enter the API Secret generated in Pulseway.
    • Pulseway Host: Enter the host name of your Pulseway server. # e.g., test.pulseway.com
    • Account Name: Assign a name to identify this Pulseway instance in JupiterOne. If the Tag with Account Name option is enabled, ingested entities will include this value in tag.AccountName.
    • Description: Add a description to assist your team in identifying this integration instance.
    • Polling Interval (optional): Select a polling interval appropriate for your monitoring needs. Leave this as DISABLED for manual execution if unsure.

  4. Click Create Configuration to save the settings.

Next Steps​

Your integration instance will now run based on the configured polling interval, populating data within JupiterOne. Refer to our Instance Management Guide to learn more about managing and editing integration instances.