UniNotes per gli amministratori IT
Come approvare UniNotes nel tenant Microsoft Entra dell'ateneo, e che cosa fa con i permessi richiesti.
In breve
Che cos'è UniNotes
UniNotes è un'app per chi studia all'università: appunti, registrazioni delle lezioni, libri ed esami. È gratuita e senza pubblicità, per Windows, macOS, Android e iPhone, con il codice pubblico su GitHub. Gli studenti possono collegare il proprio account Microsoft per sincronizzare i file con OneDrive, leggere i blocchi appunti OneNote e, su Windows, scrivere le date degli esami nel calendario Outlook.
816cebbf-da52-4012-8379-d5ab7deedc8e
L'ID applicazione non è disponibile in questa copia della pagina. In Entra admin center lo trovi cercando «UniNotes» in Applicazioni aziendali.
La registrazione è multi-tenant con account Microsoft personali (tenant common), come client pubblico con PKCE: non ha segreti client e chiede solo permessi delegati, quindi agisce sempre come lo studente che ha fatto l'accesso e solo sui suoi dati. Nessun permesso di applicazione.
Editore non verificato. La verifica dell'editore di Microsoft richiede un account del Microsoft AI Cloud Partner Program intestato a un ente legale e un dominio verificato. UniNotes è un progetto personale, senza ente legale né dominio proprio: per questo Microsoft lo mostra come non verificato e molti atenei non permettono agli studenti di dargli il consenso da soli.
Come approvare
Consenso amministratore
1. Con un clic, per tutto il tenant
Accedi con un account amministratore del tenant dell'ateneo (Amministratore applicazioni cloud, Amministratore applicazioni o Amministratore ruoli con privilegi), controlla i permessi e scegli Accetta. Microsoft torna poi su questa pagina con l'esito.
Concedi il consenso amministratore
Il link non è disponibile senza l'ID applicazione: usa il passo 2.
Il link usa l'endpoint /organizations/v2.0/adminconsent con i permessi elencati qui sotto, compreso Calendars.ReadWrite, così l'approvazione copre anche il calendario su Windows.
2. Da Microsoft Entra admin center
- Apri entra.microsoft.com → Identità → Applicazioni → Applicazioni aziendali e cerca UniNotes.
- Autorizzazioni → Concedi il consenso amministratore per il tenant dell'ateneo.
UniNotes compare tra le applicazioni aziendali dopo il primo tentativo di accesso di uno studente dell'ateneo. Se non c'è, usa il link del passo 1, che la aggiunge.
3. Lasciare che gli studenti chiedano l'approvazione
Con il flusso di lavoro di consenso amministratore, lo studente bloccato vede nella pagina di accesso Microsoft il pulsante Richiedi approvazione e la richiesta arriva ai revisori che scegli.
- Entra admin center → Applicazioni aziendali → Consenso e autorizzazioni → Impostazioni del consenso amministratore.
- Attiva Gli utenti possono richiedere il consenso amministratore per le app a cui non possono concedere il consenso.
- Scegli i revisori (utenti, gruppi o ruoli), le notifiche e la scadenza delle richieste, poi Salva.
- Le richieste compaiono in Applicazioni aziendali → Richieste di consenso amministratore.
Se in Proprietà dell'applicazione aziendale è attiva Assegnazione obbligatoria, assegna gli studenti o un gruppo in Utenti e gruppi, altrimenti l'accesso fallisce con l'errore AADSTS50105.
Permessi richiesti
Permessi delegati di Microsoft Graph
| Permesso | Che cosa ne fa UniNotes |
|---|---|
User.Read | Legge nome e indirizzo dell'account, per mostrare allo studente quale account è collegato. |
Files.ReadWrite | Elenca le cartelle quando lo studente sceglie dove sincronizzare e legge e scrive nella cartella scelta (predefinita «UniNotes»): appunti, registrazioni delle lezioni, trascrizioni, libri, materiali e un backup dei dati dell'app. Non tocca altri file. |
Notes.Read | Mostra in sola lettura i blocchi appunti OneNote dello studente. Il contenuto non viene salvato dall'app. |
offline_access | Mantiene il collegamento senza chiedere l'accesso ogni volta (refresh token conservato sul dispositivo). |
Calendars.ReadWrite | Solo nell'app per Windows, chiesto a parte quando lo studente attiva il calendario: crea un calendario «UniNotes» in Outlook con le date degli esami e i promemoria, e aggiorna o toglie solo i propri eventi. |
Dove vanno i dati
Nessun server di UniNotes
- L'app comunica direttamente con
login.microsoftonline.comegraph.microsoft.com: i dati non passano dallo sviluppatore, che non ha server. - I token restano sul dispositivo, nell'archivio protetto del sistema (Gestione credenziali di Windows, Portachiavi di macOS e iOS, Keystore di Android). Non finiscono in backup, esportazioni o sincronizzazioni. La password resta nella pagina di accesso di Microsoft.
- I file stanno sul dispositivo e nell'OneDrive dello studente, cioè nello spazio gestito dall'ateneo con le sue regole.
- Nessuna statistica d'uso, pubblicità o segnalazione automatica degli errori.
I dettagli sono nell'informativa sulla privacy.
Come revocare
Togliere l'approvazione
- Entra admin center → Applicazioni aziendali → UniNotes → Proprietà: Abilitato per l'accesso degli utenti su No blocca subito ogni accesso.
- Nella stessa pagina, Elimina toglie l'applicazione aziendale con il consenso concesso; i token già emessi non si rinnovano più.
- Il singolo studente può scollegarsi dall'app (Collegamenti → OneDrive → Scollega) e togliere le autorizzazioni da myapps.microsoft.com.
I file già sincronizzati restano nell'OneDrive dello studente.
English
For IT administrators
UniNotes is a free, ad-free app for university students (Windows, macOS, Android, iOS) with its source code public on GitHub. It is registered in Microsoft Entra as a multi-tenant public client with PKCE (no client secret) and requests delegated Microsoft Graph permissions only: User.Read (account name), Files.ReadWrite (sync the folder the student picks in their OneDrive), Notes.Read (read-only OneNote notebooks), offline_access, and, on Windows only and requested separately, Calendars.ReadWrite (an «UniNotes» Outlook calendar with exam dates).
The publisher is unverified because publisher verification requires a legal entity and a verified domain, which this personal project does not have. There is no UniNotes server: the app talks directly to Microsoft, tokens stay in the device's secure storage and files stay on the device and in the student's OneDrive.
Application (client) ID: 816cebbf-da52-4012-8379-d5ab7deedc8e. To approve it for your tenant, use the orange admin consent button above (v2.0 /organizations/adminconsent endpoint), or Entra admin center → Enterprise applications → UniNotes → Permissions → Grant admin consent. To let students request approval themselves, enable the admin consent workflow (Enterprise applications → Consent and permissions → Admin consent settings). To revoke, disable «Enabled for users to sign in?» or delete the enterprise application.