Wysyłanie wiadomości e-mail za pomocą OAuth 2.0 w QlikView
Ostatnia aktualizacja: 7.10.2026QlikView może wysyłać wiadomości e-mail za pośrednictwem Microsoft Graph przy użyciu protokołu OAuth 2.0 z usługą Microsoft 365. OAuth 2.0 to dodatkowa metoda połączenia z pocztą; istniejąca konfiguracja SMTP pozostaje dostępna.
Gdy wybrano OAuth 2.0, QlikView nie łączy się bezpośrednio z serwerem SMTP. Uzyskuje token dostępu z login.microsoftonline.com i wysyła wiadomości e-mail za pośrednictwem interfejsu API REST Microsoft Graph pod adresem graph.microsoft.com/v1.0/users/{sender}/sendMail.
Wymagania wstępne
Przed skonfigurowaniem QlikView zarejestruj aplikację w Microsoft Entra ID:
- Zaloguj się do witryny Azure Portal i przejdź do Microsoft Entra ID > Rejestracje aplikacji > Nowa rejestracja.
- Zarejestruj aplikację.
- W sekcji Certyfikaty i wpisy tajne utwórz klucz tajny klienta i skopiuj jego wartość. Wartość jest wyświetlana tylko raz.
- W sekcji Uprawnienia API dodaj uprawnienie aplikacji Microsoft Graph Mail.Send.
- Udziel zgody administratora na uprawnienie.
- Zanotuj identyfikator aplikacji (klienta) i identyfikator katalogu (dzierżawy).
Aplikacja musi mieć uprawnienie Mail.Send dla skrzynki pocztowej używanej jako nadawca.
Zabezpieczenia
QlikView szyfruje identyfikator dzierżawy, identyfikator klienta i klucz tajny klienta przed ich zapisaniem. Dane uwierzytelniające nie są przechowywane w postaci zwykłego tekstu.
Testowanie poczty OAuth 2.0
Użyj kontrolki test-mail na stronie konfiguracji:
- W programie QlikView Desktop kliknij Test na stronie Preferencje użytkownika > Poczta.
- W Konsoli zarządzania QlikView wprowadź adres w polu Wyślij testową wiadomość e-mail do i kliknij Wyślij.
QlikView uzyskuje token OAuth 2.0 i wysyła testową wiadomość e-mail za pośrednictwem Microsoft Graph. Jeśli krok zakończy się niepowodzeniem, przejrzyj komunikat o błędzie.
Załączniki plików
Gdy QlikView wysyła wiadomość e-mail z załącznikami, dołącza załączniki jako wbudowane w żądaniu Microsoft Graph w postaci zawartości zakodowanej w formacie Base64. Rozmiar każdego załącznika jest ograniczony do 3 MB. W przypadku większych plików użyj innej metody dostarczania.
Rozwiązywanie problemów
| Błąd | Przyczyna | Rozwiązanie |
|---|---|---|
OAuth 2.0 Client ID, Tenant ID, and Client Secret are required.
|
Jedno lub więcej pól OAuth jest puste. | Upewnij się, że wszystkie trzy pola na stronie ustawień poczty są wypełnione. |
OAuth token request failed: AADSTS7000215
|
Klucz tajny klienta jest nieprawidłowy. | Wygeneruj nowy klucz tajny klienta w Microsoft Entra ID i zaktualizuj QlikView. |
OAuth token request failed: AADSTS700016
|
Identyfikator aplikacji (klienta) jest nieprawidłowy lub aplikacja nie istnieje w określonej dzierżawie. | Zweryfikuj identyfikator aplikacji (klienta) i identyfikator katalogu (dzierżawy). |
Graph sendMail failed: ErrorAccessDenied
|
Aplikacja nie ma uprawnienia Mail.Send lub zgoda administratora nie została udzielona. |
Dodaj uprawnienie aplikacji Mail.Send i udziel zgody administratora w usłudze Microsoft Entra ID. |
Graph sendMail failed: ErrorItemNotFound
|
Adres nadawcy nie odpowiada prawidłowej skrzynce pocztowej w dzierżawie. | Upewnij się, że adres nadawcy odpowiada istniejącej skrzynce pocztowej Microsoft 365. |
Attachment too large
|
Załącznik pliku przekracza limit 3 MB na elementy wbudowane. | Zmniejsz rozmiar pliku lub użyj innej metody dostarczenia. |
