Návod pre IT: Microsoft 365

Konektor SharePoint / OneDrive číta dokumenty cez Microsoft Graph ako aplikácia (bez prihláseného používateľa). Potrebuje registráciu aplikácie v Microsoft Entra ID.

1. Registrácia aplikácie

1. Microsoft Entra admin center → Applications → App registrations → New registration.
2. Názov napr. KwargsAI, typ účtu Accounts in this organizational directory only, bez redirect URI.
3. Poznačte si Application (client) ID a Directory (tenant) ID z prehľadu aplikácie.

2. Oprávnenia

API permissions → Add a permission → Microsoft Graph → Application permissions.

Odporúčame Sites.Selected: aplikácia potom číta len stránky, ktoré jej výslovne pridelíte. Alternatíva Sites.Read.All dáva čítanie všetkých stránok v tenante; použite ju len vtedy, ak je to pre vás prijateľné.

Potom kliknite na Grant admin consent.

Pridelenie konkrétnych stránok (pri Sites.Selected)

Každú stránku, z ktorej chcete konektor používať, musí aplikácii prideliť administrátor, napríklad cez PnP PowerShell:

Grant-PnPAzureADAppSitePermission -AppId "<client-id>" -DisplayName "KwargsAI" `
  -Site "https://firma.sharepoint.com/sites/HR" -Permissions Read

alebo cez Microsoft Graph (POST /sites/{site-id}/permissions s rolou read).

Upozornenie

Pri Sites.Selected musí mať konektor v kwargs zadané konkrétne adresy. Stránka, ktorá nie je aplikácii pridelená, skončí chybou synchronizácie „access denied“.

3. Client secret

Certificates & secrets → Client secrets → New client secret. Skopírujte Value (nie Secret ID) hneď, neskôr sa už nezobrazí. Zapamätajte si dátum platnosti (najviac 24 mesiacov) a zadajte ho v kwargs do Platnosť tajomstva do, aby sme vás včas upozornili.

4. Zadanie v kwargs

Knižnica → priečinok → Konektory → Pridať konektor → SharePoint / OneDrive → Nové prihlasovacie údaje: Directory (tenant) ID, Application (client) ID a client secret. V rozsahu zadajte adresy stránky, knižnice alebo priečinka, napr.:

https://firma.sharepoint.com/sites/HR/Shared Documents/Smernice

Tie isté prihlasovacie údaje potom vyberiete pri ďalších konektoroch, netreba ich zadávať znova.

Obnova tajomstva

Pred vypršaním vytvorte nový client secret a v kwargs ho zadajte v Administrácia → Konektory → Prihlasovacie údaje → Obnoviť tajomstvo. Starý secret potom v Entra zmažte.