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¶
- Zaloguj się do centrum administracyjnego Microsoft Entra.
- Przejdź do Tożsamość > Aplikacje > Rejestracje aplikacji (Identity > Applications > App registrations) i wybierz Nowa rejestracja (New registration).
- Wpisz dowolną nazwę, np.
Navigator poczta. Służy tylko do rozpoznania aplikacji. - W Obsługiwanych typach kont (Supported account types) wybierz Konta tylko w tym katalogu organizacyjnym (Accounts in this organizational directory only).
- Identyfikator URI przekierowania (Redirect URI) zostaw pusty.
- Kliknij Zarejestruj (Register).
- 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¶
- W rejestracji aplikacji przejdź do Certyfikaty i wpisy tajne (Certificates & secrets).
- Na karcie Wpisy tajne klienta (Client secrets) wybierz Nowy wpis tajny klienta (New client secret).
- Podaj opis i okres ważności i kliknij Dodaj.
- 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¶
- Przejdź do Uprawnienia interfejsu API (API permissions) i wybierz Dodaj uprawnienie (Add a permission).
- Wybierz Microsoft Graph > Uprawnienia aplikacji (Application permissions).
- Zaznacz Mail.Read (odczyt poczty) i Mail.Send (wysyłanie). Skrzynce tylko do wysyłania wystarczy Mail.Send.
- 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¶
- Przejdź do Uprawnienia interfejsu API (API permissions) i wybierz Dodaj uprawnienie (Add a permission).
- Wybierz Microsoft Graph > Uprawnienia delegowane (Delegated permissions).
- 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.
- 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¶
- Konfiguracja skrzynki e-mail: typy dokumentów, procedury obiegu i automatyczne pobieranie.