From 9585b772d71e9613752846588b0ef40cb8d37a57 Mon Sep 17 00:00:00 2001 From: Tanya Jha <282742281+TanyaJha31@users.noreply.github.com> Date: Fri, 23 Oct 2026 09:45:28 -0700 Subject: [PATCH 1/2] Update Add-AdfsClient.md with redirect_uri changes (#4146) Added notes about OAuth redirect_uri requirements and wildcard handling for AD FS starting October 2026. --- docset/winserver2025-ps/ADFS/Add-AdfsClient.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docset/winserver2025-ps/ADFS/Add-AdfsClient.md b/docset/winserver2025-ps/ADFS/Add-AdfsClient.md index 736c5f8ac4..93841ccc79 100644 --- a/docset/winserver2025-ps/ADFS/Add-AdfsClient.md +++ b/docset/winserver2025-ps/ADFS/Add-AdfsClient.md @@ -252,6 +252,12 @@ If the client ID and redirection URI correspond to a pre-registered OAuth 2.0 cl Ensure that the value of the RedirectUri parameter matches exactly the redirection URI that will be specified by the OAuth 2.0 client when requesting authorization, including trailing slashes (/), if required. Use more secure schemes, such as https, when you specify a redirection URI. + [!NOTE] +> Starting with the October 2026 update, AD FS requires an exact match for the OAuth `redirect_uri` parameter, in accordance with [RFC 6749, section 3.1.2.3](https://www.rfc-editor.org/rfc/rfc6749#section-3.1.2.3). +> Redirection URIs containing wildcard characters, such as `https://*.hostname/path`, are accepted during registration without an error but will not match OAuth `redirect_uri` validation at runtime. +> Wildcard entries that previously matched through prefix matching will now be silently skipped, resulting in error MSIS9224 (Event ID 364) when no other registered URI exactly matches the requested redirection URI. +> Register a separate redirection URI for each specific hostname instead of using a wildcard. + For Windows Store applications that authenticate using the Windows Web Authentication Broker, use the 'ms-app://' scheme when registering a redirect URI. For example, ms-app://s-1-15-2-1101140336-4090662585-1905587327-262951538-2732256205-1306401843-4235927180/ is a redirect URI for a Windows Store application. If you are developing a Windows Store application, you can obtain the redirect URI for your application using the following code fragment: From b7645dd8c687139b28e845119da30ec670526507 Mon Sep 17 00:00:00 2001 From: Tanya Jha <282742281+TanyaJha31@users.noreply.github.com> Date: Fri, 23 Oct 2026 10:13:34 -0700 Subject: [PATCH 2/2] Update ADFS documentation for OAuth redirect_uri changes (#4147) Added a note about the October 2026 update regarding exact matching for the OAuth redirect_uri parameter and the handling of wildcard characters. Co-authored-by: Robin Harwood <19212983+robinharwood@users.noreply.github.com> --- .../ADFS/Add-AdfsNativeClientApplication.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docset/winserver2025-ps/ADFS/Add-AdfsNativeClientApplication.md b/docset/winserver2025-ps/ADFS/Add-AdfsNativeClientApplication.md index cc5423cb18..ac7d081eab 100644 --- a/docset/winserver2025-ps/ADFS/Add-AdfsNativeClientApplication.md +++ b/docset/winserver2025-ps/ADFS/Add-AdfsNativeClientApplication.md @@ -154,6 +154,12 @@ The value of this parameter must match exactly the redirection URI that is speci This includes trailing slashes '/', if they are required. We recommended the use of more secure schemes such as https in a redirection URI. +[!NOTE] +> Starting with the October 2026 update, AD FS requires an exact match for the OAuth `redirect_uri` parameter, in accordance with [RFC 6749, section 3.1.2.3](https://www.rfc-editor.org/rfc/rfc6749#section-3.1.2.3). +> Redirection URIs containing wildcard characters, such as `https://*.hostname/path`, are accepted during registration without an error but will not match OAuth `redirect_uri` validation at runtime. +> Wildcard entries that previously matched through prefix matching will now be silently skipped, resulting in error MSIS9224 (Event ID 364) when no other registered URI exactly matches the requested redirection URI. +> Register a separate redirection URI for each specific hostname instead of using a wildcard. + For Windows Store applications that authenticate by using the Windows Web Authentication Broker, use the `ms-app://` scheme for a redirection URI. If you are developing a Windows Store application, obtain the redirection URI for your application by using the following code fragment: