n8n-docs/docs/user-management/saml/setup.md

title	description	contentType
Set up SAML	Generic setup instructions for using SAML SSO with n8n.	howto

Set up SAML

--8<-- "_snippets/user-management/sso-saml-availability.md"

Enable SAML

1. In n8n, go to Settings > SSO.
2. Make a note of the n8n Redirect URL and Entity ID.
   1. Optional: if your IdP allows you to set up SAML from imported metadata, navigate to the Entity ID URL and save the XML.
   2. Optional: if you are running n8n behind a load balancer make sure you have N8N_EDITOR_BASE_URL configured.
3. Set up SAML with your IdP (identity provider). You need the redirect URL and entity ID. You may also need an email address and name for the IdP user.
4. After completing setup in your IdP, load the metadata XML into n8n. You can use a metadata URL or raw XML:
   1. Metadata URL: Copy the metadata URL from your IdP into the Identity Provider Settings field in n8n.
   2. Raw XML: Download the metadata XML from your IdP, toggle Identiy Provider Settings to XML, then copy the raw XML into Identity Provider Settings.
5. Select Save settings.
6. Select Test settings to check your SAML setup is working.
7. Set SAML 2.0 to Activated.

/// note | SAML Request Type Please note, n8n currently doesn't support POST binding. Please configure your IdP to use HTTP request binding instead. ///

Generic IdP setup

The steps to configure the IdP vary depending on your chosen IdP. These are some common setup tasks:

• Create an app for n8n in your IdP.
• Map n8n attributes to IdP attributes:

  Name	Name format	Value (IdP side)
  http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress` |	RI Reference |	ser email |
  http://schemas.xmlsoap.org/ws/2005/05/identity/claims/firstname` |	RI Reference |	ser First Name |
  http://schemas.xmlsoap.org/ws/2005/05/identity/claims/lastname` |	RI Reference |	ser Last Name |
  http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn` |	RI Reference |	ser Email |

Setup resources for common IdPs

Documentation links for common IdPs.

IdP	Documentation
Auth0	Configure Auth0 as SAML Identity Provider: Manually configure SSO integrations
Authentik	Applications and the SAML Provider
Azure AD	SAML authentication with Azure Active Directory
JumpCloud	How to setup SAML (SSO) applications with JumpCloud (using Zoom as an example)
Keycloak	Choose a Getting Started guide depending on your hosting.
Okta	n8n provides a Workforce Identity setup guide
PingIdentity	PingOne SSO