summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDouwe Maan <douwe@gitlab.com>2015-07-01 14:25:22 +0200
committerDouwe Maan <douwe@gitlab.com>2015-07-01 14:25:22 +0200
commit9e841cf1a894c5bb88a470ffae0f59f12e6be8c2 (patch)
treeffd4c60c77dd5ce9820d7acab44f0b26daa558ec
parentf31d2aa44d37683a0ff88c71f558f5faf87ebda2 (diff)
downloadgitlab-ce-saml-troubleshooting.tar.gz
Add Troubleshooting section to SAML doc.saml-troubleshooting
-rw-r--r--doc/integration/saml.md5
1 files changed, 5 insertions, 0 deletions
diff --git a/doc/integration/saml.md b/doc/integration/saml.md
index a8cc5c8f74a..4aa6dbe758a 100644
--- a/doc/integration/saml.md
+++ b/doc/integration/saml.md
@@ -75,3 +75,8 @@ At a minimum the IdP *must* provide a claim containing the user's email address,
On the sign in page there should now be a SAML button below the regular sign in form. Click the icon to begin the authentication process. If everything goes well the user will be returned to GitLab and will be signed in.
+## Troubleshooting
+
+If you see a "500 error" in GitLab when you are redirected back from the SAML sign in page, this likely indicates that GitLab could not get the email address for the SAML user.
+
+Make sure the IdP provides a claim containing the user's email address, using claim name 'email' or 'mail'. The email will be used to automatically generate the GitLab username.