Method: vdc.registerDevice

Ein Endpunkt, um ein Gerät beim Aussteller zu registrieren.

HTTP-Anfrage

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "deviceIdentityCertificate": string,
  "deviceIdentityCertificateChain": [
    string
  ]
}
Felder
requestMetadata

object (RequestMetadata)

Die Metadaten zur Anfrage, erforderlich in allen Anfragen.
deviceReferenceId

string

Die zum Gerät gehörende ID und der mit dem Gerät verknüpfte Identitätsschlüssel. Dabei handelt es sich NICHT um eine Geräte-ID. Wenn ein Nutzer zwei verschiedene Ausweisdokumente auf demselben Gerät verwendet, unterscheidet sich diese ID bei beiden voneinander.

Die ID wird bei allen Anfragen angegeben und kann dazu verwendet werden, Anfragen zu korrelieren.
deviceIdentityCertificate

string

(EINGESTELLT: deviceIdentityCertificateChain verwenden) Eine X.509-Zertifikatskette, die für ein bestimmtes Gerät und einen bestimmten Berechtigungsnachweis einmalig ist.

Dieses Zertifikat enthält den Identitätsschlüssel des Geräts, eine Geräteattestierung und die signierte Nonce.
deviceIdentityCertificateChain[]

string

Eine Liste der X.509-Zertifikate in der Zertifikatskette, die für ein bestimmtes Gerät und einen bestimmten Berechtigungsnachweis eindeutig ist.

Diese Zertifikatskette enthält den Identitätsschlüssel des Geräts, eine Geräteattestierung und die signierte Nonce.

Antworttext

Eine Antwort zur Bestätigung der Geräteregistrierung.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "responseMetadata": {
    object (ResponseMetadata)
  }
}
Felder
responseMetadata

object (ResponseMetadata)

Die Metadaten zur Antwort, erforderlich in allen Antworten.