title | description | keywords | author | ms.author | manager | ms.date | ms.topic | ms.service | ms.subservice | ms.localizationpriority | ms.assetid | ms.reviewer | ms.suite | search.appverid | ms.custom | ms.collection | |||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Microsoft Intune App SDK for iOS developer guide - Plan the integration |
The Microsoft Intune App SDK for iOS lets you incorporate Intune app protection policies (also known as APP or MAM policies) into your native iOS app. Plan the integration. |
Erikre |
erikre |
dougeby |
11/01/2023 |
reference |
microsoft-intune |
developer |
medium |
8e280d23-2a25-4a84-9bcb-210b30c63c0b |
jamiesil |
ems |
MET150 |
has-adal-ref |
|
The Microsoft Intune App SDK for iOS lets you incorporate Intune app protection policies (also known as APP or MAM policies) into your native iOS app. A MAM-enabled application is one that is integrated with the Intune App SDK. IT administrators can deploy app protection policies to your mobile app when Intune actively manages the app.
Important
Intune regularly releases updates to the Intune App SDK. We recommend subscribing to the Intune App SDK repositories for updates so that you can incorporate the update into your software development release cycle and ensure your apps support the latest App Protection Policy settings.
Plan to take mandatory Intune App SDK updates prior to every major OS release to ensure your app continues to run smoothly as OS updates can cause breaking changes. If you do not update to the latest version prior to a major OS release, you might run the risk of encountering a breaking change and/or being unable to apply app protection policies to your app.
This guide is for iOS developers who are looking to add support for Microsoft Intune's App Protection Policies inside their existing iOS app.
- Learn what App Protection Policy settings are available for iOS and how these policies will work inside your application.
- Understand the key decision points during the SDK integration process and plan your app's integration.
- Understand the requirements for applications integrating the SDK.
- Create a test Intune tenant and configure an iOS App Protection Policy.
Before you start integrating the Intune App SDK into your iOS application, take a moment to familiarize yourself with Microsoft Intune's Mobile Application Management solution:
- What is Microsoft Intune app management provides a high level overview of MAM capabilities on different platforms and where to find these features in the Microsoft Intune admin center.
- Intune App SDK overview goes one layer deeper, describing the current features of the SDK.
- Get Started with Intune App SDK Guide explains how to prepare for integration on each supported platform.
- iOS app protection policy settings describe each iOS setting in detail. Your app will support these settings by integrating the SDK. During the SDK integration process, you'll also configure these settings in your own test tenant for validation.
- (Optional) Plan for mobile application management in Microsoft Intune - Training | Microsoft Learn explains how to plan for mobile application management using Microsoft Intune, with a focus on adding apps to Intune, using app protection policies and app configuration policies, and troubleshooting app protection policy deployment.
Yes, all apps integrating with the Intune SDK are required to register with the Microsoft identity platform. Please follow the steps in Quickstart: Register an app in the Microsoft identity platform - Microsoft identity platform.
If you don't have access to your application's source code and only have access to the compiled application in either .app or .ipa format, you won't be able to integrate the SDK into your application. However, your application may still be compatible with Intune app protection policies. See App Wrapping Tool for iOS for more details.
Yes, you are required to integrate with MSAL before integrating the Intune SDK. Before integrating with MSAL, all apps are required to register with the Microsoft identity platform. Please follow the steps in Quickstart: Register an app in the Microsoft identity platform - Microsoft identity platform.
See Stage 2: MSAL prerequisite and setup for instructions on integrating MSAL and additional details on identity scenarios inside your application.
Without Intune App Protection Policy support, how does your application handle user authentication and accounts?
-
Does your application currently only allow a single account to be logged in? Does your application explicitly force the logged-in account to log out—and delete that previous account's data—before allowing another account to log in? If so, your application is single-identity.
-
Does your application currently allow a second account to log in, even if a different account is already logged in? Does your application display multiple accounts' data on a shared screen? Does your application store multiple accounts' data? Does your application let users switch between different logged in accounts? If so, your application is multi-identity and you'll need to follow Stage 5: Enable multi-identity. This section is required for your app.
Even if your application is multi-identity, follow this integration guide in order. Initially integrating and testing as single-identity will help ensure proper integration and prevent bugs where corporate data ends up unprotected.
What if my app builds with .NET Multi-platform App UI (.NET MAUI)?
If your app builds with .NET Multi-platform App UI (.NET MAUI), see Intune App SDK for .NET MAUI - iOS.
Intune supports application configurations that apply to SDK-integrated applications, regardless of device management mode. Admins can configure these application configuration policies for managed apps in the Microsoft Intune admin center.
The Intune App SDK supports both types of application configuration and provides a single API for accessing configurations from both channels. If your application has or will support either of these types of application configuration, you'll need to follow Stage 4: Enable targeted configuration (APP/MAM app config) for your iOS applications.
For more information about how to create a MAM targeted app configuration policy in iOS, see the section on MAM targeted app config in How to use Microsoft Intune app configuration policies for iOS/iPadOS.
If your app lets users save data to or open data from cloud services or to device locations, it must take changes to support enhanced data transfer policy. See Manage data transfer between iOS apps in Microsoft Intune.
Conditional Access (CA) is a Microsoft Entra ID feature that can be used to control access to Microsoft Entra resources. Intune administrators can define CA rules that allow resource access only from devices or apps that are managed by Intune.
Intune supports two types of CA: device-based CA and app-based CA, also known as App Protection CA. Device-based CA blocks access to protected resources until the entire device is managed by Intune. App-based CA blocks access to protected resources until the specific app is managed by Intune App Protection Policies.
If your app acquires any Microsoft Entra access tokens and accesses resources that can be CA-protected, you'll need to follow [Stage 4: App Protection CA support].
If you don't already have a tenant with your company, you can create a demo tenant with or without pre-generated data. You must register as a Microsoft partner to access Microsoft CDX. To create a new account:
- Navigate to the Microsoft CDX tenant creation site and create a Microsoft 365 Enterprise tenant.
- Set up Intune to enable mobile device management (MDM).
- Create users.
- Create groups.
- Assign licenses as appropriate for your testing.
Create and assign app protection policies in the Microsoft Intune admin center. In addition to creating app protection policies, you can create and assign an app configuration policy in Intune.
Before you test app protection policy settings within your own application, it's helpful to familiarize yourself with how these settings behave inside other SDK-integrated applications.
Tip
If your app isn't listed in the Microsoft Intune admin center, you can target it with a policy by selecting the more apps option and providing the package name in the text box.
You must target your app with app protection policy and deploy the policy to a user to successfully test your integration.
Even if policy is targeted and deployed, your app will not properly enforce policies until it has successfully integrated the SDK.
- Have you familiarized yourself with how different app protection policy settings will behave inside your iOS application?
- Have you reviewed your app and planned your app's integration around MSAL, Conditional Access, Multi-Identity, App Configuration, and all additional SDK features?
- Have you created an iOS app protection policy within your test tenant?
To download the SDK, see Download the SDK files.
Please submit a request for assistance on GitHub.
After you've completed all the Exit Criteria above, continue to Stage 2: MSAL prerequisite and setup.