Skip to content

Conversation

@jkakavas
Copy link
Contributor

Docs for #31238

  • Adds documentation for the req_authn_context_class_ref setting
  • Adds a section in SAML Guide regarding the use of SAML
    Authentication Context.

Docs for elastic#31238

- Adds documentation for the req_authn_context_class_ref setting
- Adds a section in SAML Guide regarding the use of SAML
  Authentication Context.
@jkakavas jkakavas added >docs General docs changes v7.0.0 :Security/Authentication Logging in, Usernames/passwords, Realms (Native/LDAP/AD/SAML/PKI/etc) v6.4.0 labels Aug 17, 2018
@jkakavas jkakavas requested review from lcawl and tvernum August 17, 2018 14:05
@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-security

Copy link
Contributor

@tvernum tvernum left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I left some suggestions, but @lcawl will probably offer something better.

in the Authentication Request. The IdP attempts to grant these restrictions,
and either returns an indication of which it satisfied in the Authentication
Statement of the SAML Response if it can, or it fails to authenticate the
user if it can't adhere to the restrictions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this will read better if it's more of a "if-scenario-A, then action-B ..." rather than "Either action-B if scenario-A, or ..."
For example

attempts to grant these restrictions,
and if it cannot adhere to the restrictions, then it fails the authentication attempt.
If the user is successfully authenticated, then the Authentication Statement of the
SAML Response will return an indication of the restrictions that were satisfied.

the Authentication Context Class Reference that is part of the
Authentication Statement of the SAML Assertion is examined. If it matches
one of the requested values, the authentication is considered successful,
otherwise failed.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe

otherwise, the authentication attempt fails.

?

A comma separated list of Authentication Context Class Reference values to be
included in the Requested Authentication Context when requesting the IdP to
authenticate the current user. The Authentication Context of the corresponding
authentication response should contain at least one of the requested values.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this need a link to the more complete explanation?
It doesn't make sense on its own unless you're a hard-core SAML expert.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added a link

Copy link
Contributor

@lcawl lcawl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've made some edits, now it LGTM

@jkakavas jkakavas merged commit 0a4b55c into elastic:master Aug 22, 2018
jkakavas added a commit that referenced this pull request Aug 22, 2018
Add documentation for #31238

- Add documentation for the req_authn_context_class_ref setting
- Add a section in SAML Guide regarding the use of SAML
  Authentication Context.
jkakavas added a commit that referenced this pull request Aug 22, 2018
Add documentation for #31238

- Add documentation for the req_authn_context_class_ref setting
- Add a section in SAML Guide regarding the use of SAML
  Authentication Context.
@jkakavas jkakavas deleted the authn-context-docs branch September 14, 2018 06:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

>docs General docs changes :Security/Authentication Logging in, Usernames/passwords, Realms (Native/LDAP/AD/SAML/PKI/etc) v6.4.0 v7.0.0-beta1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants