You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/active-directory/develop/single-sign-out-saml-protocol.md
+12-9Lines changed: 12 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,17 +8,17 @@ ms.service: active-directory
8
8
ms.subservice: develop
9
9
ms.workload: identity
10
10
ms.topic: conceptual
11
-
ms.date: 11/25/2022
11
+
ms.date: 05/30/2023
12
12
ms.author: owenrichards
13
13
ms.reviewer: kenwith
14
14
ms.custom: aaddev, engagement-fy23
15
15
---
16
16
17
17
# Single Sign-Out SAML Protocol
18
18
19
-
Azure Active Directory (Azure AD) supports the SAML 2.0 web browser single sign-out profile. For single sign-out to work correctly, the **LogoutURL** for the application must be explicitly registered with Azure AD during application registration. If the app is [added to the Azure App Gallery](../manage-apps/v2-howto-app-gallery-listing.md) then this value can be set by default. Otherwise, the value must be determined and set by the person adding the app to their Azure AD tenant. Azure AD uses the LogoutURL to redirect users after they're signed out.
19
+
Azure Active Directory (Azure AD) supports the SAML 2.0 web browser single sign-out profile. For single sign-out to work correctly, the **LogoutURL** for the application must be explicitly registered with Azure AD during application registration.
20
20
21
-
Azure AD supports redirect binding (HTTP GET), and not HTTP POST binding.
21
+
If the app is [added to the Azure App Gallery](../manage-apps/v2-howto-app-gallery-listing.md) then this value can be set by default. Otherwise, the value must be determined and set by the person adding the app to their Azure AD tenant. Azure AD uses the **LogoutURL** to redirect users after they're signed out. Azure AD supports redirect binding (HTTP GET), and not HTTP POST binding.
22
22
23
23
The following diagram shows the workflow of the Azure AD single sign-out process.
24
24
@@ -51,28 +51,31 @@ The `Issuer` element in a `LogoutRequest` must exactly match one of the **Servic
51
51
The value of the `NameID` element must exactly match the `NameID` of the user that is being signed out.
52
52
53
53
> [!NOTE]
54
-
> During SAML logout request, the `NameID` value is not considered by Azure Active Directory.
55
-
> If a single user session is active, Azure Active Directory will automatically select that session and the SAML logout will proceed.
56
-
> If multiple user sessions are active, Azure Active Directory will enumerate the active sessions for user selection. After user selection, the SAML logout will proceed.
54
+
> During SAML logout request, the `NameID` value is not considered by Azure AD.
55
+
> If a single user session is active, Azure AD will automatically select that session and the SAML logout will proceed.
56
+
> If multiple user sessions are active, Azure AD will enumerate the active sessions for user selection. After user selection, the SAML logout will proceed.
57
57
58
58
## LogoutResponse
59
+
59
60
Azure AD sends a `LogoutResponse` in response to a `LogoutRequest` element. The following excerpt shows a sample `LogoutResponse`.
Azure AD sets the `ID`, `Version` and `IssueInstant` values in the `LogoutResponse` element. It also sets the `InResponseTo` element to the value of the `ID` attribute of the `LogoutRequest` that elicited the response.
71
73
72
74
### Issuer
73
-
Azure AD sets this value to `https://login.microsoftonline.com/<TenantIdGUID>/` where \<TenantIdGUID> is the tenant ID of the Azure AD tenant.
74
75
75
-
To evaluate the value of the `Issuer` element, use the value of the **App ID URI** provided during application registration.
76
+
Azure AD sets this value to `https://login.microsoftonline.com/<TenantIdGUID>/` where \<TenantIdGUID> is the tenant ID of the Azure AD tenant.
77
+
78
+
To correctly identify the issuer element, use the value `https://login.microsoftonline.com/<TenantIdGUID>/` as shown in the sample LogoutResponse. This URL format identifies the Azure AD tenant as the issuer, representing the authority responsible for issuing the response.
76
79
77
80
### Status
78
81
Azure AD uses the `StatusCode` element in the `Status` element to indicate the success or failure of sign-out. When the sign-out attempt fails, the `StatusCode` element can also contain custom error messages.
0 commit comments