Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Fabric Apps innehåller en inbyggd autentiseringstjänst som loggar in användare, hanterar deras sessioner och kopplar deras identitet till alla data och lagringsanrop som appen gör. Den här artikeln beskriver de begrepp som du behöver förstå innan du konfigurerar autentisering för projektet.
Mer information om implementering finns i:
- Konfigurera Fabric SSO-autentisering för din Fabric app – inloggnings- och registreringskod för distribuerade appar.
- Definiera databehörigheter – använd den inloggade användarens identitet för att styra dataåtkomsten.
Autentiseringslägen
Distribuerade Fabric-appar autentiseras med Microsoft Entra ID. Välj integrationsvägen baserat på var appen körs och vem som skaffar Entra-token:
| Miljö | Metod som stöds | När du ska använda detta |
|---|---|---|
| Webbläsarapp som använder Fabric-portalen | Fabric SSO popup eller inbäddad handoff | Låt Fabric utföra interaktiv inloggning, eller logga in i en app som är inbäddad i Fabric. |
| Webbläsare eller Node.js app som redan har en delegerad Entra-token | signInWithEntraToken() |
Byt ut den medföljande token mot en Rayfin-session utan popup eller omdirigering. |
| Appen inbäddad i en extern överordnad portal |
createEmbedHost() i föräldern och initEmbeddedAuth() i iframe |
Låt en betrodd Entra-autentiserad parent broker förmedla en överlämning utan att skicka sin token till iframe. |
| Lokal utveckling med en lokal backend | E-post och lösenord | Testa mot en lokal backend; denna metod fungerar inte på en driftsatt Fabric-backend. |
Viktiga begrepp:
- Fabric SSO använder Fabric-portalen för att autentisera en webbläsaranvändare. Appen kan köras inne i Fabric eller använda en popup från en fristående sida, inklusive en lokal frontend som riktar sig mot en driftsatt backend.
- Direkt Entra-utbyte och överlämning till extern överordnad värd är ytterligare Microsoft Entra-vägar, inte stöd för godtyckliga identitetsleverantörer eller inloggning med tjänsthuvudnamn för endast app.
- E-post och lösenord är endast avsedda för lokal utveckling. Den fungerar inte efter distributionen.
- Den första inloggningen etablerar användarkontot. Med Fabric enkel inloggning finns det inget separat registreringssteg – användarna skapas automatiskt första gången de loggar in.
- Autentisering krävs för Fabric distributioner. Att ställa in
services.auth.enabledtillfalsegör attnpx rayfin upmisslyckas.
För tokenkrav och exempel på implementering, se Direkt Entra-tokeninloggning och Bädda in i en extern överordnad portal.
Sessioner och identitet
När en användare har loggat in skapar SDK en session som representerar den inloggade användaren. Sessioner är opaka – din app bör inte undersöka de underliggande tokenen. I stället läser appen en liten uppsättning egenskaper på hög nivå:
- Om en session för närvarande är autentiserad.
- Användarens
idochemail. - Anpassade anspråk som du konfigurerade i
rayfin.yml.
Samma klientinstans som signerar användaren ansluter automatiskt sin identitet till varje data- och lagringsanrop. Du skickar inte token manuellt.
Sessioner skapar också ändringshändelser, så att ditt användargränssnitt kan reagera när en användare loggar in eller loggar ut utan att läsa in sidan igen.
För server-side-integrationer, använd en separat klient- och minnesbaserad Auth session per användare (authStorage: false på RayfinClient, eller { storage: false } på Auth). Dela aldrig en muterbar inloggad klient mellan användare. Avsluta auth-instansen när dess begäran eller användarspecifika omfattning avslutas.
Aktivera autentisering i projektet
Autentisering har konfigurerats i rayfin/rayfin.yml. Följande exempel aktiverar både Fabric SSO (för distribuerade appar) och inloggning med e-post/lösenord (för lokal utveckling):
services:
auth:
enabled: true
allowedRedirectUris:
- http://localhost:5173
fabric:
enabled: true
externalEntraExchange: true
password:
enabled: true # Local development only
Vad varje inställning styr:
-
services.auth.enabled– Aktiverar autentiseringstjänsten. Krävs för all driftsättning av Fabric. -
allowedRedirectUris– De originer som tillåts ta emot användaren efter inloggning. Lägg till din lokala utvecklings-URL här.npx rayfin uplägger till den distribuerade appens ursprung automatiskt. -
fabric.enabled– Aktiverar enkel inloggning (SSO) för Fabric. Krävs för distribuerade appar. -
fabric.externalEntraExchange– Möjliggör direkt delegerat Entra-tokenutbyte och överlämning till extern överordnad värd. Mål-Fabric-miljön måste också stödja utbytet. -
password.enabled– Aktiverar e-post och lösenordsinloggning för lokal utveckling.
Important
Fabric distributioner kräver att autentisering aktiveras.
npx rayfin up misslyckas när services.auth.enabled är inställt på false.
När du har redigerat rayfin.ymlstartar du om den lokala serverdelen eller kör npx rayfin up för att tillämpa ändringen.
Förutsättningar för externt förvärvade Entra-tokens
Direkt utbyte och autentisering för extern överordnad värd kräver en delegerad användartoken för Fabric/Power BI-publiken som accepteras av måldistributionen, med Item.Execute.All, utfärdad i den tenant som äger objektet. Användaren måste också ha Execute-behörighet på appobjektet. App-endast tokens stöds inte av dessa inloggningsvägar.
Ditt identitetsbibliotek hämtar token och hanterar samtycket. Rayfin SDK byter den mot en Rayfin-session; den förvärvar inte Entra-token. Anrop från webbläsare kräver också att tjänstens CORS-policy tillåter ursprunget och auktoriseringshuvudet.
Anpassade anspråk
Med anpassade anspråk kan du bifoga programspecifika metadata till varje session, till exempel ett klientnamn, en funktionsflagga eller en appversion. De är användbara för rollbaserad åtkomstkontroll och funktionsstyrning utan att ändra datamodellen.
services:
auth:
enabled: true
customClaims:
tenant: default
app_version: 1.0.0
Anpassade anspråk visas i sessionsobjektet och kan refereras från dina databehörighetsregler.
Vad SDK:et tillhandahåller
När du använder RayfinClientär autentiseringstjänsten tillgänglig på client.auth. På konceptuell nivå ger den:
- Registrera dig och logga in med e-post och lösenord under den lokala utvecklingen.
- Inloggning och registrering med Fabric SSO för driftsatta appar. Samma anrop hanterar både nya och återkommande användare.
- Direkt delegerat Entra-tokenutbyte i webbläsare eller Node.js-kod, samt överlämning till en betrodd extern överordnad värd för inbäddade appar.
- Logga ut för att avsluta den aktuella sessionen.
- Sessionsläsningar och prenumerationer så att användargränssnittet förblir synkroniserat med användarens autentiseringstillstånd.
För koden som kopplar dessa funktioner till en riktig app, se Configure Fabric SSO authentication for your Fabric app. Vägledning om tillåtelselistor för återanrop och överlämning finns i Konfigurera URI:er för omdirigering vid autentisering.