Aggiungere un canale OneDrive

Prima di iniziare

Requisito	A cosa serve
Account Microsoft	Per accedere alle pagine amministrative Microsoft e autorizzare OneDrive
Dominio ImgHost	Per l'URL di callback OAuth
Registrazione app	Per generare Client ID e Client Secret
Account OneDrive	Spazio effettivo in cui verranno salvati i file

Configurazione

Passaggio 1: apri Microsoft Entra ID

1. Apri portal.azure.com.
2. Cerca Microsoft Entra ID in alto.
3. Se la pagina non compare nel menu, scegli:

Continue searching in Microsoft Entra ID

4. Apri Microsoft Entra ID.
5. Apri App registrations.
6. Clicca su New registration.

Passaggio 2: registra un'app

Nella pagina New registration, compila:

Campo	Cosa inserire
Name	Un nome riconoscibile, per esempio imgbed-onedrive
Supported account types	Scegli in base alla tabella sotto
Redirect URI type	Web
Redirect URI	https://your-domain.com/api/oauth/onedrive/callback

Guida al tipo di account:

Scenario	Supported Account Types
Solo OneDrive personale	Scegli l'opzione per account Microsoft personali.
Account personali e lavoro/scuola	Scegli l'opzione che supporta account personali e organizzativi.
Solo OneDrive aziendale o scolastico	Scegli l'opzione per account organizzativi.

Dopo aver compilato il modulo, clicca su registra.

Passaggio 3: copia le informazioni dell'app

Dalla pagina di riepilogo copia questi valori:

Campo Microsoft	Campo ImgHost
Application (client) ID	Client ID
Directory (tenant) ID	Tenant ID per account organizzativi

Passaggio 4: crea un Client Secret

1. Apri Certificates & secrets.
2. Clicca su New client secret.
3. Inserisci una descrizione qualsiasi ma riconoscibile.
4. Scegli una scadenza.
5. Copia subito il Value, appena viene creato.

Passaggio 5: aggiungi i permessi API

1. Apri API permissions.
2. Clicca su Add a permission.
3. Scegli Microsoft Graph.
4. Scegli Delegated permissions.
5. Aggiungi questi permessi:

Permesso	Scopo
Files.ReadWrite.All	Carica file, crea cartelle ed elimina file
offline_access	Permette a ImgHost di ottenere un Refresh Token
User.Read	Legge informazioni account e quota

Passaggio 6: compila il canale OneDrive

In Impostazioni di caricamento scegli OneDrive e compila:

Campo ImgHost	Cosa inserire
Nome canale	Un nome riconoscibile, per esempio Main OneDrive
Client ID	La Microsoft Application (client) ID
Client Secret	Il Client Secret Value copiato
Tenant ID	Usa la tabella sotto
Refresh Token	Lascialo vuoto per ora
Directory radice	Opzionale. Valore predefinito imgbed.
Nota	Opzionale

Come compilare Tenant ID:

Tipo di account scelto	Tenant ID in ImgHost
Account personali	consumers
Account personali e organizzativi	common
Solo organizzazione corrente	La Directory (tenant) ID

Passaggio 7: ottieni il Refresh Token

1. In ImgHost clicca su Get Token.
2. Accedi con l'account Microsoft da collegare.
3. Approva la richiesta di autorizzazione.
4. La pagina di callback mostrerà un Refresh Token.
5. Copialo.
6. Torna in ImgHost e incollalo nel campo Refresh Token.

Passaggio 8: salva il canale

Quando tutti i campi sono compilati, salva il canale.

Flusso rapido

Open portal.azure.com
-> Search for Microsoft Entra ID
-> Open App registrations
-> Register a new app
-> Fill Name / Supported account types / Web redirect URI
-> Register
-> Copy Application (client) ID
-> Check the callback URL in Authentication
-> Create a Client Secret in Certificates & secrets
-> Add permissions in API permissions
-> Fill Client ID / Client Secret / Tenant ID into ImgHost
-> Click Get Token
-> Copy the Refresh Token from the callback page
-> Paste it back into ImgHost and save

Riferimenti

1. Registrazione app Microsoft Entra: https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app
2. Flusso con codice di autorizzazione della Microsoft identity platform: https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-auth-code-flow
3. Autenticazione utente Microsoft Graph: https://learn.microsoft.com/en-us/graph/auth-v2-user