API-Schlüssel und SMTP-Zugänge
Ihre Anwendung authentifiziert sich mit einem Zugang. Es gibt zwei Arten:
| Art | Wofür | Rechte |
|---|---|---|
| API-Schlüssel | https://api.weneed.email |
Nur Senden oder Senden, E-Mail-Metadaten lesen und Verbrauch lesen |
| SMTP-Zugang | smtp.weneed.email |
Nur Senden. Ein Benutzername, der mit smtp_ beginnt, und ein Passwort |
Ein Zugang lässt Ihre Anwendung verbinden. Zum Senden allein reicht er nicht: Nachrichten brauchen weiterhin die Versandberechtigung des Projekts. Siehe So wird der Versand aktiviert.
Einen Zugang anlegen
Abschnitt betitelt „Einen Zugang anlegen“Öffnen Sie Ihr Projekt, dann API keys & SMTP, dann Create API key oder Create SMTP login. Dafür brauchen Sie zuerst eine verifizierte Domain.
Geben Sie Ihre genaue Absenderadresse ein. Bei nur einer Domain und einem Stream wählt Control beide automatisch aus. Ein Label ist vorausgefüllt; Sie können es ändern. Unter Advanced settings finden Sie die optionale Gültigkeit (standardmäßig ohne Ablaufdatum; 7, 30 oder 90 Tage für vorübergehenden Zugriff) und bei API-Schlüsseln die Rechte: nur Senden oder zusätzlich Status und Verbrauch lesen.
Das Anlegen verlangt Ihren Authenticator-Code. Das Geheimnis wird einmal angezeigt. Kopieren Sie es sofort in Ihren Secret-Manager, bevor Sie die Seite verlassen; ein Neuladen oder spätere Abfragen zeigen nur die Angaben zum Zugang, nie das Geheimnis.
Geht die Antwort beim Anlegen verloren, nutzen Sie Check request result, statt das Formular erneut abzuschicken. So entstehen keine zwei Zugänge.
Grenzen
Abschnitt betitelt „Grenzen“- Jeder Zugang sendet von genau einer Adresse. Platzhalter-Absender gibt es nicht.
- Eine Organisation kann bis zu 20 aktive Zugänge haben, API und SMTP zusammen.
- Schlüssel und Passwörter haben standardmäßig kein Ablaufdatum. Ersetzen oder widerrufen Sie sie bei Bedarf. Wenn Sie eine begrenzte Gültigkeit wählen, ersetzen Sie den Zugang vor diesem Datum.
Einen Zugang ersetzen
Abschnitt betitelt „Einen Zugang ersetzen“Für die Rotation oder bevor ein alter Zugang abläuft.
- Wählen Sie auf der Zugangskarte Replace API key oder Replace SMTP login. Das Formular ist mit den Werten des alten Zugangs vorausgefüllt.
- Legen Sie den Ersatz an und speichern Sie sein Geheimnis.
- Stellen Sie Ihre Anwendung um und prüfen Sie, ob Nachrichten angenommen werden.
- Widerrufen Sie den alten Zugang.
Bis Sie den alten widerrufen, funktionieren beide und beide zählen zur Grenze von 20. Sind Sie an der Grenze, widerrufen Sie zuerst einen ungenutzten Zugang. Nachrichten, die mit dem alten Zugang angenommen wurden, bleiben bei ihm; der Ersatz übernimmt sie nicht.
Einen Zugang widerrufen
Abschnitt betitelt „Einen Zugang widerrufen“Wählen Sie Remove API key oder Remove SMTP login, tippen Sie REVOKE und bestätigen Sie. Danach gilt:
- neue Anfragen mit diesem Zugang werden abgelehnt;
- eine bereits angemeldete SMTP-Verbindung wird bei ihrer nächsten Nachricht abgelehnt;
- noch nicht gesendete Nachrichten dieses Zugangs werden zur Prüfung zurückgehalten.
Ein Widerruf ist kein Rückruf. Eine Nachricht, die gerade zugestellt wird, kann noch ankommen.
Gerät ein Geheimnis nach außen, widerrufen Sie es sofort und legen Sie dann einen Ersatz an.
Nach dem Erstellen
Abschnitt betitelt „Nach dem Erstellen“Der einmalige Schlüssel bzw. das Passwort steht oben auf der Ergebnisseite. Speichern Sie ihn, dann wählen Sie Continue to first email. Wenn Sie beide Versandmethoden gewählt haben, führt Control Sie zuerst zum zweiten Zugang. Kennungen und Verwaltungsaktionen finden Sie unter Credential details and management.