Sign-in & Login Problems

How to Fix Microsoft Entra ID Login Popup Failure in iOS PWAs

WPS Content Manager Oct 9, 2026 868 views

Question details

The user is unable to authenticate via Microsoft Entra ID because the login popup results in a blank screen when the application is installed as an iOS Progressive Web App (PWA) through TestFlight.

Product: Microsoft Entra ID
Device & OS: iOS
Scenario: Attempting to sign in to a Progressive Web App on iOS using Microsoft Entra ID authentication.
Observed behavior: The authentication popup is blocked or unsupported in the PWA environment, leading to a blank screen instead of a successful login prompt.

Before you start

Verify that your iOS device is updated to the latest version, and check if the login screen loads correctly in the standard Safari browser before testing the standalone PWA environment.

Solution 1Recommended

Use Redirect Flow Instead of Popup for MSAL

iOS PWA standalone mode often restricts or blocks popups, which causes authentication failures. Switching your authentication library to a redirect flow resolves this limitation.

Progressive Web Apps (PWAs) on iOS do not handle secondary browser windows well. If your Microsoft Authentication Library (MSAL) is configured to use popup windows, users will likely encounter a blank screen.

Locate Auth Configuration

Open your application's source code and navigate to the file where your Microsoft Authentication Library (MSAL) is initialized.

Modify Login Method

Find the authentication call and change it from 'loginPopup()' to 'loginRedirect()'.

Configure Redirect URI

Ensure that your redirect URI in the Azure Portal matches the URL of your PWA and that your app is set up to handle the redirect callback seamlessly.

Re-deploy and Test

Push the updated code, distribute the new version via TestFlight, and test the sign-in process on an iOS device.

Recommended Authentication Method: Using the redirect flow is widely considered the best practice for authenticating users on mobile web applications and PWAs due to strict browser popup policies.

Solution 2

Consult Microsoft Q&A Identity Specialists

If changing the authentication flow does not resolve the blank screen, the issue may require investigation by Microsoft engineers specializing in Azure Active Directory and Entra ID.

Free Microsoft Office alternative

Looking for a Seamless Office Experience? Try WPS Office

While troubleshooting complex Microsoft Entra ID and web app deployment issues, you need a dependable, straightforward tool for your everyday document tasks. WPS Office provides a complete, free alternative to Microsoft Office, offering smooth performance across all platforms without complicated login configurations.

1. Download the Installer: Visit the official WPS Office website and click the free download button for your operating system.
2. Install the Suite: Run the downloaded file and follow the simple on-screen instructions to complete the installation.
3. Open Your Documents: Launch WPS Office to instantly open, edit, and save your existing Microsoft Office documents with perfect formatting.

Fully compatible with Microsoft Word, Excel, and PowerPoint formats.Lightweight and fast, requiring minimal system resources compared to other suites.No complex Active Directory or Entra ID setups required for personal or small business use.Familiar user interface ensuring a seamless migration from Microsoft Office.

microsoft office alternative - wps office

Frequently Asked Questions

Why do popups fail in iOS PWAs?

Apple's iOS heavily restricts the behavior of popup windows in standalone Progressive Web Apps for security and usability reasons. This often blocks standard authentication windows used by identity providers like Microsoft Entra ID, resulting in a blank screen.

How can I debug an iOS PWA authentication error?

You can connect your iOS device to a Mac using a USB cable. Open Safari on the Mac, enable Developer tools, and select your iOS device from the 'Develop' menu. This allows you to use the Web Inspector to view console logs for the running PWA.

Does MSAL natively support iOS PWAs?

The Microsoft Authentication Library (MSAL) relies on standard browser capabilities. While it works on iOS, for PWAs specifically, you must use the redirect flow (loginRedirect) rather than popups to ensure consistent behavior.

Login & Account Issues