Agent Zero
359 lines
12 KiB
Python
359 lines
12 KiB
Python
"""Universal entity permission routes — ACL management for ALL entities."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import uuid
|
|
|
|
from fastapi import APIRouter, Depends, HTTPException, status
|
|
from pydantic import BaseModel, Field
|
|
from sqlalchemy.ext.asyncio import AsyncSession
|
|
|
|
from app.core.db import get_db
|
|
from app.core.rate_limit import check_rate_limit
|
|
from app.deps import get_current_user, get_redis_dep, require_permission
|
|
from app.schemas.entity_permission import (
|
|
EntityPermissionCreate,
|
|
EntityPermissionUpdate,
|
|
)
|
|
from app.services import bulk_permission_service, entity_permission_service
|
|
|
|
router = APIRouter(prefix="/api/v1/permissions", tags=["entity-permissions"])
|
|
|
|
|
|
class BulkShareRequest(BaseModel):
|
|
"""Bulk-share multiple entities with a principal."""
|
|
|
|
entity_type: str = Field(..., min_length=1)
|
|
entity_ids: list[str] = Field(..., min_length=1)
|
|
principal_type: str = Field(..., pattern="^(user|group|guest)$")
|
|
principal_id: str = Field(..., min_length=1)
|
|
level: str = Field(..., pattern="^(read|write|admin|delete|owner)$")
|
|
|
|
|
|
class BulkUnshareRequest(BaseModel):
|
|
"""Bulk-remove permissions for a principal from multiple entities."""
|
|
|
|
entity_type: str = Field(..., min_length=1)
|
|
entity_ids: list[str] = Field(..., min_length=1)
|
|
principal_type: str = Field(..., pattern="^(user|group|guest)$")
|
|
principal_id: str = Field(..., min_length=1)
|
|
|
|
# Rate limits for permission changes (prevent abuse/DoS)
|
|
_PERM_RATE_LIMIT_MAX = 50 # max changes per minute
|
|
_PERM_RATE_LIMIT_WINDOW = 60 # 60 seconds
|
|
|
|
|
|
@router.get("/{entity_type}/{entity_id}")
|
|
async def list_entity_permissions(
|
|
entity_type: str,
|
|
entity_id: str,
|
|
db: AsyncSession = Depends(get_db),
|
|
current_user: dict = Depends(get_current_user),
|
|
):
|
|
"""List all permission entries for a specific entity."""
|
|
tenant_id = uuid.UUID(current_user["tenant_id"])
|
|
try:
|
|
items = await entity_permission_service.list_permissions(
|
|
db, tenant_id, entity_type, entity_id
|
|
)
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=400, detail=str(e)) from e
|
|
return {"items": items, "total": len(items)}
|
|
|
|
|
|
@router.post("/{entity_type}/{entity_id}", status_code=status.HTTP_201_CREATED)
|
|
async def create_entity_permission(
|
|
entity_type: str,
|
|
entity_id: str,
|
|
body: EntityPermissionCreate,
|
|
db: AsyncSession = Depends(get_db),
|
|
current_user: dict = Depends(get_current_user),
|
|
redis = Depends(get_redis_dep),
|
|
):
|
|
"""Grant or update a permission on any entity for a user, group, role, or guest."""
|
|
tenant_id = uuid.UUID(current_user["tenant_id"])
|
|
user_id = uuid.UUID(current_user["user_id"])
|
|
is_system_admin = current_user.get("is_system_admin", False)
|
|
# Permission check: only owner/admin/system_admin can manage permissions
|
|
if not is_system_admin:
|
|
access = await entity_permission_service.get_effective_access(
|
|
db, tenant_id, user_id, entity_type, uuid.UUID(entity_id)
|
|
)
|
|
if access not in ("owner", "admin", "delete"):
|
|
raise HTTPException(status_code=403, detail="Sie benötigen Admin-Rechte auf diesen Datensatz, um Berechtigungen zu verwalten")
|
|
# Rate limit: max 50 permission changes per minute per user
|
|
await check_rate_limit(
|
|
f"perm_change:{user_id}",
|
|
_PERM_RATE_LIMIT_MAX,
|
|
_PERM_RATE_LIMIT_WINDOW,
|
|
)
|
|
try:
|
|
result = await entity_permission_service.create_permission(
|
|
db,
|
|
tenant_id,
|
|
entity_type,
|
|
entity_id,
|
|
body.principal_type,
|
|
body.principal_id,
|
|
body.permission_level,
|
|
body.expires_at,
|
|
created_by=user_id,
|
|
redis=redis,
|
|
)
|
|
return result
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=400, detail=str(e)) from e
|
|
|
|
|
|
async def _check_entity_ownership(
|
|
db: AsyncSession,
|
|
tenant_id: uuid.UUID,
|
|
user_id: uuid.UUID,
|
|
entity_type: str,
|
|
entity_id: str,
|
|
is_system_admin: bool,
|
|
) -> None:
|
|
"""Verify that the current user owns the entity or is system admin.
|
|
|
|
Raises 403 if the user is neither owner nor system admin.
|
|
"""
|
|
if is_system_admin:
|
|
return
|
|
|
|
from sqlalchemy import select
|
|
|
|
from app.services.entity_permission_service import ENTITY_MODELS
|
|
|
|
model_info = ENTITY_MODELS.get(entity_type)
|
|
if model_info is None:
|
|
raise HTTPException(
|
|
status_code=status.HTTP_404_NOT_FOUND,
|
|
detail={"detail": f"Unknown entity type: {entity_type}", "code": "not_found"},
|
|
)
|
|
|
|
model = model_info # ENTITY_MODELS maps directly to model classes
|
|
try:
|
|
eid = uuid.UUID(entity_id)
|
|
except ValueError:
|
|
raise HTTPException(
|
|
status_code=status.HTTP_400_BAD_REQUEST,
|
|
detail={"detail": "Invalid entity_id", "code": "invalid_id"},
|
|
) from None
|
|
|
|
result = await db.execute(
|
|
select(model.owner_id).where(
|
|
model.id == eid,
|
|
model.tenant_id == tenant_id,
|
|
)
|
|
)
|
|
row = result.first()
|
|
if row is None:
|
|
raise HTTPException(
|
|
status_code=status.HTTP_404_NOT_FOUND,
|
|
detail={"detail": "Entity not found", "code": "not_found"},
|
|
)
|
|
owner_id = row[0]
|
|
if owner_id is not None and owner_id != user_id:
|
|
raise HTTPException(
|
|
status_code=status.HTTP_403_FORBIDDEN,
|
|
detail={"detail": "Only the entity owner or system admin can modify permissions", "code": "forbidden"},
|
|
)
|
|
|
|
|
|
@router.put("/{entity_type}/{entity_id}/{permission_id}")
|
|
async def update_entity_permission(
|
|
entity_type: str,
|
|
entity_id: str,
|
|
permission_id: str,
|
|
body: EntityPermissionUpdate,
|
|
db: AsyncSession = Depends(get_db),
|
|
current_user: dict = Depends(get_current_user),
|
|
):
|
|
"""Update an existing permission entry."""
|
|
tenant_id = uuid.UUID(current_user["tenant_id"])
|
|
user_id = uuid.UUID(current_user["user_id"])
|
|
await check_rate_limit(
|
|
f"perm_change:{user_id}",
|
|
_PERM_RATE_LIMIT_MAX,
|
|
_PERM_RATE_LIMIT_WINDOW,
|
|
)
|
|
# Ownership check: only owner or system admin can update permissions
|
|
await _check_entity_ownership(
|
|
db, tenant_id, user_id, entity_type, entity_id,
|
|
current_user.get("is_system_admin", False),
|
|
)
|
|
try:
|
|
return await entity_permission_service.update_permission(
|
|
db,
|
|
tenant_id,
|
|
permission_id,
|
|
body.permission_level,
|
|
body.expires_at,
|
|
)
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=404, detail=str(e)) from e
|
|
|
|
|
|
@router.delete("/{entity_type}/{entity_id}/{permission_id}", status_code=status.HTTP_204_NO_CONTENT)
|
|
async def delete_entity_permission(
|
|
entity_type: str,
|
|
entity_id: str,
|
|
permission_id: str,
|
|
db: AsyncSession = Depends(get_db),
|
|
current_user: dict = Depends(get_current_user),
|
|
):
|
|
"""Revoke a permission entry."""
|
|
tenant_id = uuid.UUID(current_user["tenant_id"])
|
|
user_id = uuid.UUID(current_user["user_id"])
|
|
await check_rate_limit(
|
|
f"perm_change:{user_id}",
|
|
_PERM_RATE_LIMIT_MAX,
|
|
_PERM_RATE_LIMIT_WINDOW,
|
|
)
|
|
try:
|
|
await entity_permission_service.delete_permission(db, tenant_id, permission_id)
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=404, detail=str(e)) from e
|
|
|
|
|
|
@router.get("/{entity_type}/{entity_id}/access")
|
|
async def get_entity_access(
|
|
entity_type: str,
|
|
entity_id: str,
|
|
db: AsyncSession = Depends(get_db),
|
|
current_user: dict = Depends(get_current_user),
|
|
):
|
|
"""Get effective access level for the current user on an entity."""
|
|
tenant_id = uuid.UUID(current_user["tenant_id"])
|
|
user_id = uuid.UUID(current_user["user_id"])
|
|
access = await entity_permission_service.get_effective_access(
|
|
db, tenant_id, user_id, entity_type, uuid.UUID(entity_id)
|
|
)
|
|
is_owner = access == "owner"
|
|
is_shared = access not in ("none", "owner")
|
|
return {
|
|
"entity_type": entity_type,
|
|
"entity_id": entity_id,
|
|
"access_level": access,
|
|
"is_owner": is_owner,
|
|
"is_shared": is_shared,
|
|
}
|
|
|
|
|
|
@router.get("/all")
|
|
async def list_all_permissions(
|
|
db: AsyncSession = Depends(get_db),
|
|
current_user: dict = Depends(require_permission("settings:read")),
|
|
):
|
|
"""List ALL permission entries for the current tenant."""
|
|
tenant_id = uuid.UUID(current_user["tenant_id"])
|
|
items = await entity_permission_service.list_all_permissions(db, tenant_id)
|
|
return {"items": items, "total": len(items)}
|
|
|
|
|
|
@router.get("/registry")
|
|
async def list_entity_registry(
|
|
current_user: dict = Depends(get_current_user),
|
|
):
|
|
"""List all registered entity types that support permissions.
|
|
|
|
Generated dynamically from the entity model registry (ARCH-016): core
|
|
models plus every entity registered by an active plugin at activation
|
|
time. Plugin entities appear automatically without touching this file.
|
|
"""
|
|
from app.services.entity_permission_service import ENTITY_MODELS
|
|
|
|
# Human-readable labels for known types; plugin entities fall back to a
|
|
# title-cased entity_type so they are still presentable.
|
|
_labels = {
|
|
"contact": "Kontakte",
|
|
"contact_folder": "Ordner",
|
|
"address": "Adressen",
|
|
"attachment": "Anhänge",
|
|
"bank_account": "Bankkonten",
|
|
"workflow": "Workflows",
|
|
"sequence": "Sequenzen",
|
|
"saved_filter": "Gespeicherte Filter",
|
|
"saved_view": "Gespeicherte Ansichten",
|
|
"webhook": "Webhooks",
|
|
"notification": "Benachrichtigungen",
|
|
"custom_field_definition": "Custom Fields",
|
|
}
|
|
|
|
seen_models: set[int] = set()
|
|
entity_types: list[dict[str, str]] = []
|
|
for entity_type, model_class in ENTITY_MODELS.items():
|
|
# Skip aliases pointing at the same model (contact/contacts/company)
|
|
if id(model_class) in seen_models:
|
|
continue
|
|
seen_models.add(id(model_class))
|
|
table = getattr(model_class, "__tablename__", f"{entity_type}s")
|
|
entity_types.append({
|
|
"entity_type": entity_type,
|
|
"label": _labels.get(entity_type, entity_type.replace("_", " ").title()),
|
|
"table": table,
|
|
})
|
|
entity_types.sort(key=lambda e: e["entity_type"])
|
|
return {"items": entity_types, "total": len(entity_types)}
|
|
|
|
|
|
@router.post("/bulk", status_code=status.HTTP_201_CREATED)
|
|
async def bulk_share_permissions(
|
|
body: BulkShareRequest,
|
|
db: AsyncSession = Depends(get_db),
|
|
current_user: dict = Depends(require_permission("settings:write")),
|
|
):
|
|
"""Bulk share multiple entities with a principal."""
|
|
tenant_id = uuid.UUID(current_user["tenant_id"])
|
|
user_id = uuid.UUID(current_user["user_id"])
|
|
try:
|
|
result = await bulk_permission_service.bulk_share(
|
|
db,
|
|
tenant_id,
|
|
body.entity_type,
|
|
body.entity_ids,
|
|
body.principal_type,
|
|
body.principal_id,
|
|
body.level,
|
|
created_by=user_id,
|
|
)
|
|
return result
|
|
except (ValueError, KeyError) as e:
|
|
raise HTTPException(status_code=400, detail=str(e)) from e
|
|
|
|
|
|
@router.post("/bulk/unshare", status_code=status.HTTP_200_OK)
|
|
async def bulk_unshare_permissions(
|
|
body: BulkUnshareRequest,
|
|
db: AsyncSession = Depends(get_db),
|
|
current_user: dict = Depends(require_permission("settings:write")),
|
|
):
|
|
"""Bulk remove permissions for a principal from multiple entities."""
|
|
tenant_id = uuid.UUID(current_user["tenant_id"])
|
|
try:
|
|
result = await bulk_permission_service.bulk_unshare(
|
|
db,
|
|
tenant_id,
|
|
body.entity_type,
|
|
body.entity_ids,
|
|
body.principal_type,
|
|
body.principal_id,
|
|
)
|
|
return result
|
|
except (ValueError, KeyError) as e:
|
|
raise HTTPException(status_code=400, detail=str(e)) from e
|
|
|
|
|
|
@router.get("/analytics")
|
|
async def get_permission_analytics(
|
|
db: AsyncSession = Depends(get_db),
|
|
current_user: dict = Depends(require_permission("settings:read")),
|
|
):
|
|
"""Get permission analytics for the current tenant."""
|
|
tenant_id = uuid.UUID(current_user["tenant_id"])
|
|
try:
|
|
result = await entity_permission_service.get_permission_analytics(db, tenant_id)
|
|
return result
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=400, detail=str(e)) from e
|