# Senden von E-Mails mit OAuth 2.0 in QlikView

QlikView kann E-Mails über Microsoft Graph unter Verwendung von OAuth 2.0 mit Microsoft 365 senden. OAuth 2.0 ist eine zusätzliche E-Mail-Verbindungsmethode; die bestehende SMTP-Konfiguration bleibt weiterhin verfügbar.

Wenn OAuth 2.0 ausgewählt ist, stellt QlikView keine direkte Verbindung zu einem SMTP-Server her. Es ruft ein Zugriffstoken von `login.microsoftonline.com` ab und sendet E-Mails über die Microsoft Graph REST API unter `graph.microsoft.com/v1.0/users/{sender}/sendMail`.

## Voraussetzungen

Bevor Sie QlikView konfigurieren, registrieren Sie eine Anwendung in Microsoft Entra ID:

1. Melden Sie sich beim Azure-Portal an und navigieren Sie zu Microsoft Entra ID > App-Registrierungen > Neue Registrierung.
2. Registrieren Sie die Anwendung.
3. Erstellen Sie unter Zertifikate & Geheimnisse ein Clientgeheimnis und kopieren Sie dessen Wert. Der Wert wird nur einmal angezeigt.
4. Fügen Sie unter API-Berechtigungen die Microsoft Graph-Anwendungsberechtigung Mail.Send hinzu.
5. Erteilen Sie die Administratorzustimmung für die Berechtigung.
6. Notieren Sie die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant).

Die Anwendung muss über die Berechtigung Mail.Send für das als Absender verwendete Postfach verfügen.

## Datensicherheit

QlikView verschlüsselt die Mandanten-ID, die Client-ID und den geheimen Client-Schlüssel, bevor sie gespeichert werden. Die Anmeldedaten werden nicht im Klartext gespeichert.

## OAuth 2.0-E-Mail testen

Verwenden Sie das Test-E-Mail-Steuerelement auf der Konfigurationsseite:

* Klicken Sie in QlikView Desktop auf der Seite Benutzereinstellungen > Mail auf Test.
* Geben Sie in der QlikView-Verwaltungskonsole eine Adresse in Test-E-Mail senden an ein und klicken Sie auf Senden.

QlikView ruft ein OAuth 2.0-Token ab und sendet die Test-E-Mail über Microsoft Graph. Wenn ein Schritt fehlschlägt, überprüfen Sie die Fehlermeldung.

## Dateianhänge

Wenn QlikView E-Mails mit Anhängen sendet, fügt es die Anhänge Inline als Base64-codierten Inhalt in die Microsoft Graph-Anforderung ein. Jeder Anhang ist auf 3 MB begrenzt. Verwenden Sie für größere Dateien eine andere Übermittlungsmethode.

## Fehlerbehebung

| Fehler | Ursache | Behebung |
| --- | --- | --- |
| `OAuth 2.0 Client ID, Tenant ID, and Client Secret are required.` | Ein oder mehrere OAuth-Felder sind leer. | Überprüfen Sie, ob alle drei Felder auf der Seite für E-Mail-Einstellungen ausgefüllt sind. |
| `OAuth token request failed: AADSTS7000215` | Das Client-Secret ist ungültig. | Generieren Sie ein neues Clientgeheimnis in Microsoft Entra ID und aktualisieren Sie QlikView. |
| `OAuth token request failed: AADSTS700016` | Die Anwendungs-ID (Client) ist falsch oder die Anwendung ist im angegebenen Mandanten nicht vorhanden. | Überprüfen Sie die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant). |
| `Graph sendMail failed: ErrorAccessDenied` | Die Anwendung verfügt nicht über die Berechtigung `Mail.Send`, oder die Administratorzustimmung wurde nicht erteilt. | Fügen Sie die Anwendungsberechtigung `Mail.Send` hinzu und gewähren Sie die Administratorzustimmung in Microsoft Entra ID. |
| `Graph sendMail failed: ErrorItemNotFound` | Die Absenderadresse entspricht keinem gültigen Postfach im Mandanten. | Stellen Sie sicher, dass die Absenderadresse mit einem vorhandenen Microsoft 365-Postfach übereinstimmt. |
| `Attachment too large` | Ein Dateianhang überschreitet das Inline-Limit von 3 MB. | Reduzieren Sie die Dateigröße oder verwenden Sie eine andere Übermittlungsmethode. |