TenantAtlas/app/Services/Intune/PolicySnapshotRedactor.php
ahmido 92704a2f7e Spec 118: Resumable baseline evidence capture + snapshot UX (#143)
Implements Spec 118 baseline drift engine improvements:

- Resumable, budget-aware evidence capture for baseline capture/compare runs (resume token + UI action)
- “Why no findings?” reason-code driven explanations and richer run context panels
- Baseline Snapshot resource (list/detail) with fidelity visibility
- Retention command + schedule for pruning baseline-purpose PolicyVersions
- i18n strings for Baseline Compare landing

Verification:
- `vendor/bin/sail bin pint --dirty --format agent`
- `vendor/bin/sail artisan test --compact --filter=Baseline` (159 passed)

Note:
- `docs/audits/redaction-audit-2026-03-04.md` left untracked (not part of PR).

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #143
2026-03-04 22:34:13 +00:00

97 lines
2.1 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Services\Intune;
final class PolicySnapshotRedactor
{
private const string REDACTED = '[REDACTED]';
/**
* @var list<string>
*/
private const array SENSITIVE_KEY_PATTERNS = [
'/password/i',
'/secret/i',
'/token/i',
'/client[_-]?secret/i',
'/private[_-]?key/i',
'/shared[_-]?secret/i',
'/preshared/i',
'/certificate/i',
];
/**
* @param array<string, mixed> $payload
* @return array<string, mixed>
*/
public function redactPayload(array $payload): array
{
return $this->redactValue($payload);
}
/**
* @param array<int, array<string, mixed>>|null $assignments
* @return array<int, array<string, mixed>>|null
*/
public function redactAssignments(?array $assignments): ?array
{
if ($assignments === null) {
return null;
}
$redacted = $this->redactValue($assignments);
return is_array($redacted) ? $redacted : $assignments;
}
/**
* @param array<int, array<string, mixed>>|null $scopeTags
* @return array<int, array<string, mixed>>|null
*/
public function redactScopeTags(?array $scopeTags): ?array
{
if ($scopeTags === null) {
return null;
}
$redacted = $this->redactValue($scopeTags);
return is_array($redacted) ? $redacted : $scopeTags;
}
private function isSensitiveKey(string $key): bool
{
foreach (self::SENSITIVE_KEY_PATTERNS as $pattern) {
if (preg_match($pattern, $key) === 1) {
return true;
}
}
return false;
}
private function redactValue(mixed $value): mixed
{
if (! is_array($value)) {
return $value;
}
$redacted = [];
foreach ($value as $key => $item) {
if (is_string($key) && $this->isSensitiveKey($key)) {
$redacted[$key] = self::REDACTED;
continue;
}
$redacted[$key] = $this->redactValue($item);
}
return $redacted;
}
}