Mit den Berechtigungen für API-Schlüssel kannst du genau festlegen, was jeder API-Schlüssel in deinem Brevo-Konto tun darf. Wenn du einer Integration nur die Zugriffsrechte gibst, die sie braucht, kann ein kompromittierter oder gemeinsam genutzter Schlüssel nicht für andere Zwecke verwendet werden.
Gut zu wissen
- Schlüssel, die erstellt wurden, bevor Berechtigungen verfügbar waren, behalten den vollständigen Zugriff, bis du sie bearbeitest.
- Die Berechtigungen gelten nur für API-Schlüssel. SMTP-Schlüssel sind davon nicht betroffen. Weitere Informationen findest du in unserem speziellen Artikel SMTP-Schlüssel erstellen und verwalten.
Zugriffstypen
Wenn du einen API-Schlüssel erstellst oder bearbeitest, wählst du zunächst aus, auf welche Bereiche deines Kontos der Schlüssel Zugriff haben soll:
- [Empfohlen] Restricted (Eingeschränkt): du wählst genau aus, worauf der Schlüssel zugreifen kann. Jede Ressource beginnt mit None (Keine), daher wählst du nur eine Berechtigung für die Ressourcen aus, die der Schlüssel benötigt.
- Full (Vollständig): Der Schlüssel kann auf alle aktuellen und zukünftigen Ressourcen zugreifen.
Berechtigungsstufen
Für jede Ressource mit dem Schlüssel Restricted (Eingeschränkt) wählst du eine von vier Berechtigungen aus. Die folgende Tabelle zeigt, was die einzelnen Stufen ermöglichen:
| Stufe | Funktionen des Schlüssels | API-Anfragen sind erlaubt |
|---|---|---|
| None (Keine) | Hat keinen Zugriff auf die Ressource. | None (Keine) |
| Read (Anzeigen) | Kann die Ressource anzeigen, aber nicht ändern. | GET |
| Read/write (Lesen/Schreiben) | Kann die Ressource anzeigen, erstellen und aktualisieren, aber nicht löschen. | GET, POST und PUT |
| All (Alle) | Hat vollen Zugriff auf die Ressource, einschließlich des Löschens. | Alle Anfragetypen |
Verfügbare Ressourcen
Du kannst Berechtigungen für 18 Ressourcen festlegen. Nicht jede Ressource bietet alle Stufen an. Die folgende Tabelle zeigt die für jede Ressource verfügbaren Stufen:
| Ressource | Verfügbare Stufen |
|---|---|
| Transaktions-E-Mail | Keine, Lesen und Alle |
| Transaktions-SMS | Keine, Lesen, Lesen/Schreiben und Alle |
| Transaktions-WhatsApp | Keine, Lesen, Lesen/Schreiben und Alle |
| E-Mail-Kampagnen | Keine, Lesen und Alle |
| SMS-Kampagnen | Keine, Lesen und Alle |
| WhatsApp-Kampagnen | Keine, Lesen und Alle |
| Kontakte | Keine, Lesen und Alle |
| Deals | Keine, Lesen und Alle |
| Unterhaltungen | Keine, Lesen, Lesen/Schreiben und Alle |
| E-Commerce | Keine, Lesen, Lesen/Schreiben und Alle |
| Treue | Keine, Lesen, Lesen/Schreiben und Alle |
| Ereignisse | Keine, Lesen, Lesen/Schreiben und Alle |
| Objekte | Keine, Lesen und Alle |
| Konto | Keine, Lesen, Lesen/Schreiben und Alle |
| Webhooks | Keine, Lesen, Lesen/Schreiben und Alle |
| Organisation | Keine, Lesen und Alle |
| Wallet | Keine, Lesen, Lesen/Schreiben und Alle |
| Brevo-Funktionen | Keine, Lesen, Lesen/Schreiben und Alle |
Berechtigungen für einen API-Schlüssel festlegen
Weitere Informationen dazu, wie du Berechtigungen für einen neuen Schlüssel festlegst oder die Berechtigungen eines bestehenden Schlüssels bearbeitest, findest du in unserem entsprechenden Artikel API-Schlüssel erstellen und verwalten.
Was passiert, wenn ein Schlüssel keine Berechtigung hat?
Wenn eine Integration einen Aufruf ausführt, den ihr Schlüssel nicht zulässt, blockiert Brevo den Aufruf und zeigt den Fehler Access denied for resource (Zugriff auf Ressource verweigert) an. Weitere Informationen zur Behebung dieses Problems findest du in unserem entsprechenden Artikel Fehlerbehebung – Probleme mit API-Schlüsseln.
⏭️ Nächste Schritte
- Einen API-Schlüssel erstellen oder löschen
- Fehlerbehebung – Probleme mit API-Schlüsseln
- IP-Adressen für die API- und SMTP-Sicherheit autorisieren und sperren
🤔 Sie haben eine Frage?
Wenden Sie sich bei Fragen an unser Support-Team: Erstellen Sie einfach ein Ticket über Ihr Konto. Wenn Sie noch kein Konto haben, können Sie uns hier kontaktieren.
Wenn Sie Unterstützung bei einem Projekt mit Brevo suchen, können wir Sie mit der richtigen zertifizierten Brevo-Partneragentur verbinden.