Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op:
Externe tenants (meer informatie)
Verificatiemethode: Ingesloten systeemeigen verificatie.
De systeemeigen verificatie-API maakt gebruik van een reactiegestuurde stroom in Microsoft Entra Externe id externe tenants. Start autorisatie, voltooi de geretourneerde verificatie-interacties, hervat autorisatie en wissel de autorisatiecode voor tokens in. Deze verwijzing definieert gedeelde bewerkingen; trajectspecifieke verwijzingen definiëren aanmeldingsdetectie, registratiekenmerken en wachtwoordherstel.
Voor een bestaande V1-integratie gebruikt u de V1 API-verwijzing. Zie Migreren van V1 naar V2 voor pakketversies, migratievereisten en SDK-integratiedetails.
Prerequisites
Important
De systeemeigen verificatie-API V2 is in preview. De systeemeigen verificatie-API V1 blijft algemeen beschikbaar. Zie de aanvullende gebruiksvoorwaarden voor Microsoft Azure previews voor juridische voorwaarden die van toepassing zijn op preview-functies.
- Een externe tenant en een toepassing die is geconfigureerd voor openbare client- en systeemeigen verificatiestromen. Zie Een toepassing configureren.
- Een gebruikersstroom die is gekoppeld aan de toepassing.
- Een door tenant geverifieerd aangepast URL-domein dat is geconfigureerd voor alle service-API-aanroepen.
- De gedelegeerde machtigingen en toestemming die vereist zijn voor uw doelresource, als u toegang tot een API aanvraagt.
- Voor SPA's met ingesloten systeemeigen verificatie en BYO UX-websites, een proxy- of edge-beleid waarmee de vereisten voor de browserproxy worden geïmplementeerd.
Bewerkingen en autoriteit
In de voorbeelden wordt https://{custom_domain}/{tenant}gebruikgemaakt van, waarbij custom_domain een door tenant geverifieerd verificatiedomein is, zoals login.contoso.com, en tenant is de map-id (tenant), een GUID.
client_id is de toepassings-id (client). Alle URL's voor service-API-aanroepen maken gebruik van dit aangepaste domein, inclusief autorisatieuitdagingen en tokenuitwisseling. Zie De API-instantie configureren.
Met uitzondering van de initiële autorisatieaanvraag en tokenuitwisseling gebruikt u de URL die wordt aangekondigd door het huidige antwoord. Methode-id's zijn ondoorzichtig. Los relatieve koppelingen op met de geconfigureerde instantie-oorsprong, valideer de bestemming en behoud het geretourneerde pad en de query ongewijzigd.
De autorisatie starten, hervatten en code-uitwisseling hieronder beschrijven embedded systeemeigen verificatie. Een BYO UX-pagina maakt in plaats daarvan gebruik van de hand-off van de browser en retourneert de voltooide koppeling rond de gedeelde systeemeigen interactiebewerkingen. Start of hervat /authorize-challenge niet binnen die BYO UX-transactie.
| Operation | Method | Pad of koppeling |
|---|---|---|
| Autorisatie starten | POST |
/{tenant}/oauth2/v2.0/authorize-challenge |
| Autorisatie hervatten | POST |
Geretourneerde continue koppeling. |
| Aanmelden starten | POST |
Geretourneerde sign_in koppeling; voorbeelden gebruiken /{tenant}/api/v2.0/signin/start. |
| Registreren starten | POST |
Geretourneerde sign_up koppeling; voorbeelden gebruiken /{tenant}/api/v2.0/signup/start. |
| Registratiekenmerken verzenden | POST |
Geretourneerde submitAttributes koppeling. |
| Wachtwoord opnieuw instellen starten | POST |
Geretourneerde koppeling voor het opnieuw instellen van het wachtwoord; voorbeelden gebruiken /{tenant}/api/v2.0/resetpassword/start. |
| Inline wachtwoord opnieuw instellen starten | POST |
De geretourneerde recover koppeling voor de wachtwoordmethode. |
| Een verificatiemethode inschrijven | POST |
De geretourneerde koppeling van de geselecteerde enroll methode. |
| Een verificatiemethode activeren | POST |
Geretourneerde activate koppeling. |
| Uitdaging of opnieuw verzenden | POST |
challenge Geretourneerd of resend koppeling. |
| Een referentie verifiëren | POST |
Geretourneerde verify koppeling. |
| Een wachtwoord bijwerken | PUT |
Geretourneerde update koppeling. |
| Update van peilingswachtwoord | POST |
Geretourneerde poll koppeling. |
| een autorisatiecode Exchange | POST |
/{tenant}/oauth2/v2.0/token |
Systeemeigen voorbeelden gebruiken /api/v2.0; OAuth-bewerkingen gebruiken /oauth2/v2.0. Gebruik de tenant-GUID in deze instantievoorbeelden. Volg geretourneerde koppelingen zonder de paden, versies of queryparameters te herschrijven.
Headers
OAuth- en systeemeigen verificatiebewerkingen maken gebruik van verschillende hoofdtekstcoderingen.
| Koptekst | Gebruiken |
|---|---|
Content-Type: application/x-www-form-urlencoded |
Vereist voor autorisatievraag- en tokenaanvragen. |
Content-Type: application/json |
Vereist voor systeemeigen verificatieaanvraagbody's. |
Accept: application/hal+json |
Aanbevolen voor systeemeigen verificatieaanvragen. |
client-request-id: {guid} |
Aanbevolen. Genereer een nieuwe waarde voor elke stroom en bewaar deze voor diagnostische gegevens. |
Vereisten voor browserproxy
Deze vereisten zijn van toepassing op browser-API-aanroepen van SPA's met ingesloten systeemeigen verificatie en BYO UX-websites. Android- en iOS-apps die systeemeigen HTTP-transporten gebruiken, hebben geen CORS-configuratie of een CORS-proxy nodig.
Systeemeigen verificatieroutes verwerken OPTIONS, maar verlenen geen toegang tot de oorsprong van een browser via Access-Control-Allow-Origin. Cross-origin browserintegraties hebben daarom een proxy- of edge-configuratie nodig die:
- Stuurt het geslaagde voorbereidende antwoord van de service door en past het geconfigureerde browser-originbeleid toe.
- Retourneert
Access-Control-Allow-Originvoor die exacte toegestane oorsprong, niet*. - Hiermee staat u de vereiste
POSTbewerking ofPUTmethode en de aanvraagheaders toe die door de integratie worden gebruikt. - Behoudt aanvraagteksten, antwoordstatuscodes, inhoudstypen en transactiekoppelingen zonder reacties op verificatie in de cache.
- Verwerkt de oorsprong en routering consistent voor autorisatie, systeemeigen bewerkingen en tokenuitwisseling.
- Bewaart richtlijnen voor opnieuw proberen, inclusief
Retry-After, en maakt deze beschikbaar voor browsercode wanneer dat nodig is.
Zie CORS-concepten voor systeemeigen verificatie voor de browsergrens en de lokale proxyconfiguratie voor ontwikkeling.
Vervolgtokens
Een vervolgtoken vertegenwoordigt de verificatietransactie in de huidige fase. Deze is gebonden aan de tenant, client, scenario en actie.
| Berichtindeling | Veld |
|---|---|
| OAuth | continuation_token |
| Systeemeigen verificatie-API | continuationToken |
Gebruik alleen het huidige token met de bewerking die wordt geïdentificeerd door hetzelfde antwoord. Parseren, wijzigen, registreren of behouden buiten de actieve transactie. Wanneer een antwoord een vervanging levert, stopt u met het gebruik van het eerdere token. Verplaats een token niet naar een andere gebruiker of reis. Autorisatie opnieuw opstarten na verloop van tijd.
De gedocumenteerde standaardvalidatie is 10 minuten voor een afzonderlijk vervolgtoken. Vervaldatum verwerken volgens het serviceantwoord; een nieuwer token is geen garantie voor het uitbreiden van het hele traject. Het token en een eenmalige wachtwoordcode hebben afzonderlijke levensduur. Autorisatiecodes zijn kortlevend en eenmalig gebruik; interpreteer een tokenantwoord expires_in niet als de levensduur van de autorisatiecode.
Antwoordmodel
Geslaagde systeemeigen interactiebewerkingen retourneren HAL JSON. De volgende actie kan zelfs verschillen voor opeenvolgende aanroepen naar hetzelfde eindpunt. Velden zijn specifiek voor het antwoord: een omleiding kan bijvoorbeeld alleen statebevatten.
| Lid | Purpose |
|---|---|
continuationToken |
Token voor de volgende toegestane aanvraag, indien opgenomen. |
state |
Huidige transactiestatus. |
action |
Vereiste interactie voor een interactionRequired antwoord. |
_links |
URL's voor toegestane bewerkingen. |
_embedded |
Gerelateerde resources, inclusief beschikbare methoden. |
In het stroomconcept worden de statussen en acties uitgelegd. Voor interactionRequiredhet afhandelen van de geretourneerde actie met behulp van een toegestane bewerking. Voor continue, hervat autorisatie via de geretourneerde koppeling. De status van completed een afzonderlijke bewerking bevestigt niet dat tokens zijn uitgegeven.
Een systeemeigen transactie die niet kan worden voortgezet, kan het volgende retourneren:
{
"state": "redirect"
}
Dit antwoord levert geen vervolgtoken, koppelingen of een hand-off-URL van de browser op. Stop systeemeigen aanvragen en bied een afzonderlijk geconfigureerde browseraanmelding of een duidelijke fout. Aanmelding via browser start verificatie opnieuw op; De systeemeigen voortgang wordt niet hervat.
Actie Accountselectie
Note
Accountselectie is niet relevant in ingesloten systeemeigen verificatie en wordt nog niet ondersteund voor zelf-hostende BYO UX-pagina's.
disambiguate identificeert accountselectie onder state: interactionRequired.
Koppelingsrelaties
Gebruik koppelingen van het meest recente antwoord en valideer hun autoriteit voordat u geheimen doorstuurt.
| Relatie | Purpose |
|---|---|
self |
Huidige resource of bewerking. |
discover |
Dien een aanmeldings-id in. |
challenge |
Start de uitdaging van de geselecteerde methode. |
verify |
Controleer een wachtwoord of eenmalige wachtwoordcode. |
resend |
Vraag een andere eenmalige wachtwoordcode aan. |
submitAttributes |
Verzend aangevraagde registratiewaarden. |
recover |
Start wachtwoordherstel binnen de actieve aanmeldingstransactie. |
enroll |
Start de registratie van een geadverteerde verificatiemethode. |
activate |
Controleer de code voor een ingeschreven methode. |
update |
Dien een vervangend wachtwoord in. |
poll |
Controleer een asynchrone update. |
continue |
OAuth-autorisatie hervatten. |
Deze actie is relevant voor byo-accountselectie (Bring Your Own UX). Ingesloten systeemeigen verificatie-integraties gebruiken deze niet en accountselectie op de zelf-hostende BYO UX-pagina wordt momenteel niet ondersteund.
Als uw BYO UX-integratie de aanbevolen tijdelijke oplossing volgt door de autorisatieaanvraag te verzenden of prompt=login in te dienenlogin_hint, wordt uw bestaande UX niet onderbroken of onderbroken door de introductie van accountselectie.
De nettolading van de actie maakt deel uit van de bestaande BYO UX-browserhandoffs initialResponse en bevat:
-
state: interactionRequired,action: disambiguateen eencontinuationTokenvoor de selectie in behandeling. - Een
_embedded.usermatrix met informatie over elk aangeboden account en ondersteunde koppelingen. Een actief account heeft een accountspecifieke_links.resumeURL. - Een URL op antwoordniveau
_links.discovervoor een inactief account of een ander account gebruiken.
Resources voor verificatiemethode
Selectie van bestaande referentiemethode maakt gebruik van _embedded.methods. De service kan ook één methode selecteren. Een bestaande referentie heeft een ondoorzichtige id, zoals typepassword, emailof , en smskoppelingen voor toegestane bewerkingen. Een gemaskeerd hint identificeert een bestemming zonder deze volledig te onthullen. isPreferred Dit zijn optionele voorkeursmetagegevens. Inschrijvingsopties hebben een afzonderlijke weergave en hebben geen bestaande referentie-id nodig.
{
"_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"
}
}
}
]
}
}
Dit fragment illustreert metagegevens van methoden. De beschikbaarheid van methoden wordt voor elke transactie bepaald. Uw app kan beschikbare methoden presenteren of er een selecteren via toepassingsstroomlogica. Uitdaging en verificatie werken op de geselecteerde methode; methoderegistratie heeft een afzonderlijk contract.
U hebt geen optionele presentatiemetagegevens nodig, zoals pages of scenario. In de voorbeelden worden basiswachtwoord- en e-mail-/SMS-interacties beschreven, niet elke aanvullende methodespecifieke vereiste.
Autorisatie starten
Verzend de toepassing, bereiken en optionele claims op de eerste aanvraag. Waarden voor formuliercodering; de onderstaande regeleinden zijn bedoeld voor leesbaarheid.
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 | Gebruiken |
|---|---|
client_id |
Vereiste toepassings-id (client). |
scope |
Bereikt uw toepassingsaanvragen. Neem de OpenID Connect (OIDC) en resourcebereiken op die nodig zijn voor de resulterende tokens. |
response_type |
code in dit voorbeeld. Het eindpunt retourneert een autorisatiecode na verificatie. |
claims |
Optionele aanvraag voor JSON-gecodeerde OpenID Connect-claims. |
Wanneer verificatie is vereist, is 401 Unauthorizedhet antwoord, met 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"
}
Aanmeldings- en registratie-URL's zijn voorwaardelijk. Trajectkoppelingen zijn OAuth-antwoordeigenschappen op het hoogste niveau, niet _links vermeldingen. Selecteer een geadverteerd traject en verzend het token zoals continuationToken in de JSON-aanvraag. Afhandelen van beleid of accountspecifieke afwijzing.
Autorisatie hervatten
Wanneer het huidige antwoord wordt geretourneerd state: continue, plaatst u het meest recente token op _links.continue.href. Verzend de oorspronkelijke client_idaanvraag scopeniet opnieuw of claims in deze aanvraag.
POST https://{custom_domain}/{tenant}/oauth2/v2.0/authorize-challenge
Content-Type: application/x-www-form-urlencoded
continuation_token={continuation_token}
Het geslaagde antwoord is 200 OK en JSON:
{
"code": "{authorization_code}"
}
Autorisatiecodes zijn kortlevend en eenmalig gebruik. Exchange de code in plaats van deze als een toegangstoken te behandelen.
Exchange de autorisatiecode
Plaats de code met dezelfde toepassings-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}
Alle drie de parameters zijn vereist.
grant_type is authorization_code. Deze openbare clientaanvraag bevat geen clientgeheim.
Het geslaagde antwoord is 200 OK en JSON:
{
"token_type": "Bearer",
"expires_in": 3600,
"access_token": "******",
"id_token": "******",
"refresh_token": "******"
}
Tokenvelden zijn afhankelijk van de bereiken en claims die in eerste instantie tot stand zijn gebracht. Een vernieuwingstoken wordt alleen geretourneerd wanneer de eerste aanvraag is opgenomen offline_access. De voorbeeldverloopwaarde is geen garantie voor een vaste levensduur. Vraag niet of offline_access uw toepassing geen vernieuwingstoken nodig heeft.
Uitdaging of opnieuw verzenden
Volg de koppeling van challenge de geselecteerde methode of een huidige resend koppeling wanneer de klant een andere wachtwoordcode aanvraagt:
POST https://{custom_domain}/{tenant}/api/v2.0/auth/methods/{methodType}/{id}/challenge
Content-Type: application/json
Accept: application/hal+json
{
"continuationToken": "******"
}
Een e-mailvraag kan het volgende retourneren:
{
"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 maakt gebruik van dezelfde shape voor referentieuitdaging met type: sms, een gemaskeerde telefoonhint en de geretourneerde methodekoppelingen. Wachtwoorduitdagingen verzenden geen wachtwoordcode en retourneren een wachtwoordactie verify . Gebruik de geretourneerde codeLengthwaarde, niet de lengte van het voorbeeld. Volg door de service beheerde limieten en verzendlimieten.
Een referentie verifiëren
Plaats een bericht op de huidige verify koppeling. Voor een wachtwoordmethode:
POST https://{custom_domain}/{tenant}/api/v2.0/auth/methods/password/{id}/verify
Content-Type: application/json
Accept: application/hal+json
{
"continuationToken": "******",
"password": "******"
}
Voor een e-mail- of sms-methode:
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}"
}
Verificatie kan een andere uitdaging, kenmerkverzameling, een wachtwoordupdate of vervolg retourneren. De geretourneerde actie afhandelen. Verificatie is niet idempotent; probeer het niet automatisch opnieuw na een dubbelzinnige netwerkfout.
Inschrijving met verificatiemethode
Registratie of aanmelding kan inlineregistratie action: enrollvereisen, gevolgd door action: activate. Inschrijving staat los van het verzamelen van profielkenmerken of het verifiëren van een bestaande referentie.
Important
Inschrijving staat los van verificatie met een geregistreerde methode. Gebruik alleen inschrijvingsmethoden die zijn geadverteerd voor de huidige transactie; een inschrijvingsbewerking niet afleiden uit een referentievraag.
Een methode selecteren en inschrijven
Selecteer een ondersteunde methode uit _embedded.methods en volg de _links.enroll BIJBEHORENDE URL.
| Method | Advertentie | Vereiste JSON-velden |
|---|---|---|
| Telefoon sms |
type: phone, met sms in channels. |
continuationToken, phoneNumber inclusief landcode en channel: sms. |
| E-mailadres |
type: email. |
continuationToken en email. Stuur geen channel. |
Telefooninschrijving gebruikt type: phone, niet het sms type dat wordt gebruikt door bestaande sms-vraagmethoden. De voorbeeld-URL voor telefooninschrijving is /{tenant}/api/v2.0/auth/methods/phone; de e-mail-URL is /{tenant}/api/v2.0/auth/methods/email. Gebruik POST met JSON en volg de geadverteerde URL in plaats van er een te maken.
Voor inschrijving via sms-telefoon is de hoofdtekst:
{
"continuationToken": "******",
"phoneNumber": "+1 2025550123",
"channel": "sms"
}
Voor e-mailinschrijving is de hoofdtekst:
{
"continuationToken": "******",
"email": "user@contoso.com"
}
De service verzendt een wachtwoordcode en retourneert action: activate, een nieuw vervolgtoken en een activate koppeling. Geef de geretourneerde gemaskeerde hint en codeLength indien aanwezig weer. E-mail en sms kunnen verschillende codelengten gebruiken.
Een reactie op telefoonactivering kan het volgende zijn:
{
"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"
}
}
}
Gebruik de velden en koppelingen uit het werkelijke antwoord; e-mail maakt gebruik van een eigen methodetype, codelengte en koppelingen.
Activeren of opnieuw verzenden
Verzend een JSON POST naar de huidige activate koppeling met de meest recente continuationToken en de code van de gebruiker in otp. Gebruik van telefoonvoorbeelden /{tenant}/api/v2.0/auth/methods/phone/{phone_method_id}/activate; e-mail maakt gebruik van een eigen geadverteerde koppeling. Verzend geen activeringscodes naar de koppeling van verify een referentie.
{
"continuationToken": "******",
"otp": "{one_time_passcode}"
}
Als het activeringsantwoord resendwordt aangekondigd, verzendt u een JSON POST die alleen de meest recente continuationToken naar die koppeling bevat. De koppeling kan teruggaan naar de inschrijving. Bewaar of verzend de contactgegevens niet opnieuw; het token heeft de inschrijvingscontext.
{
"continuationToken": "******"
}
Vervang het actieve token, koppelingen, hints en codelengte na elk antwoord. Doorgaan met het verwerken van geretourneerde acties na activering; staat alleen state: continue het hervatten van de autorisatie toe. Registratie kan zelf voldoen aan MFA, dus een afzonderlijke referentievraag is niet altijd vereist.
Houd invalidGrant het huidige activeringstoken en geadverteerd koppelingen bij met dit innerError.code: invalidOneTimeCodetoken. Laat de gebruiker de code corrigeren of een nieuwe aanvraag indienen. Registratie of activering niet automatisch opnieuw afspelen na een dubbelzinnige verbindingsfout.
Fouten
OAuth-fouten maken gebruik van velden zoals error, error_description, trace_iden correlation_id. Systeemeigen verificatiefouten maken gebruik van een geneste envelop. Een onjuiste e-mailverificatiecode kan bijvoorbeeld HTTP 400 retourneren met:
{
"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"
}
}
}
Gebruik stabiele codes voor het verwerken in plaats van gelokaliseerde berichten. Kenmerkvalidatie kan worden geretourneerd error.innerError.code: attributeValidationError met details vermeldingen met code, messageen attributeIds, plus optioneel suggestions of recovery. Controleer de HTTP-status en het inhoudstype voordat u parseert; geef geen onverwachte HTML-fouttekst weer in de app.
| Condition | Status of fout | projectverbruik |
|---|---|---|
| Ongeldige OAuth-parameter | 400 invalid_request |
Corrigeer de aanvraag; probeer het niet opnieuw. |
| Ongeldige of verlopen code | 400 invalid_grant |
Autorisatie opnieuw opstarten. |
| Ongeldige toepassing | 400 invalid_client |
Juiste app-configuratie. |
| Ongeldig of niet-gerantd bereik | 400 invalid_scope |
Controleer de aangevraagde bereiken en toestemming. |
| Verificatie vereist | 401 InsufficientAuthorization |
Volg een koppeling naar een ingeschakeld traject. |
| Ongeldig vervolgtoken/status | 400 invalidRequest |
Start de toepasselijke stroom opnieuw. |
| Verlopen token voor wachtwoordupdate |
400 expiredToken met innerError.code: expiredContinuationToken |
Autorisatie opnieuw opstarten. |
| Ontbrekende verificatiecode | 400 invalidRequest |
Corrigeer de ontbrekende invoer. |
| Onjuiste e-mail- of sms-verificatiecode |
400 invalidGrant met innerError.code: invalidOneTimeCode |
Laat de gebruiker de code corrigeren met behulp van de bruikbare huidige verificatiestatus of volg een geadverteerd opnieuw verzendende koppeling. Verzend deze niet automatisch opnieuw. |
| Onjuiste activeringscode |
400 invalidGrant met innerError.code: invalidOneTimeCode |
Bewaar het huidige activeringstoken en geadverteerd koppelingen. Laat de gebruiker de code corrigeren of een geadverteerde actie opnieuw verzenden gebruiken. Verzend deze niet automatisch opnieuw. |
| Browserinteractie vereist |
invalid_grant met web_redirect_required |
Stop systeemeigen aanvragen en gebruik het geconfigureerde interactieve herstelpad. Stuur het vervolgtoken niet door naar een willekeurige URL. |
| Systeemeigen transactie kan niet worden voortgezet | Systeemeigen hoofdtekst {"state":"redirect"} |
Stop systeemeigen aanvragen. Bij een afzonderlijke aanmelding in de browser blijft de systeemeigen voortgang niet behouden. |
| Throttling | 429 |
Eer Retry-After en serverrichtlijnen. |
Netwerk- en servicefouten kunnen andere antwoordindelingen gebruiken. Behandel een onverwacht inhoudstype als een expliciete fout. In de tabel worden specifieke veelvoorkomende gevallen beschreven, niet een volledige foutcatalogus voor elke bewerking.
Beveiliging en diagnostische gegevens
Gebruik HTTPS voor elke upstream-aanvraag. Bewaar wachtwoorden, wachtwoordcodes, vervolgtokens, codes en uitgegeven tokens uit URL's, logboeken, telemetrie, uitzonderingen, schermafbeeldingen en ondersteuningsbijlagen. Sla geen verificatiereacties in de cache op of deel de transactiestatus tussen gebruikers.
Negeer onverwachte autoriteiten en omleidingen in plaats van geheimen door te sturen. Probeer niet automatisch opnieuw referenties te verifiëren, inzendingen voor accounts of wachtwoordupdates na een dubbelzinnige fout.
Alleen gemaskeerde hints weergeven die door de service worden geleverd. Gebruik algemene detectiefouten, zodat berichten en methodepresentaties het bestaan van accounts niet onnodig openbaar maken.
Veilige diagnostische gegevens behouden: HTTP-status, bewerkingscategorie, client-request-idservicetracering/correlatie-id's en tijdstempel. OAuth-namen gebruiken onderstrepingstekens; Systeemeigen verificatiefoutnamen maken gebruik van camel case. Extraheer deze diagnostische velden zonder volledige aanvraag- of antwoordteksten te behouden.
Aangepaste verificatie-extensies
Gebeurtenisconfiguratie en contracten zijn specifiek voor elke uitbreiding en elke reis. Uw app blijft toegestane bewerkingen selecteren in serviceantwoorden wanneer een extensie deelneemt aan de stroom.
Systeemeigen gebeurtenisdekking omvat OnOtpSend voor e-mail en OnTokenIssuanceStart.
OnAttributeCollectionStart en OnAttributeCollectionSubmit worden niet ondersteund voor ingesloten systeemeigen verificatie of Bring Your Own UX. Zie Aangepaste verificatie-extensies voor gebeurtenisspecifiek gedrag. Met deze gebeurtenisset worden geen hooks voor wachtwoordmigratie, synchronisatie van wachtwoordupdates of willekeurige contextdoorgifte ingesteld.