Integrazione con Amazon Quick Sight APIs - Amazon Quick Suite

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

Integrazione con Amazon Quick Sight APIs

 Si applica a: Enterprise Edition 
   Destinatari: sviluppatori di Amazon Quick Suite 

L'effettivo processo di integrazione delle analisi con Amazon Quick Sight APIs prevede solo pochi passaggi.

Prima di iniziare, assicurati di disporre dei seguenti elementi:

  • Configura le autorizzazioni IAM richieste per l'identità del chiamante utilizzata dalla tua 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 risorse Amazon Quick Sight 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 Amazon Quick Sight. Se preferisci utilizzare l'API Amazon Quick Sight, utilizza le operazioni DescribeDashboardPermissions e UpdateDashboardPermissions API. Per ulteriori informazioni, consulta DescribeDashboardPermissionso UpdateDashboardPermissionsconsulta l'Amazon Quick Suite 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 amministratore di Amazon Quick Sight deve abilitare esplicitamente i domini in cui intendi incorporare le analisi di Amazon Quick Sight. Puoi farlo utilizzando Manage Amazon Quick Sight, Domains and Embedding dal menu del profilo oppure puoi utilizzare il AllowedDomains parametro di una chiamata GenerateEmbedUrlForAnonymousUser o GenerateEmbedUrlForRegisteredUser API.

    Questa opzione è visibile solo agli amministratori di Amazon Quick Sight. 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 Amazon Quick Suite.

    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 le operazioni dell'API Amazon Quick Sight.

Una volta completati tutti i prerequisiti, l'incorporamento di Amazon Quick Sight 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, incorpora Amazon Quick Sight utilizzando l'URL generato. Per semplificare questo processo, puoi utilizzare l'SDK Amazon Quick Sight Embedding, disponibile su NPMJS e. GitHub Questo JavaScript SDK personalizzato è progettato per aiutarti a integrare in modo efficiente Amazon Quick Sight nelle pagine delle tue applicazioni, impostare impostazioni predefinite, connettere i controlli, ricevere callback 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 percentuali di accesso.

Argomenti