Die Bildschirmaufnahmen zeigen die englische Benutzeroberfläche.
Dieses Handbuch führt einen Administrator durch alle Anmeldeeinstellungen, Benutzerattribute, Gruppen, Benutzerkonten, lokale Registrierung, Identitätswechsel, API-Schlüssel, SSO-Anbieter und persönliche Sicherheits- und Zugriffsbildschirme.
Die Beispiele wurden auf einer Neuinstallation von SQLite erstellt. Die hier gezeigten Konten, Gruppen und Schlüssel dienen nur der Dokumentation. Geheimnisse und persönliche Attributwerte wurden aus Screenshots entfernt. Verwenden Sie in der Produktion Ihre eigenen Namen, Domänen, Lebensdauern und Regeln für die geringsten Rechte.
Inhalt
- Anmeldeeinstellungen
- Benutzerattribute
- Gruppen
- Benutzer und lokale Konten
- Lokale Anmeldung und Registrierung
- Identitätswechsel
- API Schlüssel
- Allgemeiner SSO-Workflow
- SAML
- SAML-Proxy
- CAS
- OIDC
- OAuth2
- Persönliches Profil: Sicherheit und Zugang
- Verifizierungs- und Sicherheitscheckliste
1. Anmeldeeinstellungen
Öffnen Sie Einstellungen → Benutzer → Anmeldeeinstellungen. Auf dieser Seite werden Authentifizierungsmethoden für die Anwendung aktiviert. Durch die Aktivierung eines Anbieters werden nur dessen Konfiguration und Menü verfügbar; Jedes einzelne Profil muss noch gespeichert, aktiviert, getestet und korrekt zugeordnet werden.
Übersicht über die Anmeldeeinstellungen
Hauptschalter
- Lokale Anmeldung ermöglicht die von Simbioza gespeicherte Authentifizierung mit Benutzername und Passwort.
- SimpleSAMLphp, CAS, OIDC und OAuth2 aktivieren die entsprechenden Profilgruppen SSO.
- Lokale Break-Glass-Anmeldung hält eine separate direkte Administratorroute verfügbar, wenn die normale lokale Anmeldung deaktiviert ist. Schützen Sie dieses Konto mit einem starken, eindeutigen Passwort und verwenden Sie es nur zur Wiederherstellung.
- Anmeldedauer ist ein Inaktivitätslimit in Tagen (1–365), das verlängert wird, solange der angemeldete Benutzer aktiv bleibt. Verwenden Sie auf administrativen und gemeinsam genutzten Geräten einen kürzeren Zeitraum.
„Profil aktiv“ ist nicht dasselbe wie das grüne Häkchen. Aktiv bedeutet, dass das Profil verwendet werden darf. Das grüne Häkchen und der Status „Getestet und betriebsbereit“ werden erst nach einem erfolgreichen Anbietertest und gültigen erforderlichen Zuordnungen angezeigt. Ein aktives Profil ist möglicherweise immer noch nicht betriebsbereit.
2. Benutzerattribute
Öffnen Sie Benutzerattribute. Das Modell umfasst normalerweise E-Mail, Vorname und Nachname. Fügen Sie ein Attribut hinzu, wenn die Anwendung einen Wert außerhalb des Basisprofils speichern muss, beispielsweise eine Institution, Abteilung, Mitarbeiternummer oder eine externe Verzeichnisrolle.
Ein Attribut hinzufügen
- Geben Sie einen stabilen Maschinennamen in Kleinbuchstaben ohne Leerzeichen ein, z. B.
affiliation. - Geben Sie separate kroatische und englische Etiketten an.
- Wählen Sie den Datentyp und konfigurieren Sie Erforderlich, Registrierung, Profil und Aktiv unabhängig voneinander.
- Speichern Sie es. Das neue Feld wird in Benutzerprofilen und in jeder Profilzuordnungstabelle SSO verfügbar.
Mapping verbindet ein Simbioza-Modellfeld mit dem genauen Attributnamen, der vom Anbieter zurückgegeben wird. Die Attributnamen sind genau: mail, givenName und given_name sind unterschiedliche Felder. Testen Sie zuerst, überprüfen Sie die zurückgegebenen Namen und geben Sie erst dann die Zuordnungen ein. Eine SSO-Zuordnung fügt das Feld nicht automatisch zum öffentlichen Registrierungsformular hinzu.
Welche Felder sind in der Selbstregistrierung enthalten? Der Administrator wählt dies pro Attribut aus. Registrierung steuert, ob ein Feld im öffentlichen Formular angezeigt wird, während Erforderlich einen leeren Wert in Kontexten ablehnt, in denen dieses Feld beteiligt ist. Wenn beide Einstellungen aktiviert sind, ist das Feld bei der Selbstregistrierung ein Pflichtfeld. Ein erforderliches Attribut muss außerdem über eine gültige SSO-Zuordnung verfügen, damit ein Anbieterprofiltest betriebsbereit ist. In diesem Beispiel speichert affiliation die von einem Anbieter bereitgestellte Institution und erscheint im Profil, sodass sie absichtlich von der Registrierung ausgeschlossen wird.
3. Gruppen
Gruppen sammeln Benutzer und übertragen Berechtigungen. Die Administratorgruppe ist eine geschützte Systemgruppe und sollte nicht als normale Unternehmensgruppe verwendet werden. Erstellen Sie separate Gruppen mit den geringsten Rechten für Abteilungen, Projekte oder Rollen.
System- und Beispielgruppen in der englischen Benutzeroberfläche.\
- Wählen Sie Gruppe hinzufügen (die Plus-Schaltfläche), geben Sie einen erkennbaren Gruppennamen ein und aktivieren Sie Aktiv.
- Wählen Sie Gruppen speichern. Dieser Bildschirm enthält keine Beschreibung oder Inhaltsberechtigungen.
- Fügen Sie den Details jedes Benutzers eine Gruppenmitgliedschaft hinzu oder entfernen Sie sie.
- Gewähren Sie der Gruppe die erforderlichen Berechtigungen in den Einstellungen eines Arbeitsbereichs, einer Seite, eines Kalenders oder einer Umfrage. Die SSO-Mitgliedschaft kann auch Regeln folgen, die auf einem zugeordneten Attribut basieren.
Ergebnis: Die Gruppe existiert und kann beim Zuweisen von Berechtigungen ausgewählt werden. Durch die alleinige Erstellung werden keine Inhalte für die Mitglieder geöffnet.
Um eine Nicht-Systemgruppe vorübergehend zu deaktivieren, deaktivieren Sie Aktiv und speichern Sie. Zum dauerhaften Löschen wählen Sie Gruppe löschen. Prüfen Sie auf der separaten Bestätigungsseite den Gruppennamen und die angezeigten Folgen für Mitgliedschaften und Zuordnungsregeln. Bestätigen Sie anschließend die Löschung oder brechen Sie ab. Benutzerkonten bleiben bestehen. Ein leerer Name löscht keine Gruppe mehr. Prüfen Sie vorher, wo die Gruppe den Zugriff auf Inhalte ermöglicht. Eine neue Gruppe gleichen Namens erhält eine andere Identität und stellt frühere Mitgliedschaften oder Rechte nicht wieder her. Systemgruppen können nicht gelöscht werden.
4. Benutzer und lokale Konten
Öffnen Sie Einstellungen → Benutzer → Benutzer, um Konten zu finden, ihren Status zu überprüfen und Mitgliedschaft und Zugriff zu verwalten.
Erstellen eines lokalen Benutzers
- Wählen Sie Neuer Benutzer aus.
- Geben Sie eine eindeutige Anmeldekennung, einen Anzeigenamen und eine E-Mail-Adresse ein.
- Wählen Sie die lokale Authentifizierungsquelle und weisen Sie ein sicheres temporäres Passwort zu.
- Bei der ersten Anmeldung ist eine Passwortänderung erforderlich.
- Weisen Sie nur die erforderlichen Gruppen zu. Der Administratorzugriff darf nicht die Standardeinstellung sein.
Erstellen Sie ein lokales Benutzerformular
Überprüfen Sie auf der Detailseite die Kontoaktivität, die Authentifizierungsquelle, verknüpfte externe Identitäten und Gruppenmitgliedschaften. Die Deaktivierung ist in der Regel sicherer als das Löschen, da dadurch der Prüfpfad erhalten bleibt. Ersetzen Sie niemals manuell die stabile Betreff-ID eines externen Anbieters.
5. Lokale Anmeldung und Registrierung
Lokale Anmeldung steuert die Selbstregistrierung. Lassen Sie es für geschlossene Systeme deaktiviert und erstellen Sie Konten administrativ oder über vertrauenswürdige SSO. Wenn diese Option aktiviert ist, erstellt die Registrierung ein aktives normales Konto und meldet den Benutzer an. Es wird keine Bestätigungs-E-Mail gesendet und der Besitz der eingegebenen Adresse wird nicht nachgewiesen. Lassen Sie bei einem geschlossenen System die Registrierung deaktiviert und verwenden Sie vom Administrator erstellte Konten oder einen vertrauenswürdigen SSO-Anbieter. Veröffentlichen Sie eine entsprechende Datenschutzerklärung, bevor Sie Registrierungen annehmen. Das öffentliche Formular enthält nur Benutzerattribute, deren Option Registrierung aktiviert ist; das SSO-nur-Feld Institution wird daher hier nicht angezeigt.
Stellen Sie nach dem Testen den vorgesehenen Produktionszustand wieder her. Passwörter sollten eindeutig und ausreichend lang sein und in einem Passwort-Manager gespeichert werden. Administratoren dürfen Benutzer niemals nach ihrem aktuellen Passwort fragen.
6. Identitätswechsel
Benutzer imitieren öffnet die Anwendung vorübergehend im Kontext des ausgewählten Benutzers. Verwenden Sie es für Berechtigungs- und Anzeigediagnosen, nicht für die Durchführung von Geschäftsaktionen im Namen des Benutzers.
Der Identitätswechsel testet nicht die tatsächliche SSO-Authentifizierung, MFA oder die Anbieterrichtlinie. Nutzen Sie dazu den Profiltest oder ein dediziertes Testkonto.
7. API-Tasten
Diese Ansichten stehen zur Verfügung, wenn das API-Modul installiert und aktiviert ist. Ein API-Schlüssel handelt mit den Rechten seines Besitzers. Scopes können dessen vorhandene Berechtigungen nur weiter einschränken; sie gewähren keine zusätzlichen Rechte. Verwenden Sie für jede Anbindung einen eigenen Schlüssel, eine aussagekräftige Bezeichnung, eine möglichst kurze Gültigkeit und möglichst wenige Scopes.
Direkte Schlüsselausgabe
- Wählen Sie den Eigentümer und nur die erforderlichen Scopes aus.
- Legen Sie ein Ablaufdatum und bei Bedarf eine zulässige IP-Adresse oder Netzwerkbeschränkung fest.
- Erstellen Sie den Schlüssel und kopieren Sie das Geheimnis sofort in den sicheren Speicher.
- Das Geheimnis wird nur einmal gezeigt. Bei Verlust den Schlüssel widerrufen und einen neuen ausstellen.
Benutzeranfrage und Administratorgenehmigung
Ein Benutzer kann einen Schlüssel aus dem persönlichen Profil anfordern und seinen Zweck erläutern. Der Administrator überprüft Eigentümer, Scopes, Lebensdauer und Begründung und genehmigt dann die Anfrage oder lehnt sie ab. Nach der Freigabe kann der Nutzer das Geheimnis einmalig im persönlichen Profil preisgeben. Wenn Benachrichtigungen aktiviert sind, verweist eine In-App-Benachrichtigung auch auf diesen Bildschirm. Weder die Benachrichtigung noch eine E-Mail sollten das Geheimnis enthalten.
8. Allgemeiner SSO-Workflow
- Registrieren Sie die Anwendung beim Anbieter und geben Sie nur die erforderlichen Endpunkte, die Client-ID und das Geheimnis ein.
- Speichern Sie das aktive Profil. Vorhandene Geheimnisse werden beim Bearbeiten nie angezeigt; Wenn Sie das geheime Feld leer lassen, bleibt der serverseitige Wert erhalten.
- Wählen Sie Profil testen, bevor Sie Zuordnungen erraten. Führen Sie eine echte Anmeldung durch, um die tatsächlichen Attribute des Anbieters zu erfassen.
- Ordnen Sie die Felder Betreff, Login, Anzeigename und Benutzer den zurückgegebenen Namen zu.
- Testen Sie noch einmal. Nur Getestet und betriebsbereit zusammen mit einem grünen Häkchen bestätigt ein vollständiges Profil.
Erlaubte Domänen
Die Liste beschränkt die Anmeldung auf Organisationsdomänen. Geben Sie eine Domäne pro Zeile oder eine durch Kommas getrennte Liste ein. example.org lässt diese Domäne und ihre Unterdomänen zu; ein Suffix wie hr lässt Bezeichner zu, deren Domäne auf .hr endet. Eine leere Liste erlegt keine Domänenbeschränkung auf.
Domänenquellenattribut muss das echte Anbieterattribut sein, das einen Wert wie user@example.org oder eine Domäne enthält. Dies ist nur erforderlich, wenn die Liste der zulässigen Domänen ausgefüllt ist. Verwenden Sie keinen Anzeigenamen oder einen anderen veränderlichen Wert.
Öffentliche Rückrufadressen
Der Anbieter muss den Browser auf die öffentliche URL derselben Installation zurückführen. Schließen Sie ein Unterverzeichnis ein, wenn eines verwendet wird: Geben Sie für eine Anwendung unter https://simbioza.example.org/simbioza diesen vollständigen Wert als öffentliche Basis-URL ein. Es handelt sich nicht um die interne PHP-FPM-, Container- oder Datenbankadresse. Registrieren Sie die genauen Rückruf-URLs, die vom Profil angezeigt werden.
9. SAML
Ein SAML-Profil hängt von einem separat installierten und korrekt konfigurierten SimpleSAMLphp ab. Sein Autoloader, die SP-Authentifizierungsquelle, Zertifikate, Metadaten und Rückgabe-URLs müssen bereits funktionieren. Der Pfad zu vendor/autoload.php und der Name der Authentifizierungsquelle müssen mit dieser Installation übereinstimmen.
10. SAML-Proxy- und untergeordnete Profile
Eine Proxy-Instanz stellt eine SimpleSAMLphp-Authentifizierungsquelle dar, die mehrere Upstream-Anbieter verfügbar machen kann. Auf der Registerkarte Standard werden der gemeinsame Autoload-Pfad, die Authentifizierungsquelle und die Basiszuordnung definiert. Zusätzliche untergeordnete Registerkarten erben die gemeinsamen Verbindungseinstellungen und behalten gleichzeitig ihre eigenen Attributzuordnungen bei.
Ein Proxy hat keine Felder für zulässige Domänen oder Domänenquellenattribute. Dies ist beabsichtigt: Upstream-Anbieter geben möglicherweise unterschiedliche Kennungen und Domänen zurück. Erzwingen Sie Einschränkungen beim Proxy oder Upstream-Anbieter, nicht durch eine gemeinsame Domänenregel Simbioza.
Standard / AAI@EduHR
11. CAS
Ein CAS-Profil benötigt die Server-Basis-URL und seine Anmelde-, Validierungs- und Abmelde-Endpunkte. Wenn eine private CA-Kette verwendet wird, stellen Sie einen lesbaren Zertifikatspfad bereit. Deaktivieren Sie niemals die TLS-Validierung, um eine falsche Zertifikatkonfiguration zu umgehen.
12. OIDC
OIDC verwendet eine Client-ID und ein Geheimnis, eine Autorisierung, ein Token, Benutzerinformationen und optional Sitzungsendpunkte. Der Bereich muss openid enthalten, gefolgt von nur erforderlichen Daten wie profile und email. Öffentliche Redirect-Basis-URL ist die vollständige öffentliche Basisadresse dieser Installation, einschließlich eines Unterverzeichnisses, sofern vorhanden.
Verwenden Sie einen erzwungenen Anmeldeparameter wie max_age=0 nur, wenn der Anbieter dies unterstützt und Anmeldung erzwingen aktiviert ist. Andernfalls lassen Sie das Feld leer, um eine gültige vorhandene SSO-Sitzung beizubehalten.
13. OAuth2
OAuth2 verwendet Autorisierungs-, Token- und Benutzerinfo-Endpunkte sowie die für Benutzerdaten erforderlichen Scopes. Wenn der Anbieter OpenID Connect unterstützt, bevorzugen Sie OIDC, da es die Identitäts- und Tokenvalidierung standardisiert. OAuth2 Für die Abmeldung ist möglicherweise ein dedizierter Endpunkt, ein Umleitungsparametername oder ein Hinweis erforderlich. Geben Sie nur Werte ein, die in der Anbieterdokumentation erforderlich sind.
14. Persönliches Profil: Sicherheit und Zugang
Öffnen Sie Persönliches Profil aus dem Benutzermenü. Der Hauptabschnitt zeigt Identität und benutzerdefinierte Attribute. Sicherheit und Zugriff zeigt Gruppenmitgliedschaft, lokalen Passwortstatus, verknüpfte externe Anmeldungen und API Schlüsselanforderungen an.
Verknüpfen Sie ein externes Konto nur, solange Sie beide Identitäten kontrollieren. Entfernen Sie unbekannte oder nicht verwendete Links, aber stellen Sie zunächst sicher, dass weiterhin eine andere Anmeldemethode verfügbar ist. Ändern Sie lokale Passwörter über dieses sichere Formular, niemals per E-Mail oder einer Administratornachricht.
15. Verifizierungs- und Sicherheitscheckliste
- Halten Sie mindestens einen kontrollierten Administrator-Login bereit; Bewahren Sie das Glasbruchkonto außerhalb des normalen täglichen Gebrauchs auf.
- Überprüfen Sie für jedes SSO-Profil die genauen Rückruf-URLs, TLS-Zertifikate, erforderliche Scopes und geheime Rotation.
- Akzeptieren Sie kein aktives Kontrollkästchen als Beweis. Erfordern den grünen Betriebszustand nach dem wiederholten Test.
- Der Betreff muss eine unveränderliche Anbieterkennung sein. Login und E-Mail können sich ändern und sind nicht immer geeignete primäre Identifikatoren.
- Testen Sie Domäneneinschränkungen mit einem zugelassenen und einem verweigerten Testkonto.
- Überprüfen Sie regelmäßig Administratoren, Gruppenmitgliedschaften, verknüpfte externe Anmeldungen, aktive API-Schlüssel und ausstehende Anfragen.
- Geben Sie niemals Passwörter, Client-Geheimnisse, Token, API-Geheimnisse oder rohe persönliche Attribute in Screenshots, Dokumentationen, Tickets oder in der Quellcodeverwaltung ein.
- Entfernen oder deaktivieren Sie nach dem Testen nicht mehr benötigte Dokumentationskonten und Schlüssel.
Testen Sie nach dem Speichern eine normale Anmeldung und ein abgelehntes Konto. Stellen Sie sicher, dass jeder Benutzer nur die Inhalte und Aktionen sieht, die seinen Gruppen zugewiesen sind.
Kommentare
0Es liegen noch keine Kommentare vor.
Sie müssen sich anmelden, um einen Kommentar hinzuzufügen.