Loheide-eu-mitarbeiterplatt.../app/Identity/IdentitySync.php
Friederich Loheide f1202bea08
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 7m50s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 7m34s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 5m45s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 5m30s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 7m7s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 7m9s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 6m8s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 6m5s
CI / Bekannte Sicherheitslücken in Paketen (pull_request) Successful in 48s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m5s
Sicherheitsupdate nach Audit (0.29.0)
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-27 11:34:54 +00:00

292 lines
11 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
namespace App\Identity;
use App\Models\IdentityProvider;
use App\Models\IdpGroupMapping;
use App\Models\User;
use App\Models\UserIdentity;
use App\Support\Audit;
use App\Support\Avatars;
use App\Support\Permissions\Permissions;
use App\Support\ProfileFields;
use Illuminate\Support\Carbon;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Str;
use Throwable;
/**
* Überträgt Daten eines Identity Providers ins Portal: Konto finden oder anlegen,
* Profilfelder, Foto und Rollen. Wird bei der Anmeldung und im Hintergrund-Abgleich genutzt.
*/
class IdentitySync
{
public function __construct(
private readonly Avatars $avatars,
private readonly ProfileFields $profileFields,
) {}
/**
* Konto zu einer externen Identität finden, verknüpfen oder anlegen.
*
* @param array<string, mixed> $profile normalisiertes Profil (siehe EntraProfile)
*/
public function resolveUser(IdentityProvider $provider, string $subject, array $profile, bool $allowCreate): ?User
{
$identity = UserIdentity::query()->with('user')
->where('identity_provider_id', $provider->id)->where('subject', $subject)->first();
if ($identity?->user) {
return $identity->user;
}
$email = isset($profile['email']) ? Str::lower((string) $profile['email']) : null;
if ($email && ! $provider->isEmailDomainAllowed($email)) {
throw new IdentityException('Konten mit dieser E-Mail-Domain dürfen sich hier nicht anmelden.');
}
$user = $email && $provider->setting('link_by_email', true)
? User::query()->where('email', $email)->first()
: null;
// Konten mit Passwort oder Backend-Rechten nur verknüpfen, wenn die Adresse verlässlich
// ist – sonst könnte, wer beim Anbieter seine E-Mail ändern kann, fremde Konten übernehmen.
if ($user && ($user->password !== null || $user->canAccessAdmin()) && ! $this->emailTrusted($provider, $profile)) {
throw new IdentityException('Für diese E-Mail-Adresse gibt es bereits ein Portal-Konto. Bitte melden Sie sich mit Ihrem Passwort an oder bitten Sie die Administration, die Anmeldung freizuschalten.');
}
if (! $user) {
if (! $allowCreate) {
return null;
}
if (! $email) {
throw new IdentityException('Für Ihr Konto ist beim Anmeldedienst keine E-Mail-Adresse hinterlegt.');
}
$user = User::query()->create([
'email' => $email,
'first_name' => $profile['first_name'] ?? null,
'last_name' => $profile['last_name'] ?? null,
'name' => $profile['display_name'] ?? $email,
'password' => null,
'is_active' => true,
]);
Audit::log('identity.user_created', ['provider' => $provider->name, 'email' => $email], null);
}
UserIdentity::query()->create([
'user_id' => $user->id,
'identity_provider_id' => $provider->id,
'subject' => $subject,
'email' => $email,
]);
return $user;
}
/**
* Profilfelder übernehmen – nur die in der Konfiguration gewählten.
*
* @param array<string, mixed> $profile
*/
public function syncProfile(IdentityProvider $provider, User $user, array $profile): void
{
$fields = $provider->syncedFields();
$changes = [];
foreach (['first_name', 'last_name', 'job_title', 'department', 'location', 'phone', 'mobile'] as $field) {
if (in_array($field, $fields, true) && array_key_exists($field, $profile)) {
$changes[$field] = $profile[$field] !== '' ? $profile[$field] : null;
}
}
if (in_array('first_name', $fields, true) && empty($profile['first_name']) && empty($profile['last_name']) && ! empty($profile['display_name'])) {
$changes['name'] = $profile['display_name'];
}
if (in_array('email', $fields, true) && ! empty($profile['email'])) {
$email = Str::lower($profile['email']);
if (User::query()->where('email', $email)->whereKeyNot($user->id)->exists()) {
Log::warning("Entra-Abgleich: E-Mail {$email} ist bereits einem anderen Konto zugeordnet – nicht übernommen.");
} else {
$changes['email'] = $email;
}
}
if (in_array('manager', $fields, true) && array_key_exists('manager_subject', $profile)) {
$changes['manager_id'] = $profile['manager_subject']
? UserIdentity::query()->where('identity_provider_id', $provider->id)->where('subject', $profile['manager_subject'])->value('user_id')
: null;
}
$custom = $this->customFieldChanges($user, $fields, (array) ($profile['custom'] ?? []));
if ($custom !== null) {
$changes['custom_fields'] = $custom;
}
if ($changes !== []) {
$user->forceFill($changes)->save();
}
}
/**
* Freie Profilfelder aus dem Anbieter übernehmen. Datumswerte werden als
* Y-m-d gespeichert, Werte ohne Felddefinition ignoriert.
*
* @param list<string> $fields
* @param array<string, string|null> $incoming
* @return array<string, string>|null null = keine Änderung
*/
private function customFieldChanges(User $user, array $fields, array $incoming): ?array
{
$definitions = $this->profileFields->all()->keyBy('key');
$values = (array) ($user->custom_fields ?? []);
$before = $values;
foreach ($incoming as $key => $value) {
$field = $definitions->get($key);
if (! $field || ! in_array('custom.'.$key, $fields, true)) {
continue;
}
if ($value !== null && $field->type === 'date') {
try {
$value = Carbon::parse($value)->format('Y-m-d');
} catch (Throwable) {
// Unlesbares Datum: unverändert übernehmen.
}
}
if ($value === null) {
unset($values[$key]);
} else {
$values[$key] = $value;
}
}
return $values === $before ? null : $values;
}
/**
* Profilfoto übernehmen, wenn es sich geändert hat. null = kein Foto beim Anbieter.
*/
public function syncPhoto(UserIdentity $identity, ?string $binary): void
{
$user = $identity->user;
try {
if ($binary === null) {
// Nur ein Foto entfernen, das auch aus Entra stammte.
if ($identity->photo_hash !== null) {
$this->avatars->delete($user);
$identity->update(['photo_hash' => null]);
}
return;
}
$hash = hash('sha256', $binary);
if ($hash !== $identity->photo_hash || $user->avatar_path === null) {
$this->avatars->storeFromBinary($user, $binary);
$identity->update(['photo_hash' => $hash]);
}
} catch (Throwable $e) {
Log::warning("Profilfoto für {$user->email} konnte nicht übernommen werden: ".$e->getMessage());
}
}
/**
* Rollen aus Gruppen und App-Rollen abgleichen. Nur Zuweisungen dieses
* Anbieters werden hinzugefügt oder entfernt – manuelle bleiben unberührt.
*
* @param list<string> $groupIds Objekt-IDs der Gruppen
* @param list<string> $appRoles Werte der App-Rollen
* @return list<int> resultierende Rollen-IDs aus diesem Anbieter
*/
public function syncRoles(IdentityProvider $provider, User $user, array $groupIds, array $appRoles): array
{
$desired = [];
foreach ($provider->mappings()->get() as $mapping) {
$values = $mapping->kind === IdpGroupMapping::APP_ROLE ? $appRoles : array_map('strtolower', $groupIds);
$external = $mapping->kind === IdpGroupMapping::APP_ROLE ? $mapping->external_id : strtolower($mapping->external_id);
if (in_array($external, $values, true)) {
$desired[$mapping->role_id.'|'.$provider->sourcePrefix().$mapping->kind.':'.$mapping->external_id] = $mapping->role_id;
}
}
if ($defaultRole = $provider->setting('default_role_id')) {
$desired[$defaultRole.'|'.$provider->sourcePrefix().'default'] = (int) $defaultRole;
}
$current = DB::table('role_user')
->where('user_id', $user->id)
->where('source', 'idp')
->where('source_ref', 'like', $provider->sourcePrefix().'%')
->get(['id', 'role_id', 'source_ref'])
->keyBy(fn ($row) => $row->role_id.'|'.$row->source_ref);
$removed = $current->keys()->diff(array_keys($desired));
$added = collect(array_keys($desired))->diff($current->keys());
if ($removed->isNotEmpty()) {
DB::table('role_user')->whereIn('id', $removed->map(fn ($key) => $current[$key]->id)->all())->delete();
}
foreach ($added as $key) {
[$roleId, $sourceRef] = explode('|', $key, 2);
DB::table('role_user')->insert(['role_id' => (int) $roleId, 'user_id' => $user->id, 'source' => 'idp', 'source_ref' => $sourceRef, 'created_at' => now()]);
}
if ($removed->isNotEmpty() || $added->isNotEmpty()) {
Permissions::flush();
Audit::log('identity.roles_synced', [
'provider' => $provider->name,
'user' => $user->email,
'added' => $added->values()->all(),
'removed' => $removed->values()->all(),
], null);
}
return array_values(array_unique($desired));
}
/**
* Stammt die E-Mail-Adresse sicher von der Person? Microsoft Entra ID prüft Adressen,
* OIDC meldet es per „email_verified“, sonst entscheidet die Administration je Anbieter.
*
* @param array<string, mixed> $profile
*/
private function emailTrusted(IdentityProvider $provider, array $profile): bool
{
return $provider->type === 'entra'
|| ($profile['email_verified'] ?? false) === true
|| (bool) $provider->setting('trust_email', false);
}
/**
* Konto wurde beim Anbieter deaktiviert oder gelöscht: im Portal deaktivieren
* und die Rollen aus diesem Anbieter entfernen.
*/
public function deactivate(IdentityProvider $provider, UserIdentity $identity): void
{
$user = $identity->user;
if ($user->is_active) {
$user->forceFill(['is_active' => false])->save();
Audit::log('identity.user_deactivated', ['provider' => $provider->name, 'email' => $user->email], null);
}
$this->syncRoles($provider, $user, [], []);
DB::table('sessions')->where('user_id', $user->id)->delete();
}
}