Incorporamento con le API QuickSight - Amazon QuickSight

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à.

Incorporamento con le API QuickSight

 Si applica a: Enterprise Edition 
   Destinatari: QuickSight sviluppatori Amazon 

L'effettivo processo di integrazione dell'analisi tramite le QuickSight API 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' AWS SDK 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 QuickSight risorse con loro. Per i nuovi utenti che effettuano l'autenticazione, scopri come concedere l'accesso alle risorse. Un modo per farlo è aggiungere tutte le risorse a una cartella. QuickSight Se preferisci utilizzare l' QuickSight API, utilizza le operazioni DescribeDashboardPermissions e UpdateDashboardPermissions API. Per ulteriori informazioni, consulta DescribeDashboardPermissionso UpdateDashboardPermissionsconsulta Amazon QuickSight API Reference. 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 QuickSight amministratore deve abilitare esplicitamente i domini in cui intendi incorporare le tue analisi. QuickSight Puoi farlo utilizzando Gestisci QuickSight, Domini e Incorporamento dal menu del profilo oppure puoi utilizzare il AllowedDomains parametro di una chiamata o API. GenerateEmbedUrlForAnonymousUser GenerateEmbedUrlForRegisteredUser

    Questa opzione è visibile solo agli amministratori. QuickSight Puoi anche aggiungere sottodomini come parte di un dominio. Per ulteriori informazioni, consulta Consenti la pubblicazione di domini in fase di esecuzione 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 in fase di esecuzione con operazioni QuickSight API.

Una volta completati tutti i prerequisiti, l'incorporamento 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 della dashboard incorporata utilizzando l' AWS SDK di cui hai bisogno.

  2. Nel tuo portale web o nella tua applicazione, esegui l'incorporamento QuickSight utilizzando l'URL generato. Per semplificare questo processo, puoi utilizzare Amazon QuickSight Embedding SDK, disponibile su NPMJS e. GitHub Questo JavaScript SDK personalizzato è progettato per aiutarti a integrarti in modo efficiente QuickSight nelle pagine delle tue applicazioni, impostare impostazioni predefinite, connettere i controlli, ricevere richiami e gestire gli errori.

Puoi utilizzare i log AWS CloudTrail di controllo per ottenere informazioni sul numero di dashboard incorporati, sugli utenti di un'esperienza integrata e sulle tariffe di accesso.

Argomenti