Overview

JAMF is a comprehensive device management platform for Apple devices (Mac, iPad, iPhone, Apple TV, and Apple Watch). The Leena AI JAMF connector is designed for deep integration with JAMF Pro's device and application management capabilities using REST APIs.

The connector provides visibility into the status, scheduling, and completion details of applications across your managed device fleet.

API Details

Leena AI integrates with JAMF using JAMF Pro REST APIs.

Setup

Prerequisites

Before setting up the JAMF connector, ensure that the API client you use is assigned the required permissions for a successful integration. You must ensure the API client has appropriate permissions (read/write scope). Authorization errors may occur if the API client has insufficient permissions during recipe building.

Get Credentials

Leena AI supports OAuth 2.0 authentication with API client for integrations for the JAMF REST APIs.

Steps to create OAuth Client in JAMF Pro

  1. Log in to the JAMF Pro Admin Console (ensure you are signed in as an admin).
  2. Navigate to API Roles by going to Settings > Jamf Pro User Accounts & Groups > API Roles.
  3. Add a new API role. Create a new API role with appropriate permissions (read/write scope) for client credentials.
  4. Generate Client Credentials: Under System Settings, generate a Client ID and Client Secret.

Setting up JAMF connector in Leena AI

  1. Navigate to Settings > Integrations to search for the JAMF application.
  2. Select the OAuth 2.0 authentication type.
  3. Add the following connection details:
FieldInformation RequiredDescription
Base URLJAMF Cloud URLThis is the base URL for all API endpoints (Example: https://leenaai.jamfcloud.com).
Client IDOAuth Client IDObtain this by following the steps above under 'Create OAuth Client in JAMF Pro'.
Client SecretOAuth Client SecretObtain this by following the steps above under 'Create OAuth Client in JAMF Pro'.
Grant Typeclient_credentialsOAuth 2.0 grant type for server-to-server authentication.

Actions

The Leena AI JAMF connector supports the following actions:

Get List of computer applications (JAMF Managed)

This action fetches application deployment information for JAMF-managed devices. It retrieves information about application deployments for JAMF-managed computers, providing visibility into the deployment status, scheduling, and completion details of applications across your managed device fleet.

Upon execution, the action returns the following response fields:

FieldDescriptionType
idUnique identifier for the deploymentInteger
nameName of the application being deployedString
deployment_typeType of deployment (Install, Uninstall, Update)String
target.typeType of target device (Computer, Mobile Device)String
target.nameName of the target deviceString
statusStatus of deployment (In Progress, Completed, Failed, Pending)String
scheduled timeWhen the deployment was scheduled to runISO 8601 Date Time
completed_timeWhen the deployment was completed (null if not completed)ISO 8601 Date Time or null
created_atWhen the deployment was createdISO 8601 Date Time
updated_atWhen the deployment was last updatedISO 8601 Date Time
error_messageError message if deployment failed (null if no error)String or null

Use Cases

Some of the use cases that you can achieve using the JAMF connector are:

  • Application Deployment Monitoring: Employees can request information about software installations on their managed devices through the virtual assistant.
  • Device Management Queries: Leena AI Virtual Assistant can help employees check the status of application deployments and installations on their corporate devices.
  • IT Support Automation: IT teams can automate responses to common queries about software availability and installation status across managed devices.