Przejdź do treści

Konfiguracja skrzynki pocztowej Microsoft 365

Microsoft wycofuje w Exchange Online logowanie do SMTP i IMAP samym loginem i hasłem (Basic Authentication). Navigator łączy się więc ze skrzynką Microsoft 365 przez OAuth 2.0, co wymaga rejestracji aplikacji w Microsoft Entra ID (dawniej Azure Active Directory). Z tego artykułu dowiesz się, jak zarejestrować aplikację i ustawić skrzynkę w Navigatorze.

Zanim zaczniesz

  • Potrzebny jest dostęp do centrum administracyjnego Microsoft Entra (https://entra.microsoft.com) albo portalu Azure.
  • Do rejestracji aplikacji potrzebna jest jedna z ról: Administrator aplikacji (Application Administrator), Administrator aplikacji w chmurze (Cloud Application Administrator) albo Deweloper aplikacji (Application Developer).
  • Zgody administratora na uprawnienia udziela osoba z rolą Administrator globalny (Global Administrator) albo Administrator ról uprzywilejowanych (Privileged Role Administrator). Gdy osoba rejestrująca aplikację jej nie ma, zgody udziela administrator dzierżawy.

Wybór sposobu połączenia

Microsoft Graph API + Klucz tajny SMTP/IMAP + Exchange Online
Logowanie Aplikacja loguje się kluczem tajnym, bez hasła użytkownika. Login i hasło użytkownika skrzynki wymieniane na token OAuth.
Uwierzytelnianie wieloskładnikowe (MFA) Nie przeszkadza. Konto skrzynki nie może wymagać MFA.
Typ uprawnień w Entra ID Aplikacji (Application) Delegowane (Delegated)
Zgoda administratora Wymagana Wymagana
Zalecane Tak Gdy nie można użyć Graph API.

Zalecane jest Microsoft Graph API z uwierzytelnieniem Klucz tajny. Połączenie nie zależy od hasła użytkownika, więc zmiana albo wygaśnięcie hasła nie przerywa pracy skrzynki.

Rejestracja aplikacji

  1. Zaloguj się do centrum administracyjnego Microsoft Entra.
  2. Przejdź do Tożsamość > Aplikacje > Rejestracje aplikacji (Identity > Applications > App registrations) i wybierz Nowa rejestracja (New registration).
  3. Wpisz dowolną nazwę, np. Navigator poczta. Służy tylko do rozpoznania aplikacji.
  4. W Obsługiwanych typach kont (Supported account types) wybierz Konta tylko w tym katalogu organizacyjnym (Accounts in this organizational directory only).
  5. Identyfikator URI przekierowania (Redirect URI) zostaw pusty.
  6. Kliknij Zarejestruj (Register).
  7. Ze strony Przegląd (Overview) aplikacji skopiuj Identyfikator aplikacji (klienta) (Application (client) ID) i Identyfikator katalogu (dzierżawy) (Directory (tenant) ID). Wpiszesz je w Navigatorze.

Dalsza konfiguracja zależy od sposobu połączenia.

Microsoft Graph API z kluczem tajnym

Klucz tajny

  1. W rejestracji aplikacji przejdź do Certyfikaty i wpisy tajne (Certificates & secrets).
  2. Na karcie Wpisy tajne klienta (Client secrets) wybierz Nowy wpis tajny klienta (New client secret).
  3. Podaj opis i okres ważności i kliknij Dodaj.
  4. Skopiuj zawartość kolumny Wartość (Value). Widać ją tylko zaraz po utworzeniu klucza.

Ważność klucza

Klucz tajny ma ograniczony okres ważności. Przed jego wygaśnięciem wygeneruj nowy klucz i wpisz go w Navigatorze, inaczej skrzynka przestanie pobierać i wysyłać pocztę. Zapisz sobie datę wygaśnięcia klucza.

Uprawnienia interfejsu API

  1. Przejdź do Uprawnienia interfejsu API (API permissions) i wybierz Dodaj uprawnienie (Add a permission).
  2. Wybierz Microsoft Graph > Uprawnienia aplikacji (Application permissions).
  3. Zaznacz Mail.Read (odczyt poczty) i Mail.Send (wysyłanie). Skrzynce tylko do wysyłania wystarczy Mail.Send.
  4. Kliknij Dodaj uprawnienia, a potem Udziel zgody administratora (Grant admin consent). Poprawnie ustawione uprawnienia mają w kolumnie stanu zielony znacznik.

Uprawnienia aplikacji dają dostęp do wszystkich skrzynek w organizacji. Administrator Exchange Online może ograniczyć dostęp aplikacji do skrzynek używanych przez Navigator zasadami dostępu aplikacji (RBAC for Applications albo Application Access Policy, patrz dokumentacja Microsoft).

Ustawienia w Navigatorze

W formularzu skrzynki (Poczta e-mail > Skrzynki pocztowe) ustaw:

Pole Wartość
Połącz przez Microsoft Graph API
Adres Adres e-mail skrzynki, np. faktury@firma.pl.
Uwierzytelnij przez Klucz tajny
Klucz tajny Wartość klucza tajnego.
Identyfikator aplikacji (klienta), Identyfikator katalogu (dzierżawy) Wartości ze strony przeglądu aplikacji.

Zapisz skrzynkę i kliknij Sprawdź połączenie.

Uwierzytelnienie Login i hasło dla Graph API działa jak opisane niżej Exchange Online. Wymaga uprawnień delegowanych Mail.Read i Mail.Send, a dla skrzynki innej niż skrzynka logującego się użytkownika także Mail.Read.Shared i Mail.Send.Shared. Potrzebne są też włączone przepływy klientów publicznych i konto bez wymaganego MFA.

SMTP/IMAP z uwierzytelnieniem Exchange Online

Navigator łączy się z serwerami SMTP i IMAP Exchange Online, a do logowania używa tokenu OAuth uzyskanego z loginu i hasła użytkownika skrzynki.

Uprawnienia interfejsu API

  1. Przejdź do Uprawnienia interfejsu API (API permissions) i wybierz Dodaj uprawnienie (Add a permission).
  2. Wybierz Microsoft Graph > Uprawnienia delegowane (Delegated permissions).
  3. Zaznacz IMAP.AccessAsUser.All (pobieranie), SMTP.Send (wysyłanie), email i offline_access. Skrzynce tylko do wysyłania albo tylko do pobierania wystarczy uprawnienie do jednego protokołu.
  4. Kliknij Dodaj uprawnienia, a potem Udziel zgody administratora (Grant admin consent).

Przepływy klientów publicznych

W rejestracji aplikacji przejdź do Uwierzytelnianie (Authentication) i w Ustawieniach zaawansowanych (Advanced settings) ustaw Zezwalaj na przepływy klientów publicznych (Allow public client flows) na Tak. Opcja jest domyślnie wyłączona, a bez niej Navigator nie uzyska tokenu.

Ustawienia skrzynki w Microsoft 365

  • W centrum administracyjnym Microsoft 365, we właściwościach użytkownika, na karcie Poczta > Zarządzaj aplikacjami poczty e-mail (Mail > Manage email apps) włącz uwierzytelnione SMTP (Authenticated SMTP) i IMAP.
  • Konto, którym loguje się Navigator, nie może wymagać uwierzytelniania wieloskładnikowego (MFA), bo logowanie odbywa się bez udziału użytkownika. Gdy zasady dostępu warunkowego wymuszają MFA, użyj Microsoft Graph API z kluczem tajnym.

Ustawienia w Navigatorze

Pole Wartość
Połącz przez SMTP/IMAP
Adres SMTP, Port SMTP smtp.office365.com, 587
Adres IMAP, Port IMAP outlook.office365.com, 993
Uwierzytelnij przez Exchange Online
Login, Hasło Adres e-mail i hasło użytkownika skrzynki.
Identyfikator aplikacji (klienta), Identyfikator katalogu (dzierżawy) Wartości ze strony przeglądu aplikacji.

Zapisz skrzynkę i kliknij Sprawdź połączenie. Komunikat pokaże wynik osobno dla SMTP i IMAP.

Co dalej