diff --git a/openmetadata-docs/content/v1.6.x/deployment/security/saml/azure.md b/openmetadata-docs/content/v1.6.x/deployment/security/saml/azure.md index a6dbf364a617..f708fd204638 100644 --- a/openmetadata-docs/content/v1.6.x/deployment/security/saml/azure.md +++ b/openmetadata-docs/content/v1.6.x/deployment/security/saml/azure.md @@ -16,6 +16,18 @@ Security requirements for your **production** environment: {% /note %} +{% note %} + +## Key Notes on SAML Configuration + +1. **Set `AUTHENTICATION_PROVIDER` to `saml` (lowercase):** + Ensure the `AUTHENTICATION_PROVIDER` field in your environment variables is explicitly set to `saml` for SAML authentication to function correctly. Without this, SAML integration will not work. + +2. **Routing to IDP:** + Users will only be routed to the IDP upon sign-in if `AUTHENTICATION_PROVIDER` is set to `saml`. + +{% /note %} + ## Create OpenMetadata application ### Step 1: Configure a new Application in Microsoft Entra ID @@ -150,4 +162,4 @@ Security requirements for your **production** environment: ### Step 4: Start the server -- Set up for SAML is done, you should be routed to your IDP on trying to Sign-in. +- Start the OpenMetadata server. With `AUTHENTICATION_PROVIDER` set to saml, you should be routed to the IDP upon sign-in. diff --git a/openmetadata-docs/content/v1.7.x-SNAPSHOT/deployment/security/saml/azure.md b/openmetadata-docs/content/v1.7.x-SNAPSHOT/deployment/security/saml/azure.md index a107d1158322..3a184c3f88b4 100644 --- a/openmetadata-docs/content/v1.7.x-SNAPSHOT/deployment/security/saml/azure.md +++ b/openmetadata-docs/content/v1.7.x-SNAPSHOT/deployment/security/saml/azure.md @@ -16,6 +16,18 @@ Security requirements for your **production** environment: {% /note %} +{% note %} + +## Key Notes on SAML Configuration + +1. **Set `AUTHENTICATION_PROVIDER` to `saml` (lowercase):** + Ensure the `AUTHENTICATION_PROVIDER` field in your environment variables is explicitly set to `saml` for SAML authentication to function correctly. Without this, SAML integration will not work. + +2. **Routing to IDP:** + Users will only be routed to the IDP upon sign-in if `AUTHENTICATION_PROVIDER` is set to `saml`. + +{% /note %} + ## Create OpenMetadata application ### Step 1: Configure a new Application in Microsoft Entra ID @@ -150,4 +162,4 @@ Security requirements for your **production** environment: ### Step 4: Start the server -- Set up for SAML is done, you should be routed to your IDP on trying to Sign-in. +- Start the OpenMetadata server. With `AUTHENTICATION_PROVIDER` set to saml, you should be routed to the IDP upon sign-in.