Skip to main content

Konfiguracja poczty wychodzacej w AMODIT

Aktualizacja

Artykuł zweryfikowany dla linii 251231, z uwagą że MS Graph jest dostępny od wersji 251231.56.

Wprowadzenie

Ten artykuł jest dla administratora, który chce uporządkować konfigurację poczty wychodzącej w AMODIT, zanim przejdzie do ustawień konkretnego mechanizmu. Po lekturze powinno być jasne, które elementy konfiguracji są wspólne dla całego obszaru, co zależy od wybranego kanału wysyłki i dlaczego sam serwer pocztowy nie wyjaśnia jeszcze całego zachowania wiadomości wychodzących.

Kiedy ten artykuł ma zastosowanie

Ten materiał jest punktem startowym wtedy, gdy:

  • konfigurujesz pocztę wychodzącą od zera,
  • porządkujesz istniejące ustawienia po zmianie infrastruktury,
  • diagnozujesz, dlaczego wiadomości wychodzą z niewłaściwego adresu albo zawierają błędne linki,
  • chcesz ustalić, do którego artykułu szczegółowego przejść dalej.

To nie jest jeszcze instrukcja dla jednego konkretnego wariantu. To nadrzędny przewodnik administracyjny dla całego obszaru outgoing.

Jak myśleć o konfiguracji poczty wychodzącej

Najwygodniej podzielić temat na trzy warstwy:

Wybór mechanizmu wysyłki

Najpierw ustalasz, jak AMODIT ma przekazać wiadomość do infrastruktury pocztowej albo usługi zewnętrznej.

W nowszych wydaniach linii 251231 artykuł ogólny dla outgoing obejmuje cztery aktywne warianty:

  • SMTP
  • EWS
  • RestAPI
  • MS Graph

Ważna uwaga wersyjna: w linii 251231 mechanizm MS Graph dla poczty wychodzącej jest dostępny od wersji 251231.56.

Ustawienia wspólne dla wiadomości

Niezależnie od wybranego mechanizmu trzeba zadbać o elementy, które wpływają na odbiór wiadomości przez użytkownika:

  • adres nadawcy,
  • adresy bazowe używane do linków,
  • podstawowe zasady logowania, limitów i obsługi błędów.

Ustawienia szczegółowe dla wybranego wariantu

Dopiero na tym poziomie przechodzisz do danych charakterystycznych dla konkretnego kanału wysyłki, na przykład serwera SMTP, ustawień EWS, grupy parametrów dla RestAPI albo tokenów MS Graph.

To rozdzielenie jest ważne, bo w praktyce część problemów wynika z błędnej konfiguracji transportu, a część z ustawień wspólnych, które są poprawne lub błędne niezależnie od samego mechanizmu wysyłki.

Jakie ustawienia są wspólne dla całego obszaru

Mechanizm wysyłki

To ustawienie rozstrzyga, czy organizacja korzysta z SMTP, EWS, RestAPI czy MS Graph.

Adres nadawcy

To ustawienie wpływa na to, jaki adres odbiorca zobaczy w skrzynce. Z punktu widzenia administratora warto traktować je jako element tożsamości komunikacji systemowej, a nie tylko pole techniczne.

Warto pamiętać, że nie każda wiadomość musi korzystać z jednego globalnego adresu. W części scenariuszy AMODIT może użyć osobnej skrzynki nadawczej powiązanej z konkretnym adresem.

Linki w wiadomościach

To warstwa, która decyduje, dokąd użytkownik trafi po kliknięciu odnośnika z maila. W praktyce błędny adres bazowy potrafi zepsuć odbiór wiadomości nawet wtedy, gdy sam transport działa poprawnie.

Krótki przykład: wiadomość może zostać doręczona bez błędu, ale jeśli prowadzi użytkownika do złego adresu AMODIT, z perspektywy odbiorcy cała komunikacja nadal jest nieprawidłowa.

Logowanie, limity i obsługa błędów

Warto od początku ustalić, jak w danym środowisku mają być logowane wysłane wiadomości, jaki limit wysyłki obowiązuje i co powinno dziać się z pozycjami, których nie udało się dostarczyć.

Co zależy od konkretnego mechanizmu

SMTP

To klasyczny wariant oparty o serwer pocztowy, port, szyfrowanie i dane uwierzytelniające. W praktyce jest najłatwiejszy do rozpoznania, bo ma najbardziej oczywisty zestaw pól administracyjnych.

Ważny niuans: globalne ustawienia SMTP nie zawsze sterują każdą wiadomością. Dla części nadawców AMODIT może użyć osobnej konfiguracji skrzynki wysyłkowej.

EWS

To wariant dla środowisk opartych o Microsoft Exchange. Administrator nadal pracuje tu na warstwie wychodzącej, ale sposób autoryzacji i zestaw wymagań jest inny niż przy klasycznym SMTP.

RestAPI

To wariant dla środowisk, które chcą przekazywać mail do zewnętrznej usługi HTTP. W tym scenariuszu zamiast pojedynczego formularza z hostem i portem trzeba zadbać o spójną konfigurację usługi, endpointu, metody, nagłówków i body.

MS Graph

To wariant dla środowisk Microsoft 365, które wysyłają wiadomości przez Microsoft Graph. Z perspektywy administratora najważniejsze jest poprawne spięcie autoryzacji oraz pilnowanie ważności tokenów używanych przez mechanizm wysyłki.

Od czego zacząć konfigurację w praktyce

Najbezpieczniejsza kolejność wygląda tak:

  1. Ustal, który mechanizm wysyłki ma być używany w danym środowisku.
  2. Uzupełnij ustawienia wspólne:
    • adres nadawcy,
    • adresy bazowe do linków,
    • podstawowe zasady logowania, limitów i obsługi błędów.
  3. Skonfiguruj szczegóły wybranego wariantu.
  4. Wykonaj rzeczywisty test wysyłki.
  5. Zweryfikuj nie tylko dostarczenie maila, ale też nadawcę, linki i oczekiwany odbiór przez użytkownika.

To ważne, bo samo pytanie „czy mail wyszedł” jest zbyt wąskie. Administrator powinien sprawdzić również, czy wiadomość wyszła we właściwej postaci.

Gdzie najczęściej pojawiają się nieporozumienia

Najczęstsze pomyłki w tym obszarze wynikają z kilku uproszczeń:

  • utożsamiania całej konfiguracji outgoing z samym SMTP,
  • zakładania, że poprawny transport automatycznie oznacza poprawne linki i poprawnego nadawcę,
  • pomijania faktu, że część wiadomości może korzystać z osobnej konfiguracji skrzynki,
  • mieszania artykułu administracyjnego z artykułem o technicznym obiegu wiadomości.

Jeśli administrator nie rozdzieli tych poziomów, łatwo przejść do naprawiania niewłaściwego fragmentu konfiguracji.

Gdzie szukać dalej

Jeśli chcesz zrozumieć szerszy kontekst całego obszaru, wróć do artykułu Poczta wychodząca w AMODIT.

Jeśli potrzebujesz technicznego wyjaśnienia, jak wiadomość przechodzi od zdarzenia w systemie do końcowej wysyłki, przejdź do Jak działa wysyłanie maili w AMODIT.

Jeśli w tym momencie pracujesz wyłącznie z wariantem SMTP, przejdź do artykułu Konfiguracja wysyłki przez SMTP.

Jeżeli Twoje środowisko wysyła wiadomości przez Microsoft 365 z użyciem Microsoft Graph, przejdź do artykułu Konfiguracja wysyłki przez MS Graph.

Szczegółowy artykuł dla RestAPI jest w przygotowaniu.

Jeżeli Twoje środowisko wysyła wiadomości przez Exchange, przejdź do artykułu Konfiguracja wysyłki przez EWS.

Powiązane artykuły