Loheide-eu-mitarbeiterplatt.../app/Identity/Entra/EntraDirectorySync.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

277 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\Entra;
use App\Identity\IdentityException;
use App\Identity\IdentitySync;
use App\Models\IdentityProvider;
use App\Models\IdpGroupMapping;
use App\Models\UserIdentity;
use App\Support\Settings;
use Illuminate\Support\Facades\Log;
use Throwable;
/**
* Hintergrund-Abgleich mit Entra ID – ohne dass sich jemand anmelden muss.
*
* - Benutzer per Delta-Abfrage (/users/delta): nur Änderungen seit dem letzten
* Lauf; deaktivierte oder gelöschte Konten werden im Portal deaktiviert
* (Offboarding). Optional werden neue Konten vorab angelegt.
* - Fotos und Vorgesetzte rollierend in kleinen Portionen.
* - Gruppen- und App-Rollen-Zuordnungen stündlich für alle verknüpften Konten.
*
* Arbeitet mit Zeitbudget und setzt beim nächsten Lauf fort (Shared Hosting,
* Pseudo-Cron). Benötigt Anwendungsberechtigungen User.Read.All und
* GroupMember.Read.All (Administratorzustimmung).
*/
class EntraDirectorySync
{
public const PHOTOS_PER_RUN = 25;
public const GROUP_SYNC_INTERVAL = 3600;
public function __construct(
private readonly IdentitySync $sync,
private readonly Settings $settings,
) {}
public function runAll(int $budgetSeconds = 45): void
{
IdentityProvider::query()->where('enabled', true)->where('type', IdentityProvider::ENTRA)->get()
->filter(fn (IdentityProvider $p) => (bool) $p->setting('directory_sync', false))
->each(fn (IdentityProvider $p) => $this->run($p, $budgetSeconds));
}
public function run(IdentityProvider $provider, int $budgetSeconds = 45): void
{
$deadline = microtime(true) + $budgetSeconds;
$client = new EntraClient($provider);
try {
$token = $client->appToken();
$this->syncUsers($provider, $client, $token, $deadline);
$this->syncPhotosAndManagers($provider, $client, $token, $deadline);
if (now()->getTimestamp() - (int) $this->state($provider, 'groups_synced_at', 0) >= self::GROUP_SYNC_INTERVAL) {
$this->syncGroups($provider, $client, $token);
$this->saveState($provider, ['groups_synced_at' => now()->getTimestamp()]);
}
$this->saveState($provider, ['last_run_at' => now()->getTimestamp(), 'last_error' => null]);
} catch (Throwable $e) {
$client->forgetAppToken();
Log::error("Entra-Abgleich ({$provider->name}) fehlgeschlagen: ".$e->getMessage());
$this->saveState($provider, ['last_run_at' => now()->getTimestamp(), 'last_error' => $e->getMessage()]);
}
}
/**
* @return array<string, mixed>
*/
public function status(IdentityProvider $provider): array
{
return (array) $this->settings->get('identity.'.$provider->id.'.sync', []);
}
private function syncUsers(IdentityProvider $provider, EntraClient $client, string $token, float $deadline): void
{
$url = $this->state($provider, 'next_link') ?: $this->state($provider, 'delta_link') ?: '/users/delta?$select='.EntraProfile::SELECT;
while ($url && microtime(true) < $deadline) {
$response = $client->graph($token)->get($url);
// Abgelaufener Delta-Link: von vorn beginnen.
if ($response->status() === 410) {
$this->saveState($provider, ['delta_link' => null, 'next_link' => null]);
return;
}
$client->assertGraph($response);
foreach ((array) $response->json('value', []) as $graphUser) {
$this->applyUser($provider, (array) $graphUser);
}
if ($next = ($response->json() ?? [])['@odata.nextLink'] ?? null) {
$url = $next;
$this->saveState($provider, ['next_link' => $next]);
} else {
$this->saveState($provider, ['delta_link' => ($response->json() ?? [])['@odata.deltaLink'] ?? null, 'next_link' => null, 'users_synced_at' => now()->getTimestamp()]);
$url = null;
}
}
}
/**
* @param array<string, mixed> $graphUser
*/
private function applyUser(IdentityProvider $provider, array $graphUser): void
{
$subject = (string) ($graphUser['id'] ?? '');
if ($subject === '') {
return;
}
$identity = UserIdentity::query()->with('user')->where('identity_provider_id', $provider->id)->where('subject', $subject)->first();
if (isset($graphUser['@removed']) || ($graphUser['accountEnabled'] ?? true) === false) {
if ($identity?->user) {
$this->sync->deactivate($provider, $identity);
}
return;
}
if (! $identity) {
$createAllowed = $provider->setting('directory_create_users', false)
&& ($graphUser['userType'] ?? 'Member') === 'Member'
&& ! empty($graphUser['mail']);
// Ohne Vorab-Anlage: nur bestehende Konten per E-Mail verknüpfen.
try {
$user = $this->sync->resolveUser($provider, $subject, EntraProfile::fromGraph($graphUser), (bool) $createAllowed);
} catch (IdentityException) {
return; // z. B. nicht erlaubte E-Mail-Domain – dieses Konto überspringen
}
if (! $user) {
return;
}
$identity = UserIdentity::query()->with('user')->where('identity_provider_id', $provider->id)->where('subject', $subject)->first();
}
// Delta liefert nur geänderte Felder – fehlende Felder nicht leeren.
$profile = array_intersect_key(EntraProfile::fromGraph($graphUser), array_flip(array_map(fn ($key) => match ($key) {
'givenName' => 'first_name', 'surname' => 'last_name', 'mail' => 'email', 'jobTitle' => 'job_title',
'department' => 'department', 'officeLocation' => 'location', 'businessPhones' => 'phone', 'mobilePhone' => 'mobile',
'displayName' => 'display_name', default => '-',
}, array_keys($graphUser))));
$this->sync->syncProfile($provider, $identity->user, $profile);
}
private function syncPhotosAndManagers(IdentityProvider $provider, EntraClient $client, string $token, float $deadline): void
{
$withPhoto = (bool) $provider->setting('sync_photo', true);
$withManager = in_array('manager', $provider->syncedFields(), true);
if (! $withPhoto && ! $withManager) {
return;
}
$identities = UserIdentity::query()->with('user')
->where('identity_provider_id', $provider->id)
->whereHas('user', fn ($q) => $q->where('is_active', true))
->orderByRaw('synced_at is not null')->orderBy('synced_at')
->limit(self::PHOTOS_PER_RUN)->get();
foreach ($identities as $identity) {
if (microtime(true) >= $deadline) {
return;
}
if ($withPhoto) {
$response = $client->graph($token)->accept('image/*')->get('/users/'.$identity->subject.'/photo/$value');
if ($response->successful() || $response->status() === 404) {
$this->sync->syncPhoto($identity, $response->successful() ? $response->body() : null);
}
}
if ($withManager) {
$manager = $client->graph($token)->get('/users/'.$identity->subject.'/manager', ['$select' => 'id']);
if ($manager->successful() || $manager->status() === 404) {
$this->sync->syncProfile($provider, $identity->user, ['manager_subject' => $manager->successful() ? $manager->json('id') : null]);
}
}
$identity->forceFill(['synced_at' => now()])->save();
}
}
/**
* Gruppen- und App-Rollen-Zuordnungen für alle verknüpften Konten neu berechnen.
*/
private function syncGroups(IdentityProvider $provider, EntraClient $client, string $token): void
{
$mappings = $provider->mappings()->get();
$groupsBySubject = [];
$appRolesBySubject = [];
foreach ($mappings->where('kind', IdpGroupMapping::GROUP)->pluck('external_id')->unique() as $groupId) {
foreach ($this->transitiveUserIds($client, $token, $groupId) as $subject) {
$groupsBySubject[$subject][] = $groupId;
}
}
if ($mappings->where('kind', IdpGroupMapping::APP_ROLE)->isNotEmpty()) {
$appRolesBySubject = $this->appRoleAssignments($provider, $client, $token);
}
UserIdentity::query()->with('user')->where('identity_provider_id', $provider->id)
->whereHas('user', fn ($q) => $q->where('is_active', true))
->each(fn (UserIdentity $identity) => $this->sync->syncRoles(
$provider,
$identity->user,
$groupsBySubject[$identity->subject] ?? [],
array_values(array_unique($appRolesBySubject[$identity->subject] ?? [])),
));
}
/**
* @return list<string>
*/
private function transitiveUserIds(EntraClient $client, string $token, string $groupId): array
{
return array_column($client->graphAll($token, '/groups/'.$groupId.'/transitiveMembers/microsoft.graph.user?$select=id&$top=999'), 'id');
}
/**
* App-Rollen der App-Registrierung: direkt zugewiesene Personen und Gruppen (aufgelöst).
*
* @return array<string, list<string>> Objekt-ID => Rollen-Werte
*/
private function appRoleAssignments(IdentityProvider $provider, EntraClient $client, string $token): array
{
$servicePrincipal = $client->graph($token)->get("/servicePrincipals(appId='".$client->clientId()."')", ['$select' => 'id,appRoles']);
$client->assertGraph($servicePrincipal);
$values = collect((array) $servicePrincipal->json('appRoles', []))->pluck('value', 'id')->all();
$result = [];
foreach ($client->graphAll($token, '/servicePrincipals/'.$servicePrincipal->json('id').'/appRoleAssignedTo?$top=999') as $assignment) {
$value = $values[$assignment['appRoleId'] ?? ''] ?? null;
if (! $value) {
continue;
}
$subjects = ($assignment['principalType'] ?? '') === 'Group'
? $this->transitiveUserIds($client, $token, $assignment['principalId'])
: [$assignment['principalId']];
foreach ($subjects as $subject) {
$result[$subject][] = $value;
}
}
return $result;
}
private function state(IdentityProvider $provider, string $key, mixed $default = null): mixed
{
return $this->status($provider)[$key] ?? $default;
}
/**
* @param array<string, mixed> $values
*/
private function saveState(IdentityProvider $provider, array $values): void
{
$this->settings->set('identity.'.$provider->id.'.sync', array_merge($this->status($provider), $values));
}
}