View a markdown version of this page

OneDrive Integrazione con Microsoft Action - Amazon Quick

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

OneDrive Integrazione con Microsoft Action

Usa il Microsoft OneDrive Action Connector per gestire OneDrive file, cartelle e cartelle di lavoro Excel direttamente in Amazon Quick tramite linguaggio naturale.

La configurazione di questa integrazione prevede due passaggi. Innanzitutto, si registra un'applicazione in Microsoft Entra e si configurano le relative autorizzazioni. Quindi, crei l'integrazione in Amazon Quick e la connetti alla tua app Entra. Per informazioni sui metodi di autenticazione supportati da Amazon Quick, consultaMetodi di autenticazione.

Prima di iniziare

Assicurati di disporre di quanto segue prima di configurare l'integrazione.

Configurare Microsoft Entra

Prima di configurare Amazon Quick, crea una registrazione dell'app in Microsoft Entra. Completa tutti i seguenti passaggi in Entra prima di passare alla console Amazon Quick.

Per ulteriori informazioni sulle registrazioni delle app, vedi Registrare un'applicazione con la piattaforma di identità Microsoft nella documentazione Microsoft.

Registrare l'applicazione

  1. Apri l'interfaccia di amministrazione di Microsoft Entra.

  2. Nella barra di navigazione a sinistra, scegli Entra ID, quindi scegli Registrazioni app.

  3. Scegli Nuova registrazione.

  4. In Nome, inserisci un nome descrittivo per la tua integrazione.

  5. Per i tipi di account supportati, scegli Account solo in questa directory organizzativa.

  6. Per Redirect URI, selezionate Web e immettetehttps://{region}.quicksight.aws.amazon.com/sn/oauthcallback. Sostituisci {region} con la AWS regione in cui è distribuita l'istanza Amazon Quick.

  7. Scegli Registrati.

  8. Nella pagina di panoramica, copia l'ID dell'applicazione (client) e l'ID della directory (tenant). Questi valori sono necessari per la configurazione di Amazon Quick.

Crea un segreto per il cliente

Amazon Quick necessita di un client secret per l'autenticazione con Microsoft Entra. Questo segreto funge da password per la registrazione dell'app.

  1. Dalla registrazione dell'app, scegli Certificati e segreti.

  2. Scegli Nuovo segreto del cliente.

  3. Inserisci una descrizione e scegli un periodo di scadenza.

  4. Scegliere Aggiungi.

  5. Copia immediatamente il valore. Questo valore viene visualizzato solo una volta.

Importante

Copia il valore segreto, non l'ID segreto. Il valore è la stringa più lunga utilizzata per l'autenticazione.

Configura le autorizzazioni API

Questa integrazione utilizza autorizzazioni delegate, che consentono all'app di agire per conto di un utente che ha effettuato l'accesso. Per ulteriori informazioni, vedere Panoramica delle autorizzazioni di Microsoft Graph nella documentazione Microsoft.

  1. Dalla registrazione dell'app, scegli Autorizzazioni API.

  2. Scegli Aggiungi un'autorizzazione, quindi scegli Microsoft Graph.

  3. Scegli Autorizzazioni delegate e aggiungi le autorizzazioni dalla tabella seguente.

  4. Scegli Concedi il consenso dell'amministratore per [il nome dell'inquilino] per approvare le autorizzazioni.

Aggiungi quanto segue come autorizzazioni delegate nella registrazione dell'app Entra. Per il riferimento completo alle autorizzazioni, vedere il riferimento alle autorizzazioni di Microsoft Graph nella documentazione Microsoft.

OneDrive integrazione delle azioni: autorizzazioni delegate
Autorizzazione Description
Files.ReadWrite Consente all'app di leggere, creare, aggiornare ed eliminare i file dell'utente che ha effettuato l'accesso.
User.Read.All Consente all'app di leggere il set completo di proprietà del profilo di tutti gli utenti dell'organizzazione per conto dell'utente che ha effettuato l'accesso.
offline_access Consente all'app di aggiornare i token di accesso senza richiedere all'utente di effettuare nuovamente l'accesso. Ciò riduce la frequenza con cui gli utenti devono autenticarsi nuovamente.

Registra le tue credenziali

Prima di uscire dall'interfaccia di amministrazione di Microsoft Entra, verifica di avere i seguenti valori. Ne hai bisogno per la configurazione di Amazon Quick.

Credenziali richieste da Microsoft Entra
Valore Dove trovarlo
ID dell’applicazione (client) Pagina di panoramica sulla registrazione dell'app
ID della directory (tenant) Pagina di panoramica sulla registrazione dell'app
Valore segreto del cliente Pagina dei certificati e dei segreti

Configura l'integrazione in Amazon Quick

Dopo aver completato la configurazione Entra, crea l'integrazione in Amazon Quick.

  1. Nella console Amazon Quick, scegli Integrazioni.

  2. Scegli Microsoft OneDrive e scegli il pulsante Aggiungi (più «+»).

  3. Scegli la scheda Azioni.

  4. Scegli Esegui azioni in Microsoft OneDrive.

  5. Inserisci i dettagli dell'integrazione:

    • Nome: nome descrittivo per l' OneDriveintegrazione.

    • Descrizione (facoltativa): scopo dell'integrazione.

  6. Compila le impostazioni di connessione:

    • URL di basehttps://graph.microsoft.com/v1.0

    • ID cliente: ID dell'applicazione (client) ottenuto dalla registrazione dell'app Entra.

    • Client Secret: valore segreto del cliente derivante dalla registrazione dell'app Entra.

    • URL del token: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

    • URL di autenticazionehttps://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize

    • URL di reindirizzamentohttps://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  7. Scegli Crea e continua.

  8. Scegli gli utenti con cui condividere l'integrazione.

  9. Scegli Next (Successivo).

Operazioni disponibili

Dopo aver configurato l'integrazione, sono disponibili le seguenti azioni.

Azioni OneDrive disponibili in Microsoft
Categoria Azione Description
Drive e articoli Ottieni Drive Recupera le proprietà e le relazioni di un'unità.
Unità e oggetti Elemento dell'elenco Recupera tutti gli oggetti contenuti nell'unità.
Unità e oggetti Get Item Procurati un oggetto contenuto nell'unità.
Unità e oggetti Create Folder Crea una nuova cartella nell'unità dell'utente.
Unità e oggetti Update Item Aggiorna i metadati per un file o una cartella.
Unità e oggetti Delete Item Eliminare un file o una cartella. Sposta l'articolo nel cestino.
Unità e oggetti Elenca le cartelle secondarie Restituisce una raccolta di elementi nei figli di una cartella.
Drive e oggetti Copia articolo Crea una copia di un file o di una cartella in un'altra posizione.
Unità e oggetti Aggiungi autorizzazioni Invia un invito alla condivisione di un file o di una cartella.
Drive e articoli Carica file Carica un nuovo file o aggiorna un file esistente. Supporta file fino a 250 MB.
Cartelle di lavoro Excel Fogli di elenco Recupera un elenco di oggetti del foglio di lavoro.
Cartelle di lavoro Excel Aggiungi foglio Aggiungi un nuovo foglio di lavoro alla cartella di lavoro.
Cartelle di lavoro Excel Leggi il foglio Recupera le proprietà di un oggetto del foglio di lavoro.
Cartelle di lavoro di Excel Foglio di aggiornamento Aggiorna le proprietà di un oggetto del foglio di lavoro.
Cartelle di lavoro Excel Elimina foglio Elimina il foglio di lavoro dalla cartella di lavoro.
Cartelle di lavoro di Excel Leggi Cell Ottieni il valore di una singola cella per numero di riga e colonna.
Cartelle di lavoro Excel Scrivi cella Imposta il valore di una singola cella per numero di riga e colonna.
Cartelle di lavoro Excel Intervallo di lettura Ottieni i valori di un intervallo.
Cartelle di lavoro Excel Intervallo di scrittura Aggiorna i valori di un intervallo.
Cartelle di lavoro Excel Intervallo chiaro Cancella i valori dell'intervallo, il formato, il riempimento e il bordo.
Cartelle di lavoro Excel Elimina intervallo Elimina le celle associate all'intervallo.
Cartelle di lavoro Excel Get Used Range Ottieni l'intervallo più piccolo che comprende le celle con un valore o una formattazione.

Gestisci e risolvi i problemi

Per modificare, condividere o eliminare la tua integrazione, consulta. Gestione delle integrazioni esistenti

Problemi di autenticazione

  • Registrazione errata dell'app: verifica che la registrazione dell'app in Microsoft Entra includa le autorizzazioni API richieste e che sia stato concesso il consenso dell'amministratore.

  • Segreto client scaduto: controlla se il segreto del client è scaduto in Certificati e segreti e generane uno nuovo, se necessario.

  • URI di reindirizzamento errato: verifica che l'URI di reindirizzamento in Microsoft Entra corrisponda. https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

Messaggi di errore comuni

  • Access denied. You do not have permission to perform this action— L'utente autenticato non dispone delle autorizzazioni richieste. Contatta l'amministratore per verificare e concedere le autorizzazioni appropriate.

  • AADSTS50020: User account from identity provider does not exist in tenant— L'account utente non è configurato nel tenant Microsoft Entra corretto. Verifica che nel tenant esista un account utente che corrisponda all'ID di Directory (tenant) indicato nella registrazione dell'app.