Connettore per Microsoft OneDrive

Con il connettore Microsoft® OneDrive®, puoi utilizzare i comandi in una catena per gestire file e cartelle in Microsoft OneDrive o SharePoint®. Ad esempio, con questo connettore puoi:

Copia, cancellazione e ricerca di file e cartelle
Scarica e carica file
Elenco delle unità disponibili

Nota: Questo connettore è stato realizzato da Workiva e si collega a un sistema di terze parti. Sebbene il nostro team di assistenza possa aiutare a configurare questo connettore all'interno del tuo spazio di lavoro, non siamo in grado di risolvere i problemi o di fornire assistenza in altro modo per qualsiasi problema che abbia origine al di fuori della piattaforma Workiva.

Prerequisiti

Per attivare la connessione, il connettore utilizza la Microsoft Graph API. Per proteggere la connessione, il connettore utilizza l'autenticazione OAuth tramite un'applicazione designata registrata presso il portale di registrazione delle applicazioni Microsoft o Azure® Active Directory®.

Per configurare il connettore, avrai bisogno di:

Un'applicazione registrata nel portale di registrazione delle applicazioni Microsoft o in Azure Active Directory. Registra l'ID dell'applicazione
L'ID e il segreto del client OAuth dell'applicazione Azure
Gli ambiti dell'applicazione Azure, appropriati per i comandi che il connettore dovrà eseguire
Il tipo e l'ID dell'unità a cui connettersi.

Nota : è possibile utilizzare Graph Explorer di Microsoft ( ) per recuperarli da SharePoint.
L'URI di reindirizzamento del progetto:

Esempio di configurazione di Microsoft Azure per OneDrive

Registrare un'applicazione

Accedi al tuo portale Microsoft Azure: https://azure.microsoft.com/en-us/account/
Accedi ai servizi di Azure Active Directory del tuo .
Accedi a , vai alla sezione "Registrazioni app" ( ) nella sezione "Gestisci" e clicca su " " (Nuova registrazione) .
Inserisci il nome desiderato per l'applicazione , quindi premi Registrati .

Configura l'autenticazione dell'applicazione

Accedi al tuo portale Microsoft Azure: https://azure.microsoft.com/en-us/account/
Accedi ai servizi di Azure Active Directory del tuo .
Accedi alla pagina “Registrazioni delle app” di all’indirizzo nella sezione “Gestisci”.
Accedi alla sezione " " (Autenticazione) nel pannello "Gestisci" aggiornato.
Nella sezione "Tipi di account supportati", selezionare "Account " in qualsiasi directory organizzativa (qualsiasi tenant Microsoft Entra ID - Multitenant) .
Nella sezione "Aggiungi una piattaforma", seleziona " " (Web ).
Nel campo " " (URI di reindirizzamento) inserisci l'URL di callback valido indicato sopra.
Assicurati di selezionare la casella relativa a “ ” (MultiTenant) nella sezione “ ” (Tipi di account supportati) .

Nota: Poiché OneDrive Connector richiede l'abilitazione dell'opzione MultiTenant, spetta agli amministratori di Azure assicurarsi che le applicazioni siano configurate correttamente per garantire la conformità alla sicurezza. Questa opzione, se utilizzata correttamente con la sicurezza di Azure, non apre l'applicazione a tutti. Di seguito ti suggeriamo ulteriori passi da compiere.

Consulta la documentazione di Microsoft relativa a “ ” ( ) riguardante la configurazione multi-tenant.
Abilita le impostazioni di sicurezza per la singola applicazione, seguendo le istruzioni di Microsoft disponibili all'indirizzo su come limitare l'accesso all'app a un gruppo specifico di utenti .
Assegnare/consentire agli utenti l'accesso all'applicazione seguendo le istruzioni di Microsoft disponibili all'indirizzo e assegnando l'app a utenti e gruppi .

Impostazione di certificati e segreti

Accedi al tuo portale Microsoft Azure: https://azure.microsoft.com/en-us/account/
Accedi ai servizi di Azure Active Directory del tuo .
Accedi a , sezione "Registrazioni app" ( ) all'indirizzo , poi seleziona "Gestisci" ( ).
Accedi alla sezione " " (Certificati) all'interno del pannello aggiornato " " (Gestisci) .
Fai clic su “ ” (Crea un nuovo segreto client) nel pannello centrale.
Dopo aver fornito una breve descrizione dell' e , nonché la data di scadenza , verrà visualizzato un Client Secret. Questo documento deve essere conservato per motivi di sicurezza e per l'inserimento nel connettore Microsoft OneDrive.

Impostazione dei permessi API

Accedi al tuo portale Microsoft Azure: https://azure.microsoft.com/en-us/account/
Accedi ai servizi di Azure Active Directory del tuo .
Accedi a , sezione "Registrazioni app" ( ) all'indirizzo , poi seleziona "Gestisci" ( ).
Accedi alla sezione "Autorizzazioni API" di all'interno del pannello aggiornato " " Gestisci .
Fai clic su “ ” (Gestione autorizzazioni) e aggiungi un’autorizzazione denominata “ ” nel pannello centrale.
Scegli Microsoft Graph nella sezione Microsoft APIs .
Selezionare " " (Autorizzazioni del delegato) come tipo di richiesta " " ( ) .
Dall'elenco delle autorizzazioni ti serviranno:
User.Read , tutto ciò che si trova sotto FILES e OpenId.offline_access .
Fai clic su e acconsenti alla gestione delle sovvenzioni .
Definisci il livello di accesso richiesto dal connettore. Il connettore Microsoft OneDrive supporta i
seguenti ambiti di :
- Files.ReadWrite.Selected
- Files.ReadWrite.AppFolder
- Files.ReadWrite.All
- File.LetturaScrittura
- Files.Read.Selected
- Files.Read.All
- Files.Read
- accesso_offline

È richiesto almeno un ambito " " "offline_access" " ".

Perché sono necessari Files.Read.All e Files.ReadWrite.All

Il connettore Workiva OneDrive comunica con l'ambiente Microsoft tramite l'API Microsoft Graph utilizzando le autorizzazioni delegate OAuth; ciò significa che il connettore esegue l'autenticazione e agisce per conto di un utente autenticato.

Perché non è possibile utilizzare Sites.Selected

Sites.Selected è un'autorizzazione specifica di SharePoint progettata per i flussi di accesso a livello di applicazione (solo app); non è compatibile con il modello di autorizzazione delegata utilizzato dal connettore Workiva. Inoltre, limita l'accesso esclusivamente ai siti SharePoint preapprovati, impedendo così al connettore di eseguire operazioni dinamiche basate sul percorso, quali Ricerca, Copia elemento ed Elimina elemento.

Abilitare la sicurezza

Accedi al tuo portale Microsoft Azure: https://azure.microsoft.com/en-us/account/
Accedi ai servizi di Azure Active Directory del tuo .
Fai clic su Enterprise Applications nella sezione Manage .
Seleziona la tua applicazione dall'elenco per avviare il processo di modifica. Se la tua applicazione non è presente nell'elenco predefinito, clicca su Tutte le applicazioni nella sezione Gestisci .
Fai clic su “ ” (Proprietà) nella sezione “ ” (Gestisci) .
Nella schermata " " (Proprietà) , imposta le seguenti proprietà per consentire l'utilizzo dell'accesso all'API creato in precedenza:

È consentito agli utenti di effettuare l'accesso? = Sì

È necessaria l'assegnazione di un utente? = Sì

(Facoltativo) Visibile agli utenti? = No
Fare clic su “ ” (Utenti e gruppi) nella sezione “ ” (Gestione) .
Ora puoi utilizzare le procedure standard di Azure AD per aggiungere gli utenti secondo necessità. Questo
è l'elenco degli utenti autorizzati a utilizzare OneDrive e in possesso di una licenza Microsoft OneDrive valida.

Configura il connettore Microsoft OneDrive

Nota: Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza dell'org deve prima abilitarlo da Configurazione.

Da Chain Builder , clicca su Connections compare_arrows , quindi su Create in alto a destra.
In " " (Connettori) > "Connection" (Connessione) , seleziona " " (Microsoft OneDrive) e "CloudRunner" come impostazione predefinita.
In Informazioni di base, inserisci un nome e una descrizione unici per identificare il connettore.
In OAuth, inserisci l'ID e il segreto del client OAuth dell'applicazione Azure del connettore.
Per determinare il livello di accesso del connettore, inserisci l'ambito di autenticazione dell'applicazione Azure.
È richiesto almeno l'ambito " " "offline_access" .
Per autorizzare la connessione e le credenziali OAuth, clicca su Connect.

In Proprietà, inserisci i dettagli della connessione:

Proprietà	Dettagli
Tipo di unità	Seleziona il tipo di unità a cui collegarti, ad esempio Unità, Gruppo, Utente o Sito. Per collegarti alla tua unità utente, seleziona “ ” (Unità utente) > “Current User (Me)” (Utente corrente) > “ ” (Unità utente).
ID del tipo di unità	Inserisci l'ID dell'unità a cui connettersi, in base a Tipo di unità. Ad esempio, se il tipo di unità " " ( ) è "Utente", inserire l'ID utente; se è "Sito", inserire l'ID sito.

Nota: È possibile utilizzare Graph Explorer di Microsoft ( ) per recuperarli da SharePoint.

Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
Per testare la connessione, crea ed esegui una catena con il comando Download File del connettore e verifica che restituisca un output valido.

Risoluzione dei problemi

Se la connessione a Microsoft OneDrive o SharePoint fallisce:

Verifica che le credenziali OAuth dell'applicazione Azure del connettore siano presenti, corrette e valide. Le credenziali OAuth hanno date di scadenza prestabilite e il certificato potrebbe essere scaduto. In questo caso, dovrai creare un nuovo certificato e inserire il nuovo segreto del cliente nel Connector. Per ulteriori dettagli sulla creazione di un nuovo segreto, consultare
Configurazione di certificati e segreti .
Controlla il tipo di unità e l'ID inseriti per il connettore. È possibile utilizzare Graph Explorer di Microsoft ( ) per recuperarli da SharePoint.
Verifica l'URI di reindirizzamento del progetto:

Centro assistenza di Workiva