Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Save greghaskins/2a6760ec80c3fd2f32ce969c83b8fc7e to your computer and use it in GitHub Desktop.
Save greghaskins/2a6760ec80c3fd2f32ce969c83b8fc7e to your computer and use it in GitHub Desktop.
Enable Microsoft Entra SSO with Firefox for corporate Single-Sign-On on macOS

Enable Microsft Entra SSO in Firefox on macOS

Microsoft Intune / "Company Portal" integrates with the macOS system-wide SSO mechanism. Beyond just single-sign-on, this also helps the Microsoft-hosted websites (such as SharePoint and OneDrive) verify that the device is "trusted" so you don't get the annoying non-compliance banner:

Your organization doesn't allow you to download, print, or sync using this device

In Microsoft Edge (unsuprisingly) and Safari, this "just works." In Chrome, you can use the official browser extension. Firefox requires a policy settings change that isn't obvious since it's not in the UI.

Details

Policy setting documentation: https://mozilla.github.io/policy-templates/#microsoftentrasso

Turn on the MicrosftEntraSSO setting using any one of the following mechanisms. Only one is needed.

  • Perform the defaults write ... commands below. This is probably the easiest method.

    defaults write ~/Library/Preferences/org.mozilla.firefox EnterprisePoliciesEnabled -bool TRUE
    defaults write ~/Library/Preferences/org.mozilla.firefox MicrosoftEntraSSO -bool TRUE
  • Create a policies.json file in the documented location (On Mac, the file goes into Firefox.app/Contents/Resources/distribution)

    {
      "policies": {
        "MicrosoftEntraSSO": true
      }
    }
  • Corporate IT can push this policy using a system profile with those same key-value settings (MicrosoftEntraSSO=true).

In all cases, a browser restart is required. You can check that the setting worked by going to about:policies and seeing MicrosoftEntraSSO value set to true there.

@greghaskins
Copy link
Author

This is the "unmanaged device error message.

unmanaged-device-limited-web-access

Your organization doesn't allow you to download, print, or sync using this device. To use these actions, use a device that's joined to a domain or marked compliant by Intune. For help, contact your IT department.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment