Microsoft / Outlook dla poczty wychodzącej w AMODIT
Artykuł zweryfikowany dla wersji 260331.
Wprowadzenie
Dział zatytułowany „Wprowadzenie”Ten artykuł jest dla administratora, który chce skonfigurować konto Microsoft / Outlook jako nadawcę wiadomości wysyłanych przez AMODIT.
Materiał obejmuje wariant, w którym:
- wysyłka odbywa się przez SMTP,
- logowanie korzysta z OAuth,
- token jest zapisany w parametrze OutlookNotificationOAuthToken.
Ten wpis dotyczy tylko wariantu SMTP + OAuth dla kont Microsoft / Outlook. Osobne artykuły opisują wysyłkę przez EWS i MS Graph.
Kiedy ten artykuł ma sens
Dział zatytułowany „Kiedy ten artykuł ma sens”Ten materiał jest właściwy wtedy, gdy:
- organizacja korzysta z kont Microsoft / Outlook jako nadawcy wiadomości,
- AMODIT ma wysyłać pocztę przez SMTP,
- logowanie ma opierać się na tokenie, a nie na stałym haśle użytkownika.
Jeżeli szukasz ogólnego opisu poczty wychodzącej, zacznij od artykułu obszarowego. Ten wpis pokazuje, jak skonfigurować konkretnie scenariusz SMTP + OAuth dla Microsoft / Outlook.
Wymagania wstępne
Dział zatytułowany „Wymagania wstępne”Zanim zaczniesz, przygotuj:
- konto Microsoft / Outlook, z którego AMODIT ma wysyłać wiadomości,
- uprawnienia administratora do Ustawień systemowych,
- konfigurację aplikacji Microsoft w parametrze AzureApplicationConfig,
- możliwość zalogowania się do Microsoft podczas generowania tokenu OAuth.
Co trzeba ustawić
Dział zatytułowany „Co trzeba ustawić”W tym wariancie konfiguracja obejmuje trzy elementy:
- protokół i serwer poczty wychodzącej,
- konto nadawcy,
- token OAuth zapisany w parametrze OutlookNotificationOAuthToken.
Wszystkie trzy elementy muszą być ze sobą zgodne. Sam token nie wystarczy, jeżeli serwer SMTP nie odpowiada wariantowi obsługiwanemu przez ten mechanizm.
Krok 1. Przygotuj konfigurację aplikacji w Azure
Dział zatytułowany „Krok 1. Przygotuj konfigurację aplikacji w Azure”Wariant Microsoft / Outlook oparty o OAuth korzysta ze wspólnej konfiguracji aplikacji zapisanej w parametrze AzureApplicationConfig.
Ten parametr jest potrzebny wtedy, gdy organizacja korzysta z własnej aplikacji zarejestrowanej w Azure i sama zarządza zgodami OAuth. W takiej sytuacji trzeba:
- zarejestrować aplikację w Azure,
- przygotować dane klienta i adres przekierowania,
- zapisać konfigurację w parametrze AzureApplicationConfig.
Krok 2. Ustaw pocztę wychodzącą w wariancie SMTP
Dział zatytułowany „Krok 2. Ustaw pocztę wychodzącą w wariancie SMTP”W Ustawieniach systemowych, w sekcji odpowiedzialnej za pocztę wychodzącą, ustaw:
- Protocol = SMTP,
- Server name or IP = smtp-mail.outlook.com,
- użytkownika, z którego AMODIT ma wysyłać wiadomości,
- szyfrowanie i port zgodnie z wymaganiami skrzynki.
Ta konfiguracja jest krytyczna, ponieważ AMODIT używa tokenu OutlookNotificationOAuthToken tylko wtedy, gdy serwer SMTP jest ustawiony dokładnie na smtp-mail.outlook.com.
Krok 3. Wygeneruj token OutlookNotificationOAuthToken
Dział zatytułowany „Krok 3. Wygeneruj token OutlookNotificationOAuthToken”Po przygotowaniu ustawień połączenia wygeneruj token OAuth dla parametru OutlookNotificationOAuthToken.
W tym miejscu:
- uruchom generowanie tokenu,
- zaloguj się na konto Microsoft używane jako nadawca,
- zaakceptuj wymagane zgody,
- zapisz konfigurację.
W tym wariancie token przejmuje rolę hasła używanego do logowania przez SMTP.
Krok 4. Sprawdź zgodność serwera i tokenu
Dział zatytułowany „Krok 4. Sprawdź zgodność serwera i tokenu”Po zapisaniu konfiguracji warto jeszcze raz sprawdzić dwie rzeczy:
- czy serwer SMTP jest ustawiony dokładnie na smtp-mail.outlook.com,
- czy token został zapisany w parametrze OutlookNotificationOAuthToken.
To jest ważne, ponieważ AMODIT nie traktuje tego tokenu jako ogólnego hasła dla dowolnego serwera. Mechanizm działa tylko dla konkretnego wariantu Microsoft / Outlook.
Weryfikacja
Dział zatytułowany „Weryfikacja”Po poprawnej konfiguracji:
- system ma ustawiony protokół SMTP,
- serwer smtp-mail.outlook.com jest zapisany w ustawieniach poczty wychodzącej,
- token znajduje się w parametrze OutlookNotificationOAuthToken,
- AMODIT może używać tego konta do wysyłki wiadomości.
Typowe problemy
Dział zatytułowany „Typowe problemy”Token jest wygenerowany, ale system nadal nie używa go przy wysyłce
Dział zatytułowany „Token jest wygenerowany, ale system nadal nie używa go przy wysyłce”Najpierw sprawdź:
- czy serwer SMTP jest ustawiony dokładnie na smtp-mail.outlook.com,
- czy token zapisano w OutlookNotificationOAuthToken,
- czy konto nadawcy odpowiada temu samemu użytkownikowi, dla którego wygenerowano token.
Organizacja używa Microsoft, ale nie chce wysyłać przez SMTP
Dział zatytułowany „Organizacja używa Microsoft, ale nie chce wysyłać przez SMTP”W takiej sytuacji ten materiał nie będzie właściwy. Trzeba przejść do osobnych artykułów opisujących wysyłkę przez EWS albo MS Graph.
Logowanie OAuth nie kończy się poprawnie
Dział zatytułowany „Logowanie OAuth nie kończy się poprawnie”Wtedy trzeba sprawdzić zgodność:
- konfiguracji aplikacji w AzureApplicationConfig,
- adresu przekierowania po stronie Microsoft,
- konta użytego przy generowaniu tokenu.
Wynik końcowy
Dział zatytułowany „Wynik końcowy”Po wykonaniu tej konfiguracji AMODIT potrafi wysyłać wiadomości z konta Microsoft / Outlook przez SMTP, używając tokenu OAuth zapisanego w OutlookNotificationOAuthToken.