Integrate Jamf Pro with Intune for compliance
When your organization uses Jamf Pro to manage macOS devices, you can use Microsoft Intune compliance policies with Azure Active Directory (Azure AD) Conditional Access to ensure devices in your organization are compliant before they can access company resources. This article will help you configure Jamf integration with Intune.
When Jamf Pro integrates with Intune, you can sync the inventory data from macOS devices with Intune, through Azure AD. Intune's compliance engine then analyzes the inventory data to generate a report. Intune's analysis is combined with intelligence about the device user’s Azure AD identity to drive enforcement through Conditional Access. Devices that are compliant with the Conditional Access policies can gain access to protected company resources.
After you configure integration, you'll then configure Jamf and Intune to enforce compliance with Conditional Access on devices managed by Jamf.
Products and services
You need the following to configure Conditional Access with Jamf Pro:
- Jamf Pro 10.1.0 or later
- Company Portal app for macOS
- macOS devices with OS X 10.12 Yosemite or later
The following ports should be accessible for Jamf and Intune to integrate correctly:
- Intune: Port 443
- Apple: Ports 2195, 2196, and 5223 (push notifications to Intune)
- Jamf: Ports 80 and 5223
To allow APNS to function correctly on the network, you must also enable outgoing connections to, and redirects from:
- the Apple 126.96.36.199/8 block over TCP ports 5223 and 443 from all client networks.
- ports 2195 and 2196 from Jamf Pro servers.
For more information about these ports, see the following articles:
- Intune network configuration requirements and bandwidth.
- Network Ports Used by Jamf Pro on jamf.com.
- TCP and UDP ports used by Apple software products on support.apple.com
Connect Intune to Jamf Pro
To connect Intune with Jamf Pro:
- Create a new application in Azure.
- Enable Intune to integrate with Jamf Pro.
- Configure Conditional Access in Jamf Pro.
Create an application in Azure Active Directory
In the Azure portal, go to Azure Active Directory > App Registrations, and then select New registration.
On the Register an application page, specify the following details:
- In the Name section, enter a meaningful application name, for example Jamf Conditional Access.
- For the Supported account types section, select Accounts in any organizational directory.
- For Redirect URI, leave the default of Web, and then specify the URL for your Jamf Pro instance.
Select Register to create the application and to open the Overview page for the new app.
On the app Overview page, copy the Application (client) ID value and record it for later use. You'll need this value in later procedures.
Select Certificates & secrets under Manage. Select the New client secret button. Enter a value in Description, select any option for Expires and choose Add.
Before you leave this page, copy the value for the client secret and record it for later use. You will need this value in later procedures. This value isn’t available again, without recreating the app registration.
Select API permissions under Manage.
On the API permissions page, select Add a permission to add a new permission. On the Request API permissions page, select Intune, and then select Application permissions. Select only the check box for update_device_attributes.
Wait a few minutes so that the new permission can take effect. Then, select Grant admin consent for <your tenant>. Authenticate your account in the new window and grant the application access by following the prompts.
You may need to wait another few minutes so that the admin consent can take effect.
Refresh the page by click on the Refresh button at the top of the page. Confirm that admin consent has been granted for the update_device_attributes permission.
Remove admin consent from the User.Read permission by selecting the ... menu and selecting Revoke admin consent.
You will also need to remove the User.Read permission. Select the ... menu by User.Read and select Remove permission.
After the app is registered successfully, the API permissions should only contain one permission called update_device_attributes and should appear as follows:
The app registration process in Azure AD is complete.
If the client secret expires, you must create a new client secret in Azure and then update the Conditional Access data in Jamf Pro. Azure allows you to have both the old secret and new key active to prevent service disruptions.
Enable Intune to integrate with Jamf Pro
Sign in to the Microsoft Endpoint Manager Admin Center.
Select Tenant administration > Connectors and tokens > Partner device management.
Enable the Compliance Connector for Jamf by pasting the Application ID you saved during the previous procedure into the Specify the Azure Active Directory App ID for Jamf field.
Configure Microsoft Intune Integration in Jamf Pro
Activate the connection in the Jamf Pro console:
- Open the Jamf Pro console and navigate to Global Management > Conditional Access. Click the Edit button on the macOS Intune Integration tab.
- Select the check box for Enable Intune Integration for macOS.
- Provide the required information about your Azure tenant, including Location, Domain name, the Application ID, and the value for the client secret that you saved when you created the app in Azure AD.
- Select Save. Jamf Pro tests your settings and verifies your success.
Return to the Partner device management page in Intune to complete the configuration.
In Intune, go to the Partner device management page. Under Connector Settings configure groups for assignment:
- Select Include and specify which User groups you want to target for macOS enrollment with Jamf.
- Use Exclude to select groups of Users that won’t enroll with Jamf and instead will enroll their Macs directly with Intune.
Exclude overrides Include, which means any device that is in both groups is excluded from Jamf and directed to enroll with Intune.
This method of including and excluding user groups affects the enrollment experience of the user. Any user with a Mac thats already enrolled in either Jamf or Intune who is then targeted to enroll with the other MDM must unenroll their device and then re-enroll it with the new MDM before management of the device works properly.
Select Evaluate to determine how many devices will be enrolled with Jamf, based on your group configurations.
Select Save when you’re ready to apply the configuration.
To proceed, you will next need to use Jamf to deploy the Company Portal for Mac so that users can register their devices to Intune.
Set up compliance policies and register devices
After you configure integration between Intune and Jamf, you need to apply compliance policies to Jamf-managed devices.
Disconnect Jamf Pro and Intune
If you no longer use Jamf Pro to manage Macs in your organization and want users to be managed by Intune, you must remove the connection between Jamf Pro and Intune. Remove the connection by using the Jamf Pro console.
In Jamf Pro, go to Global Management > Conditional Access. On the macOS Intune Integration tab, select Edit.
Clear the Enable Intune Integration for macOS check box.
Select Save. Jamf Pro sends your configuration to Intune and the integration will be terminated.
Sign in to the Microsoft Endpoint Manager Admin Center.
Select Tenant administration > Connectors and tokens > Partner device management to verify that the status is now Terminated.
Your organization's Mac devices will be removed at the date (3 months) shown in your console.