Skip to main content

Addigy

Visualize Addigy users and policies in the JupiterOne graph, map Addigy users to employees, and monitor changes through queries and alerts.

Installation​

Addigy supports two authentication methods. Choose the one that matches your setup:

  • Basic — authenticate with an Addigy admin username and password, plus a generated client ID and secret. Ingests devices and policies.
  • API Key — authenticate with an organization ID and an API key generated in the Addigy UI. Ingests devices, policies, and users.
note

User data (addigy_user entities) is only available when using API Key authentication.

Prerequisites​

Basic authentication​

  1. Log in to the Addigy portal as a user with the Owner role.
  2. Generate a client_id and client_secret for the integration. See Addigy's API documentation for instructions.
  3. Note the username and password of the Addigy admin account you will use.

API Key authentication​

  1. Log in to the Addigy portal.
  2. Locate your Organization ID from the organization settings.
  3. Generate an API Key in the Addigy UI. See Addigy's API documentation for instructions.

Configuration in JupiterOne​

To install the Addigy integration in JupiterOne, navigate to the Integrations tab and select Addigy. Click New Instance to begin.

Provide the following:

  • Account Name — identifies this Addigy account in JupiterOne. Ingested entities store this value in tag.AccountName when the AccountName toggle is enabled.
  • Description — optional label to help identify the instance.
  • Polling Interval — how often the integration runs. Set to DISABLED to run manually.

Then select an authentication method and supply the corresponding credentials:

Basic

FieldDescription
Addigy UsernameUsername of the Addigy admin account used to authenticate.
Addigy PasswordPassword of the Addigy admin account.
Addigy Client IDThe client_id generated through the Addigy UI.
Addigy Client SecretThe client_secret generated through the Addigy UI.

API Key

FieldDescription
Organization IDYour Addigy organization ID.
API KeyThe API key generated through the Addigy UI.

Click Create once all values are provided.

Next steps​

Once the instance is created, the integration runs on the polling interval you set, populating JupiterOne with Addigy devices, policies, and (for API Key auth) users. Continue to our Instance management guide to learn more about managing integration instances.