Method: vdc.registerDevice

Un endpoint per registrare un dispositivo con 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)

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

string

Obbligatorio. L'ID che corrisponde al dispositivo e alla chiave di identità associata al dispositivo. NON è un ID dispositivo, il che significa che se l'utente avesse due credenziali separate sullo stesso dispositivo, questo ID sarebbe diverso tra loro.

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

string

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

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

string

Obbligatorio. Un elenco di certificati X.509 nella catena di certificati, univoca per un dispositivo e una credenziale 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)

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