Authentifizierung und Berechtigungen
Gib jeder Integration genau den Konto- und Postfachzugriff, den sie benötigt.
API-Zugangsdaten
Erstelle in Integrationen einen REST-Schlüssel, der an dein Konto gebunden ist. Sende ihn bei jeder Anfrage im Header Authorization.
Authorization: Bearer your-cm_rest_-credentialGeheimnisse werden nur einmal angezeigt und als Hashes gespeichert. Bewahre die Schlüssel auf deinem Server auf. Verwende separate Zugangsdaten für verschiedene Anwendungen, damit du jede Integration unabhängig davon rotieren oder widerrufen kannst.
Berechtigungen unabhängig voneinander auswählen
| Berechtigung | Ermöglicht |
|---|---|
read | Konto- und Ressourcenmetadaten; E-Mail-Lesezugriff für freigegebene E-Mail-Postfächer. |
write | Änderungen an Ressourcen, Entwürfe, Ordner, Markierungen und Nachrichtenorganisation. |
send | E-Mail-Versand, Antworten und Weiterleitung. |
delete | Ressourcen und Nachrichten löschen, vorbehaltlich der Schutzmaßnahmen beim Löschen. |
webhook | Webhook-Abonnement- und Zustellungsverwaltung für Kontoinhaber und Administratoren. |
Berechtigungen sind unabhängig voneinander. write zu haben, bedeutet nicht, dass du auch send oder delete hast. Änderungen an den Kontressourcen erfordern die Rolle „Eigentümer“ oder „Admin“.
Zugriff auf das E-Mail-Postfach autorisieren
Die Mitgliedschaft in einem Konto gewährt allein niemals Zugriff auf E-Mail-Inhalte. Für den Zugriff auf ein E-Mail-Postfach sind sowohl eine aktuelle Berechtigung als auch die Auswahl dieses Postfachs für die Zugangsdaten erforderlich.
- Weise den Zugriff mit einem einmalig verwendbaren Bestätigungscode nach, der an das E-Mail-Postfach gesendet wird, oder lass dir vom Kontoinhaber ausdrücklich Zugriff gewähren.
- Wähle dieses E-Mail-Postfach aus, wenn du die Zugangsdaten erstellst.
- Wähle die Berechtigungen aus, die die Integration für dieses E-Mail-Postfach benötigt.
Ablauf, Rotation und Widerruf
Lege beim Ausstellen eines Zugangsmittels ein Ablaufdatum fest. Rotiere die Schlüssel in Integrations und aktualisiere das Geheimnis in deiner Anwendung. Der Widerruf eines Zugangsmittels wird bei nachfolgenden Anfragen sofort wirksam.
Wenn du eine Mitgliedschaft entfernst oder die Freigabe für ein E-Mail-Postfach widerrufst, wird der davon abhängige Zugriff ungültig, einschließlich der Webhook-Zustellungen. MCP verwendet OAuth-Tokens oder einen zweckgebundenen MCP-Schlüssel; mit einem MCP-Zugangsschlüssel kann die Genehmigung nicht über die REST-API umgangen werden.