Method: vdc.registerDevice

Un endpoint per registrare un dispositivo presso l'emittente.

Richiesta HTTP

POST https://example.issuer.com/api/v1/vdc/registerDevice

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "deviceIdentityCertificate": string,
  "deviceIdentityCertificateChain": [
    string
  ]
}
Campi
requestMetadata

object (RequestMetadata)

I metadati relativi alla richiesta, necessari in tutte le richieste.
deviceReferenceId

string

L'ID corrispondente al dispositivo e la chiave di identità associata al dispositivo. Non si tratta di un ID dispositivo, il che significa che se l'utente avesse due credenziali separate sullo stesso dispositivo, questo ID sarebbe diverso.

Questo ID viene fornito in tutte le richieste e può essere utilizzato per correlarle.
deviceIdentityCertificate

string

(DEPRECATO: utilizza deviceIdentityCertificateChain) Una catena di certificati X.509 univoca per una credenziale e un dispositivo specifici.

Questo certificato contiene la chiave di identità del dispositivo, un'attestazione del dispositivo e il nonce firmato.
deviceIdentityCertificateChain[]

string

Un elenco di certificati X.509 nella catena di certificati, univoco per una credenziale e un dispositivo specifici.

Questa catena di certificati contiene la chiave di identità del dispositivo, un'attestazione del dispositivo e il nonce firmato.

Corpo della risposta

Una risposta che conferma la registrazione del dispositivo.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  }
}
Campi
responseMetadata

object (ResponseMetadata)

I metadati relativi alla risposta, obbligatori in tutte le risposte.