Dla administratorów
← Wszystkie tematy

Microsoft 365: podłączanie skrzynek

Połączenie kontem skrzynki (klient organizacji), dodatkowo rejestracja dla skrzynek współdzielonych – i co dokładnie ustawić w Microsoft Entra, krok po kroku.

Żeby asystent mógł czytać pocztę w Microsoft 365 i tworzyć w niej szkice, potrzebuje dostępu przez Microsoft Graph. W tym celu organizacja rejestruje aplikację we własnym Microsoft Entra ID; draften nie ma wspólnej aplikacji, której wystarczyłoby udzielić zgody. Dotyczy to zarówno naszej usługi, jak i instalacji na własnym serwerze.

Wszystko tutaj dotyczy tylko kont służbowych i szkolnych Microsoft 365. Kont osobistych outlook.com, hotmail.com i live.com podłączyć się w ogóle nie da – zobacz Obsługiwani dostawcy i ograniczenia.

Czego chcesz i co ustawić

Czego chceszCo ustawić
Członkowie logują się kontem Microsoft i każdy ma własną skrzynkęklient organizacji – to wystarczy
Do tego skrzynki współdzielone (info@, sprzedaz@) albo dostęp do skrzynek ustawiany centralnie, bez ich właścicielidodatkowo rejestracja organizacji
Logowania kontem Microsoft nie chceszludzie logują się hasłem z zaproszenia, pocztę podłącza rejestracja organizacji (albo IMAP)

Dwie różne aplikacje

Klient organizacji i rejestracja organizacji to dwie osobne aplikacje w Entra. Każda robi coś innego i jedna nie zastąpi drugiej:

Klient organizacjiRejestracja organizacji
Co robilogowanie członków przyciskiem Zaloguj się przez Microsoft i przycisk Podłącz Outlook przy własnej skrzyncedostęp asystenta do skrzynek bez logowania się ich właścicieli
Gdzie w draftenOrganizacja → Logowanie i dostęp do poczty → karta Logowanie kontem i podłączanie skrzynekOrganizacja → Logowanie i dostęp do poczty → karta Rejestracje dla skrzynek współdzielonych i zarządzania centralnego
Kto ją ustawia w draftenwłaściciel organizacjiwłaściciel lub menedżer organizacji
Uprawnienia w Entradelegowane (Delegated)aplikacji (Application)
Kto loguje się do skrzynkiwłaściciel każdej skrzynki, jeden raznikt
Do których skrzynek sięgatylko do tych, które ludzie podłączą samido skrzynek katalogu (można zawęzić)
Skrzynki współdzielonenie – nie mają własnego logowaniatak
Gdy ktoś odejdzie z firmypo zablokowaniu jego konta skrzynka się odłączanic się nie zmienia

To celowo dwie aplikacje. Zgoda na klienta daje prawa tylko do skrzynek, które ludzie podłączą sami – nigdy do poczty całej organizacji. Rejestracja organizacji sięga natomiast do wszystkich skrzynek, dlatego dostaje ją tylko draften do dostępu do skrzynek, a nie logowanie. Nie łącz ich w jedną.

Każda skrzynka używa jednego z obu dostępów. Obie aplikacje możesz mieć jednocześnie: na przykład klienta do logowania i własnych skrzynek, a rejestrację dla skrzynki współdzielonej info@.

Żadnej z tych aplikacji nigdy nie dawaj uprawnienia Mail.Send. draften niczego nie wysyła, a bez tego uprawnienia nawet nie może – i właśnie o to chodzi.

Klient organizacji: logowanie i Podłącz Outlook

Klient ma uprawnienia delegowane: aplikacja może tylko to, co może zalogowana osoba, i tylko w jej własnej skrzynce. Tworzysz go raz; właściciele skrzynek podłączają się potem sami i administratora Entra już nie potrzebują.

W Microsoft Entra

Pracujesz w Microsoft Entra admin center, https://entra.microsoft.com, zalogowany kontem administratora swojego katalogu Microsoft 365.

  1. W draften najpierw otwórz Organizacja → Logowanie i dostęp do poczty, kartę Logowanie kontem i podłączanie skrzynek. Pokazuje dwa redirect URI dokładnie dla twojego adresu draften – kończą się na /auth/callback i /mailboxes/connect/callback. Skopiuj je stamtąd; muszą się zgadzać znak po znaku.
  2. Otwórz listę rejestracji aplikacji: w menu po lewej Entra ID → App registrations (w starszej wersji menu Identity → Applications → App registrations). Bezpośrednio: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  3. U góry kliknij + New registration i wypełnij:
    • Name – na przykład draften – logowanie,
    • Supported account types – Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI – na liście rozwijanej Select a platform wybierz Web i obok wklej pierwszy adres z karty (kończy się na /auth/callback).

    Kliknij Register. Otworzy się strona nowej aplikacji.

  4. Na stronie Overview skopiuj Application (client) ID i Directory (tenant) ID (ikona kopiowania obok wartości).
  5. W menu aplikacji po lewej otwórz Authentication. Przy platformie Web w części Redirect URIs kliknij Add URI, wklej drugi adres z karty (kończy się na /mailboxes/connect/callback) i na dole kliknij Save.
  6. Certificates & secrets → zakładka Client secrets → + New client secret. Description na przykład draften, w Expires wybierz ważność (najwyżej 24 miesiące) i kliknij Add. W tabeli od razu skopiuj wartość z kolumny Value – wyświetla się tylko teraz; Secret ID draften nie potrzebuje. Zanotuj też datę z kolumny Expires.
  7. API permissions → + Add a permission → Microsoft Graph → Delegated permissions. W wyszukiwarce wpisuj po kolei i zaznaczaj openid, profile, email, offline_access, User.Read, Mail.ReadWrite i MailboxSettings.ReadWrite, a na dole kliknij Add permissions. User.Read jest zwykle na liście już od utworzenia. Bez offline_access połączenie się nie utrzyma – draften nie dostałby tokenu odświeżania.
  8. Na tej samej stronie kliknij Grant admin consent for … i potwierdź Yes. Przy wszystkich wierszach w kolumnie Status musi być zielony znacznik. Gdyby twoja organizacja zabraniała użytkownikom wyrażania zgody na aplikacje, bez tego kroku podłączenie skończyłoby się komunikatem, że zgoda została odrzucona.

W draften

  1. Właściciel organizacji otwiera Organizacja → Logowanie i dostęp do poczty, na karcie Logowanie kontem i podłączanie skrzynek wypełnia w sekcji Rejestracja Entra dla „Zaloguj się przez Microsoft” i „Podłącz Outlook” pola Application (client) ID (krok 4) i Client secret (krok 6) i klika Zapisz.
  2. Logowanie kontem Microsoft włącza na tej samej stronie w karcie Logowanie członków: w polu ID katalogu Microsoft (Entra) wpisuje Directory (tenant) ID. Gdy organizacja ma klienta i ID katalogu, członkowie logują się kontem Microsoft, a ich hasła przestają działać – zobacz Logowanie członków.
  3. Właściciel skrzynki otwiera stronę skrzynki i na karcie Dostęp do poczty w wierszu Podłącz kontem skrzynki: klika Podłącz Outlook. Loguje się kontem tej skrzynki – inne konto draften odrzuci – i zezwala na dostęp. Przycisk widzi tylko właściciel skrzynki i tylko wtedy, gdy organizacja ma klienta; bez niego karta zamiast przycisku napisze, że podłączenie kontem będzie możliwe, gdy właściciel organizacji doda klienta.
  4. Potem Przetestuj połączenie.

Gdy skrzynka się odłączy

Rejestracja organizacji: dostęp bez logowania

Rejestracja ma uprawnienia aplikacji: asystent dostaje się do skrzynki bez tego, żeby ktokolwiek się logował. Przydaje się dla skrzynek współdzielonych i dla organizacji, które chcą zarządzać dostępem do skrzynek centralnie. Z logowaniem do draften nie ma nic wspólnego.

Potrzebujesz konta z rolą administrator globalny albo administrator ról uprzywilejowanych – tylko ono udzieli zgody na uprawnienia aplikacji Microsoft Graph. Samą rejestrację może utworzyć także administrator aplikacji.

W Microsoft Entra

Pracujesz w Microsoft Entra admin center, https://entra.microsoft.com.

  1. Otwórz listę rejestracji aplikacji: w menu po lewej Entra ID → App registrations (w starszej wersji menu Identity → Applications → App registrations). Bezpośrednio: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  2. U góry kliknij + New registration i wypełnij:
    • Name – na przykład draften – poczta,
    • Supported account types – Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI – zostaw puste.

    Kliknij Register. Otworzy się strona nowej aplikacji.

  3. Na stronie Overview skopiuj Application (client) ID i Directory (tenant) ID (ikona kopiowania obok wartości).
  4. W menu aplikacji po lewej Certificates & secrets → zakładka Client secrets → + New client secret. Description na przykład draften, w Expires wybierz ważność (najwyżej 24 miesiące) i kliknij Add. W tabeli od razu skopiuj wartość z kolumny Value – wyświetla się tylko teraz; Secret ID draften nie potrzebuje. Zanotuj też datę z kolumny Expires.
  5. API permissions → + Add a permission → Microsoft Graph → Application permissions (nie Delegated). W wyszukiwarce wpisz i zaznacz Mail.ReadWrite i MailboxSettings.ReadWrite, a na dole kliknij Add permissions. MailboxSettings.ReadWrite służy tylko do koloru kategorii w Outlooku; bez niego kategoria zostanie dodana bez koloru. Opcjonalnie dodaj User.Read.All – draften sprawdza z nim aliasy skrzynki; bez niego test połączenia napisze przy aliasach, że nie może ich sprawdzić.
  6. Na tej samej stronie kliknij Grant admin consent for … i potwierdź Yes. Przy wszystkich wierszach w kolumnie Status musi być zielony znacznik.

W draften

  1. Otwórz Organizacja → Logowanie i dostęp do poczty, kartę Rejestracje dla skrzynek współdzielonych i zarządzania centralnego. Rejestracjami zarządza właściciel lub menedżer organizacji.
  2. System: Microsoft 365 (Entra). Wypełnij Nazwa, Directory (tenant) ID, Application (client) ID, Client secret (wartość z kroku 4, nie jego ID) i Sekret wygasa. Kliknij Dodaj rejestrację. Sekret jest przechowywany w postaci zaszyfrowanej i już się nie wyświetla.
  3. Rejestracja sama niczego nie podłącza. Na stronie każdej skrzynki, na karcie Dostęp do poczty, wybierz w polu Rejestracja organizacji tę rejestrację, kliknij Zastosuj, a potem Przetestuj połączenie. Wybór widzi tylko ten, kto jest jednocześnie właścicielem skrzynki oraz właścicielem lub menedżerem organizacji (właściciel organizacji jest właścicielem wszystkich skrzynek). Całe postępowanie ze zrzutami ekranu pokazuje instrukcja Dodanie i podłączenie skrzynki.

Przy włączonej automatycznej skrzynce (Logowanie członków) nowa skrzynka zostaje powiązana z rejestracją sama, jeśli dla Microsoft 365 jest dokładnie jedna aktywna.

Zawężenie do wybranych skrzynek (opcjonalnie)

Uprawnienie aplikacji sięga do wszystkich skrzynek katalogu; strażnikiem jest draften (członek nie może dodać skrzynki, asystent niczego nie wysyła ani nie usuwa). Kto chce mieć także techniczne ogrodzenie, zawęża aplikację do grupy zabezpieczeń zasadą ApplicationAccessPolicy w Exchange Online. Potrzebujesz PowerShella i roli administratora Exchange (albo administratora globalnego).

Krok 1 – moduł Exchange Online. Zainstaluj go jeden raz: uruchom PowerShell jako administrator komputera i wpisz:

Install-Module ExchangeOnlineManagement

Krok 2 – grupa i zasada. Zaloguj się do Exchange Online, utwórz grupę zabezpieczeń ze skrzynkami, do których draften może sięgać, i zasadę, która ograniczy aplikację tylko do niej. W miejsce <Application (client) ID> wstaw ID rejestracji z kroku 3 powyżej, w miejsce adresów swoje skrzynki:

Connect-ExchangeOnline -UserPrincipalName admin@<tenant>.onmicrosoft.com
New-DistributionGroup -Name "draften - dozwolone skrzynki" -Alias draften-skrzynki -Type Security -Members skrzynka@firma.cz
New-ApplicationAccessPolicy -AppId <Application (client) ID> -PolicyScopeGroupId draften-skrzynki@firma.cz -AccessRight RestrictAccess -Description "draften: tylko dozwolone skrzynki"

Krok 3 – sprawdzenie. Dla skrzynki w grupie polecenie powinno wypisać AccessCheckResult : Granted, dla skrzynki spoza grupy Denied:

Test-ApplicationAccessPolicy -Identity skrzynka@firma.cz -AppId <Application (client) ID>

Kolejną skrzynkę dodasz potem do grupy w Exchange admin center (https://admin.exchange.microsoft.com → Recipients → Groups) albo poleceniem Add-DistributionGroupMember -Identity draften-skrzynki@firma.cz -Member kolejna@firma.cz. Skrzynka spoza grupy skończy w teście połączenia błędem 403 (AppOnly AccessPolicy). Zasada zaczyna działać zwykle w ciągu godziny; widzieliśmy też cztery godziny. Jako nowszą alternatywę Microsoft oferuje RBAC for Applications w Exchange Online; tego na razie nie opisujemy.

Wymiana sekretu

Sekret ma ograniczoną ważność, a draften nie wysyła żadnego powiadomienia o jego końcu – data na karcie zmienia kolor na żółty 30 dni przed wygaśnięciem, a po nim na czerwony. Ustaw sobie przypomnienie w kalendarzu. Przed wygaśnięciem:

  1. W Entra otwórz App registrations → swoją rejestrację (na przykład draften – poczta) → Certificates & secrets → + New client secret i skopiuj nową Value (jak w kroku 4 powyżej).
  2. W draften w Organizacja → Logowanie i dostęp do poczty przy rejestracji wybierz Nowy sekret, wklej nową wartość i nową datę.
  3. Stary sekret w Entra usuń ikoną kosza w jego wierszu.

Gdy sekret wygaśnie wcześniej, skrzynki się odłączą (invalid_client), a asystenci będą je pomijać. Po wymianie sekretu uruchom przy skrzynkach Przetestuj połączenie – udany test znowu włącza skrzynkę.

Błędy testu połączenia

Test sprawdza trzy kroki: Dostęp, Token i uprawnienie i Odczyt skrzynki odbiorczej. Przy każdym jest znacznik albo krzyżyk z powodem:

W komunikacieCo to znaczyCo zrobić
AADSTS7000215, AADSTS7000222, invalid_clientzły albo wygasły client secretutwórz nowy sekret i zapisz go w draften
AADSTS700016, AADSTS90002, unauthorized_clientzłe Application ID albo Directory IDprzepisz oba ID ponownie z Overview
AADSTS65001, AADSTS650057, consent_requiredbrak zgody administratoraGrant admin consent przy aplikacji
token bez Mail.ReadWritebrak uprawnienia albo nie udzielono na nie zgodydodaj uprawnienie i udziel zgody
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008połączenie kontem wygasło albo zostało cofniętePodłącz Outlook ponownie
HTTP 403 AppOnly AccessPolicyskrzynki nie ma w grupie zasady dostępudodaj ją do grupy i poczekaj
HTTP 404taka skrzynka nie istniejesprawdź adres; skrzynka musi mieć Exchange Online
HTTP 401inny katalog albo brak uprawnieniasprawdź Directory ID i uprawnienia

Pozostałe błędy opisuje strona Rozwiązywanie problemów.

Wersja tekstowa