ahmido
eef85af990
Kurzbeschreibung Implementiert Tenant RBAC v1 (specs/062-tenant-rbac-v1): tenant_memberships, Capability registry/resolver, gates, Filament RelationManager für Tenant→Members, Last‑Owner‑Guard, bootstrap assign/recover (break‑glass), Audit-Logging. Wichtige Änderungen Migration: create_tenant_memberships_table (T004) — ausgeführt Models/Services: TenantMembership, Capabilities, RoleCapabilityMap, CapabilityResolver (T008–T013) Auth: Gates registriert in AuthServiceProvider.php (T011) Filament: RelationManager unter Settings → Tenants (Members CRUD + Last‑Owner‑Guard) (T017–T018) Break‑glass: lokale platform superadmin + persistent banner + bootstrap_recover action (T024–T026) Audit: Audit‑Einträge für membership actions mit canonical action_ids (T022) Tests: neue/aktualisierte Feature- und Unit‑Tests (siehe Test‑Abschnitt) Migrations / Deploy Run migrations: vendor/bin/sail artisan migrate Keine neuen Panel‑Assets registriert (kein php artisan filament:assets nötig) Wenn Frontend nicht sichtbar: vendor/bin/sail npm run dev oder vendor/bin/sail npm run build Tests (geprüft / neu) Fokus-Suite ausgeführt für Tenant RBAC (T031). Neu / aktualisiert: CapabilitiesRegistryTest CapabilityResolverTest TenantSwitcherScopeTest TenantRouteDenyAsNotFoundTest TenantMembershipCrudTest LastOwnerGuardTest TenantBootstrapAssignTest MembershipAuditLogTest BreakGlassRecoveryTest Befehl zum lokalen Ausführen (minimal): vendor/bin/sail artisan test tests/Feature/TenantRBAC --stop-on-failure Filament / Sicherheits‑Contract (erforderliche Punkte) Livewire v4.0+ compliance: bestätigt (Filament v5 target). Provider registration: keine neue Panel‑Provider-Änderung; falls nötig: providers.php (Laravel 11+). Globale Suche: keine neuen Ressourcen für Global Search hinzugefügt; vorhandene Ressourcen behalten Edit/View‑Pages unverändert. Destructive actions: tenant_membership.remove und role‑demote sind destruktive — implemented via Action::make(...)->action(...)->requiresConfirmation() + policy checks. Asset strategy: keine globalen Assets; on‑demand/load as before. Deployment: filament:assets nicht erforderlich für diese PR. Testing plan: Livewire/Filament Komponenten + actions abgedeckt — RelationManager CRUD, Last‑Owner‑Guard, BreakGlassRecovery, CapabilityResolver/Registry, Tenant switcher + deny‑as‑not‑found route tests. Offene/optionale Punkte T005/T028/T029 (tenant_role_mappings migration + UI + Tests) sind optional und noch nicht umgesetzt. Checklist (aus tasks.md) T001–T003 Discovery T004, T006–T007 Migrations (T005 optional) T008–T013 Models/Capabilities/Gates T014–T016 Tenant isolation & route enforcement T017–T021 Membership UI + bootstrap flows T022–T023 Audit logging + tests T024–T027 Break‑glass flows & tests T005, T028, T029 Optional mappings T030–T031 Formatting + focused tests Migration / Test commands to run locally vendor/bin/sail up -d vendor/bin/sail artisan migrate vendor/bin/sail artisan tinker (falls manuell Benutzer/Flags setzen) vendor/bin/sail artisan test tests/Feature/TenantRBAC --stop-on-failure Wenn du einen PR‑Titel und Labels willst, schlage ich vor: Title: feat(062): Tenant RBAC v1 — memberships, capability resolver, break‑glass recovery Labels: feature, tests, migration Co-authored-by: Ahmed Darrazi <ahmeddarrazi@MacBookPro.fritz.box> Reviewed-on: #74
49 lines
1.5 KiB
Markdown
49 lines
1.5 KiB
Markdown
# Data Model for Tenant RBAC v1
|
|
|
|
This document outlines the data models for the Tenant RBAC feature.
|
|
|
|
## `users`
|
|
|
|
Represents a user identity, linked to an Entra ID.
|
|
|
|
- `id` (PK)
|
|
- `entra_tenant_id` (string) - The Entra ID tenant ID (tid).
|
|
- `entra_object_id` (string) - The Entra ID object ID (oid).
|
|
- `name` (string)
|
|
- `email` (string, nullable)
|
|
- `timestamps`
|
|
|
|
**Indexes**:
|
|
- Unique index on `(entra_tenant_id, entra_object_id)`.
|
|
|
|
## `tenant_memberships`
|
|
|
|
Links a User to a Suite Tenant with a specific role. This is the source of truth for authorization.
|
|
|
|
- `id` (PK, uuid)
|
|
- `tenant_id` (FK to `tenants.id`)
|
|
- `user_id` (FK to `users.id`)
|
|
- `role` (enum: `owner`, `manager`, `operator`, `readonly`)
|
|
- `source` (enum: `manual`, `entra_group`, `entra_app_role`, `break_glass`)
|
|
- `source_ref` (string, nullable) - e.g., Entra group ID or app role ID.
|
|
- `created_by_user_id` (FK to `users.id`, nullable)
|
|
- `timestamps`
|
|
|
|
**Indexes**:
|
|
- Unique index on `(tenant_id, user_id)`.
|
|
- Index on `(tenant_id, role)`.
|
|
|
|
## `tenant_role_mappings`
|
|
|
|
Defines the mapping between an Entra group/app-role and a TenantAtlas role for a Suite Tenant.
|
|
|
|
- `id` (PK, uuid)
|
|
- `tenant_id` (FK to `tenants.id`)
|
|
- `mapping_type` (enum: `entra_group`, `entra_app_role`)
|
|
- `external_id` (string) - The Entra group GUID or appRole string.
|
|
- `role` (enum: `owner`, `manager`, `operator`, `readonly`)
|
|
- `is_enabled` (boolean)
|
|
- `timestamps`
|
|
|
|
**Indexes**:
|
|
- Unique index on `(tenant_id, mapping_type, external_id)`. |