# Microsoft-365-Backup (nur lesend) mit Restore der Secrets

Skripte, die die Konfiguration und die Inhalte eines Microsoft-365-Tenants lesend als JSON und Dateien sichern:
Verzeichnis (Benutzer, Gruppen, Rollen, Apps), Richtlinien, Intune, SharePoint (Sites, Listen, Dateien, Versionen),
Postfächer, Teams, Exchange-Online- und Compliance-Konfiguration. Alle Aufrufe gegen Microsoft sind lesend (GET bzw. `Get-*`).
Dazu kommt ein Restore-Skript, das die **nicht sicherbaren** Kennwörter und Secret-Werte beim Wiederherstellen neu setzt.

## Voraussetzungen

- Python 3 mit `requests`, `PyJWT` und `cryptography`. Für die Zertifikate im Restore zusätzlich `openssl`.
- PowerShell 7 mit den Modulen `ExchangeOnlineManagement` und `MicrosoftTeams` (nur für `compliance.ps1` und `teams_settings.ps1`).
- Eine **App-Registrierung** im Tenant (Beispielname `backup-reader`) mit Anwendungsberechtigungen, die nur lesen
  (zum Beispiel `User.Read.All`, `Group.Read.All`, `Directory.Read.All`, `Policy.Read.All`, `Application.Read.All`, `Sites.Read.All`,
  `Files.Read.All`, `Mail.Read`, `Calendars.Read`, `Contacts.Read`, `Team.ReadBasic.All`, `Chat.Read.All`, `ChannelMessage.Read.All`,
  `DeviceManagementConfiguration.Read.All`, `DeviceManagementApps.Read.All`, `DeviceManagementManagedDevices.Read.All`),
  dazu für Exchange `Exchange.ManageAsApp` mit einer Leserolle und für SharePoint `Sites.FullControl.All` nur dann, wenn die Admin-Site gelesen werden soll.
  Welche Rechte wirklich ankommen, zeigt `backup/permission_probe.py`.
- Ein **Zertifikat** für die App: öffentlicher Teil in der App-Registrierung, privater Schlüssel (PEM) auf dem Backup-Rechner.

## Umgebungsvariablen

Es gibt keine festen Werte im Code. Alles kommt aus der Umgebung:

| Variable | Inhalt |
|---|---|
| `M365_TENANT_ID` | Verzeichnis-ID, `<TENANT-ID>` |
| `M365_CLIENT_ID` | Anwendungs-ID der App, `<CLIENT-ID>` |
| `M365_CERT_THUMBPRINT` | SHA-1-Fingerabdruck des Zertifikats, `<CERT-THUMBPRINT>` |
| `M365_CERT_KEY_PATH` | Pfad zum privaten Schlüssel (PEM); ersatzweise `M365_CERT_PATH` |
| `M365_CERT_PATH` | Pfad zum Zertifikat (PEM), nur für die PowerShell-Skripte |
| `M365_TENANT_NAME` | Tenant-Domäne, zum Beispiel `contoso.onmicrosoft.com` |
| `M365_ANCHOR_GUID` | optional: GUID der System-Mailbox für den Header `X-AnchorMailbox` |

Für den Restore gelten eigene Variablen für den **Ziel**-Tenant: `M365_TARGET_CLIENT_SECRET` oder
`M365_TARGET_CERT_PEM` und `M365_TARGET_CERT_KEY`. Fehlt beides, fragt das Skript das Client-Secret mit `getpass` ab.

## Reihenfolge

Alle Skripte nehmen `--out <Zielordner>` (zum Beispiel `./backup/contoso/20261116-0557`) und lassen sich mit `--help` ansehen.
Die meisten sind wiederaufnehmbar: Bereits gesicherte Dateien werden übersprungen. Mit `--max-*` lässt sich der Umfang für einen Probelauf begrenzen.

1. `backup/graph_export.py` Verzeichnis, Richtlinien, Rollen, Apps, Intune, SharePoint-Sites mit Listen (nach `graph/`).
2. `backup/drive_inventory.py` Inventar aller Laufwerke (nach `graph/drives_inventory.json`).
3. `backup/files_export.py` alle Dateien samt `manifest.jsonl` (SHA-256).
4. `backup/file_versions.py` ältere Dateiversionen (`--max-versions`).
5. `backup/sharepoint_lists.py` Listeneintrag-Versionen, Papierkorb, Seiten mit Layout, Strukturprüfung.
6. `backup/mailboxes.py` Mail, Anhänge, Kalender und Kontakte je Benutzer.
7. `backup/teams.py` Teams, Kanäle, Nachrichten, Chats.
8. `backup/graph_settings.py` weitere Richtlinien, Rollen, Intune-Details, Lizenzen.
9. `backup/spo_tenant.py` SharePoint-Tenant-Einstellungen über die Admin-Site.
10. `backup/exchange.py` Exchange-Online-Konfiguration (`--retry-gzip` wiederholt Abrufe, die an einem gzip-Fehler scheiterten).
11. `backup/compliance.ps1` Purview/Compliance-Konfiguration (PowerShell).
12. `backup/teams_settings.ps1` Teams-Richtlinien (PowerShell).
13. `backup/secrets_inventory.py` Inventar der App-Secrets und Zertifikate (nur Metadaten).
14. `backup/permission_probe.py`, `backup/verify_files.py`, `backup/report.py` Rechteprobe, Vollständigkeitsprüfung, Sammelbericht.

`m365_auth.py` ist die gemeinsame Anmeldung (Zertifikat-JWT, Wiederholung bei 429/5xx, Paging). Exchange-Aufrufe sind auf `Get-*` beschränkt.

## Was gesichert wird und was nicht

Gesichert werden Konfiguration und Inhalte, soweit die Berechtigungen reichen. Was Microsoft nicht herausgibt, fehlt:
**Kennwörter, Secret-Werte von Apps und private Schlüssel von Zertifikaten sind nicht auslesbar.** Das Inventar
(`secrets_inventory.json`) hält nur fest, welche Secrets und Zertifikate es gab: App, Name, `keyId`, Ablaufdatum.
Ebenfalls nicht enthalten sind MFA-Registrierungen, Verbindungen (Power Automate und andere), Gast-Einladungen und
Inhalte, die der Tenant per API nicht liefert. Was ein Endpunkt verweigert hat, steht in den Dateien `not_possible.json`.

## Restore der Secrets

`restore/secrets_restore.py` liest den Plan aus dem Backup und zeigt, welche Stellen ein neues Secret brauchen
(Benutzerkennwörter, App-Secrets, Zertifikate, Dienstprinzipale, dazu eine Checkliste für manuelle Schritte).

- **Ohne `--execute` ist alles ein Trockenlauf:** kein Netz, keine Änderung, nur der Plan.
- Mit `--execute` fragt das Skript **interaktiv** nach: je Person «random», «enter» oder «skip». Eigene Kennwörter werden
  zweimal mit `getpass` eingegeben (Eingabe unsichtbar) und gegen Regeln geprüft (12 bis 256 Zeichen, 3 von 4 Zeichenarten).
- Neue App-Secrets und Zertifikate werden im Ziel angelegt. Die neuen Werte stehen **nie** in Journal oder Log. Sie landen
  in einer Datei mit Rechten 600 (oder einmalig am Bildschirm, optional zusätzlich im Azure Key Vault) und müssen danach
  in einen Kennwort-Manager übernommen und die Datei gelöscht werden.
- Wiederaufnahme: Das Journal merkt sich Erledigtes. Ein erneuter Start überspringt es.

Beispiel Trockenlauf: `python3 restore/secrets_restore.py --backup ./backup/contoso/20261116-0557 --tenant <TENANT-ID> --client-id <CLIENT-ID> --new-domain example.com`

## Prüfstand (ehrlich)

Der Demo-Tenant ist abgelaufen. Seit der Umbenennung und Übersetzung ist **kein Skript gegen einen Tenant gelaufen**.
Geprüft wurde:

- Syntax aller Python-Dateien (`py_compile`) und `--help` jedes Skripts ohne Anmeldung.
- Die eingebauten Unittests des Restore (7 Tests, `python3 -m unittest secrets_restore` im Ordner `restore/`).
- Ein Trockenlauf des Restore gegen ein vorhandenes Backup, nur lesend und ohne Netz.

Nicht geprüft: alle Aufrufe gegen Microsoft (Graph, Exchange-Admin-REST, SharePoint-Admin), die zwei PowerShell-Skripte
(`compliance.ps1`, `teams_settings.ps1`; PowerShell stand nicht zur Verfügung), das Schreiben ins Ziel beim Restore
und die Ablage im Key Vault. Neu gegenüber der früheren Fassung ist der eigene Zugriff auf die SharePoint-Admin-Site in
`spo_tenant.py` (vorher ein lokales Hilfsmodul, das hier nicht dabei ist). Die Sicherungsdateien haben jetzt englische
Schlüssel und Ordnernamen; Skripte, die Daten eines früheren Laufs lesen, brauchen einen Lauf mit der neuen Fassung.

Die Skripte sind ein Arbeitsstand ohne Gewähr; Einsatz und Folgen liegen bei Ihnen.
