Seminar Squidex – Administration, Benutzer, Rollen und API-Clients

Eine belastbare Squidex-Installation benötigt ein nachvollziehbares Berechtigungsmodell für Menschen, Teams, Anwendungen und automatisierte Prozesse. Das Seminar ordnet globale und appbezogene Verantwortlichkeiten, Rollen, Clients und Betriebsregeln in ein gemeinsames Administrationskonzept ein.

Im Mittelpunkt stehen minimale Rechte, wiederholbare Onboarding- und Offboarding-Abläufe sowie die praktische Prüfung jeder Berechtigungsentscheidung. Konfigurationen werden an einer mehrstufigen Beispielorganisation mit Redaktion, Entwicklung, Betrieb und externen Integrationen umgesetzt.

Zielgruppe

Squidex-Administratoren, Plattformverantwortliche, Security-Verantwortliche, technische Projektleiter und Betreiber mandantenfähiger Content-Plattformen

Voraussetzungen

Grundverständnis von Squidex-Apps, HTTP-APIs und Identitätsmanagement; Administratorzugang zu einer Schulungsinstanz

Seminarziele

• Benutzer, Teams, Apps und API-Clients fachlich sauber voneinander abgrenzen.
• Rollen und Berechtigungen nach dem Least-Privilege-Prinzip entwerfen.
• Client-Zugänge für Frontends, Integrationen und Automatisierung sicher verwalten.
• Administrative Änderungen prüfen, dokumentieren und reproduzierbar freigeben.
• Ein vollständiges Onboarding-, Rezertifizierungs- und Offboarding-Verfahren aufbauen.

Inhaltsübersicht

1. Zielgruppe und Voraussetzungen
2. Seminarziele
3. Mandanten-, Team- und App-Struktur planen
4. Benutzer und Mitgliedschaften verwalten
5. Rollen und Berechtigungen modellieren
6. API-Clients und technische Identitäten absichern
7. Governance, Rezertifizierung und Betriebsübergabe
8. Praxisprojekt und Abnahme

1. Mandanten-, Team- und App-Struktur planen

Dieser Themenblock verbindet fachliche Entscheidung, konkrete Konfiguration und überprüfbare Abnahme. Die Schritte werden an einer durchgängigen Beispiel-App umgesetzt und mit geeigneten Positiv- und Negativfällen kontrolliert.

Schrittweises Vorgehen

1. Organisationseinheiten, Verantwortlichkeiten und Schutzbedarfe erfassen.
2. Teams und Apps anhand fachlicher Grenzen statt technischer Zufälle schneiden.
3. Eigentümer, Administratoren, Entwickler und Redaktionen eindeutig zuordnen.
4. Namens-, Kennzeichnungs- und Dokumentationsregeln für neue Apps festlegen.

Prüfpunkte

• Die Konfiguration erfüllt den beschriebenen fachlichen Zweck ohne unnötige Sonderfälle.
• Berechtigungen, Fehlerzustände und Auswirkungen auf abhängige Komponenten sind geprüft.
• Ergebnis, offene Punkte und Wiederholungsweg sind nachvollziehbar dokumentiert.

2. Benutzer und Mitgliedschaften verwalten

Der Abschnitt wird als vollständiger Arbeitsablauf bearbeitet: Ausgangslage erfassen, Zielzustand festlegen, Konfiguration umsetzen, Verhalten testen und die betriebliche beziehungsweise redaktionelle Übergabe dokumentieren.

Schrittweises Vorgehen

1. Einladungs- und Aufnahmeprozess für interne und externe Konten definieren.
2. Team- und App-Mitgliedschaften mit einem Rollenregister abgleichen.
3. Temporäre Zugriffe mit Ablauf, Zweck und Verantwortlichem dokumentieren.
4. Offboarding inklusive Sperrung, Entzug und Nachkontrolle durchführen.

Prüfpunkte

• Die Konfiguration erfüllt den beschriebenen fachlichen Zweck ohne unnötige Sonderfälle.
• Berechtigungen, Fehlerzustände und Auswirkungen auf abhängige Komponenten sind geprüft.
• Ergebnis, offene Punkte und Wiederholungsweg sind nachvollziehbar dokumentiert.

3. Rollen und Berechtigungen modellieren

Die Inhalte werden nicht isoliert demonstriert. Jede Entscheidung wird anhand von Auswirkungen auf Redaktion, API, Sicherheit, Betrieb und spätere Änderungen bewertet und anschließend praktisch validiert.

Schrittweises Vorgehen

1. Benötigte Aktionen je Persona in einer Berechtigungsmatrix erfassen.
2. Standardrollen bewerten und bei Bedarf fachlich begrenzte Rollen ableiten.
3. Rechte auf App-, Schema-, Content- und Asset-Ebene gezielt einschränken.
4. Positiv- und Negativtests mit repräsentativen Benutzerkonten ausführen.
5. Ausnahmen, Kompensationsmaßnahmen und Freigaben revisionsfähig festhalten.

Prüfpunkte

• Die Konfiguration erfüllt den beschriebenen fachlichen Zweck ohne unnötige Sonderfälle.
• Berechtigungen, Fehlerzustände und Auswirkungen auf abhängige Komponenten sind geprüft.
• Ergebnis, offene Punkte und Wiederholungsweg sind nachvollziehbar dokumentiert.

4. API-Clients und technische Identitäten absichern

Im Mittelpunkt steht ein reproduzierbares Vorgehen. Konfiguration, Testdaten, Prüfschritte und Abnahmekriterien werden so festgehalten, dass der Ablauf in einer eigenen Umgebung wiederholt werden kann.

Schrittweises Vorgehen

1. Frontend-, Backend-, Migrations- und Monitoring-Clients getrennt anlegen.
2. Berechtigungsumfang und Lebensdauer an den konkreten Einsatzzweck koppeln.
3. Secrets ausschließlich über geeignete Secret-Stores bereitstellen.
4. Rotation, Widerruf und Notfallwechsel als wiederholbaren Ablauf testen.
5. Unzulässige Client-Nutzung durch gezielte API-Prüfungen erkennen.

Prüfpunkte

• Die Konfiguration erfüllt den beschriebenen fachlichen Zweck ohne unnötige Sonderfälle.
• Berechtigungen, Fehlerzustände und Auswirkungen auf abhängige Komponenten sind geprüft.
• Ergebnis, offene Punkte und Wiederholungsweg sind nachvollziehbar dokumentiert.

5. Governance, Rezertifizierung und Betriebsübergabe

Dieser Themenblock verbindet fachliche Entscheidung, konkrete Konfiguration und überprüfbare Abnahme. Die Schritte werden an einer durchgängigen Beispiel-App umgesetzt und mit geeigneten Positiv- und Negativfällen kontrolliert.

Schrittweises Vorgehen

1. Regelmäßige Überprüfung von Mitgliedschaften, Rollen und Clients terminieren.
2. Vier-Augen-Freigaben für privilegierte Änderungen definieren.
3. Administrative Checklisten, Nachweise und Eskalationswege erstellen.
4. Soll-Ist-Abweichungen bewerten und priorisierte Korrekturmaßnahmen ableiten.
5. Betriebsübergabe mit Verantwortungsmatrix und Abnahmetest abschließen.

Prüfpunkte

• Die Konfiguration erfüllt den beschriebenen fachlichen Zweck ohne unnötige Sonderfälle.
• Berechtigungen, Fehlerzustände und Auswirkungen auf abhängige Komponenten sind geprüft.
• Ergebnis, offene Punkte und Wiederholungsweg sind nachvollziehbar dokumentiert.

Praxisprojekt und Abnahme

Für eine Beispielorganisation mit mehreren Teams, Redaktionen und Anwendungen entsteht ein vollständiges Zugriffs- und Administrationsmodell.

Arbeitsschritte

1. Personas, Schutzbedarfe und technische Identitäten inventarisieren.
2. Rollenmatrix, Client-Konzept und Genehmigungswege entwerfen.
3. Konfiguration in einer Schulungs-App umsetzen und mit Testkonten prüfen.
4. Onboarding, Secret-Rotation und Offboarding praktisch durchspielen.
5. Betriebshandbuch und Rezertifizierungsplan als Abnahmeunterlage erstellen.

Abnahmekriterien

• Der fachliche Anwendungsfall ist mit repräsentativen Daten vollständig durchgespielt.
• Fehler-, Berechtigungs- und Wiederanlaufszenarien sind kontrolliert geprüft.
• Konfiguration, Tests und Verantwortlichkeiten sind so dokumentiert, dass der Transfer in eine eigene Umgebung möglich ist.