Skip to main content

Outline

Introduction

This document provides the step-by-step procedure to configure JumpCloud in SAFE.

SAFE integrates with JumpCloud, and fetches the security misconfiguration of the JumpCloud account in SAFE.

Prerequisites

  • Access required in SAFE:

    • SAFE Admin Access

  • Access required in JumpCloud:

    • JumpCloud Admin Access

  • Required User Inputs:

    • API URL

    • Organization Name

    • API Key

  • Scope:

    • Admin Access

Generate Connection Details

  • How to generate API Key

    • Log in to your JumpCloud account as admin.

    • Click on your profile icon at the top-right of the screen.

    • Click on My API Key option

    • Click on the Generate New API Key button

    • The system displays the new API Key.

    • Copy and save the API Key to use it while configuring Jumpcloud in SAFE.

    • It's important to regularly update the API Key in SAFE according to its expiration date.


  • How to get Organization Name

    • Log in to your JumpCloud account as admin.

    • Click on your profile icon at the top-right of the screen.

    • Click on the Administrators

    • Click on the Organization Profile

    • Copy and save the Organization Name to use it while configuring JumpCloud in SAFE.


  • How to get API URL

    • Access the JumpCloud API documentation by clicking on the provided link.

    • Upon reaching the JumpCloud API documentation page, locate the section titled "Recycling or Resetting Your API Key".

    • In the exhibit provided, find the base URL highlighted as 3. Copy and save this API Base URL to use it while configuring JumpCloud in SAFE.

Configure JumpCloud in SAFE

  • Log in to your SAFE account as Admin.

  • Click on the Integrations option from the left navigation.

  • Scroll to find the JumpCloud integration card or Search for JumpCloud in the search bar.

  • Hover on the JumpCloud card and click on the Configure button

  • Enter the following:

    • API URL

    • Organization Name

    • API Key



  • Enter the Auto Sync Frequency.


  • Click on the Test Connection button.

  • Once the connection is verified, click on the Save button.

  • Click on the Sync Now button to trigger an on-demand sync.

  • Upon a successful sync, the system pulls the JumpCloud assets and their findings in SAFE. You can track the status of the sync in the History table.

View Results

  • Scroll down to the Finding View and Asset View available on the integration page.

    • Finding View: This tab displays all the findings details pulled from JumpCloud.

    • Asset View: This tab displays all the assets pulled from JumpCloud.

To check sync status and errors for this integration, see Integration History.

Did this article help?

Let us know by leaving a star rating at the top of this article.