Loheide-eu-mitarbeiterplatt.../app/Identity/IdentitySync.php
Friederich Loheide 4fcc41ed30
All checks were successful
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 2m41s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 2m48s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 3m15s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 3m17s
CI / PHP 8.3 / mysql:8.0 (pull_request) Successful in 3m48s
CI / PHP 8.4 / mysql:8.0 (pull_request) Successful in 3m41s
CI / PHP 8.3 / mysql:8.4 (pull_request) Successful in 3m33s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m26s
CI / PHP 8.4 / mysql:8.4 (pull_request) Successful in 3m59s
Phase 6 (Teil 2): OpenID Connect, LDAP/AD und SAML 2
- Gemeinsamer Treiber-Unterbau (App\Identity\IdentityDriver, IdentityDrivers,
  IdentityLogin, AttributeProfile); Entra ID nutzt ihn ebenfalls
- Plugins oidc, ldap und saml mit Profil- und Gruppen-Zuordnung
- Admin: Verfahren wählen, Formular je Verfahren, zuletzt empfangene Angaben
- onelogin/php-saml als neue Abhängigkeit

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-26 12:38:32 +00:00

273 lines
9.9 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;
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));
}
/**
* 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();
}
}