BerriAI/litellm · error · ValueError

Enterprise features are not available. Custom UI SSO sign-in

Error message

Enterprise features are not available. Custom UI SSO sign-in requires LiteLLM Enterprise.

What it means

Error "Enterprise features are not available. Custom UI SSO sign-in requires LiteLLM Enterprise." thrown in BerriAI/litellm.

Source

Thrown at litellm/proxy/management_endpoints/ui_sso.py:1101

    # Store CLI login handle in state for OAuth flow
    cli_state: Final[str | None] = SSOAuthenticationHandler._get_cli_state(
        source=source,
        key=key,
        user_code=(user_code if _cli_sso_verification_uri_complete_enabled() else None),
    )

    # check if user defined a custom auth sso sign in handler, if yes, use it
    if user_custom_ui_sso_sign_in_handler is not None:
        try:
            from litellm_enterprise.proxy.auth.custom_sso_handler import (
                EnterpriseCustomSSOHandler,
            )

            return await EnterpriseCustomSSOHandler.handle_custom_ui_sso_sign_in(
                request=request,
            )
        except ImportError:
            raise ValueError(
                "Enterprise features are not available. Custom UI SSO sign-in requires LiteLLM Enterprise."
            )

    if (
        microsoft_client_id is None
        and google_client_id is None
        and generic_client_id is None
        and SAMLAuthHandler.is_saml_configured()
    ):
        verbose_proxy_logger.info("Redirecting to SAML SSO login")
        return await SAMLAuthHandler.build_login_redirect(
            request=request,
            cache=user_api_key_cache,
            relay_state=return_to,
        )

    # Check if we should use SSO handler
    if (

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Set LITELLM_LICENSE to a valid LiteLLM Enterprise license key to use custom UI SSO sign-in.

When it happens

Trigger: Thrown at litellm/proxy/management_endpoints/ui_sso.py:1101 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/a3b086f6bbf7526a. Report an issue: GitHub.