Skip to main content

 Services

Web services from /about to /webhooks

authenticator challenge

/authenticators/{authenticator}/challenge [POST]

Description

To verify an authenticator, this generator creates a multifactor authentication (MFA) challenge for the authenticator with the specified public-id registered for 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