Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Fabric App include un servizio di autenticazione predefinito che consente agli utenti di accedere, gestire le sessioni e allegare la propria identità a ogni chiamata di dati e archiviazione eseguita dall'app. Questo articolo illustra i concetti da comprendere prima di configurare l'autenticazione per il progetto.
Per informazioni dettagliate sull'implementazione, vedere:
- Configurare l'autenticazione SSO Fabric per l'app Fabric: codice di accesso e iscrizione per le app distribuite.
- Definire le autorizzazioni per i dati : usare l'identità dell'utente connesso per controllare l'accesso ai dati.
Modalità di autenticazione
Le app Fabric distribuite si autenticano con Microsoft Entra ID. Scegli il percorso di integrazione in base a dove l'app viene eseguita e chi acquisisce il token Entra:
| Ambiente | Metodo supportato | Quando usarlo |
|---|---|---|
| App browser che utilizza il portale Fabric | Popup Fabric SSO o handoff incorporato | Lascia che Fabric effettui l'accesso interattivo, oppure accedi a un'app incorporata in Fabric. |
| Browser o Node.js app che già possiede un token Entra delegato | signInWithEntraToken() |
Scambia il token fornito con una sessione Rayfin senza popup o reindirizzamento. |
| App incorporata in un portale host esterno |
createEmbedHost() genitore e initEmbeddedAuth() nell'iframe |
Lascia che un broker padre attendibile autenticato con Entra faccia un handoff senza inviare il token all'iframe. |
| Sviluppo locale con un backend locale | Posta elettronica e password | Testa contro un backend locale; questo metodo non funziona su un backend Fabric distribuito. |
Concetti chiave:
- Fabric SSO utilizza il portale Fabric per autenticare un utente del browser. L'app può essere eseguita all'interno di Fabric o utilizzare un popup da una pagina standalone, incluso un frontend locale che mira a un backend distribuito.
- Direct Entra exchange e passaggio all'host padre esterno sono percorsi aggiuntivi di Microsoft Entra, non supportano provider di identità arbitrari o l'accesso del service principal solo app.
- La posta elettronica e la password sono destinate solo allo sviluppo locale. Non funziona dopo la distribuzione.
- Al primo accesso, viene effettuato il provisioning dell'utente. Con Fabric SSO, non esiste un passaggio di iscrizione separato. Gli utenti vengono creati automaticamente la prima volta che accedono.
- L'autenticazione è necessaria per le distribuzioni di Fabric. L'impostazione di
services.auth.enabledsufalsecausa il malfunzionamento dinpx rayfin up.
Per requisiti di token ed esempi di implementazione, vedi Accesso con token Entra diretto e Incorpora in un portale padre esterno.
Sessioni e identità
Dopo l'accesso di un utente, l'SDK crea una sessione che rappresenta l'utente connesso. Le sessioni sono opache: l'app non deve esaminare i token sottostanti. L'app legge invece un piccolo set di proprietà di alto livello:
- Indica se una sessione è attualmente autenticata.
- L'utente
ideemail. - Attestazioni personalizzate che hai configurato in
rayfin.yml.
La stessa istanza client che effettua l'accesso dell'utente associa automaticamente l'identità dell'utente a ogni chiamata ai dati e di archiviazione. I token non vengono passati manualmente.
Le sessioni generano anche eventi di modifica, in modo che l'interfaccia utente possa reagire quando un utente accede o si disconnette senza ricaricare la pagina.
Per le integrazioni lato server, usa un client separato e una sessione solo in memoria Auth per utente (authStorage: false su RayfinClient, o { storage: false } su Auth). Non condividere mai un client autenticato mutabile tra utenti. Distruggi l'istanza di autenticazione quando termina la richiesta corrispondente o scade l'ambito specifico dell'utente.
Abilitare l'autenticazione nel progetto
L'autenticazione è configurata in rayfin/rayfin.yml. L'esempio seguente abilita sia Fabric SSO (per le app distribuite) che l'accesso tramite posta elettronica/password (per lo sviluppo locale):
services:
auth:
enabled: true
allowedRedirectUris:
- http://localhost:5173
fabric:
enabled: true
externalEntraExchange: true
password:
enabled: true # Local development only
Che cosa controlla ciascuna impostazione:
-
services.auth.enabled: attiva il servizio di autenticazione. Necessario per qualsiasi distribuzione di Fabric. -
allowedRedirectUris– Le origini autorizzate a cui reindirizzare l'utente dopo l'accesso. Aggiungere l'URL di sviluppo locale qui.npx rayfin upaggiunge automaticamente l'origine dell'app distribuita. -
fabric.enabled– abilita l'SSO di Fabric. Obbligatorio per le app distribuite. -
fabric.externalEntraExchange– Consente lo scambio diretto delegato di token Entra e il trasferimento all'host padre esterno. L'ambiente Fabric target deve anche supportare lo scambio. -
password.enabled: abilita l'accesso tramite posta elettronica e password per lo sviluppo locale.
Importante
Le distribuzioni di Fabric richiedono l'abilitazione dell'autenticazione.
npx rayfin up ha esito negativo quando services.auth.enabled è impostato su false.
Dopo aver modificato rayfin.yml, riavvia il backend locale o esegui npx rayfin up per applicare la modifica.
Prerequisiti per i token Entra acquisiti esternamente
Lo scambio diretto e l'autenticazione host padre esterno richiedono un token utente delegato per il pubblico Fabric/Power BI accettato dalla distribuzione target, con Item.Execute.All, emesso nel tenant proprietario dell'elemento. L'utente deve anche avere il permesso di Esecuzione sull'elemento dell'app. I token solo per app non sono supportati da questi percorsi di accesso.
La tua libreria di identità acquisisce il token e gestisce il consenso. L'SDK di Rayfin lo scambia con una sessione Rayfin; non acquisisce il token Entra. I chiamanti dal browser necessitano anche della politica CORS del servizio per consentire l'origine della richiesta e l'intestazione Authorization.
Attestazioni personalizzate
Le attestazioni personalizzate consentono di allegare metadati specifici dell'applicazione a ogni sessione, ad esempio un nome del tenant, un flag di funzionalità o una versione dell'app. Sono utili per il controllo degli accessi in base al ruolo e il controllo delle funzionalità senza modificare il modello di dati.
services:
auth:
enabled: true
customClaims:
tenant: default
app_version: 1.0.0
Le attestazioni personalizzate vengono visualizzate all'interno dell'oggetto sessione e possono essere referenziate dalle regole di autorizzazione dei dati.
Informazioni fornite dall'SDK
Quando si usa RayfinClient, il servizio di autenticazione è disponibile in client.auth. A livello concettuale, fornisce:
- Iscrizione e accesso con posta elettronica e password durante lo sviluppo locale.
- Accedere e registrarsi tramite Fabric SSO per le app distribuite. La stessa chiamata gestisce sia gli utenti nuovi sia quelli di ritorno.
- Scambio diretto delegato di token Entra nel codice del browser o di Node.js, oltre a un passaggio affidabile a un host padre esterno per le app incorporate.
- Disconnettersi per terminare la sessione corrente.
- Legge la sessione e gestisce le sottoscrizioni in modo che l'interfaccia utente rimanga sincronizzata con lo stato di autenticazione dell'utente.
Per il codice che collega queste funzionalità in un'app reale, vedi Configura l'autenticazione SSO Fabric per la tua app Fabric. Per indicazioni sull'elenco di elementi consentiti per callback e handoff, vedere Configurare gli URI di reindirizzamento dell'autenticazione.