Anonym dataåtkomst i Fabric-appar

Anonym dataåtkomst gör det möjligt för en Fabric-app att exponera utvalda dataoperationer för användare som inte är inloggade. Du kontrollerar denna åtkomst på Fabric-tenant-nivå och i varje datamodell. Anonym åtkomst är ett auktorisationsalternativ, inte en ersättning för autentisering. Samma app kan ge offentlig tillgång till vissa entiteter samtidigt som användare måste logga in för andra entiteter eller operationer.

Important

Alla som kan nå appens URL kan använda de operationer som tilldelats anonymous rollen. Exponera inte personlig, konfidentiell, finansiell eller intern affärsdata via den här rollen.

Användningsfall

Tänk på anonym dataåtkomst när en app måste erbjuda begränsad funktionalitet utan inloggningskrav.

Scenario Exempel på åtkomst Rekommenderat omfång
Offentliga referensdata Visa produktkataloger, scheman eller publika datamängder read
Insamling av feedback Skicka in kommentarer eller svar på enkäter create

Anonym åtkomst är inte lämplig när en app måste identifiera användaren, upprätthålla ägarskap eller ge tillgång baserat på identitetsanspråk. Använd autentiserade roller för dessa scenarier.

Så fungerar anonym åtkomst

Anonym dataåtkomst använder oberoende kontroller:

  1. Klientorganisationens inställning: En Fabric-tenantadministratör ger anonym dataåtkomst för organisationen eller utvalda säkerhetsgrupper.
  2. Datamodellroll: En entitet använder anonymous rollen för att definiera de operationer som icke-autentiserade användare kan utföra.

Klientorganisationsinställningen är den övergripande gränsen för organisationen. Appinställningen tillåter anonyma förfrågningar att nå appens datatjänst. Entitetsrollen avgör vilken data och vilka operationer dessa förfrågningar kan komma åt. Att aktivera endast en eller två av dessa kontroller ger inte anonym åtkomst.

Aktivera tenant-inställningen

En Fabric-tenantadministratör måste aktivera anonym dataåtkomst innan apputvecklare kan använda Fabric. Inställningen är inaktiverad som standard.

  1. Logga in på administratörsportalen Fabric.

  2. Välj Hyresgästinställningar.

  3. Under Fabric-appar (förhandsversion), hitta anonym dataåtkomst.

    Skärmdump av inställningen Anonym dataåtkomst i Fabric-administratörsportalen.

  4. Ange växlingsknappen till Aktiverad.

  5. Applicera inställningen på hela organisationen eller på specifika säkerhetsgrupper.

  6. Välj Använd.

Förändringarna kan ta några minuter innan de träder i kraft. När du begränsar inställningen till säkerhetsgrupper, bekräfta att apputvecklaren eller appägaren ingår i en tillåten grupp.

Definiera åtkomst för anonyma användare i en datamodell

Använd dekoratören @role på en entitet och ange anonymous som rollnamn. Det andra argumentet definierar de tillåtna dataoperationerna: create, read, update, eller delete.

Parameters

Parameter Type Beskrivning
roleName string Rollnamnet, till exempel authenticated eller en anpassad programroll
actions string \| string[] Enskild åtgärd eller matris: create, read, update, deleteeller * för alla
options object Valfritt objekt med check, includeoch exclude egenskaper

Följande exempel tillåter oautentiserade användare att läsa offentliga meddelanden:

Lägg till dessa entiteter i datatjänsten konfigurerad i rayfin/rayfin.yml. I standardappen Universal App aktiverar du Data och använder packages/data/src/, med matchande avtal i packages/shared/src/. En platt mall kan användas rayfin/data/ istället. Se Definiera datamodeller.

import { entity, role, uuid, text } from '@microsoft/rayfin-core';

@entity()
@role('anonymous', 'read')
export class Announcement {
  @uuid() id!: string;
  @text({ max: 200 }) title!: string;
  @text({ max: 4000 }) content!: string;
}

Rollen anonymous använder inte identitetsanspråk eftersom ingen inloggad identitet finns tillgänglig. Definiera den snävaste uppsättningen operationer som stöder ditt scenario.

Tillåt användare att skicka in data

För ett feedbackformulär, ge create tillgång utan att ge read, update, eller delete tillgång:

import { entity, role, uuid, text } from '@microsoft/rayfin-core';

@entity()
@role('anonymous', 'create')
export class Feedback {
  @uuid() id!: string;
  @text({ max: 2000 }) comment!: string;
}

Denna modell låter användare lämna in feedback, men den tillåter dem inte att se eller ändra inskickade poster.

Tillåt flera operationer

Skicka en array när ett scenario kräver mer än en operation:

import { boolean, entity, role, text, uuid } from '@microsoft/rayfin-core';

@entity()
@role('anonymous', ['create', 'read', 'update'])
export class SharedTodo {
  @uuid() id!: string;
  @text({ max: 200 }) title!: string;
  @boolean({ default: false }) completed!: boolean;
}

Alla med tillgång till denna app kan skapa, se och uppdatera varje delad att-göra-uppgift. De kan inte radera att göra-uppgifter eftersom delete inte ingår. Använd breda behörigheter som dessa endast för offentliga eller tillfälliga data där användare förväntas dela åtkomst.

Kombinera anonyma och autentiserade roller

Tillämpa båda rollerna på en entitet när publika och inloggade användare kräver olika behörigheter. Till exempel kan vem som helst läsa ett blogginlägg, men endast dess inloggade ägare kan ändra det:

import { entity, role, uuid, text } from '@microsoft/rayfin-core';

@entity()
@role('anonymous', 'read')
@role('authenticated', ['create', 'update', 'delete'], {
  policy: (claims, item) => claims.sub.eq(item.createdBy),
})
export class BlogPost {
  @uuid() id!: string;
  @text({ max: 200 }) title!: string;
  @text({ max: 4000 }) content!: string;
  @text({ max: 255 }) createdBy!: string;
}

Den anonyma rollen tillåter offentlig läsåtkomst utan att utvärdera identitetsuppgifter. Den autentiserade rollen använder den inloggade användarens claims för att begränsa ändringar till innehåll som användaren äger.

Säkerhetsvägledning

  • Ge den minsta behörighet som krävs. Välj read eller create separat. Bevilja update eller delete bara när det publika arbetsflödet kräver det.
  • Begränsa exponerade fält. Använd include eller exclude alternativ för att förhindra åtkomst till fält som anonyma användare inte behöver. För mer information, se Definiera databehörigheter.
  • Lita inte på appens gränssnitt för skydd. Behörigheter måste definieras på datamodellen eftersom anropare kan skicka förfrågningar utan att använda ditt frontend.
  • Planera för obetrodd indata. Validera inskickad data och utforma publika skrivoperationer för spam, automatisering och oväntad trafik.
  • Testa nekade åtgärder. Kontrollera att operationer som utelämnats från rollen avvisas för användare utan session.

Inaktivera anonym åtkomst

För att ta bort offentlig åtkomst från en app:

  1. Ta bort anonymous rollen från varje datamodell.
  2. Distribuera om appen genom att köra npx rayfin up.

En administratör för klientorganisationen kan också inaktivera inställningen för klientorganisationen för att blockera anonym dataåtkomst för alla appar inom en klientorganisation och begränsa åtkomsten till utvalda säkerhetsgrupper.