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 ausLiestAnlegen darf
einem Mandantennur diesen Mandantenwer 365 Backup einrichten und API-Zugänge verwalten darf
einem Partnerkontodas eigene Konto und alle Kundenmandanten des Partnerkontosnur 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:read und ö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

Adressehttps://conbool.com/api/v1/backup, bei einer eigenen Installation deren Adresse (Adresse kopieren)
AnmeldungKopf Authorization: Bearer <Zugang>, der Zugang beginnt mit csk_live_
Berechtigungsumfangbackup:read
Grenze60 Abrufe je Zugang und Minute, gemeinsam für alle Abrufe dieses Zugangs unter /api/v1
Sperrenach 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

AbrufLiefert
GET /api/v1/backup/tenantsdie 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}/sourcesalle Einheiten des Mandanten mit Zustand und letzter Sicherung
GET /api/v1/backup/tenants/{slug}/jobslaufende 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

ParameterBedeutung
limitEinträge je Seite, 1 bis 200, Vorgabe 50. Größere Werte gelten als 200.
cursorder 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": []
}
FeldBedeutung
statusnot_configured, breached, at_risk, pending oder healthy, Regel siehe unten
countsEinheiten, 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_typeje Bereich (type) alle Einheiten (total) und davon gesicherte (protected)
by_protectionalle Einheiten je Wert von protection, auch die, die nicht gesichert werden
storage_bytesbelegter Speicher in Byte, null wenn nicht lesbar
connectionsje 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.sources ist 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 in counts.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.

FeldBedeutung
typeder Bereich: mailbox, archive, groupMailbox, drive, list, teams, planner, chat oder directory
nameAnzeigename, sonst die Adresse
addressAnmeldeadresse oder Adresse des Objekts, sonst null
urlWebadresse bei Microsoft, soweit bekannt
activetrue, wenn die Einheit gesichert wird
statehealthy, 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.
protectionob gesichert wird, Werte siehe unten
paused_reasonder benannte Grund, wenn nicht gesichert wird, mit denselben Werten wie protection, sonst null
last_success_at, last_attempt_atletzte erfolgreiche Sicherung und letzter Versuch, unabhängig vom Erfolg
rpo_hoursdas Sicherungsziel in Stunden, an dem der Zustand gemessen wird
m365_tenant_idKennung des Microsoft-Mandanten

Die Werte von protection und paused_reason:

WertBedeutung
protectedwird gesichert
pausednicht in der Sicherung, ohne vermerkten Grund
paused_manuallyvon Hand abgeschaltet
erasednach Artikel 17 DSGVO gelöscht
created_by_restorebeim Zurückholen entstanden
removed_at_microsoftbei Microsoft nicht mehr vorhanden
not_licensedüber der Sitzzahl, nicht lizenziert
excluded_by_ruledurch eine Ausschlussregel ausgenommen
room_or_equipmentRaum- oder Gerätepostfach, nicht ausgewählt
not_selectednoch nicht ausgewählt
exemptedvom Kunden ausgenommen, kostet keinen Sitz
organization_pauseddie ganze Organisation ist angehalten, der Bestand bleibt bis zum Löschtermin
otherein 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 mit limit und cursor wie bei den Mandanten. Ältere liefert die Schnittstelle nicht, auch nicht über cursor: geblättert wird nur innerhalb dieser 50, mit limit=50 kommt also kein next_cursor. Der Zeiger hängt an Beginn und Kennung des letzten Auftrags der Seite.
  • source_id verweist auf id in /sources und kann null sein.
  • kind: initial (Erstsicherung), delta (Folgesicherung), restore (Zurückholen), verify (Prüfung). Ausgaben stehen nicht in dieser Liste.
  • status: running, succeeded, failed oder aborted.
  • items und bytes: was der Lauf gespeichert hat.
  • error: nur bei failed und aborted gesetzt, sonst null. Ein Objekt aus code, message und detail.
  • note: der Vermerk eines gelungenen oder laufenden Auftrags in derselben Form, etwa übersprungene Kanäle; sonst null. Ein Auftrag mit note ist 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.

codeBedeutung
source_emptyder Bereich enthält nichts zu sichern. Der Lauf hat nichts gespeichert und gilt trotzdem als erfolgreich.
empty_snapshot_discardedMicrosoft lieferte einen leeren Abzug. Er wurde nicht als Sicherung übernommen.
nothing_readder Lauf hat weder Elemente gelesen noch gespeichert
service_restartedein Neustart des Dienstes hat den Lauf unterbrochen. Was bis dahin gespeichert war, bleibt; der nächste Takt macht weiter.
token_unavailableMicrosoft hat keinen Zugangsschlüssel ausgestellt. Die App fehlt in der Microsoft-Organisation, oder ihre Zustimmung wurde zurückgezogen.
malware_blockedMicrosoft hat Elemente gesperrt, die es als Schadsoftware einstuft
items_failedeinzelne Elemente ließen sich nicht sichern
channels_skippedprivate oder geteilte Kanäle wurden übersprungen, weil sie eigene Berechtigungen haben
nothing_to_restorefür diesen Bereich gab es zum gewählten Zeitpunkt nichts Gesichertes
already_presentbeim Zurückholen lagen einzelne Elemente schon im ursprünglichen Ordner und wurden nicht doppelt angelegt
restored_as_draftSeiten wurden als Entwurf zurückgeholt. Prüfen und veröffentlichen Sie sie in SharePoint.
microsoft_errorMicrosoft Graph hat einen Fehler gemeldet
otherein 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": "…" } }.

Statuserror.codeBedeutung
400backup.invalid_parameterlimit oder cursor ungültig. cursor gilt nur unverändert aus next_cursor derselben Liste. parameter nennt den Parameter.
401unter 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_mismatchZugang 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
403siem.scope_missingdem Zugang fehlt backup:read
404backup.tenant_not_foundMandant unbekannt, für diesen Zugang nicht erreichbar oder ohne 365 Backup
429siem.rate_limitedzu viele Abrufe oder zu viele gescheiterte Anmeldungen. Die Antwort trägt Retry-After: 60.
500backup.internal_errorunerwarteter 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.

FeldInhalt
Aktionbackup.api.read
Handelnderapi: und der Anfang des Zugangs, wie ihn die Liste der Zugänge zeigt
Gegenstandsources oder jobs
routenoch einmal sources oder jobs, danach wählt das Protokoll seinen Satz
keyKennung des Zugangs
keyAccountKennung des Kontos, dem der Zugang gehört, bei einem Partnerzugang also das Partnerkonto
foldedReadsnur 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

EreignisIm PortalWann
backup.alarm_raisedSicherungsalarmein Sicherungsalarm an den Mandanten ist neu oder hat sich geändert
backup.alarm_resolvedSicherung läuft wiedernach 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"
      }
    }
  ]
}
FeldBedeutung
payload.tenantder Mandant wie bei /tenants. reference nur in der Zustellung an den Partner.
alarm.severitydie 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.findingdie Befundart, sonst null. Bei backup.alarm_resolved immer kunde:wieder-ok.
alarm.title, alarm.textTitel und Text des Alarms
alarm.affectedbis zu 50 betroffene Einheiten. affected_total nennt die volle Zahl. Bei backup.alarm_resolved leer.
alarm.detected_atwann der Alarm bei der Plattform einging
portal_urldie Übersicht von 365 Backup des Mandanten im Portal
event_timewann 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.

KopfInhalt
Content-Typeapplication/json
User-AgentConbool-Webhook/1.0 (+https://conbool.com/docs/mailguard/siem-export)
X-Conbool-Signaturesha256= und der HMAC-SHA256 über Zeitstempel, Punkt und Körper
X-Conbool-Signature-Previousnur in der Übergangszeit nach dem Erneuern des Signaturschlüssels: dieselbe Signatur mit dem alten Schlüssel
X-Conbool-TimestampZeitpunkt der Signatur in Sekunden seit 1970
X-Conbool-Delivery-IdKennung dieses Zustellversuchs, bei jedem Versuch neu
X-Conbool-Event-CountZahl 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

  1. Den Körper so nehmen, wie er ankommt, ohne ihn neu zu formatieren.
  2. X-Conbool-Timestamp, einen Punkt und den Körper aneinanderhängen.
  3. Darüber HMAC-SHA256 mit dem Signaturschlüssel bilden, hexadezimal. Der Schlüssel zählt als Text, so wie er angezeigt wurde.
  4. Mit dem Wert hinter sha256= in X-Conbool-Signature vergleichen, in konstanter Zeit.
  5. 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.