Pro administrátory
← Na rozcestník

Microsoft 365: připojení schránek

Připojení účtem schránky (klient organizace), navíc registrace pro sdílené schránky — a co přesně nastavit v Microsoft Entra, krok za krokem.

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 chceteCo nastavit
Členové se přihlašují účtem Microsoft a každý má vlastní schránkuklient 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 nechcetelidé 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 organizaceRegistrace 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ánkypřístup asistenta ke schránkám bez přihlášení jejich vlastníků
Kde v draftenuOrganizace → Přihlašování a přístup k poště → karta Přihlášení účtem a připojení schránekOrganizace → 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 nastavujevlastník organizacevlastník nebo správce organizace
Oprávnění v Entradelegovaná (Delegated)aplikační (Application)
Kdo se ke schránce přihlašujevlastník každé schránky, jednounikdo
Na které schránky dosáhnejen na ty, které si lidé sami připojína schránky adresáře (jde zúžit)
Sdílené schránkyne — nemají vlastní přihlášeníano
Když člověk z firmy odejdepo 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.

  1. 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/callback a /mailboxes/connect/callback. Zkopírujte je odtud; musí sedět znak po znaku.
  2. 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
  3. 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.

  4. Na stránce Overview si zkopírujte Application (client) ID a Directory (tenant) ID (ikona kopírování vedle hodnoty).
  5. 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.
  6. 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.
  7. 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.ReadWrite a MailboxSettings.ReadWrite a dole klikněte na Add permissions. User.Read bývá v seznamu už od založení. Bez offline_access připojení nevydrží — draften by nedostal obnovovací token.
  8. 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

  1. 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.
  2. 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ů.
  3. 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á.
  4. Pak Otestovat spojení.

Když se schránka odpojí

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.

  1. 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
  2. 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.

  3. Na stránce Overview si zkopírujte Application (client) ID a Directory (tenant) ID (ikona kopírování vedle hodnoty).
  4. 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.
  5. API permissions → + Add a permission → Microsoft Graph → Application permissions (ne Delegated). Do vyhledávání napište a zaškrtněte Mail.ReadWrite a MailboxSettings.ReadWrite a dole klikněte na Add permissions. MailboxSettings.ReadWrite slouží jen k barvě kategorie v Outlooku; bez něj se kategorie přidá bez barvy. Volitelně přidejte User.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.
  6. 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

  1. 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.
  2. 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í.
  3. 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:

  1. 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).
  2. 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.
  3. 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ášceCo to znamenáCo udělat
AADSTS7000215, AADSTS7000222, invalid_clientšpatný nebo prošlý client secretvytvořit nový secret a uložit ho v draftenu
AADSTS700016, AADSTS90002, unauthorized_clientšpatné Application ID nebo Directory IDopsat obě ID znovu z Overview
AADSTS65001, AADSTS650057, consent_requiredchybí souhlas správceGrant admin consent u aplikace
token bez Mail.ReadWriteoprávnění chybí nebo není odsouhlasenépřidat oprávnění a udělit souhlas
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008připojení účtem vypršelo nebo bylo odvolánoZnovu připojit Outlook
HTTP 403 AppOnly AccessPolicyschránka není ve skupině zásady přístupupřidat ji do skupiny a počkat
HTTP 404taková schránka neexistujezkontrolovat adresu; schránka musí mít Exchange Online
HTTP 401jiný adresář, nebo chybí oprávněnízkontrolovat Directory ID a oprávnění

Další chyby popisuje Řešení potíží.

Textová verze