Migrer fra Auth0 til FoxIDs

Flytt pålogginger fra Auth0 til FoxIDs med migreringsmetoden som passer hver tilkobling. Importer databasebrukere med bcrypt passordhasher, eller la dem velge et nytt passord. Importer passordfrie brukere uten passord og aktiver engangskoder. For sosiale pålogginger og bedriftspålogginger konfigurerer du autentiseringsmetoder i FoxIDs som stoler på de eksterne identitetsleverandørene.

Denne tekniske veiledningen dekker applikasjonskonfigurasjon, brukerimport og kontotilordning for Auth0 databasetilkoblinger, passordfrie e-post-/SMS-tilkoblinger samt sosiale tilkoblinger og bedriftstilkoblinger.

For databasebrukere og passordfrie brukere konverterer du den gjennomgåtte eksporten fra Auth0 til en CSV-fil og bruker FoxIDs Seed Tool til å masselaste brukerne inn i FoxIDs. CSV-eksemplene nedenfor viser feltene for hver migreringsmetode.

Velg en metode for hver gruppe før du forbereder importen:

Importerte brukere med passord og passordfrie brukere autentiseres lokalt i FoxIDs. Sosiale brukere og bedriftsbrukere autentiseres hos den tilkoblede identitetsleverandøren.

Forbered målet og applikasjonen

Et eget testmiljø lar deg prøve migreringen med en liten brukergruppe før produksjon. Konfigurasjonstrinnene er:

1. Hvis du ønsker et egendefinert domene, konfigurerer og verifiserer du det på leieren før du konfigurerer applikasjoner og eksterne identitetsleverandører. Bruk de resulterende FoxIDs URL-ene gjennom hele migreringen. Endring av domenet senere krever oppdatering av eksterne konfigurasjoner, inkludert applikasjonenes authority- eller metadata-URL-er og leverandørenes callback- og utloggings-URL-er.
2. Hvert miljø har en standard Login-autentiseringsmetode kalt login. Tilpass merkevarebygging og påloggingsgrensesnitt til ønsket utseende, og juster påloggingsalternativene for de importerte brukerne.
3. Opprett autentiseringsmetodene som kobler sosiale brukere og bedriftsbrukere til deres eksterne identitetsleverandører, i henhold til relevant migreringsavsnitt nedenfor.
4. Konfigurer applikasjonen, tillatte omdirigerings-URL-er og utloggingsatferd samt eventuelle API-er som godtar tilgangstokenene.

FoxIDs Cloud tilbyr levering av e-post og SMS for passordoppsett, passordfri pålogging og flerfaktorautentisering (MFA), avhengig av valgt FoxIDs Cloud abonnement.

Konfigurer nødvendige MFA-innstillinger og hvordan brukerne skal registrere seg; importene beskrevet her overfører ikke MFA-registreringer fra Auth0. For passordkontoer gjennomgår du krav til passordlengde, kompleksitet og utløp: import av en hash hopper over validering av passordpolicy under importen, men valgt policy gjelder når brukeren logger på.

Applikasjonskonfigurasjon er et eget arbeid ved siden av brukerimporten. Gjennomgå utsteder, målgruppe, scopes, claims og tokenvalidering samt eventuelle forutsetninger i Auth0 SDK, Actions, organisasjonsmedlemskap og rolletildelinger. Implementer atferden applikasjonen trenger. Den generelle migreringsveiledningen dekker den samlede applikasjonsoversikten og utrullingstrinnene.

Eksporter en definert gruppe Auth0 brukere

Følg Auth0s instruksjoner for masseeksport av brukere. Velg kildetilkoblingen uttrykkelig med connection_id; en API-eksport uten dette inkluderer alle tilkoblinger. Hold databasebrukere, passordfrie brukere og fødererte brukere atskilt under konverteringen.

Bruk JSON-kompatibel eksport (NDJSON) som kilde for konverteringen. Auth0 CSV-eksporter bruker ekstra escaping og er derfor ikke ferdige inndata til FoxIDs Seed Tool. En liten eksport kan brukes til å prøve konverteringen til Seed Tools CSV-format.

Ta med user_id, blocked og identifikatorene og verifiseringsstatusen som hver tilkobling bruker: email og email_verified, eller phone_number og phone_verified for SMS-brukere. For sosiale kontoer, bedriftskontoer og koblede kontoer beholder du leverandør, tilkobling og bruker-ID fra identities for kontotilordningen. Eksporter bare brukerdata som trengs etter migreringen, og behold kildeleier og kildetilkobling sammen med eksporten. Se Auth0s brukerprofilskjema når du velger felt.

Hent passordhasher når passord skal beholdes

Be om passordhasheksporten gjennom Auth0 Support. Den er separat fra eksporten av brukerdata. Auth0s veiledning for eksport av passordhasher beskriver NDJSON-postene og feltet passwordHash. Eksemplet $2b$10$... angir bcrypt varianten 2b og kostnaden 10.

Koble hver hash til riktig bruker ved hjelp av kildeleier, databasetilkobling og bruker-ID.

Tilordne brukerdata og bevar applikasjonskontoer

FoxIDs oppretter sin egen varige bruker-ID for importerte lokale brukere. Import av en Auth0 user_id som et egendefinert claim gjør den ikke til brukerens FoxIDs ID og bevarer ikke automatisk applikasjonens sub-claim. For sosiale pålogginger og bedriftspålogginger verifiserer du identiteten mottatt direkte fra leverandøren og subject som FoxIDs utsteder til applikasjonen.

For å beholde brukerens Auth0 ID som applikasjonens sub importerer du den som et egendefinert claim, for eksempel legacy_auth0_user_id. På Login-autentiseringsmetoden konfigurerer du en Map claim-transformasjon med handlingen Replace claim, inndataclaim legacy_auth0_user_id og utdataclaim sub. Applikasjonen mottar da brukerens Auth0 ID som sub, mens brukerens varige FoxIDs ID forblir uendret.

Oppretthold en tilordning mellom kildeidentiteten, den nye FoxIDs identiteten og den eksisterende applikasjonskontoen. For eksempel bør den gamle Auth0 identiteten og den nye FoxIDs identiteten begge vise til samme kundepost under overgangen, ikke opprette to kundeposter. Verifiser faktisk subject utstedt til hver applikasjon og oppdater kontotilordningen ved behov. Ikke koble kontoer bare fordi e-postadressene samsvarer.

For import av lokale brukere bruker du følgende tilordning:

Migrer sosiale pålogginger og bedriftspålogginger

Opprett en autentiseringsmetode i FoxIDs for hver sosial tilkobling eller bedriftstilkobling, med direkte tillit til den eksterne identitetsleverandøren. Brukerne beholder kontoene og påloggingsopplysningene hos leverandøren.

1. Identifiser leverandøren og konfigurasjonen bak hver Auth0 tilkobling. Bruk relevant integrasjonsveiledning for leverandøren, for eksempel Google, Facebook eller Microsoft Entra ID, og velg en støttet autentiseringsmetode for OpenID Connect, SAML 2.0 eller WS-Federation.
2. Registrer eller konfigurer FoxIDs hos leverandøren. Utveksle klientinnstillinger eller føderasjonsmetadata og konfigurer callback- og utloggings-URL-ene angitt i integrasjonsveiledningen. Behold Auth0 konfigurasjonen under overgangen.
3. Tillat den nye autentiseringsmetoden på applikasjonen i FoxIDs. Konfigurer Home Realm Discovery slik at brukerne kan velge leverandør eller rutes dit av konfigurerte regler.
4. Samordne leverandøridentiteten med den eksisterende applikasjonskontoen. Identifikatorene fra en testpålogging kan sammenlignes med kildekontoen; en Auth0 bruker-ID er ikke nødvendigvis identifikatoren returnert direkte til FoxIDs. Hvis du trenger å lagre claims eller tilgangstildelinger per bruker i FoxIDs, konfigurerer og klargjør du eksterne brukere.
5. Gjenopprett eventuelle begrensninger som Auth0 tidligere håndhevet, inkludert blokkerte brukere og organisasjonstilgang.

Forventet flyt er applikasjon → FoxIDs → ekstern identitetsleverandør → FoxIDs → applikasjon. FoxIDs utsteder applikasjonens tokener etter at leverandøren autentiserer brukeren.

Du kan prøve hver tilkobling ved å starte pålogging fra applikasjonen, velge leverandøren og fullføre påloggingsflyten. Da kan du observere MFA, applikasjonskonto og rettigheter samt utloggingsatferd.

Migrer passordfrie brukere

Importer brukere fra Auth0s passordfrie e-post- eller SMS-tilkoblinger som interne FoxIDs brukere uten passord. Konfigurer passordfri pålogging slik at de fortsetter å logge på med en engangskode. Brukere som tidligere mottok en magisk lenke fra Auth0, oppgir i stedet en engangskode på påloggingssiden de allerede har åpnet. Dermed slipper brukerne å følge påloggingslenker i e-post eller SMS.

1. Aktiver e-post eller telefon som påloggingsidentifikator på autentiseringsmetoden FoxIDs Login, og aktiver Passwordless with email (one-time password) eller Passwordless with SMS (one-time password) etter behov.
2. For en påloggingsmetode beregnet på passordfrie brukere velger du Disable password authentication og deaktiverer passordoppsett/tilbakestilling via e-post og SMS. Dette holder påloggingsflyten konsentrert om engangskoder.
3. Importer brukerne uten Password og alle passordhashfelt. La SetPasswordEmail, SetPasswordSms og ChangePassword være false slik at brukerne ikke må velge passord. Bevar verifiseringsstatus, deaktiveringsstatus og nødvendige claims.

For å prøve passordfri pålogging kan du starte pålogging med en importert testbrukers e-postadresse eller telefonnummer og oppgi koden du mottar. En gyldig kode lar en aktivert bruker fortsette gjennom eventuell påkrevd MFA til applikasjonen; ugyldige eller utløpte koder og deaktiverte kontoer gir ikke tilgang.

Denne CSV-filen for Seed Tool importerer for eksempel en fiktiv bruker med passordfri e-postpålogging:

Email;EmailVerified;SetPasswordEmail;SetPasswordSms;ChangePassword;DisableAccount
alice@example.com;true;false;false;false;false

For SMS-brukere erstatter du Email og EmailVerified med Phone og PhoneVerified, med gjennomgått telefonnummer og verifiseringsstatus. Samme opplastingsprosedyre gjelder. Brukeren forblir uten passord etter vellykket passordfri pålogging.

Importer brukere med bcrypt passordhasher

FoxIDs godtar fullstendige bcrypt strenger med prefiksene $2a$, $2b$ eller $2y$ og kostnader fra 4 til 16. For brukere med hasher utenfor støttet format bruker du passordoppsett via e-post.

Aktiver e-postpålogging og passordautentisering på autentiseringsmetoden FoxIDs Login for disse brukerne.

Kopier hver samsvarende Auth0 passwordHash-verdi til CSV-kolonnen PasswordHash, og sett PasswordHashAlgorithm til bcrypt. Bevar hele hashstrengen, inkludert variant, kostnad og innebygd salt. Den er allerede kodet for bcrypt. Se passordhashformater og Control API-kontrakten for passordimport.

Bruk følgende kolonner for Seed Tool. Dette er en syntetisk testkonto; erstatt den med din gjennomgåtte eksport:

Email;EmailVerified;PasswordHashAlgorithm;PasswordHash;SetPasswordEmail;ChangePassword;DisableAccount
alice@example.com;true;bcrypt;$2b$10$..CA.uOD/eaGAOmJB.yMBu3YunYvFEoaS5IJZ/wiqfQ/EWx.HaqjC;false;false;false

Utelat Password og PasswordHashSalt. La SetPasswordEmail, SetPasswordSms og ChangePassword være false når brukeren skal fortsette med eksisterende passord. Bevar deaktiveringsstatus, verifiseringsstatus, claims og MFA-krav fra den gjennomgåtte tilordningen. Ta med PasswordLastChanged hvis du kjenner opprinnelig endringstidspunkt, i Unix-sekunder; ellers registrerer FoxIDs importtidspunktet for kontroller av passordalder.

Samme opplastingsprosedyre gjelder for alle importer av lokale brukere. Masseklargjøring kan erstatte en eksisterende konto og påloggingsopplysningene, uavhengig av valgt passordformat.

Med en importert testbruker kan du prøve pålogging med det opprinnelige passordet og deretter med et feil passord. Det opprinnelige passordet autentiserer brukeren i henhold til konfigurert passordpolicy og MFA; et feil passord eller en deaktivert konto gir ikke tilgang. Passordendring og gjenoppretting kan også prøves gjennom det konfigurerte påloggingsgrensesnittet.

Den importerte hashen forblir bcrypt etter pålogging. Et passord som angis eller endres i FoxIDs, lagres med FoxIDs standardformat PBKDF2. Passordhistorikken fortsetter å forhindre gjenbruk i henhold til valgt policy, også når en gammel bcrypt hash beholdes etter en passordtilbakestilling.

Importer brukere for passordoppsett

Bruk denne metoden for kontoer som skal velge et nytt passord i stedet for å importere en hash. Aktiver e-postpålogging, passordautentisering og passordoppsett via e-post på autentiseringsmetoden FoxIDs Login. For brukere som skal fortsette uten passord, følger du Migrer passordfrie brukere.

Brukerimporten forbereder kontoene. Passordoppsett skjer når hver bruker starter en pålogging, ikke under importen.

Konverter de gjennomgåtte postene til en UTF-8-fil for FoxIDs Seed Tool. Kolonneoverskriftene skiller mellom store og små bokstaver, og skilletegnet er semikolon. Eksemplet inneholder fiktive brukere med tidligere verifiserte e-postadresser; den andre kontoen forblir deaktivert:

Email;EmailVerified;SetPasswordEmail;DisableAccount;RequireMultiFactor;Claims
alice@example.com;true;true;false;true;"[{""Claim"":""legacy_auth0_user_id"",""Values"":[""auth0|demo-001""]}]"
blocked@example.com;true;true;true;true;"[{""Claim"":""legacy_auth0_user_id"",""Values"":[""auth0|demo-002""]}]"

SetPasswordEmail=true velger passordoppsett med e-postbekreftelse. Utelat Password og alle passordhashkolonner. Du trenger ikke et midlertidig felles passord eller ChangePassword for denne flyten. RequireMultiFactor=true er eksemplets valgte policy og krever at tilsvarende MFA-metoder konfigureres.

Utlever bare eksemplets claim legacy_auth0_user_id til applikasjoner som trenger det gjennom sin konfigurerte claim-håndtering.

Last opp brukere og kontroller resultatet

Bruk denne opplastingsprosedyren for brukere med bcrypt hasher, passordfrie brukere og brukere som skal velge et passord ved første pålogging, med feltene som passer valgt metode.

Seed Tool deler felt ved semikolon; felt i anførselstegn kan ikke inneholde semikolon eller linjeskift. Bruk Control APIs brukeroperasjoner hvis verdiene trenger en rikere importrepresentasjon.

1. Last ned og konfigurer Seed Tool for ønsket miljø. Sett SeedSettings.UsersSvcPath til den konverterte CSV-filen.
2. Kjør Seed Tool og velg U for å masselaste opp brukerne.
3. Registrer de nye bruker-ID-ene i migreringstilordningen.

Du kan prøve opplastingen med en CSV-fil med noen få brukere i et testmiljø. Seed Tool rapporterer antall vellykkede og mislykkede operasjoner. De importerte brukerne kan undersøkes i FoxIDs Control for å se identifikatorer, deaktiveringsstatus, claims og passordoppsettflagg.

Seed Tool bruker masseklargjøring, som kan erstatte eksisterende brukere i stedet for å slå dem sammen på en trygg måte. Kontroller kollisjoner før opplasting. Ikke kjør hele filen på nytt etter at brukere har angitt passord eller fått tilgang: erstatning kan fjerne påloggingsopplysninger og tilstand og opprette nye bruker-ID-er. Avstem en delvis fullført import før du prøver igjen; håndter senere endringer med gjennomgåtte, målrettede brukeroppdateringer.

Passordoppsett ved første pålogging

For en aktivert importert bruker med SetPasswordEmail=true er forventet flyt:

1. Brukeren åpner applikasjonen og starter pålogging gjennom FoxIDs Login.
2. FoxIDs identifiserer brukeren fra e-postadressen og sender en bekreftelseskode.
3. Brukeren sender inn koden og et nytt passord som oppfyller FoxIDs passordpolicy.
4. FoxIDs verifiserer e-postadressen, lagrer passordet og nullstiller passordoppsettflaggene. Påloggingen fortsetter gjennom eventuelle påkrevde MFA-trinn før brukeren returnerer til applikasjonen.

Import av en bruker sender ikke e-postmeldingen for passordoppsett. Senere passordpålogginger bruker det nye FoxIDs passordet, ikke det tidligere Auth0 passordet. Hvis en bruker ikke kan motta koden, bruker du en godkjent gjenopprettingsprosess som verifiserer identiteten.

Du kan utforske flyten med en testbruker ved å følge påloggingstrinnene ovenfor. Disse scenariene viser forventede resultater:

Rull ut og behold en vei tilbake

Migreringen kan rulles ut per applikasjon eller brukergruppe. Brukerne kan fortsette via sin vanlige applikasjons-URL med konfigurert påloggingsflyt: eksisterende passord, passordoppsett, en engangskode eller eksisterende ekstern identitetsleverandør.

Før hver produksjonsimport avstemmer du brukere som er opprettet, endret, blokkert eller slettet siden eksporten. Definer en kort endringsfrys eller en annen kontrollert avstemmingsprosess. Ikke overskriv brukere som allerede er migrert for å gjennomføre disse endringene.

Overvåk levering av e-post og SMS, oppsettfeil, påloggingsfeil og problemer med kontotilordning. For hashimport tar du hensyn til passordendringer i Auth0 etter eksporten, slik at brukerne ikke møter opp med et passord som avviker fra den importerte hashen. Tilbakerulling avhenger av at den tidligere Auth0 konfigurasjonen fortsatt er tilgjengelig. Du kan prøve å gjenopprette konfigurasjonen for en testapplikasjon for å observere returen til påloggingsflyten i Auth0.

Et passord angitt i FoxIDs synkroniseres ikke tilbake til Auth0. En tilbakerulling bruker derfor påloggingsopplysningene som fortsatt finnes i Auth0. Definer hvordan brukere opprettet bare i FoxIDs får tilgang gjennom Auth0 hvis tilbakerulling blir nødvendig. For passordfri og føderert pålogging beholder du leveringsinnstillingene og leverandørtilkoblingene i Auth0 som trengs for å gjenopprette den tidligere flyten. Avvikle den gamle integrasjonen og slett beholdte eksportfiler først når kontotilgang og driftsstøtte er godkjent.

Relatert dokumentasjon

• Migreringsoversikt
• Last opp mange brukere
• Control APIs brukeroperasjoner
• Pålogging og Home Realm Discovery
• E-postleverandør
• Applikasjoner