# Invio di email con OAuth 2.0 in QlikView

QlikView può inviare e-mail tramite Microsoft Graph utilizzando OAuth 2.0 con Microsoft 365. OAuth 2.0 è un metodo di connessione di posta aggiuntivo; la configurazione SMTP esistente rimane disponibile.

Quando è selezionato OAuth 2.0, QlikView non si connette direttamente a un server SMTP. Ottiene un token di accesso da `login.microsoftonline.com` e invia email tramite l'API REST di Microsoft Graph all'indirizzo `graph.microsoft.com/v1.0/users/{sender}/sendMail`.

## Prerequisiti

Prima di configurare QlikView, registrare un'applicazione in Microsoft Entra ID:

1. Accedi al portale di Azure e passa a Microsoft Entra ID > Registrazioni app > Nuova registrazione.
2. Registrare l'applicazione.
3. In Certificati e segreti, creare un segreto client e copiarne il valore. Il valore viene visualizzato una sola volta.
4. In Autorizzazioni API, aggiungi l'autorizzazione dell'applicazione Microsoft Graph Mail.Send.
5. Concedi il consenso amministratore per l'autorizzazione.
6. Prendere nota dell'ID applicazione (client) e dell'ID directory (tenant).

L'applicazione deve disporre dell'autorizzazione Mail.Send per la cassetta postale utilizzata come mittente.

## Sicurezza

QlikView crittografa l'ID del tenant, l'ID del client e il segreto del client prima di memorizzarli. Le credenziali non vengono memorizzate in chiaro.

## Test dell'e-mail OAuth 2.0

Utilizza il controllo test-mail nella pagina di configurazione:

* In QlikView Desktop, fare clic su Test nella pagina Preferenze utente > Posta.
* Nella Console di gestione QlikView, immettere un indirizzo in Invia e-mail di prova a e fare clic su Invia.

QlikView ottiene un token OAuth 2.0 e invia l'e-mail di test tramite Microsoft Graph. Se un passaggio non riesce, esaminare il messaggio di errore.

## File allegati

Quando QlikView invia un'e-mail con allegati, include gli allegati inline nella richiesta Microsoft Graph come contenuto codificato in Base64. Ciascun allegato è limitato a 3 MB. Per i file di dimensioni maggiori, utilizzare un altro metodo di recapito.

## Risoluzione dei problemi

| Errore | Causa | Risoluzione |
| --- | --- | --- |
| `OAuth 2.0 Client ID, Tenant ID, and Client Secret are required.` | Uno o più campi OAuth sono vuoti. | Verificare che tutti e tre i campi siano compilati nella pagina delle impostazioni di posta. |
| `OAuth token request failed: AADSTS7000215` | Il segreto client non è valido. | Generare un nuovo segreto client in Microsoft Entra ID e aggiornare QlikView. |
| `OAuth token request failed: AADSTS700016` | L'ID applicazione (client) non è corretto o l'applicazione non esiste nel tenant specificato. | Verificare l'ID applicazione (client) e l'ID directory (tenant). |
| `Graph sendMail failed: ErrorAccessDenied` | L'applicazione non dispone dell'autorizzazione `Mail.Send` o non è stato concesso il consenso dell'amministratore. | Aggiungere l'autorizzazione dell'applicazione `Mail.Send` e concedere il consenso dell'amministratore in Microsoft Entra ID. |
| `Graph sendMail failed: ErrorItemNotFound` | L'indirizzo del mittente non corrisponde a una cassetta postale valida nel tenant. | Assicurarsi che l'indirizzo del mittente corrisponda a una cassetta postale Microsoft 365 esistente. |
| `Attachment too large` | Un file allegato supera il limite inline di 3 MB. | Riduci le dimensioni del file o usa un altro metodo di recapito. |