Loheide-eu-mitarbeiterplatt.../app/Identity/IdentitySync.php
Friederich Loheide 51c94cd0cf
Some checks failed
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 1m37s
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 1m41s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 1m40s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 1m42s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 2m10s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 2m6s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 1m55s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 2m2s
CI / Build-Artefakte aktuell (pull_request) Successful in 52s
Anmeldung mit Microsoft Entra ID
- OpenID Connect mit PKCE, State und Nonce; ID-Token-Prüfung gegen die
  Microsoft-Schlüssel (Signatur, Mandant, App, Gültigkeit, Nonce) inkl.
  Neuladen bei Schlüsselwechsel
- Konto bei erster Anmeldung anlegen oder per E-Mail verknüpfen, optionale
  Domain-Beschränkung, deaktivierte Konten bleiben gesperrt
- Gruppen (inkl. Overage über Graph, transitiv) und App-Rollen → Rollen,
  additiv; nur Zuweisungen aus Entra werden abgeglichen, manuelle bleiben
- Profilfelder, Vorgesetzte*r und Profilfoto aus Graph, je Feld wählbar und
  im Portal schreibgeschützt; Fallback auf Token-Angaben, wenn Graph ausfällt
- Hintergrund-Abgleich mit Delta-Abfragen (Zeitbudget, Fortsetzung über
  nextLink/deltaLink), Offboarding deaktivierter/gelöschter Konten, optionale
  Vorab-Anlage, Fotos/Vorgesetzte rollierend, Gruppen und App-Rollen stündlich
- Admin „Anmeldung“: Einrichtung mit Umleitungs-URI und Berechtigungen,
  verschlüsseltes Geheimnis (nie im Browser), Gruppensuche, Status, „Mapping testen“
- Fix: @odata.nextLink/@odata.deltaLink wurden als Pfad gelesen – Folgeseiten fehlten
- Profilseite mit Vorgesetzter/m und Mitarbeitenden; Version 0.4.0

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

223 lines
8.3 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 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) {}
/**
* 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 dieses Microsoft-Konto ist 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;
}
if ($changes !== []) {
$user->forceFill($changes)->save();
}
}
/**
* 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();
}
}