Preskočiť na obsah

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.

  • Úč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).

Ak ju už máte, pokračujte krokom 2.

  1. Microsoft 365 admin center → Teams a skupiny → Zdieľané poštové schránky → Pridať zdieľanú poštovú schránku.
  2. Názov napríklad Servis, e-mail servis@vasafirma.sk.
  3. 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”
  1. Microsoft Entra admin center → Applications → App registrations → New registration.
  2. Name: KwargsAI. Supported account types: Accounts in this organizational directory only (Single tenant). Redirect URI: nechajte prázdne. → Register.
  3. 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.

  1. V aplikácii API permissions → Add a permission → Microsoft Graph → Application permissions.
  2. Vyhľadajte a zaškrtnite Calendars.Read → Add permissions.
  3. Kliknite Grant admin consent for <vaša firma> a potvrďte.
  4. Skontrolujte, že pri Calendars.Read je 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.

  1. V aplikácii Certificates & secrets → Client secrets → New client secret.
  2. Description: napríklad KwargsAI. Expires: 12 alebo 24 mesiacov → Add.
  3. Hneď skopírujte stĺpec Value (nie Secret ID). Po opustení stránky sa už nezobrazí.
  4. 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)”
  • Windows: otvorte PowerShell (alebo Windows Terminal).
  • Mac: nainštalujte PowerShell z github.com/PowerShell/PowerShell/releases (stabilná verzia, súbor osx-arm64.pkg pre Mac s čipom M, osx-x64.pkg pre Intel) a v Termináli spustite pwsh.
Terminal window
Install-Module ExchangeOnlineManagement -Scope CurrentUser -Force
Connect-ExchangeOnline -UserPrincipalName admin@vasafirma.sk

Otvorí sa prihlásenie v prehliadači. Potom overte, že ste v správnej organizácii:

Terminal window
Get-AcceptedDomain | Select-Object DomainName

Vo 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)”
Terminal window
Enable-OrganizationCustomization

Ak 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):

Terminal window
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:

Terminal window
Get-ApplicationAccessPolicy | Format-List AppId, ScopeName, AccessRight

Exchange politiku uplatní do 30 minút až 2 hodín.

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.

Po uplynutí času z kroku 5 overte obe strany:

Terminal window
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.

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
  • 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.