Incorporamento con le API Amazon QuickSight - Amazon QuickSight

Incorporamento con le API Amazon QuickSight

 Si applica a: Enterprise Edition 
   Destinatari: sviluppatori di Amazon QuickSight 

L'effettivo processo di integrazione delle analisi mediante le API QuickSight prevede solo pochi passaggi.

Prima di iniziare, assicurati di disporre dei seguenti elementi:

  • Configura le autorizzazioni IAM richieste per l'identità del chiamante utilizzata dall'applicazione che utilizzerà l'SDK AWS per effettuare chiamate API. Ad esempio, concedi l'autorizzazione per consentire l'operazione quicksight:GenerateEmbedUrlForAnonymousUser o quicksight:GenerateEmbedUrlForRegisteredUser.

  • Per l'incorporamento per gli utenti registrati, condividi prima le risorse QuickSight con loro. Per i nuovi utenti che effettuano l'autenticazione, scopri come concedere l'accesso alle risorse. A questo scopo, puoi aggiungere tutte le risorse a una cartella QuickSight. Se preferisci utilizzare l'API QuickSight, utilizza le operazioni API DescribeDashboardPermissions e UpdateDashboardPermissions. Per ulteriori informazioni, consulta DescribeDashboardPermissions o UpdateDashboardPermissions nella Documentazione di riferimento delle API di Amazon QuickSight. Se desideri condividere il pannello di controllo con tutti gli utenti in uno spazio dei nomi o in un gruppo, puoi condividere il pannello di controllo con namespace o group.

  • Se stai incorporando i pannelli di controllo, assicurati di disporre dell'ID dei pannelli di controllo desiderati. L'ID del pannello di controllo è il codice nell'URL del pannello. Puoi ottenerlo anche dall'URL del pannello di controllo.

  • Un amministratore QuickSight deve abilitare esplicitamente i domini in cui intendi incorporare le analisi QuickSight. Puoi farlo utilizzando Gestisci QuickSight, Domini e integrazione dal menu del profilo oppure puoi utilizzare il parametro AllowedDomains di una chiamata API GenerateEmbedUrlForAnonymousUser o GenerateEmbedUrlForRegisteredUser.

    Questa opzione è visibile solo agli amministratori di QuickSight. Puoi anche aggiungere sottodomini come parte di un dominio. Per ulteriori informazioni, consulta Elenco consentiti di domini al runtime con l'API QuickSight.

    Tutti i domini nell'elenco di consentiti statico in uso (ad esempio sviluppo, gestione temporanea e produzione) devono essere consentiti esplicitamente e devono utilizzare il protocollo HTTPS. È possibile aggiungere fino a 100 domini all'elenco dei consentiti. Puoi aggiungere domini al runtime con le operazioni API di QuickSight.

Una volta completati tutti i prerequisiti, l'integrazione di QuickSight prevede i seguenti passaggi, che verranno spiegati più dettagliatamente in seguito:

  1. Per l'autenticazione, utilizza il server delle applicazioni per autenticare l'utente. Dopo l'autenticazione nel server, genera l'URL del pannello di controllo incorporato utilizzando l'SDK AWS necessario.

  2. Nel portale Web o nell'applicazione, incorpora QuickSight utilizzando l'URL generato. Per semplificare il processo, è possibile utilizzare l'SDK di incorporamento di Amazon QuickSight, disponibile su NPMJS e GitHub. Questo SDK JavaScript personalizzato è concepito per consentire all'utente di integrare in modo efficiente QuickSight nelle pagine dell'applicazione, impostare i valori predefiniti, connettere i controlli, ottenere le richiamate e gestire gli errori.

È possibile utilizzare i log di audit di AWS CloudTrail per ottenere informazioni sul numero di pannelli di controllo integrati, sugli utenti di un'esperienza incorporata e sulle tariffe di accesso.

Argomenti