Konfigurieren Sie den E-Mail-Server mithilfe einer API

Diese Art der E-Mail-Serververbindung wird mit Hilfe der API Ihres E-Mail-Anbieters authentifiziert.

Voraussetzungen

Um den E-Mail-Server mithilfe einer API zu konfigurieren, wählen Sie einen der folgenden als Ihren E-Mail-Anbieter aus:

• Microsoft Azure
• Google

E-Mail-Server-Konfiguration über eine API mit Microsoft Azure als Ihrem E-Mail-Anbieter

Wenn Sie Microsoft Azure als Ihren E-Mail-Anbieter verwenden, finden Sie die Azure-Mandanten-ID, die Client-ID und das Client-Geheimnis, indem Sie die folgenden Schritte ausführen:

1. Gehen Sie zum Azure Portal und melden Sie sich mit Ihrem Microsoft-Konto an.
2. Wählen Sie Azure Active Directory im Abschnitt Azure-Dienste aus.
3. Gehen Sie zu Verwalten > App-Registrierungen > + Neue Registrierung, um das Fenster Eine Anwendung registrieren zu öffnen.
4. Geben Sie den Anwendungsnamen ein (z. B. ADAudit Plus-Anwendung) und wählen Sie die standardmäßigen Unterstützten Kontotypen aus.
5. Im linken Bereich gehen Sie zu Verwalten > API-Berechtigungen > + Berechtigung hinzufügen.
6. Wählen Sie Microsoft Graph aus. Klicken Sie auf Anwendungsberechtigungen als Art der erforderlichen Berechtigung.
7. Wählen Sie aus der Liste Mail > Mail.Send aus. Klicken Sie auf Berechtigungen hinzufügen.
8. Wählen Sie Admin-Zustimmung für <tenantname> gewähren.
9. Finden und kopieren Sie die angezeigten Werte der Client-ID und der Mandanten-ID.
10. Im linken Bereich gehen Sie zu Verwalten > Zertifikate & Geheimnisse.
11. Klicken Sie auf + Neues Client-Geheimnis.

    Geben Sie eine geeignete Beschreibung ein. Wählen Sie 24 Monate als Ablaufdatum; dies ist der maximal verwendbare Wert.

12. Klicken Sie auf Hinzufügen.
13. Finden und kopieren Sie den Wert des Client-Geheimnisses (z. B. "14uClLxkHtIVGR3wkCq12341Nd5VtestkkWTyIPrrE=").

E-Mail-Server-Konfiguration über eine API mit Google als Ihrem E-Mail-Anbieter

Wenn Sie Google als Ihren E-Mail-Anbieter verwenden, führen Sie bitte Folgendes aus:

• Finden Sie den JSON-Privatschlüssel
• Aktivieren Sie den API-Dienst von Gmail
• Gewähren Sie der Dienstkontoberechtigung auf Domainebene

Schritte zum Finden des JSON-Privatschlüssels

1. Gehen Sie zu https://console.developers.google.com/ und melden Sie sich bei Ihrem Google-Konto an.
2. Navigieren Sie zur Seite Dienstkonten.
3. Klicken Sie auf das Dropdown-Menü Projekt auswählen und klicken Sie auf NEUES PROJEKT.
4. Klicken Sie auf + DIENSTKONTO ERSTELLEN. Geben Sie im Fenster Details zum Dienstkonto den Dienstkontonamen, die Dienstkonto-ID und die Beschreibung des Dienstkontos an. Klicken Sie auf ERSTELLEN UND FORTFAHREN.
5. Klicken Sie auf Diesen Dienstkonto Zugriff auf das Projekt gewähren, um die für das Dienstkonto erforderlichen IAM-Rollen auszuwählen.
6. Klicken Sie auf FORTFAHREN.
7. Fügen Sie die Benutzer und Gruppen hinzu, denen Sie den Zugriff auf das Dienstkonto und die Verwaltung des Dienstkontos erlauben möchten.
8. Klicken Sie auf FERTIG.
9. Wählen Sie die E-Mail-Adresse des erstellten Dienstkontos aus.
10. Im Abschnitt Schlüssel wählen Sie Neuen Schlüssel erstellen aus dem Dropdown-Menü SCHLÜSSEL HINZUFÜGEN.
11. Wählen Sie JSON als Schlüsseltyp aus.
12. Klicken Sie auf ERSTELLEN.
13. Der JSON-Privatschlüssel wird generiert und auf Ihr lokales System heruntergeladen. Bei jeder Generierung wird ein neuer privater Schlüssel erstellt, sodass es wichtig ist, den Schlüssel sicher aufzubewahren.

Schritte zur Aktivierung des Gmail-API-Dienstes

1. Loggen Sie sich bei https://console.cloud.google.com/ ein.
2. Gehen Sie zu Projekte. Klicken Sie auf + APIs UND DIENSTE AKTIVIEREN.
3. Wählen Sie Gmail API und klicken Sie auf AKTIVIEREN.

Schritte zur Bereitstellung von domänenweiter Berechtigung für das Dienstkonto

1. Loggen Sie sich als Superadministrator in die Google Workspace Admin-Konsole ein.
2. Gehen Sie zu Sicherheit > Zugriffs- und Datenkontrolle > API-Kontrollen.
3. Wählen Sie im Bereich Domänenweite Delegierung DOMÄNENWEITE DELEGIERUNG VERWALTEN.
4. Klicken Sie auf Neu hinzufügen.
5. Geben Sie die Client-ID Ihres Dienstkontos von dieser Seite ein.
6. Im Feld OAuth-Bereiche (kommagetrennt) wählen Sie die Bereiche aus, auf die Ihre Anwendung Zugriff benötigt. Wenn sie domänenweiten Zugriff auf die Gmail API benötigt, geben Sie https://mail.google.com ein.
7. Klicken Sie auf AUTORISIEREN.

Die Anwendung hat jetzt die Berechtigung, API-Aufrufe als Benutzer innerhalb Ihrer Domain zu tätigen.

Richten Sie einen E-Mail-Server über eine API ein

• Öffnen Sie die ADAudit Plus-Webkonsole.
• Navigieren Sie zu Admin > Allgemeine Einstellungen > Servereinstellungen.
• Wählen Sie Mail.
• Wählen Sie den API-Modus.
• Wählen Sie Ihren E-Mail-Anbieter, Microsoft oder Google, aus dem Dropdown-Menü.
• Geben Sie im Feld Von-Adresse die E-Mail-Adresse an, von der die Benachrichtigungs-E-Mails gesendet werden sollen.
• Geben Sie im Feld E-Mail-ID für Benachrichtigungen die E-Mail-Adresse an, an die die Benachrichtigungs-E-Mails gesendet werden sollen.
• Wenn Ihr E-Mail-Anbieter Microsoft ist, geben Sie die Mieter-ID, Client-ID und Client-Geheimnis in die entsprechenden Felder ein. Wenn Ihr E-Mail-Anbieter Google ist, laden Sie den JSON-Privatschlüssel hoch.
• Aktivieren Sie E-Mails im HTML-Format senden, wenn Sie E-Mails im HTML-Format benötigen.
• Klicken Sie auf Einstellungen speichern.