codexLB-up 1.25.0b10__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of codexLB-up might be problematic. Click here for more details.
- app/__init__.py +10 -0
- app/admin_cli.py +494 -0
- app/cli.py +339 -0
- app/codex_sessions_retag.py +487 -0
- app/core/__init__.py +0 -0
- app/core/audit/__init__.py +0 -0
- app/core/audit/service.py +216 -0
- app/core/audit/types.py +94 -0
- app/core/auth/__init__.py +236 -0
- app/core/auth/api_key_cache.py +65 -0
- app/core/auth/dashboard_access.py +429 -0
- app/core/auth/dashboard_mode.py +171 -0
- app/core/auth/dashboard_session_ttl.py +74 -0
- app/core/auth/dashboard_users_cache.py +120 -0
- app/core/auth/dependencies.py +710 -0
- app/core/auth/external_identity.py +78 -0
- app/core/auth/guardian.py +374 -0
- app/core/auth/models.py +49 -0
- app/core/auth/providers/__init__.py +129 -0
- app/core/auth/providers/oidc.py +838 -0
- app/core/auth/providers/registry.py +118 -0
- app/core/auth/refresh.py +394 -0
- app/core/auth/step_up.py +117 -0
- app/core/auth/totp.py +81 -0
- app/core/balancer/__init__.py +71 -0
- app/core/balancer/logic.py +1612 -0
- app/core/balancer/rendezvous_hash.py +21 -0
- app/core/balancer/types.py +21 -0
- app/core/bootstrap.py +172 -0
- app/core/cache/invalidation.py +426 -0
- app/core/clients/__init__.py +0 -0
- app/core/clients/codex.py +996 -0
- app/core/clients/codex_version.py +187 -0
- app/core/clients/codex_version_snapshot.py +2 -0
- app/core/clients/files.py +534 -0
- app/core/clients/headers.py +29 -0
- app/core/clients/http.py +511 -0
- app/core/clients/model_fetcher.py +276 -0
- app/core/clients/native_egress.py +1304 -0
- app/core/clients/oauth.py +477 -0
- app/core/clients/proxy.py +6089 -0
- app/core/clients/proxy_websocket.py +1411 -0
- app/core/clients/rate_limit_reset_credits.py +412 -0
- app/core/clients/stream_errors.py +12 -0
- app/core/clients/thread_cache_identity.py +347 -0
- app/core/clients/usage.py +467 -0
- app/core/clock.py +170 -0
- app/core/config/__init__.py +0 -0
- app/core/config/background_jobs.py +73 -0
- app/core/config/context_window_overrides.py +166 -0
- app/core/config/dashboard_overrides.py +145 -0
- app/core/config/inheritable.py +47 -0
- app/core/config/key_fingerprint.py +115 -0
- app/core/config/settings.py +872 -0
- app/core/config/settings_cache.py +100 -0
- app/core/config/spool_retention.py +217 -0
- app/core/config/tiers.py +174 -0
- app/core/conversation_archive.py +568 -0
- app/core/crypto.py +37 -0
- app/core/draining.py +11 -0
- app/core/errors.py +365 -0
- app/core/exceptions.py +155 -0
- app/core/handlers/__init__.py +3 -0
- app/core/handlers/exceptions.py +478 -0
- app/core/http_protocol.py +176 -0
- app/core/http_protocol_httptools.py +204 -0
- app/core/ingress_limits.py +17 -0
- app/core/metadata_store.py +18 -0
- app/core/metrics/__init__.py +0 -0
- app/core/metrics/middleware.py +74 -0
- app/core/metrics/prometheus.py +604 -0
- app/core/middleware/__init__.py +25 -0
- app/core/middleware/api_firewall.py +111 -0
- app/core/middleware/app_version.py +37 -0
- app/core/middleware/dashboard_auth_proxy.py +55 -0
- app/core/middleware/dashboard_csrf.py +177 -0
- app/core/middleware/dashboard_gzip.py +41 -0
- app/core/middleware/dashboard_overrides.py +59 -0
- app/core/middleware/firewall_cache.py +91 -0
- app/core/middleware/inflight.py +126 -0
- app/core/middleware/multipart_content_encoding.py +129 -0
- app/core/middleware/path_rewrite.py +148 -0
- app/core/middleware/request_body_limit.py +196 -0
- app/core/middleware/request_decompression.py +209 -0
- app/core/middleware/request_id.py +72 -0
- app/core/middleware/required_capability_http.py +116 -0
- app/core/middleware/trusted_proxy_headers.py +36 -0
- app/core/multipart.py +237 -0
- app/core/multipart_fields.py +91 -0
- app/core/openai/__init__.py +0 -0
- app/core/openai/chat_requests.py +493 -0
- app/core/openai/chat_responses.py +931 -0
- app/core/openai/contracts.py +46 -0
- app/core/openai/exceptions.py +24 -0
- app/core/openai/host_models.py +14 -0
- app/core/openai/images.py +413 -0
- app/core/openai/message_coercion.py +376 -0
- app/core/openai/model_refresh_scheduler.py +423 -0
- app/core/openai/model_registry.py +997 -0
- app/core/openai/model_registry_store.py +548 -0
- app/core/openai/models.py +172 -0
- app/core/openai/parsing.py +97 -0
- app/core/openai/requests.py +1980 -0
- app/core/openai/strict_schema.py +199 -0
- app/core/openai/tool_call_safety.py +99 -0
- app/core/openai/v1_requests.py +187 -0
- app/core/plan_types.py +90 -0
- app/core/prestop.py +202 -0
- app/core/rate_limiter/__init__.py +0 -0
- app/core/rate_limiter/db_rate_limiter.py +215 -0
- app/core/request_locality.py +473 -0
- app/core/resilience/__init__.py +0 -0
- app/core/resilience/backpressure.py +57 -0
- app/core/resilience/bulkhead.py +202 -0
- app/core/resilience/circuit_breaker.py +150 -0
- app/core/resilience/degradation.py +55 -0
- app/core/resilience/loop_lag_monitor.py +60 -0
- app/core/resilience/memory_monitor.py +137 -0
- app/core/resilience/network_recovery.py +256 -0
- app/core/resilience/overload.py +98 -0
- app/core/resilience/toggles.py +114 -0
- app/core/retention/__init__.py +0 -0
- app/core/retention/job.py +240 -0
- app/core/retention/scheduler.py +69 -0
- app/core/runtime_logging.py +601 -0
- app/core/scheduling/__init__.py +0 -0
- app/core/scheduling/leader_election.py +993 -0
- app/core/scheduling/leader_election_handle.py +25 -0
- app/core/server.py +140 -0
- app/core/shutdown.py +326 -0
- app/core/socket_peer.py +22 -0
- app/core/startup.py +41 -0
- app/core/timeout_invariants.py +347 -0
- app/core/tracing/__init__.py +0 -0
- app/core/tracing/otel.py +207 -0
- app/core/types.py +6 -0
- app/core/upstream_proxy/__init__.py +13 -0
- app/core/upstream_proxy/cache.py +130 -0
- app/core/upstream_proxy/resolver.py +189 -0
- app/core/upstream_proxy/types.py +104 -0
- app/core/usage/__init__.py +407 -0
- app/core/usage/depletion.py +109 -0
- app/core/usage/live_hub.py +41 -0
- app/core/usage/live_snapshots.py +174 -0
- app/core/usage/logs.py +212 -0
- app/core/usage/metadata_scheduler.py +118 -0
- app/core/usage/models.py +54 -0
- app/core/usage/pricing.py +576 -0
- app/core/usage/pricing_catalog.py +241 -0
- app/core/usage/pricing_snapshot.json +821 -0
- app/core/usage/quota.py +133 -0
- app/core/usage/refresh_policy.py +21 -0
- app/core/usage/refresh_scheduler.py +713 -0
- app/core/usage/reset_credits_refresh_scheduler.py +435 -0
- app/core/usage/types.py +168 -0
- app/core/utils/__init__.py +0 -0
- app/core/utils/json_guards.py +18 -0
- app/core/utils/locks.py +33 -0
- app/core/utils/masking.py +20 -0
- app/core/utils/proxy_env.py +104 -0
- app/core/utils/request_id.py +65 -0
- app/core/utils/retry.py +77 -0
- app/core/utils/shared_future.py +172 -0
- app/core/utils/sse.py +286 -0
- app/core/utils/time.py +24 -0
- app/db/__init__.py +0 -0
- app/db/account_identity_lock.py +56 -0
- app/db/alembic/__init__.py +1 -0
- app/db/alembic/env.py +70 -0
- app/db/alembic/revision_ids.py +43 -0
- app/db/alembic/versions/20260213_000000_base_schema.py +248 -0
- app/db/alembic/versions/20260213_000100_normalize_account_plan_types.py +45 -0
- app/db/alembic/versions/20260213_000200_add_request_logs_reasoning_effort.py +45 -0
- app/db/alembic/versions/20260213_000300_add_accounts_reset_at.py +45 -0
- app/db/alembic/versions/20260213_000400_add_accounts_chatgpt_account_id.py +45 -0
- app/db/alembic/versions/20260213_000500_add_dashboard_settings.py +70 -0
- app/db/alembic/versions/20260213_000600_add_dashboard_settings_totp.py +64 -0
- app/db/alembic/versions/20260213_000700_add_dashboard_settings_password.py +59 -0
- app/db/alembic/versions/20260213_000800_add_api_keys.py +87 -0
- app/db/alembic/versions/20260214_000000_add_api_key_limits.py +143 -0
- app/db/alembic/versions/20260215_000000_add_idx_logs_requested_at.py +38 -0
- app/db/alembic/versions/20260218_000000_add_api_key_usage_reservations.py +117 -0
- app/db/alembic/versions/20260218_000100_add_import_without_overwrite_and_drop_accounts_email_unique.py +198 -0
- app/db/alembic/versions/20260225_000000_add_dashboard_settings_routing_strategy.py +53 -0
- app/db/alembic/versions/20260228_020000_align_api_key_limit_enum_types.py +104 -0
- app/db/alembic/versions/20260228_030000_add_api_firewall_allowlist.py +42 -0
- app/db/alembic/versions/20260306_000000_add_request_logs_service_tier.py +45 -0
- app/db/alembic/versions/20260307_000000_add_api_key_enforcement_fields.py +56 -0
- app/db/alembic/versions/20260308_000000_add_sqlite_performance_indexes.py +41 -0
- app/db/alembic/versions/20260309_000000_add_additional_usage_history.py +71 -0
- app/db/alembic/versions/20260309_000000_request_logs_nullable_account_id.py +28 -0
- app/db/alembic/versions/20260310_000000_add_request_logs_transport.py +45 -0
- app/db/alembic/versions/20260310_000000_fix_postgresql_enum_value_casing.py +79 -0
- app/db/alembic/versions/20260310_120000_add_sticky_session_kinds_and_affinity_ttl.py +110 -0
- app/db/alembic/versions/20260312_000000_add_additional_usage_quota_key.py +193 -0
- app/db/alembic/versions/20260312_000000_split_sticky_sessions_primary_key_by_kind.py +96 -0
- app/db/alembic/versions/20260312_010000_merge_additional_usage_and_sticky_session_heads.py +25 -0
- app/db/alembic/versions/20260312_020000_merge_request_logs_transport_and_feature_heads.py +25 -0
- app/db/alembic/versions/20260312_020000_merge_request_logs_transport_and_sticky_heads.py +25 -0
- app/db/alembic/versions/20260312_120000_add_dashboard_upstream_stream_transport.py +62 -0
- app/db/alembic/versions/20260313_024500_merge_request_log_transport_heads.py +27 -0
- app/db/alembic/versions/20260319_100937_increase_prompt_cache_ttl_to_1800s.py +73 -0
- app/db/alembic/versions/20260319_111500_merge_prompt_cache_ttl_and_upstream_transport_heads.py +25 -0
- app/db/alembic/versions/20260319_183000_normalize_sqlite_account_status_casing.py +48 -0
- app/db/alembic/versions/20260320_000000_add_request_log_requested_actual_tiers.py +51 -0
- app/db/alembic/versions/20260321_190000_tighten_dashboard_db_indexes.py +64 -0
- app/db/alembic/versions/20260321_210000_merge_request_log_tiers_and_dashboard_index_heads.py +25 -0
- app/db/alembic/versions/20260325_000000_add_request_log_cost.py +193 -0
- app/db/alembic/versions/20260328_000000_add_rate_limit_attempts.py +48 -0
- app/db/alembic/versions/20260328_120000_add_request_log_ttft.py +37 -0
- app/db/alembic/versions/20260328_130000_add_audit_logs_table.py +45 -0
- app/db/alembic/versions/20260328_140000_add_scheduler_leader_table.py +39 -0
- app/db/alembic/versions/20260330_000000_add_cache_locality_settings.py +69 -0
- app/db/alembic/versions/20260330_010000_merge_scheduler_leader_and_cache_locality_heads.py +25 -0
- app/db/alembic/versions/20260330_020000_add_bridge_ring_members.py +46 -0
- app/db/alembic/versions/20260401_000000_add_api_key_enforced_service_tier.py +52 -0
- app/db/alembic/versions/20260401_000000_add_cache_invalidation.py +41 -0
- app/db/alembic/versions/20260401_020000_merge_cache_invalidation_and_api_key_service_tier_heads.py +22 -0
- app/db/alembic/versions/20260402_000000_switch_dashboard_routing_default_to_capacity_weighted.py +66 -0
- app/db/alembic/versions/20260403_000000_add_credit_api_key_limit_values.py +44 -0
- app/db/alembic/versions/20260406_000000_add_api_key_account_assignments.py +57 -0
- app/db/alembic/versions/20260406_010000_add_api_key_assignment_scope_flag.py +75 -0
- app/db/alembic/versions/20260407_000000_add_bridge_gateway_safe_mode.py +51 -0
- app/db/alembic/versions/20260407_010000_merge_api_key_assignment_and_bridge_gateway_heads.py +25 -0
- app/db/alembic/versions/20260408_000000_switch_import_without_overwrite_default_to_true.py +73 -0
- app/db/alembic/versions/20260408_010000_merge_import_without_overwrite_and_assignment_heads.py +25 -0
- app/db/alembic/versions/20260409_000000_add_http_bridge_sessions.py +130 -0
- app/db/alembic/versions/20260409_000000_switch_sticky_threads_and_prefer_earlier_reset_defaults_to_true.py +89 -0
- app/db/alembic/versions/20260409_010000_add_dashboard_settings_bootstrap_token.py +57 -0
- app/db/alembic/versions/20260409_010000_merge_http_bridge_and_import_without_overwrite_heads.py +25 -0
- app/db/alembic/versions/20260409_020000_fix_http_bridge_last_seen_index.py +46 -0
- app/db/alembic/versions/20260410_000000_backfill_pristine_dashboard_settings_defaults.py +77 -0
- app/db/alembic/versions/20260410_030000_restore_import_without_overwrite_default_true.py +73 -0
- app/db/alembic/versions/20260410_040000_merge_dashboard_defaults_and_import_default_heads.py +25 -0
- app/db/alembic/versions/20260413_000000_add_accounts_blocked_at.py +44 -0
- app/db/alembic/versions/20260415_160000_add_automations_tables.py +189 -0
- app/db/alembic/versions/20260415_160000_add_request_logs_response_lookup_index.py +67 -0
- app/db/alembic/versions/20260417_000000_add_request_log_plan_type.py +44 -0
- app/db/alembic/versions/20260418_190000_add_automation_runs_cycle_key.py +87 -0
- app/db/alembic/versions/20260419_000000_add_automation_run_cycle_metadata.py +56 -0
- app/db/alembic/versions/20260419_020000_add_automation_run_cycles_snapshot_tables.py +342 -0
- app/db/alembic/versions/20260421_000000_add_dashboard_session_ttl_setting.py +51 -0
- app/db/alembic/versions/20260421_120000_merge_request_log_lookup_and_plan_type_heads.py +25 -0
- app/db/alembic/versions/20260421_130000_merge_automation_and_request_log_heads.py +25 -0
- app/db/alembic/versions/20260422_103000_normalize_legacy_automation_run_cycle_keys.py +648 -0
- app/db/alembic/versions/20260423_120000_add_api_key_limit_reset_at_index.py +43 -0
- app/db/alembic/versions/20260424_000000_merge_dashboard_session_ttl_and_request_log_heads.py +25 -0
- app/db/alembic/versions/20260426_000000_add_dashboard_relative_availability_settings.py +68 -0
- app/db/alembic/versions/20260427_130000_add_warmup_model_and_request_kind.py +75 -0
- app/db/alembic/versions/20260506_000000_add_account_routing_policy.py +37 -0
- app/db/alembic/versions/20260509_000000_add_api_key_traffic_class.py +37 -0
- app/db/alembic/versions/20260509_010000_add_additional_quota_routing_policies.py +37 -0
- app/db/alembic/versions/20260513_000000_add_accounts_alias.py +44 -0
- app/db/alembic/versions/20260513_000000_add_api_key_apply_to_codex_model.py +59 -0
- app/db/alembic/versions/20260514_000000_add_request_logs_api_key_time_index.py +43 -0
- app/db/alembic/versions/20260515_000000_add_prefer_earlier_reset_window.py +47 -0
- app/db/alembic/versions/20260515_000000_soft_delete_request_logs_on_account_delete.py +83 -0
- app/db/alembic/versions/20260515_020000_add_split_sticky_budget_thresholds.py +62 -0
- app/db/alembic/versions/20260516_000000_add_sqlite_hot_path_indexes.py +75 -0
- app/db/alembic/versions/20260517_000000_merge_sqlite_hot_path_and_request_log_delete_heads.py +24 -0
- app/db/alembic/versions/20260518_000000_add_http_bridge_durable_input_prefix.py +44 -0
- app/db/alembic/versions/20260518_010000_merge_http_bridge_and_sqlite_recovery_heads.py +25 -0
- app/db/alembic/versions/20260518_120000_add_dashboard_guest_access.py +57 -0
- app/db/alembic/versions/20260520_000000_merge_api_key_and_http_bridge_heads.py +26 -0
- app/db/alembic/versions/20260520_010000_add_request_logs_api_key_account_index.py +45 -0
- app/db/alembic/versions/20260520_010000_merge_automation_and_api_key_heads.py +26 -0
- app/db/alembic/versions/20260520_030000_add_quota_planner.py +194 -0
- app/db/alembic/versions/20260520_040000_merge_quota_planner_and_request_log_index_heads.py +24 -0
- app/db/alembic/versions/20260521_000000_add_account_security_work_authorized.py +46 -0
- app/db/alembic/versions/20260521_000000_merge_dashboard_guest_and_api_key_heads.py +26 -0
- app/db/alembic/versions/20260521_000000_merge_prefer_reset_window_head.py +26 -0
- app/db/alembic/versions/20260521_000000_merge_warmup_and_request_log_index_heads.py +25 -0
- app/db/alembic/versions/20260522_000000_add_limit_warmup_trigger.py +195 -0
- app/db/alembic/versions/20260524_000000_merge_accounts_alias_and_reset_window_heads.py +24 -0
- app/db/alembic/versions/20260525_000000_add_usage_raw_window_latest_index.py +31 -0
- app/db/alembic/versions/20260526_000000_add_request_log_failure_metadata.py +100 -0
- app/db/alembic/versions/20260531_000000_add_account_workspace_identity.py +39 -0
- app/db/alembic/versions/20260531_000000_add_single_account_routing.py +42 -0
- app/db/alembic/versions/20260601_000000_merge_relative_availability_and_usage_raw_heads.py +24 -0
- app/db/alembic/versions/20260601_010000_add_api_key_usage_sections.py +58 -0
- app/db/alembic/versions/20260601_010000_add_routing_policy_persistence.py +67 -0
- app/db/alembic/versions/20260601_010000_merge_security_work_and_relative_availability_heads.py +25 -0
- app/db/alembic/versions/20260601_010000_merge_split_sticky_and_relative_usage_heads.py +25 -0
- app/db/alembic/versions/20260601_010000_merge_warmup_and_relative_availability_heads.py +25 -0
- app/db/alembic/versions/20260601_020000_merge_additional_quota_routing_and_relative_availability_heads.py +25 -0
- app/db/alembic/versions/20260601_020000_merge_quota_planner_and_relative_availability_heads.py +25 -0
- app/db/alembic/versions/20260601_020000_merge_reset_window_and_relative_availability_heads.py +25 -0
- app/db/alembic/versions/20260601_020000_merge_routing_policy_and_split_threshold_heads.py +24 -0
- app/db/alembic/versions/20260601_020000_merge_warmup_and_request_log_failure_heads.py +25 -0
- app/db/alembic/versions/20260601_030000_merge_single_account_and_routing_quota_heads.py +29 -0
- app/db/alembic/versions/20260601_040000_merge_security_work_and_routing_consolidation_heads.py +25 -0
- app/db/alembic/versions/20260601_050000_merge_quota_planner_and_routing_consolidation_heads.py +25 -0
- app/db/alembic/versions/20260602_050000_add_upstream_proxy_routing.py +164 -0
- app/db/alembic/versions/20260602_060000_merge_account_workspace_and_failure_heads.py +25 -0
- app/db/alembic/versions/20260602_070000_add_request_log_useragent_fields.py +86 -0
- app/db/alembic/versions/20260602_070000_merge_quota_planner_and_account_workspace_heads.py +25 -0
- app/db/alembic/versions/20260602_080000_merge_upstream_proxy_and_quota_planner_heads.py +25 -0
- app/db/alembic/versions/20260602_080000_merge_useragent_and_upstream_proxy_heads.py +24 -0
- app/db/alembic/versions/20260603_000000_add_weekly_pace_working_days.py +52 -0
- app/db/alembic/versions/20260603_000000_free_account_monthly_window.py +60 -0
- app/db/alembic/versions/20260604_000000_add_reauth_required_account_status.py +159 -0
- app/db/alembic/versions/20260604_010000_merge_automations_and_reauth_status_heads.py +25 -0
- app/db/alembic/versions/20260604_010000_merge_dashboard_guest_and_reauth_status_heads.py +25 -0
- app/db/alembic/versions/20260604_010000_merge_useragent_and_reauth_heads.py +24 -0
- app/db/alembic/versions/20260607_000000_merge_weekly_monthly_useragent_heads.py +28 -0
- app/db/alembic/versions/20260608_000000_add_hide_upstream_quota_from_api_keys.py +50 -0
- app/db/alembic/versions/20260611_000000_add_request_log_archive_request_id.py +47 -0
- app/db/alembic/versions/20260611_000000_merge_automations_and_weekly_monthly_useragent_heads.py +26 -0
- app/db/alembic/versions/20260611_000000_merge_dashboard_guest_and_weekly_useragent_heads.py +26 -0
- app/db/alembic/versions/20260611_010000_add_request_log_client_ip.py +57 -0
- app/db/alembic/versions/20260611_020000_merge_request_log_archive_and_client_ip_heads.py +26 -0
- app/db/alembic/versions/20260611_030000_merge_dashboard_guest_and_request_log_client_ip_heads.py +26 -0
- app/db/alembic/versions/20260613_000000_add_accounts_codex_installation_id.py +57 -0
- app/db/alembic/versions/20260613_010000_merge_installation_id_and_dashboard_weekly_heads.py +26 -0
- app/db/alembic/versions/20260615_000000_merge_automations_and_dashboard_guest_heads.py +26 -0
- app/db/alembic/versions/20260623_000000_add_limit_warmup_exhausted_threshold.py +51 -0
- app/db/alembic/versions/20260626_000000_add_http_downstream_transport_policy.py +46 -0
- app/db/alembic/versions/20260626_010000_add_request_logs_upstream_transport.py +31 -0
- app/db/alembic/versions/20260629_000000_add_dashboard_query_hot_path_indexes.py +53 -0
- app/db/alembic/versions/20260630_000000_add_limit_warmup_staggered_idle.py +47 -0
- app/db/alembic/versions/20260630_000000_merge_request_log_client_ip_and_dashboard_hot_path_heads.py +26 -0
- app/db/alembic/versions/20260630_010000_merge_warmup_and_request_log_dashboard_heads.py +26 -0
- app/db/alembic/versions/20260630_020000_merge_automations_and_main_heads.py +26 -0
- app/db/alembic/versions/20260630_020000_merge_warmup_threshold_and_main_heads.py +26 -0
- app/db/alembic/versions/20260630_030000_add_automation_run_model_snapshot.py +59 -0
- app/db/alembic/versions/20260630_040000_merge_automation_snapshot_and_warmup_threshold_heads.py +26 -0
- app/db/alembic/versions/20260630_050000_add_automation_run_prompt_snapshot.py +52 -0
- app/db/alembic/versions/20260701_000000_add_weekly_pace_smoothing_minutes.py +51 -0
- app/db/alembic/versions/20260702_000000_add_model_sources.py +176 -0
- app/db/alembic/versions/20260705_000000_add_model_source_audio_transcriptions.py +50 -0
- app/db/alembic/versions/20260705_000000_harden_dashboard_session_ttl.py +62 -0
- app/db/alembic/versions/20260706_000000_add_model_source_audio_per_minute.py +43 -0
- app/db/alembic/versions/20260707_000000_merge_model_sources_and_session_ttl.py +24 -0
- app/db/alembic/versions/20260707_010000_merge_automations_and_model_sources_heads.py +24 -0
- app/db/alembic/versions/20260707_020000_add_automation_job_account_scope.py +125 -0
- app/db/alembic/versions/20260709_000000_add_ttft_phase_observability.py +66 -0
- app/db/alembic/versions/20260711_000000_add_dashboard_prohibit_fast_mode.py +42 -0
- app/db/alembic/versions/20260711_010000_add_account_chatgpt_user_id.py +40 -0
- app/db/alembic/versions/20260711_020000_add_dashboard_account_concurrency_caps.py +71 -0
- app/db/alembic/versions/20260711_030000_add_limit_warmup_idle_threshold.py +51 -0
- app/db/alembic/versions/20260712_010000_add_account_usage_rollups.py +56 -0
- app/db/alembic/versions/20260712_020000_add_api_key_usage_rollups.py +53 -0
- app/db/alembic/versions/20260713_020000_add_model_registry_snapshot.py +42 -0
- app/db/alembic/versions/20260713_040000_add_account_refresh_claims.py +42 -0
- app/db/alembic/versions/20260713_040000_add_replica_guardrails.py +64 -0
- app/db/alembic/versions/20260713_070000_add_reset_credit_redeem_tables.py +58 -0
- app/db/alembic/versions/20260714_000000_add_oauth_flow_states.py +63 -0
- app/db/alembic/versions/20260715_000000_add_request_log_queue_latency.py +44 -0
- app/db/alembic/versions/20260716_000000_add_oauth_device_flow_slots.py +41 -0
- app/db/alembic/versions/20260716_010000_add_dashboard_retention_settings.py +48 -0
- app/db/alembic/versions/20260716_010000_add_reset_credit_display_settings.py +73 -0
- app/db/alembic/versions/20260717_000000_add_http_bridge_retry_circuits.py +47 -0
- app/db/alembic/versions/20260717_000000_merge_retention_and_reset_credit_display_heads.py +26 -0
- app/db/alembic/versions/20260717_000000_optimize_dashboard_hot_path_indexes.py +162 -0
- app/db/alembic/versions/20260717_000001_merge_retry_circuits_and_dashboard_indexes.py +22 -0
- app/db/alembic/versions/20260720_000000_add_request_log_conversation_id.py +57 -0
- app/db/alembic/versions/20260722_000000_backfill_request_log_useragent_families.py +40 -0
- app/db/alembic/versions/20260724_000000_add_request_usage_time_rollups.py +176 -0
- app/db/alembic/versions/20260724_000000_merge_request_log_schema_heads.py +33 -0
- app/db/alembic/versions/20260725_000000_add_http_bridge_pending_tool_calls.py +43 -0
- app/db/alembic/versions/20260726_000000_add_account_plan_downgrade_observations.py +44 -0
- app/db/alembic/versions/20260726_000000_repair_request_usage_rollups_after_merge.py +37 -0
- app/db/alembic/versions/20260727_000000_add_sticky_session_continuity_abandoned_at.py +45 -0
- app/db/alembic/versions/20260728_000000_merge_pending_tool_calls_and_rollup_repair_heads.py +31 -0
- app/db/alembic/versions/20260730_000000_add_api_key_fair_share_threshold.py +44 -0
- app/db/alembic/versions/20260730_000000_add_http_bridge_recovery_attempts.py +60 -0
- app/db/alembic/versions/20260731_000000_add_capability_lineage_markers.py +38 -0
- app/db/alembic/versions/20260803_000000_merge_http_bridge_recovery_and_capability_lineage_heads.py +30 -0
- app/db/alembic/versions/20260804_000000_add_http_bridge_operations.py +63 -0
- app/db/alembic/versions/20260804_000001_add_global_http_bridge_operation_fingerprint.py +53 -0
- app/db/alembic/versions/20260804_230000_add_request_log_connection_request_kind.py +43 -0
- app/db/alembic/versions/20260805_000000_add_http_bridge_operation_spool.py +75 -0
- app/db/alembic/versions/20260805_000001_finalize_http_bridge_operation_spool.py +65 -0
- app/db/alembic/versions/20260806_000000_add_additional_usage_alias_probe_indexes.py +84 -0
- app/db/alembic/versions/20260806_000000_add_anonymous_telemetry.py +49 -0
- app/db/alembic/versions/20260806_010000_add_conversation_presence_rollup.py +72 -0
- app/db/alembic/versions/20260806_020000_add_usage_history_bulk_covering_indexes.py +99 -0
- app/db/alembic/versions/20260806_030000_add_api_key_allowed_reasoning_efforts.py +65 -0
- app/db/alembic/versions/20260806_120000_add_http_bridge_owner_process_epoch.py +57 -0
- app/db/alembic/versions/20260807_000000_merge_http_bridge_operation_spool_and_latest_main.py +24 -0
- app/db/alembic/versions/20260808_000000_tune_usage_history_autovacuum.py +54 -0
- app/db/alembic/versions/20260810_000000_add_http_bridge_recovery_dispatch_count.py +44 -0
- app/db/alembic/versions/20260811_000000_add_hourly_rollup_cancelled_count.py +92 -0
- app/db/alembic/versions/20260812_000000_merge_recovery_dispatch_and_hourly_cancelled_heads.py +25 -0
- app/db/alembic/versions/20260812_120000_add_sticky_abandonment_scope.py +43 -0
- app/db/alembic/versions/20260813_000000_add_file_account_pins.py +40 -0
- app/db/alembic/versions/20260816_000000_add_account_pending_deletion.py +81 -0
- app/db/alembic/versions/20260816_000000_add_model_source_embeddings.py +50 -0
- app/db/alembic/versions/20260821_000000_add_retry_circuit_admission_generation.py +49 -0
- app/db/alembic/versions/20260826_000000_add_http_bridge_event_chunks.py +107 -0
- app/db/alembic/versions/20260828_000000_add_accounts_chatgpt_identity_index.py +55 -0
- app/db/alembic/versions/20260830_000000_add_quota_warmup_claim_expiry.py +83 -0
- app/db/alembic/versions/20260908_000000_add_guest_session_generation.py +37 -0
- app/db/alembic/versions/20260908_000000_add_subscription_overflow.py +140 -0
- app/db/alembic/versions/20260908_000000_replace_upstream_stream_transport_default_sentinel.py +50 -0
- app/db/alembic/versions/20260908_020000_merge_overflow_transport_heads.py +27 -0
- app/db/alembic/versions/20260909_000000_add_dashboard_roles.py +72 -0
- app/db/alembic/versions/20260909_010000_add_dashboard_users.py +183 -0
- app/db/alembic/versions/20260909_020000_reproject_compat_admin_credentials.py +105 -0
- app/db/alembic/versions/20260909_030000_add_audit_actor_columns.py +103 -0
- app/db/alembic/versions/20260909_030000_dashboard_resilience_toggle_settings.py +63 -0
- app/db/alembic/versions/20260909_040000_add_dashboard_user_invites.py +54 -0
- app/db/alembic/versions/20260909_040000_dashboard_timeout_settings.py +68 -0
- app/db/alembic/versions/20260909_050000_dashboard_routing_overload_settings.py +65 -0
- app/db/alembic/versions/20260909_060000_add_report_rollup.py +74 -0
- app/db/alembic/versions/20260909_070000_automation_run_claim_budget.py +50 -0
- app/db/alembic/versions/20260909_080000_dashboard_stream_bridge_budgets.py +62 -0
- app/db/alembic/versions/20260909_090000_dashboard_background_job_toggles.py +63 -0
- app/db/alembic/versions/20260909_100000_dashboard_codex_prewarm.py +49 -0
- app/db/alembic/versions/20260909_110000_model_context_window_overrides.py +45 -0
- app/db/alembic/versions/20260909_120000_dashboard_conversation_archive.py +48 -0
- app/db/alembic/versions/20260909_130000_add_request_logs_live_facet_indexes.py +96 -0
- app/db/alembic/versions/20260910_000000_add_totp_required_for_admin_role.py +44 -0
- app/db/alembic/versions/20260910_000000_request_logs_missing_cost_index.py +52 -0
- app/db/alembic/versions/20260910_010000_add_dashboard_auth_providers.py +134 -0
- app/db/alembic/versions/20260910_010000_dashboard_spool_retention.py +52 -0
- app/db/alembic/versions/20260910_020000_add_dashboard_role_mappings.py +74 -0
- app/db/alembic/versions/20260910_143000_request_log_affinity.py +28 -0
- app/db/alembic/versions/20260910_180000_merge_affinity_guest_heads.py +17 -0
- app/db/alembic/versions/20260910_200000_merge_affinity_identity_heads.py +17 -0
- app/db/alembic/versions/20260910_220000_merge_affinity_invite_heads.py +17 -0
- app/db/alembic/versions/20260911_000000_model_source_pins_kind_expires_index.py +43 -0
- app/db/alembic/versions/20260911_010000_merge_pin_index_and_affinity_heads.py +17 -0
- app/db/alembic/versions/20260911_020000_add_http_bridge_terminal_append_phase.py +54 -0
- app/db/alembic/versions/20260911_030000_add_local_login_policy.py +48 -0
- app/db/alembic/versions/20260911_040000_add_thread_cache_identity_mode.py +48 -0
- app/db/alembic/versions/20260911_060000_add_bridge_session_continuity_abandonment.py +40 -0
- app/db/alembic/versions/20260912_000000_merge_thread_cache_and_bridge_retirement_heads.py +22 -0
- app/db/alembic/versions/20260912_010000_drop_legacy_dashboard_credentials.py +140 -0
- app/db/alembic/versions/20260913_000000_add_oidc_provider_flow.py +134 -0
- app/db/alembic/versions/20260914_000000_add_scim_tokens.py +78 -0
- app/db/alembic/versions/20260914_000000_drop_subscription_overflow_schema.py +132 -0
- app/db/alembic/versions/20260918_000000_merge_scim_and_overflow_heads.py +17 -0
- app/db/alembic/versions/__init__.py +1 -0
- app/db/backup.py +64 -0
- app/db/migrate.py +1249 -0
- app/db/migration_lock.py +160 -0
- app/db/migration_url.py +18 -0
- app/db/models.py +3100 -0
- app/db/recover.py +244 -0
- app/db/session.py +1295 -0
- app/db/snapshot.py +46 -0
- app/db/sqlite_lock_retry.py +190 -0
- app/db/sqlite_utils.py +549 -0
- app/dependencies.py +462 -0
- app/main.py +1240 -0
- app/modules/__init__.py +0 -0
- app/modules/accounts/__init__.py +0 -0
- app/modules/accounts/api.py +426 -0
- app/modules/accounts/auth_manager.py +1439 -0
- app/modules/accounts/background_repository.py +160 -0
- app/modules/accounts/deletion.py +540 -0
- app/modules/accounts/mappers.py +654 -0
- app/modules/accounts/refresh_claims.py +352 -0
- app/modules/accounts/repository.py +1679 -0
- app/modules/accounts/schemas.py +308 -0
- app/modules/accounts/service.py +809 -0
- app/modules/accounts/usage_rollup.py +486 -0
- app/modules/accounts/usage_rollup_scheduler.py +75 -0
- app/modules/accounts/usage_time_rollup.py +1037 -0
- app/modules/accounts/usage_time_rollup_read.py +522 -0
- app/modules/api_keys/__init__.py +1 -0
- app/modules/api_keys/api.py +344 -0
- app/modules/api_keys/last_used_coalescer.py +216 -0
- app/modules/api_keys/limit_windows.py +41 -0
- app/modules/api_keys/repository.py +1200 -0
- app/modules/api_keys/reset_scheduler.py +85 -0
- app/modules/api_keys/schemas.py +135 -0
- app/modules/api_keys/service.py +2123 -0
- app/modules/audit/__init__.py +0 -0
- app/modules/audit/api.py +88 -0
- app/modules/audit/repository.py +74 -0
- app/modules/audit/schemas.py +33 -0
- app/modules/audit/service.py +71 -0
- app/modules/auth_providers/__init__.py +0 -0
- app/modules/auth_providers/api.py +127 -0
- app/modules/auth_providers/config.py +343 -0
- app/modules/auth_providers/repository.py +101 -0
- app/modules/auth_providers/schemas.py +88 -0
- app/modules/auth_providers/seed.py +105 -0
- app/modules/auth_providers/service.py +289 -0
- app/modules/automations/__init__.py +1 -0
- app/modules/automations/api.py +369 -0
- app/modules/automations/repository.py +1896 -0
- app/modules/automations/scheduler.py +107 -0
- app/modules/automations/schemas.py +158 -0
- app/modules/automations/service.py +2548 -0
- app/modules/cache_isolation_probe/__init__.py +0 -0
- app/modules/cache_isolation_probe/api.py +188 -0
- app/modules/cache_isolation_probe/prefix.py +144 -0
- app/modules/cache_isolation_probe/schemas.py +94 -0
- app/modules/cache_isolation_probe/sender.py +229 -0
- app/modules/cache_isolation_probe/service.py +525 -0
- app/modules/conversation_archive/__init__.py +1 -0
- app/modules/conversation_archive/api.py +101 -0
- app/modules/conversation_archive/schemas.py +28 -0
- app/modules/conversation_archive/service.py +165 -0
- app/modules/dashboard/__init__.py +1 -0
- app/modules/dashboard/api.py +106 -0
- app/modules/dashboard/builders.py +107 -0
- app/modules/dashboard/repository.py +304 -0
- app/modules/dashboard/schemas.py +148 -0
- app/modules/dashboard/service.py +534 -0
- app/modules/dashboard/timeframes.py +19 -0
- app/modules/dashboard/weekly_pace.py +617 -0
- app/modules/dashboard_auth/__init__.py +1 -0
- app/modules/dashboard_auth/api.py +1344 -0
- app/modules/dashboard_auth/oidc_api.py +753 -0
- app/modules/dashboard_auth/oidc_flows.py +330 -0
- app/modules/dashboard_auth/repository.py +452 -0
- app/modules/dashboard_auth/schemas.py +232 -0
- app/modules/dashboard_auth/service.py +1384 -0
- app/modules/dashboard_roles/__init__.py +0 -0
- app/modules/dashboard_roles/api.py +64 -0
- app/modules/dashboard_roles/repository.py +54 -0
- app/modules/dashboard_roles/schemas.py +29 -0
- app/modules/dashboard_roles/seed.py +80 -0
- app/modules/dashboard_roles/service.py +142 -0
- app/modules/dashboard_users/__init__.py +0 -0
- app/modules/dashboard_users/api.py +278 -0
- app/modules/dashboard_users/break_glass.py +169 -0
- app/modules/dashboard_users/credentials.py +18 -0
- app/modules/dashboard_users/identity_resolver.py +665 -0
- app/modules/dashboard_users/repository.py +725 -0
- app/modules/dashboard_users/schemas.py +117 -0
- app/modules/dashboard_users/service.py +1054 -0
- app/modules/firewall/__init__.py +1 -0
- app/modules/firewall/api.py +78 -0
- app/modules/firewall/repository.py +51 -0
- app/modules/firewall/schemas.py +28 -0
- app/modules/firewall/service.py +93 -0
- app/modules/fleet/__init__.py +1 -0
- app/modules/fleet/api.py +177 -0
- app/modules/fleet/mappers.py +56 -0
- app/modules/fleet/observability.py +372 -0
- app/modules/fleet/schemas.py +119 -0
- app/modules/health/__init__.py +0 -0
- app/modules/health/api.py +246 -0
- app/modules/health/schemas.py +27 -0
- app/modules/limit_warmup/__init__.py +1 -0
- app/modules/limit_warmup/repository.py +159 -0
- app/modules/limit_warmup/service.py +1001 -0
- app/modules/model_sources/__init__.py +1 -0
- app/modules/model_sources/api.py +99 -0
- app/modules/model_sources/catalog.py +307 -0
- app/modules/model_sources/forwarding.py +1435 -0
- app/modules/model_sources/projection.py +55 -0
- app/modules/model_sources/repository.py +201 -0
- app/modules/model_sources/schemas.py +79 -0
- app/modules/model_sources/selection.py +166 -0
- app/modules/model_sources/service.py +236 -0
- app/modules/oauth/__init__.py +0 -0
- app/modules/oauth/api.py +101 -0
- app/modules/oauth/repository.py +238 -0
- app/modules/oauth/schemas.py +49 -0
- app/modules/oauth/service.py +1196 -0
- app/modules/oauth/templates/oauth_success.html +122 -0
- app/modules/proxy/__init__.py +0 -0
- app/modules/proxy/_load_balancer/__init__.py +1 -0
- app/modules/proxy/_load_balancer/error_rate.py +116 -0
- app/modules/proxy/_load_balancer/latency_cohort.py +154 -0
- app/modules/proxy/_load_balancer/model_eligibility.py +250 -0
- app/modules/proxy/_load_balancer/opportunistic_admission.py +350 -0
- app/modules/proxy/_load_balancer/overload_backoff.py +394 -0
- app/modules/proxy/_load_balancer/sticky_selection.py +2417 -0
- app/modules/proxy/_load_balancer/throughput_cohort.py +233 -0
- app/modules/proxy/_load_balancer/ttft_cohort.py +214 -0
- app/modules/proxy/_load_balancer/tunables.py +97 -0
- app/modules/proxy/_load_balancer/types.py +96 -0
- app/modules/proxy/_load_balancer/unbound_selection.py +534 -0
- app/modules/proxy/_service/__init__.py +6 -0
- app/modules/proxy/_service/api_key_usage.py +745 -0
- app/modules/proxy/_service/clock_budget.py +38 -0
- app/modules/proxy/_service/codex_control.py +611 -0
- app/modules/proxy/_service/compact.py +2211 -0
- app/modules/proxy/_service/file_ops.py +749 -0
- app/modules/proxy/_service/http_bridge/__init__.py +3 -0
- app/modules/proxy/_service/http_bridge/accepted_replay.py +331 -0
- app/modules/proxy/_service/http_bridge/account_sessions.py +57 -0
- app/modules/proxy/_service/http_bridge/activity.py +178 -0
- app/modules/proxy/_service/http_bridge/helpers.py +3959 -0
- app/modules/proxy/_service/http_bridge/mixin.py +2435 -0
- app/modules/proxy/_service/http_bridge/owner_forwarding.py +609 -0
- app/modules/proxy/_service/http_bridge/protocol.py +167 -0
- app/modules/proxy/_service/http_bridge/proxy_failover.py +58 -0
- app/modules/proxy/_service/http_bridge/quarantine.py +443 -0
- app/modules/proxy/_service/http_bridge/request_submit.py +4582 -0
- app/modules/proxy/_service/http_bridge/retry_circuit.py +2442 -0
- app/modules/proxy/_service/http_bridge/service_stubs.py +492 -0
- app/modules/proxy/_service/http_bridge/session_registry.py +778 -0
- app/modules/proxy/_service/http_bridge/streaming.py +5328 -0
- app/modules/proxy/_service/http_bridge/upstream_events.py +4538 -0
- app/modules/proxy/_service/observability.py +410 -0
- app/modules/proxy/_service/rate_limit.py +361 -0
- app/modules/proxy/_service/realtime_live.py +655 -0
- app/modules/proxy/_service/refresh.py +154 -0
- app/modules/proxy/_service/request_log.py +585 -0
- app/modules/proxy/_service/response_create.py +930 -0
- app/modules/proxy/_service/streaming/__init__.py +3 -0
- app/modules/proxy/_service/streaming/helpers.py +1317 -0
- app/modules/proxy/_service/streaming/mixin.py +1100 -0
- app/modules/proxy/_service/streaming/protocol.py +32 -0
- app/modules/proxy/_service/streaming/retry.py +3762 -0
- app/modules/proxy/_service/support.py +2122 -0
- app/modules/proxy/_service/transcribe.py +434 -0
- app/modules/proxy/_service/warmup.py +483 -0
- app/modules/proxy/_service/websocket/__init__.py +3 -0
- app/modules/proxy/_service/websocket/helpers.py +2360 -0
- app/modules/proxy/_service/websocket/mixin.py +7285 -0
- app/modules/proxy/_service/websocket/protocol.py +74 -0
- app/modules/proxy/account_cache.py +229 -0
- app/modules/proxy/account_eligibility.py +87 -0
- app/modules/proxy/additional_model_limits.py +40 -0
- app/modules/proxy/affinity.py +830 -0
- app/modules/proxy/affinity_observation.py +101 -0
- app/modules/proxy/api.py +10254 -0
- app/modules/proxy/api_key_usage.py +113 -0
- app/modules/proxy/cap_partitioning.py +280 -0
- app/modules/proxy/capability_lineage.py +65 -0
- app/modules/proxy/capability_lineage_repository.py +82 -0
- app/modules/proxy/capability_routing.py +253 -0
- app/modules/proxy/continuity.py +112 -0
- app/modules/proxy/downstream_delivery.py +277 -0
- app/modules/proxy/durable_bridge_coordinator.py +1217 -0
- app/modules/proxy/durable_bridge_repository.py +4516 -0
- app/modules/proxy/durable_bridge_runtime.py +9 -0
- app/modules/proxy/durable_bridge_transcript_codec.py +122 -0
- app/modules/proxy/fair_share.py +131 -0
- app/modules/proxy/file_pin_repository.py +210 -0
- app/modules/proxy/helpers.py +439 -0
- app/modules/proxy/http_bridge_event_batcher.py +613 -0
- app/modules/proxy/http_bridge_forwarding.py +797 -0
- app/modules/proxy/http_continuation.py +76 -0
- app/modules/proxy/images_observability.py +62 -0
- app/modules/proxy/images_service.py +1054 -0
- app/modules/proxy/load_balancer.py +3016 -0
- app/modules/proxy/rate_limit_cache.py +46 -0
- app/modules/proxy/replay_safety.py +1063 -0
- app/modules/proxy/repo_bundle.py +31 -0
- app/modules/proxy/request_policy.py +1054 -0
- app/modules/proxy/ring_membership.py +251 -0
- app/modules/proxy/schemas.py +345 -0
- app/modules/proxy/selection_errors.py +41 -0
- app/modules/proxy/service.py +2600 -0
- app/modules/proxy/source_admission.py +125 -0
- app/modules/proxy/source_dispatch.py +999 -0
- app/modules/proxy/sticky_repository.py +831 -0
- app/modules/proxy/thread_anchors.py +491 -0
- app/modules/proxy/tool_call_dedupe.py +802 -0
- app/modules/proxy/types.py +54 -0
- app/modules/proxy/work_admission.py +121 -0
- app/modules/quota_planner/__init__.py +1 -0
- app/modules/quota_planner/api.py +276 -0
- app/modules/quota_planner/logic.py +743 -0
- app/modules/quota_planner/repository.py +722 -0
- app/modules/quota_planner/scheduler.py +212 -0
- app/modules/quota_planner/schemas.py +102 -0
- app/modules/quota_planner/warmup.py +693 -0
- app/modules/rate_limit_reset_credits/__init__.py +0 -0
- app/modules/rate_limit_reset_credits/api.py +601 -0
- app/modules/rate_limit_reset_credits/redeem_coordination.py +274 -0
- app/modules/rate_limit_reset_credits/store.py +114 -0
- app/modules/reports/__init__.py +1 -0
- app/modules/reports/api.py +134 -0
- app/modules/reports/cache.py +74 -0
- app/modules/reports/filters.py +27 -0
- app/modules/reports/repository.py +525 -0
- app/modules/reports/rollup.py +150 -0
- app/modules/reports/rollup_read.py +148 -0
- app/modules/reports/schemas.py +123 -0
- app/modules/reports/service.py +287 -0
- app/modules/reports/thread_identity.py +256 -0
- app/modules/request_logs/__init__.py +0 -0
- app/modules/request_logs/api.py +224 -0
- app/modules/request_logs/cost_backfill.py +154 -0
- app/modules/request_logs/mappers.py +97 -0
- app/modules/request_logs/repository.py +1765 -0
- app/modules/request_logs/schemas.py +145 -0
- app/modules/request_logs/service.py +348 -0
- app/modules/role_mappings/__init__.py +0 -0
- app/modules/role_mappings/api.py +206 -0
- app/modules/role_mappings/matching.py +55 -0
- app/modules/role_mappings/repository.py +106 -0
- app/modules/role_mappings/schemas.py +67 -0
- app/modules/role_mappings/service.py +334 -0
- app/modules/runtime/__init__.py +1 -0
- app/modules/runtime/api.py +18 -0
- app/modules/runtime/schemas.py +14 -0
- app/modules/runtime/service.py +218 -0
- app/modules/scim/__init__.py +1 -0
- app/modules/scim/api.py +194 -0
- app/modules/scim/dependencies.py +112 -0
- app/modules/scim/errors.py +77 -0
- app/modules/scim/management_api.py +156 -0
- app/modules/scim/repository.py +212 -0
- app/modules/scim/schemas.py +145 -0
- app/modules/scim/service.py +786 -0
- app/modules/scim/tokens.py +43 -0
- app/modules/settings/__init__.py +1 -0
- app/modules/settings/api.py +1677 -0
- app/modules/settings/repository.py +606 -0
- app/modules/settings/schemas.py +496 -0
- app/modules/settings/service.py +769 -0
- app/modules/shared/__init__.py +0 -0
- app/modules/shared/schemas.py +22 -0
- app/modules/sticky_sessions/__init__.py +1 -0
- app/modules/sticky_sessions/api.py +118 -0
- app/modules/sticky_sessions/cleanup_scheduler.py +487 -0
- app/modules/sticky_sessions/schemas.py +78 -0
- app/modules/sticky_sessions/service.py +196 -0
- app/modules/telemetry/__init__.py +5 -0
- app/modules/telemetry/api.py +115 -0
- app/modules/telemetry/clients.py +62 -0
- app/modules/telemetry/consent.py +115 -0
- app/modules/telemetry/scheduler.py +85 -0
- app/modules/telemetry/schemas.py +163 -0
- app/modules/telemetry/sender.py +221 -0
- app/modules/telemetry/snapshot.py +490 -0
- app/modules/usage/__init__.py +0 -0
- app/modules/usage/additional_quota_keys.py +379 -0
- app/modules/usage/api.py +45 -0
- app/modules/usage/background_repository.py +147 -0
- app/modules/usage/builders.py +559 -0
- app/modules/usage/depletion_service.py +277 -0
- app/modules/usage/live_ingest.py +356 -0
- app/modules/usage/mappers.py +29 -0
- app/modules/usage/plan_downgrade_observations.py +488 -0
- app/modules/usage/repository.py +1890 -0
- app/modules/usage/schemas.py +68 -0
- app/modules/usage/service.py +102 -0
- app/modules/usage/updater.py +1488 -0
- app/static/assets/Trans-Cj-J9mVA.js +1 -0
- app/static/assets/access-page-DHzZiXZi.js +1 -0
- app/static/assets/account-cost-donut-DGhfA4U8.js +1 -0
- app/static/assets/account-identifiers-CxbdLshZ.js +1 -0
- app/static/assets/account-status-DIsU5sUS.js +1 -0
- app/static/assets/account-trend-chart-BptlfwwQ.js +1 -0
- app/static/assets/accounts-page-Bbai8ift.js +3 -0
- app/static/assets/api-Dwa7XxPe.js +1 -0
- app/static/assets/api-client-dugX1Pti.js +55 -0
- app/static/assets/api-key-create-dialog-DnRm0oYN.js +1 -0
- app/static/assets/api-key-created-dialog-B6jkDG9f.js +1 -0
- app/static/assets/api-key-edit-dialog-Ck3Bnc3V.js +1 -0
- app/static/assets/api-trend-chart-BchCw7Hj.js +1 -0
- app/static/assets/apis-page-BvXz9c6i.js +2 -0
- app/static/assets/arrow-up-Dqh_KzJo.js +1 -0
- app/static/assets/arrow-up-down-LBRgVDGY.js +1 -0
- app/static/assets/automations-page-DQgNAJOR.js +3 -0
- app/static/assets/badge-DqMb9es0.js +1 -0
- app/static/assets/blur-email-HEvKagG2.js +1 -0
- app/static/assets/button-BjVmmiGW.js +1 -0
- app/static/assets/checkbox-apsl9vzk.js +1 -0
- app/static/assets/chevron-left-1d_pHVa5.js +1 -0
- app/static/assets/circle-alert-BS0xd_o1.js +1 -0
- app/static/assets/clsx-DB0hHKMi.js +1 -0
- app/static/assets/colors-BBy8GEtr.js +1 -0
- app/static/assets/copy-button-D7nAvOKR.js +1 -0
- app/static/assets/cost-per-day-chart-YdqlkZVM.js +1 -0
- app/static/assets/createLucideIcon-DBLzLNh2.js +1 -0
- app/static/assets/dashboard-page-CSdhBy0f.js +2 -0
- app/static/assets/distribution-metric-format-yZTy1ZEu.js +1 -0
- app/static/assets/donut-chart-Bxc69cra.js +1 -0
- app/static/assets/download-kQteIcsB.js +1 -0
- app/static/assets/ellipsis-B_5OgIre.js +1 -0
- app/static/assets/empty-state-JcA7tc8m.js +1 -0
- app/static/assets/es2015-bMH8YKZT.js +41 -0
- app/static/assets/es6-B264ni6W.js +69 -0
- app/static/assets/external-link-UVAOgMQ0.js +1 -0
- app/static/assets/i18n-BWqZ9Ua2.js +1 -0
- app/static/assets/inbox-B_RM2s1J.js +1 -0
- app/static/assets/index-DIpd264Z.js +23 -0
- app/static/assets/index-DMeLKRJx.css +2 -0
- app/static/assets/inherit-badge-QhTYVaU6.js +1 -0
- app/static/assets/invite-dialog-0CYh0GiQ.js +1 -0
- app/static/assets/iso-Bpe5Ihbb.js +1 -0
- app/static/assets/label-CGaLmLNf.js +1 -0
- app/static/assets/lazy-recharts-Pv8p9ArM.js +2 -0
- app/static/assets/loading-overlay-CzKQfHLI.js +1 -0
- app/static/assets/mini-quota-bar-cGT_t8Ae.js +1 -0
- app/static/assets/model-distribution-donut-BKjAfT48.js +1 -0
- app/static/assets/model-source-multi-select-D2d06Vc7.js +1 -0
- app/static/assets/multi-select-filter-KIA5qU6Z.js +1 -0
- app/static/assets/oauth-dialog-XeaGGDjS.js +1 -0
- app/static/assets/pagination-controls-D1Ypd0RU.js +1 -0
- app/static/assets/payload-CIYnGZz9.js +1 -0
- app/static/assets/queue-wait-chart-VoV7Yg9L.js +1 -0
- app/static/assets/report-chart-card-BXDliwcc.js +1 -0
- app/static/assets/reports-page-CGCJeMHG.js +3 -0
- app/static/assets/reset-credit-confirm-dialog-QOifTnVB.js +1 -0
- app/static/assets/rolldown-runtime-hePW80VL.js +1 -0
- app/static/assets/search-HfhqwERt.js +1 -0
- app/static/assets/select-Cl33bz-g.js +1 -0
- app/static/assets/settings-page-mZj01HYl.js +2 -0
- app/static/assets/shim-CZwyM4Q7.js +1 -0
- app/static/assets/skeleton-C_EUc4Rp.js +1 -0
- app/static/assets/sparkline-chart-DdNNsddM.js +1 -0
- app/static/assets/status-badge-CHHA5X6c.js +1 -0
- app/static/assets/switch-CzxgokcM.js +1 -0
- app/static/assets/table-DXaNSQ0G.js +1 -0
- app/static/assets/time-to-first-token-chart--68L0u_v.js +1 -0
- app/static/assets/tokens-per-day-chart-Cs82BFuE.js +1 -0
- app/static/assets/tokens-per-second-chart-AD2dfOn6.js +1 -0
- app/static/assets/totp-settings-CRHtxQ7j.js +1 -0
- app/static/assets/trash-D3KyWr1h.js +1 -0
- app/static/assets/use-account-quota-display-BPmrTBTC.js +1 -0
- app/static/assets/use-accounts-PWlVGw3z.js +1 -0
- app/static/assets/use-auth-CuDlW3iC.js +1 -0
- app/static/assets/use-chart-colors-DIu6tClI.js +1 -0
- app/static/assets/use-model-sources-Bul24JBu.js +1 -0
- app/static/assets/use-models-DUCPUuZg.js +1 -0
- app/static/assets/use-reduced-motion-hAm5r6_d.js +1 -0
- app/static/assets/useTranslation--56nHhlH.js +1 -0
- app/static/assets/useragent-distribution-donut-Dup6sf_n.js +1 -0
- app/static/assets/users-uIC3TIlE.js +1 -0
- app/static/assets/vendor-query-_bHZuxEx.js +1 -0
- app/static/assets/vendor-react-BVL0YZPW.js +9 -0
- app/static/favicon.svg +10 -0
- app/static/fonts/GeistSans-Variable.woff2 +0 -0
- app/static/fonts/jetbrains-mono-latin-ext.woff2 +0 -0
- app/static/fonts/jetbrains-mono-latin.woff2 +0 -0
- app/static/index.html +29 -0
- codexlb_up-1.25.0b10.dist-info/METADATA +124 -0
- codexlb_up-1.25.0b10.dist-info/RECORD +827 -0
- codexlb_up-1.25.0b10.dist-info/WHEEL +4 -0
- codexlb_up-1.25.0b10.dist-info/entry_points.txt +3 -0
- codexlb_up-1.25.0b10.dist-info/licenses/LICENSE +21 -0
- config/additional_quota_registry.json +11 -0
|
@@ -0,0 +1,1054 @@
|
|
|
1
|
+
"""Account management: invite, edit, disable (with the owned-key cascade), delete, invite lifecycle.
|
|
2
|
+
|
|
3
|
+
Every mutation is attributed to the calling principal (``AuditActor``), bumps
|
|
4
|
+
the ``dashboard_users`` cache namespace so peers drop their copy, and applies
|
|
5
|
+
the invariants in one place: no self role/status change, at least one active
|
|
6
|
+
admin preset, delegation subset checks, and the credential-required rule.
|
|
7
|
+
"""
|
|
8
|
+
|
|
9
|
+
from __future__ import annotations
|
|
10
|
+
|
|
11
|
+
import hashlib
|
|
12
|
+
import secrets
|
|
13
|
+
import uuid
|
|
14
|
+
from collections.abc import Sequence
|
|
15
|
+
from dataclasses import dataclass
|
|
16
|
+
from datetime import UTC, datetime, timedelta
|
|
17
|
+
|
|
18
|
+
from sqlalchemy.exc import IntegrityError
|
|
19
|
+
|
|
20
|
+
import app.modules.dashboard_users.repository as users_repository
|
|
21
|
+
from app.core.audit.service import AuditActor, AuditDetails, AuditService, AuditSeverity, AuditTarget
|
|
22
|
+
from app.core.auth.api_key_cache import get_api_key_cache
|
|
23
|
+
from app.core.auth.dashboard_access import (
|
|
24
|
+
PRESET_ROLE_IDS,
|
|
25
|
+
DashboardPrincipal,
|
|
26
|
+
PresetRoleSlug,
|
|
27
|
+
assert_can_act_on,
|
|
28
|
+
assert_can_delegate,
|
|
29
|
+
)
|
|
30
|
+
from app.core.auth.dashboard_users_cache import get_dashboard_users_cache
|
|
31
|
+
from app.core.auth.providers.registry import get_auth_provider_registry
|
|
32
|
+
from app.core.cache.invalidation import NAMESPACE_API_KEY, get_cache_invalidation_poller
|
|
33
|
+
from app.core.config.settings import get_settings
|
|
34
|
+
from app.core.utils.time import utcnow
|
|
35
|
+
from app.db.models import (
|
|
36
|
+
COMPAT_ADMIN_USERNAME,
|
|
37
|
+
AuthProviderKind,
|
|
38
|
+
DashboardRoleRecord,
|
|
39
|
+
DashboardUser,
|
|
40
|
+
DashboardUserInvite,
|
|
41
|
+
DashboardUserRoleSource,
|
|
42
|
+
DashboardUserStatus,
|
|
43
|
+
)
|
|
44
|
+
from app.modules.dashboard_auth.repository import DashboardAuthRepository
|
|
45
|
+
from app.modules.dashboard_roles.repository import DashboardRolesRepository
|
|
46
|
+
from app.modules.dashboard_roles.service import resolve_assignable_role, resolve_role_grants
|
|
47
|
+
from app.modules.dashboard_users.break_glass import (
|
|
48
|
+
BreakGlassRoleRequiredError,
|
|
49
|
+
LastBreakGlassProtectedError,
|
|
50
|
+
assert_break_glass_remains,
|
|
51
|
+
is_admin_preset,
|
|
52
|
+
)
|
|
53
|
+
from app.modules.dashboard_users.credentials import assert_credential_remains
|
|
54
|
+
from app.modules.dashboard_users.repository import (
|
|
55
|
+
DashboardUsersRepository,
|
|
56
|
+
is_valid_email,
|
|
57
|
+
is_valid_username,
|
|
58
|
+
normalize_email,
|
|
59
|
+
normalize_username,
|
|
60
|
+
)
|
|
61
|
+
from app.modules.dashboard_users.schemas import (
|
|
62
|
+
DashboardUserCreateRequest,
|
|
63
|
+
DashboardUserUpdateRequest,
|
|
64
|
+
ExpectedIdentityRequest,
|
|
65
|
+
ProfileUpdateRequest,
|
|
66
|
+
)
|
|
67
|
+
|
|
68
|
+
INVITE_TTL = timedelta(hours=24)
|
|
69
|
+
_AUTH_METHOD_PASSWORD = "password"
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
class AdminAccountRequiredError(ValueError):
|
|
73
|
+
pass
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
class UserNotFoundError(LookupError):
|
|
77
|
+
pass
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
class UsernameTakenError(ValueError):
|
|
81
|
+
pass
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
class EmailTakenError(ValueError):
|
|
85
|
+
pass
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
class InvalidUsernameError(ValueError):
|
|
89
|
+
pass
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
class InvalidEmailError(ValueError):
|
|
93
|
+
pass
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
class SelfModificationForbiddenError(ValueError):
|
|
97
|
+
pass
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
class LastAdminProtectedError(ValueError):
|
|
101
|
+
pass
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
class InviteNotPendingError(ValueError):
|
|
105
|
+
pass
|
|
106
|
+
|
|
107
|
+
|
|
108
|
+
class InvitePendingError(ValueError):
|
|
109
|
+
pass
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
class InviteNotFoundError(LookupError):
|
|
113
|
+
pass
|
|
114
|
+
|
|
115
|
+
|
|
116
|
+
class UsernameLockedError(ValueError):
|
|
117
|
+
pass
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
class UserNotActiveError(ValueError):
|
|
121
|
+
pass
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
class RoleManagedExternallyError(ValueError):
|
|
125
|
+
pass
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
class ForceWithoutRoleChangeError(ValueError):
|
|
129
|
+
pass
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
class SsoNotAvailableError(ValueError):
|
|
133
|
+
pass
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
class IdentityTakenError(ValueError):
|
|
137
|
+
pass
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
class SsoOnlyInviteError(ValueError):
|
|
141
|
+
pass
|
|
142
|
+
|
|
143
|
+
|
|
144
|
+
@dataclass(frozen=True, slots=True)
|
|
145
|
+
class IssuedInvite:
|
|
146
|
+
token: str
|
|
147
|
+
expires_at: datetime
|
|
148
|
+
|
|
149
|
+
|
|
150
|
+
@dataclass(frozen=True, slots=True)
|
|
151
|
+
class CreatedAccount:
|
|
152
|
+
"""A pre-created account and its invite; the token is handed out only when ``sso_only`` is false."""
|
|
153
|
+
|
|
154
|
+
user: DashboardUser
|
|
155
|
+
invite: IssuedInvite
|
|
156
|
+
sso_only: bool
|
|
157
|
+
|
|
158
|
+
|
|
159
|
+
@dataclass(frozen=True, slots=True)
|
|
160
|
+
class InviteDescription:
|
|
161
|
+
role_name: str
|
|
162
|
+
inviter_display_name: str | None
|
|
163
|
+
suggested_username: str
|
|
164
|
+
username_locked: bool
|
|
165
|
+
expires_at: datetime
|
|
166
|
+
|
|
167
|
+
|
|
168
|
+
@dataclass(frozen=True, slots=True)
|
|
169
|
+
class UserListing:
|
|
170
|
+
user: DashboardUser
|
|
171
|
+
pending_invite: DashboardUserInvite | None
|
|
172
|
+
|
|
173
|
+
|
|
174
|
+
def _now() -> datetime:
|
|
175
|
+
# Looked up through the module so one patched clock drives the service and the counts alike.
|
|
176
|
+
return users_repository.utc_now()
|
|
177
|
+
|
|
178
|
+
|
|
179
|
+
def as_utc(value: datetime) -> datetime:
|
|
180
|
+
"""Rows come back naive on SQLite; they were written as UTC."""
|
|
181
|
+
|
|
182
|
+
return value.replace(tzinfo=UTC) if value.tzinfo is None else value.astimezone(UTC)
|
|
183
|
+
|
|
184
|
+
|
|
185
|
+
def invite_token_hash(token: str) -> bytes:
|
|
186
|
+
return hashlib.sha256(token.encode("utf-8")).digest()
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
def _clean(value: str | None) -> str | None:
|
|
190
|
+
cleaned = (value or "").strip()
|
|
191
|
+
return cleaned or None
|
|
192
|
+
|
|
193
|
+
|
|
194
|
+
def _is_active(user: DashboardUser) -> bool:
|
|
195
|
+
return user.status == DashboardUserStatus.ACTIVE.value
|
|
196
|
+
|
|
197
|
+
|
|
198
|
+
def _is_admin_preset(user: DashboardUser) -> bool:
|
|
199
|
+
return is_admin_preset(user.role_id)
|
|
200
|
+
|
|
201
|
+
|
|
202
|
+
def _user_actor(user: DashboardUser) -> AuditActor:
|
|
203
|
+
return AuditActor(
|
|
204
|
+
user_id=user.id, username=user.username, role_slug=user.role.slug, auth_method=_AUTH_METHOD_PASSWORD
|
|
205
|
+
)
|
|
206
|
+
|
|
207
|
+
|
|
208
|
+
class DashboardUsersService:
|
|
209
|
+
def __init__(
|
|
210
|
+
self,
|
|
211
|
+
repository: DashboardUsersRepository,
|
|
212
|
+
roles: DashboardRolesRepository,
|
|
213
|
+
auth_repository: DashboardAuthRepository,
|
|
214
|
+
) -> None:
|
|
215
|
+
self._repo = repository
|
|
216
|
+
self._roles = roles
|
|
217
|
+
self._auth = auth_repository
|
|
218
|
+
|
|
219
|
+
# --- reads ---
|
|
220
|
+
|
|
221
|
+
async def list_users(self) -> list[UserListing]:
|
|
222
|
+
await self._purge_expired()
|
|
223
|
+
now = _now()
|
|
224
|
+
invites = {invite.user_id: invite for invite in await self._repo.list_live_invites(now)}
|
|
225
|
+
return [UserListing(user=user, pending_invite=invites.get(user.id)) for user in await self._repo.list_users()]
|
|
226
|
+
|
|
227
|
+
async def list_pending_invites(self) -> Sequence[DashboardUserInvite]:
|
|
228
|
+
await self._purge_expired()
|
|
229
|
+
return await self._repo.list_live_invites(_now())
|
|
230
|
+
|
|
231
|
+
# --- account lifecycle ---
|
|
232
|
+
|
|
233
|
+
async def create_user(
|
|
234
|
+
self, principal: DashboardPrincipal, payload: DashboardUserCreateRequest, *, actor_ip: str | None
|
|
235
|
+
) -> CreatedAccount:
|
|
236
|
+
"""Pre-create an account. With a link (the default) the person sets a password;
|
|
237
|
+
SSO-only accounts get no link and are activated by their first provider sign-in
|
|
238
|
+
matching ``expected_identity`` exactly."""
|
|
239
|
+
|
|
240
|
+
caller_id = self._require_account(principal)
|
|
241
|
+
await self._purge_expired()
|
|
242
|
+
username = self._new_username(payload.username)
|
|
243
|
+
email = self._normalized_email(payload.email)
|
|
244
|
+
role = await self._assignable_role(payload.role_id)
|
|
245
|
+
assert_can_delegate(principal.grants, resolve_role_grants(role))
|
|
246
|
+
expected = await self._expected_identity(payload)
|
|
247
|
+
if await self._repo.get_by_username(username) is not None:
|
|
248
|
+
raise UsernameTakenError("Username is already taken")
|
|
249
|
+
if email is not None and await self._repo.get_by_email(email) is not None:
|
|
250
|
+
raise EmailTakenError("E-mail is already in use")
|
|
251
|
+
user = DashboardUser(
|
|
252
|
+
id=str(uuid.uuid4()),
|
|
253
|
+
username=username,
|
|
254
|
+
display_name=_clean(payload.display_name),
|
|
255
|
+
email=email,
|
|
256
|
+
role_id=role.id,
|
|
257
|
+
role_source=DashboardUserRoleSource.MANUAL.value,
|
|
258
|
+
status=DashboardUserStatus.INVITED.value,
|
|
259
|
+
created_by_user_id=caller_id,
|
|
260
|
+
)
|
|
261
|
+
issued, invite = self._new_invite(
|
|
262
|
+
user.id,
|
|
263
|
+
created_by_user_id=caller_id,
|
|
264
|
+
username_locked=payload.username_locked,
|
|
265
|
+
expires_at=_now() + INVITE_TTL,
|
|
266
|
+
)
|
|
267
|
+
invite.sso_only = payload.sso_only
|
|
268
|
+
if expected is not None:
|
|
269
|
+
invite.expected_provider = expected.provider
|
|
270
|
+
invite.expected_provider_key = expected.provider_key
|
|
271
|
+
invite.expected_subject = expected.subject
|
|
272
|
+
role_slug = role.slug
|
|
273
|
+
self._repo.add(user, invite)
|
|
274
|
+
try:
|
|
275
|
+
user = await self._repo.commit_user(user.id)
|
|
276
|
+
except IntegrityError as exc:
|
|
277
|
+
conflict = await self._repo.conflicting_field(username, email)
|
|
278
|
+
if conflict == "email":
|
|
279
|
+
raise EmailTakenError("E-mail is already in use") from exc
|
|
280
|
+
if conflict is None and expected is not None:
|
|
281
|
+
# The partial unique index on the open expected identity fired: a concurrent create won.
|
|
282
|
+
raise IdentityTakenError("Another pending account already waits for that identity") from exc
|
|
283
|
+
raise UsernameTakenError("Username is already taken") from exc
|
|
284
|
+
await self._invalidate_users()
|
|
285
|
+
self._audit("user_created", principal, user.id, actor_ip, {"username": user.username, "role": role_slug})
|
|
286
|
+
invited: AuditDetails = {"sso_only": payload.sso_only}
|
|
287
|
+
if not payload.sso_only:
|
|
288
|
+
invited = {**invited, "expires_at": issued.expires_at.isoformat()}
|
|
289
|
+
if expected is not None:
|
|
290
|
+
invited = {**invited, "expected_provider": expected.provider, "expected_subject": expected.subject}
|
|
291
|
+
self._audit("user_invited", principal, user.id, actor_ip, invited)
|
|
292
|
+
return CreatedAccount(user=user, invite=issued, sso_only=payload.sso_only)
|
|
293
|
+
|
|
294
|
+
@staticmethod
|
|
295
|
+
def _new_username(raw: str) -> str:
|
|
296
|
+
"""Normalise and validate a username chosen for a person; ``admin`` stays the break-glass account's.
|
|
297
|
+
|
|
298
|
+
The reservation is a rule about the *name*: the bootstrapped account
|
|
299
|
+
may be renamed away from it, and no account -- including that one --
|
|
300
|
+
may take it afterwards, so the name the recovery runbooks use can never
|
|
301
|
+
come to mean somebody else.
|
|
302
|
+
"""
|
|
303
|
+
|
|
304
|
+
username = normalize_username(raw)
|
|
305
|
+
if not is_valid_username(username):
|
|
306
|
+
raise InvalidUsernameError("Username must be 1-64 characters of a-z, 0-9, '.', '_' or '-'")
|
|
307
|
+
if username == COMPAT_ADMIN_USERNAME:
|
|
308
|
+
raise InvalidUsernameError("'admin' is reserved for the local break-glass account")
|
|
309
|
+
return username
|
|
310
|
+
|
|
311
|
+
@classmethod
|
|
312
|
+
def _renamed_username(
|
|
313
|
+
cls, user: DashboardUser, payload: DashboardUserUpdateRequest, fields: set[str]
|
|
314
|
+
) -> str | None:
|
|
315
|
+
"""The normalised new name, or ``None`` when the request does not rename."""
|
|
316
|
+
|
|
317
|
+
if "username" not in fields:
|
|
318
|
+
return None
|
|
319
|
+
if payload.username is None:
|
|
320
|
+
raise InvalidUsernameError("A username cannot be cleared")
|
|
321
|
+
username = cls._new_username(payload.username)
|
|
322
|
+
return None if username == user.username else username
|
|
323
|
+
|
|
324
|
+
async def _expected_identity(self, payload: DashboardUserCreateRequest) -> ExpectedIdentityRequest | None:
|
|
325
|
+
"""Validate the SSO fields: they need an active non-password provider, and the
|
|
326
|
+
identity must not be linked yet. Trusted-header subjects are case-folded like the
|
|
327
|
+
resolver does, so the first sign-in matches regardless of the proxy's spelling."""
|
|
328
|
+
|
|
329
|
+
expected = payload.expected_identity
|
|
330
|
+
if not payload.sso_only and expected is None:
|
|
331
|
+
return None
|
|
332
|
+
if expected is None:
|
|
333
|
+
raise InvalidUsernameError("An SSO-only account needs the identity it will sign in with")
|
|
334
|
+
mode = get_settings().dashboard_auth_mode
|
|
335
|
+
active = {
|
|
336
|
+
(item.row.kind, item.row.provider_key)
|
|
337
|
+
for item in await get_auth_provider_registry().get_active_providers(mode)
|
|
338
|
+
if item.row.kind != AuthProviderKind.PASSWORD.value
|
|
339
|
+
}
|
|
340
|
+
if (expected.provider, expected.provider_key) not in active:
|
|
341
|
+
raise SsoNotAvailableError("No sign-in provider other than the password is active")
|
|
342
|
+
subject = expected.subject.strip()
|
|
343
|
+
if expected.provider == AuthProviderKind.TRUSTED_HEADER.value:
|
|
344
|
+
subject = subject.casefold()
|
|
345
|
+
if not subject:
|
|
346
|
+
raise InvalidUsernameError("The expected identity must not be empty")
|
|
347
|
+
if await self._repo.get_identity(expected.provider, expected.provider_key, subject) is not None:
|
|
348
|
+
raise IdentityTakenError("That identity already belongs to an account")
|
|
349
|
+
if await self._repo.find_invite_expecting_identity(expected.provider, expected.provider_key, subject, _now()):
|
|
350
|
+
raise IdentityTakenError("Another pending account already waits for that identity")
|
|
351
|
+
return ExpectedIdentityRequest(provider=expected.provider, provider_key=expected.provider_key, subject=subject)
|
|
352
|
+
|
|
353
|
+
async def update_user(
|
|
354
|
+
self, principal: DashboardPrincipal, user_id: str, payload: DashboardUserUpdateRequest, *, actor_ip: str | None
|
|
355
|
+
) -> UserListing:
|
|
356
|
+
"""Rules, in this order: self, invite pending, externally managed role,
|
|
357
|
+
delegation (new role), act-on (current role), last admin, last
|
|
358
|
+
qualifying break-glass, credential required. The account the install
|
|
359
|
+
bootstrapped is subject to exactly these and to nothing else."""
|
|
360
|
+
|
|
361
|
+
caller_id = self._require_account(principal)
|
|
362
|
+
await self._purge_expired()
|
|
363
|
+
await self._repo.acquire_write_intent()
|
|
364
|
+
user = await self._get(user_id)
|
|
365
|
+
is_self = user.id == caller_id
|
|
366
|
+
fields = payload.model_fields_set
|
|
367
|
+
role_changes = payload.role_id is not None and payload.role_id != user.role_id
|
|
368
|
+
new_status = payload.status if payload.status is not None and payload.status != user.status else None
|
|
369
|
+
designation = (
|
|
370
|
+
payload.is_break_glass
|
|
371
|
+
if payload.is_break_glass is not None and payload.is_break_glass != user.is_break_glass
|
|
372
|
+
else None
|
|
373
|
+
)
|
|
374
|
+
# A rename is not a role or status change: it is allowed on the
|
|
375
|
+
# caller's own account and never moves ``session_generation``. It is
|
|
376
|
+
# validated up front so a taken or reserved name is refused before any
|
|
377
|
+
# other field is applied.
|
|
378
|
+
new_username = self._renamed_username(user, payload, fields)
|
|
379
|
+
if new_username is not None and await self._repo.get_by_username(new_username) is not None:
|
|
380
|
+
raise UsernameTakenError("Username is already taken")
|
|
381
|
+
if (role_changes or new_status is not None) and is_self:
|
|
382
|
+
raise SelfModificationForbiddenError("You cannot change your own role or status")
|
|
383
|
+
if new_status is not None and user.status == DashboardUserStatus.INVITED.value:
|
|
384
|
+
raise InvitePendingError("The account has not accepted its invite yet; revoke the invite instead")
|
|
385
|
+
if payload.force and not role_changes:
|
|
386
|
+
raise ForceWithoutRoleChangeError("force only applies to a role change")
|
|
387
|
+
# A role a sign-in provider manages is only edited on purpose: without
|
|
388
|
+
# ``force`` the next sign-in would silently move it back.
|
|
389
|
+
overridden_source = (
|
|
390
|
+
user.role_source if role_changes and user.role_source != DashboardUserRoleSource.MANUAL.value else None
|
|
391
|
+
)
|
|
392
|
+
if overridden_source is not None and not payload.force:
|
|
393
|
+
raise RoleManagedExternallyError(
|
|
394
|
+
"That account's role is managed by its sign-in method; repeat with force to take it over"
|
|
395
|
+
)
|
|
396
|
+
designation_takes_over = designation is True and user.role_source != DashboardUserRoleSource.MANUAL.value
|
|
397
|
+
if overridden_source is None and designation_takes_over:
|
|
398
|
+
# Designating an emergency account takes its role over by hand;
|
|
399
|
+
# it must not be a role the next sign-in can move.
|
|
400
|
+
overridden_source = user.role_source
|
|
401
|
+
new_role: DashboardRoleRecord | None = None
|
|
402
|
+
if role_changes:
|
|
403
|
+
assert payload.role_id is not None
|
|
404
|
+
new_role = await self._assignable_role(payload.role_id)
|
|
405
|
+
assert_can_delegate(principal.grants, resolve_role_grants(new_role))
|
|
406
|
+
if not is_self:
|
|
407
|
+
assert_can_act_on(principal.grants, resolve_role_grants(user.role))
|
|
408
|
+
role_id_after = new_role.id if new_role is not None else user.role_id
|
|
409
|
+
status_after = new_status or user.status
|
|
410
|
+
# The designation says "this account is the way in when the identity
|
|
411
|
+
# provider is not": it is meaningless on any other role, and it must
|
|
412
|
+
# never be a role a provider can re-evaluate away. Asking for it on a
|
|
413
|
+
# non-admin is a mistake; a role change that moves a designated
|
|
414
|
+
# account off admin simply drops it -- and then meets the guard below.
|
|
415
|
+
if designation is True and not is_admin_preset(role_id_after):
|
|
416
|
+
raise BreakGlassRoleRequiredError("Only an admin account can be an emergency (break-glass) account")
|
|
417
|
+
designation_after = (user.is_break_glass if designation is None else designation) and is_admin_preset(
|
|
418
|
+
role_id_after
|
|
419
|
+
)
|
|
420
|
+
leaves_admin = (
|
|
421
|
+
_is_active(user)
|
|
422
|
+
and _is_admin_preset(user)
|
|
423
|
+
and not (role_id_after == PRESET_ROLE_IDS[PresetRoleSlug.ADMIN] and status_after == "active")
|
|
424
|
+
)
|
|
425
|
+
if leaves_admin:
|
|
426
|
+
await self._assert_other_active_admin(user.id)
|
|
427
|
+
# One guard, whatever the field: demoting, disabling and clearing the
|
|
428
|
+
# designation are the same question to the install.
|
|
429
|
+
loses_break_glass = await self.assert_break_glass_remains(
|
|
430
|
+
user, role_id=role_id_after, status=status_after, is_break_glass=designation_after
|
|
431
|
+
)
|
|
432
|
+
if new_status == DashboardUserStatus.ACTIVE.value:
|
|
433
|
+
assert_credential_remains(
|
|
434
|
+
password_hash=user.password_hash,
|
|
435
|
+
identity_count=await self._repo.count_identities(user.id),
|
|
436
|
+
solo_install=False,
|
|
437
|
+
)
|
|
438
|
+
|
|
439
|
+
old_role_slug = user.role.slug
|
|
440
|
+
old_username = user.username
|
|
441
|
+
new_role_slug = new_role.slug if new_role is not None else None
|
|
442
|
+
key_hashes: list[str] = []
|
|
443
|
+
try:
|
|
444
|
+
profile_changed = await self._apply_profile(user, payload, fields)
|
|
445
|
+
if new_username is not None:
|
|
446
|
+
user.username = new_username
|
|
447
|
+
if new_status == DashboardUserStatus.DISABLED.value:
|
|
448
|
+
key_hashes = await self._repo.deactivate_owned_keys(user.id)
|
|
449
|
+
if overridden_source is not None or designation_after:
|
|
450
|
+
# Taken over by hand (or designated): no later re-evaluation
|
|
451
|
+
# moves this role again -- which is what makes the mapping
|
|
452
|
+
# exemption a fact rather than a check.
|
|
453
|
+
user.role_source = DashboardUserRoleSource.MANUAL.value
|
|
454
|
+
if leaves_admin or loses_break_glass:
|
|
455
|
+
# The invariants are part of the write: the row only changes
|
|
456
|
+
# while another active admin (and, once local sign-in is
|
|
457
|
+
# restricted, another qualifying emergency account) exists at
|
|
458
|
+
# the moment of the UPDATE.
|
|
459
|
+
if not await self._repo.update_role_status_guarded(
|
|
460
|
+
user.id,
|
|
461
|
+
role_id=role_id_after,
|
|
462
|
+
status=status_after,
|
|
463
|
+
is_break_glass=designation_after,
|
|
464
|
+
require_other_admin=leaves_admin,
|
|
465
|
+
require_other_break_glass=loses_break_glass,
|
|
466
|
+
):
|
|
467
|
+
await self._repo.rollback()
|
|
468
|
+
if leaves_admin and await self._repo.count_active_admins(exclude_user_id=user.id) == 0:
|
|
469
|
+
raise LastAdminProtectedError("At least one active admin account must remain")
|
|
470
|
+
raise LastBreakGlassProtectedError(
|
|
471
|
+
"This is the only emergency account that can still sign in while local sign-in is "
|
|
472
|
+
"restricted; designate another admin with two-factor first"
|
|
473
|
+
)
|
|
474
|
+
else:
|
|
475
|
+
user.role_id = role_id_after
|
|
476
|
+
user.status = status_after
|
|
477
|
+
user.is_break_glass = designation_after
|
|
478
|
+
bump = new_role is not None or new_status == DashboardUserStatus.DISABLED.value
|
|
479
|
+
user = await self._repo.commit_user(user.id, bump_generation=bump)
|
|
480
|
+
except IntegrityError as exc:
|
|
481
|
+
await self._repo.rollback()
|
|
482
|
+
# A concurrent writer took the name or the address between the
|
|
483
|
+
# pre-check and this commit; the unique index says which.
|
|
484
|
+
if new_username is not None and await self._repo.conflicting_field(new_username, None) == "username":
|
|
485
|
+
raise UsernameTakenError("Username is already taken") from exc
|
|
486
|
+
raise EmailTakenError("E-mail is already in use") from exc
|
|
487
|
+
await self._invalidate_users()
|
|
488
|
+
await self._invalidate_api_keys(key_hashes)
|
|
489
|
+
|
|
490
|
+
if new_username is not None:
|
|
491
|
+
self._audit(
|
|
492
|
+
"user_renamed",
|
|
493
|
+
principal,
|
|
494
|
+
user.id,
|
|
495
|
+
actor_ip,
|
|
496
|
+
{"username": user.username, "from": old_username, "to": user.username},
|
|
497
|
+
)
|
|
498
|
+
if profile_changed or designation is not None:
|
|
499
|
+
self._audit(
|
|
500
|
+
"user_updated",
|
|
501
|
+
principal,
|
|
502
|
+
user.id,
|
|
503
|
+
actor_ip,
|
|
504
|
+
{"username": user.username, "is_break_glass": user.is_break_glass}
|
|
505
|
+
if designation is not None
|
|
506
|
+
else {"username": user.username},
|
|
507
|
+
)
|
|
508
|
+
if new_role is not None:
|
|
509
|
+
self._audit(
|
|
510
|
+
"user_role_changed",
|
|
511
|
+
principal,
|
|
512
|
+
user.id,
|
|
513
|
+
actor_ip,
|
|
514
|
+
{"username": user.username, "from": old_role_slug, "to": new_role_slug},
|
|
515
|
+
)
|
|
516
|
+
if overridden_source is not None:
|
|
517
|
+
self._audit(
|
|
518
|
+
"role_source_overridden",
|
|
519
|
+
principal,
|
|
520
|
+
user.id,
|
|
521
|
+
actor_ip,
|
|
522
|
+
{
|
|
523
|
+
"username": user.username,
|
|
524
|
+
"from_source": overridden_source,
|
|
525
|
+
"to_source": DashboardUserRoleSource.MANUAL.value,
|
|
526
|
+
"provider": await self._repo.primary_identity_provider(user.id),
|
|
527
|
+
},
|
|
528
|
+
)
|
|
529
|
+
if new_status == DashboardUserStatus.DISABLED.value:
|
|
530
|
+
self._audit("user_disabled", principal, user.id, actor_ip, {"username": user.username})
|
|
531
|
+
self._audit("user_keys_deactivated", principal, user.id, actor_ip, {"count": len(key_hashes)})
|
|
532
|
+
elif new_status == DashboardUserStatus.ACTIVE.value:
|
|
533
|
+
self._audit("user_enabled", principal, user.id, actor_ip, {"username": user.username})
|
|
534
|
+
return UserListing(user=user, pending_invite=await self._repo.live_invite_for_user(user.id, _now()))
|
|
535
|
+
|
|
536
|
+
async def update_profile(
|
|
537
|
+
self, user: DashboardUser, payload: ProfileUpdateRequest, *, actor_ip: str | None
|
|
538
|
+
) -> DashboardUser:
|
|
539
|
+
"""Self-service edit: display name and e-mail only, audited as the account itself."""
|
|
540
|
+
|
|
541
|
+
user = await self._get(user.id)
|
|
542
|
+
changed = await self._apply_profile(user, payload, payload.model_fields_set)
|
|
543
|
+
try:
|
|
544
|
+
user = await self._repo.commit_user(user.id)
|
|
545
|
+
except IntegrityError as exc:
|
|
546
|
+
raise EmailTakenError("E-mail is already in use") from exc
|
|
547
|
+
if changed:
|
|
548
|
+
await self._invalidate_users()
|
|
549
|
+
AuditService.log_async(
|
|
550
|
+
"user_updated",
|
|
551
|
+
actor_ip=actor_ip,
|
|
552
|
+
details={"username": user.username, "self": True},
|
|
553
|
+
actor=_user_actor(user),
|
|
554
|
+
target=AuditTarget("user", user.id),
|
|
555
|
+
)
|
|
556
|
+
return user
|
|
557
|
+
|
|
558
|
+
async def delete_user(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> None:
|
|
559
|
+
caller_id = self._require_account(principal)
|
|
560
|
+
await self._purge_expired()
|
|
561
|
+
await self._repo.acquire_write_intent()
|
|
562
|
+
user = await self._get(user_id)
|
|
563
|
+
if user.id == caller_id:
|
|
564
|
+
raise SelfModificationForbiddenError("You cannot delete your own account")
|
|
565
|
+
counts_as_admin = _is_active(user) and _is_admin_preset(user)
|
|
566
|
+
if counts_as_admin:
|
|
567
|
+
await self._assert_other_active_admin(user.id)
|
|
568
|
+
counts_as_break_glass = await self.assert_break_glass_remains(user, is_break_glass=False)
|
|
569
|
+
assert_can_act_on(principal.grants, resolve_role_grants(user.role))
|
|
570
|
+
details: AuditDetails = {"username": user.username, "role": user.role.slug}
|
|
571
|
+
key_hashes = await self._repo.delete_user(
|
|
572
|
+
user, require_other_admin=counts_as_admin, require_other_break_glass=counts_as_break_glass
|
|
573
|
+
)
|
|
574
|
+
if key_hashes is None:
|
|
575
|
+
if counts_as_admin and await self._repo.count_active_admins(exclude_user_id=user_id) == 0:
|
|
576
|
+
raise LastAdminProtectedError("At least one active admin account must remain")
|
|
577
|
+
raise LastBreakGlassProtectedError(
|
|
578
|
+
"This is the only emergency account that can still sign in while local sign-in is restricted; "
|
|
579
|
+
"designate another admin with two-factor first"
|
|
580
|
+
)
|
|
581
|
+
await self._invalidate_users()
|
|
582
|
+
await self._invalidate_api_keys(key_hashes)
|
|
583
|
+
self._audit("user_deleted", principal, user_id, actor_ip, details)
|
|
584
|
+
if key_hashes:
|
|
585
|
+
self._audit("user_keys_deactivated", principal, user_id, actor_ip, {"count": len(key_hashes)})
|
|
586
|
+
|
|
587
|
+
# --- the break-glass invariant (one guard, every mutation) ---
|
|
588
|
+
|
|
589
|
+
async def assert_break_glass_remains(
|
|
590
|
+
self,
|
|
591
|
+
user: DashboardUser,
|
|
592
|
+
*,
|
|
593
|
+
role_id: str | None = None,
|
|
594
|
+
status: str | None = None,
|
|
595
|
+
is_break_glass: bool | None = None,
|
|
596
|
+
has_totp: bool | None = None,
|
|
597
|
+
has_password: bool | None = None,
|
|
598
|
+
) -> bool:
|
|
599
|
+
"""Refuse a change that would leave no qualifying emergency account (PLAN §4.2).
|
|
600
|
+
|
|
601
|
+
The single entry point for every call site: the role and status
|
|
602
|
+
branches of the account PATCH, deletion, clearing the designation,
|
|
603
|
+
self-service ``/totp/disable`` (through the auth service, which calls
|
|
604
|
+
the same free function), the administrative TOTP reset, and
|
|
605
|
+
:meth:`deactivate_user`. Each keyword is the value the field would
|
|
606
|
+
carry after the write. Returns whether the caller's conditional write
|
|
607
|
+
must re-apply the count (see the free function).
|
|
608
|
+
"""
|
|
609
|
+
|
|
610
|
+
settings = await self._auth.get_settings()
|
|
611
|
+
return await assert_break_glass_remains(
|
|
612
|
+
user,
|
|
613
|
+
policy=settings.local_login_policy,
|
|
614
|
+
count_other_qualifying=lambda: self._repo.count_qualifying_break_glass(exclude_user_id=user.id),
|
|
615
|
+
role_id=role_id,
|
|
616
|
+
status=status,
|
|
617
|
+
is_break_glass=is_break_glass,
|
|
618
|
+
has_totp=has_totp,
|
|
619
|
+
has_password=has_password,
|
|
620
|
+
)
|
|
621
|
+
|
|
622
|
+
async def deactivate_user(
|
|
623
|
+
self,
|
|
624
|
+
user_id: str,
|
|
625
|
+
*,
|
|
626
|
+
actor: AuditActor,
|
|
627
|
+
actor_ip: str | None,
|
|
628
|
+
source: str,
|
|
629
|
+
) -> bool:
|
|
630
|
+
"""Disable an account through one back-channel: guard, status, generation, key cascade, audit.
|
|
631
|
+
|
|
632
|
+
This is the shared path for deactivations that do not come from the
|
|
633
|
+
account PATCH — the SCIM ``active=false`` endpoint of Phase 3b and the
|
|
634
|
+
identity resolver — so none of them can bypass the break-glass guard.
|
|
635
|
+
A refusal audits ``scim_deprovision_refused`` next to raising, because
|
|
636
|
+
the caller is a machine whose 409 nobody reads.
|
|
637
|
+
|
|
638
|
+
An account that never accepted its invitation is deactivated rather
|
|
639
|
+
than ignored: its invite is deleted in this same transaction and the
|
|
640
|
+
row moves to ``disabled``. A human revoke deletes such an account
|
|
641
|
+
outright, which a back channel must not do — the caller has to keep
|
|
642
|
+
finding that person by the name it pushed — and an ``sso_only`` invite
|
|
643
|
+
never expires, so ignoring it would leave a way in open forever.
|
|
644
|
+
Returns ``False`` when the account was already inactive (nothing to do,
|
|
645
|
+
nothing audited), which is what makes a redelivered push idempotent.
|
|
646
|
+
"""
|
|
647
|
+
|
|
648
|
+
await self._repo.acquire_write_intent()
|
|
649
|
+
user = await self._get(user_id)
|
|
650
|
+
invited = user.status == DashboardUserStatus.INVITED.value
|
|
651
|
+
if not _is_active(user) and not invited:
|
|
652
|
+
return False
|
|
653
|
+
# An invited account is not active, so it counts for neither invariant:
|
|
654
|
+
# the guards below read the same way the account PATCH reads them.
|
|
655
|
+
counts_as_admin = _is_active(user) and _is_admin_preset(user)
|
|
656
|
+
# Read off the row while it is still loaded: a rollback below expires
|
|
657
|
+
# every attribute, and reading one back then is synchronous IO in an
|
|
658
|
+
# async context — the refusal would surface as a driver error.
|
|
659
|
+
username = user.username
|
|
660
|
+
role_id = user.role_id
|
|
661
|
+
try:
|
|
662
|
+
guarded = await self.assert_break_glass_remains(user, status=DashboardUserStatus.DISABLED.value)
|
|
663
|
+
except LastBreakGlassProtectedError:
|
|
664
|
+
self._audit_deprovision_refused(user_id, username, actor=actor, actor_ip=actor_ip, source=source)
|
|
665
|
+
raise
|
|
666
|
+
if counts_as_admin:
|
|
667
|
+
await self._assert_other_active_admin(user_id)
|
|
668
|
+
key_hashes = await self._repo.deactivate_owned_keys(user_id)
|
|
669
|
+
invite_deleted = await self._repo.delete_invite(user_id) if invited else False
|
|
670
|
+
if not await self._repo.update_role_status_guarded(
|
|
671
|
+
user_id,
|
|
672
|
+
role_id=role_id,
|
|
673
|
+
status=DashboardUserStatus.DISABLED.value,
|
|
674
|
+
require_other_admin=counts_as_admin,
|
|
675
|
+
require_other_break_glass=guarded,
|
|
676
|
+
):
|
|
677
|
+
# Which invariant actually lost is a re-read, not a guess: both
|
|
678
|
+
# predicates rode into the one UPDATE, and naming the wrong one
|
|
679
|
+
# sends the operator to fix an account that was never the problem.
|
|
680
|
+
await self._repo.rollback()
|
|
681
|
+
if counts_as_admin and await self._repo.count_active_admins(exclude_user_id=user_id) == 0:
|
|
682
|
+
raise LastAdminProtectedError("At least one active admin account must remain")
|
|
683
|
+
self._audit_deprovision_refused(user_id, username, actor=actor, actor_ip=actor_ip, source=source)
|
|
684
|
+
raise LastBreakGlassProtectedError(
|
|
685
|
+
"This is the only emergency account that can still sign in while local sign-in is restricted; "
|
|
686
|
+
"designate another admin with two-factor first"
|
|
687
|
+
)
|
|
688
|
+
await self._repo.commit_user(user_id, bump_generation=True)
|
|
689
|
+
await self._invalidate_users()
|
|
690
|
+
await self._invalidate_api_keys(key_hashes)
|
|
691
|
+
AuditService.log_async(
|
|
692
|
+
"user_disabled",
|
|
693
|
+
actor_ip=actor_ip,
|
|
694
|
+
details={"username": username, "source": source},
|
|
695
|
+
actor=actor,
|
|
696
|
+
target=AuditTarget("user", user_id),
|
|
697
|
+
)
|
|
698
|
+
AuditService.log_async(
|
|
699
|
+
"user_keys_deactivated",
|
|
700
|
+
actor_ip=actor_ip,
|
|
701
|
+
details={"count": len(key_hashes), "source": source},
|
|
702
|
+
actor=actor,
|
|
703
|
+
target=AuditTarget("user", user_id),
|
|
704
|
+
)
|
|
705
|
+
if invite_deleted:
|
|
706
|
+
# The same action the management side writes when an invitation
|
|
707
|
+
# stops being usable, so one search answers "when did this link
|
|
708
|
+
# die" whoever killed it.
|
|
709
|
+
AuditService.log_async(
|
|
710
|
+
"invite_revoked",
|
|
711
|
+
actor_ip=actor_ip,
|
|
712
|
+
details={"username": username, "source": source},
|
|
713
|
+
actor=actor,
|
|
714
|
+
target=AuditTarget("user", user_id),
|
|
715
|
+
)
|
|
716
|
+
return True
|
|
717
|
+
|
|
718
|
+
def _audit_deprovision_refused(
|
|
719
|
+
self, user_id: str, username: str, *, actor: AuditActor, actor_ip: str | None, source: str
|
|
720
|
+
) -> None:
|
|
721
|
+
"""One row per refusal, written where the refusal is raised.
|
|
722
|
+
|
|
723
|
+
Both places that raise it are inside :meth:`deactivate_user`, so the
|
|
724
|
+
machine caller that maps the exception to its own envelope adds
|
|
725
|
+
nothing: a second row written there would double-count every refused
|
|
726
|
+
leaver. It takes plain values rather than the row because one caller
|
|
727
|
+
has already rolled the transaction back.
|
|
728
|
+
"""
|
|
729
|
+
|
|
730
|
+
AuditService.log_async(
|
|
731
|
+
"scim_deprovision_refused",
|
|
732
|
+
actor_ip=actor_ip,
|
|
733
|
+
details={"username": username, "source": source, "reason": "last_break_glass_protected"},
|
|
734
|
+
actor=actor,
|
|
735
|
+
target=AuditTarget("user", user_id),
|
|
736
|
+
severity=AuditSeverity.WARNING,
|
|
737
|
+
)
|
|
738
|
+
|
|
739
|
+
async def reactivate_user(
|
|
740
|
+
self,
|
|
741
|
+
user_id: str,
|
|
742
|
+
*,
|
|
743
|
+
actor: AuditActor,
|
|
744
|
+
actor_ip: str | None,
|
|
745
|
+
source: str,
|
|
746
|
+
) -> bool:
|
|
747
|
+
"""Re-enable an account through one back-channel: status, commit, then the owner keys.
|
|
748
|
+
|
|
749
|
+
The principal-free twin of :meth:`deactivate_user`, for callers that are
|
|
750
|
+
machines rather than people — the SCIM ``active=true`` push. Fabricating
|
|
751
|
+
a :class:`DashboardPrincipal` to reuse the administrative
|
|
752
|
+
:meth:`reactivate_keys` instead would hand a bearer token a blanket
|
|
753
|
+
``assert_can_act_on`` bypass over every account on the install, which is
|
|
754
|
+
exactly the escalation this separation exists to prevent.
|
|
755
|
+
|
|
756
|
+
The two halves are ordered, not merged: the restoring ``UPDATE`` reads
|
|
757
|
+
the owner's status in an ``EXISTS`` predicate, so the status flip has to
|
|
758
|
+
be committed before it runs or it would restore nothing. Only keys the
|
|
759
|
+
owner cascade turned off come back; an administrator's explicit revoke
|
|
760
|
+
(``manual``) and an expiry are never resurrected. Returns ``False`` when
|
|
761
|
+
the account was already active (nothing written, nothing audited).
|
|
762
|
+
"""
|
|
763
|
+
|
|
764
|
+
await self._repo.acquire_write_intent()
|
|
765
|
+
user = await self._get(user_id)
|
|
766
|
+
if _is_active(user):
|
|
767
|
+
return False
|
|
768
|
+
if user.status == DashboardUserStatus.INVITED.value:
|
|
769
|
+
raise InvitePendingError("The account has not accepted its invitation yet")
|
|
770
|
+
username = user.username
|
|
771
|
+
user.status = DashboardUserStatus.ACTIVE.value
|
|
772
|
+
await self._repo.commit_user(user.id)
|
|
773
|
+
await self._invalidate_users()
|
|
774
|
+
AuditService.log_async(
|
|
775
|
+
"user_enabled",
|
|
776
|
+
actor_ip=actor_ip,
|
|
777
|
+
details={"username": username, "source": source},
|
|
778
|
+
actor=actor,
|
|
779
|
+
target=AuditTarget("user", user_id),
|
|
780
|
+
)
|
|
781
|
+
key_hashes = await self._repo.reactivate_owner_disabled_keys(user.id)
|
|
782
|
+
if key_hashes:
|
|
783
|
+
await self._invalidate_api_keys(key_hashes)
|
|
784
|
+
AuditService.log_async(
|
|
785
|
+
"user_keys_reactivated",
|
|
786
|
+
actor_ip=actor_ip,
|
|
787
|
+
details={"count": len(key_hashes), "source": source},
|
|
788
|
+
actor=actor,
|
|
789
|
+
target=AuditTarget("user", user_id),
|
|
790
|
+
)
|
|
791
|
+
return True
|
|
792
|
+
|
|
793
|
+
# --- invites (management side) ---
|
|
794
|
+
|
|
795
|
+
async def resend_invite(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> IssuedInvite:
|
|
796
|
+
caller_id = self._require_account(principal)
|
|
797
|
+
await self._purge_expired()
|
|
798
|
+
user = await self._get(user_id)
|
|
799
|
+
if user.status != DashboardUserStatus.INVITED.value:
|
|
800
|
+
raise InviteNotPendingError("The account has no pending invite")
|
|
801
|
+
current = await self._repo.get_invite_for_user(user.id)
|
|
802
|
+
if current is not None and current.sso_only:
|
|
803
|
+
raise SsoOnlyInviteError("This account signs in through a provider; there is no link to resend")
|
|
804
|
+
assert_can_act_on(principal.grants, resolve_role_grants(user.role))
|
|
805
|
+
issued, fresh = self._new_invite(
|
|
806
|
+
user.id, created_by_user_id=caller_id, username_locked=False, expires_at=_now() + INVITE_TTL
|
|
807
|
+
)
|
|
808
|
+
# Conditional on the account still being invited: an acceptance that
|
|
809
|
+
# committed since the read must not have its consumed invite re-armed.
|
|
810
|
+
rotated = await self._repo.rotate_invite(user.id, token_hash=fresh.token_hash, expires_at=fresh.expires_at)
|
|
811
|
+
if not rotated:
|
|
812
|
+
await self._repo.rollback()
|
|
813
|
+
raise InviteNotPendingError("The account has no pending invite")
|
|
814
|
+
user = await self._repo.commit_user(user.id)
|
|
815
|
+
await self._invalidate_users()
|
|
816
|
+
self._audit("invite_resent", principal, user.id, actor_ip, {"username": user.username})
|
|
817
|
+
return issued
|
|
818
|
+
|
|
819
|
+
async def revoke_invite(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> None:
|
|
820
|
+
self._require_account(principal)
|
|
821
|
+
await self._purge_expired()
|
|
822
|
+
user = await self._get(user_id)
|
|
823
|
+
assert_can_act_on(principal.grants, resolve_role_grants(user.role))
|
|
824
|
+
username = user.username
|
|
825
|
+
if user.status == DashboardUserStatus.INVITED.value:
|
|
826
|
+
# An invited account has no credential, no keys and no sessions: the
|
|
827
|
+
# row goes with the link -- unless an acceptance committed meanwhile.
|
|
828
|
+
if await self._repo.delete_user(user, only_while_invited=True) is None:
|
|
829
|
+
raise InviteNotPendingError("The account has no pending invite")
|
|
830
|
+
else:
|
|
831
|
+
invite = await self._repo.get_invite_for_user(user.id)
|
|
832
|
+
if invite is None or invite.consumed_at is not None or invite.revoked_at is not None:
|
|
833
|
+
raise InviteNotPendingError("The account has no pending invite")
|
|
834
|
+
invite.revoked_at = _now()
|
|
835
|
+
await self._repo.commit_user(user.id)
|
|
836
|
+
await self._invalidate_users()
|
|
837
|
+
self._audit("invite_revoked", principal, user_id, actor_ip, {"username": username})
|
|
838
|
+
|
|
839
|
+
# --- account actions ---
|
|
840
|
+
|
|
841
|
+
async def reset_totp(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> None:
|
|
842
|
+
caller_id = self._require_account(principal)
|
|
843
|
+
await self._purge_expired()
|
|
844
|
+
# Serialised with the other account mutations *before the first read*,
|
|
845
|
+
# exactly as the account PATCH does, and held until the secret write
|
|
846
|
+
# commits: the write has no conditional form, so the lock is the only
|
|
847
|
+
# thing stopping two admins from clearing the last two second factors
|
|
848
|
+
# after both passed the count. Acquiring before the first read also
|
|
849
|
+
# keeps ``BEGIN IMMEDIATE`` on its primary path rather than the
|
|
850
|
+
# in-transaction fallback.
|
|
851
|
+
await self._repo.acquire_write_intent()
|
|
852
|
+
user = await self._get(user_id)
|
|
853
|
+
if user.id == caller_id:
|
|
854
|
+
raise SelfModificationForbiddenError("Disable your own TOTP through /totp/disable")
|
|
855
|
+
assert_can_act_on(principal.grants, resolve_role_grants(user.role))
|
|
856
|
+
await self.assert_break_glass_remains(user, has_totp=False)
|
|
857
|
+
await self._auth.set_user_totp_secret(user.id, None, bump_generation=True, preserve_policy=True)
|
|
858
|
+
await self._invalidate_users()
|
|
859
|
+
self._audit("user_totp_reset", principal, user.id, actor_ip, {"username": user.username})
|
|
860
|
+
|
|
861
|
+
async def revoke_sessions(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> None:
|
|
862
|
+
self._require_account(principal)
|
|
863
|
+
await self._purge_expired()
|
|
864
|
+
user = await self._get(user_id)
|
|
865
|
+
assert_can_act_on(principal.grants, resolve_role_grants(user.role))
|
|
866
|
+
await self._auth.bump_session_generation(user.id)
|
|
867
|
+
await self._invalidate_users()
|
|
868
|
+
self._audit(
|
|
869
|
+
"user_sessions_revoked", principal, user.id, actor_ip, {"username": user.username, "scope": "admin"}
|
|
870
|
+
)
|
|
871
|
+
|
|
872
|
+
async def reactivate_keys(self, principal: DashboardPrincipal, user_id: str, *, actor_ip: str | None) -> int:
|
|
873
|
+
self._require_account(principal)
|
|
874
|
+
await self._purge_expired()
|
|
875
|
+
# Serialised with disable (same write-intent lock); the UPDATE itself is
|
|
876
|
+
# also conditional on the owner still being active.
|
|
877
|
+
await self._repo.acquire_write_intent()
|
|
878
|
+
user = await self._get(user_id)
|
|
879
|
+
if not _is_active(user):
|
|
880
|
+
raise UserNotActiveError("Keys can only be restored for an active account")
|
|
881
|
+
assert_can_act_on(principal.grants, resolve_role_grants(user.role))
|
|
882
|
+
key_hashes = await self._repo.reactivate_owner_disabled_keys(user.id)
|
|
883
|
+
if key_hashes is None:
|
|
884
|
+
raise UserNotActiveError("Keys can only be restored for an active account")
|
|
885
|
+
await self._invalidate_api_keys(key_hashes)
|
|
886
|
+
self._audit("user_keys_reactivated", principal, user.id, actor_ip, {"count": len(key_hashes)})
|
|
887
|
+
return len(key_hashes)
|
|
888
|
+
|
|
889
|
+
# --- invites (public side) ---
|
|
890
|
+
|
|
891
|
+
async def describe_invite(self, token: str) -> InviteDescription:
|
|
892
|
+
invite = await self._pending_invite(token)
|
|
893
|
+
inviter = await self._repo.get_by_id(invite.created_by_user_id)
|
|
894
|
+
return InviteDescription(
|
|
895
|
+
role_name=invite.user.role.name,
|
|
896
|
+
inviter_display_name=(inviter.display_name or inviter.username) if inviter is not None else None,
|
|
897
|
+
suggested_username=invite.user.username,
|
|
898
|
+
username_locked=invite.username_locked,
|
|
899
|
+
expires_at=as_utc(invite.expires_at),
|
|
900
|
+
)
|
|
901
|
+
|
|
902
|
+
async def accept_invite(
|
|
903
|
+
self,
|
|
904
|
+
token: str,
|
|
905
|
+
*,
|
|
906
|
+
username: str | None,
|
|
907
|
+
password_hash: str,
|
|
908
|
+
display_name: str | None,
|
|
909
|
+
actor_ip: str | None,
|
|
910
|
+
) -> DashboardUser:
|
|
911
|
+
"""Activate the invited account; the invite is consumed compare-and-set so a link works once."""
|
|
912
|
+
|
|
913
|
+
invite = await self._pending_invite(token)
|
|
914
|
+
user = invite.user
|
|
915
|
+
try:
|
|
916
|
+
if username is not None and normalize_username(username) != user.username:
|
|
917
|
+
if invite.username_locked:
|
|
918
|
+
raise UsernameLockedError("The username of this invite cannot be changed")
|
|
919
|
+
normalized = self._new_username(username)
|
|
920
|
+
if await self._repo.get_by_username(normalized) is not None:
|
|
921
|
+
raise UsernameTakenError("Username is already taken")
|
|
922
|
+
user.username = normalized
|
|
923
|
+
if display_name is not None:
|
|
924
|
+
user.display_name = _clean(display_name)
|
|
925
|
+
user.password_hash = password_hash
|
|
926
|
+
user.status = DashboardUserStatus.ACTIVE.value
|
|
927
|
+
user.last_login_at = utcnow()
|
|
928
|
+
if not await self._repo.consume_invite(invite.id, token_hash=invite_token_hash(token), now=_now()):
|
|
929
|
+
await self._repo.rollback()
|
|
930
|
+
raise InviteNotFoundError("This invite is no longer valid")
|
|
931
|
+
user = await self._repo.commit_user(user.id, bump_generation=True)
|
|
932
|
+
except IntegrityError as exc:
|
|
933
|
+
# The autoflush inside consume_invite (or the commit) hit the unique
|
|
934
|
+
# username: a concurrent create or accept won the name.
|
|
935
|
+
await self._repo.rollback()
|
|
936
|
+
raise UsernameTakenError("Username is already taken") from exc
|
|
937
|
+
await self._invalidate_users()
|
|
938
|
+
AuditService.log_async(
|
|
939
|
+
"invite_accepted",
|
|
940
|
+
actor_ip=actor_ip,
|
|
941
|
+
details={"username": user.username, "role": user.role.slug},
|
|
942
|
+
actor=_user_actor(user),
|
|
943
|
+
target=AuditTarget("user", user.id),
|
|
944
|
+
)
|
|
945
|
+
return user
|
|
946
|
+
|
|
947
|
+
# --- helpers ---
|
|
948
|
+
|
|
949
|
+
async def _pending_invite(self, token: str) -> DashboardUserInvite:
|
|
950
|
+
"""Expired, consumed, revoked and unknown tokens are indistinguishable to the caller."""
|
|
951
|
+
|
|
952
|
+
invite = await self._repo.get_invite_by_token_hash(invite_token_hash(token))
|
|
953
|
+
if (
|
|
954
|
+
invite is None
|
|
955
|
+
or invite.sso_only # no link exists for an SSO-only account, whatever the token claims
|
|
956
|
+
or invite.consumed_at is not None
|
|
957
|
+
or invite.revoked_at is not None
|
|
958
|
+
or as_utc(invite.expires_at) <= _now()
|
|
959
|
+
or invite.user.status != DashboardUserStatus.INVITED.value
|
|
960
|
+
):
|
|
961
|
+
raise InviteNotFoundError("This invite is no longer valid")
|
|
962
|
+
return invite
|
|
963
|
+
|
|
964
|
+
@staticmethod
|
|
965
|
+
def _new_invite(
|
|
966
|
+
user_id: str, *, created_by_user_id: str, username_locked: bool, expires_at: datetime
|
|
967
|
+
) -> tuple[IssuedInvite, DashboardUserInvite]:
|
|
968
|
+
"""A fresh token: the plaintext goes to the caller once, only its hash is stored."""
|
|
969
|
+
|
|
970
|
+
token = secrets.token_urlsafe(32)
|
|
971
|
+
invite = DashboardUserInvite(
|
|
972
|
+
id=str(uuid.uuid4()),
|
|
973
|
+
user_id=user_id,
|
|
974
|
+
token_hash=invite_token_hash(token),
|
|
975
|
+
expires_at=expires_at,
|
|
976
|
+
created_by_user_id=created_by_user_id,
|
|
977
|
+
username_locked=username_locked,
|
|
978
|
+
)
|
|
979
|
+
return IssuedInvite(token=token, expires_at=expires_at), invite
|
|
980
|
+
|
|
981
|
+
async def _purge_expired(self) -> None:
|
|
982
|
+
if await self._repo.purge_expired_invited_users(_now()):
|
|
983
|
+
await self._invalidate_users()
|
|
984
|
+
|
|
985
|
+
async def _get(self, user_id: str) -> DashboardUser:
|
|
986
|
+
user = await self._repo.get_by_id(user_id)
|
|
987
|
+
if user is None:
|
|
988
|
+
raise UserNotFoundError("Account not found")
|
|
989
|
+
return user
|
|
990
|
+
|
|
991
|
+
async def _assignable_role(self, role_id: str) -> DashboardRoleRecord:
|
|
992
|
+
return await resolve_assignable_role(self._roles, role_id)
|
|
993
|
+
|
|
994
|
+
async def _assert_other_active_admin(self, user_id: str) -> None:
|
|
995
|
+
if await self._repo.count_active_admins(exclude_user_id=user_id) == 0:
|
|
996
|
+
raise LastAdminProtectedError("At least one active admin account must remain")
|
|
997
|
+
|
|
998
|
+
async def _apply_profile(
|
|
999
|
+
self, user: DashboardUser, payload: DashboardUserUpdateRequest | ProfileUpdateRequest, fields: set[str]
|
|
1000
|
+
) -> bool:
|
|
1001
|
+
changed = False
|
|
1002
|
+
if "display_name" in fields and _clean(payload.display_name) != user.display_name:
|
|
1003
|
+
user.display_name = _clean(payload.display_name)
|
|
1004
|
+
changed = True
|
|
1005
|
+
if "email" in fields:
|
|
1006
|
+
email = self._normalized_email(payload.email)
|
|
1007
|
+
if email != user.email:
|
|
1008
|
+
if email is not None:
|
|
1009
|
+
other = await self._repo.get_by_email(email)
|
|
1010
|
+
if other is not None and other.id != user.id:
|
|
1011
|
+
raise EmailTakenError("E-mail is already in use")
|
|
1012
|
+
user.email = email
|
|
1013
|
+
changed = True
|
|
1014
|
+
return changed
|
|
1015
|
+
|
|
1016
|
+
@staticmethod
|
|
1017
|
+
def _normalized_email(value: str | None) -> str | None:
|
|
1018
|
+
email = normalize_email(value)
|
|
1019
|
+
if email is not None and not is_valid_email(email):
|
|
1020
|
+
raise InvalidEmailError("E-mail address is not valid")
|
|
1021
|
+
return email
|
|
1022
|
+
|
|
1023
|
+
@staticmethod
|
|
1024
|
+
def _require_account(principal: DashboardPrincipal) -> str:
|
|
1025
|
+
if principal.user_id is None:
|
|
1026
|
+
raise AdminAccountRequiredError("Set a dashboard password and sign in before managing accounts")
|
|
1027
|
+
return principal.user_id
|
|
1028
|
+
|
|
1029
|
+
@staticmethod
|
|
1030
|
+
def _audit(
|
|
1031
|
+
action: str, principal: DashboardPrincipal, user_id: str, actor_ip: str | None, details: AuditDetails
|
|
1032
|
+
) -> None:
|
|
1033
|
+
AuditService.log_async(
|
|
1034
|
+
action,
|
|
1035
|
+
actor_ip=actor_ip,
|
|
1036
|
+
details=details,
|
|
1037
|
+
actor=AuditActor.from_principal(principal),
|
|
1038
|
+
target=AuditTarget("user", user_id),
|
|
1039
|
+
)
|
|
1040
|
+
|
|
1041
|
+
@staticmethod
|
|
1042
|
+
async def _invalidate_users() -> None:
|
|
1043
|
+
await get_dashboard_users_cache().invalidate()
|
|
1044
|
+
|
|
1045
|
+
@staticmethod
|
|
1046
|
+
async def _invalidate_api_keys(key_hashes: Sequence[str]) -> None:
|
|
1047
|
+
if not key_hashes:
|
|
1048
|
+
return
|
|
1049
|
+
cache = get_api_key_cache()
|
|
1050
|
+
for key_hash in key_hashes:
|
|
1051
|
+
await cache.invalidate(key_hash)
|
|
1052
|
+
poller = get_cache_invalidation_poller()
|
|
1053
|
+
if poller is not None:
|
|
1054
|
+
await poller.bump(NAMESPACE_API_KEY)
|