|
1 | 1 | ---
|
2 |
| -title: Redirect URI (reply URL) restrictions | Azure AD |
| 2 | +title: Redirect URI (reply URL) restrictions |
3 | 3 | description: A description of the restrictions and limitations on redirect URI (reply URL) format enforced by the Microsoft identity platform.
|
4 | 4 | author: madansr7
|
5 |
| -ms.author: saumadan |
6 | 5 | manager: CelesteDG
|
7 |
| -ms.date: 09/03/2021 |
8 |
| -ms.topic: conceptual |
9 |
| -ms.subservice: develop |
10 |
| -ms.custom: contperf-fy21q4-portal, aaddev |
| 6 | +ms.author: saumadan |
| 7 | +ms.date: 08/25/2022 |
| 8 | +ms.reviewer: marsma |
11 | 9 | ms.service: active-directory
|
12 |
| -ms.reviewer: marsma, lenalepa, manrath |
| 10 | +ms.subservice: develop |
| 11 | +ms.topic: reference |
13 | 12 | ---
|
14 | 13 |
|
15 | 14 | # Redirect URI (reply URL) restrictions and limitations
|
@@ -54,6 +53,19 @@ You can use a maximum of 256 characters for each redirect URI you add to an app
|
54 | 53 | * Always add redirect URIs to the application object only.
|
55 | 54 | * Do not add redirect URI values to a service principal because these values could be removed when the service principal object syncs with the application object. This could happen due to any update operation which triggers a sync between the two objects.
|
56 | 55 |
|
| 56 | +## Query parameter support in redirect URIs |
| 57 | + |
| 58 | +Query parameters are allowed in redirect URIs for applications that *only* sign in users with work or school accounts. |
| 59 | + |
| 60 | +Query parameters are not allowed in redirect URIs for any app registration configured to sign in users with personal Microsoft accounts like Outlook.com (Hotmail), Messenger, OneDrive, MSN, Xbox Live, or Microsoft 365. |
| 61 | + |
| 62 | +| App registration sign-in audience | Supports query parameters in redirect URI | |
| 63 | +|------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------| |
| 64 | +| Accounts in this organizational directory only (Contoso only - Single tenant) | :::image type="icon" source="media/common/yes.png" border="false"::: | |
| 65 | +| Accounts in any organizational directory (Any Azure AD directory - Multitenant) | :::image type="icon" source="media/common/yes.png" border="false"::: | |
| 66 | +| Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox) | :::image type="icon" source="media/common/no.png" border="false"::: | |
| 67 | +| Personal Microsoft accounts only | :::image type="icon" source="media/common/no.png" border="false"::: | |
| 68 | + |
57 | 69 | ## Supported schemes
|
58 | 70 |
|
59 | 71 | **HTTPS**: The HTTPS scheme (`https://`) is supported for all HTTP-based redirect URIs.
|
|
0 commit comments