S tím, jak Microsoft vylepšuje svůj stav zabezpečení ve všech produktech a službách, došlo nedávno ke změnám funkcí rozhraní API, které mohou mít dopad na zákazníky, kteří se dříve při zřizování poznámkových bloků předmětů pomocí rozhraní API spoléhali na oprávnění pouze pro aplikace.
Weby a poznámkové bloky můžete dál zřizovat ve velkém měřítku pomocí rozhraní Microsoft Graph API pomocí podporované alternativní metody. Tento článek popisuje jednotlivé kroky a poskytuje odkazy na příslušnou dokumentaci.
Přehled
Jak pokračovat ve zřizování poznámkových bloků předmětů a sharepointových webů ve velkém měřítku:
- Použití rozhraní API CreateEducationClass při vytváření nových webů (jedna skupina nebo web na třídu)
- U již existujících webů udělte Onenotovým poznámkovým blokům předmětů oprávnění AppId pomocí rozhraní API CreatePermission služby SharePoint.
- Po dokončení výše uvedených kroků by se měly obnovit stávající funkce poznámkového bloku předmětu a volání rozhraní API, jako jsou GetClassNotebooks, AddTeacher a addStudent , by měla fungovat podle očekávání.
Podrobné pokyny
1. Vytvářejte nové weby pomocí CreateEducationClass
Pomocí rozhraní API CreateEducationClass vytvořte novou skupinu Microsoft 365 a přidružený sharepointový web pro každou třídu.
- Toto rozhraní API zřídí skupinu, web a přidružené prostředky v jednom volání.
- Po vytvoření webu můžete ke správě poznámkových bloků a oprávnění používat existující rozhraní API.
Odkaz: Dokumentace k rozhraní API CreateEducationClass
2. Udělení oprávnění stávajícím webům
U stávajících skupin nebo webů musíte aplikaci Poznámkový blok předmětu explicitně udělit přístup pomocí modelu oprávnění Sites.Selected .
Požadovaná oprávnění
- Přístup pouze k aplikacím pomocí oboru Sites.Selected.
- Udělte aplikaci EDU OneNote úplné řízení webu.
Ukázková žádost
| POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //ID klienta cílové aplikace "displayName": "EDU OneNote" //zobrazovaný název cílové aplikace } }] } |
|---|
Odkazy:
Vytvoření rozhraní API pro oprávnění
Vyvíjejte aplikace, které používají službu Sites.Selected oprávnění pro weby SharePointu Online
3. Použití existujících rozhraní API pro správu poznámkových bloků
Po správné konfiguraci oprávnění by měly existující funkce poznámkového bloku předmětu, jako jsou například následující rozhraní API, dál fungovat jako předtím:
GetClassNotebooks
PřidatUčitel
PřidatStudenta
Funkce CreateClassNotebook
- Poznámka: Jak je popsáno výše, pro nové skupiny nebo weby místo toho použijte CreateEducationClass