Skip to content

An open-source, self-hostable PaaS alternative to Vercel, Heroku & Netlify that lets you easily deploy static sites, databases, full-stack applications and 360+ one-click services on your own servers.

feat(audit): store encrypted field-level changes on mutations

Andras Bacsai83d19800a676
diff --git a/app/Http/Controllers/Api/AuditEventsController.php b/app/Http/Controllers/Api/AuditEventsController.php
index 63dcca6982..19e916dc10 100644
--- a/app/Http/Controllers/Api/AuditEventsController.php
+++ b/app/Http/Controllers/Api/AuditEventsController.php
@@ -63,6 +63,7 @@ class AuditEventsController extends Controller
'actor_token_id',
'actor_token_name',
'metadata',
+ 'changes',
'ip_address',
'user_agent',
]))
diff --git a/app/Models/AuditEvent.php b/app/Models/AuditEvent.php
index be8a584e26..62c2a16d82 100644
--- a/app/Models/AuditEvent.php
+++ b/app/Models/AuditEvent.php
@@ -34,6 +34,7 @@ class AuditEvent extends Model
'resource_name',
'description',
'metadata',
+ 'changes',
'ip_address',
'user_agent',
'created_at',
@@ -43,6 +44,7 @@ class AuditEvent extends Model
{
return [
'metadata' => 'array',
+ 'changes' => 'encrypted:array',
'created_at' => 'datetime',
];
}
@@ -85,9 +87,27 @@ class AuditEvent extends Model
* @param array<string, mixed> $context
*/
public static function record(string $event, array $context = [], string $level = 'info'): void
+ {
+ self::recordWithChanges($event, $context, level: $level);
+ }
+
+ /**
+ * @param array<string, mixed> $context
+ * @param array<string, array{old: mixed, new: mixed}> $changes
+ */
+ public static function recordModelMutation(string $event, array $context, array $changes): void
+ {
+ self::recordWithChanges($event, $context, $changes);
+ }
+
+ /**
+ * @param array<string, mixed> $context
+ * @param array<string, array{old: mixed, new: mixed}>|null $changes
+ */
+ private static function recordWithChanges(string $event, array $context, ?array $changes = null, string $level = 'info'): void
{
try {
- $attributes = self::attributesFor($event, $context, $level);
+ $attributes = self::attributesFor($event, $context, $changes, $level);
DB::afterCommit(function () use ($attributes): void {
defer(function () use ($attributes): void {
@@ -113,7 +133,7 @@ class AuditEvent extends Model
* @param array<string, mixed> $context
* @return array<string, mixed>
*/
- private static function attributesFor(string $event, array $context, string $level): array
+ private static function attributesFor(string $event, array $context, ?array $changes, string $level): array
{
$teamId = data_get(auth()->user()?->currentAccessToken(), 'team_id')
?? (array_key_exists('team_id', $context)
@@ -152,7 +172,8 @@ class AuditEvent extends Model
'resource_name' => $resourceName,
'description' => data_get($context, 'audit_description')
?? trim(($resourceName ?? Str::headline((string) $resourceType)).' '.Str::headline($action)),
- 'metadata' => self::redact($context),
+ 'metadata' => self::redact(Arr::except($context, ['audit_changes'])),
+ 'changes' => $changes,
'ip_address' => app()->bound('request') ? request()->ip() : null,
'user_agent' => app()->bound('request') ? Str::limit((string) request()->userAgent(), 200, '') : null,
];
@@ -204,7 +225,7 @@ class AuditEvent extends Model
return $key ? data_get($context, $key) : null;
}
- private static function redact(mixed $value, ?string $key = null): mixed
+ public static function redact(mixed $value, ?string $key = null): mixed
{
if ($key !== null && self::isSensitiveKey($key)) {
return '[REDACTED]';
diff --git a/app/Traits/Auditable.php b/app/Traits/Auditable.php
index d0b08cd033..2038103bba 100644
--- a/app/Traits/Auditable.php
+++ b/app/Traits/Auditable.php
@@ -2,6 +2,7 @@
namespace App\Traits;
+use App\Models\AuditEvent;
use App\Models\PersonalAccessToken;
use App\Models\Team;
use Closure;
@@ -82,12 +83,53 @@ trait Auditable
$resourceType = Str::snake(class_basename($this));
$source = auth()->user()?->currentAccessToken() instanceof PersonalAccessToken ? 'api' : 'ui';
- auditLog("{$source}.{$resourceType}.{$action}", [
+ AuditEvent::recordModelMutation("{$source}.{$resourceType}.{$action}", [
'team_id' => $teamId,
"{$resourceType}_uuid" => $this->getAttribute('uuid'),
"{$resourceType}_name" => $this->getAttribute('name') ?? $this->getAttribute('key'),
'changed_fields' => $changedFields,
- ]);
+ ], $this->auditChanges(
+ $action,
+ $action === 'updated' ? $changedFields : array_keys($this->getAttributes()),
+ ));
+ }
+
+ /**
+ * @param array<int, string> $fields
+ * @return array<string, array{old: mixed, new: mixed}>
+ */
+ private function auditChanges(string $action, array $fields): array
+ {
+ return collect($fields)
+ ->reject(fn (string $field): bool => $this->isExcludedAuditField($field))
+ ->mapWithKeys(fn (string $field): array => [
+ $field => [
+ 'old' => $action === 'created' ? null : AuditEvent::redact($this->getOriginal($field)),
+ 'new' => $action === 'deleted' ? null : AuditEvent::redact($this->getAttribute($field)),
+ ],
+ ])
+ ->all();
+ }
+
+ private function isExcludedAuditField(string $field): bool
+ {
+ $cast = $this->getCasts()[$field] ?? null;
+
+ return in_array($field, [
+ $this->getKeyName(),
+ 'uuid',
+ 'created_at',
+ 'updated_at',
+ 'deleted_at',
+ 'order',
+ 'status',
+ ...$this->getHidden(),
+ ...($this->auditExclude ?? []),
+ ], true)
+ || str_ends_with($field, '_id')
+ || str_ends_with($field, '_at')
+ || preg_match('/password|secret|token|private_key|signature|credential|api_key|access_key|authorization|cookie/i', $field)
+ || (is_string($cast) && ($cast === 'encrypted' || str_starts_with($cast, 'encrypted:')));
}
public function withoutAuditLogging(Closure $callback): mixed
diff --git a/database/migrations/2026_08_24_171229_add_changes_to_audit_events_table.php b/database/migrations/2026_08_24_171229_add_changes_to_audit_events_table.php
new file mode 100644
index 0000000000..ead6470398
--- /dev/null
+++ b/database/migrations/2026_08_24_171229_add_changes_to_audit_events_table.php
@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+ /**
+ * Run the migrations.
+ */
+ public function up(): void
+ {
+ Schema::table('audit_events', function (Blueprint $table) {
+ $table->text('changes')->nullable();
+ });
+ }
+
+ /**
+ * Reverse the migrations.
+ */
+ public function down(): void
+ {
+ Schema::table('audit_events', function (Blueprint $table) {
+ $table->dropColumn('changes');
+ });
+ }
+};
diff --git a/resources/views/livewire/team/audit-log.blade.php b/resources/views/livewire/team/audit-log.blade.php
index b81de272c5..d3fd0a9fe7 100644
--- a/resources/views/livewire/team/audit-log.blade.php
+++ b/resources/views/livewire/team/audit-log.blade.php
@@ -44,8 +44,9 @@
<span class="text-right">Time</span>
</div>
@foreach ($events as $event)
- <div wire:key="audit-event-{{ $event->id }}"
- class="grid min-w-[760px] grid-cols-[14rem_minmax(0,1fr)_12rem_9rem] gap-4 border-b border-neutral-200 px-4 py-3 last:border-b-0 dark:border-white/[0.07]">
+ <div wire:key="audit-event-{{ $event->id }}" x-data="{ expanded: false }"
+ class="min-w-[760px] border-b border-neutral-200 last:border-b-0 dark:border-white/[0.07]">
+ <div class="grid grid-cols-[14rem_minmax(0,1fr)_12rem_9rem] gap-4 px-4 py-3">
<div class="min-w-0">
<div class="truncate text-[12px] font-medium text-black dark:text-fg">
{{ $event->actor_name ?: Str::headline($event->actor_type) }}
@@ -69,6 +70,13 @@
<div class="mt-0.5 truncate text-[11px] text-neutral-500 dark:text-fg-faint">
{{ $event->event }}
</div>
+ @if (filled($event->changes))
+ <button type="button" @click="expanded = ! expanded"
+ class="mt-1 text-[11px] font-medium text-accent hover:underline"
+ :aria-expanded="expanded">
+ <span x-text="expanded ? 'Hide changes' : 'View changes'">View changes</span>
+ </button>
+ @endif
</div>
<div class="flex items-center gap-2 text-[12px] text-neutral-500 dark:text-fg-dim">
<span class="rounded-md bg-neutral-100 px-2 py-1 dark:bg-white/[0.06]">
@@ -82,6 +90,24 @@
{{ $event->created_at->diffForHumans() }}
</time>
</div>
+ @if (filled($event->changes))
+ <div x-cloak x-show="expanded" x-collapse
+ class="border-t border-neutral-200 bg-neutral-50 px-4 py-3 dark:border-white/[0.07] dark:bg-white/[0.02]">
+ <div class="grid grid-cols-[12rem_minmax(0,1fr)_minmax(0,1fr)] gap-4 pb-2 text-[10px] font-medium uppercase tracking-wide text-neutral-500 dark:text-fg-faint">
+ <span>Field</span>
+ <span>Previous value</span>
+ <span>New value</span>
+ </div>
+ @foreach ($event->changes as $field => $change)
+ <div class="grid grid-cols-[12rem_minmax(0,1fr)_minmax(0,1fr)] gap-4 border-t border-neutral-200 py-2 text-[12px] dark:border-white/[0.07]">
+ <span class="font-medium text-black dark:text-fg">{{ Str::headline($field) }}</span>
+ <span class="break-words whitespace-pre-wrap text-neutral-600 dark:text-fg-dim">{{ is_array($change['old']) ? json_encode($change['old'], JSON_UNESCAPED_SLASHES) : (is_bool($change['old']) ? ($change['old'] ? 'True' : 'False') : ($change['old'] ?? 'None')) }}</span>
+ <span class="break-words whitespace-pre-wrap text-neutral-600 dark:text-fg-dim">{{ is_array($change['new']) ? json_encode($change['new'], JSON_UNESCAPED_SLASHES) : (is_bool($change['new']) ? ($change['new'] ? 'True' : 'False') : ($change['new'] ?? 'None')) }}</span>
+ </div>
+ @endforeach
+ </div>
+ @endif
+ </div>
@endforeach
</div>
</div>
diff --git a/tests/Feature/AuditEventsTest.php b/tests/Feature/AuditEventsTest.php
index b30526a580..8bae3fa71e 100644
--- a/tests/Feature/AuditEventsTest.php
+++ b/tests/Feature/AuditEventsTest.php
@@ -33,6 +33,7 @@ use Illuminate\Auth\Events\Failed;
use Illuminate\Auth\Events\Logout;
use Illuminate\Database\QueryException;
use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\Schema;
use Illuminate\Support\Once;
@@ -171,6 +172,70 @@ test('auditable models record authenticated create update and delete actions', f
])->and($events[1]->metadata['changed_fields'])->toBe(['name']);
});
+test('auditable models store encrypted changes for create update and delete actions', function () {
+ $project = Project::factory()->create([
+ 'team_id' => $this->team->id,
+ 'name' => 'Website project',
+ 'description' => 'Original description',
+ ]);
+ $project->update(['description' => 'Updated description']);
+ $project->delete();
+
+ $events = AuditEvent::query()->where('resource_type', 'project')->orderBy('id')->get();
+
+ expect($events[0]->changes)->toMatchArray([
+ 'name' => ['old' => null, 'new' => 'Website project'],
+ 'description' => ['old' => null, 'new' => 'Original description'],
+ ])->and($events[0]->changes)->not->toHaveKeys(['id', 'uuid', 'team_id', 'created_at', 'updated_at'])
+ ->and($events[1]->changes)->toBe([
+ 'description' => ['old' => 'Original description', 'new' => 'Updated description'],
+ ])->and($events[2]->changes)->toMatchArray([
+ 'name' => ['old' => 'Website project', 'new' => null],
+ 'description' => ['old' => 'Updated description', 'new' => null],
+ ]);
+
+ $storedChanges = DB::table('audit_events')->where('id', $events[1]->id)->value('changes');
+
+ expect($storedChanges)->not->toContain('Original description')
+ ->and($storedChanges)->not->toContain('Updated description');
+});
+
+test('auditable models exclude hidden and encrypted attributes from changes', function () {
+ SharedEnvironmentVariable::query()->create([
+ 'team_id' => $this->team->id,
+ 'key' => 'API_TOKEN',
+ 'value' => 'super-secret',
+ 'comment' => 'Used by the API',
+ ]);
+
+ $event = AuditEvent::query()->where('resource_type', 'shared_environment_variable')->sole();
+
+ expect($event->changes)->toMatchArray([
+ 'key' => ['old' => null, 'new' => 'API_TOKEN'],
+ 'comment' => ['old' => null, 'new' => 'Used by the API'],
+ ])->and($event->changes)->not->toHaveKey('value')
+ ->and(DB::table('audit_events')->where('id', $event->id)->value('changes'))
+ ->not->toContain('super-secret');
+});
+
+test('auditable models exclude timestamp attributes from changes', function () {
+ $project = Project::factory()->create(['team_id' => $this->team->id]);
+ $environment = Environment::factory()->create(['project_id' => $project->id]);
+ AuditEvent::query()->delete();
+
+ StandalonePostgresql::query()->create([
+ 'uuid' => fake()->uuid(),
+ 'name' => 'Timestamp test database',
+ 'environment_id' => $environment->id,
+ 'destination_type' => Server::class,
+ 'destination_id' => 0,
+ 'postgres_password' => 'password',
+ 'last_restart_at' => now(),
+ ]);
+
+ expect(AuditEvent::query()->sole()->changes)->not->toHaveKey('last_restart_at');
+});
+
test('deleting a project dispatches deleted events for its environments', function () {
$project = Project::factory()->create(['team_id' => $this->team->id]);
$environment = $project->environments()->sole();
@@ -634,6 +699,37 @@ test('audit log page only shows events for the current team', function () {
->assertDontSee('Private app deleted');
});
+test('audit log expands encrypted model changes for team admins and owners', function () {
+ AuditEvent::factory()->create([
+ 'team_id' => $this->team->id,
+ 'description' => 'Website updated',
+ 'changes' => [
+ 'name' => ['old' => 'Website', 'new' => 'Store'],
+ ],
+ ]);
+
+ Livewire::test(AuditLog::class)
+ ->assertSee('View changes')
+ ->assertSee('Name')
+ ->assertSee('Website')
+ ->assertSee('Store');
+});
+
+test('manual audit events do not store model changes', function () {
+ auditLog('ui.application.restarted', [
+ 'team_id' => $this->team->id,
+ 'application_uuid' => 'app-123',
+ 'audit_changes' => [
+ 'name' => ['old' => 'Injected', 'new' => 'Value'],
+ ],
+ ]);
+
+ $event = AuditEvent::query()->sole();
+
+ expect($event->changes)->toBeNull()
+ ->and($event->metadata)->not->toHaveKey('audit_changes');
+});
+
test('audit log is available under team settings', function () {
$this->get('/team/audit-log')
->assertSuccessful()
@@ -669,6 +765,7 @@ test('team admins can query only their team audit events through the api', funct
'actor_email' => '[email protected]',
'actor_token_name' => 'production token',
'metadata' => ['changed_fields' => ['name']],
+ 'changes' => ['name' => ['old' => 'Old project', 'new' => 'New project']],
'ip_address' => '192.0.2.1',
'user_agent' => 'Sensitive user agent',
]);
@@ -694,6 +791,7 @@ test('team admins can query only their team audit events through the api', funct
->assertJsonMissingPath('data.0.actor_token_id')
->assertJsonMissingPath('data.0.actor_token_name')
->assertJsonMissingPath('data.0.metadata')
+ ->assertJsonMissingPath('data.0.changes')
->assertJsonMissingPath('data.0.ip_address')
->assertJsonMissingPath('data.0.user_agent');
});
@@ -710,6 +808,7 @@ test('team admins with sensitive read access can query full audit event details'
'actor_email' => '[email protected]',
'actor_token_name' => 'production token',
'metadata' => ['changed_fields' => ['name']],
+ 'changes' => ['name' => ['old' => 'Old project', 'new' => 'New project']],
'ip_address' => '192.0.2.1',
'user_agent' => 'Sensitive user agent',
]);
@@ -720,6 +819,8 @@ test('team admins with sensitive read access can query full audit event details'
->assertJsonPath('data.0.actor_email', '[email protected]')
->assertJsonPath('data.0.actor_token_name', 'production token')
->assertJsonPath('data.0.metadata.changed_fields.0', 'name')
+ ->assertJsonPath('data.0.changes.name.old', 'Old project')
+ ->assertJsonPath('data.0.changes.name.new', 'New project')
->assertJsonPath('data.0.ip_address', '192.0.2.1')
->assertJsonPath('data.0.user_agent', 'Sensitive user agent');
});