Autorizzazioni nelle Mappe Fabric

Questo articolo spiega come funzionano le autorizzazioni in Fabric Maps, compreso il modo in cui interagiscono i ruoli dell'area di lavoro, le autorizzazioni a livello di mappa e le autorizzazioni sulle origini dati sottostanti, ad esempio eventhouses, database KQL e lakehouse. Comprendere questo modello di permessi ti aiuta a determinare chi può visualizzare, modificare e condividere mappe. Spiega inoltre perché le autorizzazioni mancanti possono causare layer non visualizzati, risultati incompleti o errori di accesso. Per istruzioni dettagliate sulla gestione dell'accesso ai singoli elementi della mappa, vedere Gestire le autorizzazioni della mappa.

Funzionamento delle autorizzazioni di Mappe Fabric

Tre livelli di permessi determinano l'accesso a una mappa in Fabric Maps:

Tutti e tre i livelli devono consentire a un utente di interagire completamente con una mappa.

Fabric Maps non definisce il proprio modello di sicurezza. Si basa invece sul framework di autorizzazione standard di Microsoft Fabric. Per altre informazioni, vedere Modello di autorizzazione.

Autorizzazioni dell'area di lavoro

Le mappe sono elementi di Fabric che risiedono in un'area di lavoro. I ruoli dell'area di lavoro determinano se un utente può:

  • Visualizzare il contenuto della mappa
  • Creare o modificare mappe
  • Condividere mappe con altri utenti

I ruoli del workspace Fabric si applicano a tutti gli elementi nel workspace, inclusi gli elementi della mappa. I ruoli disponibili sono:

  • Admin
  • Membro
  • Contributor
  • Visualizzatore

Ad esempio, i collaboratori possono creare e modificare mappe, ma non possono condividerle, mentre i visualizzatori possono visualizzare solo il contenuto della mappa. Per altre informazioni, vedere Ruoli nelle aree di lavoro in Microsoft Fabric.

Funzionalità dei ruoli per elementi della mappa nell'area di lavoro

La tabella seguente mostra i permessi predefiniti assegnati a ciascun ruolo di workspace Fabric per gli elementi della mappa.

Permissions Administrator Membro Collaboratore Visualizzatore
Visualizza e leggi il contenuto degli elementi della mappa ✔️ ✔️ ✔️ ✔️
Crea, modifica ed elimina la mappa ✔️ ✔️ ✔️ ❌
Condividi mappa ✔️ ✔️ ❌ ❌

Autorizzazioni dati e visibilità della mappa

Fabric Maps non controlla la sicurezza a livello di dati.

Ciò che gli utenti vedono in una mappa dipende interamente dai permessi per le fonti dati sottostanti, come:

  • File Lakehouse (ad esempio, GeoJSON o set di tessere)
  • Database KQL e insiemi di query
  • Eventhouses usati per i livelli in tempo reale

Un altro utente può creare connessioni cloud per i layer esterni e condiverle con il map builder. Dopo che la mappa utilizza la connessione per visualizzare un livello esterno, gli osservatori possono vedere il livello senza accesso separato alla connessione o alle sue credenziali.

Le autorizzazioni per i dati determinano:

  • Quali livelli eseguono il rendering
    Se un utente non riesce a leggere una sorgente dati, il corrispondente livello mappa non viene visualizzato né mostra errori.

  • Quali funzionalità vengono visualizzate
    Le mappe visualizzano solo i record restituiti dalle query o dai file che l'utente è autorizzato a leggere.

  • Quali attributi sono disponibili
    La mappa include solo colonne e proprietà accessibili tramite la fonte dati sottostante.

Fabric Maps non concede mai l'accesso ai dati che un utente non è autorizzato a leggere. Per altre informazioni, vedere Modello di autorizzazione.

Per un livello di servizio esterno di funzionalità, Fabric Maps recupera le credenziali memorizzate nella connessione cloud. Gli spettatori non hanno bisogno che la connessione venga condivisa separatamente. Se le credenziali scadono o Fabric Maps non riesce a raggiungere il servizio, la mappa mostra un errore che indica che il servizio non è stato raggiungibile.

Autorizzazioni necessarie per compilare o modificare una mappa

Questa tabella riepiloga le autorizzazioni minime necessarie per i ruoli dell'area di lavoro, gli elementi della mappa e le origini dati sottostanti per creare o modificare una mappa e i relativi livelli.

Scenario Elemento correlato Autorizzazioni minime necessarie
Creare, modificare o eliminare una mappa Workspace Collaboratore o superiore
Aggiungere livelli GeoJSON o tileset Lakehouse Leggi
Caricare PMTiles per i set di riquadri Lakehouse Scrittura
Aggiungere livelli basati su KQL KQL banca dati Leggi
Salvare le modifiche alla mappa Elemento sulla mappa Edit

Autorizzazioni necessarie per visualizzare o interagire con una mappa

Questa tabella riassume i permessi a livello di lettura richiesti sugli elementi della mappa e sulle fonti dati sottostanti affinché gli utenti possano visualizzare le mappe e tutti i livelli e i dati disponibili.

Scenario Elemento correlato Autorizzazioni minime necessarie
Aprire e visualizzare una mappa Elemento della mappa Leggi
Visualizzare i livelli GeoJSON o tileset Lakehouse Leggi
Visualizzare i risultati della query KQL KQL banca dati Leggi
Visualizzare i livelli in tempo reale Eventhouse Leggi

Importante

La condivisione di una mappa non concede l'accesso al lakehouse, al database KQL o all'eventhouse che ne fornisce i dati. Quando gli utenti non hanno il permesso di accedere al database lakehouse o KQL, la mappa mostra errori o dati incompleti.

Autorizzazioni degli elementi della mappa

Puoi concedere agli utenti i permessi di Leggere, Modificare e Condividire su una mappa.

Le sezioni seguenti forniscono maggiori dettagli su questi permessi.

Autorizzazioni di lettura

Tutti i ruoli di area di lavoro Fabric possono visualizzare e leggere gli elementi della mappa.

La visualizzazione dell'elemento della mappa è necessaria ma non sempre sufficiente:

  • Gli utenti devono anche avere accesso in lettura alle fonti dati sottostanti, come un database lakehouse o KQL.
  • Se mancano i permessi dati, la mappa potrebbe aprirsi ma mostrare errori, strati vuoti o dati incompleti.

Modificare le autorizzazioni

Il permesso di modifica concede all'utente la possibilità di modificare l'elemento della mappa stesso. Ad esempio, possono:

  • Modificare livelli, stili, filtri e impostazioni della mappa
  • Aggiungere o rimuovere livelli dati
  • Salvare le modifiche alla mappa

Questo permesso non è indipendente. Un utente può modificare una mappa solo se il suo ruolo nell'area di lavoro consente l'accesso di scrittura agli elementi della mappa.

In pratica, questa condizione significa:

  • Gli utenti con ruoli Amministratore, Membro o Collaboratore possono modificare le mappe.
  • Gli utenti con il ruolo Visualizzatore non possono modificare mappe, anche se la mappa viene condivisa con loro.

La modifica della mappa non sovrascrive i permessi dei dati. L'utente deve comunque avere i permessi necessari sulle fonti dati sottostanti, come un database lakehouse o KQL, altrimenti la mappa potrebbe mostrare errori o dati mancanti. Per altre informazioni, vedere Autorizzazioni dati e visibilità della mappa nella sezione precedente.

Per informazioni sull'assegnazione dei permessi della mappa, vedi Gestire i permessi della mappa.

Condividere una mappa

Oltre ai ruoli nello spazio di lavoro, puoi condividere i singoli elementi della mappa direttamente con utenti o gruppi. Per altre informazioni sulla condivisione delle mappe, vedere Condivisione di Mappe di Microsoft Fabric.

Quando si condivide un elemento della mappa:

  • Il destinatario ottiene l'accesso solo a tale mappa.
  • Condividere una mappa non concede accesso allo spazio di lavoro o alle fonti dati sottostanti.

Le autorizzazioni degli elementi mappa seguono lo stesso modello di condivisione a livello di elemento usato in Fabric. Per altre informazioni, vedere Modello di autorizzazione.

Per altre informazioni sulla condivisione delle mappe, vedere Condivisione di Mappe di Microsoft Fabric.

Permessi negli scenari di intelligence in tempo reale

Quando una mappa utilizza dati in tempo reale, potrebbe richiedere permessi aggiuntivi:

  • Accesso in lettura agli eventhouse
  • Scrivere o leggere l'accesso ai database KQL e ai set di query
  • Accesso in lettura ai file del lakehouse usati per riquadri o strati statici

Se un utente non ha permessi per una fonte di dati richiesta, la mappa potrebbe caricarsi con livelli mancanti o risultati incompleti.

Per altre informazioni, vedere:

Riassunto

  • Fabric Maps usa il modello di autorizzazione standard di Microsoft Fabric.
  • I ruoli dell'area di lavoro controllano chi può creare, modificare e condividere mappe.
  • Le autorizzazioni degli elementi mappa controllano l'accesso a singole mappe.
  • Le autorizzazioni per i dati controllano quali livelli, funzionalità e attributi sono visibili.
  • Fabric Maps non eleva mai né esegue l'override dell'accesso ai dati.

Per concedere l'accesso completo a una mappa, assicurarsi che gli utenti dispongano delle autorizzazioni necessarie a tutti e tre i livelli.

Passaggi successivi