Poiché Microsoft migliora il proprio approccio alla sicurezza in tutti i prodotti e i servizi, di recente sono state apportate modifiche alla funzionalità API che potrebbero influire sui clienti che in precedenza si affidavano alle autorizzazioni solo delle app per il provisioning dei blocchi appunti per la classe tramite le API.
È comunque possibile eseguire il provisioning di siti e blocchi appunti su vasta scala usando le API Microsoft Graph seguendo un metodo alternativo supportato. Questo articolo illustra i passaggi e fornisce i collegamenti alla documentazione pertinente.
Panoramica
Per continuare a eseguire il provisioning dei blocchi appunti della classe e dei siti di SharePoint su vasta scala:
- Usare l'API CreateEducationClass quando si creano nuovi siti (un gruppo/sito per classe)
- Per i siti preesistenti, usare l'API CreatePermission di SharePoint per concedere autorizzazioni AppId blocco appunti di OneNote per la classe a tale sito.
- Una volta completata la procedura precedente, è necessario ripristinare le funzionalità esistenti di Blocco appunti per la classe e le chiamate API come GetClassNotebooks, AddTeacher e addStudent dovrebbero funzionare come previsto.
Istruzioni dettagliate
1. Creare nuovi siti con CreateEducationClass
Usare l'API CreateEducationClass per creare un nuovo gruppo di Microsoft 365 e un sito di SharePoint associato per ogni classe.
- Questa API esegue il provisionsing delle risorse del gruppo, del sito e delle risorse associate in un'unica chiamata.
- Dopo aver creato il sito, è possibile usare le API esistenti per gestire blocchi appunti e autorizzazioni.
Riferimento: documentazione api CreateEducationClass
2. Concedere autorizzazioni a siti esistenti
Per i gruppi o i siti esistenti, è necessario concedere in modo esplicito l'accesso all'app Blocco appunti per la classe usando il modello di autorizzazione Sites.Selected .
Autorizzazioni necessarie
- Accesso solo alle app usando l'ambito Sites.Selected.
- Concedere all'app OneNote EDU il controllo completo sul sito.
Richiesta di esempio
| POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //Target Application's Client Id "displayName": "EDU OneNote" //Target Application's Display name } }] } |
|---|
Riferimenti:
Creare un'API di autorizzazione
Sviluppare applicazioni che usano Siti.Autorizzazioni selezionate per i siti di SharePoint Online
3. Usare API esistenti per la gestione dei blocchi appunti
Dopo aver configurato correttamente le autorizzazioni, le funzionalità esistenti di Blocco appunti per la classe, ad esempio le API seguenti, dovrebbero continuare a funzionare come prima:
GetClassNotebooks
AddTeacher
AggiungiStudent
CreateClassNotebook
- Nota: come descritto in precedenza, per i nuovi gruppi/siti, usa CreateEducationClass