Configurare OneDrive e Dropbox (registrazione app personale)
Ultimo aggiornamento: 2026-07-11
Normalmente non hai bisogno di questa pagina: Plainva fornisce già i propri ID app per OneDrive e Dropbox — scegli il provider, fai clic su Connetti e accedi. Questa guida serve solo per il caso facoltativo in cui vuoi usare una tua registrazione app (gratuita), ad es. per restrizioni aziendali. Nelle impostazioni di sincronizzazione mostri i campi ID tramite Usa il tuo ID applicazione, poi inserisci un unico valore pubblico:
- OneDrive → un ID client (formato
00000000-0000-0000-0000-000000000000) - Dropbox → una App Key (una breve stringa)
Entrambe le registrazioni sono gratuite, senza carta di credito e senza abbonamento a pagamento. Non ti serve nessuna password segreta (client secret) — i valori sopra sono pubblici e possono essere memorizzati senza rischi.
Questa pagina è l’approfondimento dettagliato delle versioni brevi in Configurare la sincronizzazione.
Gli ID inclusi in Plainva sono già precompilati — le Parti A/B qui sotto ti servono solo per una tua registrazione personale.
Parte A — OneDrive (Microsoft Entra)
Prerequisito: un account Microsoft (lo stesso il cui OneDrive vuoi sincronizzare). Al primo accesso Microsoft crea automaticamente una directory gratuita per te — non serve alcun abbonamento Azure.
1. Apri il portale
- Vai su entra.microsoft.com (funziona anche
portal.azure.com). - Accedi con il tuo account Microsoft.
2. Crea una nuova registrazione app
-
Menu Identità → Applicazioni → Registrazioni app, poi + Nuova registrazione.
-
Nome: scelta libera, ad es.
Plainva(solo a scopo di visualizzazione). -
Tipi di account supportati: scegli “Account in qualsiasi directory organizzativa … e account Microsoft personali”. Solo questa opzione corrisponde all’endpoint di accesso di Plainva; “solo questa directory” fa fallire gli account OneDrive personali.
-
URI di reindirizzamento — fai subito questo passaggio qui:
- Piattaforma: “Client pubblico/nativo (mobile e desktop)”.
- Valore:
http://localhost(esattamente così — senza porta, senza barra finale).
⚠️ Non scegliere “Web” o “SPA”. “Web” richiede un client secret e l’accesso fallirà.
-
Registra.
3. Copia l’ID client
Nella Panoramica dell’app, copia il valore “ID applicazione (client)” — questo è il tuo valore per Plainva. (Non ti serve l‘“ID directory (tenant)”.)
4. Consenti i flussi client pubblici
- Menu Autenticazione.
- In fondo alla pagina, imposta “Consenti flussi client pubblici” su Sì.
- Salva.
5. Imposta le autorizzazioni
- Menu Autorizzazioni API → + Aggiungi un’autorizzazione → Microsoft Graph → Autorizzazioni delegate.
- Spunta entrambe:
Files.ReadWriteoffline_access(fornisce il token di accesso di lunga durata — senza questo Plainva rifiuta di connettersi)
- Aggiungi. Il consenso dell’amministratore non è necessario per gli account personali; lo dai tu stesso al momento dell’accesso.
Inseriscilo in Plainva
- Impostazioni → Vault → Sincronizzazione.
- Imposta il Provider di sincronizzazione su OneDrive.
- Incolla l’ID applicazione copiato nel campo ID client; facoltativamente imposta la Cartella OneDrive (nome) (predefinita
Plainva). - Connetti a Microsoft → accedi nel browser e conferma l’accesso. Il browser ti dirà poi che puoi chiudere la finestra.
Parte B — Dropbox
Prerequisito: un account Dropbox.
1. Apri la console dell’app
- Vai su dropbox.com/developers/apps e accedi.
- Clicca su Create app.
2. Scegli il tipo di app
-
Choose an API: Scoped access.
-
Type of access: Full Dropbox — non “App folder”.
⚠️ Full Dropbox è obbligatorio: “App folder” vede solo una sottocartella isolata e non troverà i vault esistenti altrove nel tuo Dropbox.
-
Name: un nome univoco a livello globale, ad es.
Plainva-Sync-<tuonome>(solo tecnico, nessun altro lo vede). -
Create app.
3. Registra l’URI di reindirizzamento
Scheda Settings → OAuth 2 → Redirect URIs: inserisci esattamente http://127.0.0.1:41953 e clicca su Add.
⚠️ Deve corrispondere carattere per carattere:
127.0.0.1(nonlocalhost), porta41953, senza barra finale. Plainva si lega esattamente a questa porta; qualsiasi deviazione interrompe l’accesso.
4. Imposta le autorizzazioni
Scheda Permissions — spunta quanto segue e clicca su Submit in fondo:
files.metadata.readfiles.content.readfiles.content.write
⚠️ Se cambi le autorizzazioni in seguito, devi Riconnettere in Plainva, altrimenti restano valide le vecchie autorizzazioni.
5. Copia l’App key
Scheda Settings: copia il valore App key — questo è il tuo valore per Plainva. (Non ti serve l‘“App secret”.)
La tua app resta nello stato “Development”. Per l’uso privato è sufficiente; “Apply for production” serve solo se molte altre persone usano la stessa App key.
Inseriscilo in Plainva
- Impostazioni → Vault → Sincronizzazione.
- Imposta il Provider di sincronizzazione su Dropbox.
- Incolla l’App key copiata nel campo Chiave dell’app; facoltativamente imposta la Cartella Dropbox (percorso) (predefinita
/Plainva). - Connetti a Dropbox → accedi nel browser e conferma l’accesso.
Se qualcosa non funziona
| Sintomo | Causa | Soluzione |
|---|---|---|
| OneDrive: “Microsoft returned no refresh_token” | manca offline_access | Passaggio A5: aggiungi offline_access, poi Riconnetti |
| OneDrive: l’accesso richiede un secret / fallisce | Piattaforma “Web” invece di “Mobile e desktop” | Passaggio A2: piattaforma Client pubblico/nativo, reindirizzamento http://localhost |
| OneDrive: l’account personale viene rifiutato | Tipo di account errato | Passaggio A2: scegli ”… e account Microsoft personali” |
| Dropbox: l’accesso resta bloccato / “redirect_uri mismatch” | Reindirizzamento non esatto | Passaggio B3: esattamente http://127.0.0.1:41953 |
| Dropbox: “Port 41953 is in use” | Un altro programma blocca la porta | Chiudi l’applicazione che blocca, riprova |
| Dropbox: non trova il vault / mancano i permessi | ”App folder” invece di “Full Dropbox”, oppure permessi non inviati con Submit | Controlla il passaggio B2 / B4, poi Riconnetti |
Vedi anche
- Configurare la sincronizzazione — versione breve e gli altri provider
- Compatibilità di sincronizzazione — quali servizi funzionano e come
- FAQ e risoluzione dei problemi