Incorporare uno spazio Genie in un'app esterna

Incorporare uno spazio Genie come iframe in un sito Web o un'applicazione esterna in modo che gli utenti possano interagire con Genie all'interno degli strumenti o dei portali interni senza passare a Azure Databricks. Gli amministratori dell'area di lavoro configurano le superfici di incorporamento consentite; gli utenti incorporati possono inviare richieste, ma non possono modificare la configurazione dello spazio.

Requisiti

Prima di poter incorporare uno spazio Genie, è necessario inserire quanto segue:

• Amministratore dell'area di lavoro: deve configurare le superfici di incorporamento consentite nelle impostazioni di gestione degli accessi genie.
• Autore dello spazio: deve avere almeno l'autorizzazione CAN MANAGE per lo spazio Genie.
• Utenti finali: deve avere accesso esplicito a Genie Space e agli asset di dati sottostanti usati. Agli utenti che non hanno eseguito l'accesso a Azure Databricks viene richiesto di eseguire l'autenticazione prima di poter interagire con lo spazio incorporato.

Passaggio 1: Abilitare l'anteprima delle funzionalità

Un amministratore dell'area di lavoro deve abilitare Incorpora Genie come iframe dalla pagina Anteprime prima che la funzionalità sia disponibile nell'area di lavoro.

Passaggio 2: Configurare le superfici di incorporamento consentite

Un amministratore dell'area di lavoro deve configurare le superfici di incorporamento consentite prima di poter incorporare uno spazio genie. Vedere Gestire il dashboard e l'incorporamento di Genie Space.

Passaggio 3: Generare il codice iframe

Dopo che un amministratore ha configurato le superfici consentite, gli autori di spazi possono generare il codice di incorporamento iframe.

1. Aprire il Genie Space da incorporare.
2. Fare clic su Condividi.
3. Nella finestra di dialogo Condividi fare clic su Incorpora spazio.
4. Copiare il codice iframe generato.

Passaggio 4: Aggiungere l'iframe all'applicazione

Incollare il codice iframe nel sito Web o nell'applicazione esterna.

Per abilitare la funzionalità completa, inclusa la copia di dati CSV e la copia dei collegamenti di conversazione, aggiungere l'attributo allow="clipboard-write" all'elemento iframe:

<iframe src="<your-genie-space-url>" allow="clipboard-write" width="100%" height="600"></iframe>

Quando si accede a uno spazio Genie tramite un iframe, il limite di frequenza è di 20 domande al minuto per area di lavoro in tutti gli spazi Genie.

Procedure consigliate

• Concedere l'accesso esplicito ai dati: assicurarsi che gli utenti finali abbiano accesso sia a Genie Space che a tutti gli asset di dati sottostanti usati dallo spazio. Gli utenti visualizzano solo i dati a cui hanno l'autorizzazione per accedere.
• Abilitare l'accesso agli Appunti: includere allow="clipboard-write" nell'elemento iframe in modo che gli utenti possano copiare i risultati della query e i collegamenti di conversazione.
• Limitare le superfici consentite: aggiungere domini solo all'elenco di superfici di incorporamento consentite che si considera attendibile e controllato.