Aby asistent mohl číst poštu v Microsoft 365 a zakládat v ní koncepty, potřebuje přístup přes Microsoft Graph. K tomu si organizace zaregistruje aplikaci ve svém Microsoft Entra ID; draften nemá společnou aplikaci, které byste jen udělili souhlas. Platí to pro naši službu i pro instalaci na vlastním serveru.
Všechno tady platí jen pro pracovní a školní účty Microsoft 365. Osobní účty outlook.com, hotmail.com a live.com připojit nejde vůbec — viz Podporovaní poskytovatelé a omezení.
Co chcete a co nastavit
| Co chcete | Co nastavit |
|---|---|
| Členové se přihlašují účtem Microsoft a každý má vlastní schránku | klient organizace — to stačí |
| K tomu sdílené schránky (info@, obchod@), nebo přístup ke schránkám nastavený centrálně, bez jejich vlastníků | navíc registrace organizace |
| Přihlašování účtem Microsoft nechcete | lidé se přihlašují heslem z pozvánky, poštu připojí registrace organizace (nebo IMAP) |
Dvě různé aplikace
Klient organizace a registrace organizace jsou dvě samostatné aplikace v Entra. Každá dělá něco jiného a navzájem se nezastoupí:
| Klient organizace | Registrace organizace | |
|---|---|---|
| Co dělá | přihlašování členů tlačítkem Přihlásit přes Microsoft a tlačítko Připojit Outlook u vlastní schránky | přístup asistenta ke schránkám bez přihlášení jejich vlastníků |
| Kde v draftenu | Organizace → Přihlašování a přístup k poště → karta Přihlášení účtem a připojení schránek | Organizace → Přihlašování a přístup k poště → karta Registrace pro sdílené schránky a centrální správu |
| Kdo ji v draftenu nastavuje | vlastník organizace | vlastník nebo správce organizace |
| Oprávnění v Entra | delegovaná (Delegated) | aplikační (Application) |
| Kdo se ke schránce přihlašuje | vlastník každé schránky, jednou | nikdo |
| Na které schránky dosáhne | jen na ty, které si lidé sami připojí | na schránky adresáře (jde zúžit) |
| Sdílené schránky | ne — nemají vlastní přihlášení | ano |
| Když člověk z firmy odejde | po zablokování jeho účtu se schránka odpojí | nic se nemění |
Jsou to záměrně dvě aplikace. Souhlas s klientem dává práva jen ke schránkám, které si lidé sami připojí — nikdy k poště celé organizace. Registrace organizace naopak dosáhne na všechny schránky, a proto ji dostává jen draften pro přístup ke schránkám, ne přihlašování. Nespojujte je do jedné.
Každá schránka používá jeden z obou přístupů. Obě aplikace můžete mít zároveň: třeba klienta pro přihlášení a vlastní schránky a registraci pro sdílenou schránku info@.
Ani jedné aplikaci nikdy nedávejte oprávnění Mail.Send. draften nic neodesílá a bez toho oprávnění to ani nedokáže — to je smysl.
Klient organizace: přihlášení a Připojit Outlook
Klient má delegovaná oprávnění: aplikace smí jen to, co smí přihlášený člověk, a jen do jeho vlastní schránky. Založíte ho jednou; vlastníci schránek se pak připojují sami a správce Entra už nepotřebují.
V Microsoft Entra
Pracujete v Microsoft Entra admin center, https://entra.microsoft.com, přihlášení účtem správce vašeho adresáře Microsoft 365.
- V draftenu si nejdřív otevřete Organizace → Přihlašování a přístup k poště, kartu Přihlášení účtem a připojení schránek. Ukazuje dvě redirect URI přesně pro vaši adresu draftenu — končí na
/auth/callbacka/mailboxes/connect/callback. Zkopírujte je odtud; musí sedět znak po znaku. - Otevřete seznam registrací aplikací: v nabídce vlevo Entra ID → App registrations (ve starší podobě nabídky Identity → Applications → App registrations). Přímo: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
- Nahoře klikněte na + New registration a vyplňte:
- Name — třeba
draften – přihlášení, - Supported account types — Accounts in this organizational directory only (… only - Single tenant),
- Redirect URI — v rozbalovacím seznamu Select a platform zvolte Web a vedle vložte první adresu z karty (končí
/auth/callback).
Klikněte na Register. Otevře se stránka nové aplikace.
- Name — třeba
- Na stránce Overview si zkopírujte Application (client) ID a Directory (tenant) ID (ikona kopírování vedle hodnoty).
- V nabídce aplikace vlevo otevřete Authentication. U platformy Web v části Redirect URIs klikněte na Add URI, vložte druhou adresu z karty (končí
/mailboxes/connect/callback) a dole klikněte na Save. - Certificates & secrets → záložka Client secrets → + New client secret. Description třeba
draften, Expires zvolte platnost (nejvýš 24 měsíců) a klikněte na Add. V tabulce hned zkopírujte hodnotu ze sloupce Value — ukáže se jen teď; Secret ID draften nepotřebuje. Poznamenejte si i datum ve sloupci Expires. - API permissions → + Add a permission → Microsoft Graph → Delegated permissions. Do vyhledávání postupně napište a zaškrtněte
openid,profile,email,offline_access,User.Read,Mail.ReadWriteaMailboxSettings.ReadWritea dole klikněte na Add permissions.User.Readbývá v seznamu už od založení. Bezoffline_accesspřipojení nevydrží — draften by nedostal obnovovací token. - Na téže stránce klikněte na Grant admin consent for … a potvrďte Yes. U všech řádků musí být ve sloupci Status zelená fajfka. Kdyby vaše organizace zakazovala uživatelům souhlasit s aplikacemi, bez tohoto kroku by připojení skončilo hláškou, že byl souhlas odmítnut.
V draftenu
- Vlastník organizace otevře Organizace → Přihlašování a přístup k poště, v kartě Přihlášení účtem a připojení schránek vyplní u Entra registrace pro přihlášení přes Microsoft a připojení Outlooku hodnoty Application (client) ID (krok 4) a Client secret (krok 6) a klikne na Uložit.
- Přihlašování účtem Microsoft zapne na téže stránce v kartě Přihlašování členů: do ID adresáře Microsoft (Entra) vloží Directory (tenant) ID. Jakmile má organizace klienta i ID adresáře, členové se přihlašují účtem Microsoft a jejich hesla přestanou platit — viz Přihlašování členů.
- Vlastník schránky otevře stránku schránky a v kartě Přístup k poště v řádku Připojit účtem schránky: klikne na Připojit Outlook. Přihlásí se účtem té schránky — jiný účet draften odmítne — a povolí přístup. Tlačítko vidí jen vlastník schránky, a jen když organizace klienta má; bez něj karta místo tlačítka napíše, že připojení účtem půjde, až vlastník organizace klienta přidá.
- Pak Otestovat spojení.
Když se schránka odpojí
- Vypršel secret klienta — v Entra otevřete App registrations → registraci klienta (třeba
draften – přihlášení) → Certificates & secrets → + New client secret a zkopírujte Value. V kartě Přihlášení účtem a připojení schránek ho uložte a u schránek klikněte na Znovu připojit Outlook. - Člověk odešel nebo mu byl zablokován účet — Microsoft přestane vydávat tokeny a draften schránku odpojí. Schránku bez vlastního přihlášení připojte registrací organizace (níže).
- „Poskytovatel nevydal obnovovací token“ — klientovi chybí oprávnění
offline_access(krok 7). - „Přihlásil se jiný účet, než je adresa schránky“ — při připojení se přihlaste účtem právě té schránky; kdo má v prohlížeči víc účtů Microsoft, vybere ten správný.
Registrace organizace: přístup bez přihlášení
Registrace má aplikační oprávnění: asistent se dostane do schránky, aniž by se kdokoli přihlašoval. Hodí se pro sdílené schránky a pro organizace, které chtějí přístup ke schránkám spravovat centrálně. S přihlašováním do draftenu nesouvisí.
Potřebujete účet s rolí globální správce nebo správce privilegovaných rolí — jen ten udělí souhlas s aplikačními oprávněními Microsoft Graph. Registraci samotnou může založit i správce aplikací.
V Microsoft Entra
Pracujete v Microsoft Entra admin center, https://entra.microsoft.com.
- Otevřete seznam registrací aplikací: v nabídce vlevo Entra ID → App registrations (ve starší podobě nabídky Identity → Applications → App registrations). Přímo: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
- Nahoře klikněte na + New registration a vyplňte:
- Name — třeba
draften – pošta, - Supported account types — Accounts in this organizational directory only (… only - Single tenant),
- Redirect URI — nechte prázdné.
Klikněte na Register. Otevře se stránka nové aplikace.
- Name — třeba
- Na stránce Overview si zkopírujte Application (client) ID a Directory (tenant) ID (ikona kopírování vedle hodnoty).
- V nabídce aplikace vlevo Certificates & secrets → záložka Client secrets → + New client secret. Description třeba
draften, Expires zvolte platnost (nejvýš 24 měsíců) a klikněte na Add. V tabulce hned zkopírujte hodnotu ze sloupce Value — ukáže se jen teď; Secret ID draften nepotřebuje. Poznamenejte si i datum ve sloupci Expires. - API permissions → + Add a permission → Microsoft Graph → Application permissions (ne Delegated). Do vyhledávání napište a zaškrtněte
Mail.ReadWriteaMailboxSettings.ReadWritea dole klikněte na Add permissions.MailboxSettings.ReadWriteslouží jen k barvě kategorie v Outlooku; bez něj se kategorie přidá bez barvy. Volitelně přidejteUser.Read.All— draften s ním ověří aliasy schránky, bez něj test spojení u aliasů napíše, že je ověřit nemůže. - Na téže stránce klikněte na Grant admin consent for … a potvrďte Yes. U všech řádků musí být ve sloupci Status zelená fajfka.
V draftenu
- Otevřete Organizace → Přihlašování a přístup k poště, kartu Registrace pro sdílené schránky a centrální správu. Registrace spravuje vlastník nebo správce organizace.
- Systém: Microsoft 365 (Entra). Vyplňte Název, Directory (tenant) ID, Application (client) ID, Client secret (hodnotu z kroku 4, ne jeho ID) a Secret vyprší. Klikněte na Přidat registraci. Secret se uloží zašifrovaný a už se nezobrazí.
- Registrace sama nic nepřipojí. Na stránce každé schránky v kartě Přístup k poště vyberte u Registrace organizace tuto registraci, klikněte na Nastavit a pak na Otestovat spojení. Výběr vidí jen ten, kdo je zároveň vlastníkem schránky a vlastníkem nebo správcem organizace (vlastník organizace je vlastníkem všech schránek). Celý postup se snímky ukazuje návod Přidání a připojení schránky.
Se zapnutou automatickou schránkou (Přihlašování členů) se nová schránka na registraci naváže sama, když je pro Microsoft 365 právě jedna aktivní.
Zúžení na vybrané schránky (volitelné)
Aplikační oprávnění dosáhne na všechny schránky adresáře; hlídá to draften (člen nemůže přidat schránku, asistent nic neodesílá ani nemaže). Kdo chce i technický plot, zúží aplikaci na bezpečnostní skupinu zásadou ApplicationAccessPolicy v Exchange Online. Potřebujete PowerShell a roli správce Exchange (nebo globálního správce).
Krok 1 — modul Exchange Online. Jednou ho nainstalujte: PowerShell spusťte jako správce počítače a zadejte:
Install-Module ExchangeOnlineManagement
Krok 2 — skupina a zásada. Přihlaste se k Exchange Online, založte bezpečnostní skupinu se schránkami, na které smí draften sahat, a zásadu, která aplikaci omezí jen na ni. Za <Application (client) ID> dosaďte ID registrace z kroku 3 výše, za adresy své schránky:
Connect-ExchangeOnline -UserPrincipalName admin@<tenant>.onmicrosoft.com
New-DistributionGroup -Name "draften - povolené schránky" -Alias draften-schranky -Type Security -Members schranka@firma.cz
New-ApplicationAccessPolicy -AppId <Application (client) ID> -PolicyScopeGroupId draften-schranky@firma.cz -AccessRight RestrictAccess -Description "draften: jen povolené schránky"
Krok 3 — ověření. U schránky ve skupině má příkaz vypsat AccessCheckResult : Granted, u schránky mimo skupinu Denied:
Test-ApplicationAccessPolicy -Identity schranka@firma.cz -AppId <Application (client) ID>
Další schránku pak přidáte do skupiny v Exchange admin center (https://admin.exchange.microsoft.com → Recipients → Groups), nebo příkazem Add-DistributionGroupMember -Identity draften-schranky@firma.cz -Member dalsi@firma.cz. Schránka mimo skupinu skončí v testu spojení chybou 403 (AppOnly AccessPolicy). Zásada se projeví obvykle do hodiny; viděli jsme i čtyři hodiny. Microsoft nabízí jako novější alternativu RBAC for Applications v Exchange Online; ten zatím nepopisujeme.
Výměna secretu
Secret má omezenou platnost a draften o jeho konci neposílá žádné upozornění — datum v kartě zežloutne 30 dní před vypršením a po něm zčervená. Dejte si připomínku do kalendáře. Před vypršením:
- V Entra otevřete App registrations → vaši registraci (třeba
draften – pošta) → Certificates & secrets → + New client secret a zkopírujte novou Value (jako v kroku 4 výše). - V draftenu v Organizace → Přihlašování a přístup k poště u registrace zvolte Nový secret, vložte novou hodnotu a nové datum.
- Starý secret v Entra smažte ikonou koše na jeho řádku.
Když secret vyprší dřív, schránky se odpojí (invalid_client) a asistenti je přeskakují. Po výměně secretu spusťte u schránek Otestovat spojení — úspěšný test schránku zase zapne.
Chyby testu spojení
Test ověří tři kroky: Přístup, Token a oprávnění a Čtení Inboxu. U každého je fajfka, nebo křížek s důvodem:
| V hlášce | Co to znamená | Co udělat |
|---|---|---|
AADSTS7000215, AADSTS7000222, invalid_client | špatný nebo prošlý client secret | vytvořit nový secret a uložit ho v draftenu |
AADSTS700016, AADSTS90002, unauthorized_client | špatné Application ID nebo Directory ID | opsat obě ID znovu z Overview |
AADSTS65001, AADSTS650057, consent_required | chybí souhlas správce | Grant admin consent u aplikace |
token bez Mail.ReadWrite | oprávnění chybí nebo není odsouhlasené | přidat oprávnění a udělit souhlas |
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008 | připojení účtem vypršelo nebo bylo odvoláno | Znovu připojit Outlook |
HTTP 403 AppOnly AccessPolicy | schránka není ve skupině zásady přístupu | přidat ji do skupiny a počkat |
| HTTP 404 | taková schránka neexistuje | zkontrolovat adresu; schránka musí mít Exchange Online |
| HTTP 401 | jiný adresář, nebo chybí oprávnění | zkontrolovat Directory ID a oprávnění |
Další chyby popisuje Řešení potíží.