diff --git a/docs/user-management/saml.md b/docs/user-management/saml.md index 471bd9ec3..6db673472 100644 --- a/docs/user-management/saml.md +++ b/docs/user-management/saml.md @@ -6,7 +6,7 @@ Available from version [TODO] onwards. -This page tells you how to enable SAML in n8n. It assumes you're familiar with SAML. If you're not, [SAML Explained in Plain English](https://www.onelogin.com/learn/saml){:target=_blank .external-link} can help you understand how SAML works, and its benefits. +This page tells you how to enable SAML SSO (single sign-on) in n8n. It assumes you're familiar with SAML. If you're not, [SAML Explained in Plain English](https://www.onelogin.com/learn/saml){:target=_blank .external-link} can help you understand how SAML works, and its benefits. [TODO @@ -19,7 +19,25 @@ This page tells you how to enable SAML in n8n. It assumes you're familiar with S 1. In n8n, go to **Settings** > **Authentication**. n8n shows a list of single sign-on options. -1. Set **SAML 2.0** to **Activated**. You can only have one single sign-on method active. +1. Set **SAML 2.0** to **Activated**. You can't use SAML and LDAP at the same time. 1. Make a note of the n8n **Redirect URL** and **Entity ID**. 1. Set up SAML with your IdP. You need the redirect URL and entity ID. You may also need an email address and name for the IdP user. +1. Download the metadata XML from your IdP. +1. In n8n, copy the raw XML into **Identity Provider Settings**. +### Setup guidance for common IdPs + +These guides aren't full step-by-step guides. They provide documentation links, outline steps, and any n8n-specific details. + +#### Auth0 + +[Configure Auth0 as SAML Identity Provider | Manually configure SSO integrations](https://auth0.com/docs/authenticate/protocols/saml/saml-sso-integrations/configure-auth0-saml-identity-provider#manually-configure-sso-integrations){:target=_blank .external-link} + + +#### Authentik + +#### Okta + +#### OneLogin + +#### PingIdentity