{"record":{"id":"554f228512908f15","repo":"BerriAI/litellm","slug":"master-key-not-set-for-proxy-please-set-master-ke","errorCode":null,"errorMessage":"Master Key not set for Proxy. Please set Master Key to use Admin UI. Set `LITELLM_MASTER_KEY` in .env or set general_settings:master_key in config.yaml.  https://docs.litellm.ai/docs/proxy/virtual_keys. If set, use `--detailed_debug` to debug issue.","messagePattern":"Master Key not set for Proxy\\. Please set Master Key to use Admin UI\\. Set `LITELLM_MASTER_KEY` in \\.env or set general_settings:master_key in config\\.yaml\\.  https://docs\\.litellm\\.ai/docs/proxy/virtual_keys\\. If set, use `--detailed_debug` to debug issue\\.","errorType":"http","errorClass":"ProxyException","httpStatus":500,"severity":"error","filePath":"litellm/proxy/management_endpoints/ui_sso.py","lineNumber":2020,"sourceCode":"        sso_jwt_handler = JWTHandler()\n        sso_jwt_handler.update_environment(\n            prisma_client=prisma_client,\n            user_api_key_cache=user_api_key_cache,\n            litellm_jwtauth=LiteLLM_JWTAuth(\n                team_ids_jwt_field=general_settings.get(\"ui_access_mode\", {}).get(\"sso_group_jwt_field\", None),\n            ),\n            leeway=0,\n        )\n\n    microsoft_client_id: Final = os.getenv(\"MICROSOFT_CLIENT_ID\", None)\n    google_client_id: Final = os.getenv(\"GOOGLE_CLIENT_ID\", None)\n    generic_client_id: Final = os.getenv(\"GENERIC_CLIENT_ID\", None)\n    received_response: dict | None = None\n    access_token_payload: dict | None = None\n    sso_assertion: SSOIdentityAssertion | None = None\n    # get url from request\n    if master_key is None:\n        raise ProxyException(\n            message=\"Master Key not set for Proxy. Please set Master Key to use Admin UI. Set `LITELLM_MASTER_KEY` in .env or set general_settings:master_key in config.yaml.  https://docs.litellm.ai/docs/proxy/virtual_keys. If set, use `--detailed_debug` to debug issue.\",\n            type=ProxyErrorTypes.auth_error,\n            param=\"master_key\",\n            code=status.HTTP_500_INTERNAL_SERVER_ERROR,\n        )\n    redirect_url = SSOAuthenticationHandler.get_redirect_url_for_sso(request=request, sso_callback_route=\"sso/callback\")\n\n    verbose_proxy_logger.info(\"Redirecting to %s\", redirect_url)\n    result = None\n    if google_client_id is not None:\n        result = await GoogleSSOHandler.get_google_callback_response(\n            request=request,\n            google_client_id=google_client_id,\n            redirect_url=redirect_url,\n        )\n    elif microsoft_client_id is not None:\n        result = await MicrosoftSSOHandler.get_microsoft_callback_response(\n            request=request,","sourceCodeStart":2002,"sourceCodeEnd":2038,"githubUrl":"https://github.com/BerriAI/litellm/blob/77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8/litellm/proxy/management_endpoints/ui_sso.py#L2002-L2038","documentation":"Error \"Master Key not set for Proxy. Please set Master Key to use Admin UI. Set `LITELLM_MASTER_KEY` in .env or set general_settings:master_key in config.yaml.  https://docs.litellm.ai/docs/proxy/virtual_keys. If set, use `--detailed_debug` to debug issue.\" thrown in BerriAI/litellm.","triggerScenarios":"Thrown at litellm/proxy/management_endpoints/ui_sso.py:2020 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set LITELLM_MASTER_KEY in .env or general_settings:master_key in config.yaml, then restart; use --detailed_debug if already set."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8","analyzedAt":"2026-08-18T11:44:31.656Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}