Integrating with the Jamf Certificate SDK

Integrating the Jamf Certificate SDK with Mobile Device Apps Deployed by Jamf Pro

Solution
Application
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US

Before you can distribute your iOS, iPadOS, or visionOS apps developed with the Jamf Certificate SDK, you must integrate the Jamf Certificate SDK with your app code.

Requirements

Ensure the general requirements for app development are met. For more information, see Jamf Certificate SDK Requirements.

  1. Install Jamf Pro Certificate SDK with Swift Package Manager by adding the following dependency to your Package.swift file:
    .package(url: "https://github.com/jamf/CertificateSDK.git", from: "1.1.0")
  2. Implement the CertificateRequestDelegate protocol in your code.
    Note:

    Delegate messages are not called on the main thread. To update any user interface you must dispatch back to the main thread.

  3. Create an instance of a subclass of CertificateRequestBase passing it a reference to your CertificateRequestDelegate protocol, and keep a strong reference to the request object.
    The available subclasses are CertificateRequestEmbeddedP12 (for testing) and CertificateRequestWorkflow (for production).
  4. Call -startNewCertificateRequest on the object created in step 3.
    This call initiates the request asynchronously and returns immediately. Your delegate will be called with progress (if implemented by your delegate) when networking starts/stops, any errors, and a completion message.

After your app is developed with the SDK, the app can be distributed to a device using Jamf Pro. This allows the required managed app configuration to be applied to the app during distribution. For more information on distributing in-house apps developed with the Jamf Certificate SDK, see the Integrating with Active Directory Certificate Services (AD CS) Using Jamf Pro technical paper.