Seminar iRedMail Pro: API und Automatisierung

Überblick

Das Seminar überführt wiederkehrende Verwaltungsaufgaben aus iRedAdmin-Pro in reproduzierbare API-Abläufe. Konten, Domänen, Aliase und Verteiler werden über klar definierte Requests verwaltet und in betriebliche Prozesse eingebunden.

Neben den Endpunkten stehen Idempotenz, Eingabeprüfung, Fehlerbehandlung, Geheimnisschutz und Protokollierung im Vordergrund. Die Automatisierung wird mit Kommandozeilenwerkzeugen und Python umgesetzt.

Inhaltsübersicht

1. API-Aufbau, Authentifizierung und Berechtigungen
2. Domänen und Konten auslesen
3. Benutzerkonten automatisiert bereitstellen
4. Aliase, Verteiler und Mitgliedschaften verwalten
5. Änderung, Sperrung und Löschung sicher automatisieren
6. Robuste Skripte mit curl und Python erstellen
7. Integration in betriebliche Prozesse

Zielgruppe

Systemadministratoren, DevOps-Fachkräfte, Entwickler betrieblicher Werkzeuge und Verantwortliche für automatisierte Benutzerbereitstellung.

Voraussetzungen

• Sichere Linux-Shell-Kenntnisse
• Grundkenntnisse in HTTP, JSON und Skripterstellung
• Kenntnisse der iRedMail-Konten- und Domänenverwaltung

Seminarinhalte

1. API-Aufbau, Authentifizierung und Berechtigungen

1. Schritt 1: Den Funktionsumfang der REST-Schnittstelle und ihre Verwaltungsobjekte erfassen.
2. Schritt 2: Eine Sitzung mit einem geeigneten Administratorkonto aufbauen.
3. Schritt 3: Rollen und zulässige Verwaltungsbereiche vor dem ersten Schreibzugriff prüfen.
4. Schritt 4: Antwortstruktur, Erfolgskennzeichen und Fehlermeldungen protokollieren.

2. Domänen und Konten auslesen

1. Schritt 1: Bestehende Domänen und Konten gezielt abfragen.
2. Schritt 2: Antwortdaten in strukturierte Arbeitsobjekte überführen.
3. Schritt 3: Pflichtfelder, optionale Felder und Statuswerte verifizieren.
4. Schritt 4: Bestandsdaten für spätere Soll-Ist-Vergleiche speichern.

3. Benutzerkonten automatisiert bereitstellen

1. Schritt 1: Eingabedaten aus einer geprüften Datei oder einem vorgelagerten System übernehmen.
2. Schritt 2: Benutzername, Kennwort, Quota, Status und Anzeigename validieren.
3. Schritt 3: Konten erzeugen und die zurückgegebenen Ergebnisse prüfen.
4. Schritt 4: Teilweise fehlgeschlagene Läufe erkennen und kontrolliert fortsetzen.

4. Aliase, Verteiler und Mitgliedschaften verwalten

1. Schritt 1: Aliasobjekte mit Namen, Richtlinie und Mitgliedern anlegen.
2. Schritt 2: Mitgliedschaften hinzufügen, entfernen oder vollständig ersetzen.
3. Schritt 3: Backendabhängige Unterschiede bei Verteilerobjekten berücksichtigen.
4. Schritt 4: Zustellung und Zugriffsrichtlinie mit automatisierten Tests kontrollieren.

5. Änderung, Sperrung und Löschung sicher automatisieren

1. Schritt 1: Vor jeder Änderung den aktuellen Objektzustand lesen.
2. Schritt 2: Nur tatsächlich abweichende Werte schreiben.
3. Schritt 3: Sperrungen, Reaktivierungen und Löschungen mit Freigabekriterien versehen.
4. Schritt 4: Eine Rücknahmeliste und ein nachvollziehbares Änderungsprotokoll erzeugen.

6. Robuste Skripte mit curl und Python erstellen

1. Schritt 1: Requests zunächst mit einem Kommandozeilenwerkzeug reproduzierbar testen.
2. Schritt 2: Die Abläufe anschließend in eine modular aufgebaute Python-Anwendung übertragen.
3. Schritt 3: Zeitüberschreitungen, Sitzungsverlust, Validierungsfehler und Serverfehler behandeln.
4. Schritt 4: Rückgabecodes, strukturierte Logs und eindeutige Laufkennungen einführen.

7. Integration in betriebliche Prozesse

1. Schritt 1: Ein Sollmodell für Eintritt, Änderung und Austritt definieren.
2. Schritt 2: API-Zugriffe an Servicekatalog, Personalprozess oder Identitätsverwaltung anbinden.
3. Schritt 3: Geheimnisse außerhalb des Quellcodes speichern und Zugriffe minimieren.
4. Schritt 4: Test-, Freigabe- und Produktionsabläufe voneinander trennen.

Praxisübungen

• Automatisierte Bereitstellung mehrerer Konten aus geprüften Strukturdaten
• Idempotente Aktualisierung von Quoten und Kontostatus
• Aufbau und Pflege eines Verteilers einschließlich Mitgliedschaftsänderungen
• Implementierung eines Fehlerprotokolls mit Wiederanlauf und Rücknahmeliste