Link to the SAML troubleshooting doc from guide (#36754)

Explicitly call out the existence of the troubleshooting guide so
that hopefully users can solve common and easy problems with their
initial configuration
This commit is contained in:
Ioannis Kakavas 2018-12-20 01:11:55 +02:00 committed by GitHub
parent 4140b9eede
commit c4e12f06d7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 0 deletions

View File

@ -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 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. instances use basic authentication against another realm type (e.g.
<<native-realm, Native>> or <<ldap-realm, LDAP>>). <<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.html[SAML troubleshooting documentation] that has
suggestions and resolutions for common issues.