Error
A valid request URL is required to generate request examples{
"version": "external-auth-login-init/v1",
"challenge": "base64url-login-challenge",
"challengeIdentifier": "login-challenge-id",
"allowCredentials": {
"webauthn": [
{
"type": "public-key",
"id": "passkey-credential-id"
}
]
},
"userVerification": "required"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "request-id",
"code": "service_degraded",
"safeMessage": "Authentication dependencies are temporarily unavailable.",
"retryable": true,
"recoveryActions": [
"observe_status",
"retry_after"
],
"occurredAtEpochMs": 0
}Auth
Start passkey login
Starts a DFNS login challenge for an already-registered DFNS username. The browser must sign this challenge with its registered passkey before any bearer can be returned.
Method and path: POST /v1/auth/login/init
Authentication: none.
Request schema: ExternalAuthLoginInitRequest.
Response schema: ExternalAuthLoginInitResponse.
Error envelope: ExternalRestError (external-rest-error/v1).
POST
/
v1
/
auth
/
login
/
init
Error
A valid request URL is required to generate request examples{
"version": "external-auth-login-init/v1",
"challenge": "base64url-login-challenge",
"challengeIdentifier": "login-challenge-id",
"allowCredentials": {
"webauthn": [
{
"type": "public-key",
"id": "passkey-credential-id"
}
]
},
"userVerification": "required"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "request-id",
"code": "service_degraded",
"safeMessage": "Authentication dependencies are temporarily unavailable.",
"retryable": true,
"recoveryActions": [
"observe_status",
"retry_after"
],
"occurredAtEpochMs": 0
}Body
application/json
Minimum string length:
1Response
Success
Allowed value:
"external-auth-login-init/v1"Minimum string length:
1Minimum string length:
1Show child attributes
Show child attributes
Available options:
required, preferred, discouraged