Skip to main content

 Services

Web services from /about to /webhooks

authenticators challenge

/authenticators/{authenticator}/challenge [POST]

Description

To verify an authenticator, this generator creates a multifactor authentication (MFA) challenge for a specified authenticator associated with the signed-in member.

If an unresolved challenge has been created less than a minute ago for that authenticator, that challenge is returned instead of creating a new one.

Parameters

No parameters required.

Permission

Only the member themselves can invoke this service.

Response

 <challenge-request successful="[true|false]" message="[message]">
    <challenge id="[challenge id]"
          purpose="[registration|authentication]"
    authenticator="[authenticator public id]"
           issued="[issue datetime]"
          expires="[expiry datetime]"
       [<data>[challenge specific data]</data>]
    </challenge>
 </challenge-request>
 

Error handling

No specific errors expected for this generator.

Created on , last edited on