Overview

This guide will help you configure a JumpCloud API so Trustle can securely read your JumpCloud users and groups.

What you'll need:

• JumpCloud account with Administrator role
• Access to the JumpCloud Admin Panel

Step 1: Log in to the JumpCloud Admin Panel

Go to https://console.jumpcloud.com/login/admin and sign in with your administrator account.

Step 2: Create a Custom Role for Trustle Service Account

1. In the left sidebar, navigate to Settings
2. Click in the Administrators Tab
3. Click in the Custom Roles Sub Tab
4. Click to Add Custom Role
   

1. Give a name to the custom role (eg. trustle-sa)
2. Choose the “Read Only” as template role
3. Give “Full Access” to Groups Management Permission Category
   

1. Give “Full Access” to User Management Permission Category
   

1. Save

Step 3: Create a Service Account

1. In the left sidebar, navigate to Settings
2. Click in the Service Account Tab
3. Click in “New” button
   

1. Give a name
2. Select our custom role
   

1. Click in Configure
2. Select the secret life time and activate
   

1. Copy the Client ID and Client Secret
   

Step 4: Collect the JumpCloud Organization ID

1. In the left sidebar, navigate to Settings
2. Click in the Organization Profile
3. Copy the Organization ID under the General Section
   

Step 5: Set up the JumpCloud Integration in Trustle

1. Navigate to the Connections page in Trustle from the left menu
2. Under Identity Providers, find the JumpCloud logo and choose Connect
3. Fill in the connection form:
   
   • Connection Name: Enter a descriptive name (e.g., "My JumpCloud Connection")
   • Organization Id: Paste the organization id from Step 4
   • Client ID: Paste the client id from Step 3
   • Client Secret: Paste the client secret from Step 3
4. Click Test Connection
5. Upon successfully testing the connection, click Save Connection

‍