Skip to main content

Microsoft / Outlook dla poczty wychodzącej w AMODIT

Aktualizacja

Artykuł zweryfikowany dla wersji 260331.

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

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

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ć

W tym wariancie konfiguracja obejmuje trzy elementy:

  1. protokół i serwer poczty wychodzącej,
  2. konto nadawcy,
  3. 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

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:

  1. zarejestrować aplikację w Azure,
  2. przygotować dane klienta i adres przekierowania,
  3. zapisać konfigurację w parametrze AzureApplicationConfig.

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

Po przygotowaniu ustawień połączenia wygeneruj token OAuth dla parametru OutlookNotificationOAuthToken.

W tym miejscu:

  1. uruchom generowanie tokenu,
  2. zaloguj się na konto Microsoft używane jako nadawca,
  3. zaakceptuj wymagane zgody,
  4. zapisz konfigurację.

W tym wariancie token przejmuje rolę hasła używanego do logowania przez SMTP.

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

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

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

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

Wtedy trzeba sprawdzić zgodność:

  • konfiguracji aplikacji w AzureApplicationConfig,
  • adresu przekierowania po stronie Microsoft,
  • konta użytego przy generowaniu tokenu.

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.

Powiązane artykuły