Naslag Voor: beheerders, gebruikers, ontwikkelaars

Fouten bij tweestapsverificatie

Oorzaken en oplossingen voor de foutcodes bij het instellen van tweestapsverificatie en bij beperkte sessies.

error.mfa_required

Tekst in de console
Hiervoor is tweestapsverificatie vereist. Voltooi de verificatie en probeer het opnieuw.
Betekenis voor API-clients
The session is restricted until multi-factor authentication completes.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
reasonwaarom de sessie beperkt is, hier mfa_required.

Oorzaak. Het account moet tweestapsverificatie instellen voordat de sessie iets anders kan doen. Tot die tijd is de sessie beperkt en antwoordt de API met deze code op elke bewerking, behalve op de bewerkingen die de verificatie instellen.

Oplossing.

  1. Stel tweestapsverificatie in: Tweestapsverificatie instellen. Met de CLI toont kyvernon auth totp enrol het geheim en bevestigt kyvernon auth totp confirm <code> het met een code uit de authenticator-app.
  2. Bewaar de herstelcodes die na de bevestiging verschijnen op een veilige plaats. Ze worden één keer getoond.
  3. Herhaal de bewerking.

error.mfa.already_enrolled

Tekst in de console
Tweestapsverificatie is voor dit account al ingesteld.
Betekenis voor API-clients
TOTP is already set up.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. Tweestapsverificatie is voor het account al ingesteld, of een lopende instelling is al bevestigd.

Oplossing.

  1. Blijf de authenticator-app gebruiken die u hebt ingesteld.
  2. Om opnieuw te beginnen verwijdert een beheerder eerst de registratie: kyvernon users reset-mfa <username>. De gebruiker stelt de verificatie daarna opnieuw in.
  3. Voor nieuwe herstelcodes voert u kyvernon auth totp recovery-codes <code> uit. De oude codes werken dan niet meer.

error.mfa.not_enrolled

Tekst in de console
Tweestapsverificatie is voor dit account niet ingesteld.
Betekenis voor API-clients
TOTP is not set up.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De bewerking vereist tweestapsverificatie, bijvoorbeeld het maken van nieuwe herstelcodes, en het account heeft die niet ingesteld.

Oplossing.

  1. Stel eerst tweestapsverificatie in: Tweestapsverificatie instellen of kyvernon auth totp enrol.
  2. Herhaal de bewerking na de bevestiging.

error.mfa.not_enrolling

Tekst in de console
Er is geen installatie van tweestapsverificatie bezig. Start de installatie opnieuw.
Betekenis voor API-clients
No TOTP enrolment is pending.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. Er is een code gestuurd om de instelling te bevestigen, maar voor het account loopt geen instelling. De instelling is nooit gestart of is gereset.

Oplossing.

  1. Start de instelling opnieuw: kyvernon auth totp enrol. In de console gebruikt u Tweestapsverificatie instellen.
  2. Bevestig met een actuele code: kyvernon auth totp confirm <code>.

Versie 0.1. Laatst gewijzigd: 2026-11-13