$graphUser Antwort von /me, /users/{id} oder /users/delta * @param bool $partial Delta-Antwort: nur Felder liefern, deren Attribut enthalten ist * @return array */ public static function fromGraph(IdentityProvider $provider, array $graphUser, ?string $managerSubject = null, bool $withManager = false, bool $partial = false): array { $present = fn (string $path) => ! $partial || array_key_exists(EntraAttributes::topLevel($path), $graphUser); $profile = []; if ($present('displayName')) { $profile['display_name'] = EntraAttributes::value($graphUser, 'displayName'); } // Grundwerte für Kontoanlage und Verknüpfung; die Zuordnung überschreibt sie. foreach (['first_name' => 'givenName', 'last_name' => 'surname', 'email' => 'mail'] as $field => $path) { if ($present($path)) { $profile[$field] = EntraAttributes::value($graphUser, $path); } } foreach ($provider->attributeMap() as $target => $path) { if (! $present($path)) { continue; } $value = EntraAttributes::value($graphUser, $path); if (str_starts_with($target, 'custom.')) { $profile['custom'][substr($target, 7)] = $value; } else { $profile[$target] = $value; } } // Gastkonten haben oft keine „mail“; der UPN ist dann eine #EXT#-Adresse. if (array_key_exists('email', $profile) && $profile['email'] === null && ! $partial) { $upn = (string) ($graphUser['userPrincipalName'] ?? ''); $profile['email'] = $upn !== '' && ! str_contains($upn, '#EXT#') ? $upn : null; } if ($withManager) { $profile['manager_subject'] = $managerSubject; } return $profile; } /** * Rückfall, wenn Graph nicht erreichbar ist: Angaben aus dem ID-Token. * * @param array $claims * @return array */ public static function fromClaims(array $claims): array { return [ 'display_name' => $claims['name'] ?? null, 'first_name' => $claims['given_name'] ?? null, 'last_name' => $claims['family_name'] ?? null, 'email' => $claims['email'] ?? $claims['preferred_username'] ?? null, ]; } }