@@ -11,6 +11,34 @@ This guide provides framework-specific instructions for setting up the redirect
1111> The URI must match ** exactly** — including path, protocol, and port.
1212> Failure to update the app registration will result in ` redirect_uri_mismatch ` errors.
1313
14+ > [ !WARNING]
15+ > If the redirect bridge is ** not** set up, all authentication flows that rely
16+ > on a popup or hidden iframe will stop working. ` ssoSilent ` ,
17+ > ` acquireTokenPopup ` , and ` loginPopup ` depend on the redirect bridge to
18+ > receive the authentication response from the identity provider.
19+ > ` acquireTokenSilent ` is also affected when the refresh token is expired and
20+ > MSAL falls back to acquiring a new token in a hidden iframe (the same
21+ > mechanism used by ` ssoSilent ` ). Without the redirect bridge, the popup or
22+ > iframe cannot communicate the response back to the main application window.
23+ >
24+ > Redirect flows (` loginRedirect ` / ` acquireTokenRedirect ` ) ** can** work
25+ > without the redirect bridge ** only if** your ` redirectUri ` points to a page
26+ > that directly processes the authentication response (for example, using
27+ > ` handleRedirectPromise ` as in MSAL v4). However, when following the v5
28+ > guidance in this document—where ` redirectUri ` is set to the redirect bridge
29+ > page that calls ` broadcastResponseToMainFrame() ` —those redirect flows will
30+ > also fail if the bridge page is missing or not implemented correctly.
31+
32+ > [ !CAUTION]
33+ > ** Do NOT load the redirect bridge page from a CDN** (e.g., jsdelivr, unpkg,
34+ > cdnjs). The redirect bridge receives the raw authentication response —
35+ > including authorization codes and tokens — directly from the identity
36+ > provider. Loading this page from a third-party CDN creates a ** supply-chain
37+ > and token-theft risk** : a compromised CDN asset could intercept the
38+ > authentication response before it reaches your application. Always bundle the
39+ > redirect bridge with your application or serve it from your own
40+ > infrastructure.
41+
1442## Angular
1543
16441 . ** Create the redirect bridge component** (` src/app/redirect/redirect.component.ts ` ):
0 commit comments