Create a dispatch target

POST 
/nevisfido/token/dispatch/targets

This is a proprietary nevisFIDO API — not part of the FIDO UAF standard — used to register a new dispatch target for a given user. A dispatch target represents a delivery destination, such as a mobile device receiving push notifications or an email address, to which nevisFIDO can send operation tokens during a FIDO UAF authentication or registration flow. Each dispatch target is associated with a public key (in JWK format) that nevisFIDO uses to verify device-signed requests for subsequent modifications. On success, the server assigns the target a unique identifier that must be referenced when dispatching tokens or managing the target through other Dispatch Target Service endpoints.

Request

Header Parameters

headers objectrequired

application/json

Body

required

username string
deviceId string
name string
target string
dispatcher string
signatureKey string
encryptionKey string

Responses

201

Created The server successfully created the dispatch target. The response body contains id (the internal dispatch target identifier) and extId (the external identifier).

400

Bad Request The provided payload is not properly formatted.

401

Unauthorized The request was not authorized. There is an invalid SecToken or unresolved username.

403

Forbidden The user is not found in the credential repository based on the provided username.

405

Method Not Allowed The method of the received request was not POST.

406

Not Acceptable The provided Accept header forbids application/json content.

415

Unsupported Media Type The Content-Type header is not properly set to application/json;charset=UTF-8.

422

Unprocessable Entity The request could not be processed. For example, because the name of the provided dispatch target is already in use by another dispatch target of the user, or because the specified dispatcher is not configured.

500

Internal Server Error The server could not process the request because of an unexpected error.

Loading...