-
Notifications
You must be signed in to change notification settings - Fork 610
MS Intune Mobile App Support config, setup, troubleshooting, and end user workflows #8599
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Changes from all commits
599a914
6334a30
3350638
7c305b7
0f31a06
f47ab17
a2dfc71
9171afa
90580db
3af81d6
3ec94eb
657b758
5147147
3240e43
9a770d3
7ab7103
bf6a4e8
31d650e
dceacd5
f1eea82
8aec224
7f36db7
844e7bc
234c173
ab7b602
2774107
52a5724
a8e4088
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Large diffs are not rendered by default.
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -53,6 +53,33 @@ Preventing file downloads protects sensitive information from being inadvertentl | |
|
|
||
| See the :ref:`secure file preview <administration-guide/configure/environment-configuration-settings:enable secure file preview on mobile>` and :ref:`managing PDF link navigation <administration-guide/configure/environment-configuration-settings:allow pdf link navigation on mobile>` configuration settings documentation for details on enabling these features. | ||
|
|
||
| Microsoft Intune Mobile Application Management (MAM) | ||
| ---------------------------------------------------- | ||
|
|
||
| Mattermost supports Microsoft Intune MAM to enforce identity-based, app-level data protection on iOS devices without requiring full device enrollment in a mobile device management (MDM) solution. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We speak below about only supporting iOS today, should we also clarify it in this section? |
||
|
|
||
| .. important:: | ||
|
|
||
| Microsoft Intune MAM enforcement for Mattermost is currently supported on **iOS** only. We recommend using Android for Work profiles until Android Intune support is available. | ||
|
|
||
| Intune MAM applies security policies directly to the Mattermost mobile app using Microsoft Entra ID as the identity authority. This enables organizations to protect corporate or mission-sensitive data on Bring Your Own Device (BYOD) and mixed-use devices while preserving user privacy. | ||
|
|
||
| Key security capabilities enabled through Intune MAM include: | ||
|
|
||
| * **Mandatory enrollment** before accessing Mattermost on mobile | ||
| * **Identity-based enforcement** using Microsoft Entra ID | ||
| * **Selective wipe** of Mattermost work data without affecting personal apps or device data | ||
| * **Clipboard, file sharing, and data transfer restrictions** | ||
| * **Screenshot and screen recording prevention** | ||
| * **Managed browser enforcement** and controlled link handling | ||
| * **Immediate enforcement** when policies or licensing change, including during active sessions | ||
|
|
||
| Intune MAM enforcement is applied **per Mattermost workspace** and evaluated continuously at runtime. If a device becomes non-compliant, enrollment fails, or required policies are not met, access to protected content is blocked automatically. | ||
|
|
||
| This approach allows organizations to extend zero-trust and data loss prevention (DLP) controls to mobile users without assuming ownership or management of the underlying device. | ||
|
|
||
| See the :doc:`Microsoft Intune MAM configuration guide </deployment-guide/mobile/configure-microsoft-intune-mam>` for deployment and configuration details. | ||
|
|
||
| Mobile data isolation | ||
| ------------------------ | ||
|
|
||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -52,6 +52,103 @@ Access your Mattermost instance with your credentials using a web browser, the d | |
| 3. Enter your user credentials to log into Mattermost. | ||
| 4. The team that displays first in the team sidebar opens. If you're not a member of a team yet, you're prompted to select a team to join. | ||
|
|
||
| .. tab:: Mobile via Microsoft Intune | ||
| :parse-titles: | ||
|
|
||
| When your organization uses Microsoft Intune App Protection to secure Mattermost on iOS mobile devices, you must enroll to access Mattermost on mobile. Enrollment adds extra protection to work data while keeping your personal device and apps private. | ||
|
|
||
| What to Expect | ||
| --------------- | ||
|
|
||
| Each time you sign in, Mattermost checks the Intune App Protection Policy applied to your account and automatically enroll your account before you can access your workspace. After enrollment, your Mattermost experience generally stays the same, but some restrictions may be enforced. | ||
|
|
||
| Intune protections apply **per Mattermost workspace** (the Mattermost server you sign in to). If you have access to multiple Mattermost workspaces, each workspace may have different protections and requirements in place. This guide explains what to expect when the workspace you are connecting to is protected by Intune. | ||
|
|
||
| .. note:: | ||
|
|
||
| * Intune protections are based on your **user account**, not your Mattermost role or permissions. | ||
| * Intune policies are controlled by your organization, not by Mattermost. | ||
| * Intune enrollment applies only when you sign in using your organization’s **Microsoft/Entra ID** sign-in method (for example, **Sign in with Microsoft**). If you sign in using a different method (such as email/password or another SSO provider), Intune App Protection may not be applied for that workspace. | ||
| * If you’re unsure which sign-in option to use, contact your IT support team. | ||
|
|
||
| Sign In to Enroll | ||
| ----------------- | ||
|
|
||
| To sign in and enroll your iOS device: | ||
|
|
||
| 1. Open the Mattermost mobile app on your iOS device. | ||
| 2. Sign in with Microsoft (your organization’s sign-in option). | ||
| 3. Enter your credentials. | ||
| 4. When enrollment completes, you are notified. | ||
| 5. If your organization’s Intune App Protection Policy requires it, you’ll be prompted to set a PIN to protect your work data. Once the PIN is confirmed, the Mattermost Mobile App unlocks access to your workspace. | ||
|
|
||
| Enrollment happens automatically during sign-in. If you cancel the sign-in flow before it completes, return to the sign-in flow and finish signing in to continue using Mattermost on that device. | ||
|
|
||
| Mid-Session Enrollment | ||
| ---------------------- | ||
|
|
||
| If enrollment is triggered while you're already signed in, you may be prompted to confirm your Microsoft sign-in again. This is expected and typically takes only a few seconds. | ||
|
|
||
| If you tap **Cancel**, you won’t be able to continue using Mattermost on that device until enrollment succeeds. You can retry immediately, or `log out <#what-happens-when-i-log-out-manually>`__ and retry later. | ||
|
|
||
| What Changes After Enrollment? | ||
| ------------------------------ | ||
|
|
||
| Your organization’s Intune App Protection Policy may restrict how you copy, capture, save, and share data from Mattermost. The exact behavior depends on the specific policy settings your organization has configured. | ||
|
|
||
| Screenshot and Screen Recording Restrictions | ||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| Depending on your organization’s policy, you may not be able to take screenshots or record your screen while using Mattermost. If screenshot or screen recording is blocked, your device may still show the screenshot or recording UI, but the content may not be captured. | ||
|
|
||
| File Save Restrictions | ||
| ~~~~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| Depending on policy, you may not be able to save files from Mattermost to personal or unmanaged locations. Files may be limited to locations approved by your organization. | ||
|
|
||
| Browser and Sharing Restrictions | ||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| Depending on policy, links may open only in an approved browser and sharing may be restricted to managed apps. If you try to open a link in an unapproved browser or share content to an unmanaged app, the action may be blocked. | ||
|
|
||
| Frequently Asked Questions | ||
| -------------------------- | ||
|
|
||
| What Happens If I Leave the Organization or Lose My Device? | ||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| If you leave the organization, or your device is lost or compromised, your IT support team can wipe Mattermost work data from your iOS device. This is called a **selective wipe**. | ||
|
|
||
| A selective wipe means that: | ||
|
|
||
| * Only Mattermost work data is removed from your device. | ||
| * Personal apps, photos, and files are untouched. | ||
| * You are logged out of the affected Mattermost workspace. | ||
| * Other Mattermost workspaces on your device remain unaffected. | ||
|
|
||
| Why Can’t I Access Mattermost After Enrollment? | ||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| Mattermost may restrict access after enrollment if Intune detects a risk, such as: | ||
|
|
||
| * Your device operating system is out of date | ||
| * The device is too old to meet security requirements | ||
| * A jailbroken device is detected | ||
| * Malware is detected | ||
| * Re-authentication is required | ||
|
|
||
| If this occurs, Intune blocks access and displays an error message in the Mattermost mobile app explaining what action is required. Contact your IT support team for help. | ||
|
|
||
| What Happens When I Log Out Manually? | ||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| When you log out of Mattermost: | ||
|
|
||
| * All workspace data is securely removed from the device. | ||
| * Intune protection for that workspace is removed. | ||
|
|
||
| You can sign back in with Microsoft if you need access again. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Should we add a note what happens if using a non-Microsoft authentication method, which likely means the feature will not be functional? (Just to make it explicit.) |
||
|
|
||
| Reset your password | ||
| -------------------- | ||
|
|
||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -25,6 +25,17 @@ Mobile access platforms | |
|
|
||
| Mattermost mobile applications can be operated under the protection of mobile access platforms like `Hypori <https://www.hypori.com/>`_. These platforms provide an additional layer of security by creating a virtualized environment for mobile applications, ensuring that sensitive data is isolated from the device's operating system. This approach enhances data protection and minimizes the risk of data leakage or unauthorized access. | ||
|
|
||
| Microsoft Intune Mobile Application Management (MAM) | ||
| ---------------------------------------------------- | ||
|
|
||
| Mattermost supports Microsoft Intune Mobile Application Management (MAM) to enforce app-level data protection on **iOS** devices without requiring full device enrollment in a mobile device management (MDM) solution. Intune MAM applies security policies directly to the Mattermost mobile app based on user identity, enabling organizations to protect corporate or mission-sensitive data on Bring Your Own Device (BYOD) and mixed-use devices while preserving user privacy. | ||
|
|
||
| Intune MAM for Mattermost is currently supported on iOS only. For Android deployments, we recommend using **Android Enterprise work profiles** as an alternative approach until Mattermost adds support for Intune MAM on Android. | ||
|
|
||
| Intune MAM enforcement is applied per Mattermost workspace and is evaluated continuously at runtime. If a device becomes non-compliant or enrollment fails, access to protected content is blocked automatically. This approach allows organizations to extend zero-trust and data loss prevention (DLP) controls to mobile users without assuming ownership of the underlying device. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Should we add a note that we advise to use for Android for Work profiles until we ship support for MAM on Android? |
||
|
|
||
| Learn more about the :ref:`security capabilities enabled through Intune MAM <deployment-guide/mobile/mobile-security-features:microsoft intune mobile application management (mam)>`. | ||
|
|
||
| Jailbreak and root detection | ||
| ----------------------------- | ||
|
|
||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I wonder if we should provide a Step by Step bullet point or something on how to actually configure this, I think this guide says a lot but if the person doing this do not have Entra / Intune experience they may not know what to do.