Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

2.2 KB
Raw Blame
"""Builds an authorization `Resource` from a model, with the facts the access rules read from it.

It lives outside the facade because it takes a Django model, which the facade must not accept.
"""

from django.db.models import Model

from posthog.models import Team

from products.access_control.backend.facade.user_access_control import (
    RESOURCE_FALLBACK_MAP,
    fallback_parent_object_id,
    model_to_resource,
)

from ..facade.contracts import Parent, Resource
from ..facade.enums import ResourceType

# These types answer from the user's membership level, so they carry no team, creator or parent.
MEMBERSHIP_RESOURCES = frozenset({ResourceType.ORGANIZATION, ResourceType.PROJECT})
# These types always read the object's own team, so a view team's admin can't reach another environment's object.
OWN_TEAM_RESOURCES = frozenset({ResourceType.DASHBOARD})


def resource_for_object(obj: Model, *, team: Team | None = None) -> Resource:
    """The `Resource` for one object, with its creator and the parent it falls back to.

    `project_id` is the object's team id, because access rules are scoped to a team. Pass `team`
    only where today's check reads another team's rules for this object, such as the view's team.
    `OWN_TEAM_RESOURCES` and `MEMBERSHIP_RESOURCES` ignore `team`.
    """
    scope = model_to_resource(obj)
    if scope is None:
        raise ValueError(f"{type(obj).__name__} has no access control resource.")
    resource_type = ResourceType(scope)
    if resource_type in MEMBERSHIP_RESOURCES:
        return Resource(type=resource_type, id=str(obj.pk))
    rules_team = None if resource_type in OWN_TEAM_RESOURCES else team
    team_id = rules_team.id if rules_team is not None else getattr(obj, "team_id", None)
    if team_id is None:
        raise ValueError(f"{type(obj).__name__} has no team, so its access rules cannot be resolved.")
    parent = RESOURCE_FALLBACK_MAP.get(scope)
    return Resource(
        type=resource_type,
        id=str(obj.pk),
        project_id=team_id,
        created_by_id=getattr(obj, "created_by_id", None),
        parent=Parent(type=ResourceType(parent), id=fallback_parent_object_id(obj, parent)) if parent else None,
    )