Overview

The Jamf connector enables your AI Colleagues to integrate with your organization's Jamf Pro platform, facilitating automated Apple device management, inventory tracking, and endpoint visibility workflows.

Jamf Pro is an Apple device management solution that allows organizations to manage and secure their entire fleet of macOS computers and iOS/iPadOS mobile devices. The Jamf connector allows Leena AI to automate device inventory queries, user lookups, application management, and endpoint operations seamlessly.

API Details

Leena AI integrates with Jamf Pro via REST APIs (Classic API and Jamf Pro API).

Documentation link: https://developer.jamf.com/jamf-pro/docs/jamf-pro-api-overview

Setup

The Jamf connector uses OAuth 2.0 authentication with the client credentials grant type.

Prerequisites

Before setting up the Jamf connector, ensure you have:

• Administrator access to your Jamf Pro instance
• Access to Jamf Pro Settings > System > API Roles and Clients
• Ability to create API Roles and API Clients in Jamf Pro
• Access to your Leena AI workspace with connector management permissions

Get credentials

Here is how to create API credentials in Jamf Pro:

1. Log in to your Jamf Pro instance (e.g., https://yourcompany.jamfcloud.com)
2. Navigate to API Roles and Clients:
   1. Click on Settings in the top-right corner
   2. Go to System > API Roles and Clients
3. Create an API Role:
   1. Click on the API Roles tab
   2. Click + New to create a new role
   3. Enter a Display Name (e.g., "Leena AI Integration")
   4. Select all required privileges for the actions you want to perform:
      • Read Computers
      • Read Mobile Devices
      • Read Users
      • Read Mac Applications
   5. Click Save
4. Create an API Client:
   1. Click on the API Clients tab
   2. Click + New to create a new client
   3. Enter a Display Name (e.g., "Leena AI Connector")
   4. Select the API Role you created in the previous step
   5. Set Access Token Lifetime as needed (default is 30 minutes)
   6. Click Save
5. Enable and Generate Client Secret:
   1. Open the API Client you just created
   2. Click Enable API Client to activate it
   3. Click Generate Client Secret
   4. Copy the Client ID and Client Secret immediately (the secret is shown only once)
   5. Store these credentials securely in a password manager

Add connection

Here is how to add a connection on Leena AI:

1. Log in to your Leena AI workspace
2. Navigate to Settings > Integrations
3. Search for "Jamf" and select it from the list to add its new connector
4. Start configuring the connector
   1. Auth Type: Select "OAuth 2.0 Client Credentials"
   2. Jamf Instance URL: Your Jamf Pro URL (e.g., https://yourcompany.jamfcloud.com)
   3. Client ID: The API Client ID from Jamf Pro
   4. Client Secret: The Client Secret generated in Jamf Pro
5. Complete Configuration and Save
   1. Click Connect to test the connection
   2. Verify the connection is successful
   3. Save the connector configuration

Actions

The following actions are supported for the Jamf connector:

List Users

Retrieves a list of all users from Jamf Pro. This action can be leveraged by Leena AI Orchestrator/Agent to get a complete list of users registered in the Jamf Pro instance. Here are some common use cases:

• User Directory: Get a complete list of all users in Jamf Pro
• Onboarding Verification: Verify user accounts exist in the system
• Reporting: Generate user inventory reports
• Audit: Review all registered users for compliance

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

This action does not require any input parameters.

Response

The action returns a list of users, each containing:

• User ID
• User Name
• Full Name
• Email Address

Get user detail by ID

Retrieves detailed information about a specific user from Jamf Pro using their unique user ID. The Agent can leverage this action to fetch comprehensive user details for security investigations, helpdesk support, or compliance audits.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Response

Upon successful retrieval, the action returns the user details including:

• User ID
• User Name
• Full Name
• Email Address
• Phone Number
• Position
• Department
• Building
• Room
• Linked computers and devices

Get user detail by email

Retrieves detailed information about a specific user from Jamf Pro using their email address. This action is useful for quickly looking up user information when only the email is known.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Here is a sample JSON input:

{
  "email": "[email protected]"
}

Response

Upon successful retrieval, the action returns the user details including:

• User ID
• User Name
• Full Name
• Email Address
• Phone Number
• Position
• Department
• Associated devices

Get computer basic information

Retrieves basic identifying information about a computer from Jamf Pro. This action fetches the General subset of computer data, providing essential information for device identification and inventory purposes.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Response

The action returns basic computer information including:

• Computer ID
• Computer Name
• MAC Address
• Serial Number
• UDID
• Last Check-in Time
• Platform
• Model

Search computer with mac id

Searches for a computer in Jamf Pro using its MAC address. This action is useful for identifying devices during network troubleshooting or security incident investigations.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Here is a sample JSON input:

{
  "macId": "AA:BB:CC:DD:EE:FF"
}

Response

Upon successful search, the action returns the computer details including:

• Computer ID
• Computer Name
• Serial Number
• MAC Address
• Model
• Operating System
• Last Check-in

Get computer by serial number

Retrieves complete computer information from Jamf Pro using the device's serial number. This action provides comprehensive device data for asset management, security investigations, and support requests.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Here is a sample JSON input:

{
  "serialNumber": "C02X1234ABCD"
}

Response

Upon successful retrieval, the action returns complete computer information including:

• General information
• Hardware specifications
• Operating system details
• Network configuration
• Storage information
• Security status
• Installed software
• Configuration profiles

Find subset of data using serial number

Retrieves specific subsets of computer data from Jamf Pro using the device's serial number. This action allows targeted retrieval of only the data categories needed, improving efficiency for automated workflows.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Subset Options

Here is a sample JSON input:

{
  "serialNumber": "C02X1234ABCD",
  "subset": ["General", "Hardware", "Software"]
}

Response

The action returns the requested data subsets for the computer, with each subset containing its relevant information based on the selection.

Get subset of data for user device

Retrieves specific subsets of mobile device data from Jamf Pro. This action allows targeted retrieval of iOS/iPadOS device information for security assessments, compliance checks, and device management workflows.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Subset Options

Here is a sample JSON input:

{
  "id": "12345",
  "subset": ["General", "Security", "Applications"]
}

Response

The action returns the requested data subsets for the mobile device, with each subset containing its relevant information based on the selection.

Get user device information

Retrieves device information for all computers associated with a specific user, identified by their email address. This action is essential for helpdesk support, security investigations, and offboarding workflows where you need to identify all devices assigned to a user.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Data Subset Options

Here is a sample JSON input:

{
  "email": "[email protected]",
  "subset": ["General", "Hardware", "Software"]
}

Response

The action returns the requested data subsets for all computers linked to the user, each containing:

• Computer identification information
• Selected subset data for each associated device

Get List of computer appliactions (JAMF Managed)

Retrieves a list of all application deployments managed through Jamf Pro's App Installers feature. This action provides visibility into software distribution and deployment status across the managed device fleet.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

This action does not require any input parameters.

Response

The action returns a list of App Installer deployments including:

• Total count of deployments
• Deployment ID
• Application name
• Version information
• Deployment status
• Target scope

Get list of application (Apple Managed)

Retrieves a list of all Mac applications managed through Apple's Volume Purchase Program (VPP) or Apple Business Manager. This action provides visibility into Apple-managed application licenses and assignments.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

This action does not require any input parameters.

Response

The action returns a list of Apple-managed applications including:

• Application ID
• Application name
• Bundle identifier
• Version
• License information