Návod pre IT: Outlook kalendár (Microsoft 365)
Tento návod je pre správcu Microsoft 365 vo vašej firme. Prejdete ho raz, za približne 30 minút práce a do 2 hodín čakania, kým Exchange zmeny uplatní. Na konci odovzdáte administrátorovi KwargsAI tri údaje a ten kalendár pripojí v Knižnici.
Čo KwargsAI s kalendárom robí: číta udalosti jedného kalendára jednej schránky (napríklad servis@) cez Microsoft Graph, ako aplikácia bez prihláseného používateľa. Nič nezapisuje, nečíta poštu a súkromné udalosti vynechá. Postup nižšie zabezpečí, že aplikácia technicky nemá prístup k žiadnemu inému kalendáru vo firme.
Čo budete potrebovať
Section titled “Čo budete potrebovať”- Účet globálneho administrátora Microsoft 365 (alebo kombináciu rolí Application Administrator v Entra a Exchange Administrator).
- Zdieľanú schránku, ktorej kalendár chcete napojiť, napríklad
servis@vasafirma.sk. Zdieľaná schránka nepotrebuje licenciu. - PowerShell s modulom Exchange Online (krok 5 popisuje, ako ho spustiť na Windows aj na Macu).
1. Zdieľaná schránka
Section titled “1. Zdieľaná schránka”Ak ju už máte, pokračujte krokom 2.
- Microsoft 365 admin center → Teams a skupiny → Zdieľané poštové schránky → Pridať zdieľanú poštovú schránku.
- Názov napríklad Servis, e-mail
servis@vasafirma.sk. - V detaile schránky pridajte členov, ktorí do kalendára zapisujú.
2. Registrácia aplikácie v Microsoft Entra
Section titled “2. Registrácia aplikácie v Microsoft Entra”- Microsoft Entra admin center → Applications → App registrations → New registration.
- Name:
KwargsAI. Supported account types: Accounts in this organizational directory only (Single tenant). Redirect URI: nechajte prázdne. → Register. - Z prehľadu aplikácie si zapíšte:
- Application (client) ID
- Directory (tenant) ID
Ak už aplikáciu KwargsAI máte (napríklad pre SharePoint), použite tú istú a pokračujte krokom 3.
3. Oprávnenie a súhlas správcu
Section titled “3. Oprávnenie a súhlas správcu”- V aplikácii API permissions → Add a permission → Microsoft Graph → Application permissions.
- Vyhľadajte a zaškrtnite
Calendars.Read→ Add permissions. - Kliknite Grant admin consent for <vaša firma> a potvrďte.
- Skontrolujte, že pri
Calendars.Readje v stĺpci Status zelená fajka „Granted for …“. Bez súhlasu správcu KwargsAI hlási, že aplikácia nemá prístup ku kalendáru.
Iné oprávnenie kalendár nepotrebuje: nie Mail.Read, nie Calendars.ReadWrite.
4. Client secret
Section titled “4. Client secret”- V aplikácii Certificates & secrets → Client secrets → New client secret.
- Description: napríklad
KwargsAI. Expires: 12 alebo 24 mesiacov → Add. - Hneď skopírujte stĺpec Value (nie Secret ID). Po opustení stránky sa už nezobrazí.
- Uložte ho do správcu hesiel a odovzdajte ho administrátorovi KwargsAI bezpečným spôsobom (nie e-mailom v čitateľnej podobe). Zapíšte si aj dátum vypršania.
5. Obmedzenie aplikácie na jednu schránku (Exchange)
Section titled “5. Obmedzenie aplikácie na jednu schránku (Exchange)”Spustenie PowerShellu
Section titled “Spustenie PowerShellu”- Windows: otvorte PowerShell (alebo Windows Terminal).
- Mac: nainštalujte PowerShell z
github.com/PowerShell/PowerShell/releases
(stabilná verzia, súbor
osx-arm64.pkgpre Mac s čipom M,osx-x64.pkgpre Intel) a v Termináli spustitepwsh.
Pripojenie k Exchange Online
Section titled “Pripojenie k Exchange Online”Install-Module ExchangeOnlineManagement -Scope CurrentUser -ForceConnect-ExchangeOnline -UserPrincipalName admin@vasafirma.skOtvorí sa prihlásenie v prehliadači. Potom overte, že ste v správnej organizácii:
Get-AcceptedDomain | Select-Object DomainNameVo výpise musí byť vaša doména (napríklad vasafirma.sk alebo vasafirma.onmicrosoft.com).
Zapnutie prispôsobenia organizácie (len pri nových alebo malých tenantoch)
Section titled “Zapnutie prispôsobenia organizácie (len pri nových alebo malých tenantoch)”Enable-OrganizationCustomizationAk vypíše, že je už zapnuté, pokračujte. Ak ho práve zapínate, ďalšie kroky spustite až o niekoľko hodín: kým sa zmena v Exchange nerozšíri, obmedzenia nemusia platiť, aj keď sa vytvoria bez chyby.
Skupina so schránkou a politika prístupu
Section titled “Skupina so schránkou a politika prístupu”Vytvorte bezpečnostnú skupinu, v ktorej je len zdieľaná schránka, a obmedzte na ňu aplikáciu
(v príkazoch nahraďte adresy a <client-id> hodnotou z kroku 2):
New-DistributionGroup -Name "KwargsAI kalendar" -Alias KwargsAIkalendar -Type Security -Members servis@vasafirma.sk
New-ApplicationAccessPolicy -AppId "<client-id>" -PolicyScopeGroupId "KwargsAIkalendar@vasafirma.sk" -AccessRight RestrictAccess -Description "KwargsAI: len kalendar servis@"Skupinu zadávajte e-mailovou adresou, nie názvom: názov môže zodpovedať viacerým objektom.
Overte, že politika existuje:
Get-ApplicationAccessPolicy | Format-List AppId, ScopeName, AccessRightExchange politiku uplatní do 30 minút až 2 hodín.
6. Odovzdanie do KwargsAI
Section titled “6. Odovzdanie do KwargsAI”Administrátorovi KwargsAI odovzdajte:
| Údaj | Odkiaľ |
|---|---|
| Directory (tenant) ID | krok 2 |
| Application (client) ID | krok 2 |
| Client secret (Value) | krok 4, bezpečne |
| Adresa zdieľanej schránky | krok 1 |
Administrátor ich zadá v Knižnica → priečinok typu Dáta → Konektory → Outlook kalendár (postup). KwargsAI pri pripojení overí prístup a pri chybe ukáže presný dôvod.
7. Overenie, že obmedzenie platí
Section titled “7. Overenie, že obmedzenie platí”Po uplynutí času z kroku 5 overte obe strany:
Test-ApplicationAccessPolicy -Identity servis@vasafirma.sk -AppId "<client-id>"Test-ApplicationAccessPolicy -Identity riaditel@vasafirma.sk -AppId "<client-id>"Prvý príkaz má vrátiť AccessCheckResult : Granted, druhý Denied.
Riešenie problémov
Section titled “Riešenie problémov”| Hlásenie alebo príznak | Príčina | Riešenie |
|---|---|---|
| KwargsAI: „Microsoft 365 neprijal prihlasovacie údaje“ | zlý tenant ID, client ID alebo client secret, prípadne secret vypršal | skontrolujte hodnoty z krokov 2 a 4, vytvorte nový secret |
| KwargsAI: „Aplikácia nemá prístup ku kalendáru schránky“ pri schránke, ktorú chcete napojiť | chýba súhlas správcu alebo schránka nie je v skupine z kroku 5 | krok 3 (Granted for …), členstvo v skupine; po zmene počkajte do 2 hodín |
| KwargsAI: „Schránka sa nenašla“ | preklep v adrese alebo schránka neexistuje | skontrolujte adresu v Microsoft 365 admin center |
| API permissions: „Not granted for …“ | súhlas správcu nebol udelený | Grant admin consent (krok 3) |
| PowerShell: „The term ‘…’ is not recognized as a name of a cmdlet“ | nie ste pripojený k Exchange Online | Connect-ExchangeOnline |
| PowerShell: „The command you tried to run isn’t currently allowed in your organization… Enable-OrganizationCustomization“ | nový alebo malý tenant | Enable-OrganizationCustomization, potom počkajte niekoľko hodín |
| PowerShell: „There are multiple recipients matching identity …“ | skupina s týmto názvom už existuje | použite existujúcu, zadávajte ju e-mailovou adresou |
Get-ApplicationAccessPolicy: „…couldn’t be found on …“ |
v organizácii nie je žiadna politika (napríklad sa nevytvorila pred zapnutím prispôsobenia) | vytvorte politiku znova (krok 5) a overte výpisom |
| Azure Cloud Shell: „A parameter cannot be found that matches parameter name ‘UserPrincipalName’“ | upravený modul v Cloud Shelli | použite PowerShell na počítači |
| Kalendár inej schránky sa v KwargsAI pripojí | politika ešte neplatí alebo neexistuje | kalendár odpojte, priečinok zmažte, skontrolujte krok 5 a počkajte |
Údržba
Section titled “Údržba”- Obnova client secretu: pred vypršaním vytvorte v Entra nový secret (krok 4), administrátor KwargsAI ho zadá v Administrácia → Integrácie → Prihlasovacie údaje → Obnoviť tajomstvo, potom starý secret v Entra zmažte. Ak administrátor pri prihlasovacích údajoch vyplní Platnosť tajomstva do, KwargsAI ho 30 dní vopred upozorní.
- Ďalšia schránka: pridajte ju do skupiny z kroku 5
(
Add-DistributionGroupMember -Identity KwargsAIkalendar@vasafirma.sk -Member druha@vasafirma.sk) a v KwargsAI ju pripojte do samostatného dátového priečinka. - Ukončenie: v KwargsAI kalendár odpojte, v Entra zmažte aplikáciu KwargsAI (alebo z nej
odstráňte
Calendars.Read) a v Exchange odstráňte politiku (Remove-ApplicationAccessPolicy) a skupinu.