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.

3.0 KB
Raw Blame
"""Activity-log receiver for access control rules.

``ModelActivityMixin`` emits ``model_activity_signal`` when a rule is saved or deleted. This
persists who granted, changed, or removed access. Registered from ``apps.ready()``.
"""

import dataclasses
from typing import Any, Optional

from posthog.models import User
from posthog.models.activity_logging.activity_log import (
    ActivityContextBase,
    Change,
    Detail,
    LogActivityEntry,
    changes_between,
    log_activity,
)
from posthog.models.signals import model_activity_signal, mutable_receiver

from products.access_control.backend.models.access_control import AccessControl


@dataclasses.dataclass(frozen=True)
class AccessControlContext(ActivityContextBase):
    resource: str
    resource_id: str | None
    access_level: str
    role_id: str | None
    organization_member_id: str | None


def get_access_control_log_entry(
    *,
    before_update: Optional[AccessControl],
    after_update: Optional[AccessControl],
    activity: str,
    user: Optional[User],
    was_impersonated: bool = False,
) -> LogActivityEntry | None:
    rule = after_update or before_update
    if rule is None:
        return None

    if activity == "created":
        changes = [Change(type="AccessControl", field="access_level", action="created", after=rule.access_level)]
    elif activity == "deleted":
        changes = [Change(type="AccessControl", field="access_level", action="deleted", before=rule.access_level)]
    else:
        changes = changes_between("AccessControl", previous=before_update, current=after_update)

    return LogActivityEntry(
        organization_id=rule.team.organization_id,
        team_id=rule.team_id,
        user=user,
        was_impersonated=was_impersonated,
        item_id=rule.id,
        scope="AccessControl",
        activity=activity,
        detail=Detail(
            name=f"{rule.resource} {rule.resource_id}" if rule.resource_id else rule.resource,
            changes=changes,
            context=AccessControlContext(
                resource=rule.resource,
                resource_id=rule.resource_id,
                access_level=rule.access_level,
                # Ids only: any activity-log reader sees this row, so it carries no names or emails.
                role_id=str(rule.role_id) if rule.role_id else None,
                organization_member_id=str(rule.organization_member_id) if rule.organization_member_id else None,
            ),
        ),
    )


@mutable_receiver(model_activity_signal, sender=AccessControl)
def handle_access_control_change(
    sender: type,
    scope: str,
    before_update: Optional[AccessControl],
    after_update: Optional[AccessControl],
    activity: str,
    user: Optional[User],
    was_impersonated: bool = False,
    **kwargs: Any,
) -> None:
    entry = get_access_control_log_entry(
        before_update=before_update,
        after_update=after_update,
        activity=activity,
        user=user,
        was_impersonated=was_impersonated,
    )
    if entry is not None:
        log_activity(**entry)