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.
Gäller för:
Externa klienter (läs mer)
Autentiseringsmetod: Inbäddad intern autentisering.
API:et för intern autentisering använder ett svarsdrivet flöde i Microsoft Entra External ID externa klienter. Starta auktoriseringen, slutför de returnerade autentiseringsinteraktionerna, återuppta auktoriseringen och byt ut auktoriseringskoden för token. Den här referensen definierar delade åtgärder. resespecifika referenser definierar inloggningsidentifiering, registreringsattribut och lösenordsåterställning.
Använd V1 API-referensen för en befintlig V1-integrering. Se Migrera från V1 till V2 för paketversioner, migreringskrav och SDK-integreringsinformation.
Prerequisites
Important
API V2 för intern autentisering är i förhandsversion. API V1 för intern autentisering är fortfarande allmänt tillgängligt. Se kompletterande användningsvillkor för Microsoft Azure förhandsversioner för juridiska villkor som gäller för förhandsversionsfunktioner.
- En extern klientorganisation och ett program som konfigurerats för offentliga klient- och interna autentiseringsflöden. Se Konfigurera ett program.
- Ett användarflöde som är associerat med programmet.
- För webbläsarbaserade appar, till exempel SPA: er, en klientverifierad anpassad URL-domän som konfigurerats för tjänst-API-anrop.
- De delegerade behörigheter och medgivande som krävs av målresursen om du begär åtkomst till ett API.
- För SPA:er med inbäddad intern autentisering och BYO UX-webbplatser, en proxy- eller gränsprincip som implementerar kraven för webbläsarproxy.
Åtgärder och utfärdare
Exemplen använder https://{custom_domain}/{tenant}, där custom_domain är en klientverifierad autentiseringsdomän, till exempel login.contoso.com, och tenant är dess katalog-ID (klientorganisation), ett GUID.
client_id är program-ID :t (klient). I de här exemplen använder alla URL:er för api-anrop i tjänsten den här anpassade domänen, inklusive auktoriseringsutmaningar och tokenutbyte.
API V2 för intern autentisering kräver en klientverifierad anpassad domän för webbläsarbaserade appar, till exempel SPA:er, för att skydda mot förfalskning av begäranden mellan webbplatser (CSRF). Icke-webbläsarklienter, till exempel iOS- och Android-appar som använder interna HTTP-transporter, kräver ingen anpassad domän. En inbäddad webbläsare eller webbvy är inte en intern HTTP-transport. BYO UX förblir webbläsarbaserad och kräver en klientverifierad anpassad domän. Se Konfigurera API-utfärdare.
Förutom den första auktoriseringsbegäran och tokenutbytet använder du url:en som annonseras av det aktuella svaret. Metod-ID:t är ogenomskinliga. Lös relativa länkar mot den konfigurerade utfärdarens ursprung, verifiera målet och behåll den returnerade sökvägen och frågan oförändrad.
Auktoriseringsstart, återuppta och kodutbyte nedan beskriver inbäddad intern autentisering. En BYO UX-sida använder i stället sin webbläsarhandoff och returnerade slutlänk runt de delade interna interaktionsåtgärderna. Starta eller återuppta /authorize-challenge inte i byo UX-transaktionen.
| Operation | Method | Sökväg eller länk |
|---|---|---|
| Starta auktorisering | POST |
/{tenant}/oauth2/v2.0/authorize-challenge |
| Återuppta auktorisering | POST |
Returnerad continue länk. |
| Starta inloggning | POST |
Returnerad sign_in länk. Exempel använder /{tenant}/api/v2.0/signin/start. |
| Starta registreringen | POST |
Returnerad sign_up länk. Exempel använder /{tenant}/api/v2.0/signup/start. |
| Skicka registreringsattribut | POST |
Returnerad submitAttributes länk. |
| Starta lösenordsåterställning | POST |
Returnerad länk för återställningslösenord; exempel använder /{tenant}/api/v2.0/resetpassword/start. |
| Starta infogad lösenordsåterställning | POST |
Lösenordsmetodens returnerade recover länk. |
| Registrera en autentiseringsmetod | POST |
Den valda metodens returnerade enroll länk. |
| Aktivera en autentiseringsmetod | POST |
Returnerad activate länk. |
| Utmana eller skicka om | POST |
Returnerad challenge eller resend länk. |
| Verifiera en autentiseringsuppgift | POST |
Returnerad verify länk. |
| Uppdatera ett lösenord | PUT |
Returnerad update länk. |
| Uppdatering av avsökningslösenord | POST |
Returnerad poll länk. |
| Exchange en auktoriseringskod | POST |
/{tenant}/oauth2/v2.0/token |
Interna exempel använder /api/v2.0; OAuth-åtgärder använder /oauth2/v2.0. Använd klientorganisations-GUID i dessa utfärdarexempel. Följ returnerade länkar utan att skriva om sökvägar, versioner eller frågeparametrar.
Headers
OAuth- och inbyggda autentiseringsåtgärder använder olika brödtextkodningar.
| Sidhuvud | Använd |
|---|---|
Content-Type: application/x-www-form-urlencoded |
Krävs för auktoriseringsutmaning och tokenbegäranden. |
Content-Type: application/json |
Krävs för inbyggda autentiseringsbegärandeorgan. |
Accept: application/hal+json |
Rekommenderas för interna autentiseringsbegäranden. |
client-request-id: {guid} |
Rekommenderad. Generera ett nytt värde för varje flöde och behåll det för diagnostik. |
Krav för webbläsarproxy
Dessa krav gäller för webbläsar-API-anrop från SPA:er med inbäddad intern autentisering och BYO UX-webbplatser. Android- och iOS-appar som använder inbyggda HTTP-transporter behöver inte CORS-konfiguration eller cors-proxy.
Interna autentiseringsvägar hanterar OPTIONS, men bevilja inte åtkomst till webbläsarens ursprung via Access-Control-Allow-Origin. Webbläsarintegreringar mellan ursprung behöver därför en proxy- eller gränskonfiguration som:
- Vidarebefordrar tjänstens lyckade preflight-svar och tillämpar den konfigurerade ursprungsprincipen för webbläsare.
- Returnerar
Access-Control-Allow-Originför det exakta tillåtna ursprunget, inte*. - Tillåter åtgärdens obligatoriska
POSTellerPUTmetod och de begärandehuvuden som används av integreringen. - Bevarar begärandeorgan, svarsstatuskoder, innehållstyper och transaktionslänkar utan cachelagring av autentiseringssvar.
- Hanterar ursprung och routning konsekvent över auktorisering, interna åtgärder och tokenutbyte.
- Bevarar vägledning för återförsök, inklusive
Retry-After, och exponerar den för webbläsarkod när det behövs.
Se CORS-begrepp för inbyggd autentisering för webbläsargränsen och lokal proxykonfiguration för utveckling.
Fortsättningstoken
En fortsättningstoken representerar autentiseringstransaktionen i det aktuella skedet. Den är bunden till klientorganisationen, klienten, scenariot och åtgärden.
| Meddelandeformat | Fält |
|---|---|
| OAuth | continuation_token |
| API för intern autentisering | continuationToken |
Använd endast den aktuella token med den åtgärd som identifieras av samma svar. Parsa, ändra, logga eller spara den inte utöver den aktiva transaktionen. När ett svar tillhandahåller en ersättning slutar du använda den tidigare token. Flytta inte en token till en annan användare eller resa. Starta om auktoriseringen efter förfallodatum.
Den dokumenterade standard giltigheten är 10 minuter för en enskild fortsättningstoken. Hantera förfallodatum enligt tjänstsvaret. en nyare token är inte en garanti för att utöka hela resan. Token och ett engångslösenord har separata livslängder. Auktoriseringskoder är kortvariga och engångsanvändande. tolka inte ett tokensvar som livslängden för auktoriseringskoden expires_in .
Svarsmodell
Lyckade interna interaktionsåtgärder returnerar HAL JSON. Nästa åtgärd kan variera även för efterföljande anrop till samma slutpunkt. Fält är specifika för svaret: till exempel kan en omdirigering endast stateinnehålla .
| Medlem | Purpose |
|---|---|
continuationToken |
Token för nästa tillåtna begäran, när den ingår. |
state |
Aktuellt transaktionstillstånd. |
action |
Nödvändig interaktion för ett interactionRequired svar. |
_links |
URL:er för tillåtna åtgärder. |
_embedded |
Relaterade resurser, inklusive tillgängliga metoder. |
Flödeskonceptet förklarar tillstånd och åtgärder. För interactionRequiredhanterar du den returnerade åtgärden med hjälp av en tillåten åtgärd. För continueåterupptar du auktoriseringen via den returnerade länken. En enskild åtgärds completed tillstånd bekräftar inte att token har utfärdats.
En intern transaktion som inte kan fortsätta kan returnera:
{
"state": "redirect"
}
Det här svaret anger inte en fortsättningstoken, länkar eller en url för överlämning av webbläsare. Stoppa interna begäranden och erbjuda en separat konfigurerad webbläsarinloggning eller ett tydligt fel. Webbläsarinloggning startar om autentiseringen. den återupptar inte den interna förloppet.
Åtgärd för kontoval
Note
Kontoval är inte relevant för inbäddad intern autentisering och stöds ännu inte för byo UX-sidor med egen värd.
disambiguate identifierar kontoval under state: interactionRequired.
Länkrelationer
Använd länkar från det senaste svaret och verifiera utfärdaren innan du vidarebefordrar hemligheter.
| Relation | Purpose |
|---|---|
self |
Aktuell resurs eller åtgärd. |
discover |
Skicka in en inloggningsidentifierare. |
challenge |
Starta den valda metodens utmaning. |
verify |
Verifiera ett lösenord eller engångslösenord. |
resend |
Begär ett annat engångslösenord. |
submitAttributes |
Skicka begärda registreringsvärden. |
recover |
Starta lösenordsåterställning i den aktiva inloggningstransaktionen. |
enroll |
Starta registreringen av en annonserad autentiseringsmetod. |
activate |
Verifiera koden för en registrerad metod. |
update |
Skicka ett ersättningslösenord. |
poll |
Kontrollera en asynkron uppdatering. |
continue |
Återuppta OAuth-auktorisering. |
Den här åtgärden är relevant för byo-kontoval (Bring Your Own UX). Inbäddade inbyggda autentiseringsintegreringar använder den inte, och kontoval på den lokala BYO UX-sidan stöds inte för närvarande.
Om din BYO UX-integrering följer den rekommenderade lösningen genom att skicka login_hint eller prompt=login i auktoriseringsbegäran avbryts inte det befintliga användargränssnittet om du introducerar kontoval.
Åtgärdsnyttolasten är en del av den befintliga BYO UX-webbläsarens initialResponse överlämning och innehåller:
-
state: interactionRequired,action: disambiguateoch encontinuationTokenför den väntande markeringen. - En
_embedded.usermatris med information om varje erbjudet konto och länkar som stöds. Ett aktivt konto har en kontospecifik_links.resumeURL. - En url på svarsnivå
_links.discoverför ett inaktivt konto eller Använd ett annat konto.
Resurser för autentiseringsmetod
Val av befintlig autentiseringsuppgiftsmetod använder _embedded.methods. Tjänsten kan också välja en enda metod. En befintlig autentiseringsuppgift har en ogenomskinlig id, till type exempel password, emaileller sms, och länkar för tillåtna åtgärder. En maskerad hint identifierar ett mål utan att avslöja det i sin helhet. isPreferred Det är valfria inställningsmetadata. Registreringsval har en separat representation och behöver inget befintligt autentiserings-ID.
{
"_embedded": {
"methods": [
{
"id": "{id}",
"type": "email",
"hint": "u***@contoso.com",
"isPreferred": true,
"_links": {
"challenge": {
"href": "/{tenant}/api/v2.0/auth/methods/email/{id}/challenge"
},
"verify": {
"href": "/{tenant}/api/v2.0/auth/methods/email/{id}/verify"
}
}
}
]
}
}
Det här fragmentet illustrerar metodmetadata. Metodtillgänglighet bestäms för varje transaktion. Din app kan presentera tillgängliga metoder eller välja en via programflödeslogik. Utmaningen och verifieringen fungerar på den valda metoden. metodregistrering har ett separat kontrakt.
Kräver inte valfria presentationsmetadata som pages eller scenario. Exemplen beskriver grundläggande lösenords- och e-post-/SMS-interaktioner, inte alla ytterligare metodspecifika krav.
Starta auktorisering
Skicka programmet, omfången och valfria anspråk på den första begäran. Formulärkodade värden; radbrytningarna nedan är för läsbarhet.
POST https://{custom_domain}/{tenant}/oauth2/v2.0/authorize-challenge
Content-Type: application/x-www-form-urlencoded
client_id={client_id}&
scope=openid%20profile%20offline_access&
response_type=code
| Parameter | Använd |
|---|---|
client_id |
Program-ID (klient) krävs. |
scope |
Omfång för dina programbegäranden. Inkludera OpenID Connect (OIDC) och resursomfattningar som behövs för de resulterande token. |
response_type |
code i det här exemplet. Slutpunkten returnerar en auktoriseringskod efter autentisering. |
claims |
Valfri JSON-kodad OpenID Connect-anspråksbegäran. |
När autentisering krävs är 401 Unauthorizedsvaret , med Content-Type: application/json:
{
"error": "InsufficientAuthorization",
"error_description": "AADSTS500127: No authenticated credentials found in request.",
"error_codes": [
500127
],
"timestamp": "2026-08-28T17:30:00Z",
"trace_id": "0000aaaa-11bb-cccc-dd22-eeeeee333333",
"correlation_id": "aaaa0000-bb11-2222-33cc-444444dddddd",
"continuation_token": "******",
"reset_password": "/{tenant}/api/v2.0/resetpassword/start",
"sign_in": "/{tenant}/api/v2.0/signin/start",
"sign_up": "/{tenant}/api/v2.0/signup/start"
}
Inloggnings- och registrerings-URL:er är villkorliga. Reselänkar är OAuth-svarsegenskaper på toppnivå, inte _links poster. Välj en annonserad resa och skicka dess token som continuationToken i JSON-begäran. Hantera alla principer eller kontospecifika avvisanden.
Återuppta auktorisering
När det aktuella svaret returnerar state: continuepublicerar du den senaste token till _links.continue.href. Skicka inte den första client_id, scopeeller claims i den här begäran igen.
POST https://{custom_domain}/{tenant}/oauth2/v2.0/authorize-challenge
Content-Type: application/x-www-form-urlencoded
continuation_token={continuation_token}
Det lyckade svaret är 200 OK och JSON:
{
"code": "{authorization_code}"
}
Auktoriseringskoder är kortvariga och engångsanvändande. Exchange koden i stället för att behandla den som en åtkomsttoken.
Exchange auktoriseringskoden
Publicera koden med samma program-ID:
POST https://{custom_domain}/{tenant}/oauth2/v2.0/token
Content-Type: application/x-www-form-urlencoded
client_id={client_id}&
grant_type=authorization_code&
code={authorization_code}
Alla tre parametrarna krävs.
grant_type är authorization_code. Den här offentliga klientbegäran innehåller ingen klienthemlighet.
Det lyckade svaret är 200 OK och JSON:
{
"token_type": "Bearer",
"expires_in": 3600,
"access_token": "******",
"id_token": "******",
"refresh_token": "******"
}
Tokenfälten är beroende av de omfång och anspråk som etablerades från början. En uppdateringstoken returneras endast när den första begäran innehåller offline_access. Exempelvärdet för förfallodatum är inte en fast livslängdsgaranti. Begär offline_access inte om programmet inte behöver en uppdateringstoken.
Utmana eller skicka om
Följ den valda metodens challenge länk eller en aktuell resend länk när kunden begär ett annat lösenord:
POST https://{custom_domain}/{tenant}/api/v2.0/auth/methods/{methodType}/{id}/challenge
Content-Type: application/json
Accept: application/hal+json
{
"continuationToken": "******"
}
En e-postutmaning kan returnera:
{
"continuationToken": "******",
"state": "interactionRequired",
"action": "verify",
"id": "{email_method_id}",
"type": "email",
"hint": "u***@contoso.com",
"codeLength": 8,
"_links": {
"verify": {
"href": "/{tenant}/api/v2.0/auth/methods/email/{email_method_id}/verify"
},
"resend": {
"href": "/{tenant}/api/v2.0/auth/methods/email/{email_method_id}/challenge"
}
}
}
SMS använder samma utmaningsform för autentiseringsuppgifter med type: sms, ett maskerat telefontips och dess returnerade metodlänkar. Lösenordsutmaningar skickar inget lösenord och returnerar en lösenordsåtgärd verify . Använd den returnerade codeLength, inte exempellängden. Följ tjänstkontrollerade försöks- och återsändandegränser.
Verifiera en autentiseringsuppgift
Publicera till den aktuella verify länken. För en lösenordsmetod:
POST https://{custom_domain}/{tenant}/api/v2.0/auth/methods/password/{id}/verify
Content-Type: application/json
Accept: application/hal+json
{
"continuationToken": "******",
"password": "******"
}
För en e-post- eller SMS-metod:
POST https://{custom_domain}/{tenant}/api/v2.0/auth/methods/{methodType}/{id}/verify
Content-Type: application/json
Accept: application/hal+json
{
"continuationToken": "******",
"otp": "{one_time_passcode}"
}
Verifiering kan returnera en annan utmaning, attributsamling, en lösenordsuppdatering eller fortsättning. Hantera den returnerade åtgärden. Verifieringen är inte idempotent. försök inte igen automatiskt efter ett tvetydigt nätverksfel.
Registrering av autentiseringsmetod
Registrering eller inloggning kan kräva infogad registrering via action: enroll, följt av action: activate. Registreringen är separat från att samla in profilattribut eller verifiera en befintlig autentiseringsuppgift.
Important
Registreringen är separat från autentisering med en registrerad metod. Använd endast registreringsmetoder som annonseras för den aktuella transaktionen. härled inte en registreringsåtgärd från en autentiseringsuppgift.
Välj och registrera en metod
Välj en metod som stöds från _embedded.methods och följ dess _links.enroll URL.
| Method | Reklam | Obligatoriska JSON-fält |
|---|---|---|
| Telefon-SMS |
type: phone, med sms i channels. |
continuationToken, phoneNumber inklusive landskod och channel: sms. |
| E-postadress |
type: email. |
continuationToken och email. Skicka inte en channel. |
Telefonregistrering använder type: phone, inte den sms typ som används av befintliga SMS-utmaningsmetoder. Exempeladressen för telefonregistrering är /{tenant}/api/v2.0/auth/methods/phone; e-post-URL:en är /{tenant}/api/v2.0/auth/methods/email. Använd POST med JSON och följ den annonserade URL:en i stället för att skapa en.
För sms-registrering i telefon är brödtexten:
{
"continuationToken": "******",
"phoneNumber": "+1 2025550123",
"channel": "sms"
}
För e-postregistrering är brödtexten:
{
"continuationToken": "******",
"email": "user@contoso.com"
}
Tjänsten skickar ett lösenord och returnerar action: activate, en ny fortsättningstoken och en activate länk. Visa den returnerade maskerade hint och codeLength när den finns. E-post och SMS kan använda olika kodlängder.
Ett svar på telefonaktivering kan vara:
{
"continuationToken": "******",
"state": "interactionRequired",
"action": "activate",
"id": "{phone_method_id}",
"type": "phone",
"channel": "sms",
"hint": "***0123",
"codeLength": 6,
"_links": {
"activate": {
"href": "/{tenant}/api/v2.0/auth/methods/phone/{phone_method_id}/activate"
},
"resend": {
"href": "/{tenant}/api/v2.0/auth/methods/phone"
}
}
}
Använd fälten och länkarna från det faktiska svaret. e-post använder sin egen metodtyp, kodlängd och länkar.
Aktivera eller skicka om
Skicka en JSON POST till den aktuella activate länken med den senaste continuationToken och användarens kod i otp. Telefonexempel använder /{tenant}/api/v2.0/auth/methods/phone/{phone_method_id}/activate; e-post använder sin egen annonserade länk. Skicka inte aktiveringskoder till länken för en autentiseringsuppgift verify .
{
"continuationToken": "******",
"otp": "{one_time_passcode}"
}
Om aktiveringssvaret annonserar resendskickar du en JSON POST som endast innehåller det senaste continuationToken till länken. Länken kan peka tillbaka till registreringen. Behåll eller skicka inte kontaktinformationen igen. token bär registreringskontexten.
{
"continuationToken": "******"
}
Ersätt aktiv token, länkar, tips och kodlängd efter varje svar. Fortsätt att hantera returnerade åtgärder efter aktivering. endast state: continue tillåter att auktorisering återupptas. Registreringen kan uppfylla MFA, så en separat utmaning för autentiseringsuppgifter krävs inte alltid.
För invalidGrant med innerError.code: invalidOneTimeCodebehåller du den aktuella aktiveringstoken och annonserade länkar. Låt användaren korrigera koden eller begära en återsändning. Spela inte upp registreringen eller aktiveringen automatiskt efter ett tvetydigt anslutningsfel.
Errors
OAuth-fel använder fält som error, error_description, trace_idoch correlation_id. Interna autentiseringsfel använder ett kapslat kuvert. Till exempel kan en felaktig e-postverifieringskod returnera HTTP 400 med:
{
"error": {
"code": "invalidGrant",
"message": "AADSTS50181: Unable to validate the otp.",
"timestamp": "2026-08-28T17:30:00Z",
"traceId": "0000aaaa-11bb-cccc-dd22-eeeeee333333",
"correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
"innerError": {
"code": "invalidOneTimeCode"
}
}
}
Använd stabila koder för hantering i stället för lokaliserade meddelanden. Attributverifiering kan returneras med poster som innehåller code, messageoch attributeIds, plus valfri eller suggestionsrecovery.detailserror.innerError.code: attributeValidationError Kontrollera HTTP-status och innehållstyp innan du parsar. rendera inte en oväntad HTML-feltext i appen.
| Condition | Status eller fel | lagerhantering |
|---|---|---|
| Ogiltig OAuth-parameter | 400 invalid_request |
Korrigera begäran. försök inte igen oförändrade. |
| Ogiltig eller förfallen kod | 400 invalid_grant |
Starta om auktorisering. |
| Ogiltigt program | 400 invalid_client |
Rätt appkonfiguration. |
| Ogiltigt eller oskälat omfång | 400 invalid_scope |
Kontrollera begärda omfång och medgivande. |
| Autentisering krävs | 401 InsufficientAuthorization |
Följ en aktiverad reselänk. |
| Ogiltig fortsättningstoken/tillstånd | 400 invalidRequest |
Starta om det tillämpliga flödet. |
| Token för lösenordsuppdatering har upphört att gälla |
400 expiredToken med innerError.code: expiredContinuationToken |
Starta om auktorisering. |
| Verifieringskod saknas | 400 invalidRequest |
Korrigera de indata som saknas. |
| Felaktig e-post- eller SMS-verifieringskod |
400 invalidGrant med innerError.code: invalidOneTimeCode |
Låt användaren korrigera koden med hjälp av det användbara aktuella verifieringstillståndet eller följ en annonserad återsänd länk. Skicka inte automatiskt igen. |
| Felaktig aktiveringskod |
400 invalidGrant med innerError.code: invalidOneTimeCode |
Behåll den aktuella aktiveringstoken och annonserade länkar. Låt användaren korrigera koden eller använda en annonserad återsändningsåtgärd. Skicka inte automatiskt igen. |
| Webbläsarinteraktion krävs |
invalid_grant med web_redirect_required |
Stoppa interna begäranden och använd den konfigurerade interaktiva återställningssökvägen. Vidarebefordra inte fortsättningstoken till en godtycklig URL. |
| Intern transaktion kan inte fortsätta | Ursprunglig brödtext {"state":"redirect"} |
Stoppa interna begäranden. En separat webbläsarinloggning bevarar inte inbyggda förlopp. |
| Throttling | 429 |
Vägledning för heder Retry-After och server. |
Nätverks- och tjänstfel kan använda andra svarsformat. Behandla en oväntad innehållstyp som ett explicit fel. Tabellen beskriver specifika vanliga fall, inte en fullständig felkatalog för varje åtgärd.
Säkerhet och diagnostik
Använd HTTPS för varje uppströmsbegäran. Håll lösenord, lösenord, fortsättningstoken, koder och utfärdade token borta från URL:er, loggar, telemetri, undantag, skärmbilder och stödbilagor. Cachelagrar inte autentiseringssvar eller delar inte transaktionstillstånd mellan användare.
Avvisa oväntade myndigheter och omdirigeringar i stället för att vidarebefordra hemligheter. Försök inte automatiskt verifiera autentiseringsuppgifterna på nytt, skicka in autentiseringsuppgifter eller lösenordsuppdateringar efter ett tvetydigt fel.
Visa endast maskerade tips som tillhandahålls av tjänsten. Använd allmänna identifieringsfel så att meddelanden och metodpresentation inte i onödan avslöjar kontoförvaring.
Behåll säker diagnostik: HTTP-status, åtgärdskategori, client-request-id, tjänstspårnings-/korrelations-ID och tidsstämpel. OAuth-namn använder understreck; Namn på interna autentiseringsfel använder kamelfall. Extrahera dessa diagnostikfält utan att behålla fullständiga begärande- eller svarsorgan.
Anpassade autentiseringstillägg
Händelsekonfiguration och kontrakt är specifika för varje tillägg och resa. Appen fortsätter att välja tillåtna åtgärder från tjänstsvar när ett tillägg deltar i flödet.
Intern händelsetäckning omfattar OnOtpSend för e-post och OnTokenIssuanceStart.
OnAttributeCollectionStart och OnAttributeCollectionSubmit stöds inte för inbäddad intern autentisering eller Bring Your Own UX. Se Anpassade autentiseringstillägg för händelsespecifikt beteende. Den här händelseuppsättningen upprättar inte lösenordsmigreringskrokar, synkronisering av lösenordsuppdateringar eller godtycklig kontextspridning.