Skip to content

Link to the SAML troubleshooting doc from guide #36754

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jkakavas merged 9 commits into from
Dec 19, 2018
Merged

Link to the SAML troubleshooting doc from guide #36754

Changes from 8 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
1964c49
Link to the SAML troubleshooting doc from guide
jkakavas Dec 18, 2018
5b44ea1
Merge remote-tracking branch 'origin/master' into saml-guide-troubles…
jkakavas Dec 18, 2018
cf162f4
Update x-pack/docs/en/security/authentication/saml-guide.asciidoc
lcawl Dec 18, 2018
adf04ff
Merge remote-tracking branch 'origin/master' into saml-guide-troubles…
jkakavas Dec 19, 2018
2eebec7
Merge branch 'saml-guide-troubleshooting' of github.com:jkakavas/elas…
jkakavas Dec 19, 2018
89f7a6c
fix link to the troubleshooting guide
jkakavas Dec 19, 2018
e442bce
Merge remote-tracking branch 'origin/master' into saml-guide-troubles…
jkakavas Dec 19, 2018
9cf02d2
Merge remote-tracking branch 'origin/master' into saml-guide-troubles…
jkakavas Dec 19, 2018
51fbd3e
Update x-pack/docs/en/security/authentication/saml-guide.asciidoc
lcawl Dec 19, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions x-pack/docs/en/security/authentication/saml-guide.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -858,3 +858,15 @@ xpack.security.authc.realms.saml.saml_eng:
It is possible to have one or more {kib} instances that use SAML, while other
instances use basic authentication against another realm type (e.g.
<<native-realm, Native>> or <<ldap-realm, LDAP>>).

=== Troubleshooting SAML Realm Configuration

The SAML 2.0 specification offers a lot of options and flexibility for the implementers
of the standard which in turn adds to the complexity and the number of configuration options
that are available both at the Service Provider (Elastic Stack) and at the Identity Provider.
Additionally, different security domains have different security requirements that need
specific configuration to be satisfied.
A conscious effort has been made to mask this complexity with sane defaults and the detailed
documentation above but in case you encounter issues while configuring a SAML realm, you can
look through our {stack-ov}/trb-security-saml[SAML troubleshooting documentation] that has
suggestions and resolutions for common issues.