POST `/auth/webauthn/register/begin`

Generate a registration challenge and credential creation options, returning them to the frontend for calling navigator.credentials.create().

WebAuthn `bearerAuth` application/json

Request Body

Schema: handler.beginRegistrationRequest

Field	Type	Required	Constraints
`password`	`string`	Yes	length: 1–?
`user_name`	`string`	Yes
`display_name`	`string`	No

Status	Description	Schema
200	Registration options	`dto.WebAuthnRegistrationResponseWrapper`
400	Invalid request parameters	`dto.SimpleResponseWrapper`
401	Unauthorized	`dto.SimpleResponseWrapper`
500	Server error	`dto.SimpleResponseWrapper`

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`message`	`string`	No

Field	Type	Required
`authenticatorAttachment`	`string`	No
`residentKey`	`string`	No
`userVerification`	`string`	No

Field	Type	Required	Example	Constraints	Description
`alg`	`integer`	No
`type`	`string`	No

Field	Type	Required	Example	Constraints	Description
`id`	`string`	No
`name`	`string`	No

WebAuthn navigator.credentials.create() publicKey parameter

Field	Type	Required
`attestation`	`string`	No
`authenticatorSelection`	`dto.WebAuthnAuthenticatorSelection`	No
`challenge`	`string`	No
`pubKeyCredParams`	array of See `dto.WebAuthnCredentialParameter`	No
`rp`	`dto.WebAuthnRPEntity`	No
`timeout`	`integer`	No
`user`	`dto.WebAuthnUserEntity`	No

Field	Type	Required	Example	Constraints	Description
`publicKey`	`dto.WebAuthnRegistrationOptionsResponse`	No

Field	Type	Required
`code`	`integer`	No
`data`	`dto.WebAuthnRegistrationResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

Field	Type	Required
`displayName`	`string`	No
`id`	`string`	No
`name`	`string`	No