Start the registration of passkey for a user
Start the registration of a passkey for a user, as a response the public key credential creation options are returned, which are used to verify the passkey.
Path Parameters
- userId string required
- application/json
- application/grpc
- application/grpc-web+proto
Request Body required
code object
"one time code generated by ZITADEL; required to start the passkey registration without user authentication"
id string requiredPossible values:
<= 200 characters
"id to the one time code generated by ZITADEL"
code string requiredPossible values:
<= 200 characters
"one time code generated by ZITADEL"
- authenticator string
Possible values: [
PASSKEY_AUTHENTICATOR_UNSPECIFIED
,PASSKEY_AUTHENTICATOR_PLATFORM
,PASSKEY_AUTHENTICATOR_CROSS_PLATFORM
]Default value:
PASSKEY_AUTHENTICATOR_UNSPECIFIED
"Optionally specify the authenticator type of the passkey device (platform or cross-platform). If none is provided, both values are allowed."
- domain string
"Domain on which the user is authenticated."
Request Body required
code object
"one time code generated by ZITADEL; required to start the passkey registration without user authentication"
id string requiredPossible values:
<= 200 characters
"id to the one time code generated by ZITADEL"
code string requiredPossible values:
<= 200 characters
"one time code generated by ZITADEL"
- authenticator string
Possible values: [
PASSKEY_AUTHENTICATOR_UNSPECIFIED
,PASSKEY_AUTHENTICATOR_PLATFORM
,PASSKEY_AUTHENTICATOR_CROSS_PLATFORM
]Default value:
PASSKEY_AUTHENTICATOR_UNSPECIFIED
"Optionally specify the authenticator type of the passkey device (platform or cross-platform). If none is provided, both values are allowed."
- domain string
"Domain on which the user is authenticated."
Request Body required
code object
"one time code generated by ZITADEL; required to start the passkey registration without user authentication"
id string requiredPossible values:
<= 200 characters
"id to the one time code generated by ZITADEL"
code string requiredPossible values:
<= 200 characters
"one time code generated by ZITADEL"
- authenticator string
Possible values: [
PASSKEY_AUTHENTICATOR_UNSPECIFIED
,PASSKEY_AUTHENTICATOR_PLATFORM
,PASSKEY_AUTHENTICATOR_CROSS_PLATFORM
]Default value:
PASSKEY_AUTHENTICATOR_UNSPECIFIED
"Optionally specify the authenticator type of the passkey device (platform or cross-platform). If none is provided, both values are allowed."
- domain string
"Domain on which the user is authenticated."
- 200
- 403
- 404
- default
OK
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
details object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
resourceOwner resource_owner is the organization or instance_id an object belongs to- passkeyId string
- publicKeyCredentialCreationOptions object
Options for Credential Creation (dictionary PublicKeyCredentialCreationOptions). Generated helper methods transform the field to JSON, for use in a WebauthN client. See also: https://www.w3.org/TR/webauthn/#dictdef-publickeycredentialcreationoptions
{
"details": {
"sequence": "2",
"changeDate": "2023-07-27",
"resourceOwner": "69629023906488334"
},
"passkeyId": "163840776835432705",
"publicKeyCredentialCreationOptions": {
"publicKey": {
"attestation": "none",
"authenticatorSelection": {
"userVerification": "required"
},
"challenge": "XaMYwWOZ5hj6pwtwJJlpcI-ExkO5TxevBMG4R8DoKQQ",
"excludeCredentials": [
{
"id": "tVp1QfYhT8DkyEHVrv7blnpAo2YJzbZgZNBf7zPs6CI",
"type": "public-key"
}
],
"pubKeyCredParams": [
{
"alg": -7,
"type": "public-key"
}
],
"rp": {
"id": "localhost",
"name": "ZITADEL"
},
"timeout": 300000,
"user": {
"displayName": "Tim Mohlmann",
"id": "MjE1NTk4MDAwNDY0OTk4OTQw",
"name": "tim"
}
}
}
}
- Schema
- Example (from schema)
Schema
details object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
resourceOwner resource_owner is the organization or instance_id an object belongs to- passkeyId string
- publicKeyCredentialCreationOptions object
Options for Credential Creation (dictionary PublicKeyCredentialCreationOptions). Generated helper methods transform the field to JSON, for use in a WebauthN client. See also: https://www.w3.org/TR/webauthn/#dictdef-publickeycredentialcreationoptions
{
"details": {
"sequence": "2",
"changeDate": "2023-07-27",
"resourceOwner": "69629023906488334"
},
"passkeyId": "163840776835432705",
"publicKeyCredentialCreationOptions": {
"publicKey": {
"attestation": "none",
"authenticatorSelection": {
"userVerification": "required"
},
"challenge": "XaMYwWOZ5hj6pwtwJJlpcI-ExkO5TxevBMG4R8DoKQQ",
"excludeCredentials": [
{
"id": "tVp1QfYhT8DkyEHVrv7blnpAo2YJzbZgZNBf7zPs6CI",
"type": "public-key"
}
],
"pubKeyCredParams": [
{
"alg": -7,
"type": "public-key"
}
],
"rp": {
"id": "localhost",
"name": "ZITADEL"
},
"timeout": 300000,
"user": {
"displayName": "Tim Mohlmann",
"id": "MjE1NTk4MDAwNDY0OTk4OTQw",
"name": "tim"
}
}
}
}
- Schema
- Example (from schema)
Schema
details object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
resourceOwner resource_owner is the organization or instance_id an object belongs to- passkeyId string
- publicKeyCredentialCreationOptions object
Options for Credential Creation (dictionary PublicKeyCredentialCreationOptions). Generated helper methods transform the field to JSON, for use in a WebauthN client. See also: https://www.w3.org/TR/webauthn/#dictdef-publickeycredentialcreationoptions
{
"details": {
"sequence": "2",
"changeDate": "2023-07-27",
"resourceOwner": "69629023906488334"
},
"passkeyId": "163840776835432705",
"publicKeyCredentialCreationOptions": {
"publicKey": {
"attestation": "none",
"authenticatorSelection": {
"userVerification": "required"
},
"challenge": "XaMYwWOZ5hj6pwtwJJlpcI-ExkO5TxevBMG4R8DoKQQ",
"excludeCredentials": [
{
"id": "tVp1QfYhT8DkyEHVrv7blnpAo2YJzbZgZNBf7zPs6CI",
"type": "public-key"
}
],
"pubKeyCredParams": [
{
"alg": -7,
"type": "public-key"
}
],
"rp": {
"id": "localhost",
"name": "ZITADEL"
},
"timeout": 300000,
"user": {
"displayName": "Tim Mohlmann",
"id": "MjE1NTk4MDAwNDY0OTk4OTQw",
"name": "tim"
}
}
}
}
Returned when the user does not have permission to access the resource.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Returned when the resource does not exist.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}