Start Registration Passkey


Initiates the WebAuthn registration process using passkeys by generating a challenge and configuration options required by the client to create a new credential. This includes information about the Relying Party (RP), the user, acceptable cryptographic algorithms, and optional authenticator selection criteria. The response is used by the client-side WebAuthn API to prompt the user to register a new passkey with an authenticator.

Resource

POST /passkey/start_registration

Parameters

None

Payload

None

Context

Authorization

User

Errors

Example

Request
POST http://sip.xelion.nl/api/v1/master/passkey/start_registration
Response
{
  "pubKeyCredParams": [
    {
      "type": "public-key",
      "alg": -7
    }
  ],
  "excludeCredentials": [],
  "rp": {
    "id": "example.com",
    "name": "Example RP"
  },
  "user": {
    "id": "dXNlcklkMTIz",
    "name": "user@example.com",
    "displayName": "Example User"
  },
  "challenge": "Q2hhbGxlbmdlSW5CYXNlNjQ=",
  "timeout": 60000,
  "authenticatorSelection": {
    "authenticatorAttachment": "platform",
    "requireResidentKey": false,
    "userVerification": "preferred"
  },
  "attestation": "direct",
  "extensions": {
    "exampleExtension": true
  }
}