d27dd0ffbb
Close 12 audit-driven platform-compliance gaps on a single branch. - D4 dispatch: app/integrations/dispatch_client.py participant `legacyhub`, emits LegacyhubDocumentIndexed + AssetDerivativeReady after the indexing commit (idempotent uuid5), http_inbox route (reindex/tombstone) with audit-based dedupe; docs/dispatch-contract.md. Celery+Redis stays intra-module. - D2 SSO: app/integrations/identity.py validates X-TeamHub-* + role/scope mapper; security.py adds trusted-header enforcement (AUTH_REQUIRE_IDENTITY) and a scope check on /search; docker-compose.teamhub.yml (external teamhub_net + internal db net, api not host-published); RUNBOOK network/firewall section. - Asset standard: SearchHit/Citation carry asset_id/owner_module; buckets renamed teamhub-legacyhub-* (+quarantine/tmp/exports); purge-by-asset_id with legal-hold guard (app/indexing/projection.py); OCR-markdown derivative event. - audit_log model + Alembic 0003 + record_audit on writes (same transaction). - Secret masking: app/common/json_logger.py recursive mask wired into structlog (+ensure_ascii=False); event payloads redacted before persistence. - Service X-API-Key mandatory on ingest endpoints (defence-in-depth). - Port: host API 8000->8050 (collision with SalesHUB/MailHUB resolved), container still listens on 8000. - Config: no plaintext secret defaults; fail-loud in non-dev (no value leak). - Docs drift: README PG 5440, layered-auth note, 5173 removed from CORS; ingest/folder gated by ENABLE_FOLDER_INGEST (410 by default). - ADRs: layers mapping, shared-core extraction, UI locale (RU-first). Tests: 78 passing (ruff, compileall, pytest, tsc, vite build, compose config). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
48 lines
1.2 KiB
Python
48 lines
1.2 KiB
Python
"""Audit-trail helper.
|
|
|
|
Single entry point for recording write operations. Callers pass the *active*
|
|
session so the audit row commits in the same transaction as the mutation it
|
|
describes (platform security baseline: audit on every write).
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Any
|
|
|
|
from sqlalchemy.orm import Session
|
|
|
|
from app.common.json_logger import redact_secrets
|
|
from app.db.models import AuditLog
|
|
|
|
|
|
def record_audit(
|
|
db: Session,
|
|
*,
|
|
action: str,
|
|
actor: str | None = None,
|
|
actor_id: str | None = None,
|
|
app_code: str | None = None,
|
|
entity_type: str | None = None,
|
|
entity_id: str | None = None,
|
|
details: dict[str, Any] | None = None,
|
|
) -> AuditLog:
|
|
"""Add an :class:`AuditLog` row to ``db`` (not committed here).
|
|
|
|
``details`` is passed through :func:`redact_secrets` so an accidental
|
|
secret in the payload is never persisted.
|
|
"""
|
|
entry = AuditLog(
|
|
action=action,
|
|
actor=actor,
|
|
actor_id=actor_id,
|
|
app_code=app_code,
|
|
entity_type=entity_type,
|
|
entity_id=entity_id,
|
|
details=redact_secrets(details or {}),
|
|
)
|
|
db.add(entry)
|
|
return entry
|
|
|
|
|
|
__all__ = ["record_audit"]
|