Loheide-eu-mitarbeiterplatt.../app/Identity/IdentityDriver.php
Friederich Loheide f1202bea08
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
Sicherheitsupdate nach Audit (0.29.0)
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-27 11:34:54 +00:00

178 lines
4.7 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\User;
use Filament\Actions\Action;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;
/**
* Ein Anmeldeverfahren (Entra ID, OpenID Connect, LDAP, SAML …). Plugins melden
* weitere Verfahren über App\Identity\IdentityDrivers an.
*
* Ablauf: start() leitet zum Anbieter weiter oder zeigt ein eigenes Formular;
* complete() wertet die Rückkehr aus. Die meisten Verfahren liefern dafür nur
* authenticate() – Konto, Profil und Rollen übernimmt der Kern (IdentityLogin).
*/
abstract class IdentityDriver
{
/** Kürzel, wie es in identity_providers.type steht. */
abstract public function type(): string;
/** z. B. „OpenID Connect“ */
abstract public function label(): string;
public function description(): string
{
return '';
}
public function defaultButtonLabel(IdentityProvider $provider): string
{
return 'Mit '.$provider->name.' anmelden';
}
/**
* Grund, warum das Verfahren auf diesem Server nicht nutzbar ist (z. B. fehlende
* PHP-Erweiterung) – oder null.
*/
public function unavailableReason(): ?string
{
return null;
}
/**
* Filament-Felder für die Verbindung (Speicherort: config.*).
*
* @return list<mixed>
*/
abstract public function connectionSchema(): array;
/** Hinweistext über den Verbindungsfeldern (HTML erlaubt, bereits escaped). */
public function connectionHelp(?IdentityProvider $provider): string
{
return '';
}
/**
* Zusätzliche Aktionen am Verbindungsabschnitt im Admin (z. B. „Verbindung testen“).
* Werden nur beim Bearbeiten angezeigt.
*
* @return list<Action>
*/
public function adminActions(): array
{
return [];
}
/**
* Konfigurationswerte, die nie ins Formular gelangen und beim Speichern mit
* leerem Feld erhalten bleiben.
*
* @return list<string>
*/
public function secretFields(): array
{
return [];
}
/**
* Felder, die bestimmen, wohin die Geheimnisse geschickt werden (Server, Aussteller …).
* Ändert sich eines, müssen die Geheimnisse neu eingegeben werden.
*
* @return list<string>
*/
public function destinationFields(): array
{
return [];
}
/**
* Standardzuordnung Profilfeld => Attribut für neue Anbieter.
*
* @return array<string, string>
*/
public function defaultAttributeMap(): array
{
return [];
}
/**
* Vorschläge für die Attributauswahl: Attribut => Bezeichnung.
*
* @return array<string, string>
*/
public function attributeSuggestions(?IdentityProvider $provider): array
{
return [];
}
/** Erlaubte Attributnamen – großzügig, weil SAML URIs und LDAP Bindestriche nutzt. */
public function attributePattern(): string
{
return '/^[^\s<>"\'\\\\]{1,191}$/';
}
public function attributeLabel(): string
{
return 'Attribut';
}
public function supportsManager(): bool
{
return false;
}
public function supportsPhoto(): bool
{
return false;
}
public function supportsAppRoles(): bool
{
return false;
}
/** Beschriftung für den Wert einer Gruppe in der Rollen-Zuordnung. */
public function groupValueLabel(): string
{
return 'Gruppe (Wert wie übermittelt)';
}
/** Anmeldung beginnen: Weiterleitung zum Anbieter oder eigenes Formular. */
abstract public function start(IdentityProvider $provider, Request $request): Response;
/**
* Rückkehr bzw. Formular auswerten und die angemeldete Person liefern.
*
* @throws IdentityException mit einer Meldung für die Person
*/
public function complete(IdentityProvider $provider, Request $request): User
{
return app(IdentityLogin::class)->finish($provider, $this->authenticate($provider, $request));
}
/**
* Identität beim Anbieter bestätigen.
*
* @throws IdentityException
*/
protected function authenticate(IdentityProvider $provider, Request $request): ExternalUser
{
throw new IdentityException('Dieses Anmeldeverfahren ist nicht vollständig eingerichtet.');
}
/** Wohin es nach der Anmeldung geht (z. B. aus einem RelayState) – null = gemerkte Seite. */
public function intendedUrl(IdentityProvider $provider, Request $request): ?string
{
return null;
}
/** Zusätzliche öffentliche Antwort, z. B. SAML-Metadaten. */
public function metadata(IdentityProvider $provider): ?Response
{
return null;
}
}