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
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
292 lines
11 KiB
PHP
292 lines
11 KiB
PHP
<?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();
|
||
}
|
||
}
|