Schnittstelle und Webhooks: Conbool 365 Backup im RMM
Die lesende Schnittstelle unter /api/v1/backup für Mandanten, Zustand, gesicherte Einheiten und Aufträge, dazu signierte Webhooks für Sicherungsalarme und ihre Erholung.
Über die Schnittstelle liest ein RMM-System oder ein eigenes Werkzeug den Stand von Conbool 365 Backup: welche Mandanten gesichert werden, wie es um jedes Postfach, jedes OneDrive und jede Website steht und welche Aufträge laufen. Webhooks melden Sicherungsalarme und ihre Erholung sofort an eine eigene Adresse.
Die Schnittstelle liest nur. Sichern, Zurückholen und Ausgaben bleiben im Portal.
Wer sie nutzen kann
| Zugang aus | Liest | Anlegen darf |
|---|---|---|
| einem Mandanten | nur diesen Mandanten | wer 365 Backup einrichten und API-Zugänge verwalten darf |
| einem Partnerkonto | das eigene Konto und alle Kundenmandanten des Partnerkontos | nur der Inhaber des Partnerkontos, weil der Zugang über alle Kunden reicht |
In beiden Fällen zählen nur Mandanten, die 365 Backup gebucht haben. Persönliche Konten gehören nicht dazu.
Ein Partnerzugang sieht zu jedem Kundenmandanten im Feld reference die Kundennummer, die der Partner selbst vergeben hat. Beim eigenen Konto des Partners und bei jedem Zugang aus einem Mandanten ist reference immer null.
Einen Mandanten, den der Zugang nicht lesen darf, gibt es für die Schnittstelle nicht. Die Antwort ist dann 404, nicht 403.
Zugang und Ziel anlegen
Beides liegt unter Verwaltung, Einstellungen, Kachel SIEM und Schnittstellen, Reiter Anbindungen, darin 365 Backup. Hat der Mandant weder MailGuard noch SecureFiles, heißt die Kachel Schnittstelle und der Reiter Zugänge.
- Zugang: Karte Schnittstelle 365 Backup, Knopf Zugang anlegen. Ein Name genügt, dazu optional Laufzeit und IP-Beschränkung. Der Zugang wird nur einmal angezeigt. Er trägt nur den Berechtigungsumfang
backup:readund öffnet keine andere Schnittstelle. Adresse kopieren im Menü der Karte liefert die Adresse der Schnittstelle. Bestehende Zugänge lassen sich Erneuern und Sperren. - Ziel für Webhooks: Karte Webhooks für 365 Backup, Knopf Ziel anlegen. Dort stehen die Empfänger-URL und die Ereignisse Sicherungsalarm und Sicherung läuft wieder, beide vorgewählt. Der Signaturschlüssel wird nur einmal angezeigt.
Ein Ziel für 365 Backup anlegen oder ändern und einen Zugang ändern oder erneuern darf nur, wer den Zugang auch vergeben darf. Für Ziele braucht es zusätzlich das Recht, die Anbindungen zu verwalten. Im Partnerkonto ist das allein der Inhaber, weil ein Ziel dort die Alarme aller Kunden bekommt.
Adresse und Anmeldung
| Adresse | https://conbool.com/api/v1/backup, bei einer eigenen Installation deren Adresse (Adresse kopieren) |
| Anmeldung | Kopf Authorization: Bearer <Zugang>, der Zugang beginnt mit csk_live_ |
| Berechtigungsumfang | backup:read |
| Grenze | 60 Abrufe je Zugang und Minute, gemeinsam für alle Abrufe dieses Zugangs unter /api/v1 |
| Sperre | nach 30 gescheiterten Anmeldungen in einer Minute von derselben Adresse antwortet die Schnittstelle dieser Adresse mit 429 |
Jede Antwort ist JSON und trägt Cache-Control: no-store. Aufrufe aus dem Browser einer fremden Seite sind nicht vorgesehen: die Antworten tragen keine Freigabe für andere Ursprünge (CORS).
curl -s -H "Authorization: Bearer csk_live_..." \ "https://conbool.com/api/v1/backup/tenants?limit=100" curl -s -H "Authorization: Bearer csk_live_..." \ "https://conbool.com/api/v1/backup/tenants/beispiel-gmbh"
Abrufe
| Abruf | Liefert |
|---|---|
GET /api/v1/backup/tenants | die Mandanten, die der Zugang lesen darf, seitenweise |
GET /api/v1/backup/tenants/{slug} | Zustand eines Mandanten: Ampel, Zahlen, Speicher, Verbindungen zu Microsoft 365, ohne Namen |
GET /api/v1/backup/tenants/{slug}/sources | alle Einheiten des Mandanten mit Zustand und letzter Sicherung |
GET /api/v1/backup/tenants/{slug}/jobs | laufende und jüngste Aufträge |
{slug} ist der Kurzname des Mandanten aus /tenants, derselbe wie in der Adresse des Portals. Eine Einheit ist ein einzelnes gesichertes Objekt: ein Postfach, ein OneDrive, eine Website, ein Team.
Mandanten
GET /api/v1/backup/tenants
| Parameter | Bedeutung |
|---|---|
limit | Einträge je Seite, 1 bis 200, Vorgabe 50. Größere Werte gelten als 200. |
cursor | der Wert aus next_cursor der vorigen Antwort, unverändert |
{
"tenants": [
{ "id": "…", "slug": "beispiel-gmbh", "name": "Beispiel GmbH", "reference": "K-1042" }
],
"next_cursor": null
}
Die Liste ist nach slug geordnet. next_cursor ist null auf der letzten Seite. Der Zeiger hängt am letzten Kurznamen der Seite: kommt zwischen zwei Seiten ein Mandant dazu oder fällt einer weg, verschiebt sich nichts. Ein Partnerzugang sieht höchstens 2000 Kunden.
Zustand eines Mandanten
GET /api/v1/backup/tenants/{slug}
{
"tenant": { "id": "…", "slug": "beispiel-gmbh", "name": "Beispiel GmbH", "reference": "K-1042" },
"status": "at_risk",
"counts": {
"sources": 116,
"healthy": 113,
"at_risk": 2,
"breached": 0,
"first_backup_pending": 1,
"paused": 0
},
"by_source_type": [
{ "type": "mailbox", "total": 64, "protected": 60 },
{ "type": "drive", "total": 58, "protected": 56 }
],
"by_protection": [
{ "protection": "protected", "count": 116 },
{ "protection": "not_licensed", "count": 6 }
],
"storage_bytes": 412316860416,
"connections": [
{
"organization": "Beispiel GmbH",
"domain": "example.com",
"last_success_at": "2026-11-17T02:47:12+00:00",
"connection_lost_at": null,
"missing_permissions": []
}
],
"incomplete": []
}
| Feld | Bedeutung |
|---|---|
status | not_configured, breached, at_risk, pending oder healthy, Regel siehe unten |
counts | Einheiten, die gesichert werden sollen, je Zustand. sources ist ihre Summe. Die Liste unter /sources nennt auch Einheiten, die nicht gesichert werden (protection ungleich protected), und ist darum meist länger. paused zählt die, bei denen gerade keine Sicherung läuft, meist weil die Verbindung zu Microsoft fehlt. |
by_source_type | je Bereich (type) alle Einheiten (total) und davon gesicherte (protected) |
by_protection | alle Einheiten je Wert von protection, auch die, die nicht gesichert werden |
storage_bytes | belegter Speicher in Byte, null wenn nicht lesbar |
connections | je verbundenem Microsoft-Mandanten: Name, Domäne, letzter Erfolg, seit wann Microsoft die Verbindung nicht mehr kennt, fehlende Berechtigungen der sichernden Anwendung |
missing_permissions ist null, solange die Berechtigungen noch nie geprüft wurden, und eine leere Liste, wenn geprüft wurde und nichts fehlt.
So entsteht status:
not_configured: keine Einheit wird gesichert,counts.sourcesist 0.breached: mindestens eine Einheit ist ohne gültige Sicherung.at_risk: mindestens eine Einheit ist gefährdet oder wird gerade nicht gesichert (counts.paused), keine ist ohne gültige Sicherung.pending: keine Einheit ist gefährdet oder ohne gültige Sicherung, aber bei allen steht die erste Sicherung noch aus. So sieht ein frisch eingerichteter Mandant aus.healthy: sonst. Ist mindestens eine Einheit gesichert, ändern Einheiten, deren erste Sicherung noch aussteht, den Wert nicht. Ihre Zahl steht incounts.first_backup_pending.
status bewertet nur die Einheiten. Ob die Verbindung zu Microsoft steht, zeigen connection_lost_at und missing_permissions.
Einheiten
GET /api/v1/backup/tenants/{slug}/sources
{
"tenant": { "id": "…", "slug": "beispiel-gmbh", "name": "Beispiel GmbH", "reference": "K-1042" },
"sources": [
{
"id": "…",
"type": "mailbox",
"name": "Anna Beispiel",
"address": "anna@example.com",
"url": null,
"active": true,
"state": "healthy",
"protection": "protected",
"paused_reason": null,
"last_success_at": "2026-11-17T02:47:12+00:00",
"last_attempt_at": "2026-11-17T02:47:12+00:00",
"rpo_hours": 24,
"m365_tenant_id": "…"
}
],
"next_cursor": null,
"incomplete": []
}
Die Liste kommt seitenweise, mit limit und cursor wie bei den Mandanten. Sie ist nach id geordnet, der Zeiger hängt an der letzten id der Seite.
| Feld | Bedeutung |
|---|---|
type | der Bereich: mailbox, archive, groupMailbox, drive, list, teams, planner, chat oder directory |
name | Anzeigename, sonst die Adresse |
address | Anmeldeadresse oder Adresse des Objekts, sonst null |
url | Webadresse bei Microsoft, soweit bekannt |
active | true, wenn die Einheit gesichert wird |
state | healthy, at_risk, breached, first_backup_pending oder paused (es wird gerade nicht gesichert, etwa weil die Verbindung zu Microsoft fehlt). Aussagekräftig nur bei active: true. |
protection | ob gesichert wird, Werte siehe unten |
paused_reason | der benannte Grund, wenn nicht gesichert wird, mit denselben Werten wie protection, sonst null |
last_success_at, last_attempt_at | letzte erfolgreiche Sicherung und letzter Versuch, unabhängig vom Erfolg |
rpo_hours | das Sicherungsziel in Stunden, an dem der Zustand gemessen wird |
m365_tenant_id | Kennung des Microsoft-Mandanten |
Die Werte von protection und paused_reason:
| Wert | Bedeutung |
|---|---|
protected | wird gesichert |
paused | nicht in der Sicherung, ohne vermerkten Grund |
paused_manually | von Hand abgeschaltet |
erased | nach Artikel 17 DSGVO gelöscht |
created_by_restore | beim Zurückholen entstanden |
removed_at_microsoft | bei Microsoft nicht mehr vorhanden |
not_licensed | über der Sitzzahl, nicht lizenziert |
excluded_by_rule | durch eine Ausschlussregel ausgenommen |
room_or_equipment | Raum- oder Gerätepostfach, nicht ausgewählt |
not_selected | noch nicht ausgewählt |
exempted | vom Kunden ausgenommen, kostet keinen Sitz |
organization_paused | die ganze Organisation ist angehalten, der Bestand bleibt bis zum Löschtermin |
other | ein Grund, den die Schnittstelle noch nicht benennt |
Lassen Sie in Ihrem Werkzeug unbekannte Werte bei type, state und protection zu.
Aufträge
GET /api/v1/backup/tenants/{slug}/jobs
{
"tenant": { "id": "…", "slug": "beispiel-gmbh", "name": "Beispiel GmbH", "reference": "K-1042" },
"running": [],
"jobs": [
{
"id": "…",
"source_id": "…",
"kind": "delta",
"status": "succeeded",
"started_at": "2026-11-17T02:41:05+00:00",
"finished_at": "2026-11-17T02:47:12+00:00",
"items": 214,
"bytes": 18874368,
"error": null,
"note": null
}
],
"next_cursor": null,
"incomplete": []
}
running: was gerade läuft, bis zu 200 Aufträge, immer vollständig und ohne Blättern.jobs: die 50 jüngsten Aufträge des Mandanten, jüngster zuerst, seitenweise mitlimitundcursorwie bei den Mandanten. Ältere liefert die Schnittstelle nicht, auch nicht übercursor: geblättert wird nur innerhalb dieser 50, mitlimit=50kommt also keinnext_cursor. Der Zeiger hängt an Beginn und Kennung des letzten Auftrags der Seite.source_idverweist aufidin/sourcesund kannnullsein.kind:initial(Erstsicherung),delta(Folgesicherung),restore(Zurückholen),verify(Prüfung). Ausgaben stehen nicht in dieser Liste.status:running,succeeded,failedoderaborted.itemsundbytes: was der Lauf gespeichert hat.error: nur beifailedundabortedgesetzt, sonstnull. Ein Objekt auscode,messageunddetail.note: der Vermerk eines gelungenen oder laufenden Auftrags in derselben Form, etwa übersprungene Kanäle; sonstnull. Ein Auftrag mitnoteist kein Fehler.
"error": {
"code": "token_unavailable",
"message": "Microsoft issued no access token. The app is missing in the Microsoft organization or its consent was revoked.",
"detail": "kein Token: invalid_client …"
}
message ist ein fester englischer Satz je code, detail der Vermerk des Laufs im Wortlaut, meist auf Deutsch. Werten Sie code aus, nicht die Texte. error und note nutzen dieselben Codes.
code | Bedeutung |
|---|---|
source_empty | der Bereich enthält nichts zu sichern. Der Lauf hat nichts gespeichert und gilt trotzdem als erfolgreich. |
empty_snapshot_discarded | Microsoft lieferte einen leeren Abzug. Er wurde nicht als Sicherung übernommen. |
nothing_read | der Lauf hat weder Elemente gelesen noch gespeichert |
service_restarted | ein Neustart des Dienstes hat den Lauf unterbrochen. Was bis dahin gespeichert war, bleibt; der nächste Takt macht weiter. |
token_unavailable | Microsoft hat keinen Zugangsschlüssel ausgestellt. Die App fehlt in der Microsoft-Organisation, oder ihre Zustimmung wurde zurückgezogen. |
malware_blocked | Microsoft hat Elemente gesperrt, die es als Schadsoftware einstuft |
items_failed | einzelne Elemente ließen sich nicht sichern |
channels_skipped | private oder geteilte Kanäle wurden übersprungen, weil sie eigene Berechtigungen haben |
nothing_to_restore | für diesen Bereich gab es zum gewählten Zeitpunkt nichts Gesichertes |
already_present | beim Zurückholen lagen einzelne Elemente schon im ursprünglichen Ordner und wurden nicht doppelt angelegt |
restored_as_draft | Seiten wurden als Entwurf zurückgeholt. Prüfen und veröffentlichen Sie sie in SharePoint. |
microsoft_error | Microsoft Graph hat einen Fehler gemeldet |
other | ein Vermerk, den die Schnittstelle noch nicht einordnet. Lesen Sie detail. |
Lassen Sie unbekannte Werte bei code zu, die Liste kann wachsen.
Unvollständige Antworten
Jede Antwort außer /tenants trägt incomplete. Darin steht, welcher Teil beim Abruf nicht lesbar war, etwa units, runs, running, connections oder storage-usage. units-truncated heißt: die Liste der Einheiten wurde gekürzt.
Ist incomplete nicht leer, heißt ein leeres Feld nicht „nichts da“. Fehlt zum Beispiel units, steht status auf not_configured. Prüfen Sie incomplete, bevor Sie status werten.
Fehler
Jede Fehlerantwort hat die Form { "error": { "code": "…" } }.
| Status | error.code | Bedeutung |
|---|---|---|
| 400 | backup.invalid_parameter | limit oder cursor ungültig. cursor gilt nur unverändert aus next_cursor derselben Liste. parameter nennt den Parameter. |
| 401 | unter anderem siem.invalid_key, siem.token_invalid, siem.key_revoked, siem.key_expired, siem.key_pending_approval, siem.ip_not_allowed, siem.mtls_unavailable, siem.client_certificate_mismatch | Zugang fehlt, ist unbekannt, ungültig, gesperrt, abgelaufen oder noch nicht freigegeben, die Adresse ist nicht erlaubt, oder das verlangte Client-Zertifikat fehlt oder passt nicht |
| 403 | siem.scope_missing | dem Zugang fehlt backup:read |
| 404 | backup.tenant_not_found | Mandant unbekannt, für diesen Zugang nicht erreichbar oder ohne 365 Backup |
| 429 | siem.rate_limited | zu viele Abrufe oder zu viele gescheiterte Anmeldungen. Die Antwort trägt Retry-After: 60. |
| 500 | backup.internal_error | unerwarteter Fehler |
{ "error": { "code": "backup.invalid_parameter", "parameter": "limit" } }
Abrufe im Protokoll
/sources und /jobs geben Namen, Adressen und Fehlertexte heraus. Jeder solche Abruf steht im Protokoll des gelesenen Mandanten unter 365 Backup, Protokoll, auch wenn ein Partnerzugang liest. Die Abrufe von /tenants und /tenants/{slug} stehen dort nicht.
Ein Werkzeug, das alle fünf Minuten fragt, soll das Protokoll nicht füllen. Deshalb gibt es höchstens einen Eintrag je Zugang, Mandant und Abruf in der Stunde. Weitere Abrufe in dieser Stunde bekommen keinen eigenen Eintrag. Der nächste Eintrag nennt in foldedReads, wie viele es waren.
| Feld | Inhalt |
|---|---|
| Aktion | backup.api.read |
| Handelnder | api: und der Anfang des Zugangs, wie ihn die Liste der Zugänge zeigt |
| Gegenstand | sources oder jobs |
route | noch einmal sources oder jobs, danach wählt das Protokoll seinen Satz |
key | Kennung des Zugangs |
keyAccount | Kennung des Kontos, dem der Zugang gehört, bei einem Partnerzugang also das Partnerkonto |
foldedReads | nur wenn größer als 0: Abrufe seit dem letzten Eintrag ohne eigenen Eintrag |
Ein gescheiterter Abruf gibt nichts heraus und steht nicht im Protokoll. Nach einem Neustart der Plattform, oder wenn mehrere Instanzen der Plattform antworten, kann ein Eintrag mehr dastehen, nie einer weniger.
Webhooks
Die Ereignisse
| Ereignis | Im Portal | Wann |
|---|---|---|
backup.alarm_raised | Sicherungsalarm | ein Sicherungsalarm an den Mandanten ist neu oder hat sich geändert |
backup.alarm_resolved | Sicherung läuft wieder | nach einem Alarm läuft die Sicherung wieder |
Ein Ereignis entsteht aus dem Anlass „Eine Sicherung ist gescheitert oder überfällig“ der Meldungen. Die Zusammenfassung des Tages, das Zurückholen, Ausgaben und Mitteilungen nur an Conbool lösen keines aus.
- Das Ereignis geht sofort hinaus, auch wenn der Mandant seine Meldungen gesammelt einmal am Tag bekommt.
- Hat der Mandant diesen Anlass in den Meldungen abgeschaltet, entsteht auch kein Ereignis.
Wer sie bekommt
- Ein Ziel im Mandanten bekommt die Alarme dieses Mandanten.
- Ein Ziel im Partnerkonto bekommt die Alarme aller Kundenmandanten und die des eigenen Kontos.
- Haben Mandant und Partner je ein Ziel, bekommen beide das Ereignis, jeder mit eigener
event_id. - Es zählen nur Ziele, die die Ereignisse von 365 Backup ausdrücklich gewählt haben. Ein Ziel mit „alle Ereignisse“ auf einer anderen Karte bekommt sie nicht.
Aufbau einer Zustellung
Eine Zustellung ist ein POST mit bis zu 100 Ereignissen in events, die ältesten zuerst. Die Nutzlast stammt aus dem Alarm; Inhalte von Mails oder Dateien stehen nicht darin.
{
"events": [
{
"event_id": "…",
"event_type": "backup.alarm_raised",
"event_version": "1.0",
"event_time": "2026-11-17T08:00:03.412+00:00",
"ingest_time": "2026-11-17T08:00:03.418+00:00",
"source_product": "backup",
"payload": {
"tenant": {
"id": "…",
"slug": "beispiel-gmbh",
"name": "Beispiel GmbH",
"reference": "K-1042"
},
"alarm": {
"severity": "breached",
"finding": null,
"title": "Keine gültige Sicherung",
"text": "Seit 30 Stunden keine Sicherung.",
"affected": ["anna@example.com", "Vertrieb (SharePoint)"],
"affected_total": 2,
"detected_at": "2026-11-17T08:00:03.120Z"
},
"portal_url": "https://conbool.com/home/beispiel-gmbh/backup"
}
}
]
}
| Feld | Bedeutung |
|---|---|
payload.tenant | der Mandant wie bei /tenants. reference nur in der Zustellung an den Partner. |
alarm.severity | die Stufe: breached (ohne gültige Sicherung), errorObjects (Objekte scheitern wiederholt), probe (eine Probe zum Zurückholen ist gescheitert, und jeder andere Alarm ohne eigene Stufe, etwa eine ausgesetzte automatische Aufnahme einer Gruppe), chain (Protokoll gebrochen). Bei backup.alarm_resolved zählt event_type, nicht die Stufe. |
alarm.finding | die Befundart, sonst null. Bei backup.alarm_resolved immer kunde:wieder-ok. |
alarm.title, alarm.text | Titel und Text des Alarms |
alarm.affected | bis zu 50 betroffene Einheiten. affected_total nennt die volle Zahl. Bei backup.alarm_resolved leer. |
alarm.detected_at | wann der Alarm bei der Plattform einging |
portal_url | die Übersicht von 365 Backup des Mandanten im Portal |
event_time | wann das Ereignis geschrieben wurde |
Ist im Konto des Ziels der Datenschutz-Modus Pseudonymisiert oder Entfernen gewählt (Reiter Datenschutz und Format, den es nur mit MailGuard oder SecureFiles gibt), stehen in title, text und affected statt Klartext Prüfsummen oder [REDACTED]. Für hinterlegte eigene Felder kommt payload.custom dazu.
| Kopf | Inhalt |
|---|---|
Content-Type | application/json |
User-Agent | Conbool-Webhook/1.0 (+https://conbool.com/docs/mailguard/siem-export) |
X-Conbool-Signature | sha256= und der HMAC-SHA256 über Zeitstempel, Punkt und Körper |
X-Conbool-Signature-Previous | nur in der Übergangszeit nach dem Erneuern des Signaturschlüssels: dieselbe Signatur mit dem alten Schlüssel |
X-Conbool-Timestamp | Zeitpunkt der Signatur in Sekunden seit 1970 |
X-Conbool-Delivery-Id | Kennung dieses Zustellversuchs, bei jedem Versuch neu |
X-Conbool-Event-Count | Zahl der Ereignisse in events |
Kennung und Doppelte
Erkennen Sie Doppelte an event_id, nicht an X-Conbool-Delivery-Id.
- Ein wiederholter Zustellversuch trägt dieselben Ereignisse mit denselben
event_id. - Meldet der Sicherungsdienst denselben Vorfall noch einmal, mit gleichem Titel, Text, Befund und gleichen Betroffenen am selben Tag (UTC), entsteht kein neues Ereignis. Es bleibt bei dem einen mit seiner
event_id. - Ändern sich Titel, Text, Befund oder die Betroffenen, ist das ein neues Ereignis mit neuer
event_id. - Hält ein Vorfall über Mitternacht (UTC) an und wird am neuen Tag wieder gemeldet, ist das ein neues Ereignis.
- Fällt die Sicherung nach einer Erholung wieder aus, ist das ein neues Ereignis mit neuer
event_id, auch am selben Tag und mit demselben Text. Das gilt auch für ein Ziel, das nur Sicherungsalarm gewählt hat. - Zwei Erholungen an einem Tag sind zwei Ereignisse.
Die Erholung verweist nicht auf das Ereignis ihres Alarms. Ordnen Sie beide über payload.tenant.id einander zu.
Signatur prüfen
- Den Körper so nehmen, wie er ankommt, ohne ihn neu zu formatieren.
X-Conbool-Timestamp, einen Punkt und den Körper aneinanderhängen.- Darüber HMAC-SHA256 mit dem Signaturschlüssel bilden, hexadezimal. Der Schlüssel zählt als Text, so wie er angezeigt wurde.
- Mit dem Wert hinter
sha256=inX-Conbool-Signaturevergleichen, in konstanter Zeit. - Zustellungen mit altem Zeitstempel verwerfen. Jeder Versuch wird neu signiert, ein Fenster von wenigen Minuten genügt.
import hashlib, hmac
def signatur_ok(schluessel: str, zeitstempel: str, koerper: bytes, kopf: str) -> bool:
erwartet = hmac.new(
schluessel.encode(), zeitstempel.encode() + b"." + koerper, hashlib.sha256
).hexdigest()
return hmac.compare_digest(kopf, "sha256=" + erwartet)
Signaturschlüssel erneuern bietet drei Wege: 7 Tage Übergang, 1 Tag Übergang oder sofort ersetzen. In der Übergangszeit signiert X-Conbool-Signature mit dem neuen Schlüssel und X-Conbool-Signature-Previous mit dem alten. Ein Empfänger, der noch den alten kennt, prüft diesen Kopf.
Zustellung und Wiederholung
- Zugestellt wird im Minutentakt, nur an
https-Adressen und nie an interne Adressen. Weiterleitungen werden nicht verfolgt. - Als zugestellt gilt eine Antwort mit Status 2xx innerhalb von zehn Sekunden. Alles andere ist ein Fehlschlag.
- Nach einem Fehlschlag folgt der nächste Versuch nach 1, 5, 30 und dann je 120 Minuten. Nach zehn Fehlschlägen in Folge ruht das Ziel, bis Sie im Menü des Ziels Aktivieren wählen. Jetzt erneut versuchen im Menü des Ziels wartet die Pause nicht ab: der nächste Versuch folgt beim nächsten Lauf.
- Was in der Zwischenzeit anfällt, kommt mit der nächsten gelungenen Zustellung nach, auch nach dem Wiederaktivieren. Ereignisse, die älter als 30 Tage sind, werden nicht mehr zugestellt, und keine, die das Konto nicht mehr aufbewahrt (einstellbar zwischen 7 und 365 Tagen).
- Ein neues Ziel bekommt zuerst die Ereignisse der letzten 30 Tage nach, die für das Konto schon vorliegen. Das sind die aus der Zeit, in der es dort bereits ein Ziel für 365 Backup gab.
Test im Menü des Ziels sendet {"ping": true, "at": "…"} mit X-Conbool-Event-Count: 0, X-Conbool-Timestamp und X-Conbool-Signature aus dem aktuellen Schlüssel. Anders als eine Zustellung trägt er kein X-Conbool-Signature-Previous, keine X-Conbool-Delivery-Id und keinen eigenen User-Agent. Beantworten Sie ihn mit 2xx.
Weiterführend
Welche Anlässe es gibt und wer sie per Mail bekommt, beschreibt Meldungen, Berichte und Nachweis. Die Verbindung zu Microsoft 365 und ihre Berechtigungen erklärt Einrichtung. Zurück zur Übersicht von 365 Backup.