Skip to content

OpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.

Python

feat: Make providers admin-only and enforce RBAC (#1736)

Edwin Josee73df3150300
diff --git a/alembic/versions/0006_revoke_provider_override_nonadmin.py b/alembic/versions/0006_revoke_provider_override_nonadmin.py
new file mode 100644
index 000000000..06bd707ba
--- /dev/null
+++ b/alembic/versions/0006_revoke_provider_override_nonadmin.py
@@ -0,0 +1,77 @@
+"""revoke providers:override:self from non-admin roles
+
+Revision ID: 0006_revoke_provider_override_nonadmin
+Revises: 0005_user_fk_ondelete
+Create Date: 2026-06-02 00:00:00.000000
+
+Providers are now admin-only. The 0002 seed granted ``providers:override:self``
+to the built-in ``developer`` and ``user`` roles, and the seeder
+(``db.seed.seed_roles_and_permissions``) is additive-only, so removing the
+entry from the catalog map does not delete already-seeded rows on existing
+installs. This migration deletes those two ``role_permissions`` join rows.
+
+The permission itself stays in the catalog (admin still owns it), so only the
+join rows for the two non-admin roles are removed.
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+revision: str = "0006_revoke_provider_override_nonadmin"
+down_revision: str | Sequence[str] | None = "0005_user_fk_ondelete"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+_PERM_NAME = "providers:override:self"
+_ROLE_NAMES = ["developer", "user"]
+
+
+def upgrade() -> None:
+ op.execute(
+ sa.text(
+ "DELETE FROM role_permissions WHERE permission_id IN "
+ "(SELECT id FROM permissions WHERE name = :perm) "
+ "AND role_id IN (SELECT id FROM roles WHERE name IN :roles)"
+ ).bindparams(
+ sa.bindparam("perm", _PERM_NAME),
+ sa.bindparam("roles", _ROLE_NAMES, expanding=True),
+ )
+ )
+
+
+def downgrade() -> None:
+ # Best-effort: re-grant the two join rows this migration removed.
+ bind = op.get_bind()
+ perm_id = bind.execute(
+ sa.text("SELECT id FROM permissions WHERE name = :perm"),
+ {"perm": _PERM_NAME},
+ ).scalar()
+ if perm_id is None:
+ return
+ role_ids = [
+ row[0]
+ for row in bind.execute(
+ sa.text("SELECT id FROM roles WHERE name IN :roles").bindparams(
+ sa.bindparam("roles", _ROLE_NAMES, expanding=True)
+ )
+ ).fetchall()
+ ]
+ existing = {
+ row[0]
+ for row in bind.execute(
+ sa.text("SELECT role_id FROM role_permissions WHERE permission_id = :perm_id"),
+ {"perm_id": perm_id},
+ ).fetchall()
+ }
+ rp_table = sa.table(
+ "role_permissions",
+ sa.column("role_id", sa.String),
+ sa.column("permission_id", sa.String),
+ )
+ rows = [{"role_id": rid, "permission_id": perm_id} for rid in role_ids if rid not in existing]
+ if rows:
+ op.bulk_insert(rp_table, rows)
diff --git a/frontend/app/api/queries/useProviderHealthQuery.ts b/frontend/app/api/queries/useProviderHealthQuery.ts
index ab34e9b1c..665d220f5 100644
--- a/frontend/app/api/queries/useProviderHealthQuery.ts
+++ b/frontend/app/api/queries/useProviderHealthQuery.ts
@@ -4,6 +4,7 @@ import {
useQueryClient,
} from "@tanstack/react-query";
import { useChat } from "@/contexts/chat-context";
+import { usePermissions } from "@/hooks/use-permissions";
import { useGetSettingsQuery } from "./useGetSettingsQuery";
import { useGetTasksQuery } from "./useGetTasksQuery";
@@ -44,6 +45,12 @@ export const useProviderHealthQuery = (
// Get chat error state and onboarding completion from context (ChatProvider wraps the entire app in layout.tsx)
const { hasChatError, setChatError, isOnboardingComplete } = useChat();
+ // Provider health is admin-only (backend gates /provider/health on
+ // providers:read). Don't poll it for non-admins under enforced RBAC —
+ // it would only 403. When RBAC is off, behave exactly as before.
+ const { can, rbacEnforced } = usePermissions();
+ const providerHealthAllowed = !rbacEnforced || can("providers:read");
+
const { data: settings = {} } = useGetSettingsQuery();
// Check if there are any active ingestion tasks
@@ -161,6 +168,7 @@ export const useProviderHealthQuery = (
!!settings?.edited &&
isOnboardingComplete &&
!hasActiveIngestion && // Disable health checks when ingestion is happening
+ providerHealthAllowed && // Admin-only under enforced RBAC
options?.enabled !== false, // Only run after onboarding is complete
...options,
},
diff --git a/frontend/app/onboarding/_components/onboarding-blocked.tsx b/frontend/app/onboarding/_components/onboarding-blocked.tsx
new file mode 100644
index 000000000..3bbd968ce
--- /dev/null
+++ b/frontend/app/onboarding/_components/onboarding-blocked.tsx
@@ -0,0 +1,34 @@
+"use client";
+
+import Logo from "@/components/icons/openrag-logo";
+
+/**
+ * Shown to non-admin users when the workspace has not been onboarded yet.
+ *
+ * Onboarding is admin-only (the backend gates it behind `config:write`), so
+ * non-admins can't run the wizard. Instead of the onboarding flow, they see
+ * this "contact your administrator" screen. It renders inside the same card
+ * shell as the onboarding wizard (see `chat-renderer.tsx`), so it inherits the
+ * wizard's container sizing and entrance animation — this component only needs
+ * to fill that card and center its content.
+ */
+export function OnboardingBlocked() {
+ return (
+ <div className="flex h-full w-full flex-col items-center justify-center gap-6 px-8 text-center">
+ <Logo className="fill-primary" width={50} height={40} />
+ <h1 className="text-2xl font-medium font-chivo">
+ OpenRAG isn&apos;t set up yet
+ </h1>
+ <p className="max-w-md text-muted-foreground">
+ An admin needs to finish setting up OpenRAG for this workspace before it
+ can be used. Once that&apos;s done, check back here.
+ </p>
+ <button
+ onClick={() => window.location.reload()}
+ className="px-4 py-2 bg-primary text-primary-foreground rounded-md hover:bg-primary/90"
+ >
+ Refresh
+ </button>
+ </div>
+ );
+}
diff --git a/frontend/app/settings/[tab]/page.tsx b/frontend/app/settings/[tab]/page.tsx
index eebf471ad..ef1b44675 100644
--- a/frontend/app/settings/[tab]/page.tsx
+++ b/frontend/app/settings/[tab]/page.tsx
@@ -65,6 +65,10 @@ export default async function SettingsTabPage({
) {
redirect("/settings/connectors");
}
+ // Langflow tab edits agent + ingest settings (workspace config) — admin-only.
+ if (tab === "langflow" && !isNoAuthMode && !permissions.has("config:write")) {
+ redirect("/settings/connectors");
+ }
const queryClient = getQueryClient();
try {
diff --git a/frontend/app/settings/_components/settings-nav.tsx b/frontend/app/settings/_components/settings-nav.tsx
index 0dce0d53a..4baa62745 100644
--- a/frontend/app/settings/_components/settings-nav.tsx
+++ b/frontend/app/settings/_components/settings-nav.tsx
@@ -10,7 +10,8 @@ import { cn } from "@/lib/utils";
const TABS = [
{ value: "connectors", label: "Connectors" },
{ value: "providers", label: "Providers", perm: "providers:write" },
- { value: "langflow", label: "Langflow" },
+ // Agent + ingest settings write workspace config (admin-only).
+ { value: "langflow", label: "Langflow", perm: "config:write" },
{ value: "api-keys", label: "API Keys", apiKeysTab: true },
] as const;
diff --git a/frontend/components/chat-renderer.tsx b/frontend/components/chat-renderer.tsx
index f15c1bc85..43d3b4af3 100644
--- a/frontend/components/chat-renderer.tsx
+++ b/frontend/components/chat-renderer.tsx
@@ -2,6 +2,7 @@
import { useQueryClient } from "@tanstack/react-query";
import { motion } from "framer-motion";
+import { Loader2 } from "lucide-react";
import { usePathname, useRouter } from "next/navigation";
import { useCallback, useEffect, useState } from "react";
import { useUpdateOnboardingStateMutation } from "@/app/api/mutations/useUpdateOnboardingStateMutation";
@@ -11,6 +12,7 @@ import {
} from "@/app/api/queries/useGetConversationsQuery";
import { getFilterById } from "@/app/api/queries/useGetFilterByIdQuery";
import type { Settings } from "@/app/api/queries/useGetSettingsQuery";
+import { OnboardingBlocked } from "@/app/onboarding/_components/onboarding-blocked";
import { OnboardingContent } from "@/app/onboarding/_components/onboarding-content";
import { ProgressBar } from "@/app/onboarding/_components/progress-bar";
import { AnimatedConditional } from "@/components/animated-conditional";
@@ -18,6 +20,7 @@ import { Navigation } from "@/components/navigation";
import { useAuth } from "@/contexts/auth-context";
import { useIsCloudBrand } from "@/contexts/brand-context";
import { useChat } from "@/contexts/chat-context";
+import { usePermissions } from "@/hooks/use-permissions";
import { page } from "@/lib/analytics";
import {
ANIMATION_DURATION,
@@ -38,6 +41,7 @@ export function ChatRenderer({
const router = useRouter();
const queryClient = useQueryClient(); // Move hook to component level
const { isAuthenticated, isNoAuthMode } = useAuth();
+ const { can, isLoading: isPermLoading, rbacEnforced } = usePermissions();
const isCloudBrand = useIsCloudBrand();
const {
endpoint,
@@ -253,6 +257,22 @@ export function ChatRenderer({
const translateY = showLayout ? "0px" : `-50vh`;
const translateX = showLayout ? "0px" : `-50vw`;
+ // Onboarding is admin-only. When the workspace still needs onboarding
+ // (!showLayout) and RBAC is enforced, a non-admin must not see the wizard —
+ // they get a "contact your administrator" screen instead. It renders inside
+ // the same card shell as the wizard (below), so it shares the wizard's
+ // container sizing and entrance animation. Wait for the permission set to
+ // resolve first so the wizard never flashes for them.
+ const needsOnboardingGate = !showLayout && rbacEnforced && !isNoAuthMode;
+ if (needsOnboardingGate && isPermLoading) {
+ return (
+ <div className="min-h-dvh flex items-center justify-center bg-background">
+ <Loader2 className="h-8 w-8 animate-spin text-muted-foreground" />
+ </div>
+ );
+ }
+ const isOnboardingBlocked = needsOnboardingGate && !can("config:write");
+
// For all other pages, render with Langflow-styled navigation and task menu
return (
<>
@@ -336,28 +356,33 @@ export function ChatRenderer({
{children}
</div>
)}
- {!showLayout && (
- <OnboardingContent
- handleStepComplete={handleStepComplete}
- handleStepBack={handleStepBack}
- currentStep={currentStep}
- />
- )}
+ {!showLayout &&
+ (isOnboardingBlocked ? (
+ <OnboardingBlocked />
+ ) : (
+ <OnboardingContent
+ handleStepComplete={handleStepComplete}
+ handleStepBack={handleStepBack}
+ currentStep={currentStep}
+ />
+ ))}
</motion.div>
</div>
</motion.div>
- <motion.div
- initial={{ opacity: 0, y: 20 }}
- animate={{ opacity: showLayout ? 0 : 1, y: showLayout ? 20 : 0 }}
- transition={{ duration: ANIMATION_DURATION, ease: "easeOut" }}
- className={cn("absolute bottom-6 left-0 right-0")}
- >
- <ProgressBar
- currentStep={currentStep}
- totalSteps={TOTAL_ONBOARDING_STEPS}
- onSkip={handleSkipOnboarding}
- />
- </motion.div>
+ {!isOnboardingBlocked && (
+ <motion.div
+ initial={{ opacity: 0, y: 20 }}
+ animate={{ opacity: showLayout ? 0 : 1, y: showLayout ? 20 : 0 }}
+ transition={{ duration: ANIMATION_DURATION, ease: "easeOut" }}
+ className={cn("absolute bottom-6 left-0 right-0")}
+ >
+ <ProgressBar
+ currentStep={currentStep}
+ totalSteps={TOTAL_ONBOARDING_STEPS}
+ onSkip={handleSkipOnboarding}
+ />
+ </motion.div>
+ )}
</main>
</>
);
diff --git a/src/api/models.py b/src/api/models.py
index c99d06397..9311f681d 100644
--- a/src/api/models.py
+++ b/src/api/models.py
@@ -1,34 +1,33 @@
-from typing import Optional
-
from fastapi import Depends
-from pydantic import BaseModel
from fastapi.responses import JSONResponse
-from utils.logging_config import get_logger
+from pydantic import BaseModel
+
from config.settings import get_openrag_config
-from dependencies import get_models_service, get_current_user
+from dependencies import get_models_service, require_permission
from session_manager import User
+from utils.logging_config import get_logger
logger = get_logger(__name__)
class OpenAIBody(BaseModel):
- api_key: Optional[str] = None
+ api_key: str | None = None
class AnthropicBody(BaseModel):
- api_key: Optional[str] = None
+ api_key: str | None = None
class IBMBody(BaseModel):
- api_key: Optional[str] = None
- endpoint: Optional[str] = None
- project_id: Optional[str] = None
+ api_key: str | None = None
+ endpoint: str | None = None
+ project_id: str | None = None
async def get_openai_models(
- body: Optional[OpenAIBody] = None,
+ body: OpenAIBody | None = None,
models_service=Depends(get_models_service),
- user: User = Depends(get_current_user),
+ user: User = Depends(require_permission("providers:read")),
):
"""Get available OpenAI models"""
try:
@@ -50,13 +49,13 @@ async def get_openai_models(
return JSONResponse(models)
except Exception as e:
logger.error(f"Failed to get OpenAI models: {str(e)}")
- return JSONResponse({"error": f"Failed to retrieve OpenAI models: {str(e)}"}, status_code=500)
+ return JSONResponse({"error": "Failed to retrieve OpenAI models"}, status_code=500)
async def get_anthropic_models(
- body: Optional[AnthropicBody] = None,
+ body: AnthropicBody | None = None,
models_service=Depends(get_models_service),
- user: User = Depends(get_current_user),
+ user: User = Depends(require_permission("providers:read")),
):
"""Get available Anthropic models"""
try:
@@ -70,7 +69,9 @@ async def get_anthropic_models(
if not api_key:
return JSONResponse(
- {"error": "Anthropic API key is required either in request body or in configuration"},
+ {
+ "error": "Anthropic API key is required either in request body or in configuration"
+ },
status_code=400,
)
@@ -78,13 +79,13 @@ async def get_anthropic_models(
return JSONResponse(models)
except Exception as e:
logger.error(f"Failed to get Anthropic models: {str(e)}")
- return JSONResponse({"error": f"Failed to retrieve Anthropic models: {str(e)}"}, status_code=500)
+ return JSONResponse({"error": "Failed to retrieve Anthropic models"}, status_code=500)
async def get_ollama_models(
- endpoint: Optional[str] = None,
+ endpoint: str | None = None,
models_service=Depends(get_models_service),
- user: User = Depends(get_current_user),
+ user: User = Depends(require_permission("providers:read")),
):
"""Get available Ollama models"""
try:
@@ -105,13 +106,13 @@ async def get_ollama_models(
return JSONResponse(models)
except Exception as e:
logger.error(f"Failed to get Ollama models: {str(e)}")
- return JSONResponse({"error": f"Failed to retrieve Ollama models: {str(e)}"}, status_code=500)
+ return JSONResponse({"error": "Failed to retrieve Ollama models"}, status_code=500)
async def get_ibm_models(
- body: Optional[IBMBody] = None,
+ body: IBMBody | None = None,
models_service=Depends(get_models_service),
- user: User = Depends(get_current_user),
+ user: User = Depends(require_permission("providers:read")),
):
"""Get available IBM Watson models"""
try:
@@ -162,4 +163,4 @@ async def get_ibm_models(
return JSONResponse(models)
except Exception as e:
logger.error(f"Failed to get IBM models: {str(e)}")
- return JSONResponse({"error": f"Failed to retrieve IBM models: {str(e)}"}, status_code=500)
+ return JSONResponse({"error": "Failed to retrieve IBM models"}, status_code=500)
diff --git a/src/api/provider_health.py b/src/api/provider_health.py
index a10cf8a2b..adb27636a 100644
--- a/src/api/provider_health.py
+++ b/src/api/provider_health.py
@@ -8,7 +8,7 @@ from fastapi.responses import JSONResponse
from api.provider_validation import validate_provider_setup
from config.settings import get_openrag_config
-from dependencies import get_current_user
+from dependencies import require_permission
from session_manager import User
from utils import provider_health_cache
from utils.logging_config import get_logger
@@ -19,7 +19,7 @@ logger = get_logger(__name__)
async def check_provider_health(
provider: str | None = None,
test_completion: bool = False,
- user: User = Depends(get_current_user),
+ user: User = Depends(require_permission("providers:read")),
):
"""
Check if the configured provider is healthy and properly validated.
diff --git a/src/api/settings/endpoints.py b/src/api/settings/endpoints.py
index a9345caff..21a2997e3 100644
--- a/src/api/settings/endpoints.py
+++ b/src/api/settings/endpoints.py
@@ -76,11 +76,13 @@ from dependencies import (
get_knowledge_filter_service,
get_langflow_file_service,
get_models_service,
+ get_rbac_service,
get_session_manager,
get_task_service,
require_permission,
)
from services.docling_service import DoclingConfig, get_docling_preset_configs
+from services.rbac_service import is_rbac_enforced
from session_manager import User
from utils import provider_health_cache
from utils.langflow_utils import LangflowNotReadyError, wait_for_langflow
@@ -95,11 +97,19 @@ async def get_settings(
request: Request,
session_manager=Depends(get_session_manager),
user: User = Depends(get_current_user),
+ rbac=Depends(get_rbac_service),
) -> SettingsResponse:
"""Get application settings"""
try:
openrag_config = get_openrag_config()
+ # Provider configuration is admin-only. Non-admins still get the rest of
+ # settings (the UI needs them) but the providers section is redacted.
+ show_providers = True
+ if is_rbac_enforced():
+ uid = user.db_user_id or user.user_id
+ show_providers = await rbac.has_permission(uid, "providers:read")
+
knowledge_config = openrag_config.knowledge
agent_config = openrag_config.agent
@@ -201,7 +211,9 @@ async def get_settings(
endpoint=openrag_config.providers.ollama.endpoint or None,
configured=openrag_config.providers.ollama.configured,
),
- ),
+ )
+ if show_providers
+ else None,
knowledge=KnowledgeConfig(
embedding_model=knowledge_config.embedding_model,
embedding_provider=knowledge_config.embedding_provider,
@@ -237,6 +249,7 @@ async def update_settings(
session_manager=Depends(get_session_manager),
user: User = Depends(require_permission("config:write")),
models_service=Depends(get_models_service),
+ rbac=Depends(get_rbac_service),
) -> SettingsUpdateResponse:
"""Update settings in configuration"""
try:
@@ -267,6 +280,18 @@ async def update_settings(
should_validate = any(getattr(body, field) is not None for field in provider_fields)
+ # Provider changes are admin-only. The outer gate only requires
+ # config:write; require providers:write specifically when any
+ # provider field is being touched (defends custom roles too).
+ if should_validate and is_rbac_enforced() and hasattr(rbac, "has_permission"):
+ uid = user.db_user_id or user.user_id
+ if not await rbac.has_permission(uid, "providers:write"):
+ await rbac.audit_denied(uid, "providers:write")
+ raise HTTPException(
+ status_code=403,
+ detail={"error": "permission_denied", "required": "providers:write"},
+ )
+
if should_validate:
try:
logger.info("Running provider validation before modifying config")
diff --git a/src/api/settings/models.py b/src/api/settings/models.py
index 851c93da2..71aba280e 100644
--- a/src/api/settings/models.py
+++ b/src/api/settings/models.py
@@ -152,7 +152,8 @@ class SettingsResponse(BaseModel):
langflow_public_url: str | None
edited: bool
onboarding: OnboardingStateConfig
- providers: ProvidersConfig
+ # None when the caller lacks `providers:read` (RBAC redaction for non-admins).
+ providers: ProvidersConfig | None = None
knowledge: KnowledgeConfig
agent: AgentConfig
localhost_url: str
diff --git a/src/api/v1/models.py b/src/api/v1/models.py
index 7c48c762a..861e2c4b6 100644
--- a/src/api/v1/models.py
+++ b/src/api/v1/models.py
@@ -9,7 +9,7 @@ from fastapi import Depends
from fastapi.responses import JSONResponse
from config.settings import get_openrag_config
-from dependencies import get_api_key_user_async, get_models_service
+from dependencies import get_models_service, require_api_key_permission
from session_manager import User
from utils.logging_config import get_logger
@@ -72,7 +72,7 @@ async def _fetch_models(provider, config, models_service):
async def list_models_endpoint(
provider: str,
models_service=Depends(get_models_service),
- user: User = Depends(get_api_key_user_async),
+ user: User = Depends(require_api_key_permission("providers:read")),
):
"""
List available language and embedding models for a provider.
diff --git a/src/api/v1/settings.py b/src/api/v1/settings.py
index db6f3a4d3..1cdef8e46 100644
--- a/src/api/v1/settings.py
+++ b/src/api/v1/settings.py
@@ -12,8 +12,8 @@ from pydantic import BaseModel
from api.settings import SettingsUpdateBody
from config.settings import get_openrag_config
from dependencies import (
- get_api_key_user_async,
get_models_service,
+ get_rbac_service,
get_session_manager,
require_api_key_permission,
)
@@ -45,7 +45,7 @@ class SettingsResponse(BaseModel):
async def get_settings_endpoint(
- user: User = Depends(get_api_key_user_async),
+ user: User = Depends(require_api_key_permission("providers:read")),
) -> SettingsResponse:
"""Get current OpenRAG configuration (read-only). GET /v1/settings"""
try:
@@ -76,10 +76,15 @@ async def update_settings_endpoint(
session_manager=Depends(get_session_manager),
user: User = Depends(require_api_key_permission("config:write")),
models_service=Depends(get_models_service),
+ rbac=Depends(get_rbac_service),
):
"""Update OpenRAG configuration settings. POST /v1/settings"""
from api.settings import update_settings
return await update_settings(
- body=body, session_manager=session_manager, user=user, models_service=models_service
+ body=body,
+ session_manager=session_manager,
+ user=user,
+ models_service=models_service,
+ rbac=rbac,
)
diff --git a/src/db/seed.py b/src/db/seed.py
index 17efcd7b3..5633a6069 100644
--- a/src/db/seed.py
+++ b/src/db/seed.py
@@ -28,7 +28,6 @@ PERMISSIONS: list[tuple[str, str, str]] = [
("providers", "write", "Write workspace provider configuration"),
("providers", "override:self", "Override providers in own user preferences"),
("opensearch", "admin", "Administer OpenSearch security"),
-
# Users / RBAC
("users", "list", "List users"),
("users", "read", "Read user profile"),
@@ -40,7 +39,6 @@ PERMISSIONS: list[tuple[str, str, str]] = [
("roles", "edit", "Edit custom roles"),
("roles", "delete", "Delete custom roles"),
("audit", "read", "Read audit log"),
-
# Connectors
("connectors", "list:own", "List own connectors"),
("connectors", "list:all", "List all connectors in the workspace"),
@@ -48,7 +46,6 @@ PERMISSIONS: list[tuple[str, str, str]] = [
("connectors", "delete:own", "Delete own connectors"),
("connectors", "delete:any", "Delete any connector"),
("connectors", "use", "Use connector OAuth and browse"),
-
# Knowledge
("knowledge", "upload", "Upload documents"),
("knowledge", "delete:own", "Delete own documents"),
@@ -59,7 +56,6 @@ PERMISSIONS: list[tuple[str, str, str]] = [
("kf", "edit:own", "Edit own knowledge filters"),
("kf", "edit:any", "Edit any knowledge filter"),
("kf", "share", "Share knowledge filters"),
-
# Chat / search
("chat", "use", "Use chat"),
("search", "use", "Use search"),
@@ -67,13 +63,11 @@ PERMISSIONS: list[tuple[str, str, str]] = [
("conversations", "read:all", "Read all conversations"),
("conversations", "delete:own", "Delete own conversations"),
("conversations", "delete:any", "Delete any conversation"),
-
# Flows / agent
("flows", "read", "Read flows"),
("flows", "edit", "Edit flows"),
("agent", "prompt:override", "Override agent system prompt for self"),
("agent", "prompt:global", "Edit global agent system prompt"),
-
# API keys
("apikeys", "create:self", "Create own API keys"),
("apikeys", "revoke:self", "Revoke own API keys"),
@@ -93,7 +87,11 @@ def permission_name(resource: str, action: str) -> str:
BUILTIN_ROLES: list[tuple[str, str, str]] = [
# (id, name, description)
("role-admin", "admin", "Full control over infra, users, and all data."),
- ("role-developer", "developer", "Manages own connectors, flows, and ingestion. No infra writes."),
+ (
+ "role-developer",
+ "developer",
+ "Manages own connectors, flows, and ingestion. No infra writes.",
+ ),
("role-user", "user", "Default end-user. Chat, search, and own connectors."),
("role-viewer", "viewer", "Read-only chat and search."),
]
@@ -105,36 +103,57 @@ def _admin_perms() -> set[str]:
def _developer_perms() -> set[str]:
return {
- "providers:override:self",
- "connectors:list:own", "connectors:create", "connectors:delete:own", "connectors:use",
- "knowledge:upload", "knowledge:delete:own", "knowledge:read:own",
- "kf:create", "kf:edit:own",
- "chat:use", "search:use",
- "conversations:read:own", "conversations:delete:own",
- "flows:read", "flows:edit",
+ # NOTE: providers are admin-only — no provider perms for developers.
+ "connectors:list:own",
+ "connectors:create",
+ "connectors:delete:own",
+ "connectors:use",
+ "knowledge:upload",
+ "knowledge:delete:own",
+ "knowledge:read:own",
+ "kf:create",
+ "kf:edit:own",
+ "chat:use",
+ "search:use",
+ "conversations:read:own",
+ "conversations:delete:own",
+ "flows:read",
+ "flows:edit",
"agent:prompt:override",
- "apikeys:create:self", "apikeys:revoke:self",
+ "apikeys:create:self",
+ "apikeys:revoke:self",
}
def _user_perms() -> set[str]:
return {
- "providers:override:self",
- "connectors:list:own", "connectors:create", "connectors:delete:own", "connectors:use",
- "knowledge:upload", "knowledge:delete:own", "knowledge:read:own",
- "kf:create", "kf:edit:own",
- "chat:use", "search:use",
- "conversations:read:own", "conversations:delete:own",
+ # NOTE: providers are admin-only — no provider perms for users.
+ "connectors:list:own",
+ "connectors:create",
+ "connectors:delete:own",
+ "connectors:use",
+ "knowledge:upload",
+ "knowledge:delete:own",
+ "knowledge:read:own",
+ "kf:create",
+ "kf:edit:own",
+ "chat:use",
+ "search:use",
+ "conversations:read:own",
+ "conversations:delete:own",
"flows:read",
"agent:prompt:override",
- "apikeys:create:self", "apikeys:revoke:self",
+ "apikeys:create:self",
+ "apikeys:revoke:self",
}
def _viewer_perms() -> set[str]:
return {
- "chat:use", "search:use",
- "conversations:read:own", "conversations:delete:own",
+ "chat:use",
+ "search:use",
+ "conversations:read:own",
+ "conversations:delete:own",
"flows:read",
}
@@ -151,6 +170,7 @@ ROLE_PERMISSION_MAP: dict[str, set[str]] = {
# Idempotent seeder
# ---------------------------------------------------------------------------
+
async def seed_roles_and_permissions(session: AsyncSession) -> None:
"""Insert any missing roles/permissions/role_permissions. Safe to call repeatedly.
@@ -160,8 +180,7 @@ async def seed_roles_and_permissions(session: AsyncSession) -> None:
# Permissions
existing_perms = {
- p.name: p
- for p in (await session.execute(select(Permission))).scalars().all()
+ p.name: p for p in (await session.execute(select(Permission))).scalars().all()
}
perm_id_by_name: dict[str, str] = {p.name: p.id for p in existing_perms.values()}
@@ -183,10 +202,7 @@ async def seed_roles_and_permissions(session: AsyncSession) -> None:
await session.flush()
# Roles
- existing_roles = {
- r.name: r
- for r in (await session.execute(select(Role))).scalars().all()
- }
+ existing_roles = {r.name: r for r in (await session.execute(select(Role))).scalars().all()}
for role_id, role_name, description in BUILTIN_ROLES:
if role_name in existing_roles:
continue
@@ -201,10 +217,7 @@ async def seed_roles_and_permissions(session: AsyncSession) -> None:
await session.flush()
# Re-fetch so we have IDs for the just-inserted rows.
- role_id_by_name = {
- r.name: r.id
- for r in (await session.execute(select(Role))).scalars().all()
- }
+ role_id_by_name = {r.name: r.id for r in (await session.execute(select(Role))).scalars().all()}
# Role permissions (additive only — never remove perms set by an admin via UI)
existing_rp = set(