mirror of
https://github.com/BerriAI/litellm.git
synced 2026-10-06 02:48:13 +00:00
``handle_oauth2_proxy_request`` reads HTTP request headers per the admin-set ``oauth2_config_mappings`` and constructs a ``UserAPIKeyAuth`` from the values. Two failure modes: 1. **Premium parity.** Sibling auth paths (``enable_oauth2_auth``, ``enable_jwt_auth``) require ``premium_user``; this path did not, so any open-source deployment could turn the feature on without realising it requires a hardened reverse-proxy topology. Added the ``premium_user`` gate. 2. **Privileged-field denylist.** Without a denylist, an admin who maps the wrong header to ``user_role`` (or whose reverse proxy leaks the header from upstream user input) lets any caller send ``X-User-Role: proxy_admin`` and gain full admin access — Pydantic coerces the string into the ``LitellmUserRoles.PROXY_ADMIN`` enum. Mapping any field in ``PRIVILEGED_OAUTH2_PROXY_FIELDS`` (``user_role``, ``api_key``, ``token``, ``permissions``, ``allowed_routes``, budget/limit fields, ``metadata``) raises at request time so the misconfiguration surfaces loudly rather than as a silent privesc. Operators who genuinely need a trusted upstream to assert one of these privileged fields should switch to JWT auth (signature-validated) rather than header-trust. Tests: - ``test_returns_auth_for_simple_user_id_mapping``: legitimate identity-only mapping still works. - ``test_rejects_when_not_premium``: open-source deployments get a clear enterprise-feature error. - ``test_refuses_to_map_privileged_fields``: parametrized over every entry in the denylist — each is rejected at request time. - ``test_user_role_header_forgery_attack_is_blocked``: end-to-end shape of the GHSA-5c3m-qffq-4r9m attack; rejected before auth object construction. - ``test_safe_fields_still_pass_through``: documented usage (``user_id``, ``user_email``, ``team_id``, ``models``) is unaffected. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| agent_tests | ||
| audio_tests | ||
| basic_proxy_startup_tests | ||
| batches_tests | ||
| benchmarks | ||
| code_coverage_tests | ||
| documentation_tests | ||
| enterprise | ||
| guardrails_tests | ||
| image_gen_tests | ||
| litellm | ||
| litellm-proxy-extras | ||
| litellm_core_utils | ||
| litellm_utils_tests | ||
| llm_responses_api_testing | ||
| llm_translation | ||
| load_tests | ||
| local_testing | ||
| logging_callback_tests | ||
| mcp_tests | ||
| multi_instance_e2e_tests | ||
| ocr_tests | ||
| old_proxy_tests/tests | ||
| openai_endpoints_tests | ||
| otel_tests | ||
| pass_through_tests | ||
| pass_through_unit_tests | ||
| proxy_admin_ui_tests | ||
| proxy_e2e_anthropic_messages_tests | ||
| proxy_security_tests | ||
| proxy_unit_tests | ||
| router_unit_tests | ||
| scim_tests | ||
| search_tests | ||
| spend_tracking_tests | ||
| store_model_in_db_tests | ||
| test_litellm | ||
| unified_google_tests | ||
| vector_store_tests | ||
| windows_tests | ||
| __init__.py | ||
| eval_swe_bench.py | ||
| gettysburg.wav | ||
| large_text.py | ||
| openai_batch_completions.jsonl | ||
| README.MD | ||
| test_budget_management.py | ||
| test_callbacks_on_proxy.py | ||
| test_config.py | ||
| test_debug_warning.py | ||
| test_default_encoding_non_root.py | ||
| test_end_users.py | ||
| test_entrypoint.py | ||
| test_fallbacks.py | ||
| test_gpt5_azure_temperature_support.py | ||
| test_health.py | ||
| test_keys.py | ||
| test_litellm_proxy_responses_config.py | ||
| test_logging.conf | ||
| test_models.py | ||
| test_new_vector_store_endpoints.py | ||
| test_openai_endpoints.py | ||
| test_organizations.py | ||
| test_otel_thread_leak.py | ||
| test_passthrough_endpoints.py | ||
| test_presidio_latency.py | ||
| test_proxy_server_non_root.py | ||
| test_ratelimit.py | ||
| test_resource_cleanup.py | ||
| test_service_logger_otel.py | ||
| test_spend_logs.py | ||
| test_team.py | ||
| test_team_logging.py | ||
| test_team_members.py | ||
| test_users.py | ||
In total litellm runs 1000+ tests
[02/20/2025] Update:
To make it easier to contribute and map what behavior is tested,
we've started mapping the litellm directory in tests/test_litellm
This folder can only run mock tests.