Ż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 chcesz | Co 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ścicieli | dodatkowo rejestracja organizacji |
| Logowania kontem Microsoft nie chcesz | ludzie 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 organizacji | Rejestracja organizacji | |
|---|---|---|
| Co robi | logowanie członków przyciskiem Zaloguj się przez Microsoft i przycisk Podłącz Outlook przy własnej skrzynce | dostęp asystenta do skrzynek bez logowania się ich właścicieli |
| Gdzie w draften | Organizacja → Logowanie i dostęp do poczty → karta Logowanie kontem i podłączanie skrzynek | Organizacja → Logowanie i dostęp do poczty → karta Rejestracje dla skrzynek współdzielonych i zarządzania centralnego |
| Kto ją ustawia w draften | właściciel organizacji | właściciel lub menedżer organizacji |
| Uprawnienia w Entra | delegowane (Delegated) | aplikacji (Application) |
| Kto loguje się do skrzynki | właściciel każdej skrzynki, jeden raz | nikt |
| Do których skrzynek sięga | tylko do tych, które ludzie podłączą sami | do skrzynek katalogu (można zawęzić) |
| Skrzynki współdzielone | nie – nie mają własnego logowania | tak |
| Gdy ktoś odejdzie z firmy | po zablokowaniu jego konta skrzynka się odłącza | nic 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.
- 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/callbacki/mailboxes/connect/callback. Skopiuj je stamtąd; muszą się zgadzać znak po znaku. - 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
- 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.
- Name – na przykład
- Na stronie Overview skopiuj Application (client) ID i Directory (tenant) ID (ikona kopiowania obok wartości).
- 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. - 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. - API permissions → + Add a permission → Microsoft Graph → Delegated permissions. W wyszukiwarce wpisuj po kolei i zaznaczaj
openid,profile,email,offline_access,User.Read,Mail.ReadWriteiMailboxSettings.ReadWrite, a na dole kliknij Add permissions.User.Readjest zwykle na liście już od utworzenia. Bezoffline_accesspołączenie się nie utrzyma – draften nie dostałby tokenu odświeżania. - 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
- 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.
- 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.
- 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.
- Potem Przetestuj połączenie.
Gdy skrzynka się odłączy
- Wygasł sekret klienta – w Entra otwórz App registrations → rejestrację klienta (na przykład
draften – logowanie) → Certificates & secrets → + New client secret i skopiuj Value. Zapisz go na karcie Logowanie kontem i podłączanie skrzynek i przy skrzynkach kliknij Podłącz Outlook ponownie. - Osoba odeszła albo jej konto zostało zablokowane – Microsoft przestaje wydawać tokeny i draften odłącza skrzynkę. Skrzynkę bez własnego logowania podłącz rejestracją organizacji (poniżej).
- „Dostawca nie wydał tokenu odświeżania” – klientowi brakuje uprawnienia
offline_access(krok 7). - „Zalogowało się inne konto niż adres skrzynki” – przy podłączaniu zaloguj się kontem właśnie tej skrzynki; kto ma w przeglądarce kilka kont Microsoft, wybiera właściwe.
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.
- 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
- 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.
- Name – na przykład
- Na stronie Overview skopiuj Application (client) ID i Directory (tenant) ID (ikona kopiowania obok wartości).
- 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. - API permissions → + Add a permission → Microsoft Graph → Application permissions (nie Delegated). W wyszukiwarce wpisz i zaznacz
Mail.ReadWriteiMailboxSettings.ReadWrite, a na dole kliknij Add permissions.MailboxSettings.ReadWritesłuży tylko do koloru kategorii w Outlooku; bez niego kategoria zostanie dodana bez koloru. Opcjonalnie dodajUser.Read.All– draften sprawdza z nim aliasy skrzynki; bez niego test połączenia napisze przy aliasach, że nie może ich sprawdzić. - Na tej samej stronie kliknij Grant admin consent for … i potwierdź Yes. Przy wszystkich wierszach w kolumnie Status musi być zielony znacznik.
W draften
- 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.
- 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.
- 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:
- 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). - W draften w Organizacja → Logowanie i dostęp do poczty przy rejestracji wybierz Nowy sekret, wklej nową wartość i nową datę.
- 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 komunikacie | Co to znaczy | Co zrobić |
|---|---|---|
AADSTS7000215, AADSTS7000222, invalid_client | zły albo wygasły client secret | utwórz nowy sekret i zapisz go w draften |
AADSTS700016, AADSTS90002, unauthorized_client | złe Application ID albo Directory ID | przepisz oba ID ponownie z Overview |
AADSTS65001, AADSTS650057, consent_required | brak zgody administratora | Grant admin consent przy aplikacji |
token bez Mail.ReadWrite | brak uprawnienia albo nie udzielono na nie zgody | dodaj uprawnienie i udziel zgody |
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008 | połączenie kontem wygasło albo zostało cofnięte | Podłącz Outlook ponownie |
HTTP 403 AppOnly AccessPolicy | skrzynki nie ma w grupie zasady dostępu | dodaj ją do grupy i poczekaj |
| HTTP 404 | taka skrzynka nie istnieje | sprawdź adres; skrzynka musi mieć Exchange Online |
| HTTP 401 | inny katalog albo brak uprawnienia | sprawdź Directory ID i uprawnienia |
Pozostałe błędy opisuje strona Rozwiązywanie problemów.