Naslaginformatie over systeemeigen verificatie-API v2

Van toepassing op: Groene cirkel met een wit vinkje dat aangeeft dat de volgende inhoud van toepassing is op externe tenants. 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-Origin voor die exacte toegestane oorsprong, niet *.
  • Hiermee staat u de vereiste POST bewerking of PUT methode 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.

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 een continuationToken voor de selectie in behandeling.
  • Een _embedded.user matrix met informatie over elk aangeboden account en ondersteunde koppelingen. Een actief account heeft een accountspecifieke _links.resume URL.
  • Een URL op antwoordniveau _links.discover voor 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.