Skip to content

Commit a685608

Browse files
authored
Document login_hint alternative to SAML request subject
While it is accurate that Azure's SAML implementation will throw an error if there's a Subject in the AuthnRequest, subject-like behavior is possible by including a login_hint parameter on the URL. It would be helpful to document that alternative here. As this isn't a part of the SAML standard I'm not sure if the change here fully and accurately describe how the login_hint parameter works with Azure's SAML implementation -- my own test case was including it on the query string of a GET request, and I kept the wording here general enough to cover POST as well if that's supported.
1 parent 9af99a5 commit a685608

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

articles/active-directory/develop/single-sign-on-saml-protocol.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,9 @@ A `Signature` element in `AuthnRequest` elements is optional. Azure AD can be co
101101

102102
### Subject
103103

104-
Don't include a `Subject` element. Azure AD doesn't support specifying a subject for a request and will return an error if one is provided.
104+
Don't include a `Subject` element. Azure AD doesn't support specifying a subject in `AuthnRequest` and will return an error if one is provided.
105+
106+
A subject can instead be provided by adding a `login_hint` parameter to the HTTP request to the single sign-on URL, with the subject's NameID as the parameter value.
105107

106108
## Response
107109

0 commit comments

Comments
 (0)