Konfigurer autentificerings-omdirigerings-URI'er for Fabric Apps

Konfigurer allowedRedirectUris til rayfin/rayfin.yml autentificeringscallbacks og Fabric single sign-on (SSO) handoff. Denne indstilling er en tilladelsesliste over oprindelser og URL'er, som Rayfin kan omdirigere til efter en autentificeringsproces.

Universet understøtter to scenarier:

  • Fabric SSO-overdragelsenpostMessage.
  • Standard autentificeringsopkald.

Konfigurer indstillingen for både en lokal udviklingsapp og en implementeret Fabric-app.

Konfigurer allowedRedirectUris

Tilføj allowedRedirectUris nedenfor services.auth i rayfin/rayfin.yml:

services:
  auth:
    enabled: true
    allowedRedirectUris:
      - http://localhost:5173
Felt Type Standard Beskrivelse
allowedRedirectUris string[] ["http://localhost:5173"] Tillod omdirigerings-URI'er til autentificering, callbacks og Fabric SSO-handoff. Inkluder den bare oprindelse for Fabric-autentificering.

Forstå, hvordan Fabric SSO bruger oprindelsen

Fabric SSO popup-flowet bruger din apps bare oprindelse som måloprindelse for sin postMessage handoff. En nøgen oprindelse inkluderer skemaet, værten og den valgfrie port, men ingen sti. F.eks.:

http://localhost:5173

Værdien skal matche den returnOrigin videreførte til Fabric-autentificeringsudbyderen. For det komplette loginflow, se Configure Fabric SSO-autentificering.

Tilføj hver oprindelse, hvor din app bliver serveret. I de fleste projekter inkluderer denne liste den lokale udviklingsserver og en eller flere deployerede hosting-oprindelser.

Forstå, hvad rayfin up der tilføjer

Når du aktiverer statisk hosting, npx rayfin up tilføjer du automatisk hosting-URL'ens bare oprindelse til allowedRedirectUris under hver udrulning. Du behøver ikke tilføje den deployerede oprindelse manuelt.

Den deployerede oprindelse er nødvendig for Fabric SSO-handoffpostMessage, inklusive når du deaktiverer interaktiv Fabric-autentificering.

For eksempel, hvis den deployerede hosting-URL er https://bold-river-a3f1bc9d02-westus2.webapp.example.com, indeholder konfigurationen både den lokale og den deployerede oprindelse efter deployment:

services:
  auth:
    allowedRedirectUris:
      - http://localhost:5173
      - https://bold-river-a3f1bc9d02-westus2.webapp.example.com

Deployment-kommandoen opdaterer rayfin.yml og sender konfigurationen til backend. Som følge heraf får den rayfin.yml typisk en Fabric-hostet post efter den første udrulning.

Hold tilladelseslisten stramt afgrænset

Behandl allowedRedirectUris det som en sikkerhedsgrænse. Hver angivet oprindelse kan modtage en Fabric SSO-handoff eller gennemføre et autentificeringsopkald for din app.

  • Tilføj kun oprindelser, hvor du serverer din app.
  • Tilføj ikke wildcard eller tredjeparts oprindelse.
  • Gennemgå listen, efter du har kopieret rayfin.yml mellem projekter eller miljøer.
  • Fjern forældede deployment-oprindelser, efter du har bekræftet, at appen ikke længere bruger dem.

En forældet oprindelse fra et andet projekt eller en anden udrulning kan blive et utilsigtet omdirigeringsmål.

Påbevar konfigurationsændringer

Efter du har ændret allowedRedirectUris, udrul den opdaterede konfiguration:

npx rayfin up

De nye redirect-URI'er er ikke tilgængelige for den deployerede autentificeringstjeneste, før du anvender konfigurationen.

Fejlfinding af omdirigerings-URI'er

Fabric SSO rapporterer en oprindelsesmismatch

Bekræft, at:

  • returnOrigin er en nøgen oprindelse uden sti.
  • returnOrigin matcher præcist en indgang i allowedRedirectUris.
  • Den deployerede hosting-oprindelse er til stede efter npx rayfin up.
  • Planen, værten og havnen matcher, inklusive den lokale udviklingshavn.

For yderligere SSO-diagnostik, se Fejlfinding af autentificeringsproblemer.

Konfigurationsændringer træder ikke i kraft

Kør npx rayfin up for at sende den opdaterede rayfin.yml konfiguration til backend. Prøv derefter autentificeringsprocessen igen.

Listen indeholder en ukendt oprindelse

Bestem om oprindelsen tilhører en aktuel lokal udviklingsserver eller en implementeret Fabric-app. Hvis ikke, fjern den fra konfigurationen, kør npx rayfin up, og verificér autentificering fra hvert forventet miljø.

Brug en AI-prompt

Kopier følgende prompt ind i GitHub Copilot eller en anden kodningsagent, der har adgang til dit projekt:

Look at services.auth.allowedRedirectUris in my Rayfin project's rayfin/rayfin.yml.

List every origin currently in it and tell me, for each one, whether it looks like my local
development server, a Fabric-hosted deployment origin that rayfin up added automatically,
or something else that shouldn't be there. Flag anything that isn't clearly one of my own
app's origins, and propose a trimmed list. Do not remove entries without showing me the
before-and-after diff first.

Relateret indhold

  • Sidst opdateret den